Skip to content

文档站上还有一份未修的 #5002 家族镜像:content/docs/plugins/plugin-{form,grid,view}.mdx 复制了同一段不存在的 *Components 手动注册 #5076

Description

@yinlianghui

发现于 #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

  1. yinlianghui commented on Aug 17, 2026

    @yinlianghui
    CollaboratorAuthor

    立卡人补记(正文末尾 footer 被 issues 端点剥掉,改用评论补):本卡由 #5011 的 os-dev 席在实施中扫出。该单的派发边界是「只动 packages/plugin-form/README.md + changeset」,content/docs/** 一行未碰,故分离立卡。未认领。


    Generated by Claude Code

  2. self-assigned this
    on Aug 17, 2026
  3. yinlianghui commented on Aug 17, 2026

    @yinlianghui
    CollaboratorAuthor

    认领(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

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Labels

bugSomething isn't workingdocumentationImprovements or additions to documentationpm:queue

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions