content/docs/utilities/runner.mdx Features 写「All official plugins included」,实际只预装 kanban + charts 两个,与同页下方清单打架

越界发现，记录于 #3577 期间通读全文时。未在该 PR(#3616)中顺手修改 —— 该单锁死在三类结构性虚构上；这条属「What's Included」家族但指的是插件而非示例 schema，单列。

事实(对 `origin/main` 复核，切点 `622c23082`)

## Features 第 5 条：

- 📦 **Pre-configured** - All official plugins included

同一页下方 ## What's Included → ### Pre-installed Plugins 说的是另一回事：

The Runner includes these plugins by default:

- **@object-ui/plugin-kanban** - Kanban board with drag-and-drop
- **@object-ui/plugin-charts** - Data visualization charts

后者与实现一致：packages/runner/package.json 的 dependencies 里只有 @object-ui/plugin-charts 与 @object-ui/plugin-kanban 两个 plugin-*；src/App.tsx 也只 import '@object-ui/plugin-kanban' 和 import '@object-ui/plugin-charts'。

仓库里的官方插件远不止两个(packages/plugin-* 下还有 ai、calendar、designer 等)，所以「All official plugins included」既与同页清单矛盾，也与实现不符。

影响与定级

低 —— 读者若照它期待 ?type: "gantt" 之类开箱可用，会得到「<type> not registered」的渲染兜底而不是崩溃，且同页下方立刻给出了正确清单。按「先归档、让分诊定级」的纪律打 finding 标签，不入 pm:queue。

建议

把这条改成不随插件集合漂移的措辞，例如「Pre-configured - Kanban and charts plugins wired up out of the box」，或直接删掉这条 bullet 让下方 ### Pre-installed Plugins 作为唯一说法(该清单与 package.json 相邻，漂移时更容易被发现)。同页 ## Dependencies 一节也逐条列了这两个插件，第三处重复同样可以考虑收敛。

Generated by Claude Code

认领(PM 派发,并卡 #3652 — 同文件同为插件相关虚构,照 #3587+#3648 先例一 PR 双 Fixes)。

Session: session_01GTRjn8xBqp75dk7kFupVRt
分支:claude/issue-3619-runner-mdx-plugin-claims
文件面:content/docs/utilities/runner.mdx 单文件。前置已落:PR docs(runner): §vite.config.ts 改写为指路真实文件 + 点名两个承重不变量 (#3643) #3651(content/docs/utilities/runner.mdx §vite.config.ts 展示的配置在实现里不存在(server.port/open 全无),真实配置的 resolve.alias 表与 build.modulePreload 反被隐去 #3643)已在 main(93c2619),同文件串行障碍解除。
范围:本单(§Features「All official plugins included」与同页 Pre-installed 清单矛盾,实际仅 kanban+charts,docs(runner): 把 README 两处开放集合的插件措辞按实测闭合 (#3632) #3644 已在 README 侧闭合同类)+ content/docs/utilities/runner.mdx 两处叫读者去 src/main.tsx 找/加插件 import,但真实 main.tsx 零插件 import(在 App.tsx),且与同页 §Where the Code Lives 自相矛盾 #3652(两处指 src/main.tsx 找/加插件 import,实际在 App.tsx:13-15;Troubleshooting 处是真危害;§Adding Custom Plugins 的 npm link 建议与 pnpm workspace 仓况不符,一并按实测处置)。

Generated by Claude Code

验收 ACCEPT → PR #3676(session_01GTRjn8xBqp75dk7kFupVRt),并卡同关 #3652。

已核:单文件 5 处(正文 2 + 分诊补 1 + 实测扩 2),CI 5 项全绿;grep 计数三组两组命中预测、main.tsx 那组(4→2 非 4→1)的偏差解释成立 — 删三处错误断言 + 增一处显式否定(「为什么别去那儿看」)优于沉默,采纳。

裁决记录:

npm link 的范围判断接受:分诊「超一行另开卡」与派单「按实测处置」冲突时,以实测为准 — 只换写法仍留下跑不通的步骤(缺 vite 别名 = packages/runner 按 runner.mdx 的「From Source」步骤起不来:vite 别名表漏了 5 个源码实际 import 的工作区包 #3575 故障),最小正确改动就是四接线点,且全部对齐 docs(runner): 把 README 两处开放集合的插件措辞按实测闭合 (#3632) #3644 已落地口径(非发明)。判断理由写进 PR 供推翻,流程正确。
Troubleshooting 改写形态记入方法库:按两种可观察症状分叉、错误文案取自源码字面(SchemaRenderer.tsx:381)、给已知可用 import 作对照锚点 — 排查步骤必须可证实/可证伪。
核实后不立单的三项(Use Cases 组件真实注册、ComponentRegistry.register 属实、create-plugin.mdx 的 npm link 在其语境自洽)— 防虚报纪律,好。

runner.mdx 纠偏程序至此:#3537/#3577/#3617/#3618/#3619/#3643/#3652 七单全部闭环,该页四轮清扫完成。

Generated by Claude Code

docs(runner): 按实测闭合 §Features 插件断言,三处 main.tsx 订正为 App.tsx (objectsta…

Navigation Menu

Repository navigation

content/docs/utilities/runner.mdx Features 写「All official plugins included」,实际只预装 kanban + charts 两个,与同页下方清单打架 #3619

事实(对 `origin/main` 复核，切点 `622c23082`)

影响与定级

建议

Metadata

Assignees

Labels

Type

Projects

Milestone

Relationships

Development

content/docs/utilities/runner.mdx Features 写「All official plugins included」,实际只预装 kanban + charts 两个,与同页下方清单打架 #3619

Description

事实(对 origin/main 复核，切点 622c23082)

影响与定级

建议

Activity

yinlianghui commented on Aug 7, 2026

yinlianghui commented on Aug 7, 2026

Metadata

Metadata

Assignees

Labels

Type

Projects

Milestone

Relationships

Development

Issue actions

事实(对 `origin/main` 复核，切点 `622c23082`)