npm - create-yss-spec - Versions diffs - 3.0.1 → 3.1.3 - Mend

create-yss-spec 3.0.1 → 3.1.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (1348) hide show

package/template/docs/design/preview.html CHANGED Viewed

@@ -3,18 +3,176 @@
 <head>
   <meta charset="utf-8">
   <meta name="viewport" content="width=device-width, initial-scale=1">
-  <title>YSS Design System Preview</title>
-  <style>
-    :root { --primary:#3371ff; --primary-active:#245bdb; --text:rgba(0,0,0,.88); --secondary:rgba(0,0,0,.65); --layout:#f0f2f5; --surface:#fff; --subtle:#fafafa; --border:#d9d9d9; --selected:#e6f4ff; --success:#52c41a; --warning:#faad14; --error:#f5222d; font-family:-apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,"Helvetica Neue",Arial,sans-serif; }
-    * { box-sizing:border-box } body { margin:0; color:var(--text); background:var(--layout); font-size:14px; } .shell { max-width:1440px; margin:auto; padding:16px; } .toolbar { display:flex; gap:8px; flex-wrap:wrap; align-items:center; margin-bottom:12px; } h1,h2 { margin:0 0 12px; } h1 { font-size:24px; } h2 { font-size:18px; } .card { background:var(--surface); border:1px solid var(--border); border-radius:8px; padding:16px; margin-bottom:12px; } button,input,select { height:32px; border-radius:6px; border:1px solid var(--border); padding:0 12px; font:inherit; background:var(--surface); } button.primary { border-color:var(--primary); background:var(--primary); color:#000; font-weight:600; } button.primary:hover,button.primary:focus-visible { background:var(--primary-active); color:#fff; } button:disabled { background:#f0f0f0; color:rgba(0,0,0,.45); } input:focus-visible,select:focus-visible,button:focus-visible { outline:2px solid var(--primary); outline-offset:2px; } table { width:100%; border-collapse:collapse; } th,td { padding:8px 12px; border-bottom:1px solid var(--border); text-align:left; } th { background:var(--subtle); font-weight:600; } tr.selected { background:var(--selected); } .grid { display:grid; grid-template-columns:repeat(3,minmax(0,1fr)); gap:12px; } .status { padding:8px 12px; border-radius:4px; margin:8px 0; } .success { background:var(--success); color:#000; } .warning { background:var(--warning); color:#000; } .error { background:var(--error); color:#000; } .muted { color:var(--secondary); } @media (max-width:768px) { .shell { padding:12px; } .grid { grid-template-columns:1fr; } .toolbar > * { flex:1 1 140px; } table { min-width:620px; } .table-wrap { overflow-x:auto; } }
-  </style>
+  <meta name="theme-color" content="#f0f2f5">
+  <title>YSS Design System · Compact Preview</title>
+  <link rel="stylesheet" href="./preview.css">
 </head>
 <body>
-  <main class="shell">
-    <div class="toolbar"><h1>YSS 设计系统预览</h1><span class="muted">默认 / 紧凑密度</span><button class="primary" onclick="this.textContent='已保存'; this.disabled=true">保存</button><button disabled>禁用</button></div>
-    <section class="card"><h2>筛选与表单</h2><div class="toolbar"><input aria-label="关键词" placeholder="关键词"><select aria-label="状态"><option>全部状态</option><option>已启用</option></select><button class="primary">查询</button><button>重置</button></div><div class="status warning" role="status">请补充必填筛选条件。</div></section>
-    <section class="card"><h2>数据表格</h2><div class="table-wrap"><table><thead><tr><th>名称</th><th>状态</th><th>更新时间</th><th>操作</th></tr></thead><tbody><tr class="selected"><td>示例任务</td><td><span class="status success">成功</span></td><td>2026-09-02 09:30</td><td><button>查看</button></td></tr><tr><td>加载中的任务</td><td>加载中…</td><td>—</td><td><button disabled>编辑</button></td></tr><tr><td>失败任务</td><td><span class="status error">失败：权限不足</span></td><td>—</td><td><button>重试</button></td></tr></tbody></table></div></section>
-    <div class="grid"><section class="card"><h2>空状态</h2><p class="muted">暂无数据，请调整筛选条件。</p><button class="primary">创建记录</button></section><section class="card"><h2>弹层触发</h2><button onclick="alert('Modal / Drawer 应提供可见反馈和焦点管理')">打开 Modal</button></section><section class="card"><h2>无障碍</h2><p class="muted">使用 Tab 检查焦点顺序；缩放到 200% 检查布局。</p></section></div>
+  <main class="app-shell">
+    <header class="page-heading">
+      <div class="page-title-group">
+        <div class="eyebrow">YSS DESIGN SYSTEM</div>
+        <div class="title-line">
+          <h1>组件与状态预览</h1>
+          <span class="density-chip">紧凑模式 · 28px</span>
+        </div>
+        <p class="page-description">Ant Design v6 语义 Token · YSS 项目主题覆盖</p>
+      </div>
+      <div class="heading-actions">
+        <nav class="mode-switch" aria-label="主题预览">
+          <a href="./preview.html" aria-current="page">明亮</a>
+          <a href="./preview-dark.html">暗色</a>
+        </nav>
+        <button class="button button-primary" type="button" data-primary-action>保存规范</button>
+        <button class="button" type="button" disabled title="当前没有待提交的变更">提交</button>
+      </div>
+    </header>
+    <section class="panel" aria-labelledby="filter-title">
+      <div class="panel-heading">
+        <div>
+          <div class="panel-title-row">
+            <h2 id="filter-title">任务筛选</h2>
+            <span class="panel-description">保持单行扫描，空间不足时按字段组换行</span>
+          </div>
+        </div>
+        <span class="count-chip" data-count>3 条记录</span>
+      </div>
+      <div class="panel-body">
+        <form class="toolbar" data-filter-form>
+          <div class="field field-keyword">
+            <label for="keyword">任务名称</label>
+            <input id="keyword" class="control" type="search" placeholder="输入名称或编号" data-keyword>
+          </div>
+          <div class="field field-status">
+            <label for="status">运行状态</label>
+            <select id="status" class="control" data-status>
+              <option value="all">全部状态</option>
+              <option value="success">已完成</option>
+              <option value="processing">处理中</option>
+              <option value="error">失败</option>
+            </select>
+          </div>
+          <div class="toolbar-actions">
+            <button class="button button-text" type="button" data-reset>重置</button>
+            <button class="button button-primary" type="submit">查询</button>
+          </div>
+        </form>
+        <div class="notice notice-info filter-feedback" role="status">
+          <span>紧凑模式保留 14px 正文，以 28px 控件、8px 控件间距和 12px 区域节奏提升扫描效率。</span>
+        </div>
+      </div>
+    </section>
+    <section class="panel" aria-labelledby="table-title">
+      <div class="panel-heading">
+        <div class="panel-title-row">
+          <h2 id="table-title">任务列表</h2>
+          <span class="panel-description">状态使用浅色语义面，不使用高饱和整块填充</span>
+        </div>
+        <div class="table-actions">
+          <button class="button" type="button">导出</button>
+          <button class="button button-primary" type="button" data-dialog-trigger>新建任务</button>
+        </div>
+      </div>
+      <div class="table-wrap">
+        <table>
+          <colgroup>
+            <col style="width:34%">
+            <col style="width:16%">
+            <col style="width:16%">
+            <col style="width:20%">
+            <col style="width:14%">
+          </colgroup>
+          <thead>
+            <tr>
+              <th scope="col">名称</th>
+              <th scope="col">状态</th>
+              <th scope="col">责任人</th>
+              <th scope="col">更新时间</th>
+              <th scope="col">操作</th>
+            </tr>
+          </thead>
+          <tbody>
+            <tr data-record data-status="success" data-search="示例任务 yss-1024" aria-selected="true">
+              <td><span class="cell-main">示例任务</span><span class="cell-sub">YSS-1024 · 设计系统核验</span></td>
+              <td><span class="status-label status-success" data-row-status>已完成</span></td>
+              <td>陈墨</td>
+              <td>2026-09-02 09:30</td>
+              <td><button class="link-action" type="button">查看</button></td>
+            </tr>
+            <tr data-record data-status="processing" data-search="加载中的任务 yss-1025">
+              <td><span class="cell-main">加载中的任务</span><span class="cell-sub">YSS-1025 · Token 同步</span></td>
+              <td><span class="status-label status-processing" data-row-status>处理中</span></td>
+              <td>林晓</td>
+              <td>刚刚</td>
+              <td><button class="link-action" type="button" disabled>编辑</button></td>
+            </tr>
+            <tr data-record data-status="error" data-search="失败任务 yss-1026">
+              <td><span class="cell-main">失败任务</span><span class="cell-sub">YSS-1026 · 权限快照</span></td>
+              <td><span class="status-label status-error" data-row-status>权限不足</span></td>
+              <td>周屿</td>
+              <td>2026-09-02 08:46</td>
+              <td><button class="link-action" type="button" data-retry>重试</button></td>
+            </tr>
+            <tr data-empty-row hidden>
+              <td colspan="5"><span class="muted">没有符合当前筛选条件的任务。</span></td>
+            </tr>
+          </tbody>
+        </table>
+      </div>
+    </section>
+    <div class="support-grid">
+      <section class="panel" aria-labelledby="feedback-title">
+        <div class="panel-heading">
+          <h2 id="feedback-title">语义反馈</h2>
+          <span class="panel-description">颜色、边框与文本共同传达状态</span>
+        </div>
+        <div class="panel-body">
+          <div class="notice notice-success"><span>配置已同步，可进入下一步核验。</span></div>
+          <div class="notice notice-warning"><span>有 2 项变更等待维护者确认。</span></div>
+          <div class="notice notice-error" role="alert"><span>权限快照失败，请检查访问范围后重试。</span></div>
+        </div>
+      </section>
+      <section class="panel" aria-labelledby="empty-title">
+        <div class="panel-heading">
+          <h2 id="empty-title">空状态与无障碍</h2>
+          <span class="panel-description">下一步明确、焦点可见</span>
+        </div>
+        <div class="panel-body">
+          <div class="empty-state">
+            <div>
+              <p class="empty-title">暂无草稿</p>
+              <p class="muted">创建后即可验证 Modal、键盘焦点与操作反馈。</p>
+            </div>
+            <button class="button" type="button" data-dialog-trigger>创建草稿</button>
+          </div>
+          <ul class="check-list" aria-label="无障碍检查项">
+            <li>Tab 顺序符合视觉阅读顺序</li>
+            <li>200% 缩放时只有表格容器横向滚动</li>
+          </ul>
+        </div>
+      </section>
+    </div>
   </main>
+  <dialog class="dialog" data-dialog aria-labelledby="dialog-title">
+    <div class="dialog-header">
+      <h2 id="dialog-title">创建任务草稿</h2>
+      <button class="dialog-close" type="button" aria-label="关闭弹窗" data-dialog-close>关闭</button>
+    </div>
+    <div class="dialog-body">
+      <p>草稿只保存当前页面配置，不会触发正式发布或外部副作用。</p>
+    </div>
+    <div class="dialog-footer">
+      <button class="button" type="button" data-dialog-close>取消</button>
+      <button class="button button-primary" type="button" data-dialog-close>确认创建</button>
+    </div>
+  </dialog>
+  <div class="visually-hidden" aria-live="polite" data-live></div>
+  <script src="./preview.js"></script>
 </body>
 </html>

package/template/docs/design/preview.js ADDED Viewed

@@ -0,0 +1,71 @@
+const root = document.documentElement;
+const filterForm = document.querySelector("[data-filter-form]");
+const keywordInput = document.querySelector("[data-keyword]");
+const statusSelect = document.querySelector("[data-status]");
+const resetButton = document.querySelector("[data-reset]");
+const primaryButton = document.querySelector("[data-primary-action]");
+const count = document.querySelector("[data-count]");
+const emptyRow = document.querySelector("[data-empty-row]");
+const dialog = document.querySelector("[data-dialog]");
+const dialogTriggers = document.querySelectorAll("[data-dialog-trigger]");
+const dialogCloseButtons = document.querySelectorAll("[data-dialog-close]");
+const liveRegion = document.querySelector("[data-live]");
+const dataRows = [...document.querySelectorAll("tbody tr[data-record]")];
+function announce(message) {
+  liveRegion.textContent = message;
+}
+function applyFilters() {
+  const keyword = keywordInput.value.trim().toLowerCase();
+  const status = statusSelect.value;
+  let visible = 0;
+  dataRows.forEach((row) => {
+    const matchesKeyword = !keyword || row.dataset.search.includes(keyword);
+    const matchesStatus = status === "all" || row.dataset.status === status;
+    const matches = matchesKeyword && matchesStatus;
+    row.hidden = !matches;
+    if (matches) visible += 1;
+  });
+  count.textContent = `${visible} 条记录`;
+  emptyRow.hidden = visible !== 0;
+  announce(`筛选完成，共 ${visible} 条记录`);
+}
+filterForm.addEventListener("submit", (event) => {
+  event.preventDefault();
+  applyFilters();
+});
+resetButton.addEventListener("click", () => {
+  keywordInput.value = "";
+  statusSelect.value = "all";
+  applyFilters();
+  keywordInput.focus();
+  announce("筛选条件已重置");
+});
+primaryButton.addEventListener("click", () => {
+  const completedLabel = root.classList.contains("dark") ? "已发布" : "已保存";
+  primaryButton.textContent = completedLabel;
+  primaryButton.disabled = true;
+  announce(`${completedLabel}，操作已完成`);
+});
+dialogTriggers.forEach((button) => button.addEventListener("click", () => dialog.showModal()));
+dialogCloseButtons.forEach((button) => button.addEventListener("click", () => dialog.close()));
+document.querySelectorAll("[data-retry]").forEach((button) => {
+  button.addEventListener("click", () => {
+    const row = button.closest("tr");
+    const status = row.querySelector("[data-row-status]");
+    row.dataset.status = "processing";
+    status.className = "status-label status-processing";
+    status.textContent = "处理中";
+    button.textContent = "查看";
+    button.removeAttribute("data-retry");
+    announce("失败任务已重新提交，当前正在处理中");
+  });
+});

package/template/docs/design/schemas/visual-baseline.schema.json ADDED Viewed

@@ -0,0 +1,66 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://yss.dev/schemas/visual-baseline-v1.json",
+  "title": "YSS Visual Baseline Contract",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_version", "baseline_id", "feature", "version", "status", "bundle", "source", "capture_environment", "cases"],
+  "properties": {
+    "schema_version": {"const": 1},
+    "baseline_id": {"type": "string", "pattern": "^visual-baseline\\.[a-z0-9][a-z0-9-]*$"},
+    "feature": {"type": "string", "pattern": "^[a-z0-9][a-z0-9-]*$"},
+    "version": {"type": "string", "pattern": "^v[1-9][0-9]*$"},
+    "status": {"enum": ["draft", "ready-for-human", "approved", "stale", "blocked"]},
+    "bundle": {
+      "type": "object", "additionalProperties": false,
+      "required": ["format", "root_ref", "digest", "size_bytes", "max_image_bytes", "max_bundle_bytes"],
+      "properties": {
+        "format": {"const": "portable-directory"}, "root_ref": {"type": "string", "minLength": 1},
+        "digest": {"type": "string", "pattern": "^sha256:[a-f0-9]{64}$"}, "size_bytes": {"type": "integer", "minimum": 0, "maximum": 104857600},
+        "max_image_bytes": {"const": 5242880}, "max_bundle_bytes": {"const": 104857600}
+      }
+    },
+    "source": {"$ref": "#/$defs/source"},
+    "capture_environment": {"$ref": "#/$defs/environment"},
+    "cases": {"type": "array", "minItems": 2, "items": {"$ref": "#/$defs/case"}}
+  },
+  "$defs": {
+    "digest": {"type": "string", "pattern": "^sha256:[a-f0-9]{64}$"},
+    "source": {
+      "type": "object", "additionalProperties": false,
+      "required": ["prototype_ref", "prototype_digest", "interaction_spec_ref", "interaction_spec_digest", "state_matrix_ref", "state_matrix_digest"],
+      "properties": {
+        "prototype_ref": {"type": "string", "pattern": "^sources/[^/]+$"}, "prototype_digest": {"$ref": "#/$defs/digest"},
+        "interaction_spec_ref": {"type": "string", "pattern": "^sources/[^/]+$"}, "interaction_spec_digest": {"$ref": "#/$defs/digest"},
+        "state_matrix_ref": {"type": "string", "pattern": "^sources/[^/]+$"}, "state_matrix_digest": {"$ref": "#/$defs/digest"}
+      }
+    },
+    "environment": {
+      "type": "object", "additionalProperties": false,
+      "required": ["browser", "browser_version", "operating_system", "fonts_digest", "device_scale_factor", "color_space", "locale", "timezone", "animations_disabled", "cursor_hidden", "capture_script_ref", "capture_script_digest", "capture_result_ref", "capture_result_digest"],
+      "properties": {
+        "browser": {"const": "chromium"}, "browser_version": {"type": "string", "minLength": 1}, "operating_system": {"type": "string", "minLength": 1},
+        "fonts_digest": {"$ref": "#/$defs/digest"}, "device_scale_factor": {"const": 1}, "color_space": {"const": "srgb"},
+        "locale": {"type": "string", "minLength": 1}, "timezone": {"type": "string", "minLength": 1},
+        "animations_disabled": {"const": true}, "cursor_hidden": {"const": true},
+        "capture_script_ref": {"type": "string", "pattern": "^capture/[^/]+$"}, "capture_script_digest": {"$ref": "#/$defs/digest"},
+        "capture_result_ref": {"type": "string", "pattern": "^capture/[^/]+$"}, "capture_result_digest": {"$ref": "#/$defs/digest"}
+      }
+    },
+    "case": {
+      "type": "object", "additionalProperties": false,
+      "required": ["case_id", "route", "page", "state", "viewport", "theme", "locale", "data_scenario", "image_ref", "image_digest", "image_size_bytes", "mask_ref", "mask_digest", "mask_size_bytes", "semantic_refs", "allowed_differences", "result"],
+      "properties": {
+        "case_id": {"type": "string", "pattern": "^[a-z0-9][a-z0-9-]*$"}, "route": {"type": "string", "minLength": 1}, "page": {"type": "string", "minLength": 1}, "state": {"type": "string", "minLength": 1},
+        "viewport": {"type": "object", "additionalProperties": false, "required": ["name", "width", "height", "scroll_mode", "scroll_position"], "properties": {"name": {"type": "string", "minLength": 1}, "width": {"type": "integer", "minimum": 1}, "height": {"type": "integer", "minimum": 1}, "scroll_mode": {"enum": ["viewport", "segment"]}, "scroll_position": {"type": "integer", "minimum": 0}}},
+        "theme": {"type": "string", "minLength": 1}, "locale": {"type": "string", "minLength": 1}, "data_scenario": {"type": "string", "minLength": 1},
+        "image_ref": {"type": "string", "pattern": "^images/[^/]+\\.png$"}, "image_digest": {"$ref": "#/$defs/digest"}, "image_size_bytes": {"type": "integer", "minimum": 1, "maximum": 5242880},
+        "mask_ref": {"anyOf": [{"const": "not-applicable"}, {"type": "string", "pattern": "^masks/[^/]+\\.png$"}]},
+        "mask_digest": {"anyOf": [{"const": "not-applicable"}, {"$ref": "#/$defs/digest"}]},
+        "mask_size_bytes": {"type": "integer", "minimum": 0, "maximum": 5242880},
+        "semantic_refs": {"type": "array", "minItems": 1, "items": {"type": "string", "pattern": "^sources/[^/]+$"}},
+        "allowed_differences": {"type": "array", "items": {"type": "string", "minLength": 1}}, "result": {"const": "passed"}
+      }
+    }
+  }
+}

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

@@ -13,7 +13,7 @@
 | 原型阶段合同 / Product Design 路由 | `yss-prototype-stage -> product-design:index -> <focused skill>` | 必需；记录 `$get-context`、`$ideate`、`$prototype`、`$image-to-code` 或 `$url-to-code` |
 | 原型 / 线框图 | `<链接或导出图片路径>` | Excalidraw / Figma / Penpot / tldraw / Axure / Markdown |
 | 原型交付物 | `docs/.scratch/<feature>/design/prototypes/index.html` 或稳定 URL | 低保真评审后按 H1/H2 档位补齐；H2 AntD 条件取事实；真实组件待验事项交接到前端实现计划，产出后必须获得用户确认 |
-| 原型验证清单 | `docs/.scratch/<feature>/verification/prototype-evidence.yaml` | 记录 schema v3 档位、浏览器、统一 Design QA、条件组件证据和阻塞项 |
+| 原型验证清单 | `docs/.scratch/<feature>/verification/prototype-evidence.yaml` | 记录 schema v4 档位、浏览器、统一 Design QA、Visual Baseline case、条件组件证据和阻塞项 |
 | 现有 API 草案 | `docs/.scratch/<feature>/api/<feature>.yaml` | 可选；通常应先完成产品设计和 Spec 校准 |
 ## 2. 页面地图

package/template/docs/design/templates/product-overview-design-template.md CHANGED Viewed

@@ -46,19 +46,19 @@ owner: ai
 |--------|-------------|----------|--------|------|--------|
 |  |  |  | P0 / P1 / P2 |  |  |
-## 6. Strategic DDD Check（轻量）
+## 6. 业务边界与协作检查（轻量）
 > 本节嵌入产品总体设计 / 功能架构，不新增独立阶段。只有当上下文数量多、协作关系复杂或边界争议无法在本节说明时，才升级为 `docs/.scratch/<feature>/architecture/<feature>-strategic-design.md`。
-| 限界上下文 | 核心职责 | 统一语言 / 关键术语 | 上游 / 下游 / 协作关系 | 对应功能域 / 页面 / API | 非目标 |
+| 业务责任区 | 核心职责 | 统一业务词汇 / 关键术语 | 规则提供方 / 使用方 / 协作关系 | 对应功能域 / 页面 / API | 非目标 |
 |------------|----------|---------------------|-------------------------|--------------------------|--------|
 |  |  |  |  |  |  |
-战略设计就绪检查：
+业务边界与协作就绪检查：
-- [ ] 统一语言已与 `CONTEXT.md` 对齐，新增术语已列出回填项。
+- [ ] 统一业务词汇已与 `CONTEXT.md` 对齐，新增术语已列出回填项。
 - [ ] 核心域、支撑域、通用域或“不适用”的判断已明确。
-- [ ] 每个 P0 能力都能归属到一个限界上下文或明确为跨上下文协作。
+- [ ] 每个 P0 能力都能归属到一个业务责任区或明确为跨责任区协作。
 - [ ] 上下文协作关系已说明，不把内部模型直接泄露为跨上下文契约。
 - [ ] 本节足以支撑 Spec 校准和 API 影响分析 / 契约草案；否则列为阻断项。
@@ -113,7 +113,7 @@ owner: ai
 - [ ] 用户主流程和异常路径已覆盖 MVP。
 - [ ] 业务对象、状态和关系不会与 `CONTEXT.md` 术语冲突。
 - [ ] 功能域、模块边界和优先级清楚。
-- [ ] Strategic DDD Check 已完成，或明确说明本次变更不影响领域边界。
+- [ ] 业务边界与协作检查已完成，或明确说明本次变更不影响业务责任边界。
 - [ ] 页面、API、数据、权限和审计影响已显式标注。
 - [ ] 低保真原型 / 页面草图已覆盖 P0 页面、主流程和关键异常路径，并能支撑后续交互设计。
 - [ ] Spec 回填项已列出，并分清阻断项和非阻断项。

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

@@ -1,6 +1,6 @@
 # 复制到 docs/.scratch/<feature>/verification/prototype-evidence.yaml。
-# 只保留所选档位的 profile_evidence 子块；schema v1/v2 仅允许只读迁移。
-schema_version: 3
+# 只保留所选档位的 profile_evidence 子块；schema v1/v2/v3 仅允许只读迁移。
+schema_version: 4
 feature: <feature>
 prototype_ref: docs/.scratch/<feature>/design/prototypes/index.html
 prototype_profile: H2
@@ -30,12 +30,21 @@ source_visual:
   selected_ref: <selected-source-visual-ref>
   reuse_reason: not-applicable
 design_baseline:
+  canonical_design_ref: DESIGN.md
+  canonical_design_digest: <sha256>
   project_design_ref: docs/design/design.md
   project_token_refs:
     - docs/design/tokens/theme.json
     - docs/design/tokens/tokens.compact.json
   project_token_baseline_digest: <sha256>
   project_override_reviewed: false
+visual_baseline:
+  manifest_ref: docs/.scratch/<feature>/handoff/visual-baseline-v1/visual-baseline.yaml
+  baseline_id: visual-baseline.<feature>
+  version: v1
+  digest: <sha256>
+  status: approved
+  case_ids: [primary-desktop, primary-narrow]
 browser_delivery:
   delivery_kind: static-directory
   entry_ref: docs/.scratch/<feature>/design/prototypes/index.html
@@ -45,11 +54,11 @@ browser_delivery:
     - name: desktop
       size: 1440x900
       result: pending
-      screenshot_ref: <path>
+      case_ids: [primary-desktop]
     - name: narrow
       size: 390x844
       result: pending
-      screenshot_ref: <path>
+      case_ids: [primary-narrow]
   console_result: pending
   console_ref: <path-to-console-output-or-none>
 design_qa:
@@ -74,7 +83,7 @@ profile_evidence:
   #   reduced_motion: {applicable: false, result: not-applicable, evidence_ref: not-applicable}
   flow_review:
     implementation:
-      framework: react
+      framework: vue
       runtime_build_required: true
       package_manager: pnpm
       package_manifest_ref: docs/.scratch/<feature>/design/prototypes/package.json
@@ -95,12 +104,14 @@ profile_evidence:
       evidence_ref: <snapshot-result-ref>
     prototype_library_facts:
       applicable: true
-      component_basis: react-antd-6
+      component_basis: vue-antdv-next
       source: fact-pack
-      actual_antd_version: <exact-6.x-version-from-lockfile>
-      manifest_ref: docs/design/facts/antd/<exact-version>/manifest.json
+      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
 implementation_handoff:
@@ -114,6 +125,8 @@ review:
   result: pending
   review_ref: docs/.scratch/<feature>/design/<feature>-prototype-review.md
 user_confirmation:
+  user_decision_ref: <真实用户决定记录>
+  decision_subject_ref: <原型与基线确认快照>
   result: pending
   confirmation_ref: docs/.scratch/<feature>/design/<feature>-prototype-confirmation.md
   confirmed_decision: <用户确认的设计决定>

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

@@ -11,7 +11,7 @@
 | 原型 / 线框图 | `<链接或导出图片路径>` |  |
 | 状态矩阵 | `docs/.scratch/<feature>/design/<feature>-state-matrix.md` |  |
 | 原型阶段合同 / Product Design 路由记录 | `yss-prototype-stage -> product-design:index -> <focused skill>` |  |
-| 原型验证清单 | `docs/.scratch/<feature>/verification/prototype-evidence.yaml` | 档位确定后补齐 schema v3 共同与档位证据 |
+| 原型验证清单 | `docs/.scratch/<feature>/verification/prototype-evidence.yaml` | 档位确定后补齐 schema v4 共同与档位证据，并引用 Visual Baseline Bundle v1 |
 | 现有 API 草案 | `docs/.scratch/<feature>/api/<feature>.yaml` | 可选 |
 ## 门禁清单

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

@@ -0,0 +1,70 @@
+# 复制到 Visual Baseline Bundle 根目录的 visual-baseline.yaml；图片由浏览器/Design QA 捕获后执行 seal。
+schema_version: 1
+baseline_id: visual-baseline.<feature>
+feature: <feature>
+version: v1
+status: draft
+bundle:
+  format: portable-directory
+  root_ref: docs/.scratch/<feature>/handoff/visual-baseline-v1
+  digest: <sha256>
+  size_bytes: <bytes>
+  max_image_bytes: 5242880
+  max_bundle_bytes: 104857600
+source:
+  prototype_ref: sources/prototype.snapshot.html
+  prototype_digest: <sha256>
+  interaction_spec_ref: sources/interaction-spec.snapshot.md
+  interaction_spec_digest: <sha256>
+  state_matrix_ref: sources/state-matrix.snapshot.md
+  state_matrix_digest: <sha256>
+capture_environment:
+  browser: chromium
+  browser_version: <exact-version>
+  operating_system: <os-and-version>
+  fonts_digest: <sha256>
+  device_scale_factor: 1
+  color_space: srgb
+  locale: zh-CN
+  timezone: Asia/Shanghai
+  animations_disabled: true
+  cursor_hidden: true
+  capture_script_ref: capture/capture.mjs
+  capture_script_digest: <sha256>
+  capture_result_ref: capture/result.json
+  capture_result_digest: <sha256>
+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
+    locale: zh-CN
+    data_scenario: primary
+    image_ref: images/primary-desktop.png
+    image_digest: <sha256>
+    image_size_bytes: <bytes>
+    mask_ref: not-applicable
+    mask_digest: not-applicable
+    mask_size_bytes: 0
+    semantic_refs: [sources/prototype.snapshot.html, sources/interaction-spec.snapshot.md, sources/state-matrix.snapshot.md]
+    allowed_differences: []
+    result: <passed>
+  - case_id: primary-narrow
+    route: /<route>
+    page: <PageName>
+    state: normal
+    viewport: {name: narrow, width: 390, height: 844, scroll_mode: viewport, scroll_position: 0}
+    theme: compact-light
+    locale: zh-CN
+    data_scenario: primary
+    image_ref: images/primary-narrow.png
+    image_digest: <sha256>
+    image_size_bytes: <bytes>
+    mask_ref: not-applicable
+    mask_digest: not-applicable
+    mask_size_bytes: 0
+    semantic_refs: [sources/prototype.snapshot.html, sources/interaction-spec.snapshot.md, sources/state-matrix.snapshot.md]
+    allowed_differences: []
+    result: <passed>

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

@@ -1,13 +1,13 @@
 {
   "schema_version": 1,
   "source": "DESIGN.md",
-  "source_sha256": "976d74b4af85b5062f9c5a365591809ff240159f0f4445ce05e7a4dcb76d0185",
+  "source_sha256": "59a9f90f7dd62d5e1d4c398e7b8ab8fae595622d0d5fea7bc0d43fe63802f5d5",
   "files": {
-    "docs/design/tokens/theme.json": "94010a32320bfe7135f75d87357609162e0358061fe8577d820dcb62f43ac4e4",
+    "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": "d5bb7bdfe13d71214c44d1a0fdf9648cb5fa35cb6511fb2a35202f8a96fb39dd",
+    "docs/design/tokens/variables.css": "157dd6300e34be53f93196357c97125b77e00f980011db920d2964d46b12600d",
     "docs/design/tokens/variables.dark.css": "b8ebb18f304831ee5c86cf6e5563702b2cc0ce2f51b055036e437a385226cd99"
   }
 }

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

@@ -11,7 +11,7 @@
     "colorText": "rgba(0, 0, 0, 0.88)",
     "colorTextSecondary": "rgba(0, 0, 0, 0.65)",
     "colorBorder": "#d9d9d9",
-    "fontFamily": "-apple-system, BlinkMacSystemFont, \"Segoe UI\", Roboto, \"Helvetica Neue\", Arial, \"Noto Sans\", sans-serif, \"Apple Color Emoji\", \"Segoe UI Emoji\", \"Segoe UI Symbol\", \"Noto Color Emoji\"",
+    "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,
@@ -27,5 +27,5 @@
     "layoutSiderBackground": "#001529",
     "layoutBodyBackground": "#f0f2f5"
   },
-  "algorithm": "default"
+  "algorithm": "compact"
 }

package/template/docs/design/tokens/variables.css CHANGED Viewed

@@ -1,4 +1,9 @@
 :root {
+  --yss-color-primary-control: #245bdb;
+  --yss-color-primary-control-hover: #2f68eb;
+  --yss-color-on-primary: #ffffff;
+  --yss-control-height-compact: 28px;
+  --yss-card-compact-padding: 16px;
   --brand-color-primary: #3371ff;
   --brand-color-primary-bg: #d6e4ff;
   --brand-color-primary-bg-hover: #adc6ff;