create-yss-spec 3.3.8 → 3.4.1

package/template/docs/design/design.md

@@ -18,7 +18,6 @@
 | 来源 | 作用 | 采用结论 |
 | --- | --- | --- |
 | Ant Design v6 官方主题与迁移文档 | semantic token、CSS variables、theme algorithm 组合与 DOM 兼容边界 | **上游机制权威**；项目覆盖不得改变其算法语义 |
-| `docs/design/facts/antdv-next/1.5.2/manifest.json` | Antdv Next 精确版本的 Design.md、组件 API 与示例事实 | **默认 H2 Provider 事实源**；仅在版本和 digest 新鲜时使用 |
 | 历史 `Product-Design-System` 包 | 首次引入 Ant Design 企业级语义、状态矩阵和验收习惯 | 仅保留原则、组件规则和审查清单 |
 | 项目 Ant Design 5 Less / `:root` 变量 | 品牌主色、运行时切换别名、色板与布局 token 的历史项目覆盖 | 保留经批准的品牌覆盖；不作为 v6 / Antdv Next API 事实 |
 | `yss-meta` 的 `packages/src/styles` | 已落地的紧凑间距、Card 圆角、CSS 变量桥接和客户主题案例 | 只提取稳定语义；utility class、客户覆盖和兼容补丁不进入默认规范 |
@@ -42,15 +41,11 @@
 
 Codex `$design-qa` 的 Colors/tokens 与 Fonts/typography 对照必须以根 `DESIGN.md` 为 source visual truth，并用 `docs/design/tokens/*` 复核实际投影；不得回退到上游默认或历史品牌值。执行清单见 `.agents/skills/yss-design-system/references/design-qa-theme.md`。
 
-版本边界按原型档位处理：H1 直接消费项目 Token；H2 默认通过 `yss-antdv-next-design` 消费 Vue/Antdv Next 精确版本 fact pack；显式 `react-antd-6` 兼容路线才通过 `yss-antd-design` 消费 Ant Design v6 事实。两条原型路线都不替换生产实现路线。原型阶段不得调用 `yss-ui`；生产实现进入批准切片后才从目标实现仓 lockfile 中读取 Vue 3、YSS UI 与 Ant Design Vue 的真实 API。原型到生产只迁移视觉角色、项目 Token、状态和验收行为，禁止在 React/Vue 间搬运 hook、props、JSX、静态 API 或事件模型。
+原型 H1/H2 统一使用 `html-css-js`，以本地 Token CSS 保留 YSS 企业后台视觉语言。生产实现只在目标工程按 lockfile 核验组件 API；原型阶段不调用 `yss-ui`。已冻结的组件库原型和 fact pack 保留历史只读，不再生成新的 Provider 事实包。
 
-### Ant Design v6 / Antdv Next 视觉映射
+### HTML 与生产主题的映射
 
-- Ant Design v6 是以 CSS variables、现代浏览器与内部实现更新为主的技术升级，不应被误解为一套脱离 semantic token 的新皮肤。
-- `defaultAlgorithm`、`darkAlgorithm`、`compactAlgorithm` 可以组合。项目的默认工作界面采用 compact；暗色紧凑模式按 `[darkAlgorithm, compactAlgorithm]` 的等价顺序组合，不手工反色。
-- 基础 seed 从 `docs/design/tokens/theme.json` 读取，compact 结果从 `tokens.compact.json` 读取。禁止把计算结果反写为 seed 后再叠加 compact，避免重复压缩。
-- v6 内部 DOM 和生成类名不是稳定合同；原型和实现只依赖公开组件 API、semantic token、组件 token 与项目 CSS variables。
-- React Ant Design 与 Vue Antdv Next 可共享视觉角色和验收口径，但组件 props、事件、插槽、静态 API 与上下文机制必须分别从精确版本事实读取。
+HTML 直接使用 DESIGN.md 当前默认尺寸与主题 CSS，不要求 ConfigProvider 或组件库算法。生产库若使用 `defaultAlgorithm`、`darkAlgorithm`、`compactAlgorithm`，仍按其版本合同执行，避免把 compact 结果当 seed 再压缩。暗色能力只在派生 Token 和浏览器状态均核验后声明。
 
 ## 设计原则
 
@@ -133,9 +128,9 @@ Codex `$design-qa` 的 Colors/tokens 与 Fonts/typography 对照必须以根 `DE
 - 表单、筛选区、工具栏、表格和详情页应优先使用密集但有节奏的布局。
 - 不使用任意 magic number；如确需新增尺寸，应先判断是否要扩展 token。
 
-### 紧凑密度（默认原型规格）
+### 默认密度与可选紧凑密度
 
-原型交付物和中后台数据密集页面默认使用紧凑密度。紧凑密度不是把所有间距机械缩小，而是使用 `docs/design/tokens/tokens.compact.json` 和下表控制页面节奏；没有明确的展示型或触屏场景时，不切回宽松密度。
+原型和前端工程默认采用 Data Quality 全局主题：浅色、14px 正文、32px 控件、20px Card 内距，不默认开启 compact。下表仅用于明确选择紧凑模式的页面；紧凑模式消费 `tokens.compact.json`，不得再次压缩。
 
 | 场景 | Padding | Margin / Gap | 说明 |
 | --- | --- | --- | --- |
@@ -154,7 +149,7 @@ Margin 使用规则：组件自身默认不声明外部 margin，兄弟元素之
 
 | 角色 | 值来源 | 用途 |
 | --- | --- | --- |
-| 顶栏 / 侧栏 / 页面背景 | `docs/design/tokens/theme.json` 的 `layout*` | 应用壳布局 |
+| 顶栏 / 侧栏 / 页面背景 | `DESIGN.md` 的 `colors.surface` / `colors.canvas-layout` | 应用壳布局 |
 | Provider 断点 | 目标组件库精确版本的公开 Grid Token | 栅格和布局折叠 |
 | 截图视口 | 本文件“响应式与多端验收”矩阵 | 浏览器验收，不反写为组件 Token |
 
@@ -169,7 +164,7 @@ Margin 使用规则：组件自身默认不声明外部 margin，兄弟元素之
 | `borderRadius` | 6 | 默认控件圆角 |
 | `borderRadiusLG` | 8 | Card、大容器 / 浮层 |
 
-保持“控件圆角小于或等于容器圆角”：控件使用 `rounded.sm/md`，Card 与普通容器使用 `rounded.lg`。更大的 panel 圆角属于局部产品扩展，不作为紧凑型默认值；确需使用时必须先登记规范角色，不能让同一页面任意混用。实现时以根 `DESIGN.md` 与 `docs/design/tokens/tokens.compact.json` 为基线。
+保持“控件圆角小于或等于容器圆角”：控件使用 `rounded.sm/md`，Card 与普通容器使用 `rounded.lg`。更大的 panel 圆角属于局部产品扩展，不作为紧凑型默认值；确需使用时必须先登记规范角色，不能让同一页面任意混用。实现时以根 `DESIGN.md` 与 `docs/design/tokens/tokens.default.json` 为默认基线。
 
 ### 动效
 
@@ -223,17 +218,17 @@ Margin 使用规则：组件自身默认不声明外部 margin，兄弟元素之
 | 档位 | 用途 | 技术边界 | 最低验证 |
 |---|---|---|---|
 | H1 `visual-review` | 布局、密度、层级、文案和少量关键交互 | 语义 HTML/CSS/最小 JS 或设计工具导出；无需 Node、package、lockfile 或 AntD CLI | desktop/narrow 非空渲染、项目 Token、console、关键交互、基础键盘/焦点/对比度；zoom/reduced-motion 按影响 |
-| H2 `flow-review` | 主流程、权限、失败恢复、复杂联动和冲突 | 浏览器可运行流程；React/Vite + AntD v6 是受支持默认而非强制 | H1 共同证据 + 主流程、关键异常、zoom/reduced-motion；视觉回归按风险 |
+| H2 `flow-review` | 主流程、权限、失败恢复、复杂联动和冲突 | 浏览器可运行流程；默认 HTML/CSS/JavaScript 离线资源包，场景可重复触发和重置 | H1 共同证据 + 主流程、关键异常、zoom/reduced-motion；视觉回归按风险 |
 
 - H1 不得为了“显得完整”创建空 `package.json`、lockfile 或 AntD 证据。H2 不得声明真实目标组件已验证。
 - 原型中识别出的生产组件假设与待验行为写入 `implementation_handoff`，由 `frontend_implementation_plan` 和 `frontend_implementation_verification` 承接；不得在原型阶段引入 `yss-ui`、目标 lockfile 或 Storybook。
 - 新视觉方向、信息架构不确定或有多个合理方案时执行三方案 ideation；复用已批准视觉模式时记录 source visual 与 `not-applicable` 理由。
-- 默认启用紧凑密度；页面 padding、gap、Card 圆角、Card padding 和控件高度必须在浏览器计算样式中可复核。
+- 默认使用 Data Quality 的32px控件与20px Card内距，紧凑模式显式选择；页面 padding、gap、Card 圆角、Card padding 和控件高度必须在浏览器计算样式中可复核。
 - Design QA、浏览器验证和视觉目标使用同一视口与同一状态；默认 desktop `1440×900`、narrow `390×844`。
 - Design QA 统一覆盖 visual、layout、interaction、content、accessibility、cross-platform 六轴，不再复制第二份检查清单。
-- AntD fact pack 仅在精确版本、组件集合、项目 Token baseline digest 相同且没有新 API 疑问时复用；否则做增量查询。`lint/doctor` 只在存在相关 React 源时执行。
+- 交付包包含所有实际使用的本地资源和 Token 副本，登记摘要；复制到独立目录后以 `file://` 无网络复验。模板结构检查不替代浏览器证据。
 - 原型源码默认 throwaway；项目 Token、组件语义映射、状态、测试场景和验收标准可以进入下游，源码复用仍需 实现合同编译器、Slice Contract 与 TDD。
-- 用户确认只覆盖原型确认的决定、可操作范围、模拟/gap 与接受结论；HTML、story 或截图存在都不代表三个产品设计门禁已经通过。
+- 用户确认只覆盖原型确认的决定、可操作范围、模拟/gap 与接受结论；HTML、story 或截图存在都不代表产品设计聚合门禁已经通过。
 
 ### 无障碍覆盖
 
@@ -271,17 +266,17 @@ Margin 使用规则：组件自身默认不声明外部 margin，兄弟元素之
 如果前端使用 React + Ant Design：
 
 - 使用 `ConfigProvider` 注入 `docs/design/tokens/theme.json` 中的 theme 配置。
-- 默认工作界面使用 `compactAlgorithm`；暗色工作界面组合 `darkAlgorithm` 与 `compactAlgorithm`。seed 与计算结果分别从 `theme.json`、`tokens.compact.json` 读取。
+- 默认采用 Data Quality 浅色与 32px 控件；仅显式紧凑模式使用 `compactAlgorithm`；暗色工作界面组合 `darkAlgorithm` 与 `compactAlgorithm`。seed 与计算结果分别从 `theme.json`、`tokens.compact.json` 读取。
 - 组件样式优先通过 Ant Design token、component token、CSS variables 或主题算法表达。
 - 消息、通知、Modal 静态方法应使用 `App`、hook API 或 context holder，避免主题上下文丢失。
 - 暗色模式使用 `darkAlgorithm` 或 `docs/design/tokens/variables.dark.css`，不要手工反转颜色。本轮只同步了暗色的字体栈和圆角 seed；完整暗色色板仍是历史算法结果，启用暗色前应再派生一次。
-- 紧凑模式默认使用 `compactAlgorithm` 或 `docs/design/tokens/tokens.compact.json`，不要逐组件压缩高度；原型交付物必须按紧凑 token 验收实际 padding、gap、Card 圆角和控件高度。
+- 紧凑模式默认使用 `compactAlgorithm` 或 `docs/design/tokens/tokens.compact.json`，不要逐组件压缩高度；选择紧凑模式的原型交付物按紧凑 token 验收实际 padding、gap、Card 圆角和控件高度。
 
-H2 默认使用 Vue + Antdv Next：
+H1/H2 原型使用 HTML/CSS/JavaScript：
 
-- 先由 `yss-antdv-next-design` 校验精确版本、组件集合和项目 baseline digest，再消费 fact pack；不得把在线最新版示例直接当成本地版本合同。
-- 视觉层沿用本文件的 semantic token、紧凑密度和状态规则；Vue props、events、slots、ConfigProvider 主题结构从 Antdv Next fact pack 读取。
-- `yss-antd-design` 只保留为显式 React/AntD 兼容路线；两者都不替代生产 `yss-ui` 路线。
+- 使用根 `DESIGN.md` 派生的本地 Token CSS，保留来源摘要。
+- 规范直出按 Token、状态矩阵和页面模式验收；已有批准视觉稿时按相同视口与状态比对。首版截图通过审查与用户确认后冻结，不能自我比较作为质量证明。
+- 提供场景入口和重置，覆盖关键异常恢复、代表性业务内容、长文本与窄屏。复杂控件的生产能力假设进入既有 handoff。
 
 如果前端不是 Ant Design：
 
@@ -305,18 +300,15 @@ H2 默认使用 Vue + Antdv Next：
 
 ## 后续落地 TODO
 
-- 将 `docs/design/tokens/theme.json` 作为 compact 默认主题接入原型主题配置。
+- 将 `docs/design/tokens/theme.json` 作为 Data Quality 默认主题接入原型主题配置。
 - 将 `docs/design/tokens/variables.css` 中的 `--brand-*` 与运行时别名纳入项目 token 管理。
 - 如果项目启用暗色模式，用 `darkAlgorithm` 按新 seed 重派生 `docs/design/tokens/tokens.dark.json`，并补充截图验收。
 - 让 H1/H2 原型适配器默认接入项目 Token，并在浏览器证据中记录实际计算后的 padding、gap、Card 圆角和控件高度。
 
-## Ant Design v6 原型补充基线
+## HTML 原型补充基线
 
-本节根据官方 `https://ant.design/design.md` 与目标版本的 `antd design.md --format json` 提炼，仅用于采用 React AntD 的 H2 和语义映射，不替代项目 token，也不提供 Ant Design Vue API。
+参见 `.agents/skills/yss-prototype-stage/references/html-prototype-practices.md`。复用现有六轴 QA 与 Visual Baseline，新增能力只补充其执行方式，不另建交接文档。原生语义优先，弹窗与自定义控件的 ARIA 属性必须对应真实键盘/焦点行为。样式采用项目 Token，关键反馈保留可读文本，场景重置后再采集浏览器证据。
 
-- 先按 `bg-layout`、`bg-container`、`bg-elevated`、文本、边框、状态、圆角和阴影等 semantic token 角色设计，再映射到 `ConfigProvider`、组件 token 或 CSS variables；不得用页面局部色值替代主题层。
-- 默认亮色工作界面使用 `compactAlgorithm`；需要宽松展示态时才使用 `defaultAlgorithm`。暗色紧凑模式组合 `darkAlgorithm` 与 `compactAlgorithm`，禁止手工反色或逐控件压缩。
-- seed `controlHeight` 与 compact 计算值分别读取 `theme.json` 和 `tokens.compact.json`；不得同时下调 seed 和叠加 compact algorithm。
-- Alert、状态标签和选中态使用浅色语义面、边框与可读文本共同表达，避免把成功、警告、错误色铺成高饱和整块背景。
-- 每个决策区域只保留一个 single primary action。保存、提交、审批、发布、导出和重试等动作必须提供 interaction feedback；不可逆或高风险动作使用确认弹窗。
-- 对实际字号、图标和背景复核 accessibility contrast。默认 token 不足时，通过种子 token 或组件 token 调整，不引入单页特例色。
+## AntD 条件预构建
+
+高保真默认原生 HTML；简化模拟影响关键评审结论时，按原型技能的 `references/antd-integration.md` 条件使用 `react-antd-prebuilt`。交付格式与视觉权威不变；React 仅作为随包浏览器运行时，作者依赖与构建工具不交付给接收者。

package/template/docs/design/preview-dark.html

@@ -14,9 +14,9 @@
         <div class="eyebrow">YSS DESIGN SYSTEM</div>
         <div class="title-line">
           <h1>组件与状态预览</h1>
-          <span class="density-chip">暗色紧凑 · 28px</span>
+          <span class="density-chip">暗色 · 32px</span>
         </div>
-        <p class="page-description">darkAlgorithm + compactAlgorithm · YSS 项目主题覆盖</p>
+        <p class="page-description">darkAlgorithm · YSS 项目主题覆盖</p>
       </div>
       <div class="heading-actions">
         <nav class="mode-switch" aria-label="主题预览">
@@ -59,7 +59,7 @@
           </div>
         </form>
         <div class="notice notice-info filter-feedback" role="status">
-          <span>暗色与紧凑算法组合使用，仍保留 14px 正文、28px 控件和清晰的状态层级。</span>
+          <span>显式暗色模式，仍保留 14px 正文、32px 控件和清晰的状态层级。</span>
         </div>
       </div>
     </section>

package/template/docs/design/preview.css

@@ -2,7 +2,7 @@
 
 :root {
   color-scheme: light;
-  --preview-control-height: 28px;
+  --preview-control-height: 32px;
   --preview-primary-control: #245bdb;
   --preview-primary-control-hover: #2f68eb;
   --preview-panel-padding: 16px;

package/template/docs/design/preview.html

@@ -14,7 +14,7 @@
         <div class="eyebrow">YSS DESIGN SYSTEM</div>
         <div class="title-line">
           <h1>组件与状态预览</h1>
-          <span class="density-chip">紧凑模式 · 28px</span>
+          <span class="density-chip">默认模式 · 32px</span>
         </div>
         <p class="page-description">Ant Design v6 语义 Token · YSS 项目主题覆盖</p>
       </div>
@@ -59,7 +59,7 @@
           </div>
         </form>
         <div class="notice notice-info filter-feedback" role="status">
-          <span>紧凑模式保留 14px 正文，以 28px 控件、8px 控件间距和 12px 区域节奏提升扫描效率。</span>
+          <span>默认模式保留 14px 正文，以 32px 控件、8px 控件间距和 12px 区域节奏提升扫描效率。</span>
         </div>
       </div>
     </section>

package/template/docs/design/templates/interaction-spec-template.md

@@ -10,9 +10,9 @@
 | 产品总体设计 / 功能架构 | `docs/.scratch/<feature>/design/<feature>-product-overview-design.md` | 必需；缺失时先返回产品总体设计阶段 |
 | 领域术语 | `CONTEXT.md` | 核心名词、状态和业务规则 |
 | Plan | `docs/.scratch/<feature>/plan/<feature>-discovery.md` | 可选 |
-| 原型阶段合同 / Product Design 路由 | `yss-prototype-stage -> product-design:index -> <focused skill>` | 必需；记录 `$get-context`、`$ideate`、`$prototype`、`$image-to-code` 或 `$url-to-code` |
+| 原型阶段合同 / 视觉来源 | `yss-prototype-stage`；`source_visual.kind=design-system` 或 `visual-reference` | 默认 DESIGN.md 规范直出；独立视觉稿才条件使用 Product Design focused skill |
 | 原型 / 线框图 | `<链接或导出图片路径>` | Excalidraw / Figma / Penpot / tldraw / Axure / Markdown |
-| 原型交付物 | `docs/.scratch/<feature>/design/prototypes/index.html` 或稳定 URL | 低保真评审后按 H1/H2 档位补齐；H2 AntD 条件取事实；真实组件待验事项交接到前端实现计划，产出后必须获得用户确认 |
+| H1/H2 原型交付物 | `docs/.scratch/<feature>/design/prototypes/index.html` 与本地资源 | 低保真评审后按档位补齐；默认原生 HTML，复杂控件影响评审结论时选择 AntD 预构建；产出后须用户确认 |
 | 原型验证清单 | `docs/.scratch/<feature>/verification/prototype-evidence.yaml` | 记录 schema v4 档位、浏览器、统一 Design QA、Visual Baseline case、条件组件证据和阻塞项 |
 | 现有 API 草案 | `docs/.scratch/<feature>/api/<feature>.yaml` | 可选；通常应先完成产品设计和 Spec 校准 |
 

package/template/docs/design/templates/prototype-evidence-template.yaml

@@ -26,16 +26,19 @@ upstream_refs:
   state_matrix_ref: docs/.scratch/<feature>/design/<feature>-state-matrix.md
   prototype_review_ref: docs/.scratch/<feature>/design/<feature>-prototype-review.md
 source_visual:
-  ideation_status: required
-  selected_ref: <selected-source-visual-ref>
-  reuse_reason: not-applicable
+  kind: design-system # 有独立视觉稿时用 visual-reference
+  ideation_status: not-applicable
+  selected_ref: DESIGN.md
+  reuse_reason: <说明规范及已有页面模式足以支持设计的依据>
 design_baseline:
   canonical_design_ref: DESIGN.md
   canonical_design_digest: <sha256>
   project_design_ref: docs/design/design.md
   project_token_refs:
+    # 默认 Data Quality 浅色；显式暗色 / 紧凑模式改为实际消费的对应快照，并同步摘要和视觉基线 cases[].theme。
     - docs/design/tokens/theme.json
-    - docs/design/tokens/tokens.compact.json
+    - docs/design/tokens/tokens.default.json
+    - docs/design/tokens/variables.css
   project_token_baseline_digest: <sha256>
   project_override_reviewed: false
 visual_baseline:
@@ -46,6 +49,10 @@ visual_baseline:
   status: approved
   case_ids: [primary-desktop, primary-narrow]
 browser_delivery:
+  delivery_contract: offline-html-v1
+  resource_manifest_ref: docs/.scratch/<feature>/design/prototypes/yss-prototype-adapter.json
+  offline_verification_ref: <file-url-offline-browser-evidence>
+  offline_verification_result: pending
   delivery_kind: static-directory
   entry_ref: docs/.scratch/<feature>/design/prototypes/index.html
   rendered_nonblank: false
@@ -62,6 +69,7 @@ browser_delivery:
   console_result: pending
   console_ref: <path-to-console-output-or-none>
 design_qa:
+  mode: design-contract # visual-reference 对应 visual-comparison
   report_ref: docs/.scratch/<feature>/verification/design-qa.md
   result: pending
   axes:
@@ -83,13 +91,10 @@ profile_evidence:
   #   reduced_motion: {applicable: false, result: not-applicable, evidence_ref: not-applicable}
   flow_review:
     implementation:
-      framework: vue
-      runtime_build_required: true
-      package_manager: pnpm
-      package_manifest_ref: docs/.scratch/<feature>/design/prototypes/package.json
-      lockfile_ref: docs/.scratch/<feature>/design/prototypes/pnpm-lock.yaml
-      build_command: pnpm build
-      build_result: pending
+      framework: html-css-js
+      runtime_build_required: false
+    scenario_replay_ref: <case-id-and-data-scenario-action-evidence>
+    scenario_reset_result: pending
     main_flow_result: pending
     exceptional_state_result: pending
     exceptional_state_ref: <failure-permission-or-conflict-ref>
@@ -103,17 +108,8 @@ profile_evidence:
       result: pending
       evidence_ref: <snapshot-result-ref>
     prototype_library_facts:
-      applicable: true
-      component_basis: vue-antdv-next
-      source: fact-pack
-      library_package: antdv-next
-      library_version: 1.5.2
-      manifest_ref: docs/design/facts/antdv-next/1.5.2/manifest.json
-      manifest_digest: <sha256>
-      components_covered: [<Component>]
-      canonical_design_digest: <same-as-design-baseline>
-      project_token_baseline_digest: <same-as-design-baseline>
-      new_api_uncertainty: false
+      applicable: false
+      component_basis: html-css-js
 implementation_handoff:
   prototype_code_reusable: false
   production_component_assumptions:

package/template/docs/design/templates/prototype-review-checklist.md

@@ -10,7 +10,8 @@
 | 交互说明 | `docs/.scratch/<feature>/design/<feature>-interaction-spec.md` |  |
 | 原型 / 线框图 | `<链接或导出图片路径>` |  |
 | 状态矩阵 | `docs/.scratch/<feature>/design/<feature>-state-matrix.md` |  |
-| 原型阶段合同 / Product Design 路由记录 | `yss-prototype-stage -> product-design:index -> <focused skill>` |  |
+| 视觉规范与主题快照 | 根 `DESIGN.md`、`docs/design/design.md`、实际消费的 Token 快照 | 默认 Data Quality 浅色；显式暗色 / 紧凑模式注明选择依据 |
+| 原型阶段合同 / Product Design 路由记录 | `yss-prototype-stage`；规范直出或条件独立视觉稿路线 |  |
 | 原型验证清单 | `docs/.scratch/<feature>/verification/prototype-evidence.yaml` | 档位确定后补齐 schema v4 共同与档位证据，并引用 Visual Baseline Bundle v1 |
 | 现有 API 草案 | `docs/.scratch/<feature>/api/<feature>.yaml` | 可选 |
 
@@ -28,6 +29,7 @@
 | 能从界面需求反推出 API 影响和契约草案 |  |  |
 | 已列出原型需要回答的决定、风险触发及 H1/H2 推荐档位；无充分证据时回退 H2 |  |  |
 | 状态矩阵中的每个状态均有事件、转换、guard、动作和退出路径 |  |  |
+| 高保真证据的 `design_baseline` 绑定当前规范与 Token 摘要，视觉基线的 `cases[].theme` 与实际截图一致 |  |  |
 | 前端验收、组件状态和数据依赖已明确 |  |  |
 | 风险 / 回滚约束和人工确认项已记录 |  |  |
 

package/template/docs/design/templates/state-matrix-template.md

@@ -1,6 +1,6 @@
 # <功能名称> 状态矩阵模板
 
-> 适用时机：配合 `product-design:index` 路由后的 Product Design focused skill 使用，在 Spec 校准和 API 影响分析 / 契约草案之前补齐页面状态。
+> 适用时机：由 `yss-prototype-stage` 统一消费；规范直出与条件独立视觉稿使用同一状态矩阵，在 Spec 校准和 API 影响分析 / 契约草案之前补齐页面状态。
 
 状态矩阵同时承担轻量状态机合同：每个可进入状态都必须有触发事件、允许转换、guard、动作与退出路径。不要另建第二份 state-machine 资产。
 

package/template/docs/design/templates/visual-baseline-template.yaml

@@ -33,13 +33,14 @@ capture_environment:
   capture_script_digest: <sha256>
   capture_result_ref: capture/result.json
   capture_result_digest: <sha256>
+# 默认 Data Quality 浅色；显式选择暗色 / 紧凑模式时按实际渲染修改 theme，并与原型证据中的 Token 快照保持一致。
 cases:
   - case_id: primary-desktop
     route: /<route>
     page: <PageName>
     state: normal
     viewport: {name: desktop, width: 1440, height: 900, scroll_mode: viewport, scroll_position: 0}
-    theme: compact-light
+    theme: default-light
     locale: zh-CN
     data_scenario: primary
     image_ref: images/primary-desktop.png
@@ -56,7 +57,7 @@ cases:
     page: <PageName>
     state: normal
     viewport: {name: narrow, width: 390, height: 844, scroll_mode: viewport, scroll_position: 0}
-    theme: compact-light
+    theme: default-light
     locale: zh-CN
     data_scenario: primary
     image_ref: images/primary-narrow.png

package/template/docs/design/tokens/.design-md-projection.json

@@ -1,13 +1,13 @@
 {
   "schema_version": 1,
   "source": "DESIGN.md",
-  "source_sha256": "59a9f90f7dd62d5e1d4c398e7b8ab8fae595622d0d5fea7bc0d43fe63802f5d5",
+  "source_sha256": "e84a6c175840efe9663a2d0aba37f5635c053f47452bb146d1025d65665b1bec",
   "files": {
-    "docs/design/tokens/theme.json": "aab648fa655c9d6f6d3932081a035543fd6481902c873dd218b50f9e550bedac",
-    "docs/design/tokens/tokens.default.json": "bf89486a8730a68673473fa7d5afe40b158e833b10df7da75d505bc53f8f6167",
-    "docs/design/tokens/tokens.dark.json": "79b93203f305d26f2f230a8af1f4b7e77c9bdb7997efa0746eed1508c928f85b",
-    "docs/design/tokens/tokens.compact.json": "afa4ae457a3db81d4b8a4b103ed9d6baa897daa1bbc23c96ee7d9182d2b4b992",
-    "docs/design/tokens/variables.css": "157dd6300e34be53f93196357c97125b77e00f980011db920d2964d46b12600d",
-    "docs/design/tokens/variables.dark.css": "b8ebb18f304831ee5c86cf6e5563702b2cc0ce2f51b055036e437a385226cd99"
+    "docs/design/tokens/theme.json": "740f80c2c55763564ac5e1cf4159e0d5f0965548d53e0eb0de0ff380e74f0a93",
+    "docs/design/tokens/tokens.default.json": "4e6446ee85195e3a75676a763cb8be2c625dc86b2b0676cbc8b45b2221135a71",
+    "docs/design/tokens/tokens.dark.json": "826391c5dafaef4d924003052bcfa9b38943e589120b0ff740214a12c9981ae1",
+    "docs/design/tokens/tokens.compact.json": "1a943c1354487addc67e399ededc122337d278a9ff61cb12d36a2f8202e26d9c",
+    "docs/design/tokens/variables.css": "028c24f9e935f5c4b1392d131a4cd13482e6572a2ced4360ffa833aa3fbeaf66",
+    "docs/design/tokens/variables.dark.css": "38132db701cd1e9793b6320baba20645a2cf577edc75b25aadb211f65bf05767"
   }
 }

package/template/docs/design/tokens/theme.json

@@ -12,20 +12,26 @@
     "colorTextSecondary": "rgba(0, 0, 0, 0.65)",
     "colorBorder": "#d9d9d9",
     "fontFamily": "-apple-system, BlinkMacSystemFont, \"Segoe UI\", Roboto, \"Helvetica Neue\", Arial, \"Noto Sans\", sans-serif",
-    "fontFamilyCode": "\"SFMono-Regular\", Consolas, \"Liberation Mono\", Menlo, Courier, monospace",
     "fontSize": 14,
     "borderRadius": 6,
     "sizeUnit": 4,
     "sizeStep": 4,
     "controlHeight": 32,
-    "lineWidth": 1,
-    "motionUnit": 0.1,
-    "motionBase": 0,
-    "wireframe": false,
-    "motion": true,
-    "layoutHeaderHeight": 64,
-    "layoutSiderBackground": "#001529",
-    "layoutBodyBackground": "#f0f2f5"
+    "controlHeightSM": 24,
+    "controlHeightLG": 40,
+    "fontSizeSM": 12,
+    "borderRadiusSM": 4,
+    "borderRadiusLG": 8,
+    "padding": 16,
+    "paddingSM": 12,
+    "paddingXS": 8,
+    "paddingLG": 20
   },
-  "algorithm": "compact"
+  "algorithm": "default",
+  "components": {
+    "Card": {
+      "borderRadiusLG": 8,
+      "paddingLG": 20
+    }
+  }
 }