@qilitt-mickey/vue3-temp-skill 1.1.34 → 1.1.36

package/README.md

@@ -1,6 +1,6 @@
 # vue3-temp-skill
 
-Vue 3 企业级项目开发技能包。面向 vue3-web-temp 及其派生项目，把产品点子快速做成可演示、可验证、可继续演进的 Demo，同时约束代码质量和设计落地。
+Vue 3 企业级项目开发技能包。面向 vue3-web-temp 及其派生项目，把产品点子快速做成可演示、可验证、可继续演进的 Demo，同时约束代码质量。
 
 ## 文档分工
 
@@ -19,7 +19,6 @@ Vue 3 企业级项目开发技能包。面向 vue3-web-temp 及其派生项目
 - **按需** `project-inventory`（查依赖 / 装包 / 查 Re* 名录）
 - **按需** `addon-enable` — 只有目标项目确实存在排除项、占位插件或缺失接线时才读
 - **生成后闸门** `code-quality`：清单 + `pnpm lint:fix` + `pnpm type-check` + 结果块
-- **设计交接** 有 `design-handoff/v1` 时读 `design-handoff`，落地后用 `handoff.mjs` 做轻量校验
 
 ## 使用方式
 
@@ -41,7 +40,7 @@ Vue 3 企业级项目开发技能包。面向 vue3-web-temp 及其派生项目
 |------|------|
 | 始终 | core-kernel |
 | 闸门 | code-quality |
-| 高频 | page-crud、page-detail、data-service、forms、access、design-implementation、shared-ui |
+| 高频 | page-crud、page-detail、data-service、forms、access、theme-layout、shared-ui |
 | 专项 | table-advanced、visualization、workflow、files-and-editors、realtime-and-mobile、data-compare、i18n |
 | 工程 | project-setup（project-inventory + addon-enable） |
 
@@ -58,7 +57,9 @@ Vue 3 企业级项目开发技能包。面向 vue3-web-temp 及其派生项目
 | 脚本 | 职责 |
 |------|------|
 | `scripts/match.py` | 能力路由器：输入需求，输出 JSON（`load_files`、同批加载、闸门项） |
-| `scripts/handoff.mjs` | 设计交接：`init` 校验 JSON 并建 session，`check` 校验关键接线 |
+| `parser/index.js` | 设计变更集解析器：`build` 校验编译 / `match` 三级匹配 / `list` 词典清单 / `query` 单条详情（design-apply 能力组） |
+| `parser/watch.js` / `npm run mapping:watch` | 开发态监听 mapping/ 变更自动重编译 dist/ |
+| `parser/override.js` | 业务级映射覆写 API（链路 A 配套，`overrideMapping` / `overrideMappings`） |
 
 **匹配器调用（本地环境）：**
 
@@ -76,8 +77,6 @@ python scripts/match.py --batch   # 15 个典型场景回归
 ```bash
 npm run match          # python scripts/match.py
 npm run match:batch    # 批量回归
-npm run handoff:init   # node scripts/handoff.mjs init（需追加 --project 等参数）
-npm run handoff:check  # node scripts/handoff.mjs check
 ```
 
 ### 维护者（不随技能安装分发）
@@ -104,7 +103,7 @@ Node.js >= 22.12.0
 npx @qilitt-mickey/vue3-temp-skill@latest install all
 ```
 
-安装器只复制 AI 运行时文件：`match.py`、`modules.json`、`handoff.mjs`。validate / check / cli 留在技能包仓库供维护使用。
+安装器复制 AI 运行时文件：`match.py`、`modules.json`、`mapping/`（语义 ID 词典）、`parser/`（变更集解析器）。validate / check / cli / release 留在技能包仓库供维护使用。
 
 | 目标 | 说明 |
 |------|------|
@@ -113,32 +112,6 @@ npx @qilitt-mickey/vue3-temp-skill@latest install all
 
 具体路径因 AI 环境而异，安装完成后以安装器输出为准。
 
-### 设计落地（可选）
-
-handoff JSON 可以来自对话、临时文件或管道。状态默认保存在用户级状态目录，**不在业务项目创建 `.handoff/`**：
-
-- 默认路径：`~/.workbuddy/state/vue3-temp-skill/<项目哈希>/handoff.json`
-- Windows 示例：`%USERPROFILE%\.workbuddy\state\vue3-temp-skill\<项目哈希>\handoff.json`
-
-```bash
-# 动手前：校验 JSON 规格并建立 session
-node scripts/handoff.mjs init  --project ./my-vue-app --file C:/temp/handoff.json
-
-# 落地后：确认关键接线存在
-node scripts/handoff.mjs check --project ./my-vue-app --require-session
-```
-
-也支持显式指定状态目录（适合 CI 或多工作区）：追加 `--state-dir <项目外状态目录>`。
-
-通过 npm 包 CLI：
-
-```bash
-npx @qilitt-mickey/vue3-temp-skill handoff init  --project ./my-vue-app --file C:/temp/handoff.json
-npx @qilitt-mickey/vue3-temp-skill handoff check --project ./my-vue-app --require-session
-```
-
-`handoff.mjs` 只做两件事：确认 JSON 规格完整，确认目标项目存在落地所需关键接线。它不统计改动文件数量，也不要求全项目遍历。
-
 ## 与模版的关系
 
 本 Skill 约定对齐 **vue3-web-temp** 精简脚手架：
@@ -154,4 +127,3 @@ npx @qilitt-mickey/vue3-temp-skill handoff check --project ./my-vue-app --requir
 - **标准样板**：在本包 `references/`；模板 `views/` 主要用于确认真实接线，不直接复制演示文案
 - 壳层、组件和 API 以当前项目源码为准；规范文档只补充实现方法
 - HTTP：仅经 `@/utils/http`；版本以目标项目 `package.json` 和锁文件为准
-- **设计协同**：定制 UI 由**设计技能**出稿（含 `design-handoff/v1` JSON）→ 本 Skill 工程落地；不引入其他设计 Skill

package/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: "vue3-temp-skill"
-description: "Vue 3 企业级项目开发技能。面向 vue3-web-temp 及其派生项目，帮助产品经理和前端快速把点子做成可演示、可验证、可继续演进的 Demo；同时约束真实模板复用、代码质量和设计交接落地。"
+description: "Vue 3 企业级项目开发技能。面向 vue3-web-temp 及其派生项目，帮助产品经理和前端快速把点子做成可演示、可验证、可继续演进的 Demo；同时约束真实模板复用和代码质量。"
 scope: project
 agent_created: true
 tags: [vue3, typescript, element-plus, pinia, vite, unocss, crud, demo, code-quality]
@@ -21,15 +21,16 @@ tags: [vue3, typescript, element-plus, pinia, vite, unocss, crud, demo, code-qua
 典型需求：
 
 - 开发客户管理列表，支持搜索、分页、编辑和详情
-- 做一个有设计感的订单仪表盘，沿用设计 handoff
+- 做一个订单仪表盘，含统计卡片和趋势图
 - 给现有 Demo 增加附件上传、导出或审批流
 - 把一个页面从 mock 改成真实 API
+- 落地一份设计变更集 JSON（上游 project-ui-design 产出，含语义 ID + 抽象样式字段）
 
 ## 运行时只保留三件事
 
 1. **项目探查**：读取目标项目的 `package.json`、路由、页面、`Re*` 组件、Hooks、API 和样式；以源码事实为准。
 2. **能力路由**：运行 `scripts/match.py "需求" --json`，**仅**按输出中的 `load_files` 阅读 reference；禁止自行展开全部 `references/`。无 Python 时按下方能力组表手动匹配。
-3. **质量闸门**：代码完成后读取 `references/code-quality.md`，执行清单和项目命令；有设计 handoff 时完成交接检查（init → 改代码 → check exit 0）。
+3. **质量闸门**：代码完成后读取 `references/code-quality.md`，执行清单和项目命令。
 
 ## 能力组路由
 
@@ -40,7 +41,7 @@ tags: [vue3, typescript, element-plus, pinia, vite, unocss, crud, demo, code-qua
 | `data-service` | HTTP、API、类型、mock、联调 | `http-api.md`、`api-check.md` |
 | `forms` | 表单、弹窗、远程选择、回显、字典、反馈 | `form-advanced.md`、`data-writeback.md`、`base-code-dict.md`、`feedback-loading.md` |
 | `access` | 权限、认证页面 | `permission-auth.md`、`auth-pages.md` |
-| `design-implementation` | 设计 handoff、主题、布局、组件样式 | `design-handoff.md`、`design-system.md`、`layout-theme.md` |
+| `theme-layout` | 布局、主题色、暗黑模式、侧栏配色、令牌 | `layout-theme.md` |
 | `shared-ui` | Re*、图标、通用展示和指令 | `ui-components.md`、`icons.md`、`feedback-ui.md`、`directives-advanced.md` |
 | `table-advanced` | 树表、VXE 表格 | `tree-table.md`、`table-vxe.md` |
 | `visualization` | 图表、大屏、关系图谱 | `chart-echarts.md`、`data-screen.md`、`graph-relation.md` |
@@ -48,6 +49,7 @@ tags: [vue3, typescript, element-plus, pinia, vite, unocss, crud, demo, code-qua
 | `files-and-editors` | 附件、预览、下载、富文本、二维码 | `file-management.md`、`download-export.md`、`rich-text.md`、`qrcode-barcode.md` |
 | `realtime-and-mobile` | WebSocket、移动端、微信、验证码、动效 | 对应专项 reference |
 | `data-compare` | 编辑页变更对比和汇总 | `data-compare.md` |
+| `design-apply` | 设计变更集落地：语义 ID 三级匹配、结构/形态/两层样式转换、L3 新模块、合规闸门 | `design-apply.md`、`mapping/`、`parser/` |
 
 ## 工作流
 
@@ -55,7 +57,7 @@ tags: [vue3, typescript, element-plus, pinia, vite, unocss, crud, demo, code-qua
 
 - 确认目标项目根目录；没有明确目标时先询问，不在技能仓库里写业务代码。
 - 判断是 Demo 验证、功能增量还是正式业务开发。
-- 判断是否有设计稿或 `design-handoff/v1` JSON。没有时保留目标项目当前初始化视觉；有时按设计要求落地，不让开发技能自行设计。
+- 保留目标项目当前初始化视觉，不让开发技能自行设计。
 
 ### 2. 读取事实
 
@@ -72,20 +74,13 @@ tags: [vue3, typescript, element-plus, pinia, vite, unocss, crud, demo, code-qua
 - Demo 可以最小化数据和接口，但目录、类型、命名和组件边界要能承接后续开发。
 - 新依赖先检查目标项目；缺失时说明精确版本、原因和构建接线，确认后再安装。
 - 只有目标项目确实存在排除项、占位插件或缺失接线时，才读取 `addon-enable.md` 恢复配置。
+- **输入为设计变更集时**：不走常规闭环，改走 `design-apply.md` 协议——变更集是设计技能（project-ui-design）的中立产出（设计侧不感知下游），本 Skill 是统一获取与执行方；parser 匹配出施工坐标后按「结构先行、样式两层转换」落地，并过变更集合规闸门。
 
-### 4. 设计交接
-
-- 发现 `$schema: design-handoff/v1` 后，读取 `references/design-handoff.md`。
-- 动手前初始化 handoff session；设计决定视觉、结构和交互意图，本技能只负责映射到真实模板并保留业务逻辑。
-- 只修改 handoff 明确覆盖的文件和页面；不为通过检查虚构修改、不强制全项目遍历。
-- 项目级视觉改造只有在用户明确要求时才执行；单页 Demo 默认只处理当前页面及必要共享组件。
-
-### 5. 验证与交付
+### 4. 验证与交付
 
 - 对照 `references/code-quality.md` 检查类型、组件复用、API、路由、权限、安全、异常反馈、响应式和可演进性。
 - 在目标项目执行 `pnpm lint:fix`、`pnpm type-check`；改动构建配置时再执行 `pnpm build`。
-- 有 handoff 时：落地前 init session，完成后 handoff check（`--require-session`）须 **exit 0** 才能声称设计落地完成。
-- 最终说明：命中能力组、修改文件、功能验证、设计落地范围、命令结果、未解决问题和下一步。
+- 最终说明：命中能力组、修改文件、功能验证、命令结果、未解决问题和下一步。
 
 ## 项目事实优先级
 
@@ -97,7 +92,7 @@ tags: [vue3, typescript, element-plus, pinia, vite, unocss, crud, demo, code-qua
 - 不二次挂载 `Layout`，不把模板演示页原样当业务页面。
 - 不使用裸 `v-if` 代替权限指令，不使用不可信 `v-html`。
 - 不为了视觉效果引入未经确认的新 UI 框架或图表库。
-- 不把 lint 通过当成业务闭环完成，也不把 handoff 文件修改数量当成设计质量证明。
+- 不把 lint 通过当成业务闭环完成。
 
 ## 最终回复格式
 
@@ -110,7 +105,6 @@ tags: [vue3, typescript, element-plus, pinia, vite, unocss, crud, demo, code-qua
 
 ## 验证结果
 - 功能：...
-- 设计交接：未涉及 | 已按 handoff 落地 ...
 - `pnpm lint:fix`：通过 | 失败（原因）
 - `pnpm type-check`：通过 | 失败（原因）
 - 待确认：...

package/bin/cli.js

@@ -18,23 +18,21 @@
  *   npx @qilitt-mickey/vue3-temp-skill@latest update
  */
 
-const fs = require("fs");
-const path = require("path");
-const os = require("os");
-const { execFileSync, execSync } = require("child_process");
+import fs from "node:fs";
+import path from "node:path";
+import os from "node:os";
+import { execFileSync, execSync } from "node:child_process";
+import { fileURLToPath } from "node:url";
 
 const HOME = os.homedir();
 // bin/cli.js → 上一级即包根目录
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
 const SKILL_DIR = path.resolve(__dirname, "..");
 const SKILL_NAME = "vue3-temp-skill";
 const TRACK_FILE = path.join(HOME, ".vue3-temp-skill.json");
 // 只复制 AI 运行时真正需要的文件；validate/check/cli 属于作者侧工具，不随技能分发
-const RUNTIME_SCRIPT_FILES = ["match.py", "modules.json", "handoff.mjs"];
-
-// ============================================================
-// 版本
-// ============================================================
-const PKG_VERSION = require(path.join(SKILL_DIR, "package.json")).version;
+const RUNTIME_SCRIPT_FILES = ["match.py", "modules.json"];
+const PKG_VERSION = JSON.parse(fs.readFileSync(path.join(SKILL_DIR, "package.json"), "utf-8")).version;
 
 // ============================================================
 // AI 工具配置
@@ -130,14 +128,16 @@ function copyFile(src, dest) {
 
 /**
  * 复制目录（仅用于 references/ 等已知安全的小目录）
+ * @param {string[]} [skipDirs] 需要排除的子目录名（不随分发，如 fixtures 作者侧回归数据）
  */
-function copyDir(src, dest) {
+function copyDir(src, dest, skipDirs = []) {
   ensureDir(dest);
   for (const entry of fs.readdirSync(src, { withFileTypes: true })) {
     if (entry.name.startsWith(".") || entry.isSymbolicLink()) continue;
+    if (entry.isDirectory() && skipDirs.includes(entry.name)) continue;
     const s = path.join(src, entry.name);
     const d = path.join(dest, entry.name);
-    if (entry.isDirectory()) copyDir(s, d);
+    if (entry.isDirectory()) copyDir(s, d, skipDirs);
     else fs.copyFileSync(s, d);
   }
 }
@@ -262,6 +262,13 @@ function installSkills(targetKey, projectDir) {
     }
   }
 
+  // design-apply 能力组依赖：mapping/ 词典 + parser/ 解析器（变更集落地的运行时依赖）
+  // parser/fixtures/ 为作者侧回归夹具（A-H 八步测试数据），不随技能分发，保留在仓库
+  for (const runtimeDir of ["mapping", "parser"]) {
+    const src = path.join(SKILL_DIR, runtimeDir);
+    if (fs.existsSync(src)) copyDir(src, path.join(dest, runtimeDir), ["fixtures"]);
+  }
+
   // Cursor：清理旧版 rules/*.mdc，避免与 skills 重复
   if (cfg.legacyRulesFile) {
     const legacy = cfg.legacyRulesFile(projectDir);
@@ -348,8 +355,6 @@ ${bold("命令:")}
   update [target]     更新已安装的技能（默认更新全部已安装目标）
   uninstall [target]  卸载技能（默认卸载全部已安装目标）
   list                查看已安装的目标和版本
-  handoff init        校验 handoff JSON 规格，在用户级目录建立会话（不污染业务项目）
-  handoff check       确认目标项目存在设计落地所需的关键接线
 
 ${bold("目标 (target):")}
   cursor       → Cursor          ~/.cursor/skills/
@@ -382,10 +387,6 @@ ${bold("示例:")}
 
   ${dim("# 查看已安装情况")}
   npx @qilitt-mickey/vue3-temp-skill list
-
-  ${dim("# 设计交接（在业务项目根目录执行）")}
-  npx @qilitt-mickey/vue3-temp-skill handoff init --project ./my-app --file C:/temp/handoff.json
-  npx @qilitt-mickey/vue3-temp-skill handoff check --project ./my-app --require-session
 `);
 }
 
@@ -605,36 +606,6 @@ function cmdList() {
   }
 }
 
-function cmdHandoff(sub, args, projectDir) {
-  const proj = projectDir || process.cwd();
-  const fileIdx = args.indexOf("--file");
-  const handoffFile = fileIdx !== -1 ? path.resolve(args[fileIdx + 1]) : null;
-  const stateDirIdx = args.indexOf("--state-dir");
-  const stateDir = stateDirIdx !== -1 ? path.resolve(args[stateDirIdx + 1]) : null;
-  const requireSession = args.includes("--require-session");
-  const scriptDir = path.join(SKILL_DIR, "scripts");
-
-  if (sub !== "init" && sub !== "check") {
-    console.error(red("✗ handoff 子命令: init | check"));
-    console.error(dim("  handoff init  --project <dir> --file <handoff.json> [--state-dir <dir>]"));
-    console.error(dim("  handoff check --project <dir> [--state-dir <dir>] [--require-session]"));
-    console.error(dim("  默认状态目录见 README.md「设计落地」"));
-    process.exit(1);
-  }
-
-  const script = path.join(scriptDir, "handoff.mjs");
-  const childArgs = [script, sub, "--project", proj];
-  if (sub === "init" && handoffFile) childArgs.push("--file", handoffFile);
-  if (stateDir) childArgs.push("--state-dir", stateDir);
-  if (sub === "check" && requireSession) childArgs.push("--require-session");
-
-  try {
-    execFileSync(process.execPath, childArgs, { stdio: "inherit" });
-  } catch (e) {
-    process.exit(e.status ?? 1);
-  }
-}
-
 // ============================================================
 // 入口
 // ============================================================
@@ -670,9 +641,6 @@ function main() {
     case "list":
       cmdList();
       break;
-    case "handoff":
-      cmdHandoff(target, args.slice(2), projectDir);
-      break;
     default:
       // 兼容旧用法：直接传 target 名当作 install
       if (TARGETS[command] || command === "all") {

package/dist/mapping-type.d.ts

@@ -0,0 +1,33 @@
+// AUTO-GENERATED by vue3-temp-skill parser/generator.js — DO NOT EDIT
+
+/** 语义 ID 映射条目（结构与 mapping/scenes/**.json 条目一致） */
+export interface SemanticMappingEntry {
+  type: 'module' | 'component' | 'element' | 'global_component' | 'global_token';
+  selector?: string;
+  component?: string;
+  file?: string;
+  style_scope: string;
+  default_props?: Record<string, unknown>;
+  children?: string[];
+  forms?: Record<string, string>;
+  visible_prop?: string;
+  css_vars?: Record<string, string>;
+  custom_style_map?: Record<string, string>;
+  [key: string]: unknown;
+}
+
+/** 设计变更集（design.changeset/1.0 输入，兼容历史值 design-changeset/v1） */
+export interface DesignChangeset {
+  schema: 'design.changeset/1.0' | 'design-changeset/v1';
+  mapping_version?: string;
+  scene: string;
+  layout_type?: string;
+  global?: Record<string, Record<string, string | number>>;
+  changes: Array<{
+    id: string;
+    visible?: boolean;
+    position?: Record<string, string>;
+    form?: string;
+    style?: Record<string, string | number>;
+  }>;
+}

package/dist/theme-vars.js

@@ -0,0 +1,61 @@
+// AUTO-GENERATED by vue3-temp-skill parser/generator.js — DO NOT EDIT
+// 链路 A 运行时入口：themeVars + overrideMapping（业务级覆写，V3.1 §3.4.4.3）
+// 用法：import { themeVars, overrideMapping } from '@qilitt-mickey/vue3-temp-skill/dist/theme-vars.js';
+//       const custom = overrideMapping(themeVars, { color: { brandPrimary: '#ff6600' } });
+export const themeVars = {
+  brandPrimary: '',
+  brandHover: '',
+  brandActive: '',
+  successColor: '',
+  warningColor: '',
+  errorColor: '',
+  textPrimary: '',
+  textSecondary: '',
+  textTertiary: '',
+  textDisabled: '',
+  borderColor: '',
+  borderColorSecondary: '',
+  componentBg: '',
+  layoutBg: '',
+  primaryBg: '',
+  radiusSm: '4px',
+  radiusBase: '6px',
+  radiusLg: '8px',
+  dialogRadius: '10px',
+  switchRadius: '10px',
+  spaceUnit: '4px',
+  spacingSm: '8px',
+  spacingMd: '16px',
+  spacingLg: '24px',
+  contentPadding: '8px',
+  cardPadding: '24px',
+  controlPaddingX: '12px',
+  buttonPaddingX: '15px',
+  headerPaddingX: '16px',
+  fontFamily: '系统栈（PingFang SC / Microsoft YaHei 等）',
+  fontSizeSm: '12px',
+  fontSizeBase: '14px',
+  fontSizeLg: '16px',
+  fontSizeXl: '20px',
+  fontWeightRegular: '400',
+  fontWeightMedium: '500',
+  fontWeightSemibold: '600',
+  lineHeight: '1.5715',
+  bpMobile: '',
+  bpCollapse: '',
+  bpExpand: '',
+  unocssSm: '',
+  unocssMd: '',
+  unocssLg: '',
+  unocssXl: '',
+  headerHeight: '48px',
+  tabsHeight: '32px',
+  sidebarWidth: '208px',
+  sidebarCollapsedWidth: '64px',
+  sidebarCollapseBarHeight: '40px',
+  layoutFooterHeight: '48px',
+  tabsItemHeight: '46px',
+  menuItemHeight: '40px',
+};
+
+export { overrideMapping, overrideMappings } from '../parser/override.js';

package/dist/theme-vars.ts

@@ -0,0 +1,111 @@
+// AUTO-GENERATED by vue3-temp-skill parser/generator.js — DO NOT EDIT
+export const themeVars = {
+  /** --brand-primary */
+  /** --brand-hover */
+  /** --brand-active */
+  /** --success-color */
+  /** --warning-color */
+  /** --error-color */
+  /** --text-primary */
+  /** --text-secondary */
+  /** --text-tertiary */
+  /** --text-disabled */
+  /** --border-color */
+  /** --border-color-secondary */
+  /** --component-bg */
+  /** --layout-bg */
+  /** --primary-bg */
+  /** --radius-sm → --border-radius-sm 出厂 4px */
+  /** --radius-base → --border-radius-base 出厂 6px */
+  /** --radius-lg → --border-radius-lg 出厂 8px */
+  /** --dialog-border-radius 出厂 10px */
+  /** --switch-border-radius 出厂 10px */
+  /** --space-unit 出厂 4px */
+  /** --spacing-sm 出厂 8px */
+  /** --spacing-md 出厂 16px */
+  /** --spacing-lg 出厂 24px */
+  /** --layout-content-padding → --vts-margin 出厂 8px */
+  /** --card-padding → --vts-card-padding 出厂 24px */
+  /** --control-padding-x 出厂 12px */
+  /** --button-padding-x 出厂 15px */
+  /** --header-padding-x 出厂 16px */
+  /** --font-family → --el-font-family 出厂 系统栈（PingFang SC / Microsoft YaHei 等） */
+  /** --font-size-sm → --el-font-size-small 出厂 12px */
+  /** --font-size-base → --el-font-size-base 出厂 14px */
+  /** --font-size-lg → --el-font-size-large 出厂 16px */
+  /** --font-size-xl → --el-font-size-extra-large 出厂 20px */
+  /** --font-weight-regular → --el-font-weight-primary 出厂 400 */
+  /** --font-weight-medium 出厂 500 */
+  /** --font-weight-semibold 出厂 600 */
+  /** --line-height 出厂 1.5715 */
+  /** value token */
+  /** value token */
+  /** value token */
+  /** value token */
+  /** value token */
+  /** value token */
+  /** value token */
+  /** --header-height → --vts-bar-height 出厂 48px */
+  /** --tabs-height → --vts-tabs-height 出厂 32px */
+  /** --sidebar-width 出厂 208px */
+  /** --sidebar-collapsed-width 出厂 64px */
+  /** --sidebar-collapse-bar-height 出厂 40px */
+  /** --layout-footer-height 出厂 48px */
+  /** --tabs-item-height 出厂 46px */
+  /** --el-menu-item-height 出厂 40px */
+  brandPrimary: '' as string,
+  brandHover: '' as string,
+  brandActive: '' as string,
+  successColor: '' as string,
+  warningColor: '' as string,
+  errorColor: '' as string,
+  textPrimary: '' as string,
+  textSecondary: '' as string,
+  textTertiary: '' as string,
+  textDisabled: '' as string,
+  borderColor: '' as string,
+  borderColorSecondary: '' as string,
+  componentBg: '' as string,
+  layoutBg: '' as string,
+  primaryBg: '' as string,
+  radiusSm: '4px' as string,
+  radiusBase: '6px' as string,
+  radiusLg: '8px' as string,
+  dialogRadius: '10px' as string,
+  switchRadius: '10px' as string,
+  spaceUnit: '4px' as string,
+  spacingSm: '8px' as string,
+  spacingMd: '16px' as string,
+  spacingLg: '24px' as string,
+  contentPadding: '8px' as string,
+  cardPadding: '24px' as string,
+  controlPaddingX: '12px' as string,
+  buttonPaddingX: '15px' as string,
+  headerPaddingX: '16px' as string,
+  fontFamily: '系统栈（PingFang SC / Microsoft YaHei 等）' as string,
+  fontSizeSm: '12px' as string,
+  fontSizeBase: '14px' as string,
+  fontSizeLg: '16px' as string,
+  fontSizeXl: '20px' as string,
+  fontWeightRegular: '400' as string,
+  fontWeightMedium: '500' as string,
+  fontWeightSemibold: '600' as string,
+  lineHeight: '1.5715' as string,
+  bpMobile: '' as string,
+  bpCollapse: '' as string,
+  bpExpand: '' as string,
+  unocssSm: '' as string,
+  unocssMd: '' as string,
+  unocssLg: '' as string,
+  unocssXl: '' as string,
+  headerHeight: '48px' as string,
+  tabsHeight: '32px' as string,
+  sidebarWidth: '208px' as string,
+  sidebarCollapsedWidth: '64px' as string,
+  sidebarCollapseBarHeight: '40px' as string,
+  layoutFooterHeight: '48px' as string,
+  tabsItemHeight: '46px' as string,
+  menuItemHeight: '40px' as string,
+} as const;
+
+export type ThemeVarKey = keyof typeof themeVars;

package/dist/theme.css

@@ -0,0 +1,72 @@
+/* AUTO-GENERATED by vue3-temp-skill parser/generator.js — DO NOT EDIT */
+/* 链路 A（基线注入）产物：全局令牌变量基线（V3.1 §4.5.3）。
+ * 仅空白新项目从零接入 Skill 主题体系时在样式入口引入一次；
+ * 成熟模板项目（自有 design-tokens.scss 权威令牌源）不得引入，避免双令牌源冲突。 */
+:root {
+  /* brand_primary → --brand-primary（无出厂值，需项目侧定值） */
+  /* brand_hover → --brand-hover（无出厂值，需项目侧定值） */
+  /* brand_active → --brand-active（无出厂值，需项目侧定值） */
+  /* success_color → --success-color（无出厂值，需项目侧定值） */
+  /* warning_color → --warning-color（无出厂值，需项目侧定值） */
+  /* error_color → --error-color（无出厂值，需项目侧定值） */
+  /* text_primary → --text-primary（无出厂值，需项目侧定值） */
+  /* text_secondary → --text-secondary（无出厂值，需项目侧定值） */
+  /* text_tertiary → --text-tertiary（无出厂值，需项目侧定值） */
+  /* text_disabled → --text-disabled（无出厂值，需项目侧定值） */
+  /* border_color → --border-color（无出厂值，需项目侧定值） */
+  /* border_color_secondary → --border-color-secondary（无出厂值，需项目侧定值） */
+  /* component_bg → --component-bg（无出厂值，需项目侧定值） */
+  /* layout_bg → --layout-bg（无出厂值，需项目侧定值） */
+  /* primary_bg → --primary-bg（无出厂值，需项目侧定值） */
+  --radius-sm: 4px; /* ← radius_sm */
+  --border-radius-sm: 4px; /* ← radius_sm */
+  --radius-base: 6px; /* ← radius_base */
+  --border-radius-base: 6px; /* ← radius_base */
+  --radius-lg: 8px; /* ← radius_lg */
+  --border-radius-lg: 8px; /* ← radius_lg */
+  --dialog-border-radius: 10px; /* ← dialog_radius */
+  --switch-border-radius: 10px; /* ← switch_radius */
+  --space-unit: 4px; /* ← space_unit */
+  --spacing-sm: 8px; /* ← spacing_sm */
+  --spacing-md: 16px; /* ← spacing_md */
+  --spacing-lg: 24px; /* ← spacing_lg */
+  --layout-content-padding: 8px; /* ← content_padding */
+  --vts-margin: 8px; /* ← content_padding */
+  --card-padding: 24px; /* ← card_padding */
+  --vts-card-padding: 24px; /* ← card_padding */
+  --control-padding-x: 12px; /* ← control_padding_x */
+  --button-padding-x: 15px; /* ← button_padding_x */
+  --header-padding-x: 16px; /* ← header_padding_x */
+  --font-family: 系统栈（PingFang SC / Microsoft YaHei 等）; /* ← font_family */
+  --el-font-family: 系统栈（PingFang SC / Microsoft YaHei 等）; /* ← font_family */
+  --font-size-sm: 12px; /* ← font_size_sm */
+  --el-font-size-small: 12px; /* ← font_size_sm */
+  --font-size-base: 14px; /* ← font_size_base */
+  --el-font-size-base: 14px; /* ← font_size_base */
+  --font-size-lg: 16px; /* ← font_size_lg */
+  --el-font-size-large: 16px; /* ← font_size_lg */
+  --font-size-xl: 20px; /* ← font_size_xl */
+  --el-font-size-extra-large: 20px; /* ← font_size_xl */
+  --font-weight-regular: 400; /* ← font_weight_regular */
+  --el-font-weight-primary: 400; /* ← font_weight_regular */
+  --font-weight-medium: 500; /* ← font_weight_medium */
+  --font-weight-semibold: 600; /* ← font_weight_semibold */
+  --line-height: 1.5715; /* ← line_height */
+  /* bp_mobile → (value token)（无出厂值，需项目侧定值） */
+  /* bp_collapse → (value token)（无出厂值，需项目侧定值） */
+  /* bp_expand → (value token)（无出厂值，需项目侧定值） */
+  /* unocss_sm → (value token)（无出厂值，需项目侧定值） */
+  /* unocss_md → (value token)（无出厂值，需项目侧定值） */
+  /* unocss_lg → (value token)（无出厂值，需项目侧定值） */
+  /* unocss_xl → (value token)（无出厂值，需项目侧定值） */
+  --header-height: 48px; /* ← header_height */
+  --vts-bar-height: 48px; /* ← header_height */
+  --tabs-height: 32px; /* ← tabs_height */
+  --vts-tabs-height: 32px; /* ← tabs_height */
+  --sidebar-width: 208px; /* ← sidebar_width */
+  --sidebar-collapsed-width: 64px; /* ← sidebar_collapsed_width */
+  --sidebar-collapse-bar-height: 40px; /* ← sidebar_collapse_bar_height */
+  --layout-footer-height: 48px; /* ← layout_footer_height */
+  --tabs-item-height: 46px; /* ← tabs_item_height */
+  --el-menu-item-height: 40px; /* ← menu_item_height */
+}

package/mapping/basic/color.json

@@ -0,0 +1,34 @@
+{
+  "$comment": "全局原子层 · 基础色彩令牌映射。abstract_field 为设计侧抽象样式字段名（纯视觉语义）；token 为项目侧实现令牌（design-tokens.scss :root 或 EP 官方变量）；design_range 为设计侧可选值域说明。由 vue3-temp-skill mapping 体系维护，禁止业务项目修改。",
+  "meta": {
+    "layer": "basic",
+    "domain": "color",
+    "version": "1.0.0",
+    "scene": "global",
+    "tech_stack": "vue3 + element-plus + vue3-web-temp"
+  },
+  "tokens": {
+    "brand_primary": { "token": "--brand-primary", "type": "color", "desc": "品牌主色" },
+    "brand_hover": { "token": "--brand-hover", "type": "color", "desc": "品牌悬停色" },
+    "brand_active": { "token": "--brand-active", "type": "color", "desc": "品牌激活色" },
+    "success_color": { "token": "--success-color", "type": "color", "desc": "成功功能色" },
+    "warning_color": { "token": "--warning-color", "type": "color", "desc": "警告功能色" },
+    "error_color": { "token": "--error-color", "type": "color", "desc": "错误功能色" },
+    "text_primary": { "token": "--text-primary", "type": "color", "desc": "主文字色" },
+    "text_secondary": { "token": "--text-secondary", "type": "color", "desc": "次文字色" },
+    "text_tertiary": { "token": "--text-tertiary", "type": "color", "desc": "三级文字色" },
+    "text_disabled": { "token": "--text-disabled", "type": "color", "desc": "禁用文字色" },
+    "border_color": { "token": "--border-color", "type": "color", "desc": "主边框色" },
+    "border_color_secondary": { "token": "--border-color-secondary", "type": "color", "desc": "次边框色" },
+    "component_bg": { "token": "--component-bg", "type": "color", "desc": "组件面background（卡片/弹层底色）" },
+    "layout_bg": { "token": "--layout-bg", "type": "color", "desc": "页面布局背景" },
+    "primary_bg": { "token": "--primary-bg", "type": "color", "desc": "主色浅底（自动 color-mix 派生，一般不直改）" }
+  },
+  "el_bridge": {
+    "$comment": "EP 官方变量桥接关系（只读说明）：--brand-primary 等经 design-tokens.scss 自动桥接至 --el-color-primary/--el-bg-color/--el-text-color-* 等，设计侧无需输出 --el-* 字段。",
+    "brand_primary_to_el": "--el-color-primary",
+    "component_bg_to_el": "--el-bg-color",
+    "layout_bg_to_el": "--el-bg-color-page",
+    "text_primary_to_el": "--el-text-color-primary"
+  }
+}

package/mapping/basic/radius.json

@@ -0,0 +1,17 @@
+{
+  "$comment": "全局原子层 · 圆角令牌映射。radius 为设计侧抽象字段；token 为项目实现令牌（design-tokens.scss :root，并桥接 EP --el-border-radius-*）。",
+  "meta": {
+    "layer": "basic",
+    "domain": "radius",
+    "version": "1.0.0",
+    "scene": "global",
+    "tech_stack": "vue3 + element-plus + vue3-web-temp"
+  },
+  "tokens": {
+    "radius_sm": { "token": "--radius-sm → --border-radius-sm", "type": "size", "default": "4px", "desc": "小控件圆角（Tag/小按钮）", "el_bridge": "--el-border-radius-small" },
+    "radius_base": { "token": "--radius-base → --border-radius-base", "type": "size", "default": "6px", "desc": "标准控件圆角（按钮/输入框）", "el_bridge": "--el-border-radius-base" },
+    "radius_lg": { "token": "--radius-lg → --border-radius-lg", "type": "size", "default": "8px", "desc": "卡片级圆角", "el_bridge": null },
+    "dialog_radius": { "token": "--dialog-border-radius", "type": "size", "default": "10px", "desc": "弹窗圆角（出厂 ReDialog 观感）", "el_bridge": null },
+    "switch_radius": { "token": "--switch-border-radius", "type": "size", "default": "10px", "desc": "开关圆角", "el_bridge": null }
+  }
+}