rc.4 发布前置:v17 升级指南收录两条 console 破坏性迁移 + console 段 pin 区间行更新 + vendored changeset 的 flow 条目补 BREAKING 标注

[hotlong]

rc.4 发布前置单(维护者 2026-08-07 宣布今日发 v17.0.0-rc.4,指示按发布优先级处理)。缺口三处,全部来自 #6089→PR #6097(console pin 刷新)验证时的如实记录 —— 当时按纪律「只报不改」,现在到了改的时刻。

缺口(PR #6097 正文已逐项取证)

1. content/docs/releases/v17.mdx 的「Breaking changes & migration」章节完全不含两条 console 破坏性迁移:
   • 042e09d77 — widget 元数据收敛到 field 单键,退役 schema(objectui#3233);
   • 6e794a19e — flow 节点几何收敛到 spec 的 FlowNode.position,退役自有 ui: { x, y }(objectui#3172)。
     实测 field-widget / withFieldCarrier / FieldWidgetComponentProps / objectui#3233 / FlowNode.position / node.ui / objectui#3172 在整个 content/docs/ 下 0 命中。两条作者侧破坏性迁移目前只活在 .changeset/(发布记录的输入层),RC 期间正在升级的作者在文档站上读不到 —— rc.4 一发,这就是新用户第一眼撞上的坑。
2. 同页 console 段标题的 pin 区间行陈旧:仍写 bundled objectui advanced 4a4829d0ef39 → 785b8a5d432c,chore(console): 刷新 objectui pin 到 f995a452d2ca —— 98 个 commit / 64 条 releasing changeset / 2 项 v17 破坏性变更进入 v17 #6097 落地后实际已是 → f995a452d2ca(第 1969 行附近)。属事实错误,按 CLAUDE.md 第三条走 dedicated docs-only PR 修正正当。
3. .changeset/console-f995a452d2ca.md 的 flow 几何条目缺 BREAKING 标注(objectui pin bump 生成的 console changeset 对破坏性变更零标注 —— digest 只认 major 声明级别,而 objectui 在 v17 窗口内把破坏性声明为 minor + 正文标注 #6099 记录的机制性盲区在本次的实例):widget 那条条目自带 **BREAKING (v17)**(源 changeset 首段有标注,digest 读首段);flow 那条的破坏性陈述在源 changeset 正文靠后段落,digest 读不到 ⇒ 编译出的发布记录里它读起来像普通行为修复。源头(objectui 侧 changeset)确实声明了破坏性,本条是把源头真相还原到 vendored 条目上的一行文字修正 —— ⛔ 不改 digest 脚本(那是 objectui pin bump 生成的 console changeset 对破坏性变更零标注 —— digest 只认 major 声明级别,而 objectui 在 v17 窗口内把破坏性声明为 minor + 正文标注 #6099 的机制问题,另案),只改这一处已落地的静态文本。

交付形态(⛔ 拆两个 PR,不合一)

• PR A(docs-only):content/docs/releases/v17.mdx —— 在 Breaking changes & migration 章节按该页既有条目格式补两条迁移(迁移写法的源材料 = objectui@f995a452 的两份 changeset 正文 + objectui#3233/objectql: 批插入部分成功 API——根治降级重写下 beforeInsert 钩子 at-least-once(#3152 跟进) #3172),并更新 console 段 pin 区间行。⛔ 除此页外不碰任何文件;走 skip-changeset。
• PR B(changeset 文本一行):.changeset/console-f995a452d2ca.md 的 flow 条目行补 **BREAKING (v17)** — 前缀,格式与同文件 widget 条目逐字对齐。⛔ 不碰任何其他文件;该 PR 本身改的就是 changeset 文件,无需 skip-changeset(dev 核实 Check Changeset 判定)。

时间敏感性

rc.4 计划今日发。两个 PR 都是小改动,应赶在 release run 之前落地,使 rc.4 的发布记录与文档站同时诚实。

关联

• 跑 pnpm objectui:refresh 并落 console pin —— pin 落后 objectui main 98 个 commit,两条 v17 破坏性变更与 102 条待发 changeset 声明目前进不了 v17 #6089 / PR chore(console): 刷新 objectui pin 到 f995a452d2ca —— 98 个 commit / 64 条 releasing changeset / 2 项 v17 破坏性变更进入 v17 #6097 —— 缺口的取证出处(console pin 刷新)
• objectui pin bump 生成的 console changeset 对破坏性变更零标注 —— digest 只认 major 声明级别,而 objectui 在 v17 窗口内把破坏性声明为 minor + 正文标注 #6099 —— digest 只认 major 级破坏性的机制盲区(本单第 3 项是其实例修正,机制修复不在本单)
• chore(console): 刷新 objectui pin 到 785b8a5d432c —— 2026-08-02 的 7 个 PR 进入 v17 #4732 —— 同形前例当时记录的同一落点问题(框架 B:changeset + 独立 docs-only PR)
• objectui#3233 / objectui#3172 —— 两条迁移的源 issue

落点

content/docs/** + .changeset/(文本)⇒ 按 SKILL 兜底读法落 devx;domain:* 标仍留分诊座位。

[hotlong]

⛔ 认领(claim)

• 会话:session_01BDmDsu2575gDxeMCxXhDE3(devx 车道执行座位 PM;本单即本座位按维护者今日 rc.4 发布指示所立)
• 分支:PR A claude/issue-6106-v17-guide-console-migrations;PR B claude/issue-6106-flow-changeset-breaking-marker
• 文件面:PR A 仅 content/docs/releases/v17.mdx(docs-only,CLAUDE.md 第三条的正当路径);PR B 仅 .changeset/console-f995a452d2ca.md 一行 —— 与在飞 feat(scripts): check-override-consistency 增加 override 消费者体检与自失效上界报告 #6093/feat(scripts): 派发前框架新鲜度自检门禁 —— 三份框架副本 vs origin/main (#5866) #6105 全不相交。
• 前提复核(claim 时点):PR chore(console): 刷新 objectui pin 到 f995a452d2ca —— 98 个 commit / 64 条 releasing changeset / 2 项 v17 破坏性变更进入 v17 #6097 已 MERGED(pin = f995a452),两缺口与标注缺失均为其验证记录的现行事实;objectui pin bump 生成的 console changeset 对破坏性变更零标注 —— digest 只认 major 声明级别,而 objectui 在 v17 窗口内把破坏性声明为 minor + 正文标注 #6099 open 未认领(机制修复不在本单)。
• 时间敏感:rc.4 今日发布,release run 前落地。

派 1 名 os-dev(发布优先级)。

---

Generated by Claude Code