联动跟进(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,零代码)
"Breaking changes & migration" 补 objectui#3203 一条 ,含处方与理由:
内联 picker 目标:{ type: 'lookup', referenceTo: 'account' } → { type: 'lookup', reference: 'account' }
其余八个键:改 field-backed({ field: 'account_id' })整组继承
理由原样带上(说明这不是回退):九个键从来就存不进去 —— ActionParamSchema 是 .strict(),authorable 键表只有 reference,别名表点名 referenceto → reference(packages/spec/src/ui/action.zod.ts:61-82),服务端一直硬性 parse 拒绝,只是 tsc 放行。移除的是从未生效的编译期假象,不是能力。
console 段(约 :1917)区间更新 :4a4829d0ef39 → 7d9734d5e321 改为 4a4829d0ef39 → 785b8a5d432c(PR chore(console): 刷新 objectui pin 到 785b8a5d432c —— 2026-08-02 的 7 个 PR 进入 v17 #4732
约束
docs-only :除 content/docs/releases/v17.mdx 外零改动;无 changeset(docs 不发版)。两轴记录:changeset 单一输入不破(A 已做);authoring-time 拦截靠文档站可读,这正是该迁移的全部价值。
Refs #4665 / PR #4732 、objectui#3203、objectui#3174、objectui#3201。
联动跟进(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。