openyida 2026.9.21 → 2026.9.22-beta.2

package/yida-skills/skills/yida-create-form-page/references/association-form-field.md

@@ -116,7 +116,7 @@
   1. `source` 和 `target` 的 fieldId 是否正确（可通过 get-schema 技能查看）
   2. `sourceType` 和 `targetType` 是否与字段类型一致
   3. `dataFillingRules` 是否被正确设置到 `props.dataFillingRules`（而非只写在 `associationForm` 对象内）
-  4. 关联表单字段节点的**顶层**是否有 `fieldId` 属性（宜搭回填引擎依赖顶层 `fieldId` 识别字段，仅在 `props` 内有 `fieldId` 不生效）
+  4. 关联表单字段的 Schema 节点**顶层**是否有 `fieldId` 属性（宜搭回填引擎依赖顶层 `fieldId` 识别字段，仅在 `props` 内有 `fieldId` 不生效）
 
 **子表填充子表（tableRules）格式**：
 
@@ -164,7 +164,7 @@
 
 **注意事项**：
 - `tableRules` 用于实现"选择关联表单记录后，将其子表数据自动填充到当前表单的子表中"
-- **`tableId` 必须填写被关联表单（源表）的子表 fieldId**，宜搭通过它在源表中定位子表数据；填写当前表单的子表 fieldId 会导致 `getInstMultiSubTableDatas` 接口报 500 错误
+- **`tableId` 必须填写被关联表单（源表）的子表 fieldId**，宜搭通过它在源表 Schema 中定位子表数据；填写当前表单的子表 fieldId 会导致 `getInstMultiSubTableDatas` 接口报 500 错误
 - 每个 `tableRule` 对应源表的一个子表，可以配置多个子表的回填规则
 - 子表内的 `target` 同样支持 `@label:字段标签` 语法，脚本会自动解析为 fieldId
 - 确保 `rules[].source` 是源表子表内的字段 fieldId，`rules[].target` 是当前表单子表内的字段 fieldId
@@ -372,7 +372,7 @@
 ```
 
 **关键点说明**：
-1. `tableRules` 中的 `tableId` 填写的是**被关联表单（商品表）的子表 fieldId**（即「规格明细」子表的 fieldId），而非当前表单（订单表）的子表 fieldId。宜搭通过此 fieldId 在源表中定位子表数据，填错会导致 `getInstMultiSubTableDatas` 接口报 500 错误
+1. `tableRules` 中的 `tableId` 填写的是**被关联表单（商品表）的子表 fieldId**（即「规格明细」子表的 fieldId），而非当前表单（订单表）的子表 fieldId。宜搭通过此 fieldId 在源表 Schema 中定位子表数据，填错会导致 `getInstMultiSubTableDatas` 接口报 500 错误
 2. `tableRules` 中的每个 `rule.target` 支持 `@label:字段标签` 语法，用于定位当前表单子表内的字段
 3. 选择商品后，商品表的「规格明细」子表数据会自动填充到订单表的「订单明细」子表中
 4. 可以配置多个 `tableRule` 来实现多子表的数据回填
@@ -385,7 +385,7 @@
 - 检查 `sourceType` 和 `targetType` 是否与字段类型一致
 - 确认 `props.supportDataFilling` 是否为 `true`
 - 确认每条规则同时包含 `sourceFieldId/targetFieldId/source/sourceType/target/targetType` 6 个字段（缺少任意一个不生效）
-- 确认关联表单字段节点的**顶层**有 `fieldId` 属性（宜搭回填引擎依赖顶层 `fieldId`，仅在 `props` 内有 `fieldId` 不生效）
+- 确认关联表单字段的 Schema 节点**顶层**有 `fieldId` 属性（宜搭回填引擎依赖顶层 `fieldId`，仅在 `props` 内有 `fieldId` 不生效）
 
 **问题 2：子表填充子表不生效**
 - 检查 `tableRules` 是否为数组且非空

package/yida-skills/skills/yida-create-form-page/references/batch-forms.md

@@ -13,14 +13,14 @@ openyida create-form batch <appType> .cache/openyida/<项目名>/forms.json --js
 ```json
 {
   "forms": [
-    { "key": "customer", "title": "客户", "fieldsFile": "customer-fields.json", "layout": "section", "theme": "comfortable", "labelAlign": "left" },
+    { "key": "customer", "title": "客户", "fieldsFile": "customer-fields.json" },
     { "key": "product", "title": "商品", "fieldsFile": "product-fields.json" },
     { "key": "order", "title": "订单", "fieldsFile": "order-fields.json", "dependsOn": ["customer", "product"] }
   ]
 }
 ```
 
-`fieldsFile` 相对任务文件所在目录，也可使用 `fields` 直接填写字段定义。每个表单可按业务设置 `layout: single|double|card|section`、`theme: default|compact|comfortable`、`labelAlign: top|left|right`；它们分别控制整表布局起点、密度和 PC 标签位置，不能代替完整组件树设计。普通 batch 项省略 `icon`，由 CLI 自动选择；只有用户明确给出表单图标目录中的合法名称时才设置，禁止写应用图标 `xian-*`。`locale` 也只在用户明确指定时设置。已有完整表单填写 `formUuid`，CLI 回读并复用。
+`fieldsFile` 相对任务文件所在目录，也可使用 `fields` 直接填写字段定义。普通 batch 项省略 `icon`，由 CLI 自动选择；只有用户明确给出表单图标目录中的合法名称时才设置，禁止写应用图标 `xian-*`。`locale` 也只在用户明确指定时设置。已有完整表单填写 `formUuid`，CLI 回读并复用。
 
 客户和商品同时创建。订单的前置表单完成后开始创建；其他独立任务继续执行。依赖环、未知依赖、重复 key 和无效字段会在创建前报错。
 
@@ -63,10 +63,9 @@ batch 会在预校验前把紧凑写法规范化为下面的完整结构；前
 - `--concurrency 1..4` 设置并发上限，默认 3。
 - 结果保存在任务文件旁的 `.state.json`，包含每张表单的 ID、字段和状态。主流程从中汇总资源上下文，再配置导航。
 - 相同任务再次执行时，成功表单回读复用。失败及中断任务保留原状态，其依赖标记为 blocked；独立任务继续。
-- `success:false` 时，`results`、子命令诊断、`.state.json` 和 `recoveryAction` 共同描述本轮终态及下一步。
-- `rerun_unchanged_plan` 表示原任务指纹可安全恢复：后续使用原任务文件和原参数执行同一 batch，CLI 从 state 读取已知 ID 并复用成功表单。
-- `inspect_unknown_write_then_reconcile` 表示当前指纹进入待核对状态：先回读远端资源；核对完成后建立新的 reconcile 任务，用已确认 `formUuid` 表示已有表单，仅保留确定尚未创建的任务。
+- 当前批次返回 `success:false` 时，以返回的 `results`、子命令诊断和 `.state.json` 为准停止本轮创建；不得为补齐失败项改用单条 `create-form create`，也不得把剩余项拆成新的 batch。修正输入或为已知资源补入 `formUuid` 后，后续恢复仍使用原任务文件执行 batch。
+- 恢复失败任务前，核对已创建资源并修复。准备新任务文件时，用 `formUuid` 复用完整表单，仅为确认尚未创建的表单保留创建任务。
 - `.lock` 防止同一任务重复启动。进程异常退出遗留锁时，确认原进程已结束、核对已创建资源后再清理。
-- background pending 表示原 batch 仍在执行；task/state/lock 继续代表同一执行单元，后续只接受该任务的最终结果。
+- 首次 batch 返回 background pending 时等待运行时自动投递完成结果；pending 不是失败，也不是重试信号，不得再次调用 batch。
 
 已有表单的字段修改仍使用 update/patch 等命令；不同表单可分别更新，同一张表单由一个任务维护。流程审批按 `yida-create-process` 执行，等待其依赖的表单就绪后再配置。

package/yida-skills/skills/yida-create-form-page/references/field-definition-guide.md

@@ -4,7 +4,7 @@
 
 ```json
 [
-  { "type": "Divider", "title": "基本信息", "dividerType": "left-dot-title" },
+  { "type": "Divider", "title": "基本信息" },
   {
     "type": "ColumnContainer",
     "layout": "6:6",
@@ -39,22 +39,22 @@
 | `dataSource` | Array | 条件必填 | 选项类字段必填 |
 | `multiple` | Boolean | 否 | 是否多选 |
 | `remoteDataSource` | Object | 否 | 选项类字段远程搜索数据源配置 |
-| `children` | Object[] | 条件必填 | `TableField` / `ColumnContainer` 必填 |
+| `children` | Object[] | 条件必填 | `TableField` / 展示布局组件必填 |
 | `associationForm` | Object | 条件必填 | `AssociationFormField` 必填 |
 
 选项类字段包括 `SelectField`、`MultiSelectField`、`RadioField`、`CheckboxField`。固定选项必须在字段 JSON 中提供非空 `dataSource`；不要省略选项源，也不要只写旧式 `options`。
 
-## Divider 与 ColumnContainer
+## 展示/布局组件
 
 ### Divider
 
 普通业务分组优先使用 Divider：
 
 ```json
-{ "type": "Divider", "title": "基本信息", "dividerType": "left-dot-title" }
+{ "type": "Divider", "title": "基本信息" }
 ```
 
-按当前页面的业务、密度和主题选择 `dividerType`，同页同层级尽量一致，不同业务页面优先选用不同且合适的样式；无法判断时按页面随机轮换，选定后显式填写，同页复用。完整外观和场景见 [Divider 选型表](form-field-properties.md#divider)。未填写时 CLI 以 `bold-with-thin` 兜底，不替代按场景选型。
+普通企业表单不写 `dividerType`，OpenYida 会默认生成 `bold-with-thin`。显式样式优先级为 `bold-with-thin`、`double-color-trapezoid`、`left-dot-title`、`solid` / `dashed` / `thick` / `dotted`。需要门户/强分区识别时，同一张表单可统一显式写 `dividerType: "multi-parallelograms-end"`。
 
 ### ColumnContainer
 
@@ -73,9 +73,20 @@
 }
 ```
 
-### 分组组件
+### GroupContainer / PageSection
 
-普通业务分组和章节分隔使用 `Divider`，需要局部多列时组合 `Divider` 与 `ColumnContainer`。
+只在特殊场景使用，不要承载普通业务分组：
+
+```json
+{
+  "type": "PageSection",
+  "title": "高级配置",
+  "showHeadDivider": true,
+  "children": [
+    { "type": "TextField", "label": "配置说明" }
+  ]
+}
+```
 
 ## update changes
 
@@ -118,3 +129,4 @@
 | `SerialNumberField` | 流水号 | 自动生成 |
 | `Divider` | 分割线 | `title`、`dividerType`、`showTitle` |
 | `ColumnContainer` | 分栏布局，映射 `ColumnsLayout` | `layout`、`columnGap`、`rowGap`、二维 `children` |
+| `GroupContainer` / `PageSection` | 特殊分组容器，映射 `PageSection` | `label`/`title`、`showHeadDivider`、`children` |

package/yida-skills/skills/yida-create-form-page/references/form-field-properties.md

@@ -18,28 +18,30 @@
 
 ---
 
-## 表单组件与布局
+## 表单展示/布局组件
 
-表单支持在顶部、左侧、主体、右侧和字段之间组合 Tab、按钮组、图片、状态区、`Divider`、`ColumnContainer` 与业务字段。`create-form` 字段 JSON 使用下表中的结构组件；更新表单时保留其他已有组件。
+字段 JSON 中可使用的展示/布局组件如下；生成表单时只从这张清单里选择，不要编造新的布局组件名。
 
-| 结构组件 | 用法 | 典型场景 |
+| 组件 | 用法 | 典型场景 |
 | --- | --- | --- |
-| `Divider` | 作为独立字段插入字段数组，用 `title` 表达章节标题，按页面用途显式选择 `dividerType` | 普通业务分组、章节分隔、字段较多时提升可读性 |
+| `Divider` | 作为独立字段插入字段数组，用 `title` 表达章节标题，默认生成 `props.type: "bold-with-thin"` | 普通业务分组、章节分隔、字段较多时提升可读性 |
 | `ColumnContainer` | 用二维 `children` 表达多列，每个子数组是一列；内部字段仍按普通字段 JSON 写 | 开始/结束日期、姓名/工号、部门/岗位、金额/币种、联系人/电话等短字段成组 |
+| `GroupContainer` / `PageSection` | 作为容器包住一整块 `children`，标题写 `title`，映射到 `PageSection` | 需要折叠、边框、整块隐藏、整块权限或平台分组容器语义的少量特殊分组 |
+
+默认结构是 `Divider` 做章节标题和分隔，`ColumnContainer` 做局部左右/多列布局。普通业务分组不要用 `GroupContainer` / `PageSection`，它们不是普通章节标题的替代品。
 
 ### 布局决策规则
 
-先按业务任务确定区域、组件作用和响应式行为，再选择单列、局部多列、全局双列、卡片或章节布局。不要从字段数量机械推导固定结构，也不要把 `Divider` 当成每个分组的必选组件。
+默认表单是单列。不要为了“更高级”默认把整表改成双列，也不要用 `GroupContainer` / `PageSection` 做普通分组。
 
-- 单列：适合字段较少、流程表单、移动端优先、长文本、附件、地址、子表、审批意见或需要逐项认真填写的内容。
+- 默认单列：字段较少、流程表单、移动端优先、长文本、说明、附件、地址、子表、审批意见、需要逐项认真填写的字段。
 - 局部多列：短字段且天然成对或成组时使用 `ColumnContainer`，例如开始/结束日期、姓名/工号、部门/岗位、金额/币种、联系人/电话。
-- 全局布局：`--layout single|double|card|section` 设置整表布局起点；按业务和设备选择，再结合页面内容调整组件位置。
-- 语义结构：按业务含义组织区域和层级。普通业务分组和章节分隔使用 `Divider`。
+- 全局 `--layout double`：只有用户明确要求“整个表单双列”时才使用；一般更推荐在字段 JSON 内用 `ColumnContainer` 做局部多列。
+- 语义分组：按业务含义分段，不按字段数量平均分。常见分组包括“基本信息”“业务信息”“时间计划”“补充材料”“审批信息”。
 
-常用结构示例：
+推荐结构：
 
 ```text
-ColumnContainer > Field
 Divider > ColumnContainer > Field
 Divider > Field
 ```
@@ -58,61 +60,20 @@ Divider > Field
 
 映射到 `componentName: "Divider"`。
 
-OpenYida 支持以下 **23 个可见样式**，不接受 `none`（无分割线）。外观来自 `vc-deep-yida` 的 `components/yida-divider/index.tsx`、`style.less` 和样式选择器；场景列是选型建议，不是固定映射或优先级。
-
-| `dividerType` | 实际外观 | 适合的内容 |
-| --- | --- | --- |
-| `solid` | 1px 实线 | 密集录入、正式资料 |
-| `dashed` | 1px 虚线 | 补充资料、轻量清单 |
-| `thick` | 3px 粗实线 | 需要明确章节边界的长文档 |
-| `dotted` | 1px 点线 | 轻量问卷、辅助分段 |
-| `bold-with-thin` | 标题下短粗线接长细线 | 有章节层次的业务申请 |
-| `solid-center` | 标题居中，两侧细线 | 简短、对称的章节标题 |
-| `solid-left` | 左短线、标题、右长线 | 左对齐的阅读或填写分段 |
-| `left-dot-title` | 左圆点加标题 | 高频登记、紧凑字段组 |
-| `light-left-bar` | 浅底标题条，左侧短竖条 | 审核、资料维护的分组 |
-| `light-bar` | 浅底标题条 | 温和的资料采集、说明章节 |
-| `dark-bar` | 主色实底标题条 | 需要强识别的少量章节；不是固定黑底 |
-| `light-left-title` | 浅底横条，左侧主色圆角标签 | 服务办理、品牌资料分段 |
-| `light-center-title` | 浅底横条，中间主色圆角标签 | 活动报名、居中章节 |
-| `light-house-title` | 浅底横条，中间屋顶形标签 | 服务专题、活动章节 |
-| `light-hexagon-title` | 浅底横条，中间六边形标题 | 专题展示、阶段章节 |
-| `hexagon-title` | 六边形标题与两侧错层线 | 主题展示、强章节识别 |
-| `badge-line` | 徽章式标题接细线 | 荣誉、资质或专题资料 |
-| `multi-parallelograms-end` | 梯形标题，尾部多条斜杠 | 赛事、制造或有动势的专题 |
-| `center-title-with-bar` | 中间标题，两侧粗色条 | 短标题、强对称章节 |
-| `double-color-trapezoid` | 主色梯形标题拼浅底横条 | 品牌分区、项目资料 |
-| `arrow-right-title` | 右箭头标题接浅底横条 | 有明确先后顺序的阶段；样式本身不提供流程操作 |
-| `square-blocks-title` | 左侧双方块、标题及底部细线 | 项目、资源或技术资料 |
-| `inner-ellipse-title` | 主色胶囊横条内嵌浅底椭圆标题 | 轻松的活动、服务专题 |
-
-选型顺序：用户指定的有效样式优先；已有页面局部修改保留原有有效样式；新页面再按下面的业务场景选择。先排除不适合标题长度、内容密度和主题的形态，同页同层级复用一个主样式。
-
-| 页面情况 | 推荐候选 | 选择依据 |
-| --- | --- | --- |
-| 高频登记、密集录入、正式资料，或标题较长、主要在手机使用 | `solid`、`solid-left`、`left-dot-title`、`light-bar` | 装饰轻，便于连续扫描和填写 |
-| 审核、档案维护、多章节申请 | `light-left-bar`、`bold-with-thin`、`light-left-title`、`double-color-trapezoid` | 分组明确，便于定位不同资料段 |
-| 辅助材料、问卷、轻量清单 | `dashed`、`dotted` | 分隔存在感较低，不抢正文 |
-| 活动报名、服务专题，标题简短且适合居中 | `solid-center`、`light-center-title`、`light-house-title`、`inner-ellipse-title` | 用对称或柔和标签组织章节 |
-| 项目阶段、技术资料、赛事或需要明显章节识别的页面 | `arrow-right-title`、`square-blocks-title`、`multi-parallelograms-end`、`light-hexagon-title`、`hexagon-title` | 用方向或几何形态强化分区；箭头不代表已有流程交互 |
-| 资质、荣誉、品牌专题或少量重点章节 | `badge-line`、`dark-bar`、`center-title-with-bar`、`thick` | 视觉权重较强，避免在密集页面大量重复 |
-
-**不知道如何选择时，随机轮换。** 场景不明确，或多个候选同样合适时，将合适的候选随机打乱，按页面依次选用。优先用本轮尚未用过的样式，用完再重新打乱；没有可用的场景判断依据时，从全部 23 种中轮换。每页只选一次，同页各分组复用，不逐条随机。
-
-把选定样式和理由（例如“场景不明确，随机轮换”）写入现有 `design.md` 的页面说明，并显式填入该页每个 `Divider.dividerType`。后续生成、编译、重试和局部修改复用已记录的值，不重新抽签，不需要新增状态文件或 CLI 参数。
-
-`form-fields` 示例仅演示布局，其中的分割线不代表推荐默认值；复用示例时按当前页面重新选择。
+样式推荐顺序以企业表单通用建议为优先，再按当前 CLI 支持的 `Divider.props.type` 白名单生成：
 
-把“页面 → 样式 → 选择理由”写在现有 `design.md` 对应页面说明里，Fast 与 Plan 使用同一规则。表单结构通过组件树配置，Canvas 分组标题按相同外观原则实现。
+1. 默认推荐 `bold-with-thin`，适合企业级业务表单的章节标题。普通场景不要写 `dividerType`，OpenYida 会默认写入 `props.type: "bold-with-thin"`。
+2. `double-color-trapezoid`，适合需要更强品牌识别和区块视觉权重的表单。
+3. `left-dot-title`，适合轻量分组、字段较密但不希望分割线太重的表单。
+4. `solid` / `dashed` / `thick` / `dotted` 等纯线型样式只用于低调分隔、兼容兜底或用户明确指定线型。
+5. `multi-parallelograms-end` 只用于用户明确要求门户、强分区、流程阶段强调，或已有线上表单已使用该样式且需要保持一致的场景。
 
-未提供样式时 CLI 以 `bold-with-thin` 兜底，不替 AI 决定业务风格。显式的不支持值会报错，不静默替换。`dividerType` 写入 `props.type`；也接受历史别名 `dividerStyle`、`styleType`、`typeStyle` 和 `props.type`，按此前顺序取值，新生成统一用 `dividerType`。
-
-`none` 不参与推荐、轮换或字段生成；确实不需要分隔的内容区直接省略 Divider 组件。复杂装饰主要用于短标题；长标题和窄屏优先选简单线型、圆点或浅底，发布后检查换行与截断。
+生成 Schema 时默认写入 `props.type: "bold-with-thin"`。只有在用户明确指定样式时才通过 `dividerType` 覆盖 `props.type`。同一张表单中的 `Divider` 必须保持同一个 `props.type`，避免章节样式跳变。如果是修改已有表单，先看线上 Schema 中 Divider 的原始 `props.type`，属于上述支持清单或强分区特殊值时优先复用。
 
 | 属性 | 默认值 | 说明 |
 | --- | --- | --- |
 | `behavior` | `"NORMAL"` | 默认状态，支持 `"NORMAL"` / `"HIDDEN"` |
-| `dividerType` | `"bold-with-thin"`（遗漏时兜底） | 从上表按页面选型，写入 `Divider.props.type`，不是 CLI 参数 |
+| `dividerType` | `"bold-with-thin"` | 写入 Schema 的 `props.type`；优先级：`bold-with-thin` → `double-color-trapezoid` → `left-dot-title` → `solid` / `dashed` / `thick` / `dotted`；强分区特殊场景可显式用 `multi-parallelograms-end` |
 | `showTitle` | `true` | 是否显示标题 |
 | `title` | `"标题"` | 分割线标题，写入 `props.title` |
 | `description` | `""` | 标题描述，写入 `props.description` |
@@ -133,11 +94,32 @@ OpenYida 支持以下 **23 个可见样式**，不接受 `none`（无分割线
 | `rowGap` | `"16px"` | 多行场景行间距，写入 `props.rowGap` |
 | `display` | `"VERTICAL"` | 移动端排列方式，支持 `"VERTICAL"` / `"HORIZONTAL"` |
 | `mobileRowGap` | `"0px"` | 移动端垂直布局行间距 |
-| `children` | `[]` | 二维数组，每个子数组是一列内的字段或其他表单组件 |
+| `children` | `[]` | 二维数组，每个子数组是一列内的字段或展示组件 |
+
+### GroupContainer / PageSection
+
+`GroupContainer` 是 `PageSection` 的别名，映射到 `componentName: "PageSection"`。标题写入 `props.title`，不会写 `props.label`。
 
-### 分组组件
+默认不要为了普通字段分段而使用本组件。普通分段应写成 `Divider` + 后续字段，横向字段排布应写成 `Divider` + `ColumnContainer`。只有当整块内容需要作为一个容器被折叠、加边框、整体隐藏或承接平台分组样式时，才使用 `GroupContainer` / `PageSection`。
 
-普通业务分组和章节分隔使用 `Divider`，横向字段排布使用 `ColumnContainer`。
+| 属性 | 默认值 | 说明 |
+| --- | --- | --- |
+| `behavior` | `"NORMAL"` | 默认状态，支持 `"NORMAL"` / `"HIDDEN"` |
+| `label` / `title` | `"分组"` | 分组标题，写入 `props.title` |
+| `showHeader` | `true` | 是否显示头部 |
+| `tooltip` / `tips` | `""` | 用户提示，写入 `props.tooltip` |
+| `showHeadDivider` | `true` | 是否显示头部分割线 |
+| `sectionHeaderStyle` | `"origin"` | 分组头部样式 |
+| `sectionHeaderBgColor` | `"#0089ff"` | 头部背景配色 |
+| `sectionHeaderTitleColor` | `"#171A1D"` | 标题颜色 |
+| `pcStyle` | `{ "value": "origin" }` | PC 端布局样式 |
+| `showBorder` | `false` | PC 端显示边框 |
+| `withMargin` | `false` | PC 端外边距 |
+| `withPadding` | `true` | PC 端内边距 |
+| `mobileStyle` | `{ "value": "origin" }` | Mobile 端布局样式 |
+| `showBorderMobile` | `false` | Mobile 端显示边框 |
+| `withMarginMobile` | `false` | Mobile 端外边距 |
+| `withPaddingMobile` | `false` | Mobile 端内边距 |
 
 ---
 

package/yida-skills/skills/yida-create-page/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: yida-create-page
-description: 创建自定义展示页面（display 类型）并返回 pageId（即 formUuid）；仅当目标 page 缺失且用户意图允许新增页面时使用。
+description: 创建自定义展示页面（display 类型）并返回 formUuid；仅当目标 page 缺失且用户意图允许新增页面时使用。
 ---
 # 创建自定义页面
 
@@ -50,7 +50,7 @@ description: 创建自定义展示页面（display 类型）并返回 pageId（
 ## 命令
 
 ```bash
-openyida create-page <appType> "<pageName>" [--mode dashboard] [--hide-nav] [--locale zh_CN|en_US|ja_JP] [--open|--no-open]
+openyida create-page <appType> <pageName> [--mode dashboard] [--hide-nav]
 ```
 
 | 参数 | 必填 | 说明 |
@@ -58,26 +58,18 @@ openyida create-page <appType> "<pageName>" [--mode dashboard] [--hide-nav] [--l
 | `appType` | 是 | 应用 ID，如 `APP_XXX` |
 | `pageName` | 是 | 页面名称 |
 | `--mode dashboard` | 否 | 看板/驾驶舱页面推荐使用；只表达页面模式，不会自动隐藏导航 |
-| `--hide-nav` | 否 | 仅当用户显式要求页面隐藏导航 / 无导航 / 全屏无框时使用；命令自动配置并回读，未生效时在同一页面补写一次。确认隐藏后才输出 `hideNav=true` 和带 `isRenderNav=false` 的 URL；这不等同于应用导航隐藏，自绘应用侧导航需另执行 `openyida update-app <appType> --hide-app-nav` |
-| `--locale` | 否 | 页面内容语言：`zh_CN`、`en_US`、`ja_JP`；省略时按当前环境选择 |
-| `--open` / `--no-open` | 否 | 控制成功后是否返回浏览器打开提示，由宿主执行打开，不影响页面配置 |
+| `--hide-nav` | 否 | 仅当用户显式要求页面隐藏导航 / 无导航 / 全屏无框时使用；创建后隐藏页面级导航，并输出带 `isRenderNav=false` 的页面 URL；这不等同于应用导航隐藏，自绘应用侧导航需另执行 `openyida update-app <appType> --hide-app-nav` |
 
-优先使用上表参数。兼容别名：`--hide-navigation` / `--no-nav` 等同于 `--hide-nav`；`--render-nav false`（也接受 `--is-render-nav` / `--isRenderNav`）要求隐藏，`true` 保持默认；多个导航参数以最后一个为准。`--content-locale` / `--lang` 等同于 `--locale`。本命令自动输出结果 JSON，不提供专用 `--json` 参数。
-
-使用 `--hide-nav` 时，页面级配置与回读已包含在创建命令中，不需要常规追加 `update-form-config`。已确认的自定义应用导航隐藏在应用设置更新时同步保存，与这里的页面级配置分开执行。
+页面导航需要隐藏时，创建成功拿到真实 `formUuid` 就配置并回读，可与源码开发并行；不等待页面发布。已确认的自定义应用导航隐藏在应用设置更新时同步保存，与这里的页面级配置分开执行。
 
 默认生成页面导航可见；仅说“看板 / 驾驶舱 / 首页 / 门户 / 工作台”不等于隐藏导航。
 
 ## 输出
 
 ```json
-{"success":true,"pageCreated":true,"pageId":"FORM-XXX","pageName":"驾驶舱","appType":"APP_XXX","mode":"dashboard","hideNavRequested":false,"hideNav":false,"chromeless":false,"navigationVerification":null,"url":"{base_url}/APP_XXX/workbench/FORM-XXX","workbenchUrl":"{base_url}/APP_XXX/workbench/FORM-XXX","dashboardConfigWarning":null}
+{"success":true,"pageId":"FORM-XXX","pageName":"驾驶舱","appType":"APP_XXX","mode":"dashboard","hideNav":false,"chromeless":false,"url":"{base_url}/APP_XXX/workbench/FORM-XXX","workbenchUrl":"{base_url}/APP_XXX/workbench/FORM-XXX"}
 ```
 
-隐藏导航时，`navigationVerification` 记录 `requestedRenderNav:false`、实际 `renderNav`、`verified` 和配置次数 `attempts`。回读优先使用平台的 `renderNav`，缺少该字段时才读 `isRenderNav`；布尔值及字符串 `"true"` / `"false"` 均可识别，缺失值不会当成隐藏成功。
-
-补写后仍未确认时，命令以非零退出码返回 `success:false`、`pageCreated:true`、真实 `pageId` 和 `CREATE_PAGE_NAVIGATION_NOT_VERIFIED`。此时 `hideNav` 表示回读结果，未知为 `null`，`chromeless:false`；按 `recovery` 提供的参数对原页面执行 `update-form-config`，再用 `get-form-config --json` 确认。不要重跑创建命令，也不要用 URL 中的 `isRenderNav=false` 代替配置回读。
-
 > 如需创建表单页面（带字段的数据收集页），请使用 `yida-create-form-page`。
 
 ## 异常处理
@@ -85,5 +77,5 @@ openyida create-page <appType> "<pageName>" [--mode dashboard] [--hide-nav] [--l
 | 异常场景 | 处理方式 |
 |---------|----------|
 | 命令返回失败 | 检查 appType 是否正确，确认登录态有效（`openyida env`） |
-| 返回 JSON 中无 pageId | 先用 `list-forms` 核对是否已创建，找到页面后复用；不要因缺少返回值直接重跑创建 |
+| 返回 JSON 中无 pageId | 不要猜测 formUuid，重新执行命令获取 |
 | 页面名称重复 | 宜搭允许同名页面，但建议使用唯一名称避免混淆 |

package/yida-skills/skills/yida-create-process/SKILL.md

@@ -35,13 +35,6 @@ description: 流程表单一体化创建（创建表单 → 转流程 → 配置
 - 创建或转换任何远程资源前，CLI 必须先完成字段和流程定义的纯本地编译；本地编译失败时远程写入数必须为 0
 - 复用普通表单时由 `configure-process` 统一执行表单模式只读 preflight、必要转换、发布与平台 view 回读，不要在外层先手动转换表单
 
-## 配置失败后的原表恢复
-
-- `create-process` 返回 `success:false` 且包含 `formUuid` 时，该表单已经存在，失败的是后续配置；新建模式与复用模式均适用。保存返回的 `appType/formUuid`，禁止去掉 `--formUuid`、再次 `create-form` 或另建同名表作为恢复手段。
-- 先按错误中的 `stage`、`nextStep` 和 `recovery` 检查原表状态及权限。修正明确原因后只能复用原 `formUuid`，使用返回的完整 `retryCommand`；不得自动补 `--replace` 绕过已绑定流程的保护。
-- `noWriteRetry:true`、`NON_IDEMPOTENT_RESULT_UNKNOWN` 或 `PUBLISHED_UNVERIFIED` 表示远程结果未确认：只读核实原表/流程，不能执行写重试，也不能新建替代资源。
-- 无法安全恢复时保留原表，并向用户报告原表链接、失败阶段和需处理的问题；不要宣称流程已完成。
-
 ## 适用场景
 
 用户需要"创建审批流程"、"新建流程表单"、"搭建审批系统"，且 resource context 没有既有流程/表单目标时使用。
@@ -63,7 +56,7 @@ description: 流程表单一体化创建（创建表单 → 转流程 → 配置
 ## 用法 1：全新创建
 
 ```bash
-openyida create-process <appType> <formTitle> <fieldsJsonFile> <processDefinitionFile> [--replace]
+openyida create-process <appType> <formTitle> <fieldsJsonFile> <processDefinitionFile>
 ```
 
 ## 用法 2：复用已有表单（推荐）
@@ -83,16 +76,12 @@ openyida create-process <appType> --formUuid <formUuid> <processDefinitionFile>
 | `processDefinitionFile` | 是 | 流程定义文件（格式同 `yida-process-rule`） |
 | `--replace` | 条件必填 | 仅当目标已存在 PUBLISHED 流程或 SAVED 草稿，并已获得用户对整图替换的明确确认时传入 |
 
-参数不确定时先看 `openyida create-process --help`。缺参、重复参数或未知选项会在读文件和登录前返回 `CREATE_PROCESS_INVALID_ARGUMENTS`；按 `details.argument` 定位参数、`details.reason` 判断原因，修正后重试。复用参数写作 `--formUuid`。
-
 ## 输出
 
 ```json
-{"success":true,"formUuid":"FORM-YYY","formMode":"create","formTitle":"订单处理表","appType":"APP_XXX","fieldCount":6,"processCode":"TPROC--XXX","processId":"83145794990","processVersion":2,"verificationLevel":"PLATFORM_VIEW_VERIFIED","platformViewVerified":true,"url":"{base_url}/APP_XXX/workbench/FORM-YYY"}
+{"success":true,"formUuid":"FORM-YYY","formTitle":"订单处理表","appType":"APP_XXX","fieldCount":6,"processCode":"TPROC--XXX","processId":"83145794990","processVersion":2,"verificationLevel":"PLATFORM_VIEW_VERIFIED","platformViewVerified":true,"url":"{base_url}/APP_XXX/workbench/FORM-YYY"}
 ```
 
-`formMode` 区分新建（`create`）和复用（`reuse`）。复用模式不读取表单名称和字段数，`formTitle`、`fieldCount` 返回 `null`，表示未查询，不代表字段为空或转换失败；新建模式返回传入名称和创建结果中的字段数。配置失败时返回的表单信息也遵循此约定。流程是否成功以 `success` 和 `verificationLevel` 为准，不能根据字段数判断。
-
 ## 流程定义最小 DSL 合约
 
 `processDefinitionFile` 只描述发起和结束之间的业务节点。OpenYida 编译器会自动注入发起节点和结束节点，`nodes` 数组里不要手写任何 start/end 节点。

package/yida-skills/skills/yida-custom-page/SKILL.md

@@ -5,8 +5,6 @@ description: JSX 自定义页面开发规范（React 16 平台 Jsx 组件、expo
 
 # JSX 自定义页面开发
 
-平台导航下的管理页面默认只实现业务内容，跨模块由平台菜单切换；同任务分类可用页内 Tab。维护 JSX 页同样遵守[管理页面边界](../yida-canvas-custom-page/references/navigation-and-entry-guide.md#平台导航下的管理页面)，不默认追加自绘导航或隐藏平台导航。
-
 ## Resource-First 页面开发
 
 编写页面源码前，先按根技能解析目标 app/page/form context：

package/yida-skills/skills/yida-custom-page/references/design-system.md

@@ -10,7 +10,7 @@
 
 ## 设计执行清单
 
-同时遵循 [页面与导航连续性](../../yida-design/references/page-continuity.md)，沿用历史 JSX 生命周期实现，不直接复制 Canvas hooks。
+实现前先用这一组规则统一检查页面实现；视觉方向由 `yida-design` 决定，本文件只负责把方向落到平台 JSX 组件页面的 token、组件和状态上。
 
 1. **任务路径清晰**：页面标题、主操作、次操作、空状态入口和错误恢复入口一眼可见。
 2. **场景模式一致**：同类列表、详情、看板、工作台使用一致的信息层级、按钮位置和状态表达。

package/yida-skills/skills/yida-dashboard/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: yida-dashboard
-description: "经营分析看板/驾驶舱/数据大屏产品化交付；用于指标判断、趋势分析或投屏监控，不用于普通待办工作台和办事门户。含真实数据、筛选联动、卡片截图、组织内短链和钉钉待办闭环。常规图表使用 yida-rechart；明确 ECharts、复杂 ECharts option 或维护旧图表时使用 yida-chart。普通统计优先 yida-report。"
+description: "经营看板/驾驶舱/数据大屏产品化交付。含真实数据、筛选联动、卡片截图、组织内短链和钉钉待办闭环。常规图表使用 yida-rechart；明确 ECharts、复杂 ECharts option 或维护旧图表时使用 yida-chart。普通统计优先 yida-report。"
 license: MIT
 metadata:
   audience: developers
@@ -27,10 +27,9 @@ metadata:
 
 ## 何时触发
 
-- 已确认的经营分析、指标比较、趋势判断或投屏监控需求。
-- 现有经营看板的指标卡截图、分析分享或派单闭环。
-
-按任务判断，不按名称触发：待办、操作队列、业务列表、门户式工作台以及处理任务的看板由 `yida-canvas-custom-page` 实现；少量任务计数、辅助图表、管理者身份或隐藏导航都不足以触发本技能。首页选择遵循 [首页按任务选择](../yida-requirement-analysis/references/experience-groups.md#首页按任务选择)。
+- 看板 / 驾驶舱 / 大屏 / Dashboard / 数据大屏。
+- 经营看板 / 业务看板 / 管理驾驶舱 / 高层汇报。
+- 指标卡截图、组织内短链、隐藏导航、看板派单闭环。
 
 单个普通统计报表优先 `yida-report`；只解决单张图的实现问题时按“图表路由边界”选择 `yida-rechart` 或 `yida-chart`。
 

package/yida-skills/skills/yida-data-management/SKILL.md

@@ -25,7 +25,7 @@ description: 宜搭数据管理。表单实例/子表/流程实例/任务中心
 - 记录数量默认 1-3 条：单对象轻应用写 1 条；列表/工作台写 2 条；看板/排行/状态分布写 3 条。不要为了展示效果批量灌入大量数据。
 - 示例记录必须是当前业务语义，不写“测试1 / demo / mock”；例如客户、订单、学生、商品、工单、活动等对象要有合理名称、状态、金额、数量、负责人或日期。
 - 先执行 `openyida get-schema <appType> <formUuid> --field-map-json` 获取真实 `fieldId`；保存数据使用真实 fieldId 或 `--resolve-aliases` 可解析别名，禁止猜测字段 ID。
-- 单个日期传毫秒时间戳数字，日期范围传时间戳数组；单选/多选必须使用表单已配置选项；成员/部门字段只有可安全确认 userId/deptId 时才填，否则留空或跳过该字段。
+- 日期字段必须转成 13 位毫秒时间戳；单选/多选必须使用表单已配置选项；成员/部门字段只有可安全确认 userId/deptId 时才填，否则留空或跳过该字段。
 - 每条实例单独执行一次 `openyida data create form`；不要把 1-3 条记录作为顶层数组塞进一个 `--data-file`。
 - 写完必须 `openyida data query form` 抽查至少 1 条，并把写入数量和抽查结果交给 `yida-app` 页面阶段使用。
 
@@ -49,7 +49,7 @@ description: 宜搭数据管理。表单实例/子表/流程实例/任务中心
 - 删除完成只以 `deleted=true && readbackVerified=true` 为准；`alreadyAbsent=true` 表示本次未再次发删除请求，可按幂等成功处理
 - 当前不支持删除流程实例；禁止生成 `openyida data delete process`，禁止在 CLI 报不支持后探索一次性脚本、浏览器私有请求或底层 API 绕过正式能力
 - **录入/更新数据前，必须先执行 `openyida get-schema` 获取真实字段 ID，并将字段 ID 映射记录到 `.cache/<项目名>-schema.json`**
-- **生成测试数据或录入/更新数据时，`DateField` 传毫秒时间戳数字（如 `1719705600000`），`CascadeDateField` 传毫秒时间戳数组；不要传日期字符串。转换方法见 [日期字段格式](references/data-format-guide.md#日期字段datefield--cascadedatefield)**
+- **生成测试数据或录入/更新数据时，`DateField` / `CascadeDateField` 必须使用 13 位毫秒时间戳（如 `1719705600000`），不要传 `YYYY-MM-DD`、`YYYY-MM-DD HH:mm:ss` 或 ISO 字符串**
 - **录入数据后，必须执行 `openyida data query` 抽查至少 1 条记录，确认 `formData` 中字段有实际值（非空），否则说明字段 ID 有误，需重新排查**
 - **读取子表明细超过 50 行时，必须使用 `openyida data query subform` 或 `listTableDataByFormInstIdAndTableId` 分页查询完整子表；不要把 `searchFormDatas.currentPage` 当作子表分页**
 - **本技能不读写 memory**：数据操作通过 CLI 命令写入宜搭平台，不依赖跨会话的 memory 状态
@@ -127,8 +127,6 @@ description: 宜搭数据管理。表单实例/子表/流程实例/任务中心
 
 ## 命令
 
-`data create/update` 的 `--data-json` 和 `--data-file` 中，`DateField` 传毫秒时间戳数字，`CascadeDateField` 传毫秒时间戳数组；不要传日期字符串或秒级时间戳。按业务时区转换，示例见 [日期字段格式](references/data-format-guide.md#日期字段datefield--cascadedatefield)。`--resolve-aliases` 只转换字段名，不转换日期值。
-
 ### 表单实例
 
 ```bash

package/yida-skills/skills/yida-data-management/references/data-format-guide.md

@@ -6,7 +6,7 @@
 - `formDataJson` 传字符串，不直接传对象
 - `updateFormDataJson` 传字符串，不直接传对象
 - `dynamicOrder` 传字符串，不直接传对象
-- 保存、更新和测试数据中，`DateField` 传毫秒时间戳数字，`CascadeDateField` 传毫秒时间戳数组；不要传日期字符串
+- `DateField` / `CascadeDateField` 的保存、更新和测试数据值必须使用**13 位毫秒时间戳**，不要传日期字符串
 
 ## 查询条件格式
 
@@ -87,13 +87,13 @@
 }
 ```
 
-先按业务时区转换，再将数字填入 `--data-json` 或 `--data-file`。例如业务使用北京时间，`2026-10-18` 当天零点应写为 `1792252800000`：
+可用 JavaScript 转换固定日期：
 
 ```js
-new Date('2026-10-18T00:00:00+08:00').getTime() // 1792252800000
+new Date('2024-06-30T00:00:00+08:00').getTime()
 ```
 
-不要直接解析不带时区的日期，也不要把秒级时间戳当毫秒传入。收到“日期组件值的格式错误，必须为时间戳”时，检查字段值是否仍为 `YYYY-MM-DD`、`YYYY-MM-DD HH:mm:ss` 或 ISO 字符串；`--resolve-aliases` 不会转换日期值。
+如果传 `YYYY-MM-DD`、`YYYY-MM-DD HH:mm:ss` 或 ISO 字符串，宜搭可能保存失败、保存为空，或导致报表/筛选异常。
 
 ## 关联表单字段（AssociationFormField）
 

package/yida-skills/skills/yida-design/SKILL.md

@@ -3,25 +3,13 @@ name: yida-design
 description: >
   当用户要做完整应用视觉设计、单页 UI 改造、主页面视觉设计、应用主题色或全局换肤时使用。
   完整应用读取共享需求：Fast 并行输出 design.md，Plan 维护视觉事实后由 CLI 生成 design.md。
-  将导航、应用框架、表单、记录详情和自定义页面一起设计，在 design.md 写入统一的主题 token、布局、材质、形状、间距与状态规则。
+  design.md 写主题 token、布局、材质、圆角、密度、呼吸感、组件和状态规则。
 ---
 
 # yida-design
 
 宜搭应用和页面视觉设计技能，输出 `design.md`。
 
-宜搭平台基础变量是平台提供的应用主题基础变量框架。项目主题在这套基础变量上按需扩展材质、布局、字体、动效和组件状态变量。先确定设计效果，再写入对应变量和消费位置；见 [主题扩展规则](references/application-theme-consistency.md#平台基础变量是应用主题基础框架)。
-
-设计导航时，把菜单圆角、三态边框、选中阴影、项高、内距和间距一起写入主题，并在访问态的数据管理页与业务页面检查效果，见 [导航形状与密度的案例经验](references/application-theme-consistency.md#导航形状与密度的案例经验)。
-
-确定风格前，按[设计方向比较](references/theme-selection.md#设计方向比较)以第一直觉为参照，发展两个更有表现力的方向，在当前规划轮次内选定。已有明确视觉要求时，在其范围内完善设计。
-
-向用户说明设计时，写风格和适用场景：“设计主题风格为轻盈媒体栅格，适合产品展示型品牌官网。”风格名称与场景按当前项目填写；建议阶段使用“建议采用……风格”。
-
-需要业务规划时调用 `use_skill("yida-prd")`。已有 `prd.md` 时直接读取其中的页面任务、区块和业务规则，再做视觉设计；查询业务字段或格式时，按需读取 `yida-prd` 的参考文件。
-
-Fast、Plan 和单页设计使用相同的 UI 设计规则、主题变量和质量检查；流程只在编写方式与确认时机上有区别。共用 [主题索引](templates/design-themes/index.json)，按 [共享主题选择规则](references/theme-selection.md) 先读摘要、选中后读一份完整主题。
-
 完整应用沿用需求分析阶段确认的模式与风格，按 [设计模式路由](references/design-mode.md) 推进。Fast 使用下方视觉流程；Plan 使用 [视觉分支](sub_skill/yida-design-plan/SKILL.md) 维护视觉事实，由 `yida-app` 生成方案并请用户确认；业务规划始终归 `yida-prd`。单页设计和主题调整直接继续。
 
 ---
@@ -50,31 +38,29 @@ Fast、Plan 和单页设计使用相同的 UI 设计规则、主题变量和质
 | 1 | [读取整理后的用户需求](workflow/step-1-read-brief.md) | 读取业务对象、页面场景、明确范围、品牌和色彩偏好 | 视觉输入摘要 |
 | 2 | [选择主题色和 token](workflow/step-2-theme-system.md) | 确定主色、辅助色、中性色、字体层级、组件基调和宜搭 token 作用域 | `themeProfile` |
 | 3 | [页面结构和交互设计](workflow/step-4-wireframe-interaction.md) | 根据用户需求中的页面场景确定布局骨架、区块、主操作、状态和响应式规则 | 低保真结构 + 交互路径 |
-| 4 | [UI 视觉和状态设计](workflow/step-5-visual-states.md) | 从业务任务、信息拓扑和视觉特征选择设计风格 | `design.md` 内容草稿 |
+| 4 | [UI 视觉和状态设计](workflow/step-5-visual-states.md) | 从业务任务、信息拓扑和视觉 DNA 选择设计风格 | `design.md` 内容草稿 |
 | 5 | [写入 design.md](workflow/step-6-handoff.md) | 写入唯一视觉事实源和稳定 `designRefs` | `prd/<项目名>/design.md` |
 
-完整应用输出一份应用级 `design.md`，包含主题、布局、组件、状态和响应式规则，三种流程共用 [唯一输出契约](workflow/output-design.md)：frontmatter 保存机器数据与 anchor 索引，完整规则只写在五章正文。Fast 手写并执行 `check-design`，Plan 使用紧凑契约由 CLI 生成并执行同一校验。页面实现同时读取业务 PRD 和视觉契约。
+完整应用输出一份应用级 `design.md`，包含主题、布局、组件、状态和响应式规则，Fast 手写格式见 [视觉输出契约](workflow/output-design.md)；Plan 使用紧凑契约，由 CLI 生成完整文档。页面实现同时读取业务 PRD 和视觉契约。
 
 ---
 
 ## 核心规则
 
-修改已有设计时，只读取并更新相关章节、页面记录和 token。Plan 统一按 [局部调整](../yida-app/workflow/plan/step-4-deliver.md#4-处理调整) 执行；Fast 直接修改当前 `design.md`，再按主题更新命令同步已有 CSS，保留未改的正文和自定义样式。
-
 1. **平台能力优先**：数据录入、提交、编辑、审批、权限、字段校验走宜搭表单/流程；自定义页负责展示数据、呈现分析结果、放置业务入口、打开详情页，并串联表单、流程、报表和导航入口。
 2. **美感提升保持功能契约**：页面美化、视觉升级和页面重构默认只调整颜色、布局、密度、间距、视觉层级、素材和图标表达；现有数据源、字段映射、按钮动作、筛选逻辑、提交 URL、权限和业务状态保持原样。
-3. **默认保留平台应用导航**：普通自定义页、页面内 tab、分段、筛选和快捷入口都不触发 `yida-nav-shell`。PRD 的应用工作区选择自定义导航，或用户明确要求自绘应用级导航、隐藏应用导航时，写 `appBlueprint.hideAppNav: 'y'` 并交给 `yida-nav-shell`。独立前台选择自己的菜单时，同样进入 `yida-nav-shell`，但只配置该页独立展示，保留后台应用导航。用户只说全屏、无导航或 `isRenderNav=false` 时，只写页面级隐藏配置。
+3. **默认保留平台应用导航**：普通自定义页、页面内 tab、分段、筛选和快捷入口都不触发 `yida-nav-shell`。PRD 选择自定义导航，或用户明确要求自绘应用级导航、隐藏应用导航时，写 `appBlueprint.hideAppNav: 'y'` 并交给 `yida-nav-shell`。用户只说全屏、无导航或 `isRenderNav=false` 时，只写页面级隐藏配置。
 4. **同应用页面入口归导航**：同应用页面优先放入平台导航或导航分组；自定义页内容区放当前页动作、原生表单新建/查看、外部链接和跨应用资源。
 5. **表单入口响应式**：新增/提交页 URL 默认使用页面级隐藏导航的 `submission/{formUuid}?isRenderNav=false`；详情页 URL 默认使用 `formDetail/{formUuid}?formInstId={formInstId}&navConfig.layout=1180&isRenderNav=false`，且 `formInstId` 必须来自真实数据记录并优先取 `row.formInstId`；PC 端默认在侧边抽屉中用 iframe 承载宜搭原生表单，抽屉默认半屏 `50vw`，提交页和详情页使用同一宽度规则；移动端整页或新页打开。
-6. **主题文件**：主题目录统一包含设计、CSS、表单布局三个文件，导出和生成参数见 [命令与参数](references/application-style-library.md#命令与参数)。Plan 使用 CLI 返回的 `outputs.theme`；Fast 和已有主题调整按 [主题文件生成与更新](workflow/output-design.md#cli-token-契约fast--plan-共用) 执行。按 [共用主题规则](references/application-theme-consistency.md) 将已选风格落实为 token，并核对生成的 CSS。修改变量要回到设计源后重新生成、上传；仅 CLI 未覆盖且已核实选择器的样式覆盖可在 CSS 末尾小范围追加，不另写脚本生成或重写主题文件。
+6. **主题文件**：Plan 直接使用 CLI 返回的 `outputs.theme`；Fast 和已有主题调整按 [主题文件生成与更新](workflow/output-design.md#cli-token-契约fast--plan-共用) 执行。主题 CSS 生成后只用 `Read` 查看目标 token、用小范围 `Edit` 逐组修改；不得用 Python、Node、Shell 或 `run_workspace_script` 脚本生成、复制、整文件重写、正则替换或 retheme `app-theme.css`，校验脚本只能读取并报告问题，不能改写主题文件。
 7. **默认主题先做业务判断**：工作台、门户、列表、详情、普通看板和数据大屏默认都是浅底 / light 模式，但主色不固定为 `podBlue` 或 #1677ff；先根据行业、品牌、业务情绪和视觉目标做创意色彩判断，主题色可以是任意合法 CSS 颜色。只有用户明确说暗色/深色/夜间/高对比时才用深色沉浸。
 8. **页面布局要到可实现粒度**：每个页面至少写清顶部/左侧/主体/右侧/底部区域、核心组件、信息密度、主操作位置、PC/移动端差异和空/载/错态。
 9. **页面丰富度建议**：工作台、首页、门户、看板、展示页和业务入口页推荐规划 8-10 个有业务目的的区块以上，例如上下文标题、状态摘要、主操作、筛选、任务列表、最近记录、动态流、洞察、提醒、空态行动、右侧上下文和底部辅助信息。区块数量不是硬门槛，窄场景、单任务页面或用户明确要求精简时可以更少，但要写清每个区块的业务目的和取舍原因。计数按“区块组”算，不按子项算：`KPI 卡片: 学生总数, 课程总数, 出勤率, 平均分` 只能算 1 个状态摘要区块，`快捷入口: 录入学生/登记成绩/记录考勤/管理课程` 只能算 1 个动作区块；不能用重复 KPI 卡、重复快捷入口或大空白卡凑数量。
 10. **工作台禁低密大卡片套路**：工作台 / 业务首页不能用“标题 + 4 个等宽大 KPI 白卡 + 图标快捷卡 + 大空态白卡”撑首屏。默认改成紧凑状态摘要条、任务/动态列表、最近记录、右侧上下文面板和高频动作；没有真实数据时也展示薄空态行 + 登记入口，不铺大块空白卡片。
-11. **按主题保持形状、密度与呼吸感**：`design.md` 正文写清圆角、密度与呼吸节奏的具体消费方式和必要数值，优先采用选中主题的容器/控件形状与内距、组间距、列表行高。通用业务页参考值只补主题未定义项，不能用固定大圆角、padding 或 gap 覆盖主题。呼吸感来自对齐、分组、层级和节奏，不来自超宽空 KPI 框或空白卡。
-12. **背景与内容层次清晰**：正文说明主题如何用色差、细边界、共容器、留白或材质区分内容。同色画布与面板可通过明确边界和分组成立；渐变、玻璃、阴影按主题规则启用，不强制添加。
-13. **模板与自由创意并列**：始终支持[自由创意](references/application-style-library.md)，根据业务独立推演，不要求从模板选择。使用模板时，先按业务任务、信息拓扑选择风格，再按用户确认的色彩氛围协调页面、卡片、导航、填充、边界和交互。布局、圆角与材质可保留，模板固定灰阶和品牌色面积限制不能覆盖用户要求。“自然绿意”等整体风格不能缩减成只有按钮和 logo 变绿；明确只改强调色或忠实中性参考时才保持原画布。文字保留可读的中性层级，状态保留独立语义。
-14. **应用主题统一**：按 [整体主题规则](references/application-theme-consistency.md#导航与应用框架) 一起设计导航、应用框架、提交/编辑表单、记录详情和自定义页面。`app-theme.css` 保存完整主题变量与消费样式。`YidaCodeCanvas` 页面只在 `YidaComp` 内消费 `--color-brand1-*`、`--color-group` 和 `--pod-*`；严禁页面代码修改或向上层注入主题变量。应用包含表单或详情页时，读取 [表单风格规则](references/native-form-styles.md)，将组件布局和只读详情样式写入 `design.md`；视觉值写入应用主题 CSS，结构写入表单配置。
+11. **默认圆润高密且有呼吸感**：业务工具页默认使用圆润形状、紧凑信息密度和清晰呼吸节奏。`design.md` 必须写清 `roundedRule`、`densityRule` 和 `breathingRule`：卡片 padding 必须大于 20px（默认 22-28px），卡片与卡片的 gap 必须小于 20px（默认 12-18px），卡片圆角范围 0-32px（业务卡片默认 20-24px），控件 10-14px，状态摘要 64-88px，动作条 40-56px，列表行 44-56px，空态 88-120px 内；页面边距、卡片 gap 和卡片 padding 要形成可扫读的分组节奏。呼吸感来自对齐、分组、层级和节奏，不来自额外 margin、超宽空 KPI 框或空白卡撑页面。
+12. **背景与卡片必须有层次对比**：默认业务页背景保持浅色调、清爽但不能与卡片相近或相同。`design.md` 必须写清 `surfaceContrast`：白色/浅色背景配有边框卡片；浅灰背景（如 `#F3F4F6`）配白色无边框卡片；浅彩色背景（如浅蓝、浅暖灰）配白色无边框卡片；渐变背景配玻璃感卡片。禁止浅底白卡无边框、同色背景同色卡片或只有阴影没有色差/边框的层次。
+13. **设计风格先选后定制**：先按业务任务、信息拓扑选择风格，再按用户确认的色彩氛围协调页面、卡片、导航、填充、边界和交互。布局、圆角与材质可保留，模板固定灰阶和品牌色面积限制不能覆盖用户要求。“自然绿意”等整体风格不能缩减成只有按钮和 logo 变绿；明确只改强调色或忠实中性参考时才保持原画布。文字保留可读的中性层级，状态保留独立语义。
+14. **应用主题统一**：`app-theme.css` 只在应用级配置，由平台统一作用于应用壳、原生表单、详情页和自定义页面外层。`YidaCodeCanvas` 页面只在 `YidaComp` 内消费 `--color-brand1-*`、`--color-group` 和 `--pod-*`；严禁页面代码修改或向上层注入主题变量。
 15. **参考转成可执行选择**：参考 Dribbble / 优秀案例时，落到主色、背景素材、首屏构图、信息密度、动线、区块数量和反默认点。
 16. **页面文案和图标使用专业表达**：渲染文案使用纯文本；图标只使用 `lucide-react` 或 `@ant-design/icons` 的具体组件，默认选择 `lucide-react`，并在 `design.md` 的 `iconSystem` 中写清业务动作、状态、导航和空态到图标组件的映射。emoji 不能改成 CSS 形状、字母占位、Unicode 符号或临时 SVG；如果需要图标，必须映射到上述两类库的具体组件。
 17. **实现交接明确**：设计产物只定义页面结构、视觉系统和验收标准；常规业务图表使用 `yida-rechart`；ECharts 例外只用于用户明确要求复杂 ECharts option 或维护旧图表。
@@ -89,16 +75,15 @@ Fast、Plan 和单页设计使用相同的 UI 设计规则、主题变量和质
 | [读取整理后的用户需求](workflow/step-1-read-brief.md) | 业务对象、页面场景、明确范围、品牌和色彩偏好 | 完整应用必读 |
 | [选择主题色和 token](workflow/step-2-theme-system.md) | 主题 token、色彩、字体、组件基调 | 涉及主题或视觉 |
 | [页面结构和交互设计](workflow/step-4-wireframe-interaction.md) | 布局骨架、内容区块、主操作、抽屉、响应式 | 页面设计 |
-| [UI 视觉和状态设计](workflow/step-5-visual-states.md) | 设计风格选择、视觉特征、主题换肤、素材图标、空/载/错态、去 AI 味 | 输出前自检 |
+| [UI 视觉和状态设计](workflow/step-5-visual-states.md) | 设计风格选择、视觉 DNA、主题换肤、素材图标、空/载/错态、去 AI 味 | 输出前自检 |
 | [写入 design.md](workflow/step-6-handoff.md) | `design.md` 必填内容、稳定引用和完成条件 | 输出前 |
 | [page-design 单页设计](sub_skill/page-design/SKILL.md) | 单页主题证据、页面级设计流程、输出补充字段 | 单个自定义页设计 |
 | [design.md 输出格式](workflow/output-design.md) | `design.md` 字段示例 | Fast 写入前；Plan 定制时按需 |
-| [共享主题选择规则](references/theme-selection.md) | Fast、Plan、单页共用的摘要选型、项目化和读取边界 | 主题选择与生成 |
-| [视觉结构配方库](references/visual-scaffold-recipes.md) | 把真实内容组织为可实现的布局、表面与响应式安排 | UI 视觉设计 |
+| [design.md 生成规则](references/style-design-selection.md) | 从业务推演视觉 DNA，选择设计风格并按主题色换肤，生成应用级 `design.md` | UI 视觉设计 |
+| [视觉结构配方库](references/visual-scaffold-recipes.md) | 将高质量页面结构转成 `visualScaffold` 槽位，约束页面实现落地 | UI 视觉设计 |
 | [页面质量门禁](references/page-quality-gates.md) | 区块数量、源码槽位、低密大卡片、主题一致性和 `pageSpecHandoff` 检查 | 页面结构、视觉与交接阶段 |
-| [共享主题索引](templates/design-themes/index.json) | 唯一主题 ID、路径与精简风格摘要 | 选前只读摘要；选后只读对应完整主题 |
-| [基础变量契约](templates/design-themes/basic-tokens.json) | 全局基础变量与固定值 | 主题项目化和 token 校验 |
-| [应用结构参考](../yida-prd/references/app/blueprint.md) | 应用角色、导航、页面清单、页面/表单/流程资源蓝图 | 完整应用或主页面 |
+| [style-design 风格注册表](references/style-designs/registry.md) | 内置视觉 DNA 风格、选择评分、风险扣分、风格消费规则 | UI 视觉设计 |
+| [应用结构参考](references/app/blueprint.md) | 应用角色、导航、页面清单、页面/表单/流程资源蓝图 | 完整应用或主页面 |
 | [应用主题与 token 参考](references/theme/theme-token-presets.md) | 平台主题 key、候选主题、token profile | 需要主题 key 或 token |
 | [应用主题 CSS 模板](references/theme/app-custom-theme-template.css) | AI 可复制修改的品牌、Shell、页面、表格和导航 token | 生成自定义应用主题文件时必读 |
 | [yida-canvas-custom-page 样式实现指南](../yida-canvas-custom-page/references/canvas-style-implementation-guide.md) | 将 `design.md` 的 token、背景、圆角、密度和组件规则落到页面源码、antd、CSS、图表和控件状态 | 实现阶段 |