metadata-admin 的 `record:details.sections` 块设计器没有 `name` 输入位 —— Studio 搭出来的 section 结构上无法翻译,且必然挂着上游 `translation-section-name-missing`

[yinlianghui]

发现于 #3807 的实施过程(围栏外,本 PR 未夹带)。未认领,交 PM triage。

机制

packages/app-shell/src/views/metadata-admin/previews/block-config.ts:310-321,record:details 的 sections 数组条目只给了三个 itemFields:

itemFields: [
  { name: 'label',   label: 'Label',   kind: 'text' },
  { name: 'columns', label: 'Columns', kind: 'number', placeholder: '2' },
  { name: 'fields',  label: 'Fields',  kind: 'field-list', objectFrom: 'page' },
],

缺的是 name。而 pin 版 @objectstack/spec@17.0.0-rc.5 的 RecordDetailsProps.sections[].name 的 describe 明确它是 i18n 锚点:Stable section identifier for i18n lookup (snake_case) — resolves objects.{object}._sections.{name}.label; a nameless section renders its authored label in every locale。渲染器实读也确实如此(packages/plugin-detail/src/renderers/record-details.tsx):

const translatedTitle = s.name && objectName
  ? sectionLabel(objectName, s.name, rawTitle ?? s.name)
  : rawTitle;

sectionLabel 的键约定在 packages/i18n/src/useObjectLabel.ts:419({ns}.objects.{objectName}._sections.{sectionName}.label)。s.name 缺失时直接退回 authored label —— 于是在设计器里搭出来的每个 section,在所有 locale 下都显示同一串作者当时敲进去的文字,而且在 UI 里没有任何位置能补上锚点。

上游 spec 那段注释还写着:packages/lint 的 translation-section-name-missing 规则存在的目的就是提醒作者补 name。合起来就是:设计器产出的页面必然挂着一条作者在设计器里修不掉的诊断。

建议

给 itemFields 加 name(kind: 'text'),并顺带决定两件小事:

• 是否做 snake_case 校验 / 从 label 自动派生一次(派生要避免把已翻译的 label 变成锚点);
• 已存在的、只有 label 的 section 打开设计器时 name 留空还是回填。

同一设计面 #3807 已把发布给作者的 sections 说明改成对象形并写清 name 的语义,所以"作者知道要写 name、但设计器没有格子"这个落差从本单开始是可见的。

参考位置

• packages/app-shell/src/views/metadata-admin/previews/block-config.ts:310-321
• packages/plugin-detail/src/renderers/record-details.tsx —— sectionLabel(objectName, s.name, ...)
• packages/i18n/src/useObjectLabel.ts:419 —— 键约定
• packages/plugin-detail/src/index.tsx —— record:details.sections 的 input 说明(record:details 的 sections input description 还在教已被 spec 退役的「Section IDs」形状,渲染器只认对象形 —— 照 manifest 写出来的 sections 一条都不渲染 #3807 后)

关联:#3807、#3134(表单布局设计器的 i18n,邻域但另一个设计面)、objectstack#5611

[claude]

Triage: pm:queue (objectui in-repo card — pm-state only).

Anchor verification (on origin/main @ c852682): packages/app-shell/src/views/metadata-admin/previews/block-config.ts — the record:details sections itemFields array carries exactly label / columns / fields and no name (verified at :310-321 region). The renderer's i18n anchor read (record-details.tsx, sectionLabel(objectName, s.name, …)) and the plugin-detail input description that now documents name as the i18n anchor (post-#3807) are both live at this ref — so the designer demonstrably cannot author the key the renderer and lint (translation-section-name-missing) expect.

Why queue: concrete defect, single named landing site, fix is one added itemField. The two open sub-questions (snake_case validation / derive-from-label; empty-vs-backfill on open) are implementation-level choices reviewable in the PR — neither changes a public contract.

Dedup: #3134 is the neighboring designer surface (form layout), different design face; #3807 changed the published description, not the designer. No duplicate.

本评论来自分诊座位 Routine（#5474 试点），不构成认领。

---

Generated by Claude Code

[yinlianghui]

🔒 认领(objectui shard PM,session session_01GTRjn8xBqp75dk7kFupVRt)

• 分支:claude/issue-3819-sections-name-field
• 修法按分诊:record:details.sections 的 itemFields 补 name(kind: 'text',i18n 锚点);两个子问题按分诊定性为实现级选择,dev 判后在 PR 里说明 —— ① snake_case 校验/从 label 派生(派生须避免把已翻译 label 变锚点,倾向不自动派生只校验或提示);② 既有仅 label 的 section 打开时 name 留空不回填(回填有把译文固化成锚点的风险)。两处判断如与实测冲突,以实测为准并报告。
• 文件面:packages/app-shell/src/views/metadata-admin/previews/block-config.ts + 对应测试;浏览器实证设计器真的长出该输入位(worktree 有 scoped verify skill)。
• 与在飞 record:related_list.add.picker.filter 全仓零读点:作者限定了 Add 选择器的候选范围,对话框照样提供该对象的全部记录 #3831(plugin-detail/fields)零相交;[Studio i18n] 表单布局设计器未解析已有的对象字段和分组翻译 #3134(表单布局设计面)另单不碰。

---

Generated by Claude Code