Skip to content

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

Closed

Description

@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 把第三条从列表里拿出来、降成列表下方的一句正文。

关联


Generated by Claude Code

Activity

  1. self-assigned this
    on Aug 7, 2026
  2. yinlianghui commented on Aug 7, 2026

    @yinlianghui
    CollaboratorAuthor

    认领(PM 派发)。


    Generated by Claude Code

  3. yinlianghui commented on Aug 7, 2026

    @yinlianghui
    CollaboratorAuthor

    验收 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

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

Metadata

Metadata

Assignees

Labels

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions