@qilitt-mickey/vue3-temp-skill 1.1.70 → 1.1.72

package/SKILL.md

@@ -32,7 +32,7 @@ tags: [vue3, typescript, element-plus, pinia, vite, unocss, crud, demo, code-qua
 
 1. **项目探查**：读取目标项目的 `package.json`、路由、页面、`Re*` 组件、Hooks、API 和样式；以源码事实为准。
 2. **能力路由**：运行 `scripts/match.py "需求" --json`，**仅**按输出中的 `load_files` 阅读 reference；禁止自行展开全部 `references/`。无 Python 时按下方能力组表手动匹配。
-3. **质量闸门**：代码完成后读取 `references/code-quality.md`，执行清单和项目命令。设计变更集落地后追加**设计层闭环审计**：`node scripts/design-audit.mjs --project <落地项目> --container-width <内容区实际宽>`（ERROR 必须清零；无落地项目时自动跳过）。**会话结束前必须跑通终态凭证闸**：`node scripts/apply-final-gate.mjs --project <落地项目> --container-width <内容区实际宽>`（串联 changeset-selfcheck → parser match → parser audit → design-audit 四闸，`FINAL-GATE: PASS` 才算交付完成，凭证写入 `.codebuddy/design/ledger.json`）。
+3. **质量闸门**：代码完成后读取 `references/code-quality.md`，执行清单和项目命令。设计变更集落地后追加**设计层闭环审计**：`node scripts/design-audit.mjs --project <落地项目> --container-width <内容区实际宽>`（ERROR 必须清零；无落地项目时自动跳过）。**会话结束前必须跑通终态凭证闸**：`node scripts/apply-final-gate.mjs --project <落地项目> --container-width <内容区实际宽>`（串联 changeset-selfcheck → parser match → parser audit → design-audit 四闸，`FINAL-GATE: PASS` 才算交付完成，凭证写入 `.design/ledger.json`）。
 
 ## 能力组路由
 
@@ -91,7 +91,7 @@ tags: [vue3, typescript, element-plus, pinia, vite, unocss, crud, demo, code-qua
 ### 4. 验证与交付
 
 - 对照 `references/code-quality.md` 检查类型、组件复用、API、路由、权限、安全、异常反馈、响应式和可演进性。
-- 在目标项目执行 `pnpm lint:fix`、`pnpm type-check`；改动构建配置时再执行 `pnpm build`。
+- 在目标项目执行 `pnpm lint:fix`、`pnpm type-check`；改动构建配置时再执行 `pnpm build`。**本轮产出或修改设计变更集时，这两条不含还原度检查——必须按 code-quality 协议 3 同链追加终态闸 `apply-final-gate`（串联 selfcheck → match → audit → design-audit，取得 FINAL-GATE: PASS），禁止只跑 lint 链就报「全部质量闸门通过」。**
 - **设计文件落地时追加渲染态验收**：变更集含 `oracle`（或效果图带 `data-sid`）时，跑 `node parser/index.js verify`——抽取项目同名 `data-sid` 元素的 computed style，与效果图期望值逐点 diff；缺口按四类归因（选择器落空 / 权重被压 / 语境错位 / **存在性缺口 G12**：`oracle.absent` 点位仍可见）修正，禁止用 `!important` 掩盖。多轮迭代场景每轮动工前先 `--snapshot` 导快照、交付前 `--baseline` 比对——上轮命中本轮退步 = 基线漂移，先回归上轮修法。申报过的固有残差（`oracle.residual_accepted`）不计缺口。
 - **设计文件落地时核对登记表覆盖率**：变更集带登记表（`coverage.registry` 或 `--registry`）时，跑 `node parser/index.js match <cs.json> --registry <restore-registry.json>`——`C = A` 且无缺口才可交付；parser **当场以登记表为权威重算**，设计侧自报的 `coverage` 数字不参与。单独核验登记表对词典的通道就绪度用 `node parser/index.js registry <restore-registry.json>`（硬缺口 exit 1、通道缺口列出待补字段）。
 - 最终说明：命中能力组、修改文件、功能验证、命令结果、未解决问题和下一步。
@@ -131,6 +131,7 @@ tags: [vue3, typescript, element-plus, pinia, vite, unocss, crud, demo, code-qua
 - 功能：...
 - `pnpm lint:fix`：通过 | 失败（原因）
 - `pnpm type-check`：通过 | 失败（原因）
+- 设计闸（本轮有设计变更集时必填，无则 N/A）：`apply-final-gate` → FINAL-GATE: PASS ✅（凭证已写入 ledger.json）
 - 设计验收：无 oracle 时 N/A | 逐点 diff 结果（命中 N / 缺口 M，归因与修正）
 - 缺口回流：无 | 仅限「设计侧未给值」的维度（列出维度名，注明已回流设计侧补齐）
 ```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qilitt-mickey/vue3-temp-skill",
-  "version": "1.1.70",
+  "version": "1.1.72",
   "type": "module",
   "description": "Vue 3 企业级中后台项目开发规范技能包 — core-kernel 架构、按需功能模块",
   "bin": {

package/parser/fixtures/verify/snapshot-latest.json

@@ -1,5 +1,5 @@
 {
-  "generated_at": "2026-09-23T09:41:58.162Z",
+  "generated_at": "2026-09-24T07:14:25.807Z",
   "oracle": "E:\\work\\Project\\Template\\skills\\vue3-temp-skill\\parser\\fixtures\\verify\\oracle.json",
   "actual": "E:\\work\\Project\\Template\\skills\\vue3-temp-skill\\parser\\fixtures\\verify\\actual-clean.json",
   "points": {

package/parser/index.js

@@ -111,7 +111,7 @@ function printHelp() {
 
 用法：
   node parser/index.js build [--dry]                      校验映射表并生成 dist/ 产物
-  node parser/index.js match <changeset.json...>          对设计变更集执行三级匹配（可多文件；顶层 mode=restore 时 G8 模式闸强制 oracle.mockup + coverage.registry 齐备）
+  node parser/index.js match <changeset.json...>          对设计变更集执行三级匹配（可多文件；mode 唯一合法值 restore——G8 模式闸强制 oracle.mockup + coverage.registry 齐备，显式 design 直接拒绝）
                                                           主题身份：changeset.theme（优先）→ global.brand_primary（回退）；
                                                           基线图色板：图内 data-mockup-theme（优先）→ 文件名主题词（回退）。
                                                           二者不一致时须声明 oracle.theme_mapping（只做色值归一，不减声明）。
@@ -261,11 +261,18 @@ function matchOne(file, dataset, batchSummary, opts = {}) {
   //   「场景还原应给」的软提示升级为「mode=restore 必须给」的硬闸。
   //   二轮强化：oracle/coverage 须有「芯」——oracle.mockup 与 coverage.registry 非空，
   //   堵住空壳伪基线（有对象无内容）继续蒙混。
-  //   mode 缺省 / mode=design → 维持软提示口径（轻量主题调整等规范设计场景不受影响）。
-  const MODES = ["design", "restore"];
-  const mode = changeset.mode === undefined || changeset.mode === null ? "design" : changeset.mode;
-  if (!MODES.includes(mode)) {
-    console.error(`✖ mode 应为 "design" / "restore"，实际 "${mode}"`);
+  //   2026-09-24 终判：降级通道废除——mode 唯一合法值 restore，显式 "design" 直接拒绝。
+  //   mode 缺省按旧协议兼容（legacy 变更集无 scheme/page_types，由下方 G8b 基线命中闸兜底）。
+  const mode = changeset.mode === undefined || changeset.mode === null ? null : changeset.mode;
+  if (mode === "design") {
+    console.error(`✖ mode="design" 不是合法交付模式：还原任务的目标是把设计 100% 落地到项目——环境受限 / 覆盖不足 / 意图不明时唯一正确动作是停下向用户多轮询问确认，不得缩水交付；用户显式只要小改动时，不产出还原变更集（按普通需求直接修改）。基线三件套（oracle.mockup + coverage.registry）是还原交付的固有组成，任何 mode 形态都不得移除。`);
+    batchSummary?.invalid.push(path.basename(file));
+    if (!batchSummary)
+      process.exit(1);
+    return;
+  }
+  if (mode !== null && mode !== "restore") {
+    console.error(`✖ mode 应为 "restore"（唯一合法值），实际 "${mode}"`);
     batchSummary?.invalid.push(path.basename(file));
     if (!batchSummary)
       process.exit(1);
@@ -292,8 +299,8 @@ function matchOne(file, dataset, batchSummary, opts = {}) {
     if (missing.length > 0) {
       console.error(`\n✖ G8 模式闸：mode=restore（场景还原）但缺少 ${missing.join(" 与 ")} → 拒绝执行。`);
       console.error(`  场景还原的完备性以登记表覆盖率为分母、以 oracle 为验收基线——缺任一项即「伪还原变更集」：`);
-      console.error(`  只换主题色也能一路绿灯落地，但布局细节点位从未被声明，还原度不可证明（2026-09-20 实证事故）。`);
-      console.error(`  处置：补齐后重跑；若本次确属轻量主题调整而非场景还原，改 mode="design" 并如实声明。`);
+      console.error(`  只换主题色也能一路绿灯落地，但布局细节点位从未被声明，还原度不可证明。`);
+      console.error(`  处置：补齐后重跑——mode=design 不是合法出口；范围确需缩小时停下向用户多轮询问确认。`);
       batchSummary?.invalid.push(path.basename(file));
       if (!batchSummary)
         process.exit(1);
@@ -302,6 +309,42 @@ function matchOne(file, dataset, batchSummary, opts = {}) {
     console.log(`  ✔ G8 模式闸：mode=restore，oracle + coverage 齐备（基线三件套完整）`);
   }
 
+  // G8 三轮强化（2026-09-24 孔雀绿轮实证）：基线命中 ⇒ 不得以缺 mode / 降级形态移除基线三件套。
+  //   事故形态：执行会话把「环境无浏览器」读成降级许可，以 6 条品牌色变更交差，
+  //   notes 自述「未强制绑定基线登记表与 oracle.json」。显式 mode=design 已被上方硬拒，
+  //   本闸兜底「缺 mode 但带 scheme + page_types」的现代形态：三件套缺一即拒。
+  if (mode !== "restore") {
+    const covG8b = changeset.coverage && typeof changeset.coverage === "object" ? changeset.coverage : {};
+    const pageTypesG8b = Array.isArray(covG8b.page_types) ? covG8b.page_types : [];
+    const hasCoreG8b =
+      typeof changeset.oracle?.mockup === "string" && changeset.oracle.mockup.trim().length > 0 &&
+      typeof covG8b.registry === "string" && covG8b.registry.trim().length > 0;
+    if (pageTypesG8b.length && changeset.scheme && !hasCoreG8b) {
+      // 方案注册表（含 baseline 登记）在设计侧技能内；跨技能同机部署时按兄弟目录解析
+      const schemeRegistryG8b = path.resolve(__dirname, "..", "..", "project-ui-design", "references", "page-specs", "styles", "registry.json");
+      let baselineHitsG8b = [];
+      try {
+        const srG8b = JSON.parse(readFileSync(schemeRegistryG8b, "utf-8"));
+        for (const schG8b of srG8b.schemes || []) {
+          if (schG8b.id !== changeset.scheme) continue;
+          for (const [ptG8b, bG8b] of Object.entries(schG8b.baseline || {})) {
+            if (ptG8b.startsWith("$") || !bG8b || typeof bG8b !== "object" || !bG8b.mockup) continue;
+            if (pageTypesG8b.includes(ptG8b)) baselineHitsG8b.push(ptG8b);
+          }
+        }
+      } catch { /* 设计侧技能未检出（非同机部署）时跳过——设计侧 D15 为权威闸 */ }
+      if (baselineHitsG8b.length) {
+        console.error(`\n✖ G8 模式闸（三轮强化）：还原目标存在注册基线（scheme="${changeset.scheme}" × scene="${changeset.scene || "?"}" × 页型 ${baselineHitsG8b.join("/")}），却以 mode=${mode || "(缺省)"} 且缺基线三件套交付 → 拒绝执行。`);
+        console.error(`  环境受限 / 覆盖不足 / 意图不明时唯一正确动作是停下向用户多轮询问确认，基线三件套（oracle.mockup + coverage.registry）照交；`);
+        console.error(`  严禁借任何 mode 形态把还原缩水成主题色变更。`);
+        batchSummary?.invalid.push(path.basename(file));
+        if (!batchSummary)
+          process.exit(1);
+        return;
+      }
+    }
+  }
+
   // G13 页面绑定闸（2026-09-22 事故机制化）：效果图页面是设计角色坐标系，不是页面增量。
   //   事故背景：效果图演示页「运单管理」被误落地为项目新菜单/新页面——效果图标题只是
   //   设计侧为承载设计语言虚构的演示名，落地动作恒为「映射已有页面 + 在其上同步结构与样式」，

package/references/code-quality.md

@@ -13,7 +13,7 @@ tags: [code-review, quality, checklist, lint, typescript, vue3, security, perfor
 
 1. 重读本文件
 2. 列出本轮改动路径，对照下方清单；**硬失败表命中则先改代码再继续**
-3. 业务项目根目录必跑：`pnpm lint:fix` → `pnpm type-check`
+3. 业务项目根目录必跑：`pnpm lint:fix` → `pnpm type-check`；**本轮产出或修改了设计变更集（`.design/changeset*.json`）时，同一条命令链追加终态闸：`node <技能目录>/scripts/apply-final-gate.mjs --project <项目根> --container-width <内容区宽>`，取得 `FINAL-GATE: PASS` 才算通过**（该命令串联 changeset-selfcheck → parser match → parser audit → design-audit 四闸，PASS 凭证写入 ledger.json；只做设计侧产出、未落项目时至少实跑 changeset-selfcheck 并附 exit 0 输出原文）。**禁止把 lint/type-check 单独当「全部质量闸门」汇报**——它们不含任何还原度检查
 4. 失败则修代码并重跑，直至通过或写明阻塞
 5. 最终回复追加：
 
@@ -22,7 +22,7 @@ tags: [code-review, quality, checklist, lint, typescript, vue3, security, perfor
 - 闸门：已执行 code-quality（生成后）
 - 改动文件：`path/a`、`path/b`、…
 - 清单：选型 ✅ / 类型 ✅ / 组件 ✅ / API ✅ / 安全 ✅ / 业务 ✅ / 列表→详情 ✅或N/A / 列表布局 ✅或N/A / 风格 ✅
-- 设计落地：通道活性 ✅ / 锚点契约 ✅ / 结构施工 ✅或N/A / 覆写提权 ✅ / 登记表覆盖率 ✅或N/A / 渲染态验收 ✅或N/A（无 oracle 时 N/A）
+- 设计落地：通道活性 ✅ / 锚点契约 ✅ / 结构施工 ✅或N/A / 覆写提权 ✅ / 登记表覆盖率 ✅或N/A（仅本轮无设计变更集时可用 N/A）/ 渲染态验收 ✅或N/A（**同左；有变更集而无 oracle = 硬失败，不得 N/A**）/ 设计闸命令链 ✅（selfcheck + match + audit 输出原文已附）或N/A（无变更集）
 - 硬失败：无 | 已拦截并修正：…
 - 已修正：…（无则写「无」）
 - 命令：`pnpm lint:fix` → …；`pnpm type-check` → …
@@ -48,6 +48,7 @@ lint / type-check **过了也不能放过**下列项。发现即改代码，禁
 | 列表查询区 `el-form` / 查询按钮 | 写了 `size="small"`（紧凑主题用户未要求） | 不写 size，用 default=`--control-height` |
 | 本轮新增 addon 并引用对应 `Re*` / Vant / 微信 | 已装包但 `tsconfig exclude` 仍含该路径，或 `addon-enable` 要求的 build/src 未改 | 按 **`addon-enable.md`** 对应章节恢复后重跑 type-check |
 | 设计层（`design-shell.scss` / 页面 `scoped`）新增规则 | 与对手**同权重**（对手为组件 `<style scoped>` 时平手即失效——组件样式在全局之后注入），或对手带 `!important` 而本条没带 | 按 `priority.strategy` 提权；**数权重，不许目测** |
+| 本轮产出/修改了设计变更集（`.design/changeset*.json`） | ① 变更集 `mode` 非 `restore`（缺 mode / 写 design 均为硬错误——无登记表、无基线的轻量变更集落地后必然「只变主题色、布局细节零变化」）；② 变更集 `coverage.page_types` 命中注册基线页型，却缺 `oracle.mockup` 或 `coverage.registry`（基线三件套是还原交付的固有组成）；③ 设计闸未实跑（selfcheck exit 0 输出原文未附 / `match --registry` / `design-audit` 缺任一）；④ notes 的覆盖话术与 coverage 字段矛盾（如无三件套却写「等价覆盖全量」） | 补齐三件套（oracle 值可由规范派生并在 notes 声明「未做浏览器实测」）后重跑全部设计闸；范围疑问停下向用户多轮询问确认——不存在降级出口 |
 | 变更集带 `oracle` | ① `oracle.mockup` 不是本页型的**场景基线图**（对照注册表 `baseline.<页型>.mockup`）；② 基线图色板（图内 `data-mockup-theme`）与本次主题（`changeset.theme`）不一致**且未声明** `oracle.theme_mapping`；③ `oracle.sids` 与 `changes[]` 未双向闭合（存在欠声明 / 无基线点位）。**注意：主题 ≠ 基线图色板本身不是违规**——基线图是场景基线、与主题无关，声明 `theme_mapping`（色值归一）后照常全量施工，**不得**把主题不一致当回流理由缩水成只换主题色 | 视缺口而定：缺 `theme_mapping` → 回流设计侧补声明；`sids` 未闭合 → 回流设计侧补齐后再开工，禁止直接施工 |
 | `element-plus.scss` / `sidebar.scss` 等样式消费层 | `var(--font-size-*)` 用于 `line-height` / `height` 等非字号属性 | 查 TSB：`classifyToken` + `PROPERTY_FORBIDDEN`；`line-height` → `--line-height` 或 `--el-menu-item-height` |
 | `element-plus.scss` 内视觉规则（shadow/hover/transition） | 出现非令牌引用的裸 hex / px / rgba 值 | 全部改为 `var()` 引用令牌 |

package/references/design-apply.md

@@ -11,7 +11,7 @@ tags: [design-apply, changeset, semantic-id, mapping, parser, theme, layout]
 
 本能力组是**双 Skill 链路的项目侧执行端**：统一获取上游设计技能产出的「语义 ID 变更集」JSON（`design.changeset/1.0`，协议技术栈中立），由本 Skill 负责翻译并落地到目标项目（vue3-web-temp 及派生项目）。上游设计技能为 **project-ui-design**，协议文档见其 `references/changeset-schema.md`。
 
-**变更集落点唯一化（强制）**：变更集一律落在 `<落地项目>/.codebuddy/design/changeset-<场景>-<页型>-<主题>.json`，与交付台账 `ledger.json` 同目录；多份并存时无法判定「本轮交付物」（`design-audit.mjs` 会告警）。**落地台账**（`ledger.json`，由审计闸自动维护）记录每轮的 `covered/applicable`、设计层行数与已落地语义 ID 集合——它既是**回退检测**的依据，也是**断点续传**的入口：跨轮「继续」时按 `applicable − 已落地点数` 取剩余工作项，禁止把「继续」当成重跑一次同样的开头。
+**变更集落点唯一化（强制）**：变更集一律落在 `<落地项目>/.design/changeset-<场景>-<页型>-<主题>.json`，与交付台账 `ledger.json` 同目录；多份并存时无法判定「本轮交付物」（`design-audit.mjs` 会告警）。**落地台账**（`ledger.json`，由审计闸自动维护）记录每轮的 `covered/applicable`、设计层行数与已落地语义 ID 集合——它既是**回退检测**的依据，也是**断点续传**的入口：跨轮「继续」时按 `applicable − 已落地点数` 取剩余工作项，禁止把「继续」当成重跑一次同样的开头。
 
 ```
 设计变更集 JSON（设计技能产出，中立协议）
@@ -135,16 +135,27 @@ parser match（确定性翻译）→ 施工坐标 → AI 按坐标改代码 →
 
 **红线摘要（全文适用，细节在各步子文件）**：出厂中性 · 变更集驱动（上文）；先结构后样式（第 2 步先于第 3 步）；缺口只分「能力缺口（当场落地）」与「意图缺口（回流设计侧）」两类；**效果图/大文件只读一次**——期望值落盘 `oracle.json` 后，后续环节一律消费落盘产物，禁止反复重读。环境无 Node 时按「环境备注」（见 maintenance.md）人工执行。
 
+## 施工标记规范（G3：@sid / @closed，design-audit E15 机检）
+
+结构性声明（`form` / `suppress` / `suppress_inner` / `structure_ops` / `text_visible:none` / `visible:false`）**必须在设计层留机读标记**——声明了不等于落地了，没有标记就没有对账凭证（悬空声明例：`collapse_trigger.form=header_inline` 声明后壳层零规则，落地端静默无效）：
+
+| 标记 | 写法 | 作用 |
+|---|---|---|
+| `@sid` | 规则上方 `/* @sid: <语义ID> */` | 「变更集 ↔ 设计层」逐条落点对账（@sid 强制） |
+| `@closed` | 收口规则上方 `/* @closed: <通道名> */` | suppress 收口兑现证据（通道名 = 词典 forms/css_vars/custom_style_map 的键） |
+
+补充证据通道：通道为 `css_vars` 键时，设计层对该 var 写关闭值（`transparent` / `none` / `0`）即视为兑现，可免 `@closed` 标记；`visible:false` 的 `display:none` 规则按 E6 口径取证。**双向对账（E15）**：设计层 `@closed` 了变更集未声明的通道 → WARN（台账失真，收口记录进不了 D13 继承链）；声明了词典不认识的 form 值 / 通道名 → ERROR（悬空声明 = 无规则可挂）；结构性声明在设计层零证据 → ERROR。
+
 ## 会话结束条件（终态硬闸，违反 = 交付未完成）
 
 **落地会话不许「做一批、停下来等用户说继续」。** 「继续」只是异常中断后的恢复手段，不是交付形态——把恢复手段当成默认流程 = 把 1:1 还原降级为多次半成品。本轮做完一批点位后，**必须自动进入下一批**，直到同时满足以下三条才允许结束会话：
 
 | # | 结束条件 | 判定方式 |
 |---|---|---|
-| 1 | **施工对账清零**：变更集全部已声明点位（`changes[]` ∪ `visible:false` ∪ `pending` 兑现项）全部落地 | 对照 `.codebuddy/design/ledger.json` 台账与 parser match 输出逐条核销；剩余 >0 → 继续施工 |
+| 1 | **施工对账清零**：变更集全部已声明点位（`changes[]` ∪ `visible:false` ∪ `pending` 兑现项）全部落地 | 对照 `.design/ledger.json` 台账与 parser match 输出逐条核销；剩余 >0 → 继续施工 |
 | 2 | **静态闸清零**：`parser audit` 与 `scripts/design-audit.mjs` 的 ERROR = 0 | 两闸任一 ERROR 即返工，不得带错收尾 |
 | 3 | **验收闭环**：变更集含 oracle 时跑第 6 步 verify（本环境无浏览器 → 渲染态抽取显式移交用户执行，并说明移交项） | verify 全绿或移交说明已给出 |
-| 4 | **终态机读凭证**：跑通 `node <技能>/scripts/apply-final-gate.mjs --project <项目根> --container-width <内容区宽>`，取得 `FINAL-GATE: PASS` | 该命令串联四闸（changeset-selfcheck → parser match → parser audit → design-audit），任何一步非零即 `FAIL`，会话**不得以完成态结尾**；PASS 凭证自动写入 `.codebuddy/design/ledger.json` 的 `finalGate` 字段——终态判定以凭证为准，不以会话自述为准 |
+| 4 | **终态机读凭证**：跑通 `node <技能>/scripts/apply-final-gate.mjs --project <项目根> --container-width <内容区宽>`，取得 `FINAL-GATE: PASS` | 该命令串联四闸（changeset-selfcheck → parser match → parser audit → design-audit），任何一步非零即 `FAIL`，会话**不得以完成态结尾**；PASS 凭证自动写入 `.design/ledger.json` 的 `finalGate` 字段——终态判定以凭证为准，不以会话自述为准。**mode 唯一合法值 restore**：缺 mode / 写 design / 基线命中却缺三件套，均在此拦截 |
 
 > 条件 4 是 1–3 的机器汇总，不替代前三条的人读核对；前 3 条满足而凭证 FAIL = 仍有静态闸未清零，按 FAIL 输出逐项修复。
 

package/references/steps/maintenance.md

@@ -6,9 +6,9 @@
 
 ## 词典维护纪律
 
-### 出厂状态漂移（词典假前提 = 事故源，落地前必查）
+### 出厂状态漂移（词典假前提 = 风险源，落地前必查）
 
-**项目可能随时被还原到出厂**（design-shell 回空壳、`.changeset/*` 消失、本体系此前补的通道全部消失）。因此词典里凡「出厂已具备 X」类表述必须满足：① X 是**真出厂能力**（对照出厂源码可验证）；② 由本体系补建的通道一律写成**条件式**——「若缺失，按 structure_ops / 补通道流程补建并申报」，不写「已存在」。**落地前必须跑 `node parser/index.js audit --project <dir>`**：锚点/选择器/变量消费者存在性静态校验，会当场暴露词典假前提（曾发生：词典写「出厂已渲染分割线 / 工具栏行已挂语义类」，项目还原后全部失真 → 规则落空）。
+**项目可能随时被还原到出厂**（design-shell 回空壳、`.changeset/*` 消失、本体系此前补的通道全部消失）。因此词典里凡「出厂已具备 X」类表述必须满足：① X 是**真出厂能力**（对照出厂源码可验证）；② 由本体系补建的通道一律写成**条件式**——「若缺失，按 structure_ops / 补通道流程补建并申报」，不写「已存在」。**落地前必须跑 `node parser/index.js audit --project <dir>`**：锚点/选择器/变量消费者存在性静态校验，会当场暴露词典假前提（例：词典写「出厂已渲染分割线 / 工具栏行已挂语义类」，项目还原后全部失真 → 规则落空）。
 
 - mapping/ 是唯一事实源：施工前 `parser query <id>` 精读条目，**不凭记忆施工**。
 - **禁止编造的是「既有条目的映射」**（改既有 selector / css_vars / 变量指向 = 静默篡改，绝对禁止）。**词典缺 ID / 缺字段枚举不属编造**——那是新点位，按 L3 当场落地并写**新增的**临时映射条目，交付说明申报，等人工评审转正。

package/references/steps/step1-match.md

@@ -29,9 +29,9 @@ node parser/index.js match --batch <changesets-dir>
 | **能力缺口**（词典缺 ID / 缺字段枚举 / 缺 form） | 设计侧意图完整、值合法 | **项目侧当场落地**：按 L3 定制布局施工并写 mapping 临时映射；出厂文件仅在「补通道」时可动，交付说明单列申报。**进清单 = 把可落地项搁置 = 交付失败** |
 | **意图缺口**（设计侧没给值 / 值非法） | 变更集里本就没有这个值 | 才可进「缺口清单」，交付说明写明「回流设计侧补齐」——**不是问用户要不要做** |
 
-> **闸门红 = 硬停（交付缺陷，性质与上表相反）**：`parser match` **退出码非 0**（G8 模式闸 / G9 登记表身份闸 / G10 dims 闸 / G11 oracle 基线闸 / 覆盖率细闸，任一不通过）时 **禁止开工落地**。合法出路只有两条：① 回设计侧补齐（基线 / 登记项 / 点位）后重跑；② 经用户**显式同意**后按 `mode=design` 降级，并在交付说明写出「本次实际覆盖范围清单 + 未覆盖清单」。
+> **闸门红 = 硬停（交付缺陷，性质与上表相反）**：`parser match` **退出码非 0**（G8 模式闸 / G9 登记表身份闸 / G10 dims 闸 / G11 oracle 基线闸 / 覆盖率细闸，任一不通过）时 **禁止开工落地**。合法出路只有一条：回设计侧补齐（基线 / 登记项 / 点位）后重跑——**`mode` 唯一合法值是 `restore`**，不存在「经用户同意降级」的出口；范围确需缩小时，停下向用户多轮询问确认真实意图，按确认结论调整变更集范围后重算。
 >
-> **禁止「挑拣完整的那部分先落地」**：最典型的错误是闸门报错后只落全局主题令牌（改 `platform-config.json` 的 `EpThemeColor` + 设计层覆盖 `--brand-primary`）再宣称完成——用户看到的是「只换了主题色，布局样式全不对」，且重建设计层时把上一轮成果一并覆盖（2026-09-23 橘橙跑三闸红 → 只落主题色 → 620 行设计层被覆盖为 77 行）。上表「禁止中途停顿」**只适用于能力缺口**（词典没建 ID / 字段没枚举），**不适用于闸门红**。
+> **禁止「挑拣完整的那部分先落地」**：最典型的错误是闸门报错后只落全局主题令牌（改 `platform-config.json` 的 `EpThemeColor` + 设计层覆盖 `--brand-primary`）再宣称完成——用户看到的是「只换了主题色，布局样式全不对」，且重建设计层时会把上一轮成果一并覆盖。上表「禁止中途停顿」**只适用于能力缺口**（词典没建 ID / 字段没枚举），**不适用于闸门红**。
 
 
 `缺口清单` 只承载第二类，且必须给出点位 ID + 缺失字段名。

package/references/steps/step2-structure.md

@@ -22,7 +22,7 @@
 - 设计未声明该点位（效果图上没有这个位置的操作）→ 收口隐藏（`visible:false` 或隐藏通道），不显示演示文字；
 - **判据一句话：还原后的页面不得残留模板的演示说明性文字与占位按钮——它们既不是设计效果，也不是交付目标。** 残留 = 把演示噪音当成了还原结果，即「效果 vs 内容」混淆的实景表现。
 
-**结构/样式图层分工**：`form`（高度模式、形态枚举）是**结构意图**，必须落到 DOM 属性/组件开关/配置字段（如 `data-content-mode`、`ShowModel`）；**禁止把结构意图降级翻译成 SCSS 变量写进样式文件**（form=scroll 只写 `--vts-margin` = 未施工，已实证）。样式文件（如 design-shell.scss）只承载 css_vars/custom_style_map 翻译产物；壳层通用文件禁止代打页面级结构属性（lay-content 硬编码 `data-content-mode="scroll"` 曾压掉 `:has()` 自动定高探测，useTableSearch 高度链断裂致列表区整体崩坏——已回退，禁止复活）。
+**结构/样式图层分工**：`form`（高度模式、形态枚举）是**结构意图**，必须落到 DOM 属性/组件开关/配置字段（如 `data-content-mode`、`ShowModel`）；**禁止把结构意图降级翻译成 SCSS 变量写进样式文件**（form=scroll 只写 `--vts-margin` = 未施工）。样式文件（如 design-shell.scss）只承载 css_vars/custom_style_map 翻译产物；壳层通用文件禁止代打页面级结构属性（lay-content 硬编码 `data-content-mode="scroll"` 会压掉 `:has()` 自动定高探测，useTableSearch 高度链断裂致列表区整体崩坏，禁止此类写法）。
 
 **结构链不可侵（高度链保命红线）**：内容区高度链是**结构层**，已与视觉解耦，两侧各有边界——
 

package/references/steps/step3b-shell.md

@@ -49,9 +49,9 @@ html body .sidebar-container {          /* 令牌宿主 = 该令牌被消费的
 
 - **本文件是产物，不是手改对象（流程红线）**：`design-shell.scss` 的每一行都必须由「变更集 + 词典」经本协议产出——发现缺规则时，正确动作是**补词典字段 / 前置条件 / 登记项**让下一次 design-apply 自动生成，**禁止绕过流程直接手写项目文件**。仅「补通道」（变量消费者 / form 枚举 / 组件中性默认）允许动出厂源码并单列申报。
 
-- **累积性红线（禁止整文件重写）**：本文件的**驱动源是变更集，不是词典**——「历史规则已落词典，重生成后会自动带出」**只在「本轮变更集交齐全部适用点位」时成立**。若上游只交了部分点位（`coverage.covered < applicable`、`gaps` 非空），按「出厂空文件」重建会把上一轮已落地的规则**整段覆盖**，用户侧表现为「布局样式全不对，只剩主题色」（2026-09-23 实证：620 行 → 77 行，同时上游 covered=31/186）。因此：
+- **累积性红线（禁止整文件重写）**：本文件的**驱动源是变更集，不是词典**——「历史规则已落词典，重生成后会自动带出」**只在「本轮变更集交齐全部适用点位」时成立**。若上游只交了部分点位（`coverage.covered < applicable`、`gaps` 非空），按「出厂空文件」重建会把上一轮已落地的规则**整段覆盖**，用户侧表现为「布局样式全不对，只剩主题色」（例：620 行 → 77 行，同时上游 covered=31/186）。因此：
   - **重建即合并**：本轮变更集未覆盖的既有段落**原样保留**，只增删本轮涉及的段；自举（文件缺失 → 新建）后不得把既有内容当作「历史包袱」丢弃；
-  - **落地前后各记一次状态**（设计层行数 + 已落地语义 ID 集合）：`node scripts/design-audit.mjs --project <落地项目>` 的 E12 会自动写 `.codebuddy/design/ledger.json` 台账并与历史峰值比对，**行数或点位骤降 = 交付回退**，必须停下并向上游回流，不得继续宣称完成；
+  - **落地前后各记一次状态**（设计层行数 + 已落地语义 ID 集合）：`node scripts/design-audit.mjs --project <落地项目>` 的 E12 会自动写 `.design/ledger.json` 台账并与历史峰值比对，**行数或点位骤降 = 交付回退**，必须停下并向上游回流，不得继续宣称完成；
   - 上游交付不完整时，正确动作是**拒绝落地 + 回流设计侧补齐**，**不是「挑完整的那部分先落」**（只落全局主题令牌 = 假交付）。
 
 - 每条规则带来源标注（`/* <语义 ID> · <变更条目> */`），换设计时整段可替换；

package/references/steps/step5-gates.md

@@ -50,7 +50,7 @@
   - E9 形态收口缺件 → `icon_only` 只落了「显图标」而没有**在同一作用域内**收口文案（作用域外的兄弟变体收口不算成对）
   - E10 scoped 挂空 → 组件 scoped 规则依赖运行时并不存在的类（结构重构后残留，永不命中）
   - E11 **交付完整性** → `mode=restore` 时 `covered < applicable`（欠声明）/ `gaps` 非空 / 缺口未在 `pending[]` 台账化（下游「继续」无工作项可执行）/ 自报 `registrable` 与登记表实物不符 / `notes` 的成功话术与 `coverage` 字段互相矛盾。**该项是「只换了主题色」的第一现场**：上游残缺口 + 下游挑拣落地，两头都能被它抓住
-  - E12 **设计层累积性** → 设计层文件行数或变更集点位相比历史峰值骤降（上一轮成果被重建覆盖）。本项会写 `.codebuddy/design/ledger.json` 台账（`--no-ledger` 可关；`--changeset <path>` / `--design-layer <path>` 可指定），**台账同时是「继续」的断点续传依据**：`applicable − 已落地点数` 即剩余工作项，不再依赖自然语言回忆
+  - E12 **设计层累积性** → 设计层文件行数或变更集点位相比历史峰值骤降（上一轮成果被重建覆盖）。本项会写 `.design/ledger.json` 台账（`--no-ledger` 可关；`--changeset <path>` / `--design-layer <path>` 可指定），**台账同时是「继续」的断点续传依据**：`applicable − 已落地点数` 即剩余工作项，不再依赖自然语言回忆
   - E13 **固定尺寸内容度量** → 设计层出现「固定 `width` 小于内容需求、且未声明收口兜底」的规则（典型：页签位 40px 里还留着标题、图标位里塞着文案）。固定宽装不下内容时文字会换行、被压缩、甚至字符重叠渲染——**「设计说 40px 就固定 40px」必然复现**。判据：盒内还有文案却用 exact 宽度又无收口
   - E14 **列宽预算链自洽** → 列宽（含公式推出的值）扣掉**实际生效的 td 水平内边距**后装不下该列内容（操作列 = 平铺槽数 × 槽宽）；或同一列宽存在两个来源且值不一致（列定义死值 vs 模板公式）。**这是「按钮文字换行 / 重叠」的第一现场**
   - E16 **引用完整性** → 变更集 `oracle.mockup` / `coverage.registry` 指向的实物不存在（标识改名后未同步引用，全链路静默降级为无基线还原）；`mode=restore` 缺顶层 `theme` 字段

package/scripts/apply-final-gate.mjs

@@ -45,7 +45,7 @@ if (!PROJECT || !fs.existsSync(PROJECT)) {
 const CONTAINER_WIDTH = argValue("--container-width", "1200");
 
 // ── 变更集发现（与 design-audit 同口径：多目录 + 显式 --changeset 优先）──
-const DESIGN_DIRS = [".codebuddy/design", "design", ".changeset"];
+const DESIGN_DIRS = [".design", "design", ".changeset"];
 let changeset = argValue("--changeset") ? path.resolve(argValue("--changeset")) : null;
 if (!changeset) {
   const found = [];
@@ -63,7 +63,7 @@ if (!changeset) {
 }
 if (!changeset || !fs.existsSync(changeset)) {
   console.error(`FINAL-GATE: FAIL（无变更集）`);
-  console.error(`  ${PROJECT} 下未发现变更集（查找 .codebuddy/design、design、.changeset）——没有交付物就没有终态。`);
+  console.error(`  ${PROJECT} 下未发现变更集（查找 .design、design、.changeset）——没有交付物就没有终态。`);
   process.exit(1);
 }
 
@@ -138,7 +138,7 @@ for (const s of steps) {
 const status = allOk ? "PASS" : "FAIL";
 console.log(`\nFINAL-GATE: ${status}`);
 if (allOk) {
-  console.log(`  四闸清零，交付完成。凭证已写入 .codebuddy/design/ledger.json（finalGate）。`);
+  console.log(`  四闸清零，交付完成。凭证已写入 .design/ledger.json（finalGate）。`);
 } else {
   const firstBad = steps.find((s) => !s.ok);
   console.log(`  终态未达成（首个未清零闸：${firstBad?.name || "?"}）——会话不得以完成态结尾，须继续修复后复跑。`);
@@ -146,7 +146,7 @@ if (allOk) {
 
 // 凭证写入 ledger.json（不改动 design-audit 维护的轮次历史，只追加 finalGate 字段）
 try {
-  const ledgerPath = path.join(PROJECT, ".codebuddy", "design", "ledger.json");
+  const ledgerPath = path.join(PROJECT, ".design", "ledger.json");
   let ledger = {};
   if (fs.existsSync(ledgerPath)) {
     try {

package/scripts/check.mjs

@@ -23,10 +23,13 @@ const PYTHON_ARGS = process.platform === "win32" && !process.env.VUE3_SKILL_PYTH
 /** 设计层闭环审计的目标项目：默认当前目录，可用 VUE3_AUDIT_PROJECT 指向落地项目 */
 function resolveAuditProject() {
   const dir = process.env.VUE3_AUDIT_PROJECT || process.cwd();
-  const designDir = path.join(dir, ".codebuddy", "design");
-  if (!fs.existsSync(designDir)) return null;
-  const has = fs.readdirSync(designDir).some((f) => /^changeset.*\.json$/i.test(f));
-  return has ? dir : null;
+  for (const d of [".design", "design", ".changeset"]) {
+    const designDir = path.join(dir, d);
+    if (!fs.existsSync(designDir)) continue;
+    const has = fs.readdirSync(designDir).some((f) => /^changeset.*\.json$/i.test(f));
+    if (has) return dir;
+  }
+  return null;
 }
 
 const checks = [
@@ -45,7 +48,7 @@ const checks = [
     desc: "变量悬空/层错位/层叠胜负/锚点挂空/列宽预算/收口断言（无落地项目则跳过）",
     cmd: () => {
       const project = resolveAuditProject();
-      if (!project) return "SKIPPED 未发现落地项目（.codebuddy/design/changeset*.json，亦兼容 design/ 与 .changeset/）；用 VUE3_AUDIT_PROJECT=<落地项目> 指定后复跑";
+      if (!project) return "SKIPPED 未发现落地项目（.design/changeset*.json，亦兼容 design/ 与 .changeset/）；用 VUE3_AUDIT_PROJECT=<落地项目> 指定后复跑";
       const args = ["--project", project];
       if (process.env.VUE3_AUDIT_CONTAINER_WIDTH) {
         args.push("--container-width", process.env.VUE3_AUDIT_CONTAINER_WIDTH);
@@ -53,6 +56,79 @@ const checks = [
       return run(NODE, "scripts/design-audit.mjs", args);
     },
   },
+  {
+    name: "审计闸 G3 回归",
+    desc: "结构声明兑现闸：悬空 form / 未收口通道的假项目必须被 design-audit 拒绝，带 @sid/@closed 标记的正例必须通过",
+    cmd: () => {
+      const neg = path.join(ROOT, "tests/fixtures/audit-g3-negative");
+      const pos = path.join(ROOT, "tests/fixtures/audit-g3-positive");
+      const lines = [];
+      if (fs.existsSync(neg)) {
+        let rejected = false;
+        let out = "";
+        try {
+          out = run(NODE, "scripts/design-audit.mjs", ["--project", neg, "--no-ledger"]);
+        } catch (e) {
+          rejected = true;
+          out = `${e.stdout || ""}${e.stderr || ""}`;
+        }
+        if (!rejected) {
+          throw Object.assign(new Error("审计负例未被拒绝"), {
+            stdout: "  ✗ audit-g3-negative 竟然通过 —— E15 结构声明兑现闸判据被削弱，必须修复\n",
+          });
+        }
+        if (!/\[E15\]/.test(out)) {
+          throw Object.assign(new Error("审计负例未命中 E15"), {
+            stdout: `  ✗ audit-g3-negative 被拒绝，但未命中 [E15] —— 断言已失效\n${out.slice(-800)}\n`,
+          });
+        }
+        lines.push("negative 被拒绝并命中 [E15]");
+      }
+      if (fs.existsSync(pos)) {
+        let out = "";
+        try {
+          out = run(NODE, "scripts/design-audit.mjs", ["--project", pos, "--no-ledger"]);
+        } catch (e) {
+          throw Object.assign(new Error("审计正例被拒绝"), {
+            stdout: `  ✗ audit-g3-positive 被拒绝（E15 存在误报，必须修复）：\n${(e.stdout || "") + (e.stderr || "")}\n`,
+          });
+        }
+        lines.push("positive 通过");
+      }
+      if (!lines.length) return "SKIPPED 未发现审计夹具（仅源码检出时可用）";
+      return `  ${lines.join("；")}`;
+    },
+  },
+  {
+    name: "模式闸唯一值回归",
+    desc: "mode 唯一合法值 restore：显式 design 的变更集必须被 parser match 拒绝",
+    cmd: () => {
+      const cs = path.join(
+        ROOT,
+        "tests/fixtures/pattern-g15-negative/.design/changeset-g15-negative.json",
+      );
+      if (!fs.existsSync(cs)) return "SKIPPED 未发现模式闸夹具（仅源码检出时可用）";
+      let rejected = false;
+      let out = "";
+      try {
+        out = run(NODE, "parser/index.js", ["match", cs]);
+      } catch (e) {
+        rejected = true;
+        out = `${e.stdout || ""}${e.stderr || ""}`;
+      }
+      if (!rejected) {
+        throw Object.assign(new Error("模式闸负例未被拒绝"), {
+          stdout: "  ✗ pattern-g15-negative 竟然通过 —— mode 唯一合法值 restore 的判据被削弱，必须修复\n",
+        });
+      }
+      if (!/基线三件套/.test(out)) {
+        throw Object.assign(new Error("模式闸负例未命中预期判据"), {
+          stdout: `  ✗ pattern-g15-negative 被拒绝，但未命中「基线三件套」判据 —— 断言已失效\n${out.slice(-800)}\n`,
+        });
+      }
+      return "  negative 被拒绝并命中「基线三件套」判据（mode 唯一合法值 restore）";
+    },
+  },
 ];
 
 function run(runner, script, args = []) {

package/scripts/design-audit.mjs

@@ -28,10 +28,11 @@
  *   E9 形态收口缺件  form=icon_only 只显图标、未在同一作用域内收口文案（且不被兄弟变体规则骗过）
  *   E10 scoped 挂空  组件 scoped 规则依赖运行时并不存在的类（重构残留，永不命中）
  *   E11 交付完整性   mode=restore 时 covered<applicable / gaps 非空 / 缺口未台账化 / 分母漂移 / notes 与字段矛盾
- *   E12 设计层累积性  变更集点位或设计层行数相对历史骤降（上一轮成果被覆盖）→ 写交付台账 .codebuddy/design/ledger.json
+ *   E12 设计层累积性  变更集点位或设计层行数相对历史骤降（上一轮成果被覆盖）→ 写交付台账 .design/ledger.json
  *   E13 固定尺寸内容度量 固定 width 小于内容需求且无收口兜底 → 文字换行/压缩/重叠
  *   E14 列宽预算链自洽  列宽（含公式）扣掉实际 td 内边距后装不下内容 → 操作列按钮被压
  *   E16 引用完整性   变更集引用的实物不存在（改名未同步）/ restore 缺顶层 theme
+ *   E15 结构声明兑现  form 值 / suppress 通道名必须在词典枚举内，且设计层有 @sid / @closed 落点证据（G3 双向对账）
  */
 
 import fs from "fs";
@@ -254,9 +255,9 @@ const designRules = DESIGN_FILES.flatMap((f) =>
 const PRIMARY_LAYER = path.resolve(PROJECT, argValue("--design-layer", "src/styles/design-shell.scss"));
 const isPrimary = (file) => path.resolve(file) === PRIMARY_LAYER;
 
-// 变更集发现：落点历史上不唯一（.codebuddy/design 与项目根 design/ 都出现过）。
-// 硬编码单一目录的代价是「变更集搬家 → 闸门静默跳过」（2026-09-23 实证：E6/E8/E9 全跳过而无人察觉）。
-const CHANGESET_DIRS = [".codebuddy/design", "design", ".changeset"];
+// 变更集发现：规范落点 .design/，兼容 design/ 与 .changeset/。
+// 硬编码单一目录的代价是「变更集搬家 → 闸门静默跳过」。
+const CHANGESET_DIRS = [".design", "design", ".changeset"];
 const relp = (p) => path.relative(PROJECT, p).replace(/\\/g, "/");
 const changesetCandidates = [];
 {
@@ -281,7 +282,7 @@ let changesetFile = null;
 if (changesetCandidates.length > 1) {
   warn(
     "E11",
-    `多份变更集并存：${changesetCandidates.map(relp).join("、")} —— 无法判定哪份是「本轮」交付物，暂取最近修改的一份。落点应唯一为 .codebuddy/design/ 并在交付台账登记。`,
+    `多份变更集并存：${changesetCandidates.map(relp).join("、")} —— 无法判定哪份是「本轮」交付物，暂取最近修改的一份。落点应唯一为 .design/ 并在交付台账登记。`,
   );
 }
 if (changesetCandidates.length) {
@@ -680,7 +681,7 @@ function matchArrayLiteral(text, anchorRe) {
 // ── E6 visible:false 收口断言 ──────────────────────────────
 (function checkE6() {
   if (!changeset) {
-    info("E6", "未发现变更集（.codebuddy/design/changeset*.json），跳过收口断言");
+    info("E6", "未发现变更集（.design/changeset*.json），跳过收口断言");
     return;
   }
   const changes = changeset.changes || [];
@@ -826,6 +827,195 @@ const lastClassOutsideNot = (sel) => {
   }
 })();
 
+// ── E15 结构声明兑现闸（G3：@sid 强制 + form/suppress 双向对账）──
+// 结构性声明（form / suppress / suppress_inner / structure_ops / text_visible:none /
+// visible:false）不能停留在台账上——项目侧必须有可指认的落点证据。实证缺口
+// （2026-09-24 孔雀绿轮）：collapse_trigger.form=header_inline 声明了，但词典 forms
+// 只有 bottom_bar / center_edge —— 壳层零规则，落地端静默无效，而 E6/E8/E9 的
+// 特判窗口都盖不住它。
+// 证据通道（按优先级）：
+//   ① /* @sid: <语义ID> */      —— 逐条落点标记（@sid 强制的机读载体）
+//   ② /* @closed: <通道名> */   —— suppress 收口证据（与 @sid 同构）
+//   ③ 通道为 css_vars 键时，设计层对该 var 写入关闭值（transparent / none / hidden / 0）
+//   ④ visible:false 的 display:none 收口规则（E6 同源）
+// 判定：
+//   · form 值不在词典 forms 枚举内 / suppress 通道名不是 forms∪css_vars∪custom_style_map
+//     的键 → ERROR（声明悬空 = 项目侧无规则可挂）
+//   · suppress_rules[form] 与 suppress[] 要求的通道无任何兑现证据 → ERROR
+//   · 有落点证据但缺 @sid → WARN（补标记使逐条对账可机读）
+//   · 出厂默认形态且无其他结构载荷 → WARN（保持现状无需规则，但仍需标记）
+//   · 反向：设计层 @closed 了变更集未声明的通道 → WARN（台账失真，收口记录进不了 D13 继承链）
+const CLOSING_VALUE_RE = /^(transparent|none|hidden|0(?:px)?)(\s|$)/i;
+const markedSids = new Set([...designCss.matchAll(/@sid\s*:\s*([\w.$-]+)/g)].map((m) => m[1]));
+const closedMarkers = new Set([...designCss.matchAll(/@closed\s*:\s*([\w.-]+)/g)].map((m) => m[1]));
+
+/** 与 parser extractSuppressRules 同源：结构化 suppress_rules 优先，forms 描述「suppress 必含」兜底 */
+function extractSuppressRulesAudit(entry) {
+  const rules = {};
+  if (entry && typeof entry.suppress_rules === "object" && entry.suppress_rules !== null) {
+    for (const [form, channels] of Object.entries(entry.suppress_rules)) {
+      rules[form] = Array.isArray(channels) ? channels.filter((c) => typeof c === "string") : [];
+    }
+  }
+  const forms = entry?.forms;
+  if (forms && typeof forms === "object" && !Array.isArray(forms)) {
+    for (const [form, desc] of Object.entries(forms)) {
+      if (typeof desc !== "string") continue;
+      for (const m of desc.matchAll(/suppress\s*必含\s*([a-z][a-z0-9_]*(?:[、,/][a-z][a-z0-9_]*)*)/gi)) {
+        const channels = m[1].split(/[、,/]/).map((s) => s.trim()).filter(Boolean);
+        rules[form] = [...new Set([...(rules[form] || []), ...channels])];
+      }
+    }
+  }
+  return rules;
+}
+
+const channelNamesOf = (entry) =>
+  new Set([
+    ...Object.keys(entry?.forms || {}),
+    ...Object.keys(entry?.css_vars || {}),
+    ...Object.keys(entry?.custom_style_map || {}),
+  ]);
+
+/** 通道收口证据：@closed 标记 或（css_vars 键）关闭值覆写 */
+function channelEvidence(entry, ch) {
+  if (closedMarkers.has(ch)) return `@closed:${ch}`;
+  const varName = entry?.css_vars?.[ch];
+  if (varName) {
+    const re = new RegExp(`${varName}\\s*:\\s*([^;\\n}]+)`, "i");
+    const m = re.exec(designCss);
+    if (m && CLOSING_VALUE_RE.test(m[1].trim())) return `${varName} 关闭值覆写`;
+  }
+  return null;
+}
+
+/** visible:false 落点证据（E6 同源口径） */
+function visibleClosureRule(change) {
+  const entry = dictSidMap.get(change.id);
+  const target = classTokens(entry?.selector || "").slice(-1)[0];
+  if (!target) return null;
+  return (
+    designRules.find((r) => r.selector.includes(`.${target}`) && /none/i.test(r.decls.display || "")) || null
+  );
+}
+
+(function checkE15() {
+  if (!changeset) {
+    info("E15", "未发现变更集，跳过结构声明兑现对账");
+    return;
+  }
+  const isStructural = (c) =>
+    typeof c?.form === "string" ||
+    (Array.isArray(c?.suppress) && c.suppress.length > 0) ||
+    (typeof c?.suppress_inner === "string" && c.suppress_inner.trim()) ||
+    (Array.isArray(c?.structure_ops) && c.structure_ops.length > 0) ||
+    c?.style?.text_visible === "none" ||
+    c?.visible === false;
+
+  const changes = changeset.changes || [];
+  for (const change of changes) {
+    if (!isStructural(change)) continue;
+    const entry = dictSidMap.get(change.id);
+    if (!entry) {
+      warn("E15", `${change.id} 声明结构语义（form/suppress 等），但词典无该条目 —— 项目侧无挂载点，无法兑现（match 会拦截）。`);
+      continue;
+    }
+
+    // ① form 值真实性：悬空 form 值 = 壳层零规则（header_inline 实证）
+    if (typeof change.form === "string" && change.form) {
+      const forms = entry.forms && typeof entry.forms === "object" ? Object.keys(entry.forms) : [];
+      const rules = entry.suppress_rules || {};
+      if (forms.length && !forms.includes(change.form) && !(change.form in rules)) {
+        err(
+          "E15",
+          `${change.id} 的 form="${change.form}" 不在词典 forms 枚举 [${forms.join("、")}] 内 —— 项目侧无规则可挂（壳层零规则），声明悬空。形态值只能取词典已支持的枚举；确需新形态先走 pending 补词典。`,
+        );
+      }
+    }
+
+    // ② suppress 通道名真实性（「声明 → 词典」对账）
+    const declared = Array.isArray(change.suppress) ? change.suppress : [];
+    const known = channelNamesOf(entry);
+    const unknown = declared.filter((ch) => !known.has(ch));
+    if (unknown.length) {
+      err(
+        "E15",
+        `${change.id}.suppress 引用了词典不认识的通道 [${unknown.join("、")}]（可用通道：${[...known].join("、")}）—— 通道名以该条目 forms/css_vars/custom_style_map 的键为准。`,
+      );
+    }
+
+    // ③ suppress_rules[form] 与已声明通道的兑现证据（「声明 → 设计层」对账）
+    const required = extractSuppressRulesAudit(entry)[change.form] || [];
+    const demanded = [...new Set([...required, ...declared])];
+    let allClosed = true;
+    for (const ch of demanded) {
+      const ev = channelEvidence(entry, ch);
+      if (!ev) {
+        allClosed = false;
+        const varHint = entry.css_vars?.[ch]
+          ? `，或（通道为 css_vars 键）在设计层覆写 ${entry.css_vars[ch]} 为关闭值（transparent / none / 0）`
+          : "";
+        err(
+          "E15",
+          `${change.id} 要求收口通道「${ch}」，但设计层无任何兑现证据 —— 需要 /* @closed: ${ch} */ 标记${varHint}。声明了不收口 = 出厂旧装饰残留（双竖条并存类症状）。`,
+        );
+      }
+    }
+
+    // ④ @sid 强制（零证据 = 壳层零规则；有证据缺标记 = 降级 WARN 促标记）
+    const hasSid = markedSids.has(change.id);
+    if (!hasSid) {
+      const visRule = change.visible === false ? visibleClosureRule(change) : null;
+      if (change.visible === false && !visRule) {
+        // E6 已就同一根因报 ERROR，此处不重复
+      } else if (demanded.length && allClosed) {
+        warn("E15", `${change.id} 的收口已有落点证据，但缺 /* @sid: ${change.id} */ 标记 —— 补标记使「变更集 ↔ 设计层」逐条对账可机读（G3）。`);
+      } else if (change.visible === false && visRule) {
+        warn("E15", `${change.id} 的 display:none 收口已落（E6 ✓），但缺 /* @sid: ${change.id} */ 标记 —— 补标记使逐条对账可机读。`);
+      } else {
+        const forms = entry.forms && typeof entry.forms === "object" ? entry.forms : {};
+        const isDefaultForm = typeof change.form === "string" && /出厂默认|默认形态|default/i.test(String(forms[change.form] || ""));
+        const hasOps = Array.isArray(change.structure_ops) && change.structure_ops.length > 0;
+        const hasInner = typeof change.suppress_inner === "string" && change.suppress_inner.trim().length > 0;
+        const hasTextNone = change.style?.text_visible === "none";
+        const otherPayload = hasOps || hasInner || hasTextNone || demanded.length > 0;
+        if (isDefaultForm && !otherPayload) {
+          warn("E15", `${change.id} 的 form="${change.form}" 是出厂默认形态（无需新增规则），但缺 /* @sid: ${change.id} */ 标记 —— 建议补标记。`);
+        } else if (hasOps && !otherPayload) {
+          warn("E15", `${change.id} 的 structure_ops 由 parser G2 施工证据闸取证；设计层建议补 /* @sid: ${change.id} */ 标记。`);
+        } else {
+          err(
+            "E15",
+            `${change.id} 的结构性声明在设计层零落点证据（无 @sid 标记、无 @closed 兑现标记、无收口规则）—— 壳层零规则，声明悬空（例：collapse_trigger.form=header_inline 声明后壳层无任何规则）。每条结构性声明必须在设计层留机读标记：/* @sid: <语义ID> */。`,
+          );
+        }
+      }
+    }
+  }
+
+  // ⑤ 反向对账：设计层收口了变更集未声明的通道 → 台账失真
+  for (const ch of closedMarkers) {
+    const owners = changes
+      .map((c) => ({ c, e: dictSidMap.get(c?.id) }))
+      .filter(({ e }) => e && channelNamesOf(e).has(ch));
+    if (!owners.length) continue; // 不属于本变更集涉及的点位（历史层），不判
+    const accounted = owners.some(
+      ({ c, e }) =>
+        (Array.isArray(c.suppress) ? c.suppress.includes(ch) : false) ||
+        (extractSuppressRulesAudit(e)[c.form] || []).includes(ch),
+    );
+    if (!accounted) {
+      warn(
+        "E15",
+        `设计层 /* @closed: ${ch} */ 收口了通道，但变更集未声明该收口（涉及点位：${owners.map((o) => o.c.id).join("、")}）—— 台账失真：收口记录进不了 D13 继承链，下轮漏抄即出厂形态复现。`,
+      );
+    }
+  }
+  if (!errors.some((e) => e.id === "E15") && !warnings.some((w) => w.id === "E15")) {
+    info("E15", "结构声明兑现：form/suppress 全部落在词典已知通道且设计层有落点证据 ✓");
+  }
+})();
+
 // ── @sid 标记覆盖率（可选增强） ─────────────────────────────
 (function checkSidCoverage() {
   const marked = new Set([...designCss.matchAll(/@sid\s*:\s*([\w.$-]+)/g)].map((m) => m[1]));
@@ -852,7 +1042,7 @@ const lastClassOutsideNot = (sel) => {
     );
     return;
   }
-  const mode = changeset.mode || "design";
+  const mode = changeset.mode;
   const cov = changeset.coverage;
   const gaps = (cov && cov.gaps) || [];
   const pending = changeset.pending || [];
@@ -860,7 +1050,11 @@ const lastClassOutsideNot = (sel) => {
   const notesText = JSON.stringify(changeset.notes || []);
 
   if (mode !== "restore") {
-    info("E11", `交付模式 mode=${mode}（规范设计 / 显式轻量调整），跳过覆盖率硬闸；但若本次本意是场景还原，则「还原被降级为 design」= 交付失败。`);
+    err(
+      "E11",
+      `mode 必须为 "restore"（实为 ${JSON.stringify(changeset.mode ?? null)}）：` +
+        `还原任务的目标是把设计 100% 落地到项目，环境受限 / 覆盖不足 / 意图不明时唯一正确动作是停下向用户多轮询问确认，不得缩水交付。`,
+    );
     return;
   }
   if (!cov) {
@@ -882,7 +1076,7 @@ const lastClassOutsideNot = (sel) => {
     if (!pending.length) {
       err(
         "E11",
-        `缺口未台账化：gaps 有 ${gaps.length} 条理由，但 pending[] 为空 —— 缺口没有变成可执行工作项，所以「继续」时无任何东西可做，复跑也不可能收敛（实证症状：多轮继续后效果不变）。`,
+        `缺口未台账化：gaps 有 ${gaps.length} 条理由，但 pending[] 为空 —— 缺口没有变成可执行工作项，所以「继续」时无任何东西可做，复跑也不可能收敛（症状：多轮继续后效果不变）。`,
       );
     } else {
       const declared = new Set(changes.map((c) => c.id));
@@ -904,7 +1098,7 @@ const lastClassOutsideNot = (sel) => {
         const reg = JSON.parse(fs.readFileSync(real, "utf-8"));
         const items = reg.items || reg.registry || [];
         if (Array.isArray(items) && items.length && items.length !== R) {
-          err("E11", `登记表分母漂移：coverage.registrable=${R}，登记表实物为 ${items.length} 条 —— 自报数与实物不一致（曾发生 186 对 190）。分母错则该报的欠声明数也不可信。`);
+          err("E11", `登记表分母漂移：coverage.registrable=${R}，登记表实物为 ${items.length} 条 —— 自报数与实物不一致。分母错则该报的欠声明数也不可信。`);
         } else if (Array.isArray(items) && items.length) {
           info("E11", `登记表分母对账：registrable=${R} = 实物 ${items.length} 条 ✓`);
         }
@@ -931,7 +1125,7 @@ const lastClassOutsideNot = (sel) => {
 // ── E12 设计层累积性（跨轮回退检测 + 交付台账） ──────────────
 // 「继续一次处理不完、继续了也没变化」的根治：把每轮落地状态落成机器可读台账，
 // 使「本轮是否把上一轮成果覆盖掉」可被断言，而不是靠人记得。
-const LEDGER_PATH = path.join(PROJECT, ".codebuddy", "design", "ledger.json");
+const LEDGER_PATH = path.join(PROJECT, ".design", "ledger.json");
 const WRITE_LEDGER = !process.argv.includes("--no-ledger");
 (function checkE12() {
   const primaryText = srcTextByFile.get(PRIMARY_LAYER) ?? readIf(PRIMARY_LAYER) ?? "";
@@ -941,7 +1135,7 @@ const WRITE_LEDGER = !process.argv.includes("--no-ledger");
   const cur = {
     at: new Date().toISOString(),
     changeset: changesetFile ? relp(changesetFile) : null,
-    mode: changeset ? changeset.mode || "design" : null,
+    mode: changeset ? changeset.mode ?? null : null,
     covered: cov ? cov.covered : null,
     applicable: cov ? cov.applicable : null,
     design_shell_lines: primaryLines,
@@ -967,7 +1161,7 @@ const WRITE_LEDGER = !process.argv.includes("--no-ledger");
     if (peakLines && primaryLines && primaryLines < peakLines * 0.6) {
       err(
         "E12",
-        `交付回退：设计层 ${argValue("--design-layer", "src/styles/design-shell.scss")} 行数 ${peakLines} → ${primaryLines}（骤降 >40%）—— 上一轮已落地的规则被覆盖/丢失。设计层是累积产物，禁止按「出厂空文件」重建；重建必须合并既有规则。（2026-09-23 实证：620 行被覆盖为 75 行，用户侧表现为「布局样式全不对，只剩主题色」。）`,
+        `交付回退：设计层 ${argValue("--design-layer", "src/styles/design-shell.scss")} 行数 ${peakLines} → ${primaryLines}（骤降 >40%）—— 上一轮已落地的规则被覆盖/丢失。设计层是累积产物，禁止按「出厂空文件」重建；重建必须合并既有规则（否则用户侧表现为「布局样式全不对，只剩主题色」）。`,
       );
     }
     const priorSids = new Set(priorRounds.flatMap((r) => r.applied_sids || []));
@@ -1208,7 +1402,7 @@ const MIN_ANY_BOX = 24;
   }
   // restore 模式的顶层 theme 字段：缺失会让「本次主题」回落到 global.brand_primary 反推，
   // 重新引入「换主题 = 换读取路径」的分叉
-  if ((changeset.mode || "design") === "restore" && !changeset.theme) {
+  if (changeset.mode === "restore" && !changeset.theme) {
     warn(
       "E16",
       "变更集 mode=restore 但缺顶层 `theme` 字段 —— 本次主题只能回落按 `global.brand_primary` 反推（旧口径）。补 `theme` 可让「本次主题」与「基线图色板」两个身份各自可机读、互不推断。",