观察类 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 从头到尾全绿。
同一缺陷的三次复发
| # | 位置 | 教了什么 | 真实注册名 |
|---|
| #4786 | content/docs/** | stats-card | 已在其 PR 中修掉 |
| #4796 | content/docs/fields/grid.mdx | plugin:grid | object-grid |
| #4796 | content/docs/fields/location.mdx | plugin:map | object-map |
三次都是同一个形状:教学面给了一个注册表里不存在的 type。三次都靠人工探针发现,没有一次是门禁抓到的。
顺带一提,#4796 还暴露了缺口的第二个维度:即使 type 名对了,片段里的其余键也没人核对是否真的被对应 renderer 读。location.mdx 那段的 bind / markers 就是零读点的死键(ObjectMap 根本没有 useDataScope 调用,markers 是从抓到的记录派生的),grid.mdx 那段的节点级 sortable / filterable 同理。
为什么标 finding 而不是 pm:queue
这是一个缺失的门禁,不是一个待修的 bug —— 已知的三个实例都已经修了或正在修。要不要建这道门、建成什么形状(在 mdx 里给可执行片段加标记?把片段抽进 catalog?还是只做一个「type: 字面量必须在注册表里」的静态扫描?),是个需要维护者定方向的设计决策,不适合我这边替它选。交给分诊轮定级。
参考
观察类 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 从头到尾全绿。同一缺陷的三次复发
content/docs/**stats-cardcontent/docs/fields/grid.mdxplugin:gridobject-gridcontent/docs/fields/location.mdxplugin:mapobject-map三次都是同一个形状:教学面给了一个注册表里不存在的
type。三次都靠人工探针发现,没有一次是门禁抓到的。顺带一提,#4796 还暴露了缺口的第二个维度:即使
type名对了,片段里的其余键也没人核对是否真的被对应 renderer 读。location.mdx那段的bind/markers就是零读点的死键(ObjectMap根本没有useDataScope调用,markers 是从抓到的记录派生的),grid.mdx那段的节点级sortable/filterable同理。为什么标
finding而不是pm:queue这是一个缺失的门禁,不是一个待修的 bug —— 已知的三个实例都已经修了或正在修。要不要建这道门、建成什么形状(在 mdx 里给可执行片段加标记?把片段抽进 catalog?还是只做一个「
type:字面量必须在注册表里」的静态扫描?),是个需要维护者定方向的设计决策,不适合我这边替它选。交给分诊轮定级。参考
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 的发现来源)