@teamix-evo/skills 0.5.0 → 0.6.0

package/src/teamix-evo-design-opentrek/rules/design-tokens.json

@@ -0,0 +1,2798 @@
+{
+  "version": "7.8.5",
+  "description": "设计 Token 规范 v7.8.5（teamix-evo 对齐版）。锁定 TrekClaw v4.1 CSS 变量（HSL 三元组格式）作为底层唯一真相源，颜色 token 命名已迁移为 teamix-evo `--color-*` 前缀（对齐 `@teamix-evo/tokens/variants/opentrek/theme.css` 的 Tailwind v4 @theme 命名）。非颜色 token（spacing / radius / font / shadow / duration / z-index）保持原命名，已与 teamix-evo 一致。legacy 别名（gray-title / gray-bg / data-1–10 / *-aura 等，详见同目录 token-mapping.md）保留原名作为 TODO，待 teamix-evo 后续版本补齐。v7.8.5 变更：Shadow 分区注释同步 v4.1 源的 ContentCard surface 完整说明块（去掉 1px border + 使用 var(--shadow-sm)）。",
+  "source": {
+    "path": "../../design token进展/4.1/迭代/design-tokens.css",
+    "docPath": "../../design token进展/4.1/迭代/OP-DesignTokens-V5.md",
+    "format": "HSL 三元组（不含 hsl() 包裹），使用方式：hsl(var(--color-token-name))。注意：运行时 @teamix-evo/tokens 的 theme.css 采用 hsl() 包裹后的值格式，实际使用时依赖 Tailwind v4 utility 或 var(--color-*)不需手动 hsl() 包裹；本文件作为 Skill 参考文档保持 TrekClaw 原始 HSL 三元组以便 AI 查询 token 原始色值。",
+    "lastSynced": "2026-06-10",
+    "cssDelivery": {
+      "path": "rules/design-tokens.css",
+      "generatedFrom": "本文件（design-tokens.json）",
+      "generateCommand": "node design-spec/scripts/generate-tokens-css.mjs",
+      "validateCommand": "node design-spec/scripts/validate-json-source.mjs",
+      "instruction": "design-tokens.css 为运行时产物，由 JSON 自动生成，禁止手动编辑。生成 HTML 时，将 design-tokens.css 中 :root 块内的全部 CSS 变量定义嵌入页面 <style> 标签；生成 React/TSX 组件时，确保项目已通过 @import 引入该 CSS 文件",
+      "htmlMode": "inline in <style> tag",
+      "reactMode": "@import './styles/design-tokens.css' in index.css"
+    }
+  },
+  "cssGeneration": {
+    "fileHeader": "TrekClaw Design Tokens — v4.1\n源：OP Design Tokens v4.1（tokens-v4.json）\n品牌主色：#0055EE（深蓝 218.6°）\nHSL 格式（不含 hsl() 包裹），使用方式：hsl(var(--token-name))\n更新时间：2026-05-15",
+    "wrapper": "@layer base",
+    "sections": [
+      {
+        "id": "brand",
+        "comment": "Brand / 主色（#0055EE 深蓝，真实色相 218.6°）\n实测 #0055EE 的 HSL ≈ hsl(218.6, 100%, 46.7%)，以实际色值为准。",
+        "vars": [
+          "--color-primary",
+          "--color-primary-foreground",
+          "--color-primary-hover",
+          "--color-primary-pressed",
+          "--color-primary-glow"
+        ]
+      },
+      {
+        "id": "accent",
+        "comment": "Accent / 辅助色（MasterGuide 提取）\n用途：UI 强调色、图标、标签、次要操作\n排序：蓝 → 紫 → 杏 → 靛 → 绿 → 洋红 → 青 → 橙 → 莓 → 橄榄",
+        "vars": [
+          "--color-accent-blue",
+          "--color-accent-violet",
+          "--color-accent-apricot",
+          "--color-accent-indigo",
+          "--color-accent-green",
+          "--color-accent-magenta",
+          "--color-accent-turquoise",
+          "--color-accent-orange",
+          "--color-accent-berry",
+          "--color-accent-olive"
+        ]
+      },
+      {
+        "id": "gray",
+        "comment": "Gray / 灰色完整色阶（v7.4 重构 — 合并整合 + 反白色新增）\n色相统一冷灰调（210°/216°/218°/220°），8 级语义分层",
+        "vars": [
+          "--color-gray-primary",
+          "--color-gray-primary-foreground",
+          "--color-gray-secondary-foreground",
+          "--color-muted-foreground",
+          "--color-gray-disabled",
+          "--color-gray-line",
+          "--color-gray-sidebar-accent",
+          "--color-gray-muted",
+          "--color-gray-white"
+        ]
+      },
+      {
+        "id": "gray-legacy",
+        "comment": "Legacy 别名（保留兼容旧引用，不新增使用）",
+        "vars": [
+          "--gray-title",
+          "--gray-secondary",
+          "--gray-tertiary",
+          "--gray-border",
+          "--gray-fill",
+          "--gray-bg-dark",
+          "--gray-bg"
+        ]
+      },
+      {
+        "id": "semantic",
+        "comment": "语义映射（shadcn 标准）",
+        "vars": [
+          "--color-foreground",
+          "--page-title",
+          "--color-border",
+          "--color-input",
+          "--color-ring"
+        ]
+      },
+      {
+        "id": "background",
+        "comment": "Background",
+        "vars": [
+          "--color-background",
+          "--color-background-dark",
+          "--color-background-panel",
+          "--background-end"
+        ]
+      },
+      {
+        "id": "card-popover",
+        "comment": "Card / Popover / Secondary / Accent",
+        "vars": [
+          "--color-card",
+          "--color-card-foreground",
+          "--color-popover",
+          "--color-popover-foreground",
+          "--color-secondary",
+          "--color-secondary-foreground",
+          "--color-muted",
+          "--color-accent",
+          "--color-accent-foreground"
+        ]
+      },
+      {
+        "id": "success",
+        "comment": "Success / 成功色（#16A34A，Tailwind green-600）",
+        "vars": [
+          "--color-success",
+          "--color-success-foreground",
+          "--color-success-hover",
+          "--color-success-pressed",
+          "--color-success-bg",
+          "--color-success-border",
+          "--success-dark",
+          "--success-medium",
+          "--success-light",
+          "--success-aura"
+        ]
+      },
+      {
+        "id": "destructive",
+        "comment": "Destructive / 警示色（#DC2626，Tailwind red-600）",
+        "vars": [
+          "--color-destructive",
+          "--color-destructive-foreground",
+          "--color-destructive-hover",
+          "--color-destructive-pressed",
+          "--color-destructive-bg",
+          "--color-destructive-border",
+          "--destructive-dark",
+          "--destructive-light",
+          "--destructive-aura"
+        ]
+      },
+      {
+        "id": "warning",
+        "comment": "Warning / 提醒色（#D97706，Tailwind amber-600）",
+        "vars": [
+          "--color-warning",
+          "--color-warning-foreground",
+          "--color-warning-hover",
+          "--color-warning-pressed",
+          "--color-warning-bg",
+          "--color-warning-border",
+          "--warning-dark",
+          "--warning-light",
+          "--warning-aura"
+        ]
+      },
+      {
+        "id": "info",
+        "comment": "Info / 信息提示色（#2563EB，Tailwind blue-600）",
+        "vars": [
+          "--color-info",
+          "--color-info-foreground",
+          "--color-info-hover",
+          "--color-info-pressed",
+          "--color-info-bg",
+          "--color-info-border",
+          "--color-info-light",
+          "--info-aura"
+        ]
+      },
+      {
+        "id": "chart",
+        "comment": "图表用色 — 10 色标准组合（MasterGuide 提取）",
+        "vars": [
+          "--color-chart-1",
+          "--color-chart-2",
+          "--color-chart-3",
+          "--color-chart-4",
+          "--color-chart-5",
+          "--color-chart-6",
+          "--color-chart-7",
+          "--color-chart-8",
+          "--color-chart-9",
+          "--color-chart-10"
+        ]
+      },
+      {
+        "id": "chart-legacy",
+        "comment": "Legacy 别名（兼容 --data-* 旧命名）",
+        "vars": [
+          "--data-1",
+          "--data-2",
+          "--data-3",
+          "--data-4",
+          "--data-5",
+          "--data-6",
+          "--data-7",
+          "--data-8",
+          "--data-9",
+          "--data-10"
+        ]
+      },
+      {
+        "id": "topbar-sidebar",
+        "comment": "顶栏 / 侧边栏",
+        "vars": [
+          "--color-topbar",
+          "--color-topbar-foreground",
+          "--color-topbar-divider",
+          "--topbar-height",
+          "--color-sidebar",
+          "--color-sidebar-foreground",
+          "--color-sidebar-active",
+          "--color-sidebar-active-foreground",
+          "--color-sidebar-hover",
+          "--color-sidebar-title",
+          "--color-sidebar-group",
+          "--color-sidebar-item",
+          "--color-sidebar-item-muted",
+          "--color-sidebar-accent",
+          "--color-sidebar-accent-foreground",
+          "--color-sidebar-border",
+          "--color-sidebar-ring",
+          "--color-sidebar-primary",
+          "--color-sidebar-primary-foreground",
+          "--color-avatar-bg"
+        ]
+      },
+      {
+        "id": "sidebar-collapsed",
+        "comment": "Sidebar Collapsed State",
+        "vars": [
+          "--sidebar-collapsed-width",
+          "--sidebar-menu-item-height",
+          "--sidebar-menu-item-size-collapsed",
+          "--sidebar-menu-item-gap-collapsed",
+          "--sidebar-header-padding-collapsed",
+          "--sidebar-footer-padding-collapsed",
+          "--sidebar-flyout-z-index",
+          "--sidebar-flyout-min-width",
+          "--sidebar-flyout-item-height",
+          "--sidebar-centered-axis",
+          "--sidebar-expand-icon-size"
+        ]
+      },
+      {
+        "id": "type-identifier",
+        "comment": "类型标识 - API / MCP",
+        "vars": [
+          "--color-type-api",
+          "--color-type-api-light",
+          "--color-type-api-border",
+          "--color-type-mcp",
+          "--color-type-mcp-light",
+          "--color-type-mcp-border"
+        ]
+      },
+      {
+        "id": "status",
+        "comment": "状态指示点",
+        "vars": [
+          "--color-status-running",
+          "--color-status-stopped",
+          "--color-status-error"
+        ]
+      },
+      {
+        "id": "terminal",
+        "comment": "终端 / 代码块",
+        "vars": [
+          "--color-terminal",
+          "--color-terminal-foreground"
+        ]
+      },
+      {
+        "id": "font-family",
+        "comment": "Font Family / 字体族（v7.8.4 新增）\nbody 必须使用 var(--font-sans)，代码片段使用 var(--font-mono)\n禁止在页面中硬编码 font-family 堆栈",
+        "vars": [
+          "--font-sans",
+          "--font-mono"
+        ]
+      },
+      {
+        "id": "typography",
+        "comment": "Typography / 字号等级（v4 规则）\nbase=12 / lg=14 / xl=16 / 2xl=18",
+        "vars": [
+          "--font-size-base",
+          "--font-size-lg",
+          "--font-size-xl",
+          "--font-size-2xl",
+          "--font-size-page-header",
+          "--font-weight-normal",
+          "--font-weight-medium",
+          "--font-weight-black",
+          "--line-height-input",
+          "--line-height-normal",
+          "--line-height-dialog-title",
+          "--letter-spacing-tight",
+          "--letter-spacing-normal"
+        ]
+      },
+      {
+        "id": "spacing",
+        "comment": "间距（v4 保留项目原值：button-gap=8 / card-gap=16 / page-container-*）",
+        "vars": [
+          "--gap-xs",
+          "--btn-padding-x",
+          "--btn-padding-x-sm",
+          "--button-gap",
+          "--tabs-gap",
+          "--card-gap",
+          "--page-container-gap",
+          "--page-container-padding",
+          "--page-container-padding-left",
+          "--card-padding-x"
+        ]
+      },
+      {
+        "id": "layout-frame",
+        "comment": "Layout Frame Width",
+        "vars": [
+          "--layout-sidebar-width"
+        ]
+      },
+      {
+        "id": "table-cell",
+        "comment": "Table Cell Padding (v7.5 三层模型)",
+        "vars": [
+          "--table-cell-padding-x",
+          "--table-first-cell-padding-left",
+          "--table-last-cell-padding-right"
+        ]
+      },
+      {
+        "id": "card-grid",
+        "comment": "CardGrid 列宽预设 (v7.2 新增，业务卡片页 minWidth token 化)",
+        "vars": [
+          "--card-grid-min-compact",
+          "--card-grid-min-standard",
+          "--card-grid-min-comfortable",
+          "--card-grid-min-feature"
+        ]
+      },
+      {
+        "id": "page-header",
+        "comment": "Page Header",
+        "vars": [
+          "--page-header-height",
+          "--breadcrumb-height"
+        ]
+      },
+      {
+        "id": "action-toolbar",
+        "comment": "ActionToolbar",
+        "vars": [
+          "--action-toolbar-search-combo-gap"
+        ]
+      },
+      {
+        "id": "radius",
+        "comment": "圆角（v4 更新）\nsm=4 / md=8 / lg=12 / xl=16 / full=9999\ndrawer-radius 已移除",
+        "vars": [
+          "--radius",
+          "--radius-sm",
+          "--radius-md",
+          "--radius-lg",
+          "--radius-xl",
+          "--radius-full",
+          "--card-radius",
+          "--input-radius"
+        ]
+      },
+      {
+        "id": "input",
+        "comment": "Input / 输入框",
+        "vars": [
+          "--input-height",
+          "--input-font-size",
+          "--text-font-size",
+          "--input-line-height",
+          "--input-padding-x",
+          "--input-padding-y",
+          "--color-input-placeholder",
+          "--input-icon-size"
+        ]
+      },
+      {
+        "id": "dialog",
+        "comment": "Dialog / 弹窗",
+        "vars": [
+          "--dialog-width-s",
+          "--dialog-width-m",
+          "--dialog-width-l",
+          "--dialog-width-xl",
+          "--dialog-header-height",
+          "--dialog-footer-height",
+          "--dialog-body-padding-x",
+          "--dialog-body-padding-y",
+          "--shadow-dialog"
+        ]
+      },
+      {
+        "id": "drawer",
+        "comment": "Drawer / 抽屉",
+        "vars": [
+          "--drawer-width-s",
+          "--drawer-width-m",
+          "--drawer-width-l",
+          "--drawer-width-xl"
+        ]
+      },
+      {
+        "id": "shadow",
+        "comment": "Shadow / 阴影等级（v4 新增；v7.6 补充 ContentCard surface 规则）\n----------------------------------------\nv7.6 内容区大卡片容器（ContentCard / G-C024 作为白卡容器使用时）表面规则：\n- 去掉 1px solid border（不使用 --color-gray-line 边框）\n- 使用最弱阴影 var(--shadow-sm) = 0 1px 2px rgba(0,0,0,0.05)\n详见 design-tokens.json · shadowMapping",
+        "vars": [
+          "--shadow-none",
+          "--shadow-sm",
+          "--shadow-DEFAULT",
+          "--shadow-md",
+          "--shadow-lg",
+          "--shadow-xl",
+          "--shadow-2xl",
+          "--shadow-dialog",
+          "--shadow-select-content"
+        ]
+      },
+      {
+        "id": "animation",
+        "comment": "Animation / 动画（v4 新增）",
+        "vars": [
+          "--duration-fast",
+          "--duration-normal",
+          "--duration-slow",
+          "--duration-slower",
+          "--easing-linear",
+          "--easing-ease",
+          "--easing-ease-in",
+          "--easing-ease-out",
+          "--easing-ease-in-out"
+        ]
+      },
+      {
+        "id": "z-index",
+        "comment": "Z-index 层级",
+        "vars": [
+          "--z-base",
+          "--z-dropdown",
+          "--z-sticky",
+          "--z-overlay",
+          "--z-modal",
+          "--z-tooltip"
+        ]
+      },
+      {
+        "id": "form",
+        "comment": "Form Layout / 表单布局",
+        "vars": [
+          "--form-label-width",
+          "--form-control-max-width",
+          "--form-row-gap",
+          "--form-row-padding-y",
+          "--form-description-font-size",
+          "--form-required-indicator-margin-left"
+        ]
+      },
+      {
+        "id": "pagination",
+        "comment": "Pagination / 分页",
+        "vars": [
+          "--pagination-button-size",
+          "--pagination-arrow-icon-size",
+          "--pagination-ellipsis-icon-size",
+          "--button-sm-height"
+        ]
+      },
+      {
+        "id": "stepper",
+        "comment": "Stepper / 步进器",
+        "vars": [
+          "--stepper-button-width",
+          "--stepper-button-height",
+          "--stepper-input-width",
+          "--stepper-input-height"
+        ]
+      }
+    ]
+  },
+  "grayScale": {
+    "description": "灰色完整色阶（v7.4 重构）。色相统一冷灰调（210°/216°/218°/220°），8 级语义分层。重要变更：--gray-border + --color-gray-line 合并为单一 --color-gray-line；--gray-bg-dark + --gray-bg + --gray-fill 合并为 --color-gray-muted；--gray-tertiary 重命名为 --color-muted-foreground；--gray-title 归并到 --color-gray-primary；新增 --color-gray-primary-foreground 与 --color-gray-sidebar-accent。旧变量以 Legacy 别名形式保留，指向新色。使用方式：hsl(var(--gray-*))。",
+    "palette": {
+      "--color-gray-primary": {
+        "hsl": "220 9% 7%",
+        "hex": "#101113",
+        "usage": "主要文字、大标题、sidebar 激活文字、顶部导航背景"
+      },
+      "--color-gray-primary-foreground": {
+        "hsl": "210 33% 99%",
+        "hex": "#FBFCFD",
+        "usage": "主题反白色 / 侧边栏反白文字色"
+      },
+      "--color-gray-secondary-foreground": {
+        "hsl": "216 4% 26%",
+        "hex": "#414346",
+        "usage": "次要文字颜色"
+      },
+      "--color-muted-foreground": {
+        "hsl": "216 2% 45%",
+        "hex": "#717376",
+        "usage": "弱化文字色（替代旧 --gray-tertiary）"
+      },
+      "--color-gray-disabled": {
+        "hsl": "210 3% 63%",
+        "hex": "#9DA0A3",
+        "usage": "禁用文字颜色、输入框激活态"
+      },
+      "--color-gray-line": {
+        "hsl": "210 9% 91%",
+        "hex": "#E6E8EA",
+        "usage": "描边色、分割线、卡片边框（合并旧 --gray-border + --color-gray-line）"
+      },
+      "--color-gray-sidebar-accent": {
+        "hsl": "210 12% 93%",
+        "hex": "#ECEEF0",
+        "usage": "sidebar 激活态背景"
+      },
+      "--color-gray-muted": {
+        "hsl": "220 18% 97%",
+        "hex": "#F5F6F8",
+        "usage": "表单禁用态色、目录激活背景色、表头颜色、页面背景、消息填充（合并旧 --gray-bg-dark + --gray-bg + --gray-fill）"
+      },
+      "--color-gray-white": {
+        "hsl": "0 0% 100%",
+        "hex": "#FFFFFF",
+        "usage": "纯白"
+      }
+    },
+    "legacyAliases": {
+      "description": "保留兼容旧变量名，新页面不得使用。迁移完成后可在后续版本移除。",
+      "--gray-title": {
+        "alias": "--color-gray-primary",
+        "hsl": "220 9% 7%",
+        "hex": "#101113"
+      },
+      "--gray-secondary": {
+        "alias": "--color-gray-secondary-foreground",
+        "hsl": "216 4% 26%",
+        "hex": "#414346"
+      },
+      "--gray-tertiary": {
+        "alias": "--color-muted-foreground",
+        "hsl": "216 2% 45%",
+        "hex": "#717376"
+      },
+      "--gray-border": {
+        "alias": "--color-gray-line",
+        "hsl": "210 9% 91%",
+        "hex": "#E6E8EA"
+      },
+      "--gray-fill": {
+        "alias": "--color-gray-muted",
+        "hsl": "220 18% 97%",
+        "hex": "#F5F6F8"
+      },
+      "--gray-bg-dark": {
+        "alias": "--color-gray-muted",
+        "hsl": "220 18% 97%",
+        "hex": "#F5F6F8"
+      },
+      "--gray-bg": {
+        "alias": "--color-gray-muted",
+        "hsl": "220 18% 97%",
+        "hex": "#F5F6F8"
+      }
+    }
+  },
+  "colorMapping": {
+    "description": "语义色名 → TrekClaw CSS 变量映射。生成/翻新页面时必须使用 CSS 变量引用，禁止硬编码色值（F1）。",
+    "primary": {
+      "var": "--color-primary",
+      "fallback": "#0055EE",
+      "hsl": "218.6 100% 46.7%",
+      "usage": "主按钮、链接、选中态、聚焦态边框、行动点、高亮"
+    },
+    "primaryForeground": {
+      "var": "--color-primary-foreground",
+      "fallback": "#FFFFFF",
+      "usage": "主色上的前景文字",
+      "hsl": "0 0% 100%"
+    },
+    "primaryHover": {
+      "var": "--color-primary-hover",
+      "fallback": "#004CD6",
+      "hsl": "218.6 100% 42%",
+      "usage": "主按钮 hover 态"
+    },
+    "primaryPressed": {
+      "var": "--color-primary-pressed",
+      "fallback": "#0044BF",
+      "hsl": "218.6 100% 37.5%",
+      "usage": "主按钮 pressed 态"
+    },
+    "success": {
+      "var": "--color-success",
+      "fallback": "#16A34A",
+      "usage": "成功状态、运行中、已开通",
+      "hsl": "142 76% 36%"
+    },
+    "successForeground": {
+      "var": "--color-success-foreground",
+      "fallback": "#FFFFFF",
+      "usage": "成功色上的前景文字",
+      "hsl": "0 0% 100%"
+    },
+    "successHover": {
+      "var": "--color-success-hover",
+      "fallback": "#15803D",
+      "usage": "成功按钮 hover 态",
+      "hsl": "142 72% 29%"
+    },
+    "successBg": {
+      "var": "--color-success-bg",
+      "fallback": "#ECFDF5",
+      "usage": "成功状态背景",
+      "hsl": "152 82% 96%"
+    },
+    "successBorder": {
+      "var": "--color-success-border",
+      "fallback": "#86EFAC",
+      "usage": "成功状态边框",
+      "hsl": "142 77% 73%"
+    },
+    "warning": {
+      "var": "--color-warning",
+      "fallback": "#D97706",
+      "hsl": "40 88% 48%",
+      "usage": "警告状态、创建中、停止中"
+    },
+    "warningForeground": {
+      "var": "--color-warning-foreground",
+      "fallback": "#FFFFFF",
+      "usage": "警告色上的前景文字",
+      "hsl": "0 0% 100%"
+    },
+    "warningHover": {
+      "var": "--color-warning-hover",
+      "fallback": "#B45309",
+      "usage": "警告按钮 hover 态",
+      "hsl": "38 85% 40%"
+    },
+    "warningBg": {
+      "var": "--color-warning-bg",
+      "fallback": "#FFF3DB",
+      "usage": "警告状态背景",
+      "hsl": "43 100% 94%"
+    },
+    "warningBorder": {
+      "var": "--color-warning-border",
+      "fallback": "#FBBF24",
+      "usage": "警告状态边框",
+      "hsl": "40 92% 68%"
+    },
+    "destructive": {
+      "var": "--color-destructive",
+      "fallback": "#DC2626",
+      "usage": "错误状态、已停止、失败、删除操作",
+      "hsl": "0 72% 51%"
+    },
+    "destructiveForeground": {
+      "var": "--color-destructive-foreground",
+      "fallback": "#FFFFFF",
+      "usage": "警示色上的前景文字",
+      "hsl": "0 0% 100%"
+    },
+    "destructiveHover": {
+      "var": "--color-destructive-hover",
+      "fallback": "#B91C1C",
+      "usage": "destructive 按钮 hover 态",
+      "hsl": "0 74% 42%"
+    },
+    "destructiveBg": {
+      "var": "--color-destructive-bg",
+      "fallback": "#FEF2F2",
+      "usage": "错误状态背景",
+      "hsl": "0 86% 97%"
+    },
+    "destructiveBorder": {
+      "var": "--color-destructive-border",
+      "fallback": "#FCA5A5",
+      "usage": "错误状态边框",
+      "hsl": "0 93% 82%"
+    },
+    "info": {
+      "var": "--color-info",
+      "fallback": "#2563EB",
+      "usage": "信息提示、异步操作中",
+      "hsl": "221 83% 53%"
+    },
+    "infoForeground": {
+      "var": "--color-info-foreground",
+      "fallback": "#FFFFFF",
+      "usage": "信息色上的前景文字",
+      "hsl": "0 0% 100%"
+    },
+    "infoBg": {
+      "var": "--color-info-bg",
+      "fallback": "#EFF6FF",
+      "usage": "信息状态背景",
+      "hsl": "214 100% 97%"
+    },
+    "infoBorder": {
+      "var": "--color-info-border",
+      "fallback": "#93C5FD",
+      "usage": "信息状态边框",
+      "hsl": "212 96% 78%"
+    },
+    "muted": {
+      "var": "--color-muted-foreground",
+      "fallback": "#717376",
+      "usage": "弱化文字、辅助文字、标签、提示文字、不可用操作",
+      "hsl": "216 2% 45%"
+    },
+    "textPlaceholder": {
+      "var": "--color-input-placeholder",
+      "fallback": "#AAAAAA",
+      "usage": "占位符、不可用文字",
+      "hsl": "0 0% 66.7%"
+    },
+    "textPrimary": {
+      "var": "--color-gray-primary",
+      "fallback": "#101113",
+      "usage": "主要文字、正文、按钮文字、大标题（v7.4 起合并 textTitle）",
+      "hsl": "220 9% 7%"
+    },
+    "textPrimaryForeground": {
+      "var": "--color-gray-primary-foreground",
+      "fallback": "#FBFCFD",
+      "usage": "主题反白色 / 侧边栏反白文字色",
+      "hsl": "210 33% 99%"
+    },
+    "textPageTitle": {
+      "var": "--color-gray-primary",
+      "fallback": "#101113",
+      "usage": "PageHeader 标题专用色（v7.4 起 → --color-gray-primary）",
+      "hsl": "220 9% 7%"
+    },
+    "textTitle": {
+      "var": "--color-gray-primary",
+      "fallback": "#101113",
+      "usage": "页面标题、弹窗标题、导航背景（v7.4 起 → --color-gray-primary）",
+      "hsl": "220 9% 7%"
+    },
+    "textSecondary": {
+      "var": "--color-gray-secondary-foreground",
+      "fallback": "#414346",
+      "usage": "次要文字、常态页码、描述文字",
+      "hsl": "216 4% 26%"
+    },
+    "textDisabled": {
+      "var": "--color-gray-disabled",
+      "fallback": "#9DA0A3",
+      "usage": "禁用态文字、分组标签文字、输入框激活态",
+      "hsl": "210 3% 63%"
+    },
+    "background": {
+      "var": "--color-background",
+      "hsl": "220 18% 97%",
+      "fallback": "#F5F6F8",
+      "usage": "页面级背景",
+      "note": "页面背景色与 sidebar 背景色保持一致（v7.4 起 → --color-gray-muted）"
+    },
+    "card": {
+      "var": "--color-card",
+      "fallback": "#FFFFFF",
+      "usage": "卡片与弹窗背景、输入框背景",
+      "hsl": "0 0% 100%"
+    },
+    "pageBackground": {
+      "var": "--color-background",
+      "hsl": "220 18% 97%",
+      "fallback": "#F5F6F8",
+      "usage": "页面级背景",
+      "note": "页面背景色与 sidebar 背景色保持一致"
+    },
+    "border": {
+      "var": "--color-gray-line",
+      "fallback": "#E6E8EA",
+      "usage": "表单输入框边框、描边色（v7.4 起合并旧 --gray-border + --color-gray-line → --color-gray-line）",
+      "hsl": "210 9% 91%"
+    },
+    "borderLight": {
+      "var": "--color-gray-line",
+      "fallback": "#E6E8EA",
+      "usage": "卡片边框、分割线、outline 按钮边框",
+      "hsl": "210 9% 91%"
+    },
+    "borderFocus": {
+      "var": "--color-primary",
+      "fallback": "#0035F5",
+      "usage": "Focus 环、输入框聚焦态边框",
+      "hsl": "218.6 100% 46.7%"
+    },
+    "subtle": {
+      "var": "--color-gray-muted",
+      "hsl": "220 18% 97%",
+      "fallback": "#F5F6F8",
+      "usage": "消息填充、hover 背景、导航按钮（v7.4 起 → --color-gray-muted）"
+    },
+    "subtleDark": {
+      "var": "--color-gray-muted",
+      "hsl": "220 18% 97%",
+      "fallback": "#F5F6F8",
+      "usage": "表单禁用背景、输入框 disabled 态（v7.4 起 → --color-gray-muted）"
+    },
+    "sidebarAccent": {
+      "var": "--color-gray-sidebar-accent",
+      "hsl": "210 12% 93%",
+      "fallback": "#ECEEF0",
+      "usage": "sidebar 激活态背景（v7.4 新增，实际使用请参考 sidebarRules.colors.menuItem.active）"
+    },
+    "white": {
+      "var": "--color-gray-white",
+      "hsl": "0 0% 100%",
+      "fallback": "#FFFFFF",
+      "usage": "纯白背景，如批量操作栏、对话框背景"
+    },
+    "rowHover": {
+      "$ref": "#/colorMapping/subtle",
+      "usage": "表格行 hover 背景"
+    },
+    "rowSelected": {
+      "$ref": "#/colorMapping/subtle",
+      "usage": "表格行 selected 背景"
+    },
+    "tableHeader": {
+      "var": "--color-gray-muted",
+      "hsl": "220 18% 97%",
+      "fallback": "#F5F6F8",
+      "usage": "表头背景色",
+      "note": "v7.4 起 --color-gray-muted 与 --color-background、--color-sidebar 保持一致（220 18% 97%）= #F5F6F8"
+    },
+    "bulkActionBarBg": {
+      "value": "#ffffff",
+      "usage": "批量操作栏背景色（纯白）"
+    },
+    "selected": {
+      "var": "--color-sidebar-accent",
+      "fallback": "#F6FAFF",
+      "usage": "表格行选中背景（sidebar 选中态用 --color-sidebar-active，见 sidebarRules.colors.menuItem.active）",
+      "hsl": "210 12% 93%"
+    },
+    "sidebarBg": {
+      "var": "--color-sidebar",
+      "fallback": "#F5F6F8",
+      "usage": "侧边栏背景色（v7.4 起 → --color-gray-muted）",
+      "hsl": "220 18% 97%"
+    },
+    "sidebarForeground": {
+      "var": "--color-sidebar-foreground",
+      "fallback": "#101113",
+      "usage": "侧边栏默认文字色（v7.4 起 → --color-gray-primary）",
+      "hsl": "220 9% 7%"
+    },
+    "sidebarActiveBg": {
+      "var": "--color-sidebar-active",
+      "fallback": "#ECEEF0",
+      "usage": "侧边栏激活态背景色（v7.4 起 → --color-gray-sidebar-accent）",
+      "hsl": "210 12% 93%"
+    },
+    "sidebarActiveFg": {
+      "var": "--color-sidebar-active-foreground",
+      "fallback": "#101113",
+      "usage": "侧边栏激活态文字色（v7.4 起 → --color-gray-primary）",
+      "hsl": "220 9% 7%"
+    },
+    "sidebarHoverBg": {
+      "var": "--color-sidebar-hover",
+      "fallback": "#F5F6F8",
+      "usage": "侧边栏菜单项 hover 背景色（v7.4 起 → --color-gray-muted）",
+      "hsl": "220 18% 97%"
+    },
+    "sidebarTitle": {
+      "var": "--color-sidebar-title",
+      "fallback": "#101113",
+      "usage": "侧边栏标题文字色（v7.4 起 → --color-gray-primary）",
+      "hsl": "220 9% 7%"
+    },
+    "sidebarGroup": {
+      "var": "--color-sidebar-group",
+      "fallback": "#717376",
+      "usage": "侧边栏分组标题文字色（v7.4 起 → --color-muted-foreground）",
+      "hsl": "216 2% 45%"
+    },
+    "sidebarItem": {
+      "var": "--color-sidebar-item",
+      "fallback": "#101113",
+      "usage": "侧边栏菜单项文字色（v7.4 起 → --color-gray-primary）",
+      "hsl": "220 9% 7%"
+    },
+    "sidebarItemMuted": {
+      "var": "--color-sidebar-item-muted",
+      "fallback": "#414346",
+      "usage": "侧边栏次要菜单项文字色（v7.4 起 → --color-gray-secondary-foreground）",
+      "hsl": "216 4% 26%"
+    },
+    "sidebarAccentLegacy": {
+      "var": "--color-sidebar-accent",
+      "fallback": "#ECEEF0",
+      "usage": "shadcn 语义侧边栏强调背景色（v7.4 起与 --color-gray-sidebar-accent 同色）",
+      "hsl": "210 12% 93%"
+    },
+    "sidebarAccentFg": {
+      "var": "--color-sidebar-accent-foreground",
+      "fallback": "#0055EE",
+      "usage": "侧边栏强调文字色（= primary）",
+      "hsl": "218.6 100% 46.7%"
+    },
+    "sidebarBorder": {
+      "var": "--color-sidebar-border",
+      "fallback": "#E6E8EA",
+      "usage": "侧边栏内部分隔线（菜单组间/折叠态边框），v7.4 起 → --color-gray-line；侧边栏容器禁止右侧外边框（详见 sidebarRules.colors.container.border: none）",
+      "hsl": "210 9% 91%"
+    },
+    "sidebarRing": {
+      "var": "--color-sidebar-ring",
+      "fallback": "#0055EE",
+      "usage": "侧边栏焦点环（= primary）",
+      "hsl": "218.6 100% 46.7%"
+    },
+    "sidebarPrimary": {
+      "var": "--color-sidebar-primary",
+      "fallback": "#0055EE",
+      "usage": "侧边栏主色（= primary）",
+      "hsl": "218.6 100% 46.7%"
+    },
+    "sidebarPrimaryFg": {
+      "var": "--color-sidebar-primary-foreground",
+      "fallback": "#FFFFFF",
+      "usage": "侧边栏主色上的文字（白色）",
+      "hsl": "0 0% 100%"
+    },
+    "topbarBg": {
+      "var": "--color-topbar",
+      "fallback": "#141414",
+      "usage": "顶栏背景色",
+      "hsl": "0 0% 7.8%"
+    },
+    "topbarForeground": {
+      "var": "--color-topbar-foreground",
+      "fallback": "#FFFFFF",
+      "usage": "顶栏文字色",
+      "hsl": "0 0% 100%"
+    },
+    "topbarDivider": {
+      "var": "--color-topbar-divider",
+      "fallback": "#4D4D4D",
+      "usage": "顶栏分割线",
+      "hsl": "0 0% 30.2%"
+    },
+    "accent": {
+      "var": "--color-accent",
+      "hsl": "220 18% 97%",
+      "fallback": "#F5F6F8",
+      "usage": "shadcn accent 高亮（→ --color-gray-muted）"
+    },
+    "accentForeground": {
+      "var": "--color-accent-foreground",
+      "hsl": "220 9% 7%",
+      "fallback": "#101113",
+      "usage": "shadcn accent 上的前景文字（→ --color-gray-primary）"
+    },
+    "foreground": {
+      "var": "--color-foreground",
+      "hsl": "220 9% 7%",
+      "fallback": "#101113",
+      "usage": "shadcn 主前景文字（→ --color-gray-primary）"
+    },
+    "pageTitle": {
+      "var": "--page-title",
+      "hsl": "220 9% 7%",
+      "fallback": "#101113",
+      "usage": "页面标题色（v7.4 起合并 → --color-gray-primary）"
+    },
+    "inputBorder": {
+      "var": "--color-input",
+      "hsl": "210 9% 91%",
+      "fallback": "#E6E8EA",
+      "usage": "shadcn input 边框色（→ --color-gray-line）"
+    },
+    "ring": {
+      "var": "--color-ring",
+      "hsl": "218.6 100% 46.7%",
+      "fallback": "#0055EE",
+      "usage": "shadcn focus ring（→ --color-primary）"
+    },
+    "cardForeground": {
+      "var": "--color-card-foreground",
+      "hsl": "220 9% 7%",
+      "fallback": "#101113",
+      "usage": "卡片上的前景文字（→ --color-gray-primary）"
+    },
+    "popover": {
+      "var": "--color-popover",
+      "hsl": "0 0% 100%",
+      "fallback": "#FFFFFF",
+      "usage": "浮层（Popover/Dropdown）背景"
+    },
+    "popoverForeground": {
+      "var": "--color-popover-foreground",
+      "hsl": "220 9% 7%",
+      "fallback": "#101113",
+      "usage": "浮层文字色（→ --color-gray-primary）"
+    },
+    "secondary": {
+      "var": "--color-secondary",
+      "hsl": "220 18% 97%",
+      "fallback": "#F5F6F8",
+      "usage": "shadcn secondary 背景（→ --color-gray-muted）"
+    },
+    "secondaryForeground": {
+      "var": "--color-secondary-foreground",
+      "hsl": "220 9% 7%",
+      "fallback": "#101113",
+      "usage": "shadcn secondary 文字（→ --color-gray-primary）"
+    },
+    "mutedSurface": {
+      "var": "--color-muted",
+      "hsl": "220 18% 97%",
+      "fallback": "#F5F6F8",
+      "usage": "shadcn muted 背景（→ --color-gray-muted），区别于 --color-muted-foreground 文字色"
+    },
+    "primaryGlow": {
+      "var": "--color-primary-glow",
+      "hsl": "226.9 100% 68.6%",
+      "fallback": "#5F82FF",
+      "usage": "主色光晕 / 渐变起始（sidebar Gradient）"
+    },
+    "backgroundDark": {
+      "var": "--color-background-dark",
+      "hsl": "216 42.9% 93.1%",
+      "fallback": "#E6ECF5",
+      "usage": "导航经过色（legacy）"
+    },
+    "backgroundEnd": {
+      "var": "--background-end",
+      "hsl": "220 18% 97%",
+      "fallback": "#F5F6F8",
+      "usage": "页面背景渐变结束色（与 --color-background 一致）"
+    },
+    "backgroundPanel": {
+      "var": "--color-background-panel",
+      "hsl": "220 27.3% 97.8%",
+      "fallback": "#F8F9FB",
+      "usage": "画布配置面板背景"
+    },
+    "legacyGrayAliases": {
+      "description": "Legacy 灰色别名（保留兼容旧引用，不新增使用）。映射到 v7.4 重构后的统一灰色变量。",
+      "grayTitle": {
+        "var": "--gray-title",
+        "hsl": "220 9% 7%",
+        "fallback": "#101113",
+        "usage": "→ --color-gray-primary"
+      },
+      "graySecondary": {
+        "var": "--gray-secondary",
+        "hsl": "216 4% 26%",
+        "fallback": "#414346",
+        "usage": "→ --color-gray-secondary-foreground"
+      },
+      "grayTertiary": {
+        "var": "--gray-tertiary",
+        "hsl": "216 2% 45%",
+        "fallback": "#717376",
+        "usage": "→ --color-muted-foreground"
+      },
+      "grayBorder": {
+        "var": "--gray-border",
+        "hsl": "210 9% 91%",
+        "fallback": "#E6E8EA",
+        "usage": "→ --color-gray-line"
+      },
+      "grayFill": {
+        "var": "--gray-fill",
+        "hsl": "220 18% 97%",
+        "fallback": "#F5F6F8",
+        "usage": "→ --color-gray-muted"
+      },
+      "grayBgDark": {
+        "var": "--gray-bg-dark",
+        "hsl": "220 18% 97%",
+        "fallback": "#F5F6F8",
+        "usage": "→ --color-gray-muted"
+      },
+      "grayBg": {
+        "var": "--gray-bg",
+        "hsl": "220 18% 97%",
+        "fallback": "#F5F6F8",
+        "usage": "→ --color-gray-muted"
+      }
+    },
+    "legacyStatusAliases": {
+      "description": "Legacy 状态色别名 / 衍生态（保留兼容旧引用）。",
+      "successDark": {
+        "var": "--success-dark",
+        "hsl": "142 72% 29%",
+        "fallback": "#15803D",
+        "usage": "→ --color-success-hover"
+      },
+      "successMedium": {
+        "var": "--success-medium",
+        "hsl": "142 77% 73%",
+        "fallback": "#86EFAC",
+        "usage": "→ --color-success-border"
+      },
+      "successLight": {
+        "var": "--success-light",
+        "hsl": "152 82% 96%",
+        "fallback": "#ECFDF5",
+        "usage": "→ --color-success-bg"
+      },
+      "successPressed": {
+        "var": "--color-success-pressed",
+        "hsl": "143 60% 24%",
+        "fallback": "#166534",
+        "usage": "成功按钮 pressed 态"
+      },
+      "successAura": {
+        "var": "--success-aura",
+        "rawValue": "0 0 8px rgba(22, 163, 74, 0.25)",
+        "usage": "成功色光晕（box-shadow 用）"
+      },
+      "destructiveDark": {
+        "var": "--destructive-dark",
+        "hsl": "0 74% 42%",
+        "fallback": "#B91C1C",
+        "usage": "→ --color-destructive-hover"
+      },
+      "destructiveLight": {
+        "var": "--destructive-light",
+        "hsl": "0 86% 97%",
+        "fallback": "#FEF2F2",
+        "usage": "→ --color-destructive-bg"
+      },
+      "destructivePressed": {
+        "var": "--color-destructive-pressed",
+        "hsl": "0 70% 35%",
+        "fallback": "#991B1B",
+        "usage": "警示按钮 pressed 态"
+      },
+      "destructiveAura": {
+        "var": "--destructive-aura",
+        "rawValue": "0 0 8px rgba(220, 38, 38, 0.25)",
+        "usage": "警示色光晕（box-shadow 用）"
+      },
+      "warningDark": {
+        "var": "--warning-dark",
+        "hsl": "38 85% 40%",
+        "fallback": "#B45309",
+        "usage": "→ --color-warning-hover"
+      },
+      "warningLight": {
+        "var": "--warning-light",
+        "hsl": "43 100% 94%",
+        "fallback": "#FFF3DB",
+        "usage": "→ --color-warning-bg"
+      },
+      "warningPressed": {
+        "var": "--color-warning-pressed",
+        "hsl": "35 78% 34%",
+        "fallback": "#92400E",
+        "usage": "警告按钮 pressed 态"
+      },
+      "warningAura": {
+        "var": "--warning-aura",
+        "rawValue": "0 0 8px rgba(217, 119, 6, 0.25)",
+        "usage": "警告色光晕（box-shadow 用）"
+      },
+      "infoHover": {
+        "var": "--color-info-hover",
+        "hsl": "224 76% 48%",
+        "fallback": "#1D4ED8",
+        "usage": "信息按钮 hover 态"
+      },
+      "infoPressed": {
+        "var": "--color-info-pressed",
+        "hsl": "226 71% 40%",
+        "fallback": "#1E40AF",
+        "usage": "信息按钮 pressed 态"
+      },
+      "infoLight": {
+        "var": "--color-info-light",
+        "hsl": "213 100% 98.2%",
+        "fallback": "#F6FAFF",
+        "usage": "信息浅色背景（与 sidebar gradient 联动）"
+      },
+      "infoAura": {
+        "var": "--info-aura",
+        "rawValue": "0 0 8px rgba(37, 99, 235, 0.25)",
+        "usage": "信息色光晕（box-shadow 用）"
+      }
+    },
+    "borderShadcn": {
+      "var": "--color-border",
+      "hsl": "210 9% 91%",
+      "fallback": "#E6E8EA",
+      "usage": "shadcn 标准边框 token（→ --color-gray-line），区别于 colorMapping.border 语义引用"
+    }
+  },
+  "glossy": {
+    "description": "TrekClaw 独有：Accent 辅助色 + 图表用 10 色。来源：OP-DesignTokens-V5.md A3/A14/A14。",
+    "accent10": {
+      "description": "10 色辅助强调色，用于图标、标签、次要操作。",
+      "blue": {
+        "var": "--color-accent-blue",
+        "fallback": "#5F99F9",
+        "hsl": "217.4 92.8% 67.5%"
+      },
+      "indigo": {
+        "var": "--color-accent-indigo",
+        "fallback": "#888BFF",
+        "hsl": "238.0 100% 76.7%"
+      },
+      "violet": {
+        "var": "--color-accent-violet",
+        "fallback": "#AB7BFF",
+        "hsl": "261.8 100% 74.1%"
+      },
+      "turquoise": {
+        "var": "--color-accent-turquoise",
+        "fallback": "#33AFA9",
+        "hsl": "186.1 98.9% 37.1%"
+      },
+      "magenta": {
+        "var": "--color-accent-magenta",
+        "fallback": "#DA62DF",
+        "hsl": "297.6 66.1% 62.9%"
+      },
+      "berry": {
+        "var": "--color-accent-berry",
+        "fallback": "#EE6590",
+        "hsl": "341.2 80.1% 66.5%"
+      },
+      "orange": {
+        "var": "--color-accent-orange",
+        "fallback": "#EF702C",
+        "hsl": "21.2 89.9% 64.9%"
+      },
+      "apricot": {
+        "var": "--color-accent-apricot",
+        "fallback": "#CF8A1C",
+        "hsl": "38.1 95.9% 62.0%"
+      },
+      "green": {
+        "var": "--color-accent-green",
+        "fallback": "#4CB36F",
+        "hsl": "140.2 43.7% 52.0%"
+      },
+      "olive": {
+        "var": "--color-accent-olive",
+        "fallback": "#7BAD30",
+        "hsl": "84.1 51.8% 52.0%"
+      }
+    },
+    "chart10": {
+      "1": {
+        "var": "--color-chart-1",
+        "fallback": "#6250F9",
+        "hsl": "246.4 93.4% 64.5%"
+      },
+      "2": {
+        "var": "--color-chart-2",
+        "fallback": "#33AFA9",
+        "hsl": "261.8 100% 74.1%"
+      },
+      "3": {
+        "var": "--color-chart-3",
+        "fallback": "#AE34B4",
+        "hsl": "297.3 56.9% 54.5%"
+      },
+      "4": {
+        "var": "--color-chart-4",
+        "fallback": "#5F99F9",
+        "hsl": "36.1 88.1% 57.1%"
+      },
+      "5": {
+        "var": "--color-chart-5",
+        "fallback": "#9C660D",
+        "hsl": "266.2 77.7% 57.8%"
+      },
+      "6": {
+        "var": "--color-chart-6",
+        "fallback": "#EE6590",
+        "hsl": "140.4 40.4% 50.0%"
+      },
+      "7": {
+        "var": "--color-chart-7",
+        "fallback": "#068580",
+        "hsl": "217.4 68.5% 51.4%"
+      },
+      "8": {
+        "var": "--color-chart-8",
+        "fallback": "#AB7BFF",
+        "hsl": "49.4 65.0% 42.5%"
+      },
+      "9": {
+        "var": "--color-chart-9",
+        "fallback": "#5A8219",
+        "hsl": "207.7 11.0% 53.7%"
+      },
+      "10": {
+        "var": "--color-chart-10",
+        "fallback": "#7C8A96",
+        "hsl": "341.2 80.1% 66.5%"
+      },
+      "description": "图表用 10 色标准组合，11/13 阶交替。"
+    },
+    "chartLegacyAliases": {
+      "1": {
+        "var": "--data-1",
+        "ref": "--color-chart-1",
+        "usage": "→ --color-chart-1"
+      },
+      "2": {
+        "var": "--data-2",
+        "ref": "--color-chart-2",
+        "usage": "→ --color-chart-2"
+      },
+      "3": {
+        "var": "--data-3",
+        "ref": "--color-chart-3",
+        "usage": "→ --color-chart-3"
+      },
+      "4": {
+        "var": "--data-4",
+        "ref": "--color-chart-4",
+        "usage": "→ --color-chart-4"
+      },
+      "5": {
+        "var": "--data-5",
+        "ref": "--color-chart-5",
+        "usage": "→ --color-chart-5"
+      },
+      "6": {
+        "var": "--data-6",
+        "ref": "--color-chart-6",
+        "usage": "→ --color-chart-6"
+      },
+      "7": {
+        "var": "--data-7",
+        "ref": "--color-chart-7",
+        "usage": "→ --color-chart-7"
+      },
+      "8": {
+        "var": "--data-8",
+        "ref": "--color-chart-8",
+        "usage": "→ --color-chart-8"
+      },
+      "9": {
+        "var": "--data-9",
+        "ref": "--color-chart-9",
+        "usage": "→ --color-chart-9"
+      },
+      "10": {
+        "var": "--data-10",
+        "ref": "--color-chart-10",
+        "usage": "→ --color-chart-10"
+      },
+      "description": "Legacy 别名（兼容 --data-* 旧命名）。CSS 端通过 var(--chart-N) 引用。"
+    }
+  },
+  "statusDot": {
+    "description": "状态圆点颜色映射，引用 colorMapping 的语义色。",
+    "mapping": [
+      {
+        "status": "运行中",
+        "semanticColor": "success",
+        "shape": "solid circle 8px"
+      },
+      {
+        "status": "已停止",
+        "semanticColor": "textDisabled",
+        "shape": "solid circle 8px"
+      },
+      {
+        "status": "创建中",
+        "semanticColor": "warning",
+        "shape": "solid circle 8px"
+      },
+      {
+        "status": "释放中",
+        "semanticColor": "destructive",
+        "shape": "solid circle 8px"
+      },
+      {
+        "status": "异步操作",
+        "semanticColor": "info",
+        "shape": "solid circle 8px + animate-pulse"
+      }
+    ]
+  },
+  "table": {
+    "description": "表格专属尺寸与布局 token（颜色引用 colorMapping）。",
+    "checkboxColWidth": "48px",
+    "actionColRightPadding": "8px",
+    "bulkActionBarBorder": "var(--color-border) top-only（仅上边框，无下边框）",
+    "cssVars": {
+      "description": "Table v7.5 三层模型 padding token。",
+      "cellPaddingX": {
+        "var": "--table-cell-padding-x",
+        "value": "12px",
+        "usage": "中间列 td 水平内边距"
+      },
+      "firstCellPaddingLeft": {
+        "var": "--table-first-cell-padding-left",
+        "value": "20px",
+        "usage": "首列 padding-left（额外缩进 20px）"
+      },
+      "lastCellPaddingRight": {
+        "var": "--table-last-cell-padding-right",
+        "value": "20px",
+        "usage": "末列 padding-right（额外缩进 20px）"
+      }
+    }
+  },
+  "navigation": {
+    "topNavHeight": "48px",
+    "topNavBackground": "固定值 #141414（非设计系统 token）",
+    "sidebarWidth": "240px",
+    "sidebarCollapsedWidth": "68px",
+    "tokens": {
+      "topbarHeight": {
+        "var": "--topbar-height",
+        "value": "48px",
+        "usage": "顶栏高度"
+      }
+    }
+  },
+  "shadowMapping": {
+    "description": "阴影等级映射，引用 TrekClaw CSS 变量。v7.6 补充 ContentCard 表面规则：内容区大卡片容器去掉 1px border，使用最弱阴影 sm。",
+    "none": {
+      "var": "--shadow-none",
+      "rawValue": "0 0 #0000",
+      "usage": "无阴影"
+    },
+    "sm": {
+      "var": "--shadow-sm",
+      "rawValue": "0 1px 2px rgba(0,0,0,0.05)",
+      "usage": "按钮、输入框微浮起；v7.6 起作为 ContentCard 白卡容器唯一阴影源（无边框方案的最弱阴影）"
+    },
+    "DEFAULT": {
+      "var": "--shadow-DEFAULT",
+      "rawValue": "0 1px 3px 0 rgb(0 0 0 / 0.1), 0 1px 2px -1px rgb(0 0 0 / 0.1)",
+      "usage": "卡片默认阴影（v7.6 起 ContentCard 不再使用，已转为 sm）"
+    },
+    "md": {
+      "var": "--shadow-md",
+      "rawValue": "0 4px 6px -1px rgb(0 0 0 / 0.1), 0 2px 4px -2px rgb(0 0 0 / 0.1)",
+      "usage": "卡片、面板、Dropdown"
+    },
+    "lg": {
+      "var": "--shadow-lg",
+      "rawValue": "0 10px 15px -3px rgb(0 0 0 / 0.1), 0 4px 6px -4px rgb(0 0 0 / 0.1)",
+      "usage": "Popover、Toast、右键菜单"
+    },
+    "xl": {
+      "var": "--shadow-xl",
+      "rawValue": "0 20px 25px -5px rgb(0 0 0 / 0.1), 0 8px 10px -6px rgb(0 0 0 / 0.1)",
+      "usage": "Dialog、Sheet、Command Palette"
+    },
+    "2xl": {
+      "var": "--shadow-2xl",
+      "rawValue": "0 25px 50px -12px rgba(0, 0, 0, 0.25)",
+      "usage": "顶层模态、全屏遮罩"
+    },
+    "dialog": {
+      "var": "--shadow-dialog",
+      "usage": "弹窗专属阴影",
+      "value": "0px 12px 48px 0px rgba(0, 0, 0, 0.2)"
+    },
+    "select": {
+      "var": "--shadow-select-content",
+      "rawValue": "0 6px 24px rgba(0,0,0,0.1)",
+      "usage": "Select 弹层阴影"
+    }
+  },
+  "radiusMapping": {
+    "description": "圆角映射，引用 TrekClaw CSS 变量。基准 --radius=16px。",
+    "sm": {
+      "var": "--radius-sm",
+      "value": "4px",
+      "usage": "Badge、Chip、Checkbox、select-item"
+    },
+    "md": {
+      "var": "--radius-md",
+      "value": "8px",
+      "usage": "按钮、输入框、Select trigger、Toggle capsule"
+    },
+    "lg": {
+      "var": "--radius-lg",
+      "value": "12px",
+      "usage": "卡片"
+    },
+    "xl": {
+      "var": "--radius-xl",
+      "value": "16px",
+      "usage": "对话框、大型容器（= --radius）"
+    },
+    "full": {
+      "var": "--radius-full",
+      "value": "9999px",
+      "usage": "完全圆形、药丸标签、Switch handle"
+    },
+    "legacyAliases": {
+      "description": "Legacy 圆角别名（v4 起映射到新圆角）。",
+      "cardRadius": {
+        "var": "--card-radius",
+        "value": "12px",
+        "usage": "→ --radius-lg（卡片圆角，原 8px 已升至 12px）"
+      },
+      "inputRadius": {
+        "var": "--input-radius",
+        "value": "8px",
+        "usage": "→ --radius-md（输入框圆角，原 6px 已升至 8px）"
+      }
+    },
+    "base": {
+      "var": "--radius",
+      "value": "1rem",
+      "usage": "全局基准圆角（= --radius-xl 16px，对话框/大型容器）"
+    }
+  },
+  "animationMapping": {
+    "description": "动画时长/缓动映射，引用 TrekClaw CSS 变量。",
+    "fast": {
+      "var": "--duration-fast",
+      "value": "150ms",
+      "usage": "微交互(hover/focus)"
+    },
+    "normal": {
+      "var": "--duration-normal",
+      "value": "200ms",
+      "usage": "常规过渡(Accordion/Tabs)"
+    },
+    "slow": {
+      "var": "--duration-slow",
+      "value": "300ms",
+      "usage": "面板滑入(Sheet/Dialog)"
+    },
+    "slower": {
+      "var": "--duration-slower",
+      "value": "500ms",
+      "usage": "大型展开动画"
+    },
+    "easing": {
+      "linear": {
+        "var": "--easing-linear",
+        "value": "cubic-bezier(0, 0, 1, 1)"
+      },
+      "ease": {
+        "var": "--easing-ease",
+        "value": "cubic-bezier(0.25, 0.1, 0.25, 1)"
+      },
+      "ease-in": {
+        "var": "--easing-ease-in",
+        "value": "cubic-bezier(0.4, 0, 1, 1)"
+      },
+      "ease-out": {
+        "var": "--easing-ease-out",
+        "value": "cubic-bezier(0, 0, 0.2, 1)"
+      },
+      "ease-in-out": {
+        "var": "--easing-ease-in-out",
+        "value": "cubic-bezier(0.4, 0, 0.2, 1)"
+      }
+    }
+  },
+  "zIndexMapping": {
+    "description": "层级映射，引用 TrekClaw CSS 变量。",
+    "base": {
+      "var": "--z-base",
+      "value": "0"
+    },
+    "dropdown": {
+      "var": "--z-dropdown",
+      "value": 50
+    },
+    "sticky": {
+      "var": "--z-sticky",
+      "value": 100
+    },
+    "overlay": {
+      "var": "--z-overlay",
+      "value": 200
+    },
+    "modal": {
+      "var": "--z-modal",
+      "value": 300
+    },
+    "tooltip": {
+      "var": "--z-tooltip",
+      "value": 500
+    }
+  },
+  "componentDimensions": {
+    "description": "组件精确尺寸。来源：TrekClaw v4.1 CSS + OP-DesignTokens-V5.md C 系列。",
+    "dialog": {
+      "widthS": {
+        "var": "--dialog-width-s",
+        "value": "400px",
+        "usage": "二次确认/极简字段"
+      },
+      "widthM": {
+        "var": "--dialog-width-m",
+        "value": "600px",
+        "usage": "常用弹窗"
+      },
+      "widthL": {
+        "var": "--dialog-width-l",
+        "value": "800px",
+        "usage": "宽表格"
+      },
+      "widthXL": {
+        "var": "--dialog-width-xl",
+        "value": "1000px",
+        "usage": "分栏/超复杂"
+      },
+      "headerHeight": {
+        "var": "--dialog-header-height",
+        "value": "46px"
+      },
+      "footerHeight": {
+        "var": "--dialog-footer-height",
+        "value": "64px"
+      },
+      "bodyPaddingX": {
+        "var": "--dialog-body-padding-x",
+        "value": "20px"
+      },
+      "bodyPaddingY": {
+        "var": "--dialog-body-padding-y",
+        "value": "16px"
+      },
+      "shadow": {
+        "var": "--shadow-dialog",
+        "value": "0px 12px 48px 0px rgba(0, 0, 0, 0.2)"
+      }
+    },
+    "drawer": {
+      "widthS": {
+        "var": "--drawer-width-s",
+        "value": "400px"
+      },
+      "widthM": {
+        "var": "--drawer-width-m",
+        "value": "600px"
+      },
+      "widthL": {
+        "var": "--drawer-width-l",
+        "value": "800px"
+      },
+      "widthXL": {
+        "var": "--drawer-width-xl",
+        "value": "1200px"
+      }
+    },
+    "input": {
+      "height": {
+        "var": "--input-height",
+        "value": "32px"
+      },
+      "fontSize": {
+        "var": "--input-font-size",
+        "value": "12px",
+        "note": "= --font-size-base"
+      },
+      "lineHeight": {
+        "var": "--input-line-height",
+        "value": "18px"
+      },
+      "paddingX": {
+        "var": "--input-padding-x",
+        "value": "8px"
+      },
+      "paddingY": {
+        "var": "--input-padding-y",
+        "value": "7px"
+      },
+      "iconSize": {
+        "var": "--input-icon-size",
+        "value": "16px"
+      },
+      "placeholder": {
+        "var": "--color-input-placeholder",
+        "fallback": "#AAAAAA",
+        "hsl": "0 0% 66.7%"
+      }
+    },
+    "layout": {
+      "sidebarWidth": {
+        "var": "--layout-sidebar-width",
+        "value": "240px"
+      }
+    }
+  },
+  "spacingTokens": {
+    "description": "全局间距体系。TrekClaw 双轨策略：非语义绑定用 Tailwind 标准刻度（4px 基准）；语义强绑定场景用 CSS 变量。详见 source.docPath Part A19。",
+    "tailwindScale": {
+      "0": "0px",
+      "1": "4px — 紧凑 padding（icon 与文字间距）",
+      "2": "8px — 表格单元格/Badge",
+      "3": "12px — Drawer/Dialog 区块之间",
+      "4": "16px — 卡片内边距",
+      "5": "20px — 卡片外间距",
+      "6": "24px — 白卡外间距 / 页面容器内边距",
+      "8": "32px — 组件高度基准",
+      "10": "40px — Tab list 高度 / 底部留白",
+      "12": "48px — 顶栏高度",
+      "14": "56px — Drawer header 高",
+      "16": "64px — 页头高度",
+      "20": "80px — 空态底部",
+      "24": "96px — 空态边距",
+      "32": "128px — Hero 区",
+      "description": "Tailwind 标准间距刻度，基准 4px。所有 padding/margin/gap 优先使用此类。",
+      "0.5": "2px — 极小密集（icon inset）",
+      "1.5": "6px — Badge/Chip 左右",
+      "2.5": "10px — 较紧凑容器",
+      "3.5": "14px — 中等 padding"
+    },
+    "semanticVariables": {
+      "description": "语义间距变量。仅用于语义强绑定场景（一处改动、全局同步）。",
+      "gap-xs": {
+        "var": "--gap-xs",
+        "value": "4px",
+        "tailwind": "1",
+        "usage": "Button 内部 icon↔文字间距"
+      },
+      "btn-padding-x": {
+        "var": "--btn-padding-x",
+        "value": "16px",
+        "tailwind": "4",
+        "usage": "按钮水平内边距（默认尺寸 height=32px）"
+      },
+      "btn-padding-x-sm": {
+        "var": "--btn-padding-x-sm",
+        "value": "12px",
+        "tailwind": "3",
+        "usage": "小号按钮水平内边距（卡片内操作等紧凑场景）"
+      },
+      "button-gap": {
+        "var": "--button-gap",
+        "value": "8px",
+        "tailwind": "2",
+        "usage": "操作栏按钮行/筛选器行/分页器间距"
+      },
+      "tabs-gap": {
+        "var": "--tabs-gap",
+        "value": "24px",
+        "tailwind": "6",
+        "usage": "Tabs 标签项之间的水平间距"
+      },
+      "card-gap": {
+        "var": "--card-gap",
+        "value": "16px",
+        "tailwind": "4",
+        "usage": "卡片网格间距/区块之间垂直间距"
+      },
+      "page-container-gap": {
+        "var": "--page-container-gap",
+        "value": "16px",
+        "tailwind": "4",
+        "usage": "白卡外间距同义别名（v7.5 由 20px → 16px）"
+      },
+      "page-container-padding": {
+        "var": "--page-container-padding",
+        "value": "16px",
+        "tailwind": "4",
+        "usage": "白卡外间距（上/右/下）/ PageContainer 内边距（top/right/bottom）（v7.5 由 20px → 16px）"
+      },
+      "page-container-padding-left": {
+        "var": "--page-container-padding-left",
+        "value": "0px",
+        "usage": "主内容区左边缘 → 白卡容器左边缘间距；sidebar 与内容区之间不预留间距，白卡紧贴 sidebar 右侧"
+      },
+      "card-padding-x": {
+        "var": "--card-padding-x",
+        "value": "20px",
+        "tailwind": "5",
+        "usage": "白卡容器（ContentCard）内部左右内边距（v7.5 由 24px → 20px）；Card 内所有子组件的唯一外侧呼吸来源。独立于 --page-container-padding（PageContainer 外层间距 16px），两者属不同设计层级，不可混用。"
+      }
+    },
+    "componentSpacing": {
+      "description": "Card 白卡容器内各元素间距规范。PageHeader/ActionToolbar/DataTable/Pagination 垂直排列在 Card 内，使用 gap 或 margin-bottom 控制间距。禁止使用 <hr> / section-divider / border 分割线分隔组件（通过 padding + margin 控制间距）。",
+      "Card.internalGap": "16px (= --card-gap, Card 白卡容器内各区块垂直间距)",
+      "Card.padding": "0 var(--card-padding-x) 【上下 0 / 左右 20px】；**稳定规则**：Card 白卡容器为 Card 内所有子组件提供唯一的左右内边距来源，子组件本身不再重复设置 paddingX。注意：--card-padding-x (20px) 独立于 --page-container-padding (16px)，后者为 PageContainer 外层间距。",
+      "Card.surface": {
+        "description": "【v7.6 表面规则】内容区大卡片容器（ContentCard 作为白卡容器使用时）去掉 1px solid border，改用最弱阴影提供表面分层。",
+        "border": "none（禁止使用 1px solid hsl(var(--color-gray-line))；v7.5 及之前的 border 定义均废弃）",
+        "boxShadow": "var(--shadow-sm) = 0 1px 2px rgba(0,0,0,0.05)（最弱阴影，唯一允许值）",
+        "borderRadius": "var(--radius-lg) = 12px（保持不变）",
+        "background": "hsl(var(--color-card))（保持不变）",
+        "forbidden": [
+          "禁止 border: 1px solid hsl(var(--color-gray-line))（去线框后不再需要）",
+          "禁止使用 box-shadow: 0 1px 2px rgba(0,0,0,0.04)等硬编码阴影值（一律走 var(--shadow-sm)）",
+          "禁止使用 shadow-DEFAULT / shadow-md 等更强阴影（会造成表面过重）",
+          "禁止同时使用 border + shadow（v7.6 为二选一关系，仅保留 shadow）"
+        ],
+        "verification": "Card 外边没有 1px 边框线（DOM Inspector 下 border-width = 0）；卡片与背景之间仅靠最弱阴影进行分层；box-shadow computed value = rgba(0,0,0,0.05) 0px 1px 2px 0px。",
+        "appliesTo": [
+          "ListPage 的 .card / .card-wrapper（化身为列表白卡容器）",
+          "DetailPage 的内容区白卡",
+          "DetailPage 的 InfoCard（仅独立 Card 容器模式 A：拥有 background / border-radius 时）跟随主卡应用本规则",
+          "FormPage / WizardFormPage 的主体表单白卡",
+          "任何作为 'PageContainer 直接子节点的内容区大卡片' 使用场景"
+        ],
+        "notAppliesTo": [
+          "浮层类组件：Dropdown / Popover / Select content / Tooltip（仍使用 1px border + 中等阴影）",
+          "业务卡片列表项 (item-card / GenericCard)：依然使用 border，不适用本规则",
+          "DetailPage 的 InfoCard（嵌入主卡内的分组区块模式 B：仅采用 padding + border-bottom 分隔）不适用本规则",
+          "shadcn 默认 Card（未作为内容区白卡容器使用时）保留 border + shadow-card 默认行为",
+          "功能性分割线：PageHeader / Tabs / Divider 的 border（属区域分隔，非卡片表面，不被本规则涵盖）"
+        ],
+        "version": "v7.6"
+      },
+      "PageContainer.padding": "16px 16px 16px 0 (上/右/下/左 = --page-container-padding --page-container-padding --page-container-padding --page-container-padding-left；左侧 0 使白卡紧贴 sidebar 右边缘，不预留间距)",
+      "PageHeader.height": "64px",
+      "PageHeader.paddingX": "0 (水平对齐由 Card.paddingX 提供；禁止重复设置)",
+      "ActionToolbar.internalGap": "8px (= --button-gap)",
+      "ActionToolbar.paddingX": "0 (水平对齐由 Card.paddingX 提供；禁止重复设置)",
+      "ActionToolbar.paddingBottom": "16px (= --card-gap)",
+      "ActionToolbar.searchComboGap": "20px（SearchCombo 固定跟随在 .left-actions 后方，与 .left-actions 间距 = 20px，独立于工具栏 gap=8px）",
+      "ActionToolbar.layoutRule": {
+        "structure": ".action-toolbar > [.left-actions, .search-combo, .right-tools]（SearchCombo 为工具栏的直接子元素，不再嵌套在 .right-tools 内）",
+        "leftActionsToSearchCombo": "SearchCombo 与 .left-actions 之间 = 20px（使用 margin-left: calc(20px - var(--button-gap)) 在工具栏 gap=8px 上叠加 12px，合计 20px）",
+        "rightTools": ".right-tools 仍然 margin-left: auto，包含刷新 / 设置 等 icon 按钮",
+        "css": [
+          ".action-toolbar { display: flex; align-items: center; gap: var(--button-gap); padding: 0; padding-bottom: var(--card-gap); }",
+          ".action-toolbar .left-actions { display: flex; align-items: center; gap: var(--button-gap); }",
+          ".action-toolbar > .search-combo { margin-left: calc(20px - var(--button-gap)); }",
+          ".action-toolbar .right-tools { margin-left: auto; display: flex; align-items: center; gap: var(--button-gap); }"
+        ],
+        "forbidden": [
+          "禁止将 SearchCombo 放在 .right-tools 内部（会被 margin-left:auto 推到最右，与 .left-actions 间距不可控）",
+          "禁止 SearchCombo 与 .left-actions 间距为 8px（仅 toolbar gap）或其他非 20px 值",
+          "禁止在 .left-actions 内部添加 SearchCombo（会与 .left-actions 内部 gap=8px 混淆）"
+        ],
+        "verification": "SearchCombo 左边缘 X = .left-actions 最后一个按钮右边缘 X + 20px。刷新按钮仍然贴 Card 右缘（X = Card 右缘 - 20px）。"
+      },
+      "DataTable.paddingX": "0 (表格本身不设水平 padding；表格与 Card 外侧边缘的 20px 呼吸由 Card.paddingX 提供)",
+      "DataTable.paddingY": "0 (表格本身贴紧上下元素)",
+      "DataTable.cellPadding": "12px 12px 【上下 12px / 左右 12px】；**分层规则**：th/td 的水平 padding 仅用于列与列之间的内部呼吸（相邻两个 td 的 12+12 = 24px 列间距）；**表格与 Card 外侧边缘的呼吸不由 td 提供**",
+      "DataTable.firstLastCellRule": "首列 padding-left = 20px，末列 padding-right = 20px；表格作为密集数据区，享有除 Card.paddingX (20px) 之外的额外 20px 视觉呈息。首列内容 X = Card 外缘 + 20 + 20 = 40px；末列右缘 X = Card 右缘 - 20 - 20 = -40px。CSS：`.data-table th:first-child, .data-table td:first-child { padding-left: 20px; } .data-table th:last-child, .data-table td:last-child { padding-right: 20px; }`",
+      "DataTable.actionColRightPadding": "废弃：末列右侧呼吸由 「Card.paddingRight 20px + td.paddingRight 20px」组合提供，总计40px",
+      "DataTable.horizontalAlignmentRule": {
+        "description": "【Card 内左右对齐稳定规则 - 分层模型 v7.5】水平 padding 职责严格分层：\n  - **Card.paddingX (20px)**：提供 Card 外侧边缘 ↔ 非 Table 子组件 (PageHeader / ActionToolbar / BulkActionBar / Pagination) 外缘的外侧呼吸\n  - **Table td.paddingX (12px)**：仅提供中间列与列之间的内部呼吸（相邻 td 12+12=24）\n  - **Table 首末列 padding-left/right = 20px**：表格作为密集数据区，额外享有 20px 视觉呈息\n重要：表格首列内容 X = Card 外缘 + 40px，与 PageHeader / ActionToolbar / Pagination 起始线不对齐（这是设计预期）。\n其他子组件 (PageHeader / ActionToolbar / BulkActionBar / Pagination) 的 paddingX 为 0，完全由 Card.paddingX 提供外侧呼吸，起始线 X = Card 外缘 + 20px。",
+        "singleSourceOfOuterPadding": "Card.padding (上下 0 / 左右 var(--card-padding-x) = 20px)",
+        "tableInnerColumnGap": "td paddingX = 12px (中间列)；首列 padding-left = 20px，末列 padding-right = 20px",
+        "alignmentLines": {
+          "nonTableSubcomponents": "PageHeader / ActionToolbar / BulkActionBar / Pagination 起始线 X = Card 外缘 + 20px",
+          "tableContent": "Table 首列内容 X = Card 外缘 + 40px；Table 末列右缘 X = Card 右缘 - 40px",
+          "note": "两者不在同一起始线上；Table 享有额外 20px 缩进，为密集数据提供视觉呈息"
+        },
+        "forbidden": [
+          "禁止在非 Table 子组件（PageHeader / ActionToolbar / BulkActionBar / Pagination）重复设置 paddingX（会与 Card.paddingX 叠加为 40px）",
+          "禁止 Table 的 td 不设 paddingX（列间会贴紧挨压）",
+          "禁止 Table 首列 padding-left 为 0 / 12 / 16 / 24 等非 20 值（独立于权威 20px 规则，需护栏）",
+          "禁止 Table 末列 padding-right 为非 20 值（同上）",
+          "禁止使用 px-3/4/5/6 等 Tailwind 字面量。Table td 唯一可接受模式：px-3 (12px) 中间列 + first:pl-5 (20px) + last:pr-5 (20px)",
+          "禁止为 Card 以外的中间包裹层（如 .card-scrollable）额外设置 paddingX"
+        ],
+        "verification": "生成后可验证：\n  1. PageHeader 左边缘 X = ActionToolbar 首个控件 X = Pagination 左侧起始 X = Card 左边缘 + 20px\n  2. Table 首列 (checkbox) 内容左边缘 X = Card 左边缘 + 40px（20 + 20）\n  3. Table 末列内容右边缘 X = Card 右边缘 - 40px\n  4. Table 相邻两个中间列内容间距 = 24px（例如「ID」列右边缘 ↔ 「状态」列左边缘）\n任一不一致即为违反。",
+        "visualSideEffect": "thead 背景、tbody tr border-bottom、BulkActionBar 背景、Pagination border-top 不延伸到 Card 左右边缘（Card 左右各保留 20px 白边）。这是设计预期行为。表格首末列内容进一步缩进 20px，总体与 Card 边缘保持 40px 距离。"
+      },
+      "BulkActionBar.paddingX": "0 (水平对齐由 Card.paddingX 提供；禁止重复设置)",
+      "BulkActionBar.paddingY": "12px",
+      "BulkActionBar.background": "#ffffff（纯白）",
+      "BulkActionBar.statsGap": "16px（“已选 x 项”与“共 x 条”之间间距）",
+      "BulkActionBar.statsOrder": "“已选 x 项”在前、“共 x 条”在后；margin-left: auto 推到右侧",
+      "Pagination.paddingX": "0 (水平对齐由 Card.paddingX 提供；禁止重复设置)",
+      "Pagination.paddingY": "12px",
+      "Pagination.topGap": "0 (紧贴 DataTable/BulkActionBar)",
+      "FieldGroup.fieldGap": "16px (= --card-gap)",
+      "CardGrid.gap": "16px (= --card-gap)",
+      "Form.submitBarGap": "8px (= --button-gap)",
+      "Form.itemGap": "16px (= --card-gap)",
+      "Form.groupGap": "24px",
+      "Form.labelContentGap": "24px (左右布局), 4px (上下布局)",
+      "Detail.labelContentGap": "12px (= --gap-md，label 与 value 间距，与 component-specs.json C26.row.gap 一致)",
+      "Detail.multiColumnGap": "64px (多列 DescriptionList 列与列之间的水平间距)",
+      "Detail.groupGap": "24px (分组与分组之间的纵向间距，与 component-specs.json C26.section.sectionGap 对齐)",
+      "Detail.labelSize": "12px (= --font-size-base，说明字段名)",
+      "Detail.contentSize": "12px (= --font-size-base，字段值；v7.6.1 以代码实际与 C26 为准对齐为 12px)",
+      "DescriptionList": {
+        "description": "【v7.6.1 补齐】详情页核心展示组件 DescriptionList 间距与字号的结构化定义。最终精确规格（响应式、交互、边界）以 component-specs.json C26-DescriptionList 为唯一真相源，本段仅记录 spacing/typography 核心 token。",
+        "row": {
+          "height": "36px（含 paddingY）",
+          "paddingY": "8px",
+          "labelValueGap": "12px (= --gap-md；label 与 value 之间)"
+        },
+        "label": {
+          "fontSize": "var(--font-size-base) = 12px",
+          "color": "hsl(var(--color-gray-secondary-foreground))",
+          "fontWeight": "var(--font-weight-normal) = 400",
+          "width": "auto，minWidth=80px，maxWidth=180px"
+        },
+        "value": {
+          "fontSize": "var(--font-size-base) = 12px",
+          "color": "hsl(var(--color-gray-primary))",
+          "fontWeight": "var(--font-weight-normal) = 400"
+        },
+        "section": {
+          "sectionGap": "24px（分组与分组之间的纵向间距，通过后一个 section 的 padding-top 实现）",
+          "titleFontSize": "var(--font-size-lg) = 14px",
+          "titleFontWeight": "600",
+          "titleColor": "hsl(var(--color-gray-primary))",
+          "titleMarginBottom": "12px【分组标题与首行间距】",
+          "borderTopBetween": "1px solid hsl(var(--color-gray-line))（非首个分组）— 属「功能性分组分割线」，不受 v7.6 surface 规则约束"
+        },
+        "columns": {
+          "default": 2,
+          "options": [
+            2,
+            3,
+            4
+          ],
+          "multiColumnGap": "64px（列与列间的水平间距）",
+          "responsive": {
+            ">=1200px": "使用配置列数",
+            "768px-1199px": "最多 2 列",
+            "<768px": "强制 1 列（vertical 布局）"
+          }
+        },
+        "container": {
+          "paddingX": "0【继承 Card 内边距 var(--card-padding-x) = 20px，不重复设置】",
+          "paddingY": "0"
+        },
+        "reference": "component-specs.json C26-DescriptionList（完整规格；含交互与边界约束）、page-rule-examples/detail-page.html（参考实现）、pages/detail-page/SKILL.md §6.5（详情页域间距与表面规范）"
+      },
+      "Page.bottomPadding": "40px",
+      "Sidebar.menuItemHeight": "40px",
+      "Sidebar.l2Indent": "16px"
+    }
+  },
+  "typographyTokens": {
+    "description": "全局字体体系。TrekClaw 4 级字号体系（base=12/lg=14/xl=16/2xl=18）。CSS 变量 --font-sans / --font-mono 为字体族唯一引用方式，禁止在页面中硬编码 font-family 堆栈。",
+    "fontFamily": {
+      "sans": {
+        "var": "--font-sans",
+        "value": "'PingFang SC', -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, 'Helvetica Neue', sans-serif",
+        "usage": "UI 文字、正文、标题、标签、按钮等所有非代码文本"
+      },
+      "mono": {
+        "var": "--font-mono",
+        "value": "'SF Mono', Monaco, 'Courier New', monospace",
+        "usage": "代码/ID/IP/版本号/实例规格等机器可读标识符"
+      },
+      "cssInstruction": "生成 HTML 时，body 必须使用 font-family: var(--font-sans)；代码片段使用 font-family: var(--font-mono)。禁止在任何位置硬编码 font-family 字符串。"
+    },
+    "scale": {
+      "base": {
+        "var": "--font-size-base",
+        "value": "0.75rem",
+        "note": "12px",
+        "name": "text-xs",
+        "usage": "正文/标签/脚注/输入框/表格/Badge/分页/页面副标题",
+        "weight": {
+          "normal": "400"
+        }
+      },
+      "lg": {
+        "var": "--font-size-lg",
+        "value": "0.875rem",
+        "note": "14px",
+        "name": "text-sm",
+        "usage": "强调正文/弹窗标题/抽屉标题/Tab",
+        "weight": {
+          "normal": "400",
+          "medium": "500"
+        }
+      },
+      "xl": {
+        "var": "--font-size-xl",
+        "value": "1rem",
+        "note": "16px",
+        "name": "text-base",
+        "usage": "Sidebar 品牌区文字、小标题、卡片标题、区块标题",
+        "weight": {
+          "medium": "500",
+          "black": "900 (仅 Sidebar 品牌区)"
+        }
+      },
+      "2xl": {
+        "var": "--font-size-2xl",
+        "value": "1.125rem",
+        "note": "18px",
+        "name": "text-lg",
+        "usage": "页面主标题（PageHeader）、概览统计大数字",
+        "weight": {
+          "medium": "500"
+        }
+      },
+      "page-header": {
+        "var": "--font-size-page-header",
+        "value": "1.125rem",
+        "note": "= var(--font-size-2xl) = 18px",
+        "name": "语义别名",
+        "usage": "PageHeader 页面主标题专用字号（映射到 --font-size-2xl）。生成页面时 .page-header-title 必须使用此变量。",
+        "weight": {
+          "medium": "500"
+        }
+      }
+    },
+    "lineHeight": {
+      "input": {
+        "var": "--line-height-input",
+        "value": "1.5",
+        "note": "18px/12px"
+      },
+      "normal": {
+        "var": "--line-height-normal",
+        "value": "1.5"
+      },
+      "dialogTitle": {
+        "var": "--line-height-dialog-title",
+        "value": "1.57",
+        "note": "22px/14px"
+      }
+    },
+    "fontWeight": {
+      "normal": {
+        "var": "--font-weight-normal",
+        "value": "400",
+        "usage": "正文、Tab 常态、表格单元格"
+      },
+      "medium": {
+        "var": "--font-weight-medium",
+        "value": "500",
+        "usage": "标签、导航、Tab 激活、弹窗标题、按钮"
+      },
+      "black": {
+        "var": "--font-weight-black",
+        "value": "900",
+        "usage": "Sidebar 品牌区文字"
+      }
+    },
+    "letterSpacing": {
+      "tight": {
+        "var": "--letter-spacing-tight",
+        "value": "-0.025em"
+      },
+      "normal": {
+        "var": "--letter-spacing-normal",
+        "value": "0em"
+      }
+    },
+    "pageHeaderTitle": {
+      "description": "PageHeader 标题专用字号。18px 不属于主 scale（base/lg/xl/2xl），仅用于 PageHeader 标题。",
+      "fontSize": "18px",
+      "fontWeight": "500 (medium)",
+      "lineHeight": "36px (leading-9)",
+      "color": "var(--gray-title)",
+      "note": "此值独立于 typographyTokens.scale，AI 生成 PageHeader 时必须使用 18px，不得用 --font-size-lg 或 --font-size-xl 替代"
+    },
+    "code": {
+      "usage": "实例ID、IP地址、VPC ID、实例规格等机器可读标识符",
+      "properties": "font-mono, text-sm(14px), text-[hsl(var(--gray-secondary))]"
+    },
+    "truncate": {
+      "usage": "单行文本截断，超出显示省略号",
+      "css": "truncate (overflow-hidden text-ellipsis whitespace-nowrap)",
+      "maxLines": "1 (默认), 2-3 (卡片描述等场景使用 line-clamp)"
+    },
+    "legacyAliases": {
+      "description": "Legacy 排版别名。",
+      "textFontSize": {
+        "var": "--text-font-size",
+        "value": "14px",
+        "usage": "→ --font-size-lg（强调正文 legacy 别名）"
+      }
+    }
+  },
+  "layoutTokens": {
+    "description": "响应式断点与布局模式体系",
+    "breakpoints": {
+      "DesktopXL": {
+        "min": "1920px",
+        "behavior": "导航展开，完整布局"
+      },
+      "Desktop": {
+        "min": "1200px",
+        "max": "1919px",
+        "behavior": "导航可收起，完整布局"
+      },
+      "Tablet": {
+        "min": "768px",
+        "max": "1199px",
+        "behavior": "导航覆盖式/横滚，表格横滚"
+      },
+      "Mobile": {
+        "max": "767px",
+        "behavior": "不推荐，提示使用桌面端"
+      }
+    },
+    "layoutModes": {
+      "SINGLE_COL": "单列布局，PageContainer 直接包含内容，无 Sidebar",
+      "TWO_COL": "双列布局，Sidebar(240px 固定) + PageContainer(自适应)",
+      "GRID": "网格布局，卡片/统计卡片使用 grid auto-fill/auto-fit"
+    },
+    "responsiveTable": {
+      "fixedLeft": "选择框 + ID/名称列固定在左侧",
+      "fixedRight": "操作列固定在右侧",
+      "scrollable": "中间列支持横向滚动",
+      "priorityHide": "视口受限时按列优先级从右向左隐藏"
+    }
+  },
+  "sidebarRules": {
+    "description": "Sidebar 组件统一规范 — AI 生成页面时必须引用以下规则，禁止硬编码色值或宽度。其他文件（page-frame.json / common-components.json / 子技能）应引用本规则，避免分散和冲突。",
+    "width": {
+      "expanded": {
+        "var": "--layout-sidebar-width",
+        "value": "240px",
+        "usage": "侧边栏展开状态默认宽度"
+      },
+      "collapsed": {
+        "var": "--sidebar-collapsed-width",
+        "value": "68px",
+        "usage": "侧边栏收起状态宽度（仅显示图标）"
+      }
+    },
+    "layout": {
+      "position": "fixed",
+      "top": "0",
+      "left": "0",
+      "bottom": "0",
+      "zIndex": "100",
+      "mainContentOffset": "margin-left: var(--layout-sidebar-width)（主内容区补偿，非 flex）",
+      "usage": "Sidebar 使用 fixed 定位，主内容区通过 margin-left 补偿宽度。禁止使用 flex 布局排列 Sidebar 和主内容区。"
+    },
+    "structure": {
+      "description": "Sidebar 内部 HTML 结构规范。支持 2 级 / 3 级两种结构变体；菜单项必须用 ul > li > a 包裹，禁止扁平化（直接 a 挂在 nav/div 下）。",
+      "variants": {
+        "threeLevel": {
+          "description": "3 级结构（默认）：分组标题 + 主菜单 + 子菜单。适用信息架构需要 3 层归类的场景（顶层按业务域分组、中层主导航、底层细分功能）。",
+          "levels": [
+            "sidebar-group-label（分组标题）",
+            "sidebar-menu-item（主菜单）",
+            "sidebar-sub-menu > sidebar-menu-item（子菜单）"
+          ],
+          "hierarchy": [
+            "aside.sidebar",
+            "├─ div.sidebar-header（品牌区）",
+            "├─ div.sidebar-content（滚动容器）",
+            "│   ├─ div.sidebar-group-label（分组标题，可重复）",
+            "│   ├─ ul.sidebar-menu",
+            "│   │   └─ li > a.sidebar-menu-item（主菜单项）",
+            "│   ├─ ul.sidebar-sub-menu（可选，主菜单展开后显示）",
+            "│   │   └─ li > a.sidebar-menu-item（子菜单项）",
+            "│   └─ … 更多分组",
+            "├─ div.sidebar-divider（Footer 分隔线）",
+            "└─ div.sidebar-footer",
+            "    ├─ div.sidebar-avatar",
+            "    ├─ span.sidebar-username",
+            "    └─ button.sidebar-more"
+          ]
+        },
+        "twoLevel": {
+          "description": "2 级结构（新增）：主菜单 + 子菜单，无分组标题。适用信息架构只有 2 层归类的场景（顶层主导航、底层细分功能，无需分组标题归类）。",
+          "levels": [
+            "sidebar-menu-item（主菜单）",
+            "sidebar-sub-menu > sidebar-menu-item（子菜单，可选）"
+          ],
+          "hierarchy": [
+            "aside.sidebar",
+            "├─ div.sidebar-header（品牌区）",
+            "├─ div.sidebar-content（滚动容器）",
+            "│   ├─ ul.sidebar-menu（单一菜单容器，无分组标题）",
+            "│   │   ├─ li > a.sidebar-menu-item（主菜单项，可重复）",
+            "│   │   └─ li > ul.sidebar-sub-menu（可选，主菜单展开后显示）",
+            "│   │       └─ li > a.sidebar-menu-item（子菜单项）",
+            "├─ div.sidebar-divider（Footer 分隔线）",
+            "└─ div.sidebar-footer",
+            "    ├─ div.sidebar-avatar",
+            "    ├─ span.sidebar-username",
+            "    └─ button.sidebar-more"
+          ],
+          "differenceFromThreeLevel": "禁止出现 div.sidebar-group-label；所有主菜单项放入同一个 ul.sidebar-menu，主菜单项之间间距由 li 自身 padding 提供（不再依赖 group-label margin-top:16px）。",
+          "textAlignment": {
+            "description": "子菜单文字与主菜单文字 x 坐标上下对齐（同一列），不再以退格表现层级，层级关系由展开箭头 / 字号减小 / 背景色表现。",
+            "calculation": "主菜单文字 x = ul.sidebar-menu padding-left(8) + a.sidebar-menu-item padding-left(12) + .item-icon 宽(16) + gap var(--button-gap)(8) = 44px（从 sidebar-content 内边缘起算）。子菜单文字需同样为 44px。",
+            "implementation": [
+              ".sidebar-menu > li > .sidebar-sub-menu { padding-left: 0; } — sub-menu 不再额外加左 padding",
+              ".sidebar-sub-menu .sidebar-menu-item { padding-left: 36px; } — 36px = 12 + 16 + 8，代替主菜单的 padding+icon+gap 宽度",
+              "子菜单项本身不需要 .item-icon（仅文字）"
+            ],
+            "forbidden": "禁止给子菜单项加 .item-icon；禁止使子菜单文字起点低于主菜单文字起点 x（隐藏层级关系）或高于主菜单（反直觉）。"
+          }
+        }
+      },
+      "selectionGuide": {
+        "principle": "以信息架构层级深度为准，与菜单项个数无关。",
+        "useThreeLevel": "信息架构需要 3 层归类：分组标题（业务域 / 模块归类）→ 主菜单 → 子菜单。当主菜单项之间需要语义化分组时使用。",
+        "useTwoLevel": "信息架构只需 2 层归类：主菜单 → 子菜单。当主菜单项处于同一语义层级、无需上层分组归类时使用。"
+      },
+      "forbidden": [
+        "禁止扁平化结构（直接 a 标签挂在 nav/div 下，无 ul > li 包裹）",
+        "禁止 Sidebar 整体使用 flex 布局（改用 fixed 定位）",
+        "禁止省略 sidebar-content 滚动容器（sidebar-header 固定，footer 固定在底部）",
+        "twoLevel 变体下禁止出现 sidebar-group-label",
+        "只有一级功能、无子菜单的菜单项禁止出现 expand-icon 与 data-toggle：expand-icon 仅出现在有 sidebar-sub-menu 的主菜单项上"
+      ]
+    },
+    "collapseBehavior": {
+      "description": "收起态行为规则。收起后 sidebar 宽度缩为 68px，所有元素居中对齐于 34px 中轴线。",
+      "width": "68px (= --sidebar-collapsed-width)",
+      "overflow": "visible（容器级别 overflow: visible 以支持 flyout 浮层溢出；滚动能力下移到 .sidebar-content 的 overflow-y: auto / overflow-x: hidden）",
+      "visible": "仅显示图标，隐藏所有文字（label / group title / count / expand-icon）",
+      "transition": "width var(--duration-normal) var(--easing-ease)",
+      "selectedIndicator": "收起态通过灰色背景 var(--color-sidebar-active) 区分，不显示高亮条",
+      "menuItem": {
+        "size": "40x40px",
+        "borderRadius": "var(--radius-md) (8px)",
+        "centering": "li { display: flex; justify-content: center } 使 40px item 居中于 68px sidebar 的 34px 中轴线",
+        "gap": "0（覆盖基础 gap: var(--button-gap)，消除隐形文字节点产生的 flex 间距偏移）",
+        "flexShrink": "0（防止弹性压缩）",
+        "selector": ".sidebar.collapsed .sidebar-menu > li > a.sidebar-menu-item（精确作用域，不泄漏到 flyout 内的菜单项）",
+        "textHiding": "li > a { font-size: 0 } + li > a > .item-icon { font-size: var(--font-size-lg) }",
+        "iconMargin": "0（覆盖展开态的 item-icon margin）"
+      },
+      "menu": {
+        "padding": "0（移除展开态的 0 8px，配合 li justify-content: center 实现居中）",
+        "gap": "2px（继承基础 sidebar-menu 的 gap: 2px）"
+      },
+      "divider": {
+        "margin": "0 14px（宽度 = 68 - 14*2 = 40px，与菜单项等宽对齐）"
+      },
+      "header": {
+        "padding": "0 12px",
+        "justifyContent": "center",
+        "logo": {
+          "collapsed": "显示折叠态 Logo（30x30px），隐藏展开态品牌 Logo",
+          "hoverInteraction": "hover Logo 区域时隐藏折叠 Logo、显示展开 icon（14x14px，#717376）",
+          "clickAction": "点击 Logo 区域展开 sidebar（移除 collapsed class）",
+          "expandIcon": {
+            "size": "14x14px",
+            "color": "#717376",
+            "viewBox": "正方形裁剪（如 380 160 680 680），确保在固定像素容器中不变形"
+          }
+        },
+        "collapseBtn": "display: none（收起态隐藏折叠按钮）"
+      },
+      "footer": {
+        "padding": "12px 10px 16px",
+        "justifyContent": "center",
+        "hidden": "username / moreButton 隐藏，仅保留 avatar 居中"
+      },
+      "collapseButton": {
+        "size": "14x14px",
+        "color": "#717376",
+        "position": "margin-left: auto（展开态靠右对齐）",
+        "note": "展开态和收起态的 icon 尺寸与颜色保持一致"
+      },
+      "flyout": {
+        "description": "收起态 hover 菜单项时，在右侧弹出子菜单浮层",
+        "trigger": "li:hover > .sidebar-flyout { display: block }",
+        "position": "absolute; left: 100%; top: 0（紧贴 sidebar 右边缘）",
+        "minWidth": "160px",
+        "padding": "4px",
+        "background": "hsl(var(--color-card))",
+        "border": "1px solid hsl(var(--color-gray-line))",
+        "borderRadius": "var(--radius-md)",
+        "boxShadow": "0 4px 12px rgba(0,0,0,0.08)",
+        "zIndex": 200,
+        "menuItem": {
+          "height": "36px",
+          "padding": "0 12px",
+          "fontSize": "var(--font-size-base)",
+          "fontWeight": "var(--font-weight-normal)",
+          "color": "hsl(var(--color-gray-primary))",
+          "borderRadius": "var(--radius-sm)",
+          "hoverBg": "hsl(var(--gray-fill))"
+        }
+      },
+      "alignment": {
+        "description": "68px 收起态中轴对齐规则：所有可见元素的视觉中心对齐于 x = 34px",
+        "header": "padding: 0 12px + justify-content: center → 30px Logo 居中于 34px",
+        "menuItem": "li justify-content: center → 40px item 居中于 34px",
+        "divider": "margin: 0 14px → 40px divider 居中于 34px",
+        "footer": "padding: 12px 10px 16px + justify-content: center → 28px avatar 居中于 34px"
+      }
+    },
+    "colors": {
+      "container": {
+        "background": "var(--color-sidebar)",
+        "border": "none",
+        "note": "Sidebar 整体无任何外边框（右侧外边框、品牌区底部边框）。与内容区通过背景色差区分边界。"
+      },
+      "navGroup": {
+        "text": "var(--color-sidebar-group)",
+        "usage": "分组标题文字，小写大写混排"
+      },
+      "menuItem": {
+        "default": {
+          "text": "var(--color-sidebar-item-muted)",
+          "background": "transparent",
+          "note": "默认态文字颜色为 muted（灰色），不是 item（黑色）"
+        },
+        "hover": {
+          "text": "var(--color-sidebar-item)",
+          "background": "var(--color-sidebar-hover)"
+        },
+        "active": {
+          "text": "var(--color-sidebar-active-foreground)",
+          "background": "var(--color-sidebar-active)",
+          "indicator": "无高亮条，仅通过灰色背景 var(--color-sidebar-active) 区分选中态"
+        },
+        "disabled": {
+          "text": "var(--color-sidebar-item-muted)",
+          "background": "transparent"
+        }
+      },
+      "icon": {
+        "default": "var(--color-sidebar-item-muted)",
+        "active": "var(--color-sidebar-active-foreground)",
+        "note": "默认态图标也应为 muted，激活态为白色"
+      }
+    },
+    "menuItemStyle": {
+      "description": "菜单项样式规范。禁止扁平样式。",
+      "padding": "0 12px",
+      "height": "40px (= --menuItemHeight)",
+      "gap": "8px (= --button-gap)",
+      "borderRadius": "8px (= --radius-md，药丸形圆角，非直角）",
+      "fontSize": "14px (= --font-size-lg)",
+      "fontWeight": "500 (= --font-weight-medium)",
+      "iconSize": "16px (= --input-icon-size)",
+      "activeState": {
+        "implementation": "background: hsl(var(--color-sidebar-active))，禁止使用 border-left / ::before / 高亮条",
+        "paddingLeft": "12px（保持与 padding 一致，无需补偿）",
+        "forbidden": "border-left / ::before 伪元素 / 高亮条实现（仅用灰色背景区分）"
+      }
+    },
+    "sidebarFooter": {
+      "description": "Sidebar 底部区域。包含用户头像、用户名、更多按钮。固定在底部，不参与滚动。",
+      "styles": {
+        "flexShrink": "0",
+        "display": "flex",
+        "alignItems": "center",
+        "gap": "8px"
+      },
+      "divider": {
+        "styles": {
+          "height": "1px",
+          "background": "hsl(var(--color-sidebar-border))",
+          "margin": "0 12px",
+          "flexShrink": "0"
+        }
+      },
+      "padding": "12px 12px 16px 24px",
+      "avatar": {
+        "size": "28px",
+        "borderRadius": "50%",
+        "styles": {
+          "width": "28px",
+          "height": "28px",
+          "borderRadius": "50%",
+          "display": "flex",
+          "alignItems": "center",
+          "justifyContent": "center",
+          "flexShrink": "0",
+          "fontSize": "var(--font-size-base)",
+          "fontWeight": "600",
+          "overflow": "hidden"
+        }
+      },
+      "username": {
+        "styles": {
+          "flex": "1",
+          "fontSize": "var(--font-size-lg)",
+          "fontWeight": "var(--font-weight-medium)",
+          "color": "var(--color-sidebar-item)",
+          "overflow": "hidden",
+          "textOverflow": "ellipsis",
+          "whiteSpace": "nowrap"
+        }
+      },
+      "moreButton": {
+        "size": "28px",
+        "icon": "垂直三点（ellipsis-vertical）",
+        "styles": {
+          "width": "28px",
+          "height": "28px",
+          "borderRadius": "var(--radius-sm)",
+          "border": "none",
+          "background": "transparent",
+          "display": "flex",
+          "alignItems": "center",
+          "justifyContent": "center",
+          "color": "var(--gray-tertiary)",
+          "cursor": "pointer",
+          "transition": "color var(--duration-fast), background var(--duration-fast)"
+        },
+        "hoverState": {
+          "color": "var(--color-gray-primary)",
+          "background": "var(--gray-fill)"
+        }
+      },
+      "collapsedState": {
+        "padding": "12px 10px 16px",
+        "justifyContent": "center",
+        "hidden": [
+          "username",
+          "moreButton"
+        ],
+        "visible": [
+          "avatar"
+        ],
+        "note": "收起态详细规范见 collapseBehavior.footer"
+      }
+    },
+    "behavior": {
+      "menuItemHeight": "40px",
+      "l2Indent": "16px",
+      "responsiveBreakpoint": "768px 以下折叠为 Overlay 抽屉模式"
+    },
+    "sidebarHeader": {
+      "description": "Sidebar 顶部品牌区域，替代原 TopNavigation 的 Logo+ProductName。与菜单区背景色一致（--color-sidebar），无分割线分隔。",
+      "styles": {
+        "height": "56px",
+        "padding": "0 16px",
+        "display": "flex",
+        "alignItems": "center",
+        "gap": "4px (= --gap-xs，Logo 与品牌文字间距)",
+        "flexShrink": "0",
+        "forbidden": "flex-grow / overflow / border-bottom"
+      },
+      "logo": {
+        "size": "20x20px",
+        "styles": {
+          "width": "20px",
+          "height": "20px",
+          "flexShrink": "0",
+          "padding": "4px",
+          "display": "flex",
+          "alignItems": "center",
+          "justifyContent": "center"
+        },
+        "gap": "4px (= --gap-xs，Logo 与品牌文字间距)"
+      },
+      "productName": {
+        "fontSize": "var(--font-size-xl)",
+        "fontWeight": "900 (= --font-weight-black)",
+        "color": "var(--color-sidebar-foreground)",
+        "letterSpacing": "var(--letter-spacing-tight)",
+        "styles": {
+          "lineHeight": "1",
+          "whiteSpace": "nowrap"
+        }
+      },
+      "forbidden": [
+        "border-bottom（禁止底部边框/分割线）",
+        "box-shadow（禁止底部阴影）"
+      ],
+      "collapsedState": {
+        "padding": "0 12px",
+        "justifyContent": "center",
+        "note": "收起态详细规范见 collapseBehavior.header"
+      }
+    },
+    "sidebarContent": {
+      "description": "Sidebar 菜单滚动容器。位于 header 与 footer 之间，承载所有分组和菜单项。",
+      "styles": {
+        "flex": "1",
+        "flexShrink": "0",
+        "overflowY": "auto",
+        "padding": "12px 0"
+      },
+      "groupLabel": {
+        "styles": {
+          "padding": "0 16px",
+          "height": "26px",
+          "lineHeight": "26px",
+          "fontSize": "var(--font-size-base)",
+          "fontWeight": "var(--font-weight-normal)",
+          "color": "var(--color-sidebar-group)"
+        },
+        "spacing": "非首个分组时 margin-top: 16px"
+      },
+      "menu": {
+        "listStyle": "none",
+        "padding": "0 8px",
+        "note": "ul.sidebar-menu，菜单项用 li > a 包裹"
+      }
+    },
+    "typography": {
+      "description": "Sidebar 字体体系。所有文字引用本层规则，禁止硬编码字号。",
+      "productName": {
+        "fontSize": "var(--font-size-xl) (16px)",
+        "fontWeight": "900 (= --font-weight-black)",
+        "color": "var(--color-sidebar-foreground)",
+        "letterSpacing": "var(--letter-spacing-tight)"
+      },
+      "navGroup": {
+        "fontSize": "var(--font-size-base) (12px)",
+        "fontWeight": "400 (= --font-weight-normal)",
+        "color": "var(--color-sidebar-group)",
+        "height": "26px"
+      },
+      "menuItem": {
+        "fontSize": "var(--font-size-lg) (14px)",
+        "fontWeight": "500 (= --font-weight-medium)",
+        "colorDefault": "var(--color-sidebar-item-muted)",
+        "colorHover": "var(--color-sidebar-item)",
+        "colorActive": "var(--color-sidebar-active-foreground)"
+      },
+      "footer": {
+        "username": {
+          "fontSize": "var(--font-size-lg) (14px)",
+          "fontWeight": "500 (= --font-weight-medium)",
+          "color": "var(--color-sidebar-item)",
+          "truncate": true
+        },
+        "avatarText": {
+          "fontSize": "var(--font-size-base) (12px)",
+          "fontWeight": "600",
+          "color": "var(--color-gray-primary)"
+        }
+      }
+    },
+    "cssVars": {
+      "description": "由本规则映射出的 CSS 变量条目（用于 cssGeneration 派生 + 反向核验）。",
+      "layoutSidebarWidth": {
+        "var": "--layout-sidebar-width",
+        "value": "240px",
+        "usage": "L1 Sidebar 展开态宽度"
+      },
+      "avatarBg": {
+        "var": "--color-avatar-bg",
+        "hsl": "216 11.1% 91.2%",
+        "fallback": "#E3E5E8",
+        "usage": "Sidebar 头像背景色"
+      }
+    },
+    "collapsedTokens": {
+      "description": "Sidebar 收起态专用 token（68px 收起态、flyout 浮层、菜单项尺寸等）。",
+      "sidebarCollapsedWidth": {
+        "var": "--sidebar-collapsed-width",
+        "value": "68px",
+        "usage": "收起态侧边栏宽度"
+      },
+      "sidebarMenuItemHeight": {
+        "var": "--sidebar-menu-item-height",
+        "value": "40px",
+        "usage": "菜单项高度（展开/收起共用）"
+      },
+      "sidebarMenuItemSizeCollapsed": {
+        "var": "--sidebar-menu-item-size-collapsed",
+        "value": "40px",
+        "usage": "收起态菜单项正方形尺寸"
+      },
+      "sidebarMenuItemGapCollapsed": {
+        "var": "--sidebar-menu-item-gap-collapsed",
+        "value": "0px",
+        "usage": "收起态菜单项内部 gap（消除隐形文字节点的 flex 间距）"
+      },
+      "sidebarHeaderPaddingCollapsed": {
+        "var": "--sidebar-header-padding-collapsed",
+        "value": "0 12px",
+        "usage": "收起态品牌区 padding"
+      },
+      "sidebarFooterPaddingCollapsed": {
+        "var": "--sidebar-footer-padding-collapsed",
+        "value": "12px 10px 16px",
+        "usage": "收起态底部 padding"
+      },
+      "sidebarFlyoutZIndex": {
+        "var": "--sidebar-flyout-z-index",
+        "value": "200",
+        "usage": "Flyout 浮层 z-index"
+      },
+      "sidebarFlyoutMinWidth": {
+        "var": "--sidebar-flyout-min-width",
+        "value": "160px",
+        "usage": "Flyout 浮层最小宽度"
+      },
+      "sidebarFlyoutItemHeight": {
+        "var": "--sidebar-flyout-item-height",
+        "value": "36px",
+        "usage": "Flyout 浮层菜单项高度"
+      },
+      "sidebarCenteredAxis": {
+        "var": "--sidebar-centered-axis",
+        "value": "34px",
+        "usage": "收起态视觉中轴（68/2 = 34px）"
+      },
+      "sidebarExpandIconSize": {
+        "var": "--sidebar-expand-icon-size",
+        "value": "14px",
+        "usage": "展开/折叠按钮图标尺寸"
+      }
+    }
+  },
+  "typeIdentifierTokens": {
+    "description": "类型标识色（API / MCP）。用于资源类型 Badge / 标签。",
+    "api": {
+      "var": "--color-type-api",
+      "hsl": "221 83% 53%",
+      "fallback": "#2563EB",
+      "usage": "API 类型主色"
+    },
+    "apiLight": {
+      "var": "--color-type-api-light",
+      "hsl": "214 100% 92%",
+      "fallback": "#D6E8FF",
+      "usage": "API 类型浅底"
+    },
+    "apiBorder": {
+      "var": "--color-type-api-border",
+      "hsl": "213 97% 87%",
+      "fallback": "#BFDBFE",
+      "usage": "API 类型边框"
+    },
+    "mcp": {
+      "var": "--color-type-mcp",
+      "hsl": "271 81% 56%",
+      "fallback": "#9333EA",
+      "usage": "MCP 类型主色"
+    },
+    "mcpLight": {
+      "var": "--color-type-mcp-light",
+      "hsl": "264 77% 95%",
+      "fallback": "#F0E8FC",
+      "usage": "MCP 类型浅底"
+    },
+    "mcpBorder": {
+      "var": "--color-type-mcp-border",
+      "hsl": "269 100% 92%",
+      "fallback": "#E9D5FF",
+      "usage": "MCP 类型边框"
+    }
+  },
+  "statusTokens": {
+    "description": "状态指示点颜色（Running / Stopped / Error）。",
+    "running": {
+      "var": "--color-status-running",
+      "hsl": "142 76% 36%",
+      "fallback": "#16A34A",
+      "usage": "运行中（→ --color-success）"
+    },
+    "stopped": {
+      "var": "--color-status-stopped",
+      "hsl": "222 7.6% 74.1%",
+      "fallback": "#BABCBF",
+      "usage": "已停止（→ --color-gray-disabled 同色系）"
+    },
+    "error": {
+      "var": "--color-status-error",
+      "hsl": "0 72% 51%",
+      "fallback": "#DC2626",
+      "usage": "错误（→ --color-destructive）"
+    }
+  },
+  "terminalTokens": {
+    "description": "终端 / 代码块颜色。",
+    "background": {
+      "var": "--color-terminal",
+      "hsl": "222 47% 11%",
+      "fallback": "#0F172A",
+      "usage": "终端背景"
+    },
+    "foreground": {
+      "var": "--color-terminal-foreground",
+      "hsl": "142 69% 58%",
+      "fallback": "#4ADE80",
+      "usage": "终端前景（绿色字符）"
+    }
+  },
+  "cardGridTokens": {
+    "description": "CardGrid 列宽预设（v7.2 业务卡片页 minWidth token 化）。",
+    "compact": {
+      "var": "--card-grid-min-compact",
+      "value": "240px",
+      "usage": "iconStyle=avatar + density=minimal"
+    },
+    "standard": {
+      "var": "--card-grid-min-standard",
+      "value": "300px",
+      "usage": "iconStyle=avatar + density=standard（默认）"
+    },
+    "comfortable": {
+      "var": "--card-grid-min-comfortable",
+      "value": "320px",
+      "usage": "iconStyle=tile + density=standard"
+    },
+    "feature": {
+      "var": "--card-grid-min-feature",
+      "value": "360px",
+      "usage": "iconStyle=avatar + density=complex"
+    }
+  },
+  "pageHeaderTokens": {
+    "description": "PageHeader / Breadcrumb / ActionToolbar 布局 token。",
+    "pageHeaderHeight": {
+      "var": "--page-header-height",
+      "value": "64px",
+      "usage": "PageHeader 高度"
+    },
+    "breadcrumbHeight": {
+      "var": "--breadcrumb-height",
+      "value": "64px",
+      "usage": "Breadcrumb 高度"
+    },
+    "actionToolbarSearchComboGap": {
+      "var": "--action-toolbar-search-combo-gap",
+      "value": "20px",
+      "usage": "ActionToolbar 中 SearchCombo 与 .left-actions 间距"
+    }
+  },
+  "formTokens": {
+    "description": "Form 表单布局 token。详见 component-specs.json C-Form。",
+    "labelWidth": {
+      "var": "--form-label-width",
+      "value": "140px",
+      "usage": "左右布局下 label 列宽度"
+    },
+    "controlMaxWidth": {
+      "var": "--form-control-max-width",
+      "value": "400px",
+      "usage": "表单控件最大宽度"
+    },
+    "rowGap": {
+      "var": "--form-row-gap",
+      "value": "24px",
+      "usage": "表单分组间距"
+    },
+    "rowPaddingY": {
+      "var": "--form-row-padding-y",
+      "value": "12px",
+      "usage": "表单行垂直内边距"
+    },
+    "descriptionFontSize": {
+      "var": "--form-description-font-size",
+      "value": "13px",
+      "usage": "表单描述文字字号"
+    },
+    "requiredIndicatorMarginLeft": {
+      "var": "--form-required-indicator-margin-left",
+      "value": "2px",
+      "usage": "必填星号与 label 间距"
+    }
+  },
+  "paginationTokens": {
+    "description": "Pagination 分页组件尺寸 token。",
+    "buttonSize": {
+      "var": "--pagination-button-size",
+      "value": "32px",
+      "usage": "分页按钮正方形尺寸"
+    },
+    "arrowIconSize": {
+      "var": "--pagination-arrow-icon-size",
+      "value": "20px",
+      "usage": "左右翻页箭头图标尺寸"
+    },
+    "ellipsisIconSize": {
+      "var": "--pagination-ellipsis-icon-size",
+      "value": "16px",
+      "usage": "省略号图标尺寸"
+    },
+    "buttonSmHeight": {
+      "var": "--button-sm-height",
+      "value": "28px",
+      "usage": "小号按钮高度（分页/紧凑场景共用）"
+    }
+  },
+  "stepperTokens": {
+    "description": "Stepper 步进器组件尺寸 token。",
+    "buttonWidth": {
+      "var": "--stepper-button-width",
+      "value": "32px",
+      "usage": "加减按钮宽度"
+    },
+    "buttonHeight": {
+      "var": "--stepper-button-height",
+      "value": "36px",
+      "usage": "加减按钮高度"
+    },
+    "inputWidth": {
+      "var": "--stepper-input-width",
+      "value": "60px",
+      "usage": "数值输入框宽度"
+    },
+    "inputHeight": {
+      "var": "--stepper-input-height",
+      "value": "36px",
+      "usage": "数值输入框高度"
+    }
+  }
+}