@qilitt-mickey/vue3-temp-skill 1.1.43 → 1.1.45

package/parser/validator.js

@@ -5,7 +5,7 @@
  *   1. 字段完整性（必须字段存在且类型正确）
  *   2. 枚举合法性（type/forms 值域）
  *   3. 层级一致性（children 引用的 ID 必须存在于同级或同场景映射集）
- *   4. V3.2 三字段结构：anchors（kind/layer 枚举 + target 必填）、
+ *   4.  三字段结构：anchors（kind/layer 枚举 + target 必填）、
  *      preconditions（非空字符串数组）、priority（strategy 枚举）
  *
  * 说明：selector / anchors.target 的「挂载点存在性」需要在**目标项目源码**里查证，
@@ -101,7 +101,7 @@ export function validateMappingDataset(dataset) {
           }
         }
 
-        // anchors（V3.2 §3.2）：条目可承载的全部通道，含落点层级 layer
+        // anchors（ §3.2）：条目可承载的全部通道，含落点层级 layer
         if (entry.anchors !== undefined) {
           if (!Array.isArray(entry.anchors)) {
             errors.push(`[${file}] ${id}.anchors 必须为数组`);
@@ -130,7 +130,7 @@ export function validateMappingDataset(dataset) {
           }
         }
 
-        // preconditions（V3.2 §3.2）：几何 / 取值成立的宿主前提，非空字符串数组
+        // preconditions（ §3.2）：几何 / 取值成立的宿主前提，非空字符串数组
         if (entry.preconditions !== undefined) {
           if (!Array.isArray(entry.preconditions) || entry.preconditions.length === 0) {
             errors.push(`[${file}] ${id}.preconditions 必须为非空字符串数组`);
@@ -143,7 +143,7 @@ export function validateMappingDataset(dataset) {
           }
         }
 
-        // priority（V3.2 §4.6.4）：覆写优先级策略
+        // priority（ §4.6.4）：覆写优先级策略
         if (entry.priority !== undefined) {
           if (typeof entry.priority !== "object" || entry.priority === null) {
             errors.push(`[${file}] ${id}.priority 必须为对象`);

package/references/cobalt-admin-restore.changeset.json

@@ -0,0 +1,468 @@
+{
+  "schema": "design.changeset/1.0",
+  "changeset_version": "1.0.0",
+  "mapping_version": "1.0.0",
+  "scene": "admin",
+  "layout_type": "vertical",
+  "global": {
+    "brand_primary": "钴蓝-5"
+  },
+  "changes": [
+    {
+      "id": "admin.layout.sidebar",
+      "style": {
+        "width": "208px",
+        "collapsed_width": "64px",
+        "bg": "#001529"
+      }
+    },
+    {
+      "id": "admin.layout.sidebar.logo_area",
+      "style": {
+        "height": "54px",
+        "title_font_size": "16px",
+        "title_font_weight": "中等",
+        "title_color": "#FFFFFF"
+      }
+    },
+    {
+      "id": "admin.layout.sidebar.menu",
+      "form": "pill",
+      "style": {
+        "padding_y": "8px",
+        "item_height": "40px",
+        "font_size": "14px",
+        "font_weight": "常规",
+        "text_color": "rgba(255,255,255,0.65)",
+        "menu_hover_bg": "rgba(255,255,255,0.08)",
+        "menu_active_bg": "钴蓝-5",
+        "menu_active_indicator": "钴蓝-5"
+      },
+      "priority": { "strategy": "deep_qualified" }
+    },
+    {
+      "id": "admin.layout.sidebar.collapse_trigger",
+      "visible": false
+    },
+    {
+      "id": "admin.layout.header",
+      "style": {
+        "height": "54px",
+        "padding_x": "24px",
+        "bg": "#FFFFFF",
+        "border_color": "#F0F0F0"
+      }
+    },
+    {
+      "id": "admin.layout.header.collapse_trigger",
+      "form": "header_inline",
+      "style": {
+        "btn_width": "40px",
+        "btn_height": "40px",
+        "icon_size": "16px",
+        "border_radius": "6px"
+      }
+    },
+    {
+      "id": "admin.layout.header.logo_area",
+      "visible": false
+    },
+    {
+      "id": "admin.layout.header.breadcrumb",
+      "visible": false,
+      "priority": { "strategy": "deep_qualified" }
+    },
+    {
+      "id": "admin.layout.header.lang_switch",
+      "form": "inline_switch",
+      "style": {
+        "gap": "2px",
+        "icon_size": "16px",
+        "text_color": "#000000A6"
+      }
+    },
+    {
+      "id": "admin.layout.header.fullscreen",
+      "style": {
+        "icon_size": "16px",
+        "width": "32px"
+      }
+    },
+    {
+      "id": "admin.layout.header.setting_button",
+      "style": {
+        "icon_size": "16px",
+        "hover_bg": "#FAFAFA",
+        "text_color": "#000000A6"
+      }
+    },
+    {
+      "id": "admin.layout.header.user_profile",
+      "form": "greeting_avatar_name",
+      "style": {
+        "avatar_width": "28px",
+        "avatar_height": "28px",
+        "avatar_radius": "9999px",
+        "name_font_size": "14px",
+        "name_font_weight": "中等",
+        "greeting_font_size": "14px",
+        "gap": "12px",
+        "text_color": "#000000E6",
+        "hover_bg": "#FAFAFA"
+      },
+      "structure_ops": [{ "op": "add_node", "node": "问候区" }]
+    },
+    {
+      "id": "admin.layout.tabs",
+      "form": "flat",
+      "style": {
+        "height": "40px",
+        "bg": "#FFFFFF",
+        "border_bottom": "1px solid #F0F0F0",
+        "padding_inline": "0px"
+      },
+      "priority": { "strategy": "deep_qualified" }
+    },
+    {
+      "id": "admin.layout.tabs.home_tab",
+      "form": "icon_only",
+      "style": {
+        "width": "40px",
+        "height": "40px",
+        "icon_size": "16px",
+        "icon_color": "钴蓝-5"
+      }
+    },
+    {
+      "id": "admin.layout.tabs.item",
+      "form": "text_only",
+      "style": {
+        "card_height": "40px",
+        "padding_x": "12px",
+        "title_gap": "6px",
+        "close_size": "12px",
+        "close_opacity": "0.45",
+        "close_hover_color": "#FF4D4F",
+        "divider_color": "#F0F0F0"
+      },
+      "priority": { "strategy": "deep_qualified" }
+    },
+    {
+      "id": "admin.layout.tabs.item_active",
+      "form": "text_color_only",
+      "style": {
+        "text_color": "钴蓝-5",
+        "font_weight": "中等"
+      }
+    },
+    {
+      "id": "admin.layout.tabs.divider",
+      "style": {
+        "width": "1px",
+        "height": "100%",
+        "bg": "#F0F0F0",
+        "opacity": "1"
+      }
+    },
+    {
+      "id": "admin.layout.tabs.context_menu",
+      "style": {
+        "width": "120px",
+        "border_color": "#F0F0F0",
+        "radius": "6px"
+      }
+    },
+    {
+      "id": "admin.content.container",
+      "form": "fixed"
+    },
+    {
+      "id": "admin.layout.content",
+      "style": {
+        "padding": "24px"
+      }
+    },
+    {
+      "id": "component.card.base",
+      "style": {
+        "bg_color": "#FFFFFF",
+        "radius": "8px",
+        "border_color": "transparent",
+        "box_shadow": "0 2px 8px rgba(0,0,0,0.06)",
+        "padding_x": "0px",
+        "padding_y": "0px"
+      }
+    },
+    {
+      "id": "admin.content.page_header",
+      "style": {
+        "margin_bottom": "1px solid #F0F0F0",
+        "title_size": "20px",
+        "title_weight": "加粗",
+        "desc_size": "14px",
+        "desc_color": "#000000A6",
+        "actions_gap": "8px",
+        "padding_x": "20px",
+        "padding_y": "20px"
+      }
+    },
+    {
+      "id": "admin.content.filter_area",
+      "style": {
+        "radius": "6px",
+        "padding_y": "20px",
+        "padding_x": "20px",
+        "margin_bottom": "1px solid #F0F0F0",
+        "bg": "#FFFFFF",
+        "border_color": "#F0F0F0",
+        "font_size": "14px",
+        "text_color": "#000000E6",
+        "text_align": "右对齐",
+        "icon_size": "16px",
+        "gap": "20px"
+      }
+    },
+    {
+      "id": "admin.content.table.operation_bar",
+      "style": {
+        "gap": "8px",
+        "padding_y": "20px 20px 8px",
+        "btn_height": "32px",
+        "btn_radius": "6px",
+        "btn_font_size": "14px",
+        "font_size": "14px",
+        "font_weight": "常规",
+        "text_color": "#000000E6"
+      }
+    },
+    {
+      "id": "admin.content.table.area",
+      "style": {
+        "radius": "8px",
+        "header_bg": "#FAFAFA",
+        "header_text": "#000000E6",
+        "row_hover_bg": "#FAFAFA",
+        "bg_color": "#FFFFFF"
+      }
+    },
+    {
+      "id": "admin.content.table.header_cell",
+      "layer": { "padding": "host", "text_align": "inner" },
+      "style": {
+        "height": "48px",
+        "padding": "16px",
+        "bg": "#FAFAFA",
+        "font_size": "14px",
+        "font_weight": "中等",
+        "text_color": "#000000E6",
+        "text_align": "左对齐",
+        "border_bottom": "1px solid #F0F0F0",
+        "nowrap": "禁止换行",
+        "gap": "8px",
+        "icon_size": "16px"
+      },
+      "priority": { "strategy": "self_plus_important" }
+    },
+    {
+      "id": "admin.content.table.cell",
+      "layer": "host",
+      "style": {
+        "padding": "16px",
+        "height": "55px",
+        "font_size": "14px",
+        "font_weight": "常规",
+        "text_color": "#000000E6",
+        "border_bottom": "1px solid #F0F0F0",
+        "vertical_align": "居中",
+        "nowrap": "禁止换行"
+      }
+    },
+    {
+      "id": "admin.content.table.cell_status",
+      "form": "filled",
+      "style": {
+        "bg": "#F6FFED",
+        "border_color": "#D9F7BE",
+        "text_color": "#52C41A",
+        "font_size": "12px",
+        "radius": "6px",
+        "icon_size": "16px"
+      },
+      "structure_ops": [{ "op": "render_branch", "node": "状态列" }]
+    },
+    {
+      "id": "admin.content.table.cell_amount",
+      "layer": "inner",
+      "style": {
+        "align": "右对齐"
+      },
+      "structure_ops": [{ "op": "bind_source", "node": "金额列", "source": "列类名" }]
+    },
+    {
+      "id": "admin.content.table.operation_column",
+      "style": {
+        "link_color": "钴蓝-5",
+        "danger_color": "#FF4D4F",
+        "divider_color": "#F0F0F0",
+        "align": "居中",
+        "min_width": "160px",
+        "column_width": "160px",
+        "nowrap": "禁止换行",
+        "bg": "#FFFFFF",
+        "box_shadow": "-2px 0 4px rgba(0,0,0,0.06)",
+        "font_size": "14px",
+        "gap": "8px",
+        "radius": "6px",
+        "vertical_align": "居中"
+      },
+      "structure_ops": [
+        { "op": "render_branch", "node": "操作列图标" },
+        { "op": "add_node", "node": "操作列分隔线" }
+      ]
+    },
+    {
+      "id": "admin.content.pagination",
+      "style": {
+        "font_size": "14px",
+        "text_color": "#000000A6",
+        "gap": "8px",
+        "margin_bottom": "20px",
+        "padding_y": "8px 20px",
+        "active_bg": "钴蓝-5",
+        "active_color": "#FFFFFF",
+        "border_color": "#D9D9D9",
+        "hover_color": "钴蓝-5"
+      }
+    },
+    {
+      "id": "admin.content.empty_state",
+      "style": {
+        "font_size": "14px",
+        "text_color": "#000000A6",
+        "icon_size": "40px",
+        "padding": "40px"
+      }
+    },
+    {
+      "id": "component.button.primary",
+      "style": {
+        "bg_color": "钴蓝-5",
+        "text_color": "#FFFFFF",
+        "border_color": "钴蓝-5",
+        "font_weight": "常规",
+        "padding_x": "15px",
+        "height": "32px",
+        "radius": "6px"
+      }
+    },
+    {
+      "id": "component.button.default",
+      "style": {
+        "bg_color": "#FFFFFF",
+        "text_color": "#000000E6",
+        "border_color": "#D9D9D9",
+        "font_weight": "常规",
+        "padding_x": "15px",
+        "height": "32px",
+        "radius": "6px"
+      }
+    },
+    {
+      "id": "component.button.danger",
+      "style": {
+        "bg_color": "#FF4D4F",
+        "text_color": "#FFFFFF",
+        "border_color": "#FF4D4F",
+        "font_weight": "常规",
+        "padding_x": "12px",
+        "height": "32px",
+        "radius": "6px"
+      }
+    },
+    {
+      "id": "component.tag.status",
+      "form": "filled",
+      "style": {
+        "bg_color": "#F6FFED",
+        "text_color": "#52C41A",
+        "border_color": "#D9F7BE",
+        "font_size": "12px",
+        "radius": "6px",
+        "icon_size": "16px"
+      }
+    },
+    {
+      "id": "component.input.base",
+      "style": {
+        "bg_color": "#FFFFFF",
+        "text_color": "#000000E6",
+        "border_color": "#D9D9D9",
+        "radius": "6px",
+        "height": "32px",
+        "font_size": "14px",
+        "icon_size": "16px",
+        "padding_x": "12px"
+      }
+    },
+    {
+      "id": "component.pagination.base",
+      "style": {
+        "height": "32px",
+        "gap": "8px",
+        "radius": "6px",
+        "active_bg": "钴蓝-5",
+        "active_color": "#FFFFFF",
+        "border_color": "#D9D9D9",
+        "text_color": "#000000E6",
+        "hover_color": "钴蓝-5",
+        "icon_size": "16px"
+      }
+    }
+  ],
+  "oracle": {
+    "mockup": "project-ui-design/references/page-specs/styles/default/scenes/admin/mockups/list-page/运单管理-钴蓝.html",
+    "sids": [
+      "admin.layout.sidebar",
+      "admin.layout.sidebar.logo_area",
+      "admin.layout.sidebar.menu",
+      "admin.layout.header",
+      "admin.layout.header.collapse_trigger",
+      "admin.layout.header.lang_switch",
+      "admin.layout.header.fullscreen",
+      "admin.layout.header.setting_button",
+      "admin.layout.header.user_profile",
+      "admin.layout.tabs",
+      "admin.layout.tabs.home_tab",
+      "admin.layout.tabs.item",
+      "admin.layout.tabs.item_active",
+      "admin.layout.tabs.divider",
+      "admin.layout.content",
+      "admin.content.container",
+      "component.card.base",
+      "admin.content.page_header",
+      "admin.content.filter_area",
+      "admin.content.table.operation_bar",
+      "admin.content.table.area",
+      "admin.content.table.header_cell",
+      "admin.content.table.cell",
+      "admin.content.table.cell_status",
+      "admin.content.table.cell_amount",
+      "admin.content.table.operation_column",
+      "admin.content.pagination",
+      "component.button.primary",
+      "component.button.default",
+      "component.button.danger",
+      "component.tag.status",
+      "component.input.base",
+      "component.pagination.base"
+    ]
+  },
+  "coverage": {
+    "registry": "project-ui-design/references/page-specs/styles/default/scenes/admin/restore-registry.json",
+    "registrable": 186,
+    "applicable": 186,
+    "covered": 186,
+    "gaps": []
+  },
+  "notes": "钴蓝主题 admin 列表页完整还原变更集（首版，待 verify 验收）。值优先取效果图精确字面量；官方主色走语义值 钴蓝-5。侧栏为深色 #001529（钴蓝主题壳层约定）。cell_thumb 列本页未出现故未声明；sidebar.collapse_trigger / header.logo_area 按出厂中性收口（visible:false）。"
+}

package/references/code-quality.md

@@ -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（无 oracle 时 N/A）
+- 设计落地：通道活性 ✅ / 锚点契约 ✅ / 结构施工 ✅或N/A / 覆写提权 ✅ / 登记表覆盖率 ✅或N/A / 渲染态验收 ✅或N/A（无 oracle 时 N/A）
 - 硬失败：无 | 已拦截并修正：…
 - 已修正：…（无则写「无」）
 - 命令：`pnpm lint:fix` → …；`pnpm type-check` → …
@@ -47,6 +47,8 @@ lint / type-check **过了也不能放过**下列项。发现即改代码，禁
 | 新菜单路由 | 父级无 `icon` 或业务页二次挂 `Layout` | `icons` + `core-kernel` |
 | 列表查询区 `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` 提权；**数权重，不许目测** |
+| 变更集带 `oracle` | `oracle.mockup` 与本次主题/页面不一致（跨主题复用效果图），或 `oracle.sids` 与 `changes[]` 未双向闭合（存在欠声明 / 无基线点位） | 回流设计侧补齐后再开工，禁止直接施工 |
 | `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()` 引用令牌 |
 | 视觉规则新增 | `dark.scss` 缺少对应暗色覆盖 | 每条新规则在 `html.dark` 内有对应覆盖 |
@@ -54,6 +56,7 @@ lint / type-check **过了也不能放过**下列项。发现即改代码，禁
 | 同上 | `apply_via` 为 `class_name` / `attribute` / `slot_content` / `data_source` 之一，却只写了 CSS 而没改结构/绑定 | 按 `structure_ops` 施工（改模板 / 绑 `class-name` / 改 formatter / 挂 `data-*`），CSS 换不掉数据驱动点位 |
 | 同上 | 全局覆写与组件 `scoped` 同权重生效失败（收口 `visible:false` / opacity / 几何覆盖不生效） | 按 `priority` 声明提权（`scope_qualified` / `self_plus_important` / `deep_qualified`），不得靠「后置加载」赌注入顺序 |
 | 同上 | 词典 `selector` / `css_vars` 指向的选择器在真实 DOM 不存在（死通道 / 死令牌） | 跑 `node parser/index.js audit` 复核；死令牌双删、死通道补消费者挂载点 |
+| 同上 | 变更集带登记表时 `C < A`（有规范子项未落进 `changes[]` / `visible` / `pending`）——组级台账过了但组内子项被静默丢失 | 跑 `node parser/index.js match --registry`；缺口逐条点名回流设计侧，**禁止采信自报的 `coverage` 数字**（parser 当场重算） |
 
 ## 选型与硬约束
 
@@ -142,7 +145,7 @@ lint / type-check **过了也不能放过**下列项。发现即改代码，禁
 - [ ] 变更集外点位零改动（diff 只含变更集提到的文件/选择器）
 - [ ] `visible: false` 模块代码仍存在（只隐藏不删除）
 - [ ] 未修改 `src/components/` Re* 组件库源码（底线一）；未改业务逻辑层 API/状态/事件（底线二）
-- [ ] 两层样式全部落在条目 `style_scope` 作用域内，无全局泄漏、无 `!important` 新增
+- [ ] 两层样式全部落在条目 `style_scope` 作用域内，无全局泄漏；`!important` 仅用于 `priority.strategy=self_plus_important` 或「对手为组件 scoped 且提权后实测仍平手」两种情形，且带理由注释
 - [ ] 无内联硬编码色值；全部走 CSS 变量（css_vars 层）或 `:deep()` 隔离（custom_style_map 层）
 - [ ] 新增视觉规则在 `dark.scss` `html.dark` 有对应覆盖
 - [ ] 能力缺口（词典缺 ID / 缺字段枚举 / 缺 form）已当场落地并写临时映射，未进清单；`缺口清单` 只含意图缺口（设计侧未给值 / 值非法）且已注明回流设计侧；mapping 临时新增后 `node parser/index.js build --dry` 通过
@@ -150,11 +153,13 @@ lint / type-check **过了也不能放过**下列项。发现即改代码，禁
 - [ ] **映射通道活性**：本轮用到的词典条目，其 `selector` / `css_vars` 在真实 DOM 可命中、CSS 变量有消费者（已跑 `audit` 或逐条核对，无死通道 / 死令牌）
 - [ ] **锚点契约**：变更集 `anchor` 声明的锚点存在；`layer=inner` 的点位已解析到内层文本盒（`.cell` / 文本节点宿主），未错落在宿主盒上
 - [ ] **结构施工**：`apply_via` 非 `style_override` 的点位已按 `structure_ops` 改结构/绑定（`class-name` / formatter / `data-*` / 渲染分支），未只用 CSS 冒充落地；申报了结构增量施工
-- [ ] **覆写提权**：`priority` 声明的点位覆写已生效（收口 / 几何覆盖实测生效），全局规则未被组件 `scoped` 反压
+- [ ] **覆写提权 / 同权重失效检查**：`priority` 声明的每条规则都**数过权重**——对手为组件 `<style scoped>` 时本条必须严格更高（**平手即判失效**并提权）；对手带 `!important` 时本条必须同样 `!important`，或改走通道变量。收口（`display:none` 等）与几何覆盖必须实测生效，未被组件 `scoped` 反压
 - [ ] **模板源码注释中性**：对模板文件的改动中，注释只描述「这段代码做什么」；语义 ID / 协议步骤号 / 缺口·自举·申报等面向 AI 的纪律条款不得写入模板源码注释（一律留在技能侧文档）
 
 ### 渲染态验收（变更集含 `oracle` / 效果图有 `data-sid` 时强制）
 
+- [ ] **oracle 基线可用**：`oracle.mockup` 与本次主题、页面一致（未复用异主题效果图）；`oracle.sids` 与 `changes[]` 双向闭合（无欠声明点位、无「已声明却无基线」点位）——`parser match` 已自动报出，未报错才算通过
+- [ ] **登记表覆盖率闭合**（变更集带登记表时）：`match --registry` 输出 `C = A`、无缺口，且无「效果图标注缺口」（恒存在子项在效果图上都有同名 `data-sid`）
 - [ ] 项目同名 `data-sid` 元素已渲染，抽取 computed style 与效果图期望值逐点 diff
 - [ ] diff 结果无未解释缺口；有缺口者已按三类（选择器落空 / 权重被压 / 语境错位）归因并修正，未用 `!important` 掩盖
 - [ ] 验收结果写入最终回复（命中 / 缺口 / 归因 / 修正），不得只报「已完成」