yugoo-design 0.2.6 → 0.2.8

package/payload/overlays/claude-code/authoring/studio-creators/source/docs/panel-uiux-standard.md

@@ -52,15 +52,33 @@ Bundle 作者决定业务信息的归属、关系、次序和合适的已支持
 表达方式。前两者复用或增强共享层；最后一种才增加形态，并给出真实用例、适用边界
 和状态/交互约定。不能为一个 Bundle 在共享层硬编码名称或复制整套导航、输入样式。
 
-结构导航统一采用 14px / 20px 行高、最小36px行高、8px内边距；长标题自然增高，
+结构导航与卡片导航的顶层条目表面共用16px基础左右留白；标题图标与工具栏沿同一16px基线。结构导航统一采用 14px / 20px 行高、最小36px行高、8px内边距；无图标平项的文字因此距栏边24px。有独立展开列时，文字按钮仍保留自身的左右8px留白，真实层级继续缩进，不用空图标强凑文字列。长标题自然增高，
 不固定高度后让文字溢出。工作区导航标题14px常规字重，分组与选中项500，普通项400。
+结构导航和卡片导航共用这套文字角色，紧凑密度都随所在容器降为13px；内层标签
+继承按钮状态，不再独立声明字重。“两层卡片”表示内容组织不同，不表示全部项目加粗。
+工具栏内的分段视图切换使用紧凑导航字号13px / 20px行高，普通项400、选中项500；
+不随正文密度放大为14px，层级通过位置与选中底色表达。
+宿主底部的「设计面板／场景体验／关联图谱」（Panels / Scenarios / Relationships）视图切换共用最小52px高的底栏，右侧操作保留完整按钮与上下留白。
+选中项对应的2px品牌色亮条贴着整个底栏与内容区相接的上边界，不浮在文字上方；导航占满底栏高度，
+窄屏可将右侧操作移至下一行，但视图导航保留第一行。三种视图复用同一布局，不继承专业画布的按钮造型。
 可选状态/注记独占不压缩的行尾位置，对齐首行；无状态时不占空位，也不虚构状态。
 真实层级保留缩进和展开；Function Module、Flow、Research、业务对象、角色等使用
 同一结构样式。问题轮次保留“两层卡片”，不强行归并成树。
 
+对支持新增的导航集合，新增入口统一放在所属集合末尾，使用共享 `PanelWorkspaceTreeAdd`；
+筛选使用侧栏标题旁的图标入口，保留当前筛选的可访问名称与悬停提示，非默认筛选保持高亮；
+不为单一筛选保留一整行空工具栏。移动入口时保留原有新增行为：
+本地新增仍写同一份草稿，已有宿主 Agent 请求仍走原对话；不为只读产物虚构可用的新建操作。
+分组若只是记录的派生标签，不因补一个“添加分组”按钮而变成新的业务实体。
+
 宿主内 Panel 变窄时，仍保持左侧导航和右侧内容的方向；不自动把树或问题轮次移到
 顶部、改排成横向菜单。沿用现有的导航分隔条调整宽度，保留选中、展开和滚动位置。
 
+多 Panel 的顶部标签栏用轻微对比区分背景；选中标签与下方工作区使用同一底色，
+底边直接相接，悬停时也保持连接。详情章节标题栏延续工作区底色，以文字和细分隔线
+建立层级；正文卡片、输入框保留各自的表面边界。普通阅读和编辑内容统一铺满工作区分配的正文宽度，扣除既有公共边距；问答、连续卡片、详情表单和公共规格不各设最大宽度或居中规则。可用宽度由工作区及其分隔条管理，不由 Bundle 或内容块决定。表单内的属性表随所属正文布局，宽列保留局部滚动；专业画布和预览保留自身布局。内容卡片与分组遵循下述表面层级。明暗主题均需能看出选中的标签，
+不能只依赖文字颜色，或因宿主将多个背景层映射为同色而失去轮廓。
+
 专业组件可保留领域行为（如流程节点联动画布），但导航条目、分组、展开和新增入口
 必须复用已有工作区公共组件，不能在专业分支内重新实现这些基础交互。零子项不显示
 空展开箭头。应用配色等选择动作保留 `aria-pressed` 与只读保护，复用公共侧栏及选择
@@ -75,6 +93,170 @@ Bundle 作者决定业务信息的归属、关系、次序和合适的已支持
 
 从 Skill 扩展交互式 Bundle 时，围绕这些问题寻找贴合任务的表达。提问、对话或后台执行不决定其交互价值；例如问题卡片可帮助比较与回答，变更视图可帮助理解影响。保留原专业方法，让人的判断能够保存、修订并继续供 Agent 使用，不以补齐配置或展示聊天记录代替这条交互路径。
 
+### 内容卡片与分组
+
+卡片用于分隔完整的内容单元，不能由各 Panel 各自决定基础边框、圆角与留白。
+功能章节承托功能记录、问题题干承托回答、主要语义分区承托字段，是“柔和承托面→基础内容面”组合，
+这些组合使用同一底色方向。标题本身不决定底色；先判断用户在浏览集合、编辑一个对象、
+回答问题还是比较属性，再选表达。未分组的普通记录直接使用基础内容卡片。
+页面、章节与内容应能通过底色对比、留白和轻边界
+辨认，不能把完整记录扁平为同色文字列表。不同表面表达不同的信息层级，不是为了
+装饰而逐字段叠框。
+不为视觉效果创建虚假分组，也不在整个工作区外再套装饰性卡片。
+
+这里借鉴 [Apple HIG 的动态背景层级与一致语义](https://developer.apple.com/design/human-interface-guidelines/color)
+和 [Material 的 surface/container 角色](https://m3.material.io/styles/color/the-color-system)：底色帮助表达内容归属，
+与标题、留白和结构一起工作，而非单靠颜色识别信息。具体色阶由本系统的实际宿主主题验证，
+不照搬原平台的色值、材质或控件外观，也不要求每一层嵌套都增加一种颜色。
+[Apple 的容器指导](https://developer.apple.com/design/human-interface-guidelines/boxes)
+也提醒：已有容器内的关系可以通过留白和对齐表达，连续嵌套边框会增加视觉负担。
+
+公共界面语言按用户可感知的承载关系分配，不按 Panel 名称、存储类型或 DOM 深度分配：
+
+| 职责 | 表达与适用边界 |
+| --- | --- |
+| 工作区 | 安静的阅读背景，不代表选中、完成或业务分组 |
+| 结构承托 | 功能章节、题干和对象内有明确任务含义的主要分区使用 muted，所属独立记录、答案和完整字段正文使用 base；字段正文包含标签、说明与控件，不能只把输入框底色当成内容分层；普通布局行或嵌套小标题不因此新增表面 |
+| 普通记录 | 卡片形态统一 base 表面与普通边界；整页详情不为一致而额外套外卡 |
+| 阅读条目 | 需要逐项辨认的已存答案使用 base 内容面与正文色；普通段落与密集表格保留原组织 |
+| 编辑控件 | 真实输入边界、焦点、选择状态与原操作共同表达可编辑；静态阅读项不伪造这些反馈 |
+
+功能模块与智能提问均为“柔和标题容器→基础内容面”。问题组在题目容器之外用章节标题和
+间距组织，不再叠加第二层柔和外框。阅读与编辑维持这个方向，用实际输入边界、焦点与操作
+区分交互状态；不靠反转底色区分。深色模式沿用相同表面职责，不规定内容必须比外层更亮。
+判断可迁移性时同时检查卡片列表、详情表单与表格，而非把一种页面形态复制给所有面板。
+
+| 内容场景 | 共享表达 |
+| --- | --- |
+| 智能提问 | 题干与说明使用柔和容器，真实答案使用基础内容面；已声明的问题组保留标题、顺序和结构，避免重复承托框 |
+| 功能模块 | 真实功能分组使用章节底色，组内各功能保留独立卡片；未分组时直接排列记录卡片 |
+| 业务对象、AI 能力等完整子对象编辑 | 有名称的完整子记录集合以柔和承托面包含集合标题、按需帮助、独立的基础记录卡和末尾添加操作；单条卡片内部沿用真实输入。已有章节负责同一集合时复用其承托，不重复套框。整页当前对象不额外套集合框 |
+| 一个对象内部的字段分组 | 主要语义组用柔和章节承托与完整基础正文形成层级，常显或折叠不改变配色；连续字段共用正文面。组内布局行和小组靠间距组织；已有独立记录卡的集合直接沿用原卡片，不再增加同色外卡 |
+| 具名结构化阅读 | 顶层业务段落沿用同一章节与正文组合，完整对象列表复用记录卡片；内部标签与值按普通字段纵向排列，不因只读改用递归两列表格或独立卡片样式。同级顶层章节（包括引用和未知内容）使用同一容器，默认折叠只决定开闭；嵌套字段不另造章节，未知键和值仍可阅读 |
+| 简单条目与属性比较 | 一条语句用列表，同列属性用表格；存储为 `record_map`、列数或紧凑布局标志都不是新增卡片层级的理由 |
+| 离散值选择 | 选项、已选值与移除操作表达选择状态；简短标签可用 chips，真实图标/说明可用 cards，不把选择值当作子对象 |
+
+普通记录表面统一由 `dsh-panel-content-card` 在共享基础中维护：普通边界语义（`--ds-border-default`）的1px边框、
+8px圆角、16px内边距与卡片间距；紧凑密度沿用12px组间距。章节和问题容器使用共享
+`dsh-panel-content-group` 的12px内边距、12px圆角和柔和底色，与记录的基础表面区分。
+深色模式同样保留可辨认的表面明度差，不照搬白色。分组和记录标题使用
+14px / 500；当前打开对象或工作区的主标题使用600，同页内容分组与重复记录标题使用500，普通字段标签、说明和输入值使用400。
+同排纯文字的标签与值按首行文字基线对齐，保留说明与正文各自的字号；值换行时标签仍对齐首行，
+不用顶部对齐、像素偏移或统一字号掩盖差异。纵向字段、图标、徽标和输入控件保留各自的布局规则。
+记录标题到直接正文、字段标签到控件使用共享8px间距，紧凑时6px；记录标题到一组具名字段、独立卡片、字段或章节之间使用16px，紧凑时12px。父容器按这两种关系管理一次间距，不能用同一个等距布局
+把标题与首张卡片也当成两个独立记录。详情页优先按用户任务组织少量主要分区，
+由既有顶层具名 `form.group` 表达；内部布局组不重复套框，分组标题仍用500。操作性“功能详情”保持400，不因可以展开
+就变成章节标题。
+记录下半部的补充详情开关统一由 `PanelDetailDisclosure` 承担：收起时显示详情名称。紧凑字段表单展开后，收起箭头与首字段标题同排并位于最右侧，给箭头保留独立热区，不留下隐藏名称后的空白行；保留可访问名称、键盘操作和正文挂载。未提供首字段标题的完整表单保留有名称的开关，不将箭头覆盖在未知内容上。此规则不隐藏业务分组或记录标题。
+独立记录与预设分区按内容职责区分，不按当前是否显示“添加”按钮、是否只读或由谁生成判色。
+可独立管理的记录保持基础表面与描边；主要分区使用同一 `dsh-panel-content-group` 承托，默认展开并支持整体折叠，
+整条标题栏按“标题 → 帮助／数量／操作 → 最右折叠箭头”排列；箭头位于整条标题栏最右侧，不能停在题干后、操作之前。展开前后位置稳定，并提供悬停与键盘焦点反馈。
+收起时标题命中区覆盖可见承托面内的留白；展开后仅标题区负责收起，正文编辑不会触发展开操作。
+正文沿用所属8px（紧凑6px）间距，连续的普通字段连同标签、说明、表格和添加操作共用完整基础内容面；
+自带独立记录卡的集合保留其边界，不套第二层同色卡片，关联预览也保留自己的布局边界。
+普通字段中的卡片集合与关联子记录编辑器遵循同一归属关系；固定章节、是否允许新增、只读或达到数量上限均不改变集合和条目的表面职责。
+集合的补充填写说明放在标题旁的共享帮助入口，可悬停、聚焦或点击查看，Escape 关闭；不在集合末尾重复占一行。
+当前对象的背景、实际校验错误和完成操作所必需的信息仍在相关位置直接显示，不因采用按需帮助而隐藏。
+同一详情正文中的普通分组、关联集合和继承集合共用正文区的左右边界，随容器伸缩，不逐组限宽或居中。权限等集合表格使用所属正文区的完整可用宽度，宽列在表内滚动；不因采用表格而越过同级分组右边界。标题栏、独立比较表与画布保留各自框架；表格与chips本身不各添一层承托框。
+是否有添加按钮或能否折叠不决定主要分区的表面。
+所有已有语义灰色内容组统一支持整体折叠，默认展开，允许多个组同时展开。
+折叠能力不取决于条目、字段、控件或选项数量，不为普通字段、chips 或选项另添容器。
+用户手动收起后，轮询、语言或只读状态变化不强制重开；正文保持挂载，增删内容与折叠均保留草稿和内部状态。
+同页同级内容统一采用分组承托或连续表单，不能只给备注增加灰色强调。
+当前条目的具体背景放在公共条目标题栏内，不用固定通用写作指令占据该位置；分组与字段说明放对应标题/标签后的共享帮助入口，
+悬停、聚焦或点击查看，不另占一行。真实业务描述、用户输入与即时错误不当作帮助隐藏。
+不要用填值数量代替内容概览或完成状态。当组只含一个字段且标题完全同名时，保留分组标题，
+内层字段标签仅作无障碍关联，必填提示显示一次。不同名、多字段及带关联预览的组保留各自标签。
+选项卡片根据真实标签、图标和说明自然增高；空的添加入口不预留说明高度。
+
+公共不变量是信息归属、字阶、关系间距、可辨的状态和可用操作；以上组合允许有意义的表面与密度差异。
+共享组件负责这些默认组合，Bundle 负责真实对象、关系和内容。新增变体先说明它帮助哪个判断或操作，
+并与现有模式对照；不因局部截图不同就新增样式，也不按组件名反过来合理化已出现的问题。
+统一 token 只是基础：实际组合还须由父布局管理所属间距，避免子控件 margin、祖先选择器和后置覆盖叠加。
+这里参考 [Fluent 的值与语义用途分层](https://fluent2.microsoft.design/design-tokens) 和
+[Carbon 的关系间距与父布局职责](https://www.carbondesignsystem.com/building-blocks/foundations/spacing/overview)，
+沿用本项目已有尺寸与组件，不另建主题系统。
+
+题干和可交互的章节标题使用同一文字盒节奏：20px文字行高，上下各4px由文字块或标题按钮
+管理一次，单行28px，多行自然增高。标题外行不重复加内边距；次要操作在首行28px槽内对齐，
+隐藏、悬停或聚焦不改变排版，也不缩小按钮命中区。动作同排时，最后一行文字盒到下方内容边界
+为12px（紧凑10px），包含标题下留白和8px（紧凑6px）内容间距。窄栏动作另占一行时保留该行
+及其间距，不为了凑同一数值而挤占题干。可编辑名称沿用自身输入控件高度，不重复添加文字盒
+留白；功能卡名称行到描述正文或其编辑框同样由一处8px（紧凑6px）间距管理。
+嵌套子表单保留已有32px操作命中区，标题行随按钮或长标题自然增高；标题行到表单同样为8px
+（紧凑6px）。单行文字到底部内容的实际距离还包含行内居中留白，不能只比较CSS gap就宣称
+像素相同，也不能缩小操作按钮或使用负间距凑齐。
+
+完整记录的边界不能降为宿主最淡的分隔线；未分组的卡片也必须在页面底色上可辨，
+不能依赖外层章节底色才能看清。一层正文容器负责页面留白，内部列表不重复增加左右内缩。
+柔和容器内部，需要独立辨认的已存答案使用共享 `dsh-panel-reading-item` 基础阅读表面：
+与承托面有可辨明度差，8px圆角、上下8px（紧凑6px）、左右12px内边距，
+正文14px（紧凑13px）/400/1.6。条目容器的外沿与所属标题对齐，内部留白表达其归属；
+这不等于重复叠加页面 gutter，也不把每个说明、标量字段或表格单元格都变成卡片。
+阅读项不添加输入边框、悬停编辑或可勾选外观；编辑态保留真实输入、焦点和原有操作。
+智能提问的一道题及回答仍是一个完整内容单元：多选答案按实际已存值逐条显示，单选为一条，
+自由文本为一个完整回答并保留换行，不按标点或换行制造多个答案。未答/跳过是状态，不伪造内容条目。
+题目的灰色外层默认展开，可由用户手动收起；`always_expanded` 只控制答案区域的阅读/编辑呈现，
+不禁止外层折叠。外层开关与编辑、完成、跳过等动作独立，收起不清空回答或取消编辑。
+只读或单列本身不是增加阅读表面的理由；集合须先验证逐项辨认的真实需求，不能按存储形状自动铺色。
+多属性表格沿用表头、行列与原编辑控件，
+记录摘要和普通字段帮助不机械套框。附件和专业附加内容保留自身布局，不用后代通配规则将其压平。
+题目优先获得可读宽度。紧凑内容槽内，题干和原操作可在标题栏内自然换行并保持可见，折叠箭头始终占整条标题栏最右侧，操作不排在箭头之后，
+不为隐藏按钮预留题干右侧空列，也不在悬停时改变卡片高度；空操作组不占行。宽栏保留原有同排及悬停/焦点入口。
+
+审查信息层级时，以实际呈现回答“属于哪一组、哪个是完整记录、在哪里修改”，
+不要以减少边框或加粗数量本身作为目标。并排比较相同宽度下的题干→答案、章节→记录，
+核对宿主解析后的承托/内容底色对：只有色差而方向相反，同样不算一致；不能用代码角色名
+合理化相反的阅读层次。详情内的字段分组保持500，不应
+重于外层记录标题；主题、窄容器与长内容下均复核这一层级。操作入口沿现有
+导航和工具区，不为了恢复内容表面而搬回旧按钮或重新增加工具栏。
+
+保留输入框、回答区、错误、继承与来源等有意义的边界和反馈，不使用后代选择器
+清除所有边框。紧凑表格、专业画布和用户生成的文档
+保留各自表达，不强行卡片化。复验应比较智能提问、功能模块和嵌套记录的实际组合，
+同时检查阅读、编辑、展开和滚动，不能只检查孤立卡片的类名。
+
+连续卡片用于需要对照相邻记录的阅读任务，例如功能列表和验收标准。验收卡片按既有字段
+直接展示条件与通过标准，有内容的验证方式紧随其后，不能拼成无标签摘要或另造执行状态。
+空必填项仍保留标签和原地编辑入口。普通字段用标签、段落和间距组织，不再套一层卡片。
+卡片标题到直接描述使用控件间距（通常8px，紧凑内容槽6px）；到结构化字段组使用组间距16px/12px。字段标签到值或输入框仍为8px/6px，不能把两层标题压成与一段正文相同的节奏。字段标签读编同为主文字色，不降成附注。添加、删除、顺序与未展示的来源信息保持原语义。
+分组卡片的上下移动作用于本组可见的相邻记录，保持其他组和被筛掉记录的位置；首尾动作
+按当前组判断。不能让“下移条目”意外变成整组换序，修改所属组仍通过原有分组字段完成。
+复杂对象仍可使用列表与详情，不能仅为整齐把所有工作区改成同一种导航。
+
+#### 阅读、编辑与动作
+
+普通记录卡片、已选对象详情与内部属性、状态和权限采用直接编辑。已有名称、描述、
+优先级及字段的每次修改统一进入面板草稿，不再设置卡片内“编辑／保存／取消”或保存后
+切换阅读外观。底部“取消／保存并继续”是整份面板的撤回和持久保存入口；普通导航、
+过滤和展开不能丢失输入。真正只读的记录仍用完整可读文本，不伪造禁用输入框。
+专业图形与公式编辑器保留其预览/编辑表达，不能以普通卡片规则改变专业内容语义。
+问答保留已回答后的反馈，不给自由文字题新增补充输入框或局部保存层。
+
+具有管理能力的白色记录卡片，编号在名称左边，上移、下移、删除按此顺序位于标题右侧，
+始终可见，不依赖hover；已有折叠箭头保持最右侧。管理动作操作当前记录，不能意外触发
+折叠；没有声明排序或删除能力的静态内容不虚构按钮，表格在行末操作列沿用同一几何。
+长标题使用剩余空间，普通文本允许换行；可直接改名的原生单行输入保留完整值。
+紧凑内容槽的卡片标题与管理动作分两行，动作行靠右，避免常驻按钮挤掉常见标题的关键文字，
+也不能缩小操作目标。新增保留在所属集合末尾。
+记录排序沿既有稳定身份和顺序绑定；受筛选分组仅与本组可见相邻记录交换，其他记录不动。
+拒绝状态不是删除：保留已拒绝记录的查看、过滤与恢复，但不另留一个悬停出现的删除入口。
+分组名直接编辑时只暂时稳定当前卡片的显示位置，离开后再归位，不延迟草稿更新或引入局部保存。
+
+可变尺寸的普通多行输入复用公共控件，空值和单行内容默认只占一行，按实际可用宽度与
+文本换行自动增高，默认最多5行（已声明的自动行数预算限制在3–5行）。更长内容在框内滚动，
+不截断内容；长placeholder不是实际内容，不能撑高空框。用户仍可原生拖高，手动高度不受
+自动5行上限限制，后续输入、外部重绘、容器变宽和折叠重开不将其压回默认高度。
+尺寸是字段自身的界面状态，不写入设计文件、不触发保存或Agent；不同字段不共用一次拖动尺寸。
+普通只读段落保持自然高度，第三方原生画布/专业编辑器及宿主对话框不被全局扫描改写。
+
+连续阅读区的侧栏表示当前阅读位置：点击定位条目标题，手动滚动同步高亮；收起的导航组
+仍能标明当前记录所在组。滚动仅发生在所属内容区，过滤、折叠和尺寸变化后重新判断实际
+可见条目，不跳回旧选中项、不抢焦点、不写设计数据。已拒绝但保留的记录仍可阅读，
+用状态与恢复操作区分；正文不按禁用控件降低透明度。
+同理，历史或只读问答里的已存选项仍是阅读内容：保留正常文字对比和选择标记，
+只锁定修改操作，不能把整条答案套成禁用按钮的淡色。
+
 ### 面板自查
 
 Studio 连续呈现同一请求的修改建议时，干净编辑器同步最新候选与诊断，并保留当前
@@ -129,7 +311,7 @@ Studio 连续呈现同一请求的修改建议时，干净编辑器同步最新
 | 理由、来源、报告和整体交付 | 可阅读正文、来源定位、章节导航 | `document_workspace` / `artifact_workspace`；日志不冒充研究结论 |
 | 未结构化想法 | 白板、草图、批注 | `canvas_workspace`；手绘线不自动成为 canonical 关系 |
 
-自由输入答案的简答题只提供一个答案输入区，不附加第二个补充输入框；选择题可以提供可选的“补充说明”。已有简答题保存的补充内容保留为只读上下文，使用同一“补充说明”标签，不另称“其他补充”；阅读态去掉“选填”后缀。该规则由共享问题组件提供，Bundle 不重建输入或改写标签。保留的上下文不冒充用户答案，也不在渲染时迁移或删除原值。
+自由输入答案的问答题只有一个答案区域；编辑态、阅读态和展开/收起时都不显示额外补充输入框或补充说明，不保留旧数据的只读兼容区域。选择题可以提供“补充说明”，阅读和编辑态使用同一个标签，不追加可选后缀。该规则由共享问题组件实现，Bundle 不重建第二个输入区；渲染不会把旧补充值自动拼进答案或改写已保存事实。
 
 普通表单与卡片详情中的多列简单 `record_map.columns` 复用共享表头的编号表格，不再每条重复集合标题。单列保留其所在场景的标题语义；带 `item_fields` 或折叠交互的复杂子表单保留卡片表达。窄容器由表格内部横向滚动，文本域按内容增高并可手动调整；变化只影响呈现，不改变稳定键、添加删除或保存语义。
 
@@ -149,6 +331,8 @@ Studio 连续呈现同一请求的修改建议时，干净编辑器同步最新
 
 需要用户引用编号的分组卡片可用 `board.id_field`，在标题旁用次级文字显示已有只读 ID；展开的内联详情沿用同一卡片标题，覆盖式详情在顶部保留编号。编号不是可编辑名称，不增加编号生成、回填或保存通道。
 
+记录标题按实际可用宽度分配空间：名称与其编辑图标组成一个整体，图标留在标题区域内；短编号保留自身宽度，名称在剩余空间内收缩。超长编号可在限定宽度内换行，不能与编辑入口重叠。沿用原单行名称输入和完整值，不靠隐藏操作、缩小点击目标或新增编辑流程处理窄栏；验收须检查相邻元素的实际边界，页面没有横向溢出并不足以证明没有重叠。
+
 总览用于定位和比较，详情用于精确编辑。只在需要时展示低频细节，但影响判断的冲突、权限、异常和未知不得隐藏。大图提供已支持的导航、筛选或相关邻域；不能把字号不断缩小来塞进所有节点。只读图明确只读；专业编辑器的文件格式、布局与保存屏障沿原契约处理。
 
 视图选择、展开和滚动属于界面状态；显式保存的画布坐标属于布局数据；对象和关系属于设计事实。不要互相推断。排序仅在契约已有顺序字段和实际操作时提供；引用编号只是定位，不自动生成 order 字段或上下移动按钮。
@@ -181,7 +365,10 @@ canonical 数据或保存；验收覆盖从详情返回画布及退出后新实
 是当前视图几何，不写成业务字段；重开视图仍按默认右出左入自动布局。
 只读模式禁止连线，单父、循环等领域限制仍走原记录创建与保存校验。
 自动取景（初始、恢复显示、自动布局、适应画布）最高100%，手动可继续放大；
-图的节点与完整标签共同参与布局。画布工具栏与内容区域保持16px两侧留白，
+图的节点与完整标签共同参与布局；关系图的长链按可用画布比例折行，不能为了
+显示全图把少量对象压成难以阅读的细横线。折行只改变视图几何，不改变关系、
+端口方向或设计数据。若布局库的折行造成文字重叠，保留完整标注的原布局与缩放操作，
+不能以压缩面积为由牺牲关系含义。画布工具栏与内容区域保持16px两侧留白，
 标题与按钮对齐，不能在全幅画布里让标题贴边。
 
 关系图、页面导航图、功能分组思维图复用 `PanelCanvasHandles` 与
@@ -192,6 +379,15 @@ canonical 数据或保存；验收覆盖从详情返回画布及退出后新实
 不把合成根节点当业务对象计数。只有已有可编辑关系契约的画布允许连线；
 派生思维图的端口只用于路由，不新增关系写入。页面地图既有布局坐标、
 frame 尺寸保存规则保持不变，不因复用控件而改成暂态数据。
+页面地图与公共规范通过现有画布工具栏右侧、添加操作旁的双按钮分段开关在同一区域切换，
+不为切换另占一行或重复标题栏；左侧页面地图图标、标题和数量代表工作区上下文，切换时保持不变。
+右侧开关位置不变，仅显示当前视图适用的操作。
+切换过程中，暂不适用的已有操作保留自然宽度占位、不可见且不可聚焦/触发，避免窄窗口跳行；
+不为本就没有添加能力的工作区虚构占位。动作组换行后仍右对齐。复用公共 Tabs 的
+选中状态、键盘操作和常驻内容，不新增弹窗或独立返回流程。右侧边缘开关只负责地图与
+具体页面详情，不承担公共规范的返回。切换保留地图视口、所选页面、预览与未提交内容，
+外层横向面板导航始终不变；具体页面详情沿用自己的标题栏和返回地图入口，不叠加地图工具栏。
+不把长规范正文挤在地图上方。
 
 KAG 的只读关联图谱沿用当前共享工作区的导航、搜索、筛选和详情基础，
 节点数量在底部状态区显示，布局说明放在视图设置中；画布顶部不重复显示数量提示或实现说明。
@@ -219,6 +415,17 @@ Canvas 内采用已确认的来源配色、细点细线和来源密度星云。
 记录与字段节点继续保留；完整名称、正文、来源与证据通过原有提示和同源详情查看，
 展开/收起入口显示真实内容数量。画布短标签不改写 canonical 名称或正文。
 
+图谱的右侧详情是普通只读阅读界面，复用公共标题、分组、正文、辅助文字和控件；
+专用样式只负责画布内的位置和响应式尺寸，不另设小字号表或固定窄标签列。
+首屏先呈现选中对象、关系含义、实际状态与已有操作；业务端点分段呈现，长句不与箭头、
+来源和状态挤在同一行。固定解释使用共享提示图标，不重复占据正文；来源、方向、分数、
+模型和 JSON 等诊断信息不作日常阅读内容，保留在默认收起的技术详情中。聚合关系只有在含义、类型、来源、方向和状态全部相同时
+才共用一次解释；候选、未知和采纳状态保持可见，差异状态按原关系分别展示。
+有真实文字依据时按正文展示，不能把结构化来源 JSON 当作业务解释，也不从分数编造结论。
+每条原关系的端点、原始标签和证据完整保留，技术定位与原始依据默认按需展开。
+来源面板使用已知友好名称，原文件、位置和类型仍可在来源详情查到。
+折叠和语言切换不重建图谱或清除选择、搜索、相机、固定位置，滚动应能到达原文末尾。
+
 连线标签表达关系含义，不重复节点已经展示的“A → B”端点名称。
 共享关系图仅对精确匹配两端名称的自动端点串作展示去重，保留关系类型、
 端点数量等说明及用户自定义的关系文字；无关系含义时不绘制空标签或占位框。
@@ -264,14 +471,35 @@ Bundle 的保存校验。未声明单父的业务对象多父关系保持原行
 
 | 信息角色 | 默认字号/字重 | 使用规则 |
 | --- | --- | --- |
-| 工作区标题 | 18px / 500 | 一次显示主要标题；不要重复产品名、页面名和 Bundle 名占满首屏 |
-| 详情名称、字段分组、关联内容标题 | 14px / 600 | 使用共享标题字重 token 和主文字色，与 400 字重的正文清楚区分；折叠前后保持一致 |
-| 重复记录卡片、树节点标题 | 14px / 500 | 保留紧凑浏览层级；功能卡片“功能详情”保留已确认的 400 字重 |
-| 主要正文、常规表单值、长文本编辑 | 14px / 400 | 默认阅读和编辑保持字号与文本起点一致，行高约 1.5–1.7 |
+| 独立页面主标题 | 18px / 500 | 一次显示主要标题；不要重复产品名、页面名和 Bundle 名占满首屏 |
+| 当前打开对象或工作区的主标题、详情名称 | 14px / 600，行高20px | 使用共享标题字重 token 和主文字色，突出当前查看的对象或范围；折叠前后保持一致。轮次、阅读产物工具栏及通用节点标题不能落回浏览器默认字号 |
+| 内容分组、重复记录卡片、集合标题、图中记录名称 | 14px / 500，行高20px | 下属关联集合及继承来源集合与普通分组同级，不因来源不同提升字重；树导航普通项仍按导航状态使用400/500；功能卡片“功能详情”保持400 |
+| 普通字段标签、主要正文、常规表单值、长文本编辑 | 14px / 400 | 标签靠位置与间距识别，不普遍加粗；默认阅读和编辑保持字号与文本起点一致，正文行高约 1.5–1.7 |
 | 摘要、辅助说明、密集次级字段 | 12px / 400 | 清楚但次要，不把主要说明、错误或所有字段机械缩为小字 |
 | 表格、行内编辑 | 按该内容角色 | 阅读/编辑同列对齐；避免切换导致列宽、行高和阅读位置突然变化 |
 
-卡片摘要可保留**阅读 12px、编辑 14px**的已确认模式：编辑是在更易输入的明确区域进行，而非每次聚焦都放大所有文字。标题不会因进入输入框降为正文；长篇正文不自动缩为摘要。默认规则若与已确认的原生/场景基线不同，应记录适用范围并在对应任务中迁移，不静默改写。
+普通排版角色统一由 `visual-components.css` 的共享排版区定义；组件只映射角色，
+不在各自布局规则中重复字号、字重和行高。当前 Web App Kit 的普通导航与表单均
+使用这套公共基础。背景色、表格结构、`strong`/标题标签和阅读/编辑状态不改变角色：
+当前对象标题与重复记录标题不同，重复记录不会因为沿用详情标题框架而升级为主标题。
+内层文本与编辑控件继承其角色，修改公共角色时移除旧声明及会重置字体的 shorthand。
+富文本强调和数学记法保留其专业语义；专业画布中的普通标题、分组与表单仍复用公共角色。
+中英文复核须检查同一宿主环境的实际字体回退和实屏效果，CSS 数值相同不能证明感知字重相同。
+
+字段标签不因使用表格、`rows`、紧凑 `record_map` 或选择器而提升字重；例如功能详情中的使用场景、核心行为、输入和异常处理均为同级普通字段。只有实际承载
+独立条目的集合标题使用分组层级；同一章节中的普通字段标签保持400。横向复核需
+比较不同控件的同级标签，不能仅检查章节标题与卡片标题。
+展开后的自定义填写标题、来源片段标题仍按分组角色使用14px/500/20px，
+不可继承 `strong` 的浏览器默认粗体。折叠正文与常显正文共用同一排版；
+结构化只读字段由列表统一管理字段间距，标题、正文容器和首行不得重复叠加留白。
+标量与对象的展开正文使用相同的组内间距。复核须真正打开自定义输入、来源和嵌套折叠项。
+
+次要卡片摘要可保留**阅读 12px、编辑 14px**的已确认模式；承担比较、取舍和业务理解的主要记录说明按正文呈现，不能仅因放在卡片中就降成辅助小字。编辑是在更易输入的明确区域进行，而非每次聚焦都放大所有文字。标题不会因进入输入框降为正文；长篇正文不自动缩为摘要。默认规则若与已确认的原生/场景基线不同，应记录适用范围并在对应任务中迁移，不静默改写。
+
+工具自身的标签、控件和状态跟随宿主界面语言；Bundle 双语标题必须随该语言更新，
+切换语言不重置所选记录或草稿。用户设计内容保持其保存的语言，不在渲染时自动翻译。
+双语 UI 审阅使用分开的中英文项目，并为展示选择配套界面语言；生成产物内的固定结构
+文案跟随产物已有语言声明，业务编号、路径和身份标识不翻译。
 
 共享 Panel 以实际容器宽度自动选择紧凑密度，不按显示器型号或整个浏览器视口
 推断。内容宽度不超过560 CSS px时，常规正文/字段与共享选择控件采用13px、
@@ -284,8 +512,9 @@ Markdown标题按正文比例呈现：一级约1.43倍、二级1.29倍、三级1
 
 普通声明式表单、结果阅读页与嵌套字段复用上述标题层次。章节标题提供范围，
 字段标题标识具体内容，正文与输入保持常规字重；不靠缩小全部正文或把整块内容
-加粗制造区分。共享默认不覆盖已确认的卡片摘要、普通操作性展开入口、问答与
-数学阅读组件的独立层级，也不改宿主界面或生成产物的品牌字体。
+加粗制造区分。问答、数学阅读等不同形态的普通导航、标题与字段都遵守公共角色；
+已确认的次要卡片摘要、常规字重的操作性展开入口和专业公式记法保留相应语义，
+不因此形成某个组件的排版豁免，也不改宿主界面或生成产物的品牌字体。
 
 长文保留完整换行，不能用省略号隐藏关键事实。导航用精简名称，允许换行；详情在内容区显示。中英文混排、长名称和浏览器文本放大都需保持可读与可操作。
 
@@ -314,18 +543,26 @@ schema 与完成校验仍保留；普通必填字段仍使用原必填提示。
 
 长记录可用声明式 `form.body` 页签按用户任务分开，而不是增加第二份记录或
 把每个字段变成页签。共用顶部名称，页内不重复页签标题；默认页呈现用途和体验，
-完整指令与资源、行为约定按真实信息归属组织。低频可选资料用共享折叠组，
-折叠或切页不清空内容，不作为权限隔离。组内16/8px节奏、键盘页签交互与只读
+完整指令与资源、行为约定按真实信息归属组织。已有语义灰组统一支持折叠、默认展开，
+不按内容数量或填写频率另做判断。折叠或切页不清空内容，不作为权限隔离。组内16/8px节奏、键盘页签交互与只读
 约束一致；未解决的重要约束须在交接中明确，不能靠折叠伪装已经确认。
-
-内联折叠标题文字与其内容左边界对齐，16px 折叠箭头紧跟标题、间隔8px；
-不继承普通按钮的左右内边距，也不在展开时增加正文缩进。长标题自然换行，
-箭头不挤压文字；展开后的首个内容组仍遵循16px间距。重复记录标题保留500字重，
+收起时保留可辨认的标题和原有必要状态；不为决定折叠再统计字段或记录数量。
+折叠和填写状态均不代表校验通过、完整或已确认。
+
+灰色分组标题与内容左边界对齐；帮助、数量和操作位于折叠箭头之前，箭头始终在整条标题栏最右侧。
+同类内容组不保留箭头紧跟标题、落在其余内容中间的例外；普通树导航仍使用原有左侧层级箭头。展开不额外增加正文缩进。
+长标题自然换行，箭头不挤压文字；标题到其直接统领的首个内容块遵循组内8px/紧凑6px，
+后续独立内容组之间使用16px/紧凑12px，折叠不改变这两种关系。
+分组标题使用14px/20px/500，文字行高、点击热区与外部间距分别管理：
+分组折叠按钮与原生字段组summary的标题行均保留上下4px留白和最小28px热区；长标题自然增高，
+不靠放大行高撑热区、不用固定高度裁切，也不靠负间距抵消多处留白。
+重复记录标题保留500字重，
 功能卡片的“功能详情”保留已确认的400字重。此规则适用于共享字段组、重复记录
 和卡片详情，不改变结构树的前置层级箭头或节点缩进。
 
 共享解释器对**单个直属字段、可见标签、与组名精确相同且无 sidecar**的声明
-只渲染字段标签，保留必填标记、可访问名及原编辑通道。不同名称的语义范围、
+只保留一个可见标题：真实语义分组保留组标题、内部标签仅供无障碍使用；纯布局组保留字段标签。
+两种组合都保留必填标记、可访问名及原编辑通道。不同名称的语义范围、
 多字段组及有预览的组不靠文字猜测自动删除；近义冗余由作者按上述规范清理。
 `label: visually_hidden` 且由组名担当唯一标题的情况保留组名和必填提示，
 不一刀切隐藏首字段，也不修改字段名、schema 或用户内容。
@@ -354,7 +591,12 @@ DSH 侧栏从桌面菜单/标题栏下方开始，两侧信息栏以**下分割
 完整名称提示；评分理由和过期状态仍可访问。原有明确启用的单行嵌入模式保留，
 不改设计数据、保存屏障或宿主界面。
 
-用现有 4/8/12/16/20/24px 间距梯度：图标和文字 4–8，字段内部 8–12，容器内边距通常 12–16。可编辑详情里的完整内容组默认16px；独立工作区、对话等大容器可采用24px，不将后者套入每一组字段。具体值服从组件与场景基线，不靠增加空白制造层级。
+用现有 4/8/12/16/20/24px 间距梯度：图标和文字 4–8，容器内边距通常 12–16。
+间距表达内容关系：标题与所属内容、标签与控件使用组内8px/紧凑6px；完整内容组、
+字段或记录之间使用组间16px/紧凑12px。独立工作区、对话等大容器可采用24px，
+不将后者套入每一组字段。同一角色的默认规则不因是否可折叠、所在Panel或语言不同
+而改变；具体场景的已确认例外应明确说明。复验实际组合的最终距离与归属感，
+包括文字行盒、热区内边距和容器间距，不能仅确认各处都引用了token。
 
 Studio 详情页的顶部标题区采用同一紧凑基线：标题/图标/操作的内容行32px，
 上下各8px，正常单行整体48px；标题18px/24px、500字重，图标和普通操作按钮32px。
@@ -392,20 +634,22 @@ Studio 的设计套件列表用工具栏右侧的次要外链提供官方套件
 不增加市场页或把未安装的套件混入已安装目录。外链明确新标签页打开，并保留键盘焦点；
 查看清单不安装、升级或修改项目引用。公开文档可访问性与界面渲染分别验收。
 
-- 工作区类组件占满可用内容区域，不再套文档卡片、重复页头或大段说明。明确导航、内容和底栏的空间及滚动所有者，避免多重整页滚动。
+- 工作区类组件占满可用内容区域，不再套文档卡片、重复页头或大段说明。DSH 与 Companion 的完整设计标签页及场景体验沿用无装饰外框的共享 viewport，不添加整页圆角边框或不对称外留白；侧栏分隔、记录卡片、表格和控件仍保留各自有意义的边界。正文留白归可见内容表面所有，不能靠移除边框掩盖宽度溢出。明确导航、内容和底栏的空间及滚动所有者，避免多重整页滚动。
 - 布局外层裁切只用于由子视图管理滚动或平移的区域；普通长内容必须有可到达末尾的滚动区。Bundle 不声明 CSS 溢出策略。组件目录、创作示例和实际实现同步收口；公开示例须验证点击导航后的内容变化及长内容滚动，不能用包含组件 class 的静态渲染断言代替交互验收。
 - 记录工作区外框不添加正文留白；详情和预览各管理一次16px内边距，单详情、画布切换和多栏详情使用相同规则。不能因组合子组件数量改变，就额外叠加18px或24px外层留白；窄容器调整排列与滚动，不重新制造两层内边距。
 - 侧栏按工作区分配的高度收缩，不用内容的最小高度撑大网格行。普通侧栏自身滚动；有侧栏边缘画布入口时，由内部导航独立滚动，保留入口在滚动区外的可见性。长列表的最后一项必须可通过滚轮和键盘到达，右侧详情滚动不带动导航；窄容器保持左侧导航，不用固定像素高度或裁切条目解决溢出。
+- 侧栏标题工具栏保持单行；可选筛选操作放不下时隐藏，不挤到下一行。按当前语言标题与控件的实际宽度判断，侧栏变宽后恢复，并保留筛选值。标题过长可省略，导航条目仍保留自然换行；普通添加入口留在集合尾部，不属于可隐藏的标题操作。
 - 可选行动指引以面板左下角的轻量提示图标呈现，悬停、键盘聚焦或点击查看，Escape 或移到外部关闭。入口锚定面板自身，不依赖侧栏，不占标题或工具栏的一行；未声明 `ui.guidance` 就不显示，不用简介或空状态文案代替。浮层避让视口，用户可移入阅读；长内容末项仍可滚动到达。局部字段说明仍跟随字段，错误与运行状态不收进指引。
 - `ui.guidance` 用一到两句帮助人审阅眼前的结果：应核对哪些事实和判断、哪里可能遗漏或需要调整。沿用现有 locale，不复用 Skill 能力简介或 `bundleDescription`。Agent 交付面板时在对话中简明引导用户，有声明指引时沿用并结合本次结果，没有时自行给出贴合任务的简短引导；左下角提示只供重复查看，不增加工具、步骤、门禁或强制提示。指引不写设计数据或用户偏好，也不是专业规则或约束的唯一载体。
 - 流程图已正常显示时，不重复显示「可阅读」；加载、失败和缺失反馈仍保留。详情入口使用简短名称，不能拼接所有有值字段的标签作为按钮文案。
 - 主内容壳、标签页（tabs）和组合容器（stack）不叠加页面内边距。可见内容表面负责一层共享 `--ygd-panel-content-gutter`（16px）。卡片内缩与画布原生工具不是第二层页面留白。画布与多栏按实际范围布局，不写死宽度、不用 Bundle 专属补偿，也不预留空列模拟滚动条。
 - 表单节奏归属于 inspector 自己的内容槽，不能依赖完整父级选择器或“只有一个孩子”的偶然形状；加入辅助内容、用单子 stack 包裹表单、在 tabs 中组合视图，不改变这一表面的边距、字段节奏、标题绑定与编辑权限。真实嵌套工作区、画布、多 inspector 和卡片各自保留布局所有权；透明组合不能跨过这些边界提升标题或给内层控件套用外层样式。
-- 普通记录标题栏统一由 `PanelRecordHeader` 管理：44px高度、14px/20px文字；数学阅读沿用这一标题栏，不另设字号。已确认的卡片标题保持40px。共享样式变更须检查实际 Kit 表达，同时覆盖辅助正文、透明 stack、tabs 包装、长内容、窄容器，以及真实嵌套工作区、多 inspector、卡片等所有权边界；JSDOM不能替代实际滚动与几何检查。
+- 普通记录标题栏统一由 `PanelRecordHeader` 管理：默认44px高度、14px/20px文字；数学阅读沿用这一标题栏，不另设字号。已确认的卡片标题默认40px。多行内容自然增高，不裁切文字或挤压控件。共享样式变更须检查实际 Kit 表达，同时覆盖辅助正文、透明 stack、tabs 包装、长内容、窄容器，以及真实嵌套工作区、多 inspector、卡片等所有权边界；JSDOM不能替代实际滚动与几何检查。
+- 当前对象的简短范围导读或辅助背景，可通过 `PanelRecordHeader.context` 显示在标题下、正文前；有实际内容才出现，无值不留空行、不补默认文案，也不要求其他面板新增说明。标题、背景和正文共享文字起点；背景用辅助文字12px、400字重、1.6行高与 secondary 语义色，保持低于14px（紧凑13px）正文的层级，标题到背景复用组内8px（紧凑6px）间距，不另套提示卡或“背景信息”标题。长背景保留换行并与正文共用可到达的阅读滚动路径，不能固定在滚动区外挤掉正文。计数与操作仍在标题行；背景不替代左下角行动指引、字段旁帮助或错误/状态反馈。必要业务条件、决定与约束仍在正文清楚呈现，不因位置靠近标题就降为辅助说明。标题组件管理呈现，工作区管理导航与滚动。
 - 有 owning 侧栏标题的 workspace 用有限 `sidebar_icon` 显式选择语义图标：16px、文字前间距8px、次要文字色、不收缩、aria-hidden。省略保留原中性图标或无图标；不得从标题/Bundle名猜图标，不给记录增加装饰图标，无侧栏表单不强加导航。具体支持以 [DSL](dsl-spec.md#sidebar_icon--authored-sidebar-title-icons) 和 catalog 为准，生成式面板不开放此 authored-only 字段。同级父节点与叶节点保留相同展开列宽，子节点按真实层级缩进，展开操作与选择操作分开。
 - 关系图自动布局使用实际节点和全部关系文字尺寸，包括多行标题与端点说明；文字不得被节点或其他文字遮挡。布局和缩放只改变视图，不改写对象、端点、数量或保存顺序。
 - 一组字段以共同文字起点对齐；同一工具栏按钮高度、内边距、图标基线一致。状态不要插在操作组中间；返回靠左，主要操作靠右。
-- 新轮次采用独立的 `title` 和 `description`：标题是短主题，说明是整轮目的或背景，逐题 `prompt` 仍只属于该问题。左侧固定两层：上层次要“第x轮”（12px常规字重），下层主要标题（14px），随可拖拽侧栏宽度自动换行、不截断；不附带整段说明或状态小字。主内容以轮次标题为标题、下方仅轮次说明。中文标题建议12字以内，英文用短语；这是生成指导，不是截断或长度校验门槛。
+- 新轮次采用独立的 `title` 和 `description`：标题是短主题，说明是整轮目的或背景，逐题 `prompt` 仍只属于该问题。左侧固定两层：上层次要“第x轮”（12px常规字重），下层主要标题（14px），随可拖拽侧栏宽度自动换行、不截断；不附带整段说明或状态小字。主内容以轮次标题为标题，已有轮次说明传给公共标题区的可选背景位置，不另建 QA 专用说明样式。中文标题建议12字以内，英文用短语；这是生成指导，不是截断或长度校验门槛。
 - 声明式工作区使用可选 `rounds_source` 绑定独立的已声明 section，记录为 `title`/`description` 字符串，map key 对应保存的数值轮号（不是界面“第x轮”的显示序号）。轮次仍只由真实问题推导，独立介绍不能制造待答轮次或改变固定题、历史只读、回答进度。绑定后缺少介绍时显示通用轮次标签，不从首题编造介绍；查看、切语言和编辑答案不补写元数据。未声明独立介绍的旧显示调用仍保留“标题：说明”/首行标题投影，不改保存原文。
 - 单列适合长说明、核心行为和异常处理；只有便于比较的短字段才并列。窄容器按内容区宽度折行/堆叠，不只看整个浏览器宽度。
 - 编号在自己的窄列内水平居中，正文左对齐。新增按钮的 **+ 实际图标起点**对齐前一输入框外沿，而不只是按钮盒子。
@@ -425,17 +669,18 @@ Studio 的设计套件列表用工具栏右侧的次要外链提供官方套件
 
 | 边界 | 共享详情表单默认值 | 间距所有者 |
 | --- | --- | --- |
-| “功能详情”等展开标题行 → 第一个内容组 | `--ygd-panel-detail-section-gap`，16px | 详情容器的直接内容块 |
-| 上一个完整内容组 → 下一个内容组 | 同一个 `--ygd-panel-detail-section-gap`，16px | 内容组的父级布局；跨渲染块也使用同一值 |
+| 记录卡片标题 → 结构化字段组 | `--ygd-panel-detail-section-gap`，16px，紧凑12px | 卡片直接字段容器；读编相同 |
+| 独立展开标题行 → 第一个内容组 | `--ygd-panel-detail-control-gap`，8px；与首字段同排的补充详情不另占标题行 | 详情容器的直接内容块 |
+| 上一个完整内容组 → 下一个内容组 | `--ygd-panel-detail-section-gap`，16px | 内容组的父级布局；跨渲染块也使用同一值 |
 | 组内标题 → 输入框或集合 | `--ygd-panel-detail-control-gap`，8px | 该组的标题 header |
 | 同一集合的相邻输入行、最后一行 → 添加按钮 | 8px | 集合组件，不再额外增加模块间距 |
 | 控件 → 所属字段的辅助说明 | 同一个 `--ygd-panel-detail-control-gap`，8px | 字段说明只持有段前间距，段后为0 |
 
 间距按布局盒子的边界测量，组间从上一组最后一个控件/添加按钮所在的盒子底部算起，而非上一个标题的基线。只由一个层级负责每一道间距，不同时叠加上一块的段后 margin、下一块的段前 margin 和父级 gap。文本换行、输入框增长或添加条目只改变组高，不改变组间距离。
 
-共享详情组件使用语义间距token，而非直接依赖宿主的编号token：实测 Studio 的 `--ds-space-6` 为32px，Panel 根样式则为24px。不能把两个编号体系当成同一个尺度；详情组件在本地定义上述16/8px默认值，避免相同声明在不同宿主里意外变密或变疏，不改写宿主自身的布局token。
+共享详情组件使用语义间距token，而非直接依赖宿主的编号token：实测 Studio 的 `--ds-space-6` 为32px，Panel 根样式则为24px。不能把两个编号体系当成同一个尺度；共享内容密度所有者提供宽态16/8px、窄态12/6px，详情叶节点继承这些值，避免相同声明在不同宿主里意外变密或变疏，不改写宿主自身的布局token。
 
-因此“使用场景 + 输入框”“核心行为 + 输入集合 + 添加”“异常处理 + 表格 + 添加”“备注 + 输入框”使用相同的组间规则；展开标题到第一组也采用16px。此前先从10px的首组特例统一为24px，最新用户确认将所有组间距收紧为16px，以适应密集详情面板；组内仍为8px。标题字号和常规字重保持已有约定，不增加分割线。本规则从共享 Record Board 内联详情扩展到普通 `record_form`、单 inspector 和声明式 form group；不要求对话、导航或图形工具栏机械使用16px。显式声明的 separator 仍可表达真实分组边界，不能由共享样式默默删除；图与结果预览的 sidecar 保留其意义。
+因此“使用场景 + 输入框”“核心行为 + 输入集合 + 添加”“异常处理 + 表格 + 添加”“备注 + 输入框”之间采用16px组间距；展开标题到其统领的第一组采用8px组内距。紧凑密度分别为12px与6px。标题字号和常规字重保持已有约定，不增加分割线。本规则从共享 Record Board 内联详情扩展到普通 `record_form`、单 inspector 和声明式 form group；不要求对话、导航或图形工具栏机械使用16px。显式声明的 separator 仍可表达真实分组边界，不能由共享样式默默删除；图与结果预览的 sidecar 保留其意义。
 
 原则来源：[Atlassian Spacing](https://atlassian.design/foundations/spacing) 的相似性、邻近性及视觉节奏，以及 [Carbon Spacing](https://www.carbondesignsystem.com/building-blocks/foundations/spacing/overview) 的父级 Stack 统一控制间距。16/8px是本产品结合现有token与用户确认的分组方式选定的默认值，不是这些设计系统要求所有产品使用的数值。
 
@@ -448,17 +693,25 @@ Studio 的设计套件列表用工具栏右侧的次要外链提供官方套件
 | 常规单行文本和选择框 | 高36px、文字14px、圆角8px、横向内边距12px | checkbox/radio 不套文本框尺寸 |
 | 常规长文本 | 文字14px、圆角8px、内边距8/12px、最小高度88px | 保留多行与拉伸；不把所有内容挤为单行 |
 | 参数调节 inspector | 紧凑单行高32px、文字14px、圆角8px | 色块与其文字输入同高；标题/说明按各自信息角色定字号 |
-| 卡片内紧凑详情 | 按已确认场景正文12px、同一输入边界 | 文本可随内容增长；不将其字号扩散到常规正文 |
+| 卡片内展开详情 | 主要业务正文与表格值14px/400，正文容器≤560px时13px；同一输入边界 | 摘要、编号等按各自信息角色；文本可随内容增长 |
 | 问题答案组合框 | 外壳持有边界及唯一焦点环 | 内部 textarea 不再叠加第二套紫色边框/outline |
 
 以上约束作用于工具自身的共享控件，不侵入 iframe 内用户设计的页面，也不重置宿主控件。`--ygd-panel-control-focus` 统一取共享品牌语义色；普通灰边框与焦点环分工明确，不在控件自身再堆同色阴影。紧凑工具栏、图标动作和专业画布控件保留任务相关尺寸。
 
-共享单值选择器的触发框与展开菜单使用同一主题：普通字段36px，卡片优先级及筛选
-保留28px紧凑尺度；菜单提供边框、圆角、阴影、当前值勾选及键盘高亮。弹出层离开
+可选颜色未填写时明确显示“未设置”，不能把原生取色器的黑色默认值显示成已配置内容。色块与文字输入共用原字段，保留用户填写的 CSS 颜色；仅明确选择颜色才改变字段。专用控件的点击区域与可见边界一致，不被外层普通输入框的尺寸覆盖。
+
+标签列表的添加沿用32px紧凑动作，不继承卡片的80px添加区域；其选项菜单保持可读宽度，
+选项行不继承普通按钮的边框和填充背景，保留主题高亮、已选禁用和取消后返回触发按钮。
+共享单值选择器的触发框与展开菜单使用同一主题：普通字段36px，卡片优先级与文字筛选
+保留28px紧凑尺度，侧栏筛选图标使用32px点击区域；菜单提供边框、圆角、阴影、当前值勾选及键盘高亮。弹出层离开
 工作区滚动/裁切容器时继承实际触发控件的语义token和字体，不依赖原容器的祖先选择器，
 也不改写宿主页面主题。选择仍使用原编辑通道，空值、失效引用、只读与禁用保持原语义。
 这条规则先落实于普通单选字段和卡片优先级/筛选，不表示所有历史原生select已迁移。
 
+宿主侧栏的项目目录、评审设置与建议浮层也要继承当前明暗模式，独立于设计面板是否打开。
+底色、悬停、当前项和边框使用宿主当前的背景层级与边框语义 token，并提供随明暗变化的默认值；
+旧颜色别名不得优先覆盖当前语义值，也不能在深色模式回退为固定白底或亮边框。
+
 Studio 的版本、工作副本及预览 Bundle 选择器通过可选的中性控件渲染口复用同一菜单，
 保留32px触发框；未注入该能力的宿主保留原生控件。原生模态对话框中的菜单留在最近的
 已打开对话框内，不能靠提高 body 弹出层的层级绕过模态隔离或焦点约束。
@@ -473,9 +726,14 @@ GRA 建议收件箱在各宿主复用同一标题与操作行：设置是带图
 业务对象“什么时候必须填写？”与 AI 能力“触发方式”均遵循横向默认；布局变化
 不影响选择值、条件表单、键盘操作和校验。检查双语与窄内容区的完整可读性。
 
-输入必须有持久可识别的标签，placeholder 不替代标签。边界在默认、聚焦、错误、只读和禁用时清楚；聚焦使用一套明确焦点反馈，避免叠加两层同色紫框。错误和链接保留语义色，不能为统一灰色层级而掩盖它们。
+输入必须有持久可识别的标签，placeholder 不替代标签。普通可见字段标签与对应控件使用原生关联，点击标签能够聚焦；重复表单不产生重复ID，复合选择保留自己的分组语义。边界在默认、聚焦、错误、只读和禁用时清楚；聚焦使用一套明确焦点反馈，避免叠加两层同色紫框。错误和链接保留语义色，不能为统一灰色层级而掩盖它们。
 
 编辑保留未修改字段、稳定 ID、引用和用户文本；支持契约已有的取消/撤销。不因隐藏字段、语言切换或查看预览而清空事实。中文输入法确认不触发提交；专门多行输入支持换行，不能把所有 Enter 都当保存。
+普通卡片直接编辑公共草稿，切换面板时保留未保存内容，不自动写盘，也不再另设局部保存/取消。
+底部保存/撤回能识别这些改动，全局撤回后导航不能重新带回。专业公式或画布编辑器若已有
+独立编辑边界，其局部取消只丢弃对应输入。真实冲突仍由公共草稿边界保留输入并说明，避免覆盖新内容。模态新建复用原生
+dialog：初始焦点进入输入，Tab留在窗口内，Escape取消并回到原入口；普通查看与
+展开不增加确认步骤。面板及导航分隔条同时支持指针与键盘调整。
 
 主要操作强调，次要操作中性，删除使用危险语义。改名在标题旁使用有可访问名称的铅笔入口；Studio 卡片的打开、复制、编辑分别提供明确动作，导出与删除收在最右侧的更多菜单中。禁用必须说明具体原因，不能以永久灰按钮冒充功能。只读原件与可编辑本地副本分清。Studio 本地 Kit/Bundle 的删除统一使用红色“移到回收站”动作，确认时说明系统回收站及实际引用影响，成功后再提示已移入。用户通过系统回收站恢复或重新导入；不增加应用内回收站或软删除机制。
 
@@ -485,7 +743,7 @@ Runtime 暴露 `user_continue` 时，宿主复用共享续接栏：有可用对
 
 嵌套信息、业务状态及选中对象的从属清单，都使用集合尾部的同款轻量添加入口，不把添加挤在标题右侧。展开控件复用 `PanelDisclosureIcon` 的16px线性箭头、14px/500标题；状态使用 `aria-expanded` 与键盘按钮语义。卡片只负责直属字段的16/8px节奏，不能用后代 `label` 样式给 radio/checkbox 选项叠加外边距；选项保持24px最小行高、8px组内间距。
 
-简单重复记录卡片的记录标题采用14px/500，直属字段标签采用12px/400次要色，输入正文仍为14px；嵌套复杂表单和紧凑表格保留各自的信息层次，不继承这套卡片标签样式。字段标题使用所选语言的自然表达，不为普通用户重复展示 `Name/Description/Prompt` 等内部概念。
+简单重复记录卡片的记录标题采用14px/500，直属字段标签与嵌套表单、紧凑表格共用普通标签角色14px/400，随共享密度缩为13px；标签可用次要色，但控件形态不另定一套字号或字重。字段标题使用所选语言的自然表达，不为普通用户重复展示 `Name/Description/Prompt` 等内部概念。
 
 所有备注类字段均应可选，允许缺省或空字符串；真正必须表达的领域信息应以明确的业务字段和契约承载，不能用“备注”暗示可选却在保存时阻断。必填星号与 `aria-required` 来源于面板的 `required` 声明，并不自动生成持久化校验；真实保存和发布校验由 Core 的 schema 与 `validation.yaml` 执行。修改必填语义时必须核对两者，并同步 Bundle 可达的输出契约，不能只删星号。系统集成备注按用户确认改为可选，其他必要信息与安全约束不变。
 
@@ -532,7 +790,7 @@ Studio 与 Companion 的宿主会话复用同一消息和工作记录组件。
 
 内容区域复用 `PanelContentState` 的 loading / empty / unavailable / error 展示，不把读取状态误作执行成功或失败。文档、产物、页面缩略图与预览、流程和白板的缺失内容不再用左上角裸文字；缩略图使用紧凑尺寸，重试保留在 owning 组件。空白源文件须在注入 CSS/图片前判空，不能因 transport 生成了 markup 而显示空 iframe。样式通过现有 owned-styles 生命周期进入 DSH、Companion 和 HMR，不让 Bundle 自带第二套等待样式。
 
-执行状态使用共享 `artifact-status-icon` 的点/活动动画，同时提供名称或可访问文本，不能只看颜色判断。状态是运行投影，不写 canonical。`execution_log` 复用宿主只读桥：绑定 owning Bundle/精确目标，按上限取尾部；在底部才跟随，用户向上阅读时保留位置，切 run/target 清旧行并忽略晚响应。没有精确关联时诚实不可用，不能拿整个主对话冒充该产物日志。细节以 [日志契约](dsl-spec.md#execution_log--embedded-host-logs-authored-panels) 为准。
+执行状态使用共享 `artifact-status-icon` 的点/活动动画，同时提供名称或可访问文本，不能只看颜色判断。侧栏保留12px状态占位以对齐，静态圆点直径6px，不把占位区域填成大色块；排队与工作中的图标仍使用12px。状态是运行投影，不写 canonical。`execution_log` 复用宿主只读桥：绑定 owning Bundle/精确目标，按上限取尾部；在底部才跟随，用户向上阅读时保留位置，切 run/target 清旧行并忽略晚响应。没有精确关联时诚实不可用，不能拿整个主对话冒充该产物日志。细节以 [日志契约](dsl-spec.md#execution_log--embedded-host-logs-authored-panels) 为准。
 
 构思完成度（Clarity）的待评估、评估中、失败、失效和不可用是瞬态工作状态，不是第二份评分权威。状态复用共享图标及12px辅助文字，保留项目标题原有两行布局；详细原因按需展开并支持键盘访问。等待或未成功取得新评估时，保留的分数须标为“上次评估”，不能冒充本次结果；从未评估则保持未评估，不填零分或虚假进度。已保存不等于主对话已开始响应，后台结果已产生也不等于主 Agent 已消费；评估失败不撤销保存成功的提示。
 
@@ -585,13 +843,17 @@ Panel 区域的固定底栏只覆盖 Panel，不能压住宿主导航或整个 S
 
 品牌、专有名称和缩写（AI、MCP、API、YAML、JSON）保持正确拼写，用户写的标题和正文不改大小写。这是本项目的产品风格，不是行业唯一规则。同一 locale key 若确实同时承担命名和动作两种角色，先核对消费者再拆分；禁止对所有文案运行大小写转换或用 CSS text-transform 修饰原文。
 
+翻译按控件的实际含义写自然表达，不逐字对应中文。字段问句必须与可填写的答案对应（例如选择授予方式时用“How is this role assigned?”）；按钮使用直接动词，数量关系用“Zero or one / Zero or more”等惯用表达。检查可见内容、展开区、悬浮提示、无障碍名称、空态与失败反馈，并沿真实入口验证语言传递；仅确认 locale 文件无中文，不能证明界面没有混杂。场景体验、关联图谱等辅助视图沿用同一语言上下文。原始依据、用户文本、技术标识不在渲染时翻译；独立的中英文示例在各自维护源修订，不用运行时替换掩盖内容错误。
+
 中文 Kit 统一称“设计套件”，Bundle 称“技能包”；原始文件、技术身份和代码引用保留 Kit/Bundle。设计套件的可选双语展示简介来自 mindset.md frontmatter 的 `display_description: {zh, en}`，原 `description` 及方法正文不变；技能包沿用既有 picker 简介。卡片显示当前界面语言的三行摘要，文件详情窄右栏显示完整简介；缺少翻译时回退原简介，不虚构翻译。标准文件用途由共享文件名/相对路径映射识别，在文件名后显示 12px 次要灰色说明，可自然换行；未知文件不显示用途提示，也不要求作者逐文件维护说明。
 
 所有主要操作支持键盘，可见焦点不被隐藏或底栏遮挡；纯图标操作有名称，选中/展开/只读状态可识别，标题有真实语义层级。普通文字以 WCAG AA 的 4.5:1 对比度为审查目标；大字、非文本控件分别按其准则检查，不把 token 名等同实际对比度合格。
 
+原生控件的激活键由当前控件拥有，不能被同页保留挂载的画布快捷键取消。公共 Panel 边界保留原生 `summary` 未修饰空格键的默认展开动作，仅阻止它继续冒泡到外部快捷键；不模拟点击、不吞掉按键释放，不改变嵌套输入、Enter 或带修饰键的宿主快捷键。复验应包含真实画布与表单共存，静态 HTML 无法发现全局监听冲突。
+
 桌面交互目标至少 24×24 CSS px 或满足相应间距/例外要求；触摸的重要目标宜更大。200% 文本放大不能丢失操作；颜色不独自表达关键意义，动画考虑 reduced motion。它们是验收要求，不是当前产品已通过 WCAG 认证的声明。图形所必需的二维画布/表格可以局部滚动，不能让整页被迫横滚。
 
-主题使用共享语义 token 和合理 fallback，不写死黑色主按钮或纯白所有背景；检查实际浅/暗主题。工具品牌强调色不替代成功、失败、警告、只读和链接语义。
+主题使用共享语义 token 和合理 fallback，不写死黑色主按钮或纯白所有背景；检查实际浅/暗主题。宿主已解析的 `color-scheme` 和语义颜色是普通 Panel、Studio 与弹出菜单的主题来源；宿主明确选择的浅色不能被系统暗色覆盖。当前宿主的语义层 token 优先于兼容别名，回归应覆盖新旧别名同时存在和旧宿主缺少当前 token 的情况。共享基础在 `visual-components.css` 维护，移植控件消费同一套 token，不在 dock 再固定浅色。专业画布保留领域配色和已有人工明暗选择，以宿主作为未选择时的默认值；画布文件自身的内容颜色不因界面主题而改写。工具品牌强调色不替代成功、失败、警告、只读和链接语义。
 
 ## 9. 已确认的场景基线
 
@@ -599,9 +861,9 @@ Panel 区域的固定底栏只覆盖 Panel，不能压住宿主导航或整个 S
 
 | 场景 | 保留的决定 |
 | --- | --- |
-| Function 详情 | 外层整宽单栏，直接编辑，不另设阅读/编辑模式；“使用场景”合并用户、情境和目的，“备注”承载设计理由及补充信息；固定可选输入，不做字段级增删，保留集合条目增删；没有重复“功能详情”标题；模块 14px/500，“功能详情”展开摘要使用常规字重 14px/400（按最新反馈取消粗体），紧凑正文 12px/400；完整内容组间及展开标题到首组均16px，组内标题到控件8px（见§4）；不新增模块分割线 |
+| Function 详情 | 外层整宽单栏，直接编辑，不另设阅读/编辑模式；“使用场景”合并用户、情境和目的，“备注”承载设计理由及补充信息；固定可选输入，不做字段级增删，保留集合条目增删；没有重复“功能详情”标题；模块 14px/500，“功能详情”展开摘要使用常规字重 14px/400（按最新反馈取消粗体），主要正文与表格业务值14px/400，正文容器≤560px时13px；完整内容组间及展开标题到首组继承共享密度（宽16/8px、窄12/6px）（见§4）；不新增模块分割线 |
 | Function 重复内容 | 核心行为轻量编号列表；“异常处理”共享表头：序号 / 发生条件 / 处理方式；24px 列表编号槽、48px 表格编号列居中；+ 起点分别沿 30px/48px 输入起点；不提供无领域依据的上下移动 |
-| Function 卡片 | 标题 14px/500、描述阅读 12px/编辑 14px；优先级左下、修改/拒绝右下；拒绝仍可查看而不是删除 |
+| Function 卡片 | 编号最左，名称14px/500，标题右侧常驻上移/下移/删除；描述与详情直接编辑同一面板草稿，正文14px/400（紧凑13px），不再有卡片局部保存或悬浮删除；描述按实际内容自动增高，优先级留在卡片下方。已有拒绝记录保留只读、筛选和恢复语义，删除仍走原删除确认，不把拒绝数据改写为删除 |
 | Smart Questions | 精简轮次说明在左侧并换行，详情在内容区；答案、选项、跳过和只读历史分清；统一输入边界与单层焦点反馈 |
 | Research | 真实方向/报告导航、语义状态点和 working 动画、精确关联的滚动日志；日志不作为研究报告，不假报未建立的宿主桥 |
 | 业务对象/角色权限 | 业务对象只导航对象及真实继承层级，关系通过画布选中/同源详情编辑，无重复分类根节点。信息卡、业务状态和角色自有权限的添加统一在尾部；组间16px、组内8px，嵌套选项不叠加外边距，展开箭头复用共享组件。画布入口与功能模块同一控件 |
@@ -637,6 +899,13 @@ AI 角色画布采用已确认的原型表达：总览卡片将人物头像/角
 这些角色内部视图规则不强加给有真实关系编辑契约的其他画布。
 原型迁移验收必须逐项对照视觉层次与交互；仅关系数量或 schema 通过不代表视觉迁移完成。
 
+DSH 的 Design 停靠区与宿主原生右侧栏（文件、浏览器、终端等）同一时刻只显示一个，
+保留可读的对话区。用户打开原生右侧栏时隐藏 Design，保留其打开意图、未保存编辑、
+选中项和画布视口；普通内容刷新不抢回显示。明确点击「Yugoo设计」才通过宿主公开
+切换操作收起原生右侧栏。隐藏不等于关闭或销毁内容，局部订阅沿既有可见性入口暂停；
+重新显示保留用户拖动的宽度，不重复应用初始分栏比例。宿主原生标签、草稿和持久布局
+仍由宿主负责，不关闭其标签、不读取私有布局存储，也不另建恢复状态机。
+
 ## 10. 所有人如何使用与维护
 
 ### 结果阅读页的信息层级
@@ -664,6 +933,12 @@ AI 角色画布采用已确认的原型表达：总览卡片将人物头像/角
 
 用现有 Studio 样例逐步形成少量代表性基准：问题、卡片详情、重复记录表格、关系图、流程、报告日志、参数预览。正常、空态、错误、长文和窄容器尽可能复用相同样例，不创建第二套样例权威，也不对每次文档修改全量重测。
 
+用户指出的差异是设计问题的线索，不是逐字改样式的答案。审阅者需要独立判断信息归属、
+阅读顺序和交互预期，再决定采用、拒绝或限定参考做法的范围。多人审阅时分别给出理由、
+潜在反效果及更小的替代，不以复述实现者或用户意见代替判断。学习成熟案例时阅读其官方
+方法与适用背景，并对照中英文、明暗主题下的实际呈现；既不因“简洁”压平必要的分区，
+也不因“有层次”给所有内容套框。分歧、最终取舍和横向检查记入现有工作记录，不新增审批阶段。
+
 ## 11. 最小验收清单
 
 - **认知与改写**：回答[面板自查](#面板自查)的四个问题；说明内部 Tab 的必要性，结合实际内容检查阅读与人工改写路径。
@@ -700,15 +975,15 @@ UI 改动先从用户入口走到完成结果，检查是否要求用户理解
 
 目标和约束各用一张可展开收起、默认展开的卡片，保留 Function 卡片的轻边框、白底、
 紧凑标题与正文层级。卡片内依次是业务含义、公式、该公式所用符号的解释；设计
-来源留在底部按需展开，以只读上下文呈现，不要求用户重填技术引用。每条公式下的符号说明默认收起，标题显示条目数，可就近
-展开；完整模型和技术记录也默认收起。符号解释投影共用定义，修改入口回到同一符号对照表，
+来源留在底部，以只读上下文呈现，不要求用户重填技术引用。每条公式下的符号说明、
+完整模型和技术记录沿用共享折叠组，默认展开，可分别手动收起。符号解释投影共用定义，修改入口回到同一符号对照表，
 不在各卡片保存解释副本。匹配只识别实际呈现的记法，不宣称推导数学等价。
 
 公式使用专业数学排版；正文中的数学片段也用明确的 `\( ... \)` 行内 LaTeX，
 普通文字不解析为 HTML。完整数学表达放在普通文档流的折叠卡片中，内含可编辑
 符号对照表；不吸底挤占当前阅读区域。
 
-模型文件仅在有保存的产物引用时显示查看入口，文件内容复用宿主的受限读取通道，
+模型文件仅在有保存的产物引用时显示查看入口，用户明确打开文件预览后才经宿主的受限读取通道读取内容；外层分组默认展开不触发文件读取，
 以固定来源版本的只读文本预览，不执行模型代码。“模型检查”显示记录的状态和
 面向业务用户的结论：实际检查了什么、发现什么、尚未检查什么。缺少说明时明确
 显示尚未记录，不从技术日志猜测结论，也不把排版或结构合法当成求解成功。
@@ -716,7 +991,7 @@ UI 改动先从用户入口走到完成结果，检查是否要求用户理解
 在非空时才出现的“建模依据与技术记录”折叠区，以只读内容呈现，不要求业务用户
 填写。它们与可理解的检查说明分别保存，原字段和事实保留；查看不触发重算或校验。
 默认阅读不铺满输入框；编辑时文字在原位置替换为输入框，公式区域保留即时预览和
-就地的 LaTeX 输入，不在条目下方再重复整组表单。模型标题复用共享记录标题栏的14px/600、条目标题14px/600、
+就地的 LaTeX 输入，不在条目下方再重复整组表单。模型标题复用共享记录标题栏的14px/600、条目标题复用公共记录层级14px/500/20px、
 业务说明继承共享正文字号并采用1.7行距、来源12px、公式18px，建立清楚的阅读层级；编辑态延续相应层级。
 文字采用智能提问（Smart Question）的阅读/编辑处理：完成后是轻量背景的阅读区，
 原位编辑使用白底边框和单层焦点反馈；复用实际保存成功信号收回编辑态，不把关闭
@@ -737,64 +1012,51 @@ UI 改动先从用户入口走到完成结果，检查是否要求用户理解
 等编号是色阶，不表示文字重要性，不能据名称猜测。浏览器检查实际计算颜色和
 内边距，避免只在缺少宿主 token 的合成测试中看起来正常。
 
-### 折叠/新增区域与必填语义的横向审计（2026-10-09）
-
-已静态核查 Web App 15 个与 Decision Modeling 8 个 Bundle 的面板、嵌套声明、schema、validation 和中文标签；cx-2 独立只读复核。以下是当前问题记录，不是授权重新设计全部领域字段，也不是23个面板的完整视觉验收。
-
-| 范围 | 已确认的事实 | 处理边界 |
-| --- | --- | --- |
-| 全部备注类字段 | Integration 是唯一有非空门槛的备注，本轮已改为可选；Function `reason`、Business Rules `notes`、Design Style `config.notes` 原本可选 | 增加跨 Kit 回归检查面板标记、schema 存在性与非空规则；保留已写备注，不把业务决策理由或权限自定义条件误当备注 |
-| 可添加的凭据卡片 | 原卡片标题默认粗体，与直属字段标签层次接近；已统一为记录标题14px/500、标签12px/400次要色，正文14px、控件36px；字段中文标题去除重复英文前缀 | 仅修改非 compact 卡片直属元素，嵌套复杂表单、radio/checkbox 和紧凑表格不继承；英文切换和大写名称格式化在真实预览检查 |
-| 缺少可见必填提示 | Role `assignment_rule`/`capability` 有 state+completion 非空规则；Notification 的触发、接收者、渠道、内容，Quality 的条件/通过标准，Business Rules 的结果有 completion 非空规则，但对应面板未声明必填 | 暂未变更规则；完成必需与允许保存草稿要区分，radio/token/visually_hidden 分组需要共享的标题及无障碍呈现，不能只给隐藏标签加星号 |
-| 同一字段在不同对象中的要求 | Business Data `description` 在对象完成时必需，在关系中可选，却共用“含义与约束（选填）”声明；AI 关系端点必须引用存在的组件，但提示不完整 | 不能给共用字段全局加必填，也不能将对象误标为可选；按声明所属 section 与引用约束设计提示 |
-| 有星号不等于禁止空字符串 | 最小真实 `validateSkillDesign` 检查证实：Function 的名称/说明/分组及已存在详情条目、Role 标题在字段存在但为空字符串时可通过；schema `required` 只要求键存在，语义方法仍有质量要求 | 记录为 UI 提示、形状和内容门槛的分层差距；本轮不增加强校验阻止草稿保存，不把“允许空字符串”说成“没有校验” |
-| 动态区域的共享布局 | Business Data 折叠信息/状态、Function 内联集合、AI 分类型字段、角色自定义要求使用不同表达形态；当前直属 CSS 没有污染它们，旧 related-editor 间距在 record-form 已有16/8覆盖 | 未发现静态新越界不等于所有展开状态都已视觉合格；后续以实际新增、展开、条件切换的代表性截图查共享缺口，避免纯截图或遍历代替交互 |
-
-本轮共享 Panel 源回归23项、Core实际加载/校验回归8项和 Panel 类型检查通过。真实 Studio 已验证系统集成双语、新增凭据后的卡片、名称格式化、可选备注与顶部中性图标；另实际新增、折叠/展开业务对象信息卡并选择条件必填，核对 nested 标签、选项和16/8px节奏，未被新简单卡片规则污染。上述证据不包含正式 Design Project 保存/重开、Agent 生成质量、所有原生宿主或已发布安装包。Bundle 内容使用新的隔离精确快照验证，没有覆盖旧版本原件或此前测试结果。
-
-### 必填呈现的系统性对齐（2026-10-09，审计后的落实）
-
-此前审计的缺失提示现在在共享字段与 Bundle 声明修复：角色获得方式/权限操作、
-通知触发/接收者/渠道/内容、验收条件/通过标准、业务规则结果与 AI 关系端点。
-业务对象的 `description` 使用同一个 canonical key，通过有限的
-`required_in: [objects]` 区分对象必需与关系可选；共用标签不再写“选填”。
-不是通过 Bundle 名称的共享层分支、重复字段或额外保存权威实现。
-
-- 普通字段和嵌套条目复用同一要求标记；隐藏标签若由匹配的单字段组标题取代，
-  标记放组标题；没有对应标题时放控件旁的窄列，不增加空白行。条件字段随可见性
-  显示/隐藏，不能为了提示把它重新初始化。
-- 单选及自定义单选用 `radiogroup` 的 `aria-required`，组合多值用本地化的命名组；
-  不在不支持此属性的 `group` 上伪造无障碍语义，不要求每个新 token 输入都必填。
-- 重复卡片/紧凑表格的列标题和编辑控件遵守同样的标记与命名规则；可添加区域仍
-  按16px组间、8px组内及集合尾部添加。简单卡片的12px次要标签不覆盖复杂表单的14px字段标题。
-- `required`/`required_in` 是输入预期的呈现，不新增 HTML `required` 提交闸门，
-  不自动修复/删空值，不改 schema、validation 或普通保存入口。所有备注仍可选。
-  Board 的创建请求弹窗同样按所属分区解析，但保留原有请求输入约束；
-  它发送宿主请求，不是 Panel Save，也不直接写 canonical 数据。
-
-保留映射：各 Bundle 的领域方法、输出契约、ID/引用、state/completion 范围原位
-保留；本次只更正相应 `panel.yaml` 的缺失/错误提示和共享解释。Function/Role 的
-字段存在性与专业内容质量的分层保持：空字符串在既有机械契约允许时仍允许，
-不能声称新增非空检查。Function 的拒绝历史卡与可选详情没有被新完成门槛卡住。
-DSH Panel Save 当前应用 schema 与来源定位安全检查；Companion 原有 state
-检查、Executor handoff/in_progress 的 state 与 complete 的 state+completion
-路径未被互相替换。保存成功不等于内容质量已完整。
+### 字段标题、输入要求与按需帮助
+
+普通字段的标题顺序固定为：名称、声明中的必填 `*`、有内容时的帮助图标。
+中文和英文遵守相同顺序；不在字段名中零散追加“可选”“选填”或“(optional)”。
+这一默认只约束普通表单提示，不改写业务选项、条件要求或用户输入中的这些词。
+可选说明由所属语言资源直接修订，不在渲染时用正则清洗标签，也不新增一套可选性声明。
+没有星号不代表当前设计已经达到完成质量；不根据内容是否为空，
+为只读事实或派生内容推断新的填写要求。
+
+`PanelFieldCaption` 与 `PanelRequiredMark` 是普通表单、集合标题、紧凑详情、
+嵌套条目和创建请求的共同呈现入口。必填来自已有 `required` / `required_in`，
+后者按所属分区解析；例如业务对象与关系共用 `description`，但只有对象要求填写。
+表格列标题遵守同样的标记规则。对象标题仍遵守前述“标题 + 编辑图标”的规范：
+不重复加可见星号，编辑控件保留真实的无障碍要求。Bundle 不自行重建这些标题。
+
+帮助是字段或分组名称后的共享 `PanelHelp`，不为解释单独占一行。紧凑详情由
+可见标题承接原字段说明，不能因内部标签隐藏而丢失，也不能复制为两份帮助。
+一字段与同名分组共用标题时，帮助和要求标记只显示一次。帮助按钮与原生
+`label` 平级，标签仍准确关联输入控件；帮助按钮不嵌入另一个控件的标签。
+帮助可由 hover、键盘聚焦或点击打开，Esc 关闭并保留焦点；正文允许阅读和滚动，
+继承当前主题并避开窗口边缘。无障碍描述必须读到解释正文，不能用“字段帮助”
+覆盖正文的可访问名称。无说明时不显示空图标；操作必需的错误和反馈仍就地可见。
+
+隐藏标签若由匹配的单字段组标题取代，标记放组标题；没有对应标题时放控件旁
+的窄列，不增加空白行。条件字段随可见性变化，不因提示重新初始化数据。
+单选及自定义单选用 `radiogroup` 的 `aria-required`，组合多值用本地化的命名组；
+不在不支持此属性的 `group` 上伪造语义，不要求每个新 token 输入都必填。
+可添加区域仍按16px组间、8px组内及集合尾部添加；普通标签共同遵守§3的角色与密度。
+
+输入预期、字段形状、内容质量和持久化是不同责任。呈现调整不新增 HTML `required`
+提交闸门，不自动删空值，不改 schema、validation 或普通保存入口。备注保持可选；
+独立业务规则、权限条件和专业决策理由不按“备注”处理。schema `required` 要求键
+存在，不等于非空检查；Function/Role 等既有机械契约允许空字符串时仍允许保存草稿。
+Board 创建请求按所属分区解析字段要求，并保留原有请求输入约束；它向宿主发送请求，
+不直接写 canonical 数据，也不冒充 Panel Save。
+
+DSH Panel Save 的 schema 与来源定位检查、Companion 原有 state 检查、Executor
+handoff/in_progress 的 state 与 complete 的 state+completion 路径各自保持；
+保存成功不等于专业内容已经完整。ID、引用、领域方法和输出契约不随提示风格改变。
 
 标签列表的删除动作由共享 `TokenList` 持有：chips/cards/cards-menu 使用同一
 16px关闭图标、24×24px无边框点击目标；普通按钮的边框和内边距不能污染标签。
 chips为32px高的紧凑标签。删除仍只发送该列表的单项替换，不能修改入参、写入
 其他字段，或在只读/无效数据时提供删除入口。
 
-本轮验证：Panel聚焦源回归30项，TokenList回归5项，Core加载/校验与嵌套负例15项
-通过；Core按既有tsdown脚本构建通过，Panel对本worktree已构建Core声明的类型检查
-通过。cx-2只读复核发现的创建请求消费者遗漏已补齐并回归；标题标记被宽屏
-space-between拉开的视觉缺口已修复并复核。9222 Chrome实际核查角色的分组/
-自定义输入与标题标记、通知必填组与标签删除、业务对象新增信息/条件切换；
-1280px业务对象组件截图与computed值确认无横向溢出、组间16px/选项间8px。
-后台隔离检查页同时出现过两条 `TypeError: Failed to fetch` 外壳错误；组件仍可
-显示与操作，此记录不能充当该后台页完整加载成功的证据。未验证正式项目保存/
-重开、模型生成、原生宿主消费或安装包；这些不应由本轮呈现检查冒充。
-
 ### 侧栏标题图标的只读核查（2026-10-09）
 
 23个Bundle当前没有显式的领域标题图标：17个使用共享 `PanelsTopLeft` 中性布局
@@ -892,3 +1154,12 @@ cx-2独立只读复核同样确认此缺口。
 表头固定、输入紧凑、横向溢出留在表格容器内；表格使用记录详情的共享间距。
 窄容器允许工具栏换行，字段设置保持可操作；验证实际像素、键盘、空态、只读及保存读回。
 这是一种通用数据编辑表达，不将排班列或任何 Bundle 名称写入共享层。
+
+
+### 本轮共享控件与阅读细节
+
+普通表单、重复记录和标准问题的单选/复选共用主题、16px控件和焦点反馈，保留原生键盘与表单语义；专业画布自己的工具不受这些选择控件规则影响。字段字数统计放在标签行末，仅编辑聚焦或接近上限时出现，不另占一行。
+
+白板等专业工作区的外层标题和操作复用记录标题与操作尺寸；不能用“标题栏内所有button”规则把可编辑标题、铅笔和动作一起改成小字号。正常已加载的报告不再常驻“可阅读”状态；没有待确认引用时不显示“待确认0”和相应图例，错误与进行中反馈仍在原处。
+
+顶部标签从左向右展开；仅在标签溢出时，在标签栏右端显示省略号菜单，弹层向左展开并与右端对齐。“全部面板 / All panels”保留为悬停提示与可访问名称；标签仍可横向滚动，保留完整标签提示、当前项定位和键盘导航。空间充足时隐藏溢出入口。整个设计面板的关闭按钮位于项目标题栏右上角，与标签操作分开，并沿用原有草稿保留与关闭行为。跨面板引用沿真实记录显示名称、保存稳定ID；支持自由文本的控件保留未知与自定义值，不因显示优化增加门禁。