Repository navigation
文档站上还有一份未修的 #5002 家族镜像:content/docs/plugins/plugin-{form,grid,view}.mdx 复制了同一段不存在的 *Components 手动注册 #5076
Description
发现于 #5011 的实施(plugin-form README 重写)。Filed unassigned, not claiming.
现象
#5002 家族修的是包内 README 里那段虚构的 Object.entries(xxxComponents).forEach(register)。同一段代码在文档站 content/docs/plugins/*.mdx 上还有一份复制品,家族的七个 PR 一个都没碰到它(每个 PR 的 changed files 都是 README + changeset 两个)。
读数取自当前 origin/main @ 6098ecd08a8c884b22a4130571d17af1ffafebdb:
| 文件 | 行 | 名字 | 该名字在对应包的 src 里 |
判定 |
|---|---|---|---|---|
content/docs/plugins/plugin-form.mdx |
:165 / :168 |
formComponents |
零命中 | 虚构;README 侧已由 #5011 修 |
content/docs/plugins/plugin-grid.mdx |
:121 / :124 |
gridComponents |
零命中 | 虚构;README 侧已由 #5013 / PR #5071 修 |
content/docs/plugins/plugin-view.mdx |
:70 / :73 |
viewComponents |
零命中 | 虚构;README 侧见 #5014 |
content/docs/plugins/plugin-dashboard.mdx |
:73 / :76 |
dashboardComponents |
packages/plugin-dashboard/src/index.tsx:338 |
名字是真的,错的是键的词汇表 —— 已在 #5064,本卡不重复 |
前三行照抄拿到 undefined,Object.entries(undefined) 当场抛 TypeError —— 与各自 README 上那段完全一样的失败,只是发生在文档站的读者身上。文档站的曝光量比包内 README 高,而且 .mdx 不随 npm 发布,所以修它不需要 changeset。
为什么单立一卡而不是各包一单
这四处是同一段被复制的代码,住在同一个目录、同一种文件里,一次替换就能全改对(改法与 README 侧已落地的三单相同:删虚构节,改写成「注册是 import 副作用」+ 真实 register 键表 + 真实导出面)。按包切成三单反而制造三份孪生。
content/docs/plugins/plugin-map.mdx 另有两处不同性质的漂移,已在 #5019,与本卡不重叠(那个文件里没有 mapComponents 这一段)。
复核方式
git grep -nw -E "formComponents|gridComponents|viewComponents|dashboardComponents" -- content/docs
git grep -nw formComponents -- packages/plugin-form/src # 零命中
git grep -nw gridComponents -- packages/plugin-grid/src # 零命中
git grep -nw viewComponents -- packages/plugin-view/src # 零命中
各包的真实 register 键从 ComponentRegistry.register(...) 调用现场抄,不要从文档反推:
git grep -nE "ComponentRegistry\.register\(" -- packages/plugin-form/src packages/plugin-grid/src packages/plugin-view/src
分级
交 PM 分诊,未打 finding 标签 —— 照抄即抛,是读者今天就会撞上的具体缺陷,与 #5010 / #5011 / #5013 / #5014 同一性质,只是文件不同。
门禁侧:check-doc-component-types 确实扫 content/docs,但它核的是组件 type 而不是 import 的名字,所以这四处从它下面穿过去了;包内 README 的同类断言无人核对(#5043)。一道同时覆盖两个扫描根的名集合门禁能把这一整族关掉。
Activity
yinlianghui commentedon Aug 17, 2026
立卡人补记(正文末尾 footer 被 issues 端点剥掉,改用评论补):本卡由 #5011 的 os-dev 席在实施中扫出。该单的派发边界是「只动
packages/plugin-form/README.md+ changeset」,content/docs/**一行未碰,故分离立卡。未认领。Generated by Claude Code
yinlianghui commentedon Aug 17, 2026
认领(objectui 分片 PM 直辖,批次 22 补席)—— session
session_01GTRjn8xBqp75dk7kFupVRt,分支claude/issue-5076-docs-mirror-components。os-dev 席位实施,PM 只读验收。按卡面一卡一 PR:只改
content/docs/plugins/plugin-{form,grid,view}.mdx三处虚构*Components注册段(删虚构、改教 import 副作用 + 真实 register 键表 + 真实导出面 —— 键从 register 调用现场抄,README 侧已落地的 #5011/#5013/#5014 三单为基准);⛔ dashboard 的那段归 #5064 勿碰;⛔ plugin-map.mdx 归 #5019 勿碰;⛔ 不加导出。changeset:mdx 不随 npm 发布,按卡面判断不需要 —— 以 Changeset 门禁实测为准并在报告说明。注意与在飞 #5065(packages/plugin-grid/README.md)不同文件,零冲突;check-doc-component-types扫 content/docs —— 改写后的 mdx 代码块要过它(组件 type 核对),发 PR 前本地跑一遍。Generated by Claude Code