`content/docs/fields/{grid,location}.mdx` 教的 `plugin:grid` / `plugin:map` 全仓未注册 —— 照抄即 OBJUI-001 红框

[yinlianghui]

发现于 #4786 的实施,真实 SchemaRenderer 探针实测。与 #4786 里已修掉的 stats-card 是同一类缺陷(教学面给了一个注册表里不存在的 type),但落在两个不同文件、且不属于 #4786 的 props 信封范围,故单列。

实测

@@PROBE plugin:grid
 text="Unknown component type: plugin:grid ... (OBJUI-001)"
@@PROBE plugin:map
 text="Unknown component type: plugin:map ... (OBJUI-001)"

真实注册名

• packages/plugin-grid/src/index.tsx:129 —— ComponentRegistry.register('object-grid', ObjectGridRenderer, ...)
• packages/plugin-map/src/index.tsx:62 —— ComponentRegistry.register('object-map', ObjectMapRenderer, ...)

全仓 grep -rn "register('plugin:grid'\|register('plugin:map'" 零命中。

命中位置

• content/docs/fields/grid.mdx 的 "Full Grid Functionality" 段(type: 'plugin:grid')
• content/docs/fields/location.mdx 的 "With map visualization" 段(type: 'plugin:map')

#4786 的 PR 已把这两处的 props 信封拆掉(键提到节点上,与 object-grid / object-map 的真实读法一致),但刻意没有改 type 名 —— 那是本单的范围。改完信封后示例仍然渲染红框,直到这里被修。

修法

两处 type 改成 object-grid / object-map,并核一遍同段落里其余键是否被对应 renderer 读(object-grid 读 schema.objectName / schema.columns / schema.fields,见 packages/plugin-grid/src/index.tsx:155-157)。

参考

• 教学面成体系教 props 信封,而渲染器从节点本身读键 —— 照 page-builder.md 写出的页面渲染一片空白框 #4786(发现来源;stats-card 同类缺陷在其 PR 中已修)
• 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 侧已有"不许出现 OBJUI-001"的棘轮;教学面 prose 没有等价物 —— 这正是同一结构性缺口的第三次复发)

[yinlianghui]

【分诊晋级 + 认领】objectui 分片 PM(session_01GTRjn8xBqp75dk7kFupVRt):finding → pm:queue 并即时派发(批次 11 补位)。晋级依据:卡内已带 OBJUI-001 probe 读数与真实注册名(object-grid/object-map 的 register 行号),修法零决策(改两处 type 名 + 同段键核对),catalog 侧 #4616 棘轮先例在案。分支:claude/issue-4796-fields-docs-plugin-types。

---

Generated by Claude Code