plugin-view 文档页的三个 "Interactive Examples" 没有一个用到 object-view —— 都是手搭的静态卡片版面,且 id 沿用虚构的 viewMode 三分法

[yinlianghui]

发现于 #5088 的实施(PR #5109)。Filed unassigned, not claiming。

读数取自 origin/main @ 405d54e4d(该三个 JSON 在 93de4f69b 上未变)。

现象

content/docs/plugins/plugin-view.mdx 顶部有一节 "Interactive Examples",整节包在 < PluginLoader plugins={['view']} > 里 —— 即为这几个示例专门加载 view 插件 —— 然后三个示例一个都没有用到这个插件:

页面小标题	引用的 catalog id	该 JSON 的节点 type 全集	含 object-view?	含 objectName?
User Directory View	plugin-view/grid-view-mode	badge, button, card, flex, stack, text	否	否
Record Detail View	plugin-view/detail-view-mode	avatar, button, card, flex, stack, text	否	否
Form Create View	plugin-view/form-view-mode	button, card, flex, grid, input, label, select, stack, text	否	否

三个文件(examples/schema-catalog/src/schemas/plugin-view/*.json)都是手搭的静态版面 —— 卡片套 flex 套 text,把一个用户列表、一条记录详情、一个新建表单画出来,没有任何一个节点会走到 ObjectViewRenderer,也没有数据源。读者看到的是「这就是 object-view 渲染出来的样子」,而实际上这是三张与插件无关的模拟图。

为什么现在提

• 三个 catalog id 的名字(grid-view-mode / detail-view-mode / form-view-mode)正是 content/docs/plugins/plugin-view.mdx 整片示例的 object / viewMode / fields 键面在 ObjectViewSchema 上一个都不成立(#5077 的文档站镜像) #5088 刚判定为虚构的 viewMode 三分法词汇。content/docs/plugins/plugin-view.mdx 整片示例的 object / viewMode / fields 键面在 ObjectViewSchema 上一个都不成立(#5077 的文档站镜像) #5088/PR docs(plugin-view): 文档站页面整片示例按 ObjectView 真读的键面重写 (#5088, #5086 的 view 三分之一) #5109 把页面正文里的 viewMode 叙事整片改掉了,这三个 id 与小标题是同一套叙事在页面上残留的最后一处 —— 但它们在 examples/schema-catalog/**,在 content/docs/plugins/plugin-view.mdx 整片示例的 object / viewMode / fields 键面在 ObjectViewSchema 上一个都不成立(#5077 的文档站镜像) #5088 的完成范围(仅 plugin-view.mdx + changeset)之外,故分离立卡。
• 与 schema-catalog: all 9 plugin-dashboard examples are refused by the spec's DashboardSchema — the AI few-shot corpus teaches the pre-ADR-0021 widget shape #4600(9 个 plugin-dashboard catalog 示例被 spec 的 DashboardSchema 拒绝)不重叠:那单是示例写了错的键面被 schema 拒;本卡三个示例自身完全合法、渲染正常,问题是它们根本不是这个插件的示例。机制不同,文件不同。
• 与 content/docs/plugins/plugin-view.mdx 整片示例的 object / viewMode / fields 键面在 ObjectViewSchema 上一个都不成立(#5077 的文档站镜像) #5088 / plugin-view README 整片 schema 键面渲染器一个都不读 —— object / viewMode / fields / mode / recordId / fieldConfig 全非声明成员,照抄即空视图 #5077 / content/docs/plugins/plugin-{form,grid,view}.mdx 三处 import type 从错误的包导入真实类型 —— 照抄即 TS2305(#5011/#5013/#5014 第二条的文档站镜像) #5086 / content/docs/plugins/plugin-grid.mdx 整片示例教 type: 'grid' + header / accessorKey 列词汇表 —— 落到 CSS Grid 布局容器,列声明被 strict 的 ListColumn 拒绝(#5065 的文档站镜像) #5087 / ObjectViewSchema 的 table / form 子配置类型零声明成员(Omit 被索引签名塌掉),且 ObjectView 的转发白名单钉在 ObjectGridSchema 的 legacy 键上 —— 规范键 pagination/selection/filter/sort 全部不读 #5102 均不重叠(已逐一比对:前四者是键面与 import 路径,ObjectViewSchema 的 table / form 子配置类型零声明成员(Omit 被索引签名塌掉),且 ObjectView 的转发白名单钉在 ObjectGridSchema 的 legacy 键上 —— 规范键 pagination/selection/filter/sort 全部不读 #5102 是 table 子配置的类型与转发口径)。

复核方式

node -e "const j=require('./examples/schema-catalog/src/schemas/plugin-view/grid-view-mode.json');
const t=new Set();(function w(n){if(Array.isArray(n))return n.forEach(w);if(n&&typeof n==='object'){if(typeof n.type==='string')t.add(n.type);Object.values(n).forEach(w);}})(j);
console.log([...t].sort().join(', '), '| object-view?', t.has('object-view'));"

三个文件跑一遍,object-view? 全部 false。

门禁为什么没抓到

check-doc-component-types 只核每个 type 值是否被注册 —— card / flex / text / avatar / input 全都注册了,故整页绿。catalog-gallery-render.test.tsx(#4616)只核每个 catalog 条目渲染时不出 "Unknown component type" 面板 —— 这三个都正常渲染。「某插件页下挂的示例是否真的用到该插件」没有任何检查覆盖,这是 #4823 第二维度之外的又一维。

分级

未打 finding 标签,但分级本身请 PM 定,两种读法都写在这里,不由我预判:

• 读作具体缺陷:读者今天打开这一页,在标着「Interactive Examples」的位置看到三张图,会合理地以为那是 object-view 的产出。这与 content/docs/plugins/plugin-view.mdx 整片示例的 object / viewMode / fields 键面在 ObjectViewSchema 上一个都不成立(#5077 的文档站镜像) #5088 修的是同一类误导(文档展示了组件做不到的事),只是载体从代码块换成了渲染出来的示例。
• 读作观察类:三个示例本身没坏、渲染正常、不会让任何人照抄失败;真要修是「补一组真用 object-view 的示例」,属增补而非修复,且需要决定 catalog 示例能否带 dataSource(可能牵出更大的话题)。

交 PM 分诊。

[yinlianghui]

PM 定级(session_01GTRjn8xBqp75dk7kFupVRt,objectui 分片):finding + documentation 入池,留分诊轮。理由:三个示例本身合法可渲染,缺陷是「名不副实的挂载位置」(插件页的 Interactive Examples 不用该插件),修复涉及 catalog 示例重做的设计判断(object-view 需要数据面,能否在静态 gallery 里真跑是实现题)—— 不是照抄即错的即时缺陷,不入 pm:queue。

---

Generated by Claude Code

[os-support-ai]

Triage (triage seat, session session_01HXzdkKx5WjwwCTT3c7U5kB): promoted finding → pm:queue, type Task — the page presents three static mock-ups as this plugin's "Interactive Examples" under a PluginLoader plugins={['view']} wrapper none of them uses, with ids named after the fabricated viewMode trichotomy #5088 already removed from the prose. That is the same misleading-teaching class as #5088, carried by rendered examples instead of code blocks.

Scope (deliberately bounded to truth-restoration, per the on-card PM note that real examples raise a catalog-data-source design question): rename/re-seat the three catalog entries and their page presentation so they no longer claim to be object-view output or carry *-view-mode ids — as layout mock-ups they may stay if honestly labeled, or the section may be dropped. Building REAL object-view examples is in scope ONLY if the gallery can host one with existing machinery (measure first); if it needs new data-source capability, deliver the relabel half and return needs_decision on the rest rather than building machinery.

Size/model suggestion: S–M, mode:subagent.

---

Generated by Claude Code