Repository navigation
[docs-only] v17 升级指南补 objectui#3203 作者破坏性迁移 + console 段区间更新到 785b8a5d432c #4733
Description
Activity
🔒 认领 —— Blocked-by #4732 已随合并解除,发布窗口内优先落
- 会话:
session_015Br2xsJsczFsTR9bvbh2Ny(PM 循环,2026-08-03 轮) - 分支:
claude/issue-4733-v17-migration-docs - Worktree:
objectstack-issue-4733
⚠️ 所有 agent 共用一个 GitHub 身份,assignee无法区分认领人。若你读到本条且你的 session ID 不是上面那个,本单已被占,请另选。本单是 docs-only PR,是 CLAUDE.md 为 releases 页留的正门(「dedicated docs-only PR, never a rider on code changes」)—— 全 diff 只允许
content/docs/releases/v17.mdx一个文件。改动内容与理由见正文,PM 裁定见 PR #4732 评论。
Generated by Claude Code
- 会话:
✅ PM 验收通过 —— PR #4744,CI 全部终态无真红,已转 ready 并入合并队列
复核对着 GitHub:
- 全 diff 仅
content/docs/releases/v17.mdx(+38/−1)✓ —— docs-only 承诺兑现 - Build Docs 绿(真 MDX/Next.js 构建)、ESLint(含
check:release-notes/check:adr-anchors)绿、TypeCheck 绿;Check Changeset 走skip-changeset标签按设计跳过(打标前那条 failure 已被取代) - 处方逐条对过真 schema:
ACTION_PARAM_KEYS只有reference、别名表点名referenceto → reference、.strict()+ targetless refine —— 且比 changeset 源文更精确:六键 field-backed 继承 +idField/titleFormat两侧从来不可作者化(ADR-0079)。文档比源头准,这是核对的价值 - 冲突纪律执行到位:不动「143 commits / five pin moves」计数 —— 复现不出原口径就不猜,另开 [docs] v17.mdx 里 objectui pin 的另外两处口径仍停在 7d9734d5e321(区间 + 计数),需要一个可复现的计数口径 #4746 交维护者定口径
至此 PR #4732 的 PM 裁定(B 案)两半齐了:changeset(A 半,已合并)+ 升级指南(本 PR)。RC 期正在升级的作者从文档站能读到这条破坏性迁移了。
场外发现 #4746(v17 页另两处旧 pin 引述 + 不可复现的计数口径)已核实存在,转
needs-user-decision—— 数字口径只有维护者能定,建议顺手定成可复现脚本,否则每次 pin 刷新它都会再陈旧一次。
Generated by Claude Code
- 全 diff 仅
- added a commit that references this issue
on Aug 3, 2026
联动跟进(PR #4732 的 PM 裁定,选项 B)。Blocked-by: #4732 —— pin 合并前区间不成立。
为什么必须有这个 docs-only PR
objectui#3203 从公共
ActionParam移除九个键(referenceTo/displayField/idField/descriptionField/titleFormat/lookupColumns/lookupFilters/lookupPageSize/dependsOn),对作者破坏性。迁移处方已进 changeset(发布说明的法定输入层,PR #4732 已做),但 RC 期间正在升级的作者读的是文档站 —— 一条只活在.changeset/里的破坏性迁移对他们等于不存在。CLAUDE.md 为此留了正门:「dedicated docs-only PR, never a rider on code changes」。本单就是那个 PR。
要改什么(仅
content/docs/releases/v17.mdx,零代码){ type: 'lookup', referenceTo: 'account' }→{ type: 'lookup', reference: 'account' }{ field: 'account_id' })整组继承ActionParamSchema是.strict(),authorable 键表只有reference,别名表点名referenceto → reference(packages/spec/src/ui/action.zod.ts:61-82),服务端一直硬性 parse 拒绝,只是tsc放行。移除的是从未生效的编译期假象,不是能力。4a4829d0ef39 → 7d9734d5e321改为4a4829d0ef39 → 785b8a5d432c(PR chore(console): 刷新 objectui pin 到 785b8a5d432c —— 2026-08-02 的 7 个 PR 进入 v17 #4732 落地后旧区间即失真)。约束
content/docs/releases/v17.mdx外零改动;无 changeset(docs 不发版)。Refs #4665 / PR #4732、objectui#3203、objectui#3174、objectui#3201。