finding: 教学面 prose(content/docs/**.mdx 代码块)没有 catalog 侧 #4616 那样的「不许出现 OBJUI-001」棘轮,同一缺陷已复发三次 #4823

观察类 finding —— 记录一个结构性缺口,不是今天有用户正在踩的具体缺陷(具体实例每次都被单独立项修掉了)。发现于 #4796 的实施。

缺口

catalog 侧已经有棘轮:examples/schema-catalog/test/catalog-gallery-render.test.tsx 会渲染每一条 catalog entry 并断言不出现 OBJUI-001 红框(#4616 建立)。

教学面 prose 没有等价物。 content/docs/**.mdx 里那些 ```plaintext 代码块中的 schema 片段不被任何东西渲染、不被任何东西解析、也不被任何东西对着 ComponentRegistry 校验。一个片段可以写任意 type 字符串,读者照抄得到 OBJUI-001,而 CI 从头到尾全绿。

同一缺陷的三次复发

三次都是同一个形状:教学面给了一个注册表里不存在的 type。三次都靠人工探针发现,没有一次是门禁抓到的。

顺带一提,#4796 还暴露了缺口的第二个维度:即使 type 名对了,片段里的其余键也没人核对是否真的被对应 renderer 读。location.mdx 那段的 bind / markers 就是零读点的死键(ObjectMap 根本没有 useDataScope 调用,markers 是从抓到的记录派生的),grid.mdx 那段的节点级 sortable / filterable 同理。

为什么标 finding 而不是 pm:queue

这是一个缺失的门禁,不是一个待修的 bug —— 已知的三个实例都已经修了或正在修。要不要建这道门、建成什么形状(在 mdx 里给可执行片段加标记?把片段抽进 catalog?还是只做一个「type: 字面量必须在注册表里」的静态扫描?),是个需要维护者定方向的设计决策,不适合我这边替它选。交给分诊轮定级。

参考

• Docs gallery: 35 catalog entries render the red "Unknown component type" panel because their plugin package is never loaded on that page #4616 / examples/schema-catalog/test/catalog-gallery-render.test.tsx(catalog 侧的既有棘轮)
• 教学面成体系教 props 信封,而渲染器从节点本身读键 —— 照 page-builder.md 写出的页面渲染一片空白框 #4786(第一次复发,stats-card)
• content/docs/fields/{grid,location}.mdx 教的 plugin:grid / plugin:map 全仓未注册 —— 照抄即 OBJUI-001 红框 #4796 / PR docs(fields): grid.mdx / location.mdx teach the registered plugin types (#4796) #4822(第二、三次复发,本 finding 的发现来源)