packages/runner/README.md 的插件清单两处写成开放集合(§Features 的「etc.」、§Pre-installed Plugins 的非插件条目),实际只预装 kanban + charts 两个

[yinlianghui]

越界发现，记录于 #3620(改写同文件 §Features 的 Hot Reload 一条)期间按派发要求通读 §Features 全列表时。未在该 PR 中顺手修改 —— #3620 的派发范围被明确锁死在 Hot Reload 那一个 bullet，「其余 bullet 只报不改」。

事实(对 origin/main 复核，切点 0e4ea07b2)

packages/runner/README.md 同一文件里有两处把预装插件写成开放集合，实际是恰好两个的闭集合。

第一处 —— §Features 第 9 行:

- **Plugin Support** - Pre-configured with popular plugins (Kanban, Charts, etc.)

括号里穷举了全部两个，末尾却缀「etc.」，读起来是「还有更多没列」。

第二处 —— §Pre-installed Plugins(第 41-47 行):

The runner comes with these plugins pre-configured:

- **@object-ui/plugin-kanban** - Kanban board components
- **@object-ui/plugin-charts** - Chart visualization components
- **Additional plugins can be added as needed**

第三条不是插件。它被排在一句「comes with these plugins pre-configured」引出的列表里、且和前两条一样加粗，形状上与两个真插件并列，扫读时会被当成第三个预装项。它想说的是「可以自己再装」，那是一句能力说明，不是清单项。

实现侧(两处都对不上):

• packages/runner/package.json:24-38 的 dependencies 里 plugin-* 只有两个 —— @object-ui/plugin-charts、@object-ui/plugin-kanban。
• packages/runner/src/App.tsx:14-15 也只有这两行注册 import:

  import '@object-ui/plugin-kanban';
  import '@object-ui/plugin-charts';
  

• 仓库里的官方插件远不止两个(packages/plugin-* 下另有 ai、calendar、dashboard、designer、detail、form、gantt、grid、list、map、markdown、report、timeline、tree、view 等)，所以「etc.」指向的那个「更多」在 runner 里一个都没有。

影响与定级

低 —— 与 #3619 同源同量级:读者若照它期待 "type": "gantt" 之类开箱可用，拿到的是未注册组件的渲染兜底而不是崩溃。按「先归档、让分诊定级」的纪律打 finding 标签，不入 pm:queue。

建议

两处一并收敛成闭集合措辞，例如 §Features 改成 Kanban and charts plugins wired up out of the box(不随插件集合漂移)，§Pre-installed Plugins 把第三条从列表里拿出来、降成列表下方的一句正文。

关联

• content/docs/utilities/runner.mdx Features 写「All official plugins included」,实际只预装 kanban + charts 两个,与同页下方清单打架 #3619 —— 完全同一个缺陷家族(Features 把预装插件写成开放集合)，但在 content/docs/utilities/runner.mdx，另一个文件、另一处文本、另一处改动面，故按 content/docs/utilities/runner.mdx Features 写「All official plugins included」,实际只预装 kanban + charts 两个,与同页下方清单打架 #3619 / packages/runner/README.md §Features 的「Hot Reload - Automatic reload on schema changes」未按 loader 分路,?api= 那条不成立 #3620 自己的按文件分单先例单列而非并入。两单可以合并派发给同一个开发，口径应一致。
• 同源:文档站还有两处环境变量示例与实现不符:runner.mdx 教两个 runner 不读的变量,objectos-integration.mdx 在 Vite 前端用 process.env #3533(文档不许描述实现里不存在的能力)、packages/runner/README.md §Development Workflow 教读者写 TypeScript schema 文件,但两个 loader 都只认 JSON #3604 / PR docs(runner): README §Development Workflow 按两个 loader 的真相改写第 1、3 步 (#3604) #3621、packages/runner/README.md §Features 的「Hot Reload - Automatic reload on schema changes」未按 loader 分路,?api= 那条不成立 #3620。
• 已搜开放 issue 与 PR(关键字 packages/runner/README.md、Pre-installed Plugins、runner README plugins pre-configured、runner README Features Kanban Charts)，除 content/docs/utilities/runner.mdx Features 写「All official plugins included」,实际只预装 kanban + charts 两个,与同页下方清单打架 #3619 外无重复。

---

Generated by Claude Code

[yinlianghui]

认领(PM 派发)。

• Session: session_01GTRjn8xBqp75dk7kFupVRt
• 分支:claude/issue-3632-readme-plugin-list
• 文件面:packages/runner/README.md 单文件。前置已落:PR docs(runner): README §Features 的 Hot Reload 按两个 loader 分路限定 (#3620) #3634(packages/runner/README.md §Features 的「Hot Reload - Automatic reload on schema changes」未按 loader 分路,?api= 那条不成立 #3620)已在 main(8098c85),同文件串行障碍解除。
• 处置:两处开放集合措辞按实测闭合(仅 kanban + charts 两个预装插件,package.json:24-38 + src/App.tsx:14-15 为准):§Features 的 (Kanban, Charts, etc.) 去掉 etc.;§Pre-installed Plugins 把非插件的加粗行「Additional plugins can be added as needed」移出预装清单形状(改为清单后的普通说明句或删除,以该节上下文实测定)。⛔ 不碰 runner.mdx(content/docs/utilities/runner.mdx §Add Custom Routes 教读者用 react-router-dom 改写 App.tsx,但 runner 不依赖它,路由是手写的 history.pushState #3618 在途)。

---

Generated by Claude Code

[yinlianghui]

验收 ACCEPT → PR #3644(session_01GTRjn8xBqp75dk7kFupVRt)。

已核:单文件 +8/−3,零链接增删(12=12 奇偶补证 — 在 packages/** 尚未入扫描面的窗口期,这是正确的证据替代);两处闭合与实测集合一致。

裁决记录:

1. 连 "popular" 一起删,接受:闭集措辞下「popular plugins (Kanban, Charts)」仍读作「从更大集合里挑的几个」— 与闭集不相容,不是顺手润色,理由成立。
2. 「the entries the two above have」而非「required」的措辞取舍接受 — vite alias 表是 monorepo 启动用途(packages/runner 按 runner.mdx 的「From Source」步骤起不来:vite 别名表漏了 5 个源码实际 import 的工作区包 #3575),写成 mandatory 是新的过度断言;边修虚构边不制造新虚构,对。
3. 不跑 vitest/type-check 的判断成立(纯 README,如实记录而非制造绿灯)。
4. 新发现 35 个包 README 的生成块 §Compatibility 版本已陈旧:声称 @objectstack/spec ^3.3.0,实际全仓锁 ^17.0.0-rc.5;部分包还列了自己并不依赖的 @objectstack/client #3645 入池待分诊(35 包生成式 §Compatibility 块过期:spec ^3.3.0 vs 实际 rc.5 + 幽灵 client 行)— dev 判断根因在发版生成器、手改会被覆盖,不入队 35 个手改单是对的;下一步是定位生成器归属(可能在发版流程/objectstack 侧)再定处置,PM 跟进。
5. GitHub 消毒器吃掉 HTML 注释标记的读回自查与转义重写,好。

---

Generated by Claude Code