openyida 2026.9.19 → 2026.9.21

package/yida-skills/skills/yida-design/sub_skill/yida-design-plan/references/visual-theme-selection.md

@@ -3,7 +3,7 @@
 ## 用途
 
 - 用户已说明想要的风格，就按要求设计。
-- 用户想比较几种风格时，读取本文，准备配色、菜单明暗和组件样式等方案供用户选择。
+- Plan 没有明确完整风格时，读取本文，准备三套配色、表面层次和组件样式方案供用户选择。
 - 用户选界面风格，AI 负责匹配实现用的主题模板。
 
 ## 核心关系
@@ -11,15 +11,16 @@
 ```text
 应用场景与视觉证据
   → AI 定义项目视觉方向
-  → 绑定主题索引中的可落地基底
+  → 选择命名模板，或自由创意独立推演
   → 用户选择一套完整方向
-  → 风格、配色、导航和主题选择
+  → 风格、配色和主题选择；导航结构沿用业务规划
+  → 命名模板的导航明暗由模板派生；自由创意明确设计导航明暗
   → CLI 读取所选完整模板并生成 design.md
 ```
 
-先按[设计方向比较](../../../references/theme-selection.md#设计方向比较)根据项目需求发展风格，再匹配主题索引中的模板。匹配成功后，将方案提供给用户选择。
+先按[设计方向比较](../../../references/theme-selection.md#设计方向比较)根据项目需求发展风格，可匹配主题索引中的模板，也可独立推演。按[应用风格与自由创意](../../../references/application-style-library.md)交付。
 
-应用编排先根据业务需求确定导航方式。视觉设计沿用该结果，设计各页面共用的配色、菜单明暗、背景、圆角和组件样式。页面内容、布局和操作顺序按业务规划执行。
+应用编排先根据业务需求确定导航结构。视觉设计沿用该结果，设计各页面共用的配色、背景、圆角和组件样式；命名模板的导航明暗采用模板 `navTheme`；自由创意由项目设计明确填写。页面内容、布局和操作顺序按业务规划执行。
 
 主色按所选主题的公式推导，其他颜色沿用主题。已选方向承诺的画布、卡片、填充、字体或辅助色与模板不同时，将具体差异写入 `visualStyle.tokens`，不等待用户逐个指定色值。`description` 和 `colorStrategy.usage` 只说明用途，不会被编译成配色。按 [共用主题规则](../../../references/application-theme-consistency.md) 完成变量后再交接页面；渐变和图片按公共输出契约处理。Fast 与 Plan 使用相同规则。
 
@@ -29,7 +30,7 @@
 
 ## 候选结构与约束
 
-生成恰好三套候选，每套包含：
+生成三项选择：两个具体视觉方向，加一项“自由创意：根据业务重新推演”。用户已明确风格时直接沿用，无需重选。具体方向包含：
 
 ```json
 {
@@ -39,8 +40,7 @@
   "themeId": "<有效索引记录，仅内部>",
   "primaryColor": "#6F4E37",
   "primaryColorName": "暖咖啡棕",
-  "navigationStructure": "side",
-  "navigationTone": "dark",
+  "contentTone": "light",
   "recommendationReason": "适合需要持续查看关系历史和推进状态的日常工作。"
 }
 ```
@@ -49,12 +49,12 @@
 
 1. 第一项为推荐项。
 2. `directionLabel`、`description` 和 `recommendationReason` 由 AI 根据项目的用户、任务和界面效果编写。
-3. `themeId` 必须来自索引，三项绑定不同记录；模板路径由索引在选择后确定性补齐。
-4. 候选保持已确认的导航类型；通过主题基底、主题色、导航明暗形成差异，优先至少两项不同。用户约束固定的部分保持不变。
-5. 配色和菜单明暗应依据品牌素材、用户偏好和实际使用场景选择，并写清理由。
+3. `themeId` 必须来自索引，两个模板方向绑定不同记录，自由创意使用 catalog.creativeOption；模板路径由索引在选择后确定性补齐。
+4. 模板候选保持已确认的导航结构，但不输出 `navigationTone`。候选可以通过不同主题呈现深色或浅色导航差异，这个差异来自主题模板，而不是 AI 单独填写字段；优先至少两项视觉维度不同。用户约束固定的部分保持不变。
+5. 配色依据品牌素材、用户偏好和实际使用场景选择，并写清理由。用户明确菜单明暗时，将其作为主题筛选条件；用户未明确时不推导菜单明暗。
 6. 用户明确品牌色时保留该颜色，通过主题基底、材质和组件表达形成差异。
-7. 项目色彩和已确定导航可覆盖模板默认变量；表面层级、形状语言、组件机制等核心视觉特征与模板冲突时必须换一个基底。
-8. 方案缺少匹配模板时，重新设计并匹配，完成后再展示。
+7. 项目色彩和已确定的导航结构可覆盖模板对应输入；导航明暗不得覆盖模板 `navTheme`。用户导航明暗要求或表面层级、形状语言、组件机制等核心视觉特征与模板冲突时必须换一个基底。
+8. 方案缺少匹配模板时走自由创意，填写独立设计决策和 Token。自由创意的导航明暗由项目设计决定，写入 navigationStyle.tone；内容与导航按[主题明暗双轴](../../../references/application-style-library.md#主题明暗双轴)分别设计。
 
 平台导航沿用 `navigationType` 对应的顶部、侧边或 L 型布局。自定义导航由视觉设计细化顶部、侧边等菜单样式，按该入口已确定的配置范围实施。
 
@@ -92,9 +92,9 @@
       "description": "<second.description> <second.recommendationReason>"
     },
     {
-      "value": "<third.directionId>",
-      "label": "<third.directionLabel>",
-      "description": "<third.description> <third.recommendationReason>"
+      "value": "free-creative",
+      "label": "自由创意",
+      "description": "根据这项业务重新推演构图、材质和表单布局，不从现成模板选取。"
     }
   ],
   "allowCustom": true,
@@ -123,9 +123,8 @@
     },
     "navigationStyle": {
       "structure": "side",
-      "tone": "dark",
       "source": "user_selected",
-      "selectionReason": "持续工作场景需要稳定入口，深色导航加强模块边界。"
+      "selectionReason": "持续工作场景需要稳定的侧边入口；导航明暗由所选主题模板确定。"
     }
   },
   "internal": {
@@ -138,18 +137,18 @@
 }
 ```
 
-`build-plan.json` 保存选中方案；完整候选保留在 `ask_human` 问答历史中。上例只展示选择事实，已选方向需要的画布、字体、辅助色等差异还须写入同级 `tokens`，见 [共用主题示例](../../../references/application-theme-consistency.md#先把风格落到变量)。
+`build-plan.json` 保存选中方案；完整候选保留在 `ask_human` 问答历史中。命名模板由 CLI 补入 `navigationStyle.tone` 和 `toneSource=theme_derived`；自由创意在 visual.json 中明确编写 tone=light|dark，CLI 标记 toneSource=project_defined，后续可通过 patch 修改该 tone。上例只展示选择事实，已选方向需要的画布、字体、辅助色等差异还须写入同级 `tokens`，见 [共用主题示例](../../../references/application-theme-consistency.md#先把风格落到变量)。
 
 ## 直接选择与自定义输入
 
-- 用户已明确主题色、导航结构和导航明暗，或要求严格继承可信品牌/模板时，AI 匹配一个有效基底并直接写入，`source=user_explicit | material_extracted`。
-- 用户明确采用推荐方案或不再提问时，选择第一项，`source=ai_inferred`。
+- 只有用户已明确完整视觉风格、指定现有主题，或要求严格继承可信品牌/模板时，AI 才直接匹配一个有效基底并写入，`source=user_explicit | material_extracted`。单独的主题色、导航结构或导航明暗只作为候选约束，不视为已给出完整风格；导航明暗也不另存为可覆盖模板的输入。
+- 用户在三套候选中明确采用推荐方案时，选择第一项，`source=user_selected`。
 - 用户自由描述新方向时，先匹配核心视觉特征最近且不违反硬约束的模板。能够匹配则记录原文为 `customText` 并写入项目覆盖项。
-- 所有模板都不支持时，只问一次：采用最接近的可用基底，或返回三套方向重新选择。收到选择后继续规划。
+- 所有模板都不支持时，沿用自由创意选项，从已确认业务独立推演并继续规划。
 
 ## 运行时读取边界
 
 - Step 2 读取本规则和主题索引中的精简风格摘要，不读取候选模板全文。
 - 候选阶段只提供方向名称、配色与体验说明。
-- 用户选择后保存选中方向、内部主题绑定和实现该方向所需的 token 差异。
+- 用户选择后保存选中方向、内部主题绑定、导航结构和实现该方向所需的 token 差异；CLI 从模板读取导航明暗。
 - 用户确认主题后，规划时读取 CLI 返回的主题上下文；CLI 仅按已确认的 selectedTheme.themeId 读取选中的完整模板生成文档。

package/yida-skills/skills/yida-design/sub_skill/yida-design-plan/scripts/render_build_plan.py

@@ -941,6 +941,8 @@ def render_execution(data: dict[str, Any]) -> str:
     hidden_pages = execution.get("pageNavigation") or []
     if hidden_pages:
         parts += ["<h3>页面导航</h3>", table(["页面", "平台页面导航"], [[item.get("name"), "隐藏" if item.get("isRenderNav") is False else "显示"] for item in hidden_pages])]
+    if execution.get("entryModeSummary"):
+        parts += ["<h3>系统怎么使用</h3>", f'<p>{esc(execution["entryModeSummary"])}</p>']
     for entry in (execution.get("entryRecommendation") or {}).get("entries", []):
         rows = []
 

package/yida-skills/skills/yida-design/templates/application-styles.json

@@ -0,0 +1,398 @@
+[
+  {
+    "id": "app-wire",
+    "label": "精密线框",
+    "ink": "#242826",
+    "canvas": "#f7f8f6",
+    "surface": "#ffffff",
+    "border": "#c0c6c2",
+    "radius": 2,
+    "height": 38,
+    "width": 940,
+    "padding": 28,
+    "gap": 18,
+    "columns": "6:6",
+    "intro": "顶端编号标题与标尺式章节",
+    "composition": "横向工具带与精确双列工作区",
+    "material": "细线框、浅网格、平面无阴影",
+    "scenario": "适合研发、资产与审计。",
+    "accent": "#242826",
+    "background": "repeating-linear-gradient(0deg, transparent 0 23px, rgba(36,40,38,.045) 23px 24px), repeating-linear-gradient(90deg, transparent 0 23px, rgba(36,40,38,.045) 23px 24px)"
+  },
+  {
+    "id": "app-paper",
+    "label": "奶油手账",
+    "ink": "#745338",
+    "canvas": "#e9dfcd",
+    "surface": "#fffaf0",
+    "border": "#b49a76",
+    "radius": 8,
+    "height": 44,
+    "width": 690,
+    "padding": 42,
+    "gap": 30,
+    "columns": "12",
+    "intro": "纸页顶部题签与短说明",
+    "composition": "窄幅纵向阅读与按日期组织的清单",
+    "material": "暖纸面、虚线章节、柔和纸张阴影",
+    "scenario": "适合服务登记、档案与内容策划。",
+    "accent": "#745338",
+    "headingFont": "Georgia, 'Songti SC', serif",
+    "headingSize": 44,
+    "rule": "dashed",
+    "shadow": "0 4px 12px rgba(116,83,56,.10)",
+    "background": "repeating-linear-gradient(0deg, transparent 0 31px, rgba(116,83,56,.04) 31px 32px)"
+  },
+  {
+    "id": "app-sage",
+    "label": "植物浮雕",
+    "ink": "#345b49",
+    "canvas": "#dce7df",
+    "surface": "#eaf1ea",
+    "border": "#bfcebf",
+    "radius": 16,
+    "height": 46,
+    "width": 900,
+    "padding": 40,
+    "gap": 30,
+    "columns": "6:6",
+    "intro": "低对比色块介绍与圆弧分组",
+    "composition": "宽松双列、纵向状态清单与柔和分区",
+    "material": "柔绿表面、轻内凹、圆润控件",
+    "scenario": "适合健康服务、员工关怀与资源协作。",
+    "accent": "#345b49",
+    "shadow": "inset 0 1px 2px rgba(52,91,73,.10)"
+  },
+  {
+    "id": "app-pop",
+    "label": "波普印刷",
+    "ink": "#211c21",
+    "canvas": "#ffde59",
+    "surface": "#fffdf6",
+    "border": "#211c21",
+    "radius": 0,
+    "height": 46,
+    "width": 1000,
+    "padding": 32,
+    "gap": 26,
+    "columns": "8:4",
+    "intro": "大字印刷标题与偏置章号",
+    "composition": "不对称二比一工作区与粗线信息带",
+    "material": "方角、粗墨线、硬偏移阴影",
+    "scenario": "适合活动执行、创意制作与品牌运营。",
+    "accent": "#211c21",
+    "stroke": 3,
+    "shadow": "4px 4px 0 #211c21",
+    "headingSize": 44
+  },
+  {
+    "id": "app-neon",
+    "label": "午夜霓虹",
+    "ink": "#b4f5f1",
+    "canvas": "#080f21",
+    "surface": "#111b31",
+    "border": "#356274",
+    "radius": 10,
+    "height": 44,
+    "width": 1040,
+    "padding": 32,
+    "gap": 22,
+    "columns": "6:6",
+    "intro": "小号技术编号与发光横线",
+    "composition": "横向监控总览与双列任务区",
+    "material": "深海蓝层次、局部青色微光",
+    "scenario": "适合明确要求暗色的技术值守。",
+    "accent": "#b4f5f1",
+    "contentTone": "dark",
+    "navTheme": "dark",
+    "background": "radial-gradient(ellipse at 10% 0%, rgba(80,205,210,.14), transparent 55%), radial-gradient(ellipse at 90% 100%, rgba(139,93,228,.12), transparent 55%)"
+  },
+  {
+    "id": "app-line",
+    "label": "极简下划线",
+    "ink": "#242323",
+    "canvas": "#f2f1ee",
+    "surface": "#ffffff",
+    "border": "#aaa5a0",
+    "radius": 0,
+    "height": 48,
+    "width": 680,
+    "padding": 48,
+    "gap": 38,
+    "columns": "12",
+    "intro": "纯文字标题与短红色侧线",
+    "composition": "窄幅单列、连续正文与留白章节",
+    "material": "无浮起卡片、平面纸白、强调下划线",
+    "scenario": "适合申请、访谈与简洁审批。",
+    "accent": "#242323"
+  },
+  {
+    "id": "app-glass",
+    "label": "雾面玻璃",
+    "ink": "#45345f",
+    "canvas": "#e5dff2",
+    "surface": "#f9f7fd",
+    "border": "#c8bfd6",
+    "radius": 20,
+    "height": 48,
+    "width": 880,
+    "padding": 40,
+    "gap": 28,
+    "columns": "6:6",
+    "intro": "轻透标题面与辅助说明",
+    "composition": "流动双列、层叠摘要与留白工作区",
+    "material": "雾紫衬底、柔边和低强度漫射阴影",
+    "scenario": "适合服务门户与体验反馈。",
+    "accent": "#45345f",
+    "shadow": "0 10px 32px rgba(69,52,95,.12)",
+    "background": "radial-gradient(ellipse at 5% 20%, rgba(159,209,220,.35), transparent 60%), radial-gradient(ellipse at 90% 70%, rgba(179,145,223,.3), transparent 60%)"
+  },
+  {
+    "id": "app-ticket",
+    "label": "复古票据",
+    "ink": "#733c26",
+    "canvas": "#b96b49",
+    "surface": "#fff2d5",
+    "border": "#a7744d",
+    "radius": 0,
+    "height": 40,
+    "width": 660,
+    "padding": 28,
+    "gap": 16,
+    "columns": "12",
+    "intro": "票据抬头、单据编号与细密说明",
+    "composition": "窄单据纵向排布与对齐的键值清单",
+    "material": "暖纸、双分割线、印章式操作",
+    "scenario": "适合订单、交付与报销。",
+    "accent": "#733c26",
+    "rule": "double"
+  },
+  {
+    "id": "app-editorial",
+    "label": "杂志编辑",
+    "ink": "#692e3e",
+    "canvas": "#ede7e0",
+    "surface": "#fffdf8",
+    "border": "#ac8490",
+    "radius": 0,
+    "height": 44,
+    "width": 1100,
+    "padding": 40,
+    "gap": 28,
+    "columns": "6:6",
+    "intro": "左侧大衬线标题、导语与右侧章节正文",
+    "composition": "非对称编辑栏与跨栏内容摘要",
+    "material": "酒红细线、纸白表面、大标题与克制留白",
+    "scenario": "适合知识、内容与文化业务。",
+    "accent": "#692e3e",
+    "rail": true,
+    "headingFont": "Georgia, 'Songti SC', serif",
+    "headingSize": 44
+  },
+  {
+    "id": "app-terminal",
+    "label": "终端像素",
+    "ink": "#9fe5ad",
+    "canvas": "#0e1813",
+    "surface": "#15231a",
+    "border": "#558966",
+    "radius": 0,
+    "height": 40,
+    "width": 960,
+    "padding": 24,
+    "gap": 12,
+    "columns": "6:6",
+    "intro": "命令行式短标题与流程提示",
+    "composition": "紧凑双列与可扫描的日志清单",
+    "material": "像素直角、点线边界、等宽排版",
+    "scenario": "适合明确要求终端风格的技术工具。",
+    "accent": "#9fe5ad",
+    "contentTone": "dark",
+    "navTheme": "dark",
+    "font": "'SFMono-Regular', Consolas, monospace",
+    "rule": "dotted"
+  },
+  {
+    "id": "app-platinum",
+    "label": "铂金商务",
+    "ink": "#35434b",
+    "canvas": "#eef0ef",
+    "surface": "#ffffff",
+    "border": "#d1d8d7",
+    "radius": 6,
+    "height": 38,
+    "width": 1000,
+    "padding": 36,
+    "gap": 24,
+    "columns": "6:6",
+    "intro": "克制抬头与细线章节",
+    "composition": "稳定双列与合同摘要侧栏",
+    "material": "铂灰细线、低圆角、均衡留白",
+    "scenario": "适合合同、采购与商务审批。",
+    "accent": "#35434b"
+  },
+  {
+    "id": "app-executive",
+    "label": "墨金行政",
+    "ink": "#d9c49a",
+    "canvas": "#151919",
+    "surface": "#222826",
+    "border": "#596054",
+    "radius": 4,
+    "height": 42,
+    "width": 1080,
+    "padding": 40,
+    "gap": 30,
+    "columns": "12",
+    "intro": "左侧香槟金衬线标题与用途说明，右侧单列章节",
+    "composition": "四分之一介绍栏与四分之三主工作区",
+    "material": "墨绿黑表面、金色细节与长横线",
+    "scenario": "适合明确要求暗色的战略与高管事项。",
+    "accent": "#d9c49a",
+    "contentTone": "dark",
+    "navTheme": "dark",
+    "rail": true,
+    "headingFont": "Georgia, 'Songti SC', serif",
+    "headingSize": 44,
+    "background": "linear-gradient(120deg, rgba(217,196,154,.04), transparent 65%)"
+  },
+  {
+    "id": "app-finance",
+    "label": "金融蓝图",
+    "ink": "#274e78",
+    "canvas": "#edf2f7",
+    "surface": "#ffffff",
+    "border": "#c4d1df",
+    "radius": 4,
+    "height": 36,
+    "width": 1080,
+    "padding": 28,
+    "gap": 16,
+    "columns": "6:6",
+    "intro": "技术抬头与编号章节",
+    "composition": "密集双列、水平标签与对齐金额",
+    "material": "淡蓝图纸、清晰细边界、低圆角",
+    "scenario": "适合预算、风险与资金计划。",
+    "accent": "#274e78"
+  },
+  {
+    "id": "app-nordic",
+    "label": "北欧云白",
+    "ink": "#526361",
+    "canvas": "#f2f5f3",
+    "surface": "#ffffff",
+    "border": "#dce4df",
+    "radius": 14,
+    "height": 46,
+    "width": 720,
+    "padding": 52,
+    "gap": 36,
+    "columns": "12",
+    "intro": "简短自然标题与舒展说明",
+    "composition": "单列阅读与低密度任务清单",
+    "material": "云白表面、柔圆角与大段间距",
+    "scenario": "适合员工服务与预约申请。",
+    "accent": "#526361"
+  },
+  {
+    "id": "app-teal",
+    "label": "青岚运营",
+    "ink": "#24665f",
+    "canvas": "#edf4f2",
+    "surface": "#ffffff",
+    "border": "#bfd6d0",
+    "radius": 8,
+    "height": 40,
+    "width": 980,
+    "padding": 32,
+    "gap": 24,
+    "columns": "8:4",
+    "intro": "窄色带章节与任务说明",
+    "composition": "二比一主次区、任务流与状态摘要条",
+    "material": "青绿弱填充、清晰分组、适度圆角",
+    "scenario": "适合运营排班、供应与项目协同。",
+    "accent": "#24665f"
+  },
+  {
+    "id": "app-amber",
+    "label": "琥珀工单",
+    "ink": "#805c26",
+    "canvas": "#f3f0e9",
+    "surface": "#fffefa",
+    "border": "#d6cbb8",
+    "radius": 3,
+    "height": 34,
+    "width": 1140,
+    "padding": 24,
+    "gap": 14,
+    "columns": "4:4:4",
+    "intro": "工单编号与薄型摘要带",
+    "composition": "三列短字段、项目名跨列、子表整行",
+    "material": "低圆角、琥珀细边、紧凑清单",
+    "scenario": "适合设备工单与现场服务。",
+    "accent": "#805c26"
+  },
+  {
+    "id": "app-graphite",
+    "label": "石墨数据",
+    "ink": "#c7d4dc",
+    "canvas": "#171d23",
+    "surface": "#242d35",
+    "border": "#485863",
+    "radius": 4,
+    "height": 36,
+    "width": 1100,
+    "padding": 24,
+    "gap": 10,
+    "columns": "6:6",
+    "intro": "小标题、信息计数与细行分隔",
+    "composition": "密集双列与连续数据表、横向标签",
+    "material": "石墨层次、细行线、低圆角",
+    "scenario": "适合明确要求暗色的数据运营。",
+    "accent": "#c7d4dc",
+    "contentTone": "dark",
+    "navTheme": "dark"
+  },
+  {
+    "id": "app-plum",
+    "label": "绛紫咨询",
+    "ink": "#685167",
+    "canvas": "#f2eef1",
+    "surface": "#fffdfd",
+    "border": "#d8cad5",
+    "radius": 10,
+    "height": 44,
+    "width": 1060,
+    "padding": 44,
+    "gap": 32,
+    "columns": "7:5",
+    "intro": "衬线标题、导语与双线章节",
+    "composition": "接近三比二的咨询内容与上下文分栏",
+    "material": "绛紫细线、柔白表面与舒展阅读",
+    "scenario": "适合咨询、客户服务与调研。",
+    "accent": "#685167",
+    "headingFont": "Georgia, 'Songti SC', serif",
+    "headingSize": 44,
+    "rule": "double"
+  },
+  {
+    "id": "free-creative",
+    "label": "自由创意",
+    "ink": "#242424",
+    "canvas": "#f6f6f6",
+    "surface": "#ffffff",
+    "border": "#cccccc",
+    "radius": 4,
+    "height": 36,
+    "width": 1000,
+    "padding": 24,
+    "gap": 20,
+    "columns": "12",
+    "intro": "从业务内容自主决定介绍的位置与形态",
+    "composition": "从任务频率和内容拓扑推导工作区",
+    "material": "从品牌与使用环境自主决定材质",
+    "scenario": "不从命名模板选择，必须提交独立推演依据。",
+    "accent": "#242424",
+    "mode": "creative"
+  }
+]

package/yida-skills/skills/yida-design/templates/design-themes/README.md

@@ -5,24 +5,28 @@
 ## 文件职责
 
 - [index.json](index.json) 维护主题 ID、用户可读名称、模板路径和选型摘要，`schemaVersion` 为 `2.0`。
-- `<themeId>.md` 保存完整 V2 主题模板，是视觉规则和 Token 数值的事实源。
-- [basic-tokens.json](basic-tokens.json) 保存 69 个全局变量及固定值，作为模板校验依据。
+- `<themeId>/design.md` 保存完整 V2 主题模板，是视觉规则和 Token 数值的事实源。
+- 每个主题目录统一包含 `design.md`、`app_theme.css`、`form-layout.json` 三个文件；CSS 保留品牌颜色占位，布局文件提供可填入业务字段的组件结构。
+- [basic-tokens.json](basic-tokens.json) 保存 70 个全局变量及固定值，作为模板校验依据。
 - [validate_design_themes.py](../../scripts/validate_design_themes.py) 校验索引、模板及变量引用。
 
 每条索引记录包含以下字段：
 
 | 字段 | 维护要求 |
 | --- | --- |
-| `themeId` | 唯一的小写连字符 ID，与模板 frontmatter 和文件名一致 |
+| `themeId` | 唯一的小写连字符 ID，与模板 frontmatter 和主题目录名一致 |
 | `label` | 唯一的用户可读名称 |
-| `templatePath` | `templates/design-themes/<themeId>.md`，相对公共 `yida-design` 根目录 |
-| `styleSummary` | 从模板“风格摘要”精简约 150–250 字，保留外观、核心差异、偏离风险与真实内容适用条件 |
+| `templatePath` | `templates/design-themes/<themeId>/design.md`，相对公共 `yida-design` 根目录 |
+| `cssTemplatePath` | `templates/design-themes/<themeId>/app_theme.css` |
+| `formLayoutPath` | `templates/design-themes/<themeId>/form-layout.json` |
+| `legacyTemplatePath` | 已迁移主题的原 Markdown 路径，供历史方案读取；新方案使用 `templatePath` |
+| `styleSummary` | 以“深色/浅色导航，深色/浅色内容界面。”开头，再从模板“风格摘要”精简约 150–250 字；使用自然语言，避免把 `dark` 误解为纯黑色，同时保留外观、核心差异、偏离风险与真实内容适用条件 |
 
-一条索引记录对应一份模板，所有模板均须登记。修改风格摘要后同步修改索引摘要，不增加原文没有的特征或另一组关键词。`openyida design-plan catalog --json` 返回同一份索引；三种设计入口不得维护平行主题清单。主题不按业务领域或产品形态限制候选资格，具体布局与特色表达由真实内容决定。
+34 个主题入口均采用三文件结构，可通过 `sample yida-design application-style --style-id <themeId>` 导出。一条索引记录对应一个主题目录，所有模板均须登记。修改风格摘要后同步修改索引摘要，不增加原文没有的特征或另一组关键词。`openyida design-plan catalog --json` 返回同一份索引；三种设计入口不得维护平行主题清单。主题不按业务领域或产品形态限制候选资格，具体布局与特色表达由真实内容决定。
 
 ## V2 模板结构
 
-Frontmatter 包含 `name`、`description`、`themeId` 和 `tokens`。正文依次包含五个章节：
+Frontmatter 包含 `name`、`description`、`themeId`、`navTheme` 和 `tokens`；`navTheme` 只允许 `light` 或 `dark`，并与主题导航 Token 的实际明暗一致。正文依次包含五个章节：
 
 1. 风格摘要
 2. 页面视觉系统
@@ -34,13 +38,14 @@ Frontmatter 包含 `name`、`description`、`themeId` 和 `tokens`。正文依
 
 ## Token 契约
 
-`tokens.application-global` 按 `appearance`（含表面和导航）、`colors`、`typography`、`spacing`、`rounded`、`shadow` 分组，完整定义契约中的 69 个基础变量；这是最小集合，允许按角色补充变量。`tokens.custom-page` 可为空，也可组织跨页面与组件复用的项目扩展变量，包括材质、布局、字体、动效等。两组均写入主题 CSS 的 `:root`，分组不是运行时隔离作用域，变量前缀不限定为 `--oyd-*`。递归读取以 `--` 开头的标量叶子，分组名不拼入 CSS 变量名。
+`tokens.application-global` 按 `appearance`（含表面和导航）、`colors`、`typography`、`spacing`、`rounded`、`shadow` 分组，完整定义契约中的 70 个基础变量；这是最小集合，允许按角色补充变量。`tokens.custom-page` 可为空，也可组织跨页面与组件复用的项目扩展变量，包括材质、布局、字体、动效等。两组均写入主题 CSS 的 `:root`，分组不是运行时隔离作用域，变量前缀不限定为 `--oyd-*`。递归读取以 `--` 开头的标量叶子，分组名不拼入 CSS 变量名。
 
 - 字体与间距使用契约固定值；页面标题使用 subhead，表格正文使用 table。
 - 颜色与圆角保留主题差异。Tooltip 固定使用 `#262626` 与 `#FFFFFF`。
 - `--color-white` 和 `--pod-table-cell-color` 通过 `var(--pod-card-bg-color)` 继承内容表面；页面桥接 `--oyd-page-bg` 若存在，使用 `var(--pod-page-bg-color)`。
-- `--color-brand1-6` 使用项目主色占位符，其他品牌档位明确引用这个主色种子推导。`<生成实际色值：…>` 属于推导指令，项目化时替换为实际 CSS 值。
+- `design.md` 与 `app_theme.css` 中，`--color-brand1-6` 保留 `{{PRIMARY_COLOR}}`，`--color-brand1-1` 保留品牌悬停色的同源生成占位，其他品牌档位也由主色种子推导。`<生成实际色值：…>` 属于推导指令，项目化时替换为实际 CSS 值。先完成项目 `design.md`，再运行 `sample yida-design app-theme --design-file <design.md> --output <app_theme.css>`；该命令会替换导出 CSS 的占位。
 - 变量名在两层及各分组中均唯一；平台基础与项目扩展均在主题中声明，可无环引用，并按实际设计补充变量。声明与正文中的引用必须存在，不得循环引用，不使用后缀缩写或 `*` 通配写法。
+- 原生导航选中项阴影统一由 `--pod-nav-menu-item-selected-shadow` 控制；不需要额外标记的主题显式写 `none`，需要标记的主题写完整 `box-shadow` 值。该值不绑定方向：左、右、下强调线分别使用正水平偏移、负水平偏移、负垂直偏移的 `inset` 阴影。公共 CSS 模板负责消费该变量，主题模板不保存平台 DOM 选择器。
 - 标量可用双引号、单引号或普通 CSS 文本；数字可以不加引号。不使用 YAML 数组、别名、标签或多行标量。
 
 ## 项目化占位符
@@ -63,6 +68,6 @@ npm run check:skills
 
 校验器只依赖 Python 3.9+ 标准库；`check:skills` 自动尝试 `python3`、`python`、Windows 的 `py -3`，找不到可用解释器时明确失败，不能跳过。`check:ci` 已包含 `check:skills`。
 
-`check:skills` 还通过 CLI 的公共主题校验检查 `references/theme/app-custom-theme-template.css`，包括括号、字符串和注释闭合、品牌色阶及受限内容。主题生成测试检查 15 套主题的 token 位于顶层 `:root`，并保留白色、灰色导航的变量引用与回退链；不能用正则匹配到变量代替作用域验证。
+`check:skills` 还通过 CLI 的公共主题校验检查 `references/theme/app-custom-theme-template.css`，包括括号、字符串和注释闭合、品牌色阶及受限内容。主题生成测试检查全部主题的 token 位于顶层 `:root`，并保留白色、灰色导航的变量引用与回退链；不能用正则匹配到变量代替作用域验证。
 
 校验覆盖索引与模板一一对应、ID 和路径安全、五章节与四个项目占位符、分组变量声明、固定值、同源关系、未知与循环引用。测试使用真实共享库，并以缺失字段、非法路径、固定值漂移和错误引用等坏样例验证错误能被拦截。