`record:details` 的 `sections` input description 还在教已被 spec 退役的「Section IDs」形状,渲染器只认对象形 —— 照 manifest 写出来的 sections 一条都不渲染

[yinlianghui]

发现于 #3797 / PR #3806 的实施过程(全仓 registry inputs × ComponentPropsMap parity 门)。该门只判键名,判不到 description 的内容,所以这条从旁边掉出来。未认领,交 PM triage。

与 #3407 / PR #3795 修的 record:highlights.fields 是同一个失效,只是换了 block —— 那次是 description 把条目形状写成 {name,label?,icon?,type?}、漏了渲染器已兑现的 readonly;这次更重:description 写的形状spec 已经退役、渲染器根本不认。

机制

packages/plugin-detail/src/index.tsx:249 的声明:

{ name: 'sections', type: 'array', label: 'Sections', description: 'Section IDs to show (required when layout is "custom")' },

而 pin 版 @objectstack/spec@17.0.0-rc.5 的 RecordDetailsProps.sections 是对象数组,z.array(z.object({ name?, label?, columns?, fields })),description 原文:Field groups rendered as the detail body, in order. Object form: { name?, label?, columns?, fields }.。spec 那段注释还专门写了这次收敛的理由(objectstack#5611):

直到 17.x 这个键是 z.array(z.string()) ——「section IDs」—— 而本仓没有任何页面、objectui 没有任何读路径用过它:RecordDetailsRenderer 把每个条目都当对象映射(s.name / s.label / s.fields),没有任何 string 分支;@object-ui/types 的 RecordDetailsComponentProps 镜像声明的是对象形;Studio 的 block 设计器只能写 {label, columns, fields}。ID 列表那种拼法是「无 producer 也无 consumer 的声明」,所以是删掉而不是 union 进来:一种形状,不是两套事实契约(Prime Directive #12)。

也就是说 spec 已经把「Section IDs」这条拼法删了,而本仓的 inputs 还在把它当唯一说明发布出去。inputs 是 gen-manifest.ts 序列化进 sdui.manifest.json 和 sdui-intrinsics.d.ts 的东西 —— 读 manifest 的作者(尤其是 AI 作者)会照着写:

{ "type": "record:details", "properties": { "layout": "custom", "sections": ["contact_info", "address"] } }

后果链条,每一层都不报错:

1. manifest 门只看顶层 prop 名 + 粗类型(array),['contact_info','address'] 是合法 array,零诊断;
2. RecordDetailsProps 是普通 strip 模式 z.object,不过 .strict(),但 sections[] 的元素校验会拒 —— 只有在真的走 parse 的路径上才拒(objectstack validateComponentProps 是 advisory/warning 级);
3. RecordDetailsRenderer(packages/plugin-detail/src/renderers/record-details.tsx)对每个条目读 s.name / s.label / s.fields,字符串上这三个全 undefined → 该 section 一个字段都不渲染;
4. 页面看起来「就是空的」,没有任何报错指向 sections。

layout: 'custom' 时 sections 是详情页正文的唯一来源,所以照 manifest 写的作者拿到的是一张空白详情页。

建议

按 PR #3795 的同一做法:description 从 spec 的形状派生着写,并把机器可读的那半补上 —— 至少把对象形写清({ name?, label?, columns?, fields },以及 name 是 i18n 锚点、columns 是本 section 的字段栅格宽度)。顺带看一眼同一处的 fields(:250)与 spec 的 fields / hideFields 是否也漂了。

sections 这种「数组元素带自己形状」的 input 在门里是看不见的(见 PR #3806 头注的 LIMIT 段:ComponentInput 没有成员形状声明位,这也是 PR #3795 那条 open question 存档的原因),所以这类漂移目前只能靠人看,或者靠那条 open question 落地后才机械可查。

参考位置:

• packages/plugin-detail/src/index.tsx:239-251 —— record:details 的 inputs
• packages/plugin-detail/src/renderers/record-details.tsx —— 只认对象形的映射,及 :147 的 hideFields 读点
• spec packages/spec/src/ui/component.zod.ts 的 RecordDetailsProps(objectstack#5611)

关联:#3797 / PR #3806、#3407 / PR #3795(同族,record:highlights.fields)、objectstack#5611、objectstack#5068

[yinlianghui]

分诊判级(objectui 分片 PM,session_01GTRjn8xBqp75dk7kFupVRt):bug + pm:queue,可派。判据:与 #3407/PR #3795 修的 record:highlights.fields 同族且更重 —— manifest 教的是 spec 已退役的形状,照抄的作者在四层零诊断后得到空白详情页(layout:'custom')。修法有 #3795 现成范式(description 改为对象形 + spec 推导 parity 断言)。派发时与 PR #3806 的门对齐:该 description 修正后应能被(未来的)成员键断言覆盖。

---

Generated by Claude Code

[yinlianghui]

🔒 认领(objectui 分片 PM,session_01GTRjn8xBqp75dk7kFupVRt)

• 分支:claude/issue-3807-record-details-sections-desc
• 文件面:packages/plugin-detail/src/index.tsx(:239-251 的 record:details inputs)+ spec 推导 parity 测试(按 PR fix(plugin-detail): record:highlights 的 fields 声明补上 readonly,让 manifest 能被作者读到 (#3407) #3795 范式,可扩展 recordHighlightsInputs.spec-parity.test.ts 或新建 sibling)。顺带核对同处 fields(:250)与 spec fields/hideFields 是否同漂(核对后按围栏处置:description 同修入本单,新 input 声明属 parity 门的反方向没推到全仓:7 个 block 共 15 个 spec 已声明的顶层键没有任何 inputs 发布,其中 3 个渲染器实读(record:details.hideFields / record:related_list.relationshipValueField / element:text_input.defaultValue) #3808 范围不夹带)。与在飞 #3546切片三(i18n)/行动作声明 visible: false 仍然渲染该菜单项——可见性门用真值判断（#3492 在行菜单上的未收口部分） #3758(plugin-grid+data-table)/data-objectstack 的 queryDataset 返回类型漏掉 fields[].percentScale,而 #3136 明令渲染端必须按它缩放 #3752(data-objectstack)文件面不相交;⚠️ parity 门的反方向没推到全仓:7 个 block 共 15 个 spec 已声明的顶层键没有任何 inputs 发布,其中 3 个渲染器实读(record:details.hideFields / record:related_list.relationshipValueField / element:text_input.defaultValue) #3808 与本单同触该文件,不同批 —— 本单落 main 前不派 parity 门的反方向没推到全仓:7 个 block 共 15 个 spec 已声明的顶层键没有任何 inputs 发布,其中 3 个渲染器实读(record:details.hideFields / record:related_list.relationshipValueField / element:text_input.defaultValue) #3808。
• 修法:description 从 spec RecordDetailsProps.sections 形状派生着写(对象形 { name?, label?, columns?, fields } + 语义),按 fix(plugin-detail): record:highlights 的 fields 声明补上 readonly,让 manifest 能被作者读到 (#3407) #3795 已确立范式;spec 措辞以实装 pin 版实读为准。

即将派发 os-dev 实施。

---

Generated by Claude Code