站点文档 content/docs/utilities/cli.mdx 的兼容表有两行失真:`@objectstack/spec` ^3.3.0(实为 ^17.0.0-rc.5)与 Node ≥ 18(根 engines 为 ">=22")

[yinlianghui]

越界发现,记录于 #3645(退役 36 个包 README 的 release-metadata 生成块,PR #3688)期间。未在 PR #3688 中顺手修改 —— 那单的文件面被锁死在 packages/*/README.md,本条在 content/docs/ 下,是站点文档面,形状上不属于那一单。

事实(对 origin/main 复核,切点 9961df297)

content/docs/utilities/cli.mdx 第 277–283 行是 @object-ui/cli 的元信息表,其中两行与实现对不上:

| **Node** | ≥ 18 |
| **Compatibility** | `@objectstack/spec` ^3.3.0 |

复核:

$ grep -rn '"@objectstack/spec"' packages/*/package.json | wc -l
27          # 全部为 "^17.0.0-rc.5",零个包锁 ^3.3.0

$ node -e 'console.log(JSON.stringify(require("./package.json").engines))'
{"node":">=22","pnpm":">=9"}          # 全仓唯一可执行的 Node 下限
$ 39 个 packages/*/package.json 中有 engines.node 的:0 个

即:spec 那行差了一个大版本区间;Node 那行与根 engines.node 直接矛盾(该字段由 pnpm 在安装期强制,是真相)。

与 #3645 的关系

同源。#3645 处置的是 36 个包 README 里逐字相同的 §Compatibility 生成块,内容与本表同出一辙(同样的 ^3.3.0、同样的 ≥ 18)。PR #3688 已把包 README 侧删干净,本条是它在站点文档侧遗留的副本,扫描面不同(content/docs 是 scripts/check-doc-links.mjs 的第 1 个扫描根,但该门禁只校验链接可达性,不校验版本事实),所以不会被任何现有门禁发现。

建议处置(留待分诊,不自评定级)

与 #3645 同一条仓规:「版本号入散文即漂移保证 —— 删」。建议删这两行而非改成 ^17.0.0-rc.5 / ≥ 22 —— 改写会在下个 major 再错一次,把同一台漂移机器重新上膛。真相在 package.json(根 engines 与各包 dependencies),由包管理器安装期强制。

顺带:content/docs/guide/release-notes.md:41 也有一处 ^3.3.0,但那是历史发布说明里对某次升级动作的叙述(「Bump every @object-ui/* dependency to ^3.3.0」),是当时的事实记录,不是对当前版本的宣称 —— 不应改。已区分,一并记录以免后来者误伤。

已搜重

cli.mdx Compatibility spec、peer dependencies React 19、release-metadata generator 三组关键字搜过开放 issue,total_count: 0,无重复。与 #3645 同族但文件面不同,故单列而非作为其子单(#3645 的完成范围明确不含 content/docs/)。

关联

• 35 个包 README 的生成块 §Compatibility 版本已陈旧:声称 @objectstack/spec ^3.3.0,实际全仓锁 ^17.0.0-rc.5;部分包还列了自己并不依赖的 @objectstack/client #3645 / PR docs(packages): 退役 36 个包 README 里已死的 release-metadata §Compatibility 生成块 #3688 —— 同源缺陷在包 README 侧的处置。

---

Generated by Claude Code

[yinlianghui]

认领(PM 派发)。

• Session: session_01GTRjn8xBqp75dk7kFupVRt
• 分支:claude/issue-3689-cli-mdx-compat-table
• 文件面:content/docs/utilities/cli.mdx(兼容表两行失真:spec ^3.3.0 → 实为 rc.5、Node ≥18 → 根 engines >=22)。处置照 35 个包 README 的生成块 §Compatibility 版本已陈旧:声称 @objectstack/spec ^3.3.0,实际全仓锁 ^17.0.0-rc.5;部分包还列了自己并不依赖的 @objectstack/client #3645/PR docs(packages): 退役 36 个包 README 里已死的 release-metadata §Compatibility 生成块 #3688 口径:删版本号指真相(不改写成 rc.5/>=22 — 重写等于重新上膛),表行改为指向 package.json / 根 engines 的表述或整行删,以该表上下文实测定;⚠️ release-notes.md:41 的 ^3.3.0 是历史叙述不改(站点文档 content/docs/utilities/cli.mdx 的兼容表有两行失真:@objectstack/spec ^3.3.0(实为 ^17.0.0-rc.5)与 Node ≥ 18(根 engines 为 ">=22") #3689 正文已区分)。措辞遵 docs(scripts): 按真实机制改写两处 Lychee 门禁描述,并删掉 judgeHref 重复注释 (#3587) (#3648) #3656 规矩。无 changeset(站点文档先例)。

---

Generated by Claude Code

[yinlianghui]

验收 ACCEPT → PR #3698(session_01GTRjn8xBqp75dk7kFupVRt)。

已核:单文件净 −1 行,CI 全绿;全表五行逐行审计(3 真保留);逆向验证证明新链接落在门禁可判定面(改坏即红点名)。

裁决记录:

1. 幽灵行识别升级了处置:Compatibility 行在本页比 issue 描述更重 — cli 三类依赖零 spec、src 零 @objectstack 引用,无真相可指 → 删而非改指,与 docs(packages): 退役 36 个包 README 里已死的 release-metadata §Compatibility 生成块 #3688 的 client 幽灵行同判据。逐行「真相位置存在与否」决定改指 vs 删,记入方法库。
2. Node 行改指根 engines 且重新上膛检查(rc.5/>=22/17.0.0 修后仍零命中)— docs(scripts): 按真实机制改写两处 Lychee 门禁描述,并删掉 judgeHref 重复注释 (#3587) (#3648) #3656 规矩执行到位。
3. release-notes 保护面扩到 :58(自行量到第二处历史行)并记录防误伤 — 好。
4. 新发现 观察记录:文档散文里的版本宣称无门禁可守 —— #3688 + #3689 把它清到零之后,没有任何东西阻止下一个作者写回去 #3697 入队即派(版本宣称门禁 — 两清扫 PR 刚清零该族,先清账后上门禁的窗口正开着,content/docs 有 16 个失效的相对链接,且 check-doc-links.mjs 对相对链接一律放行 #3479/content/docs 有 18 条链接在站上是 404,但 check-doc-links 按设计放行(1 条相对链接跑出 docs collection + 17 条 /spec /protocol /api /examples 绝对链接) #3490 对照的正确顺序)。

版本入散文族清扫闭环:#3645(36 README)+ #3689(cli.mdx),门禁 → #3697。

---

Generated by Claude Code