sai-assets可复用网页资产库
GitHub

Token Harbor · 墨色双模设计语言

token-harbor v1.0.0 MIT 主题 · 配色与字体 12 文件 · 146 KB
新窗口 ↗
载入预览…

营销 / 服务型站点与产品落地页要一套「无色相」设计语言时:近黑与暖白双模、正文 14px、按钮 4px 圆角、卡片 14px、无渐变、标题不外挂衬线,唯一强调色就是墨色本身(靠墨/纸互换与一条细线制造层次)。含 announce 条、吸顶 header、语言切换与主题按钮、tag/chip、定价卡、案例卡、表单与 footer 全套构件,加一套按用途命名的语义 token(深浅各一份)。

不适用场景

内容型/杂志型长文排版(走 ouuut-editorial 或 paper-editorial);需要三套以上主题或换肤;需要色相当信息编码(状态红绿、数据可视化配色)——这套语言里没有色相;要的是动效而不是配色(走 motion-kit)。

元数据

类目
主题 · 配色与字体
版本
v1.0.0
许可
MIT
规模
12 文件 · 146 KB
来源
make-site · assets/css/site.css

标签

  • monochrome
  • dual-theme
  • dark
  • light
  • marketing
  • landing-page
  • hairline
  • no-hue
  • announce-bar
  • forms
  • faq
  • pricing-cards

验证证据

2026-11-04 · python packs/token-harbor/scripts/assert_tokens.py(退出 0)与 python scripts/gate.py(exit 0)

assert_tokens 真实输出:『PASS assert_tokens token-harbor / 对比度实测 · 近黑(dark):ink/bg 14.78:1 · muted/bg 6.34:1(阈值 4.5:1,全部通过)/ 对比度实测 · 暖白(light):ink/bg 16.66:1 · muted/bg 5.02:1(阈值 4.5:1,全部通过)/ 反色块与页脚(次级实测):dark promo 14.78:1 · dark footer 18.67:1 · light promo 16.66:1 · light footer 18.01:1 / 原色表 38 色 + 6 影 · 语义 token 32 条 × 2 变体 · CSS 逐条比对通过 96 处(default :root 32 + themes 两作用域 64)/ 预览 preview/index.html:包内引用 2 个(外部 0、url() 0)· 页内锚点 9 个全部命中 id · 产物 12 文件 · 禁用内容形态交给 scripts/gate.py』(退出码 0)。gate 真实输出:『PASS gate: 0 findings, 33 packs, 31 assertions』,其中唯一提到本包的一行是 [assert] token-harbor: PASS,输出里没有任何 packs/token-harbor/ 前缀的命中行(本包已 git add 进索引,gate 因此对 pack.json 做 schema 校验、对包内文本做禁用形态扫描并跑了本包断言)。

归属与许可

  • 站点样式表(自有营销 / 服务型站点) · MIT
    原色板(近黑 / 暖白两套中性色 + 四级透明墨线 + 三档影)、全部构件规则与深浅双模逻辑的来源
  • sai-assets PACK-CONTRACT v1 · MIT
    包形状、pack.json 字段、断言最低集与 theme 类必填产物的规则来源

取用

固定版本(CDN)
<link rel="stylesheet" href="https://cdn.jsdelivr.net/gh/nakamotosai/sai-assets@pack/token-harbor@1.0.0/packs/token-harbor/css/default.css">
raw 直取(跟随 main)
curl -O https://raw.githubusercontent.com/nakamotosai/sai-assets/main/packs/token-harbor/SKILL.md
仓库内落地
python scripts/apply.py token-harbor --to <项目目录>
整包下载
https://assets.ouuut.com/downloads/token-harbor.zip

源码与规则

pack.json
{
  "schema": 1,
  "id": "token-harbor",
  "title": "Token Harbor · 墨色双模设计语言",
  "kind": "theme",
  "category": "themes",
  "version": "1.0.0",
  "license": "MIT",
  "attribution": [
    {
      "name": "站点样式表(自有营销 / 服务型站点)",
      "license": "MIT",
      "what": "原色板(近黑 / 暖白两套中性色 + 四级透明墨线 + 三档影)、全部构件规则与深浅双模逻辑的来源"
    },
    {
      "name": "sai-assets PACK-CONTRACT v1",
      "license": "MIT",
      "what": "包形状、pack.json 字段、断言最低集与 theme 类必填产物的规则来源"
    }
  ],
  "origin": {
    "project": "make-site",
    "path": "assets/css/site.css",
    "derived_from": null
  },
  "entry": "SKILL.md",
  "files": {
    "tokens": [
      "tokens/absolute.json",
      "tokens/index.json",
      "tokens/semantic/dark.json",
      "tokens/semantic/light.json"
    ],
    "css": [
      "css/default.css",
      "css/themes.css"
    ],
    "usage": "docs/usage.md",
    "assert": "scripts/assert_tokens.py",
    "preview": "preview/index.html"
  },
  "tags": [
    "monochrome",
    "dual-theme",
    "dark",
    "light",
    "marketing",
    "landing-page",
    "hairline",
    "no-hue",
    "announce-bar",
    "forms",
    "faq",
    "pricing-cards"
  ],
  "when": "营销 / 服务型站点与产品落地页要一套「无色相」设计语言时:近黑与暖白双模、正文 14px、按钮 4px 圆角、卡片 14px、无渐变、标题不外挂衬线,唯一强调色就是墨色本身(靠墨/纸互换与一条细线制造层次)。含 announce 条、吸顶 header、语言切换与主题按钮、tag/chip、定价卡、案例卡、表单与 footer 全套构件,加一套按用途命名的语义 token(深浅各一份)。",
  "not_for": "内容型/杂志型长文排版(走 ouuut-editorial 或 paper-editorial);需要三套以上主题或换肤;需要色相当信息编码(状态红绿、数据可视化配色)——这套语言里没有色相;要的是动效而不是配色(走 motion-kit)。",
  "default_variant": "dark",
  "verified": {
    "date": "2026-11-04",
    "how": "python packs/token-harbor/scripts/assert_tokens.py(退出 0)与 python scripts/gate.py(exit 0)",
    "evidence": "assert_tokens 真实输出:『PASS assert_tokens token-harbor / 对比度实测 · 近黑(dark):ink/bg 14.78:1 · muted/bg 6.34:1(阈值 4.5:1,全部通过)/ 对比度实测 · 暖白(light):ink/bg 16.66:1 · muted/bg 5.02:1(阈值 4.5:1,全部通过)/ 反色块与页脚(次级实测):dark promo 14.78:1 · dark footer 18.67:1 · light promo 16.66:1 · light footer 18.01:1 / 原色表 38 色 + 6 影 · 语义 token 32 条 × 2 变体 · CSS 逐条比对通过 96 处(default :root 32 + themes 两作用域 64)/ 预览 preview/index.html:包内引用 2 个(外部 0、url() 0)· 页内锚点 9 个全部命中 id · 产物 12 文件 · 禁用内容形态交给 scripts/gate.py』(退出码 0)。gate 真实输出:『PASS gate: 0 findings, 33 packs, 31 assertions』,其中唯一提到本包的一行是 [assert] token-harbor: PASS,输出里没有任何 packs/token-harbor/ 前缀的命中行(本包已 git add 进索引,gate 因此对 pack.json 做 schema 校验、对包内文本做禁用形态扫描并跑了本包断言)。"
  },
  "canonical_home": null,
  "changelog": [
    "1.0.0 · 首次发布:近黑(默认)/ 暖白双模 + 全套营销 / 服务型站点构件 + 按用途命名的语义 token 各一份(32 条 × 2),含四级墨线、promo 四件套与三档影"
  ]
}
css/default.css
/* Token Harbor · 墨色双模设计语言 —— 默认变体:近黑(dark)
   ------------------------------------------------------------------
   单文件即可用:一份 :root 暗色 token + 全部基础 chrome(重置 / 排版刻度 / 按钮 / tag / chip /
   announce 条 / 吸顶 header / 导航 / 语言与主题按钮 / hero / 分区头 / 作品卡 / 服务卡 / 定价卡 /
   附加项 / 维护包 / 流程 / why 卡 / FAQ / 案例卡 / 联系表单 / 页脚 / 响应式 / 减少动效 / 法务页)。
   深浅同页可切:再引一份 css/themes.css(那份只出 [data-theme] 作用域的 token 覆盖)。
   主张:无色相 —— 唯一强调色就是墨色本身,靠墨/纸互换与一条细线制造层次;无渐变;标题不外挂衬线。
   真值源:tokens/semantic/dark.json;本文件的 token 值由 scripts/assert_tokens.py 逐条比对。
   字号 / 圆角 / 布局刻度见 docs/usage.md §刻度。 */

/* ── 1 · token(暗色 = 默认) ─────────────────────────────────────────── */

:root {
  color-scheme: dark;

  /* 底与面 */
  --bg: #141413;
  --surface: #1b1b19;
  --surface-raised: #232320;

  /* 墨与灰字 */
  --ink: #e8e6e1;
  --muted: #9a9793;
  --muted-soft: #6f6c68;

  /* 四级透明墨线 */
  --line: rgba(255, 255, 255, 0.0902);
  --line-hairline: rgba(255, 255, 255, 0.0510);
  --line-field: rgba(255, 255, 255, 0.1608);
  --line-control: rgba(255, 255, 255, 0.3608);

  /* 交互洗色 */
  --surface-hover: rgba(255, 255, 255, 0.0392);
  --surface-pressed: rgba(255, 255, 255, 0.0784);

  /* 强调 = 墨本身;压在它上面的字用 on-accent */
  --accent: #e8e6e1;
  --on-accent: #141413;

  /* 反色块:announce 条与定价主推卡 */
  --promo-bg: #e8e6e1;
  --promo-fg: #141413;
  --promo-muted: rgba(20, 20, 19, 0.7);
  --promo-tag-bg: rgba(20, 20, 19, 0.12);

  /* 页脚:两模共用同一套深色 token */
  --footer-bg: #0c0d09;
  --footer-fg: #fafaf9;
  --footer-strong: rgba(250, 250, 249, 0.9);
  --footer-link: rgba(250, 250, 249, 0.6);
  --footer-muted: rgba(250, 250, 249, 0.55);
  --footer-faint: rgba(250, 250, 249, 0.45);
  --footer-line: rgba(250, 250, 249, 0.12);
  --footer-line-strong: rgba(250, 250, 249, 0.18);

  /* 图上叠加:与主题无关 */
  --overlay-bg: rgba(20, 20, 19, 0.72);
  --overlay-fg: #f7f6f2;
  --overlay-line: rgba(255, 255, 255, 0.14);

  /* 影:三档,只给浮起元素 */
  --shadow-btn: 0 1px rgba(0, 0, 0, 0.1020), 0 2px 4px rgba(0, 0, 0, 0.2000), 0 8px 22px -4px rgba(0, 0, 0, 0.3490);
  --shadow-card: 0 1px 2px rgba(0, 0, 0, 0.1333), 0 8px 24px -12px rgba(0, 0, 0, 0.2667);
  --shadow-pill: 0 1px rgba(0, 0, 0, 0.1490), 0 2px 4px rgba(0, 0, 0, 0.2000), 0 12px 28px -8px rgba(0, 0, 0, 0.3333);

  /* 字族:包内不引 webfont(零外部子资源),用系统栈回退 */
  --font-sans: "Inter", "Inter var", -apple-system, BlinkMacSystemFont, "Segoe UI",
    "Noto Sans SC", "Hiragino Kaku Gothic ProN", "Hiragino Sans", "Yu Gothic", "Meiryo", sans-serif;
  --font-mono: ui-monospace, SFMono-Regular, Menlo, Consolas, monospace;

  /* 字阶:12 档;组件局部的 11.5 / 12.5 / 13.5 是子档,直接写字面值 */
  --fs-display: 64px;
  --fs-section: 40px;
  --fs-case: 20px;
  --fs-sub: 18px;
  --fs-card: 17px;
  --fs-lede: 16px;
  --fs-body: 14px;
  --fs-small: 13px;
  --fs-meta: 12px;
  --fs-caption: 11px;
  --fs-eyebrow: 10.5px;

  /* 圆角:按钮 4 / 菜单 6 / chip 10 / 卡 14 / 胶囊 */
  --radius-btn: 4px;
  --radius-menu: 6px;
  --radius-chip: 10px;
  --radius-card: 14px;
  --radius-pill: 999px;

  /* 布局 */
  --maxw: 1240px;
  --maxw-narrow: 880px;
  --wrap-x: 24px;
  --sec-y: 80px;
  --anchor-offset: 96px;
  --hit: 44px;

  /* 动效:0.16 快互动 / 0.2 主题与影 / 0.18 常态 / 0.4 图像 */
  --dur-fast: 0.16s;
  --dur-base: 0.18s;
  --dur-mid: 0.2s;
  --dur-slow: 0.4s;
  --ease: cubic-bezier(0.22, 0.61, 0.36, 1);

  /* 跨包共存别名:项目里已占用 --bg 这类短名时,改用 --theme-* 引用 */
  --theme-bg: var(--bg);
  --theme-surface: var(--surface);
  --theme-surface-raised: var(--surface-raised);
  --theme-ink: var(--ink);
  --theme-muted: var(--muted);
  --theme-muted-soft: var(--muted-soft);
  --theme-line: var(--line);
  --theme-line-hairline: var(--line-hairline);
  --theme-accent: var(--accent);
  --theme-on-accent: var(--on-accent);
  --theme-promo-bg: var(--promo-bg);
  --theme-promo-fg: var(--promo-fg);
  --theme-footer-bg: var(--footer-bg);
  --theme-footer-fg: var(--footer-fg);
}

/* ── 2 · 重置与基础 ─────────────────────────────────────────────────── */

*, *::before, *::after { box-sizing: border-box; }
html, body { margin: 0; padding: 0; }
html {
  -webkit-text-size-adjust: 100%;
  scroll-behavior: smooth;
  scroll-padding-top: var(--anchor-offset);
}
body {
  background: var(--bg);
  color: var(--ink);
  font-family: var(--font-sans);
  font-feature-settings: "cv11", "ss01", "ss03";
  font-size: var(--fs-body);
  line-height: 1.55;
  -webkit-font-smoothing: antialiased;
  -moz-osx-font-smoothing: grayscale;
  text-rendering: optimizeLegibility;
  min-height: 100vh;
  display: flex;
  flex-direction: column;
  transition: background var(--dur-mid) ease, color var(--dur-mid) ease;
}

a { color: inherit; text-decoration: none; }
button, input, textarea, select { font: inherit; color: inherit; }
img, svg { display: block; max-width: 100%; }
img { height: auto; }
::selection { background: var(--accent); color: var(--on-accent); }

:focus-visible {
  outline: 2px solid var(--accent);
  outline-offset: 3px;
}

.sr-only {
  position: absolute;
  width: 1px; height: 1px;
  padding: 0; margin: -1px;
  overflow: hidden; clip: rect(0, 0, 0, 0);
  white-space: nowrap; border: 0;
}
.skip-link { position: absolute; left: -9999px; top: auto; }
.skip-link:focus {
  left: 8px; top: 8px; z-index: 9999;
  padding: 8px 16px;
  background: var(--accent); color: var(--on-accent);
  border-radius: var(--radius-btn);
}

/* ── 3 · 布局工具 ───────────────────────────────────────────────────── */

.wrap { max-width: var(--maxw); margin: 0 auto; padding: 0 var(--wrap-x); }
.wrap-narrow { max-width: var(--maxw-narrow); }
.text-center { text-align: center; }
.mt-2 { margin-top: 8px; }
.mt-3 { margin-top: 16px; }
.mt-4 { margin-top: 24px; }
.mt-6 { margin-top: 40px; }
.flex { display: flex; }
.items-center { align-items: center; }
.justify-center { justify-content: center; }
.gap-3 { gap: 12px; }

/* ── 4 · 排版刻度 ───────────────────────────────────────────────────── */

.eyebrow {
  display: block;
  margin: 0 0 10px;
  text-transform: uppercase;
  letter-spacing: 0.18em;
  color: var(--muted);
  font-size: var(--fs-eyebrow);
  font-weight: 800;
}
.h-display {
  margin: 0;
  font-size: var(--fs-display);
  font-weight: 700;
  line-height: 1.08;
  letter-spacing: -0.025em;
  color: var(--ink);
  text-wrap: balance;
}
.h-section {
  margin: 0;
  font-size: var(--fs-section);
  font-weight: 500;
  letter-spacing: -0.022em;
  line-height: 1.16;
  color: var(--ink);
  text-wrap: balance;
}
.h-card {
  margin: 0;
  font-size: var(--fs-card);
  font-weight: 700;
  line-height: 1.25;
  letter-spacing: -0.01em;
  color: var(--ink);
}
.lede {
  margin: 16px 0 0;
  font-size: var(--fs-lede);
  font-weight: 500;
  line-height: 1.55;
  color: var(--ink);
  opacity: 0.76;
  text-wrap: pretty;
}
.body-sm {
  margin: 0;
  font-size: 13.5px;
  line-height: 1.55;
  color: var(--ink);
  opacity: 0.76;
}
.muted { color: var(--muted); }
.muted-soft { color: var(--muted-soft); }

/* ── 5 · 按钮 / tag / chip ──────────────────────────────────────────── */

.btn {
  display: inline-flex;
  align-items: center;
  justify-content: center;
  gap: 8px;
  height: 36px;
  padding: 0 16px;
  font-size: var(--fs-small);
  font-weight: 500;
  line-height: 1;
  border: 0;
  border-radius: var(--radius-btn);
  cursor: pointer;
  white-space: nowrap;
  transition: transform var(--dur-fast) ease, box-shadow var(--dur-mid) ease,
    opacity var(--dur-fast) ease, background var(--dur-fast) ease,
    border-color var(--dur-fast) ease;
}
.btn-primary {
  background: var(--accent);
  color: var(--on-accent);
  box-shadow: var(--shadow-btn);
}
.btn-primary:hover { transform: translateY(-1px); color: var(--on-accent); opacity: 0.95; }
.btn-primary:active { transform: translateY(0); opacity: 0.9; }
.btn-outline {
  background: transparent;
  color: var(--ink);
  border: 1px solid var(--line-field);
}
.btn-outline:hover { background: var(--surface-hover); border-color: var(--line-control); }
.btn-lg { height: 44px; padding: 0 24px; font-size: var(--fs-body); }
.btn-sm { height: 32px; padding: 0 12px; font-size: var(--fs-meta); }

.tag {
  display: inline-flex;
  align-items: center;
  padding: 4px 10px;
  font-size: 11.5px;
  font-weight: 600;
  letter-spacing: -0.005em;
  background: var(--surface-pressed);
  color: var(--ink);
  border-radius: var(--radius-pill);
  line-height: 1.2;
  white-space: nowrap;
}
.icon-chip {
  display: inline-flex;
  align-items: center;
  justify-content: center;
  width: var(--hit);
  height: var(--hit);
  background: var(--surface-pressed);
  color: var(--ink);
  border-radius: var(--radius-chip);
  flex-shrink: 0;
}
.icon-chip svg { width: 20px; height: 20px; stroke-width: 2.2; }

/* ── 6 · announce 条 ───────────────────────────────────────────────── */

.announce {
  background: var(--promo-bg);
  color: var(--promo-fg);
  font-size: var(--fs-meta);
  font-weight: 500;
  line-height: 1.4;
  padding: 8px 0;
  border-bottom: 1px solid var(--line);
}
.announce-inner {
  display: flex;
  align-items: center;
  justify-content: center;
  gap: 8px;
  flex-wrap: wrap;
  text-align: center;
}
.announce-dot {
  width: 6px; height: 6px;
  border-radius: 50%;
  background: var(--promo-fg);
  flex-shrink: 0;
}

/* ── 7 · 吸顶 header / 导航 / 语言与主题按钮 ────────────────────────── */

.site-header {
  position: sticky;
  top: 0;
  z-index: 40;
  background: var(--bg);
  border-bottom: 1px solid var(--line);
}
.header-inner {
  display: flex;
  align-items: center;
  gap: 24px;
  padding-top: 14px;
  padding-bottom: 14px;
}
.brand {
  display: flex;
  align-items: center;
  gap: 8px;
  color: var(--ink);
  font-size: var(--fs-lede);
  font-weight: 800;
  letter-spacing: -0.01em;
  flex-shrink: 0;
}
/* 品牌标记:纯 CSS 画的方框含内芯,不引任何图片与字体;
   原站的 logo 图形是站点自有资产,本包用这个中性几何件占位(docs/usage.md §接入步骤 第 4 条)。 */
.brand-mark {
  position: relative;
  display: inline-block;
  width: 28px; height: 28px;
  flex-shrink: 0;
  border: 1.5px solid currentColor;
  border-radius: 3px;
}
.brand-mark::after {
  content: "";
  position: absolute;
  inset: 6px;
  background: currentColor;
  border-radius: 1px;
}
.brand-text { font-weight: 800; }
.brand-sub {
  font-size: 10px;
  font-weight: 500;
  color: var(--muted);
  letter-spacing: 0.08em;
  padding-left: 8px;
  margin-left: 4px;
  border-left: 1px solid var(--line-hairline);
}
.nav {
  display: flex;
  align-items: center;
  gap: 24px;
  font-size: var(--fs-body);
  font-weight: 500;
  color: var(--muted);
  margin-left: 8px;
}
.nav a { color: var(--muted); transition: color var(--dur-fast) ease; }
.nav a:hover { color: var(--ink); }
.nav-cta { display: none; }
.header-actions {
  display: flex;
  align-items: center;
  gap: 10px;
  margin-left: auto;
}
.lang-switch {
  display: flex;
  align-items: center;
  gap: 2px;
  font-size: var(--fs-meta);
  font-weight: 500;
}
.lang-switch a {
  padding: 6px 8px;
  border-radius: var(--radius-btn);
  color: var(--muted);
  transition: color var(--dur-fast) ease, background var(--dur-fast) ease;
}
.lang-switch a:hover { background: var(--surface-hover); color: var(--ink); }
.lang-switch a.is-active { color: var(--ink); background: var(--surface-pressed); }

.theme-toggle {
  display: inline-flex;
  align-items: center;
  justify-content: center;
  width: var(--hit); height: var(--hit);
  padding: 0;
  border: 0;
  border-radius: var(--radius-btn);
  background: transparent;
  color: var(--muted);
  cursor: pointer;
  transition: color var(--dur-fast) ease, background var(--dur-fast) ease;
}
.theme-toggle:hover { background: var(--surface-hover); color: var(--ink); }
.theme-toggle svg { width: 17px; height: 17px; stroke-width: 1.8; }
.theme-toggle .icon-moon { display: none; }
html[data-theme="light"] .theme-toggle .icon-sun { display: none; }
html[data-theme="light"] .theme-toggle .icon-moon { display: block; }

.menu-toggle {
  display: none;
  background: none;
  border: 0;
  width: var(--hit); height: var(--hit);
  align-items: center;
  justify-content: center;
  flex-direction: column;
  gap: 4px;
  cursor: pointer;
  border-radius: var(--radius-btn);
  color: var(--ink);
}
.menu-toggle:hover { background: var(--surface-hover); }
.menu-toggle span {
  display: block;
  width: 18px; height: 1.5px;
  background: currentColor;
  transition: transform var(--dur-base) ease;
}
.menu-toggle[aria-expanded="true"] span:first-child { transform: translateY(2.75px) rotate(45deg); }
.menu-toggle[aria-expanded="true"] span:last-child { transform: translateY(-2.75px) rotate(-45deg); }

/* ── 8 · hero ───────────────────────────────────────────────────────── */

.hero {
  position: relative;
  display: flex;
  flex-direction: column;
  align-items: center;
  justify-content: center;
  min-height: calc(100dvh - 260px);
  padding: 64px var(--wrap-x) 48px;
  text-align: center;
  overflow: hidden;
}
.hero-pill {
  display: inline-flex;
  align-items: center;
  gap: 10px;
  max-width: 92vw;
  padding: 10px 18px;
  font-size: 12.5px;
  font-weight: 600;
  color: var(--ink);
  background: var(--surface);
  border: 1px solid var(--line-hairline);
  border-radius: var(--radius-pill);
  box-shadow: var(--shadow-pill);
  margin-bottom: 28px;
}
.hero-pill .dot {
  width: 6px; height: 6px;
  border-radius: 50%;
  background: var(--ink);
  flex-shrink: 0;
}
.hero-title {
  margin: 0;
  font-size: var(--fs-display);
  font-weight: 700;
  line-height: 1.08;
  letter-spacing: -0.028em;
  color: var(--ink);
  max-width: 980px;
  text-wrap: balance;
}
.hero-sub {
  margin: 20px 0 0;
  max-width: 720px;
  font-size: var(--fs-lede);
  font-weight: 500;
  line-height: 1.55;
  color: var(--ink);
  opacity: 0.76;
  text-wrap: pretty;
}
.hero-actions {
  display: flex;
  align-items: center;
  justify-content: center;
  gap: 12px;
  flex-wrap: wrap;
  margin-top: 32px;
}
.hero-note {
  margin: 18px 0 0;
  font-size: var(--fs-meta);
  color: var(--muted);
}
.hero-proof {
  display: flex;
  align-items: stretch;
  justify-content: center;
  gap: 0;
  flex-wrap: wrap;
  margin-top: 48px;
  border-top: 1px solid var(--line-hairline);
  border-bottom: 1px solid var(--line-hairline);
}
.proof-item {
  min-width: 150px;
  padding: 18px 28px;
  text-align: center;
}
.proof-item + .proof-item { border-left: 1px solid var(--line-hairline); }
.proof-value {
  display: block;
  font-size: 24px;
  font-weight: 700;
  letter-spacing: -0.02em;
  line-height: 1;
}
.proof-label {
  display: block;
  margin-top: 7px;
  font-size: var(--fs-caption);
  font-weight: 500;
  color: var(--muted);
  letter-spacing: 0.02em;
}

/* ── 9 · 分区头 ─────────────────────────────────────────────────────── */

.section { padding: var(--sec-y) var(--wrap-x) 64px; }
.section-head { text-align: center; margin-bottom: 44px; }
.section-head .eyebrow { margin-bottom: 10px; }
.section-head .lede { max-width: 640px; margin-left: auto; margin-right: auto; }
.section-head--left { text-align: left; }
.section-head--left .lede { margin-left: 0; }

/* ── 10 · 作品卡 ────────────────────────────────────────────────────── */

.work-grid {
  display: grid;
  grid-template-columns: repeat(2, minmax(0, 1fr));
  gap: 16px;
}
.work-card {
  display: flex;
  flex-direction: column;
  background: var(--surface);
  border: 1px solid var(--line-hairline);
  border-radius: var(--radius-card);
  overflow: hidden;
  transition: transform var(--dur-base) ease, box-shadow var(--dur-base) ease,
    border-color var(--dur-base) ease;
}
.work-card:hover {
  transform: translateY(-2px);
  box-shadow: var(--shadow-card);
  border-color: var(--line-field);
}
.work-media {
  position: relative;
  aspect-ratio: 16 / 10;
  overflow: hidden;
  background: var(--surface-raised);
  border-bottom: 1px solid var(--line-hairline);
}
.work-media img {
  width: 100%; height: 100%;
  object-fit: cover;
  transition: transform var(--dur-slow) var(--ease);
}
.work-card:hover .work-media img { transform: scale(1.025); }
.work-type {
  position: absolute;
  top: 12px; left: 12px;
  background: var(--overlay-bg);
  color: var(--overlay-fg);
  border: 1px solid var(--overlay-line);
  backdrop-filter: blur(8px);
  -webkit-backdrop-filter: blur(8px);
}
.work-body {
  display: flex;
  flex-direction: column;
  gap: 10px;
  padding: 22px 22px 24px;
}
.work-top {
  display: flex;
  align-items: baseline;
  justify-content: space-between;
  gap: 12px;
}
.work-title { font-size: var(--fs-lede); font-weight: 700; letter-spacing: -0.01em; }
.work-arrow { color: var(--muted); font-size: var(--fs-small); flex-shrink: 0; }
.work-desc { margin: 0; font-size: var(--fs-small); line-height: 1.55; color: var(--muted); }
.work-tags { display: flex; flex-wrap: wrap; gap: 6px; margin-top: 2px; }
.work-tags .tag { font-size: var(--fs-eyebrow); padding: 3px 8px; }
.work-all { margin-top: 32px; text-align: center; }
.work-all a {
  font-size: var(--fs-small);
  font-weight: 500;
  color: var(--ink);
  text-decoration: underline;
  text-underline-offset: 4px;
  text-decoration-color: var(--line-control);
}
.work-all a:hover { text-decoration-color: var(--ink); }

/* ── 11 · 服务卡 ────────────────────────────────────────────────────── */

.services-grid {
  display: grid;
  grid-template-columns: repeat(3, minmax(0, 1fr));
  gap: 16px;
}
.service-card {
  display: flex;
  flex-direction: column;
  gap: 14px;
  padding: 28px;
  background: var(--surface);
  border: 1px solid var(--line-hairline);
  border-radius: var(--radius-card);
}
.service-card .tag { align-self: flex-start; }
.service-card p { margin: 0; font-size: 13.5px; line-height: 1.55; color: var(--muted); }
.service-tags { display: flex; flex-wrap: wrap; gap: 6px; margin-top: auto; }
.service-tags .tag { font-size: var(--fs-eyebrow); padding: 3px 8px; }

/* ── 12 · 定价卡 ────────────────────────────────────────────────────── */

.pricing-grid {
  display: grid;
  grid-template-columns: repeat(3, minmax(0, 1fr));
  gap: 16px;
  align-items: stretch;
}
.sku-card {
  display: flex;
  flex-direction: column;
  gap: 16px;
  padding: 28px 24px;
  background: var(--surface);
  border: 1px solid var(--line-hairline);
  border-radius: var(--radius-card);
  transition: transform var(--dur-base) ease, box-shadow var(--dur-base) ease,
    border-color var(--dur-base) ease;
}
.sku-card:hover { transform: translateY(-2px); box-shadow: var(--shadow-card); border-color: var(--line-field); }
.sku-name {
  display: flex;
  align-items: center;
  justify-content: space-between;
  gap: 8px;
  font-size: var(--fs-body);
  font-weight: 600;
  color: var(--muted);
}
.sku-price { display: flex; align-items: baseline; gap: 6px; flex-wrap: wrap; }
.sku-price-num { font-size: 38px; font-weight: 700; letter-spacing: -0.025em; line-height: 1; color: var(--ink); }
.sku-price-unit { font-size: var(--fs-meta); color: var(--muted); }
.sku-desc { margin: 0; font-size: var(--fs-small); line-height: 1.55; color: var(--muted); flex: 1; }
.sku-features {
  list-style: none;
  margin: 0; padding: 0;
  display: flex; flex-direction: column; gap: 10px;
  font-size: var(--fs-small); line-height: 1.5;
}
.sku-features li { display: flex; align-items: flex-start; gap: 8px; }
.sku-features li::before { content: "✓"; font-weight: 700; flex-shrink: 0; color: var(--ink); }

/* 主推卡:整块翻成反色(promo-*),两模共用同一套规则,不再写 html[data-theme="light"] 分支 */
.sku-card.is-featured {
  background: var(--promo-bg);
  color: var(--promo-fg);
  border-color: var(--promo-bg);
  box-shadow: var(--shadow-card);
}
.sku-card.is-featured .sku-name,
.sku-card.is-featured .sku-price-unit,
.sku-card.is-featured .sku-desc { color: var(--promo-muted); }
.sku-card.is-featured .sku-price-num { color: var(--promo-fg); }
.sku-card.is-featured .sku-features { color: var(--promo-fg); }
.sku-card.is-featured .sku-features li::before { color: var(--promo-fg); }
.sku-card.is-featured .btn-primary {
  background: var(--promo-fg);
  color: var(--promo-bg);
  box-shadow: none;
}
.sku-card.is-featured .tag { background: var(--promo-tag-bg); color: var(--promo-fg); }
.pricing-note { margin: 24px auto 0; max-width: 760px; text-align: center; font-size: var(--fs-meta); color: var(--muted); }

.extras-wrap { margin-top: 64px; }
.extras-head { display: flex; align-items: baseline; justify-content: space-between; gap: 16px; flex-wrap: wrap; margin-bottom: 18px; }
.extras-head h3 { margin: 0; font-size: var(--fs-sub); font-weight: 600; letter-spacing: -0.01em; }
.extras-head span { font-size: var(--fs-meta); color: var(--muted); }
.extras-grid { display: grid; grid-template-columns: repeat(2, minmax(0, 1fr)); gap: 1px; background: var(--line-hairline); border: 1px solid var(--line-hairline); border-radius: var(--radius-card); overflow: hidden; }
.extra-row { display: flex; align-items: flex-start; justify-content: space-between; gap: 18px; padding: 18px 20px; background: var(--surface); }
.extra-name { font-size: 13.5px; font-weight: 600; }
.extra-desc { margin: 4px 0 0; font-size: var(--fs-meta); line-height: 1.5; color: var(--muted); }
.extra-price { font-size: var(--fs-meta); font-weight: 600; color: var(--ink); white-space: nowrap; text-align: right; }

.care-wrap { margin-top: 64px; }
.care-grid { display: grid; grid-template-columns: repeat(3, minmax(0, 1fr)); gap: 16px; }
.care-card { padding: 24px; background: var(--surface); border: 1px solid var(--line-hairline); border-radius: var(--radius-card); }
.care-top { display: flex; align-items: baseline; justify-content: space-between; gap: 12px; }
.care-name { font-size: var(--fs-body); font-weight: 700; }
.care-price { font-size: var(--fs-case); font-weight: 700; letter-spacing: -0.02em; }
.care-price span { font-size: var(--fs-caption); font-weight: 500; color: var(--muted); }
.care-list { list-style: none; margin: 14px 0 0; padding: 0; display: flex; flex-direction: column; gap: 8px; font-size: 12.5px; color: var(--muted); }
.care-list li { display: flex; gap: 8px; }
.care-list li::before { content: "·"; color: var(--ink); font-weight: 700; }

/* ── 13 · 流程 ──────────────────────────────────────────────────────── */

.process-grid {
  display: grid;
  grid-template-columns: repeat(5, minmax(0, 1fr));
  gap: 0;
  border-top: 1px solid var(--line-hairline);
}
.process-step {
  padding: 24px 20px 0 0;
  border-right: 1px solid var(--line-hairline);
}
.process-step:last-child { border-right: 0; padding-right: 0; }
.process-step + .process-step { padding-left: 20px; }
.process-num { display: block; font-size: var(--fs-caption); font-weight: 700; letter-spacing: 0.12em; color: var(--muted); }
.process-title { margin: 12px 0 0; font-size: 15px; font-weight: 700; }
.process-desc { margin: 8px 0 0; font-size: 12.5px; line-height: 1.55; color: var(--muted); }

/* ── 14 · why 卡 ────────────────────────────────────────────────────── */

.why-grid { display: grid; grid-template-columns: repeat(2, minmax(0, 1fr)); gap: 16px; }
.why-card { padding: 28px; background: var(--surface); border: 1px solid var(--line-hairline); border-radius: var(--radius-card); }
.why-card h3 { margin: 0 0 8px; font-size: var(--fs-lede); font-weight: 700; letter-spacing: -0.01em; }
.why-card p { margin: 0; font-size: var(--fs-small); line-height: 1.55; color: var(--muted); }

/* ── 15 · FAQ ───────────────────────────────────────────────────────── */

.faq-list { max-width: 840px; margin: 0 auto; border-top: 1px solid var(--line-hairline); }
.faq-item { border-bottom: 1px solid var(--line-hairline); }
.faq-item summary {
  display: flex;
  align-items: center;
  justify-content: space-between;
  gap: 18px;
  padding: 20px 0;
  cursor: pointer;
  list-style: none;
  font-size: var(--fs-body);
  font-weight: 600;
}
.faq-item summary::-webkit-details-marker { display: none; }
.faq-item summary::after {
  content: "+";
  font-size: var(--fs-sub);
  font-weight: 400;
  color: var(--muted);
  transition: transform var(--dur-fast) ease;
}
.faq-item[open] summary::after { transform: rotate(45deg); }
.faq-answer { padding: 0 0 22px; max-width: 720px; font-size: 13.5px; line-height: 1.65; color: var(--muted); }

/* ── 16 · 案例卡 ────────────────────────────────────────────────────── */

.case-grid {
  display: grid;
  grid-template-columns: repeat(3, minmax(0, 1fr));
  gap: 16px;
}
.case-card {
  display: flex;
  flex-direction: column;
  gap: 16px;
  padding: 28px;
  background: var(--surface);
  border: 1px solid var(--line-hairline);
  border-radius: var(--radius-card);
}
.case-label {
  font-size: var(--fs-eyebrow);
  font-weight: 800;
  letter-spacing: 0.16em;
  color: var(--muted);
}
.case-title {
  margin: 0;
  font-size: var(--fs-case);
  font-weight: 700;
  line-height: 1.2;
  letter-spacing: -0.015em;
  text-wrap: balance;
}
.case-list { margin: 0; display: flex; flex-direction: column; gap: 12px; }
.case-list div { border-top: 1px solid var(--line-hairline); padding-top: 12px; }
.case-list dt {
  margin-bottom: 4px;
  font-size: 10px;
  font-weight: 700;
  letter-spacing: 0.14em;
  text-transform: uppercase;
  color: var(--muted);
}
.case-list dd { margin: 0; font-size: var(--fs-small); line-height: 1.55; color: var(--ink); opacity: 0.78; }
.case-foot {
  display: flex;
  align-items: center;
  justify-content: space-between;
  gap: 12px;
  flex-wrap: wrap;
  margin-top: auto;
}
.case-tags { display: flex; flex-wrap: wrap; gap: 6px; }
.case-tags .tag { font-size: var(--fs-eyebrow); padding: 3px 8px; }
.case-foot > a {
  font-size: var(--fs-meta);
  font-weight: 500;
  color: var(--ink);
  text-decoration: underline;
  text-underline-offset: 4px;
  text-decoration-color: var(--line-control);
}
.case-foot > a:hover { text-decoration-color: var(--ink); }

/* ── 17 · 联系区与表单 ──────────────────────────────────────────────── */

.contact-section { padding: var(--sec-y) var(--wrap-x) 96px; }
.contact-layout {
  display: grid;
  grid-template-columns: minmax(0, 0.9fr) minmax(0, 1.1fr);
  gap: 48px;
  align-items: start;
  max-width: 1080px;
}
.contact-intro { padding-top: 20px; }
.contact-note { margin: 20px 0 0; font-size: var(--fs-meta); color: var(--muted); }
.contact-checklist { display: flex; flex-wrap: wrap; gap: 8px; margin-top: 20px; }
.contact-checklist span {
  font-size: var(--fs-caption);
  color: var(--muted);
  border: 1px solid var(--line-hairline);
  border-radius: var(--radius-pill);
  padding: 5px 10px;
}
.contact-fallback { margin: 24px 0 0; font-size: var(--fs-meta); color: var(--muted); }
.contact-fallback a {
  color: var(--ink);
  text-decoration: underline;
  text-underline-offset: 3px;
}
.contact-form-card {
  padding: 32px;
  background: var(--surface);
  border: 1px solid var(--line-hairline);
  border-radius: var(--radius-card);
  box-shadow: var(--shadow-card);
}
.form-title { margin: 0 0 20px; font-size: var(--fs-sub); font-weight: 700; letter-spacing: -0.01em; }
.project-form { display: flex; flex-direction: column; gap: 16px; }
.field-row { display: grid; grid-template-columns: 1fr 1fr; gap: 12px; }
.field { display: flex; flex-direction: column; gap: 6px; font-size: var(--fs-meta); font-weight: 600; }
.field span { color: var(--ink); }
.field em { font-style: normal; font-weight: 400; color: var(--muted); }
.field input,
.field select,
.field textarea {
  width: 100%;
  padding: 10px 12px;
  font-size: var(--fs-small);
  font-weight: 400;
  color: var(--ink);
  background: var(--bg);
  border: 1px solid var(--line-field);
  border-radius: var(--radius-btn);
  outline: none;
  transition: border-color var(--dur-fast) ease, box-shadow var(--dur-fast) ease;
}
.field input:focus,
.field select:focus,
.field textarea:focus {
  border-color: var(--ink);
  box-shadow: 0 0 0 3px var(--surface-pressed);
}
.field textarea { min-height: 120px; resize: vertical; }
.field small { font-size: var(--fs-caption); font-weight: 400; color: var(--muted); }

/* 校验态:这套语言里没有色相,报错靠"加粗描边 + 圆形叹号 + 文案",不靠红绿 */
.field-error {
  display: flex;
  align-items: center;
  gap: 6px;
  font-size: var(--fs-caption);
  font-weight: 600;
  color: var(--ink);
}
.field-error[hidden] { display: none; }
.field-error::before {
  content: "!";
  display: inline-grid;
  place-items: center;
  width: 14px; height: 14px;
  border: 1px solid var(--ink);
  border-radius: 50%;
  font-size: 9px;
  line-height: 1;
  flex-shrink: 0;
}
.field input[aria-invalid="true"],
.field select[aria-invalid="true"],
.field textarea[aria-invalid="true"] {
  border-color: var(--ink);
  box-shadow: inset 0 0 0 1px var(--ink);
}

.check {
  display: flex;
  align-items: flex-start;
  gap: 8px;
  font-size: var(--fs-meta);
  font-weight: 400;
  line-height: 1.5;
  color: var(--muted);
}
.check input { margin-top: 2px; accent-color: var(--accent); }
.honeypot {
  position: absolute;
  left: -9999px;
  width: 1px;
  height: 1px;
  overflow: hidden;
}
.form-status { min-height: 20px; margin: 0; font-size: var(--fs-meta); color: var(--muted); }
.form-status.is-ok { color: var(--ink); font-weight: 600; }
.form-status.is-error { color: var(--ink); font-weight: 600; }
.form-privacy { margin: 0; font-size: var(--fs-caption); line-height: 1.5; color: var(--muted); }

/* ── 18 · 页脚 ──────────────────────────────────────────────────────── */

.site-footer { margin-top: auto; background: var(--footer-bg); color: var(--footer-fg); }
.footer-grid {
  display: grid;
  grid-template-columns: 2fr 1fr 1fr 1fr;
  gap: 40px;
  padding-top: 64px;
  padding-bottom: 48px;
}
.footer-brand .brand { color: var(--footer-fg); margin-bottom: 16px; }
.footer-brand .brand-mark { width: 26px; height: 26px; }
.footer-brand .brand-sub { color: var(--footer-faint); border-left-color: var(--footer-line-strong); }
.footer-tagline { max-width: 300px; margin: 16px 0 20px; font-size: var(--fs-small); line-height: 1.6; color: var(--footer-muted); }
.footer-company, .footer-meta { margin: 6px 0 0; font-size: 11.5px; line-height: 1.6; color: var(--footer-muted); }
.footer-col h2 { margin: 0 0 16px; font-size: var(--fs-meta); font-weight: 600; color: var(--footer-strong); }
.footer-col a { display: block; margin-bottom: 10px; font-size: 12.5px; color: var(--footer-link); }
.footer-col a:hover { color: var(--footer-fg); }
.footer-bottom {
  display: flex;
  align-items: center;
  justify-content: space-between;
  gap: 16px;
  flex-wrap: wrap;
  padding-top: 20px;
  padding-bottom: 28px;
  border-top: 1px solid var(--footer-line);
  font-size: var(--fs-caption);
  color: var(--footer-muted);
}
.footer-bottom p { margin: 0; }
.footer-lang { display: flex; gap: 12px; }
.footer-lang a { color: var(--footer-link); }

/* ── 19 · 响应式 ────────────────────────────────────────────────────── */

@media (max-width: 1100px) {
  .pricing-grid { grid-template-columns: repeat(2, minmax(0, 1fr)); }
  .pricing-grid .sku-card:last-child { grid-column: 1 / -1; }
  .case-grid { grid-template-columns: repeat(2, minmax(0, 1fr)); }
}
@media (max-width: 960px) {
  .nav {
    display: none;
    position: absolute;
    left: 0; right: 0;
    top: 100%;
    flex-direction: column;
    align-items: stretch;
    background: var(--bg);
    border-bottom: 1px solid var(--line-hairline);
    padding: 12px 24px 20px;
    gap: 4px;
    margin-left: 0;
  }
  .nav.is-open { display: flex; }
  .nav a { padding: 10px 12px; border-radius: var(--radius-menu); }
  .nav a:hover { background: var(--surface-hover); }
  .nav a.nav-cta { color: var(--on-accent); }
  .nav a.nav-cta:hover { color: var(--on-accent); }
  .nav-cta {
    display: block;
    margin-top: 8px;
    padding: 11px 12px;
    text-align: center;
    background: var(--accent);
    color: var(--on-accent);
    border-radius: var(--radius-btn);
    font-weight: 600;
  }
  .nav-cta:hover { background: var(--accent); color: var(--on-accent); opacity: 0.95; }
  .menu-toggle { display: inline-flex; }
  .header-cta { display: none; }
  .process-grid { grid-template-columns: repeat(2, minmax(0, 1fr)); }
  .process-step { border-right: 0; padding: 24px 20px 0 0; }
  .process-step + .process-step { padding-left: 0; }
  .process-step:nth-child(even) { padding-left: 20px; }
  .contact-layout { grid-template-columns: 1fr; gap: 32px; }
  .contact-intro { padding-top: 0; }
  .footer-grid { grid-template-columns: 1fr 1fr; }
}
@media (max-width: 768px) {
  .h-display { font-size: 38px; }
  .h-section { font-size: 28px; }
  .hero { min-height: auto; padding: 56px 20px 48px; }
  .hero-title { font-size: 38px; }
  .hero-sub { font-size: var(--fs-body); }
  .hero-pill { font-size: 11.5px; padding: 8px 14px; }
  .hero-proof { margin-top: 36px; }
  .proof-item { min-width: 0; flex: 1; padding: 16px 10px; }
  .proof-value { font-size: var(--fs-case); }
  .proof-label { font-size: 10px; }
  .section { padding: 64px 20px 48px; }
  .work-grid, .services-grid, .why-grid, .extras-grid, .care-grid, .case-grid { grid-template-columns: 1fr; }
  .pricing-grid { grid-template-columns: 1fr; }
  .pricing-grid .sku-card:last-child { grid-column: auto; }
  .process-grid { grid-template-columns: 1fr; }
  .process-step, .process-step:nth-child(even) { padding: 20px 0 0; }
  .process-step + .process-step { border-top: 1px solid var(--line-hairline); margin-top: 20px; }
  .contact-form-card { padding: 24px; }
  .footer-grid { grid-template-columns: 1fr 1fr; gap: 28px; padding-top: 48px; }
  .footer-brand { grid-column: 1 / -1; }
  .footer-bottom { flex-direction: column; align-items: flex-start; }
}
@media (max-width: 560px) {
  .brand-sub { display: none; }
  .brand { font-size: var(--fs-body); gap: 6px; }
  .brand-mark { width: 24px; height: 24px; }
  .lang-switch { display: flex; }
  .lang-switch a { padding: 4px 5px; font-size: var(--fs-caption); }
  .header-inner { gap: 8px; }
  .header-actions { gap: 4px; }
  .footer-grid { grid-template-columns: 1fr; }
  .hero-actions .btn { width: 100%; }
  .field-row { grid-template-columns: 1fr; }
  .contact-form-card { padding: 20px 16px; }
}

/* ── 20 · 减少动效 ──────────────────────────────────────────────────── */

@media (prefers-reduced-motion: reduce) {
  html { scroll-behavior: auto; }
  *, *::before, *::after {
    animation-duration: 0.01ms !important;
    animation-iteration-count: 1 !important;
    transition-duration: 0.01ms !important;
  }
  .work-card:hover, .sku-card:hover { transform: none; }
  .work-card:hover .work-media img { transform: none; }
}

/* ── 21 · 法务页 ────────────────────────────────────────────────────── */

.legal { max-width: 760px; padding: 72px 0 96px; }
.legal h1 { margin: 0 0 16px; font-size: var(--fs-section); font-weight: 500; letter-spacing: -0.022em; }
.legal h2 { margin: 40px 0 12px; font-size: var(--fs-sub); font-weight: 700; letter-spacing: -0.01em; }
.legal p, .legal li { margin: 0 0 12px; font-size: var(--fs-body); line-height: 1.7; color: var(--muted); }
.legal ul { padding-left: 20px; }
.legal a { color: var(--ink); text-decoration: underline; text-underline-offset: 3px; }
.legal .legal-back { display: inline-block; margin-bottom: 32px; font-size: var(--fs-meta); color: var(--muted); }
.legal .legal-meta { margin-top: 40px; font-size: var(--fs-caption); color: var(--muted-soft); }
.legal .legal-zh, .legal .legal-ja { margin-top: 56px; padding-top: 32px; border-top: 1px solid var(--line-hairline); }
css/themes.css
/* Token Harbor · 多主题并存版:只出 [data-theme="dark"] / [data-theme="light"] 两个作用域的 token 覆盖
   ------------------------------------------------------------------
   这份文件里没有任何构件规则,只有颜色与影。用法:
     1) 项目已有自己的组件样式 —— 只引这一份,在 <html data-theme="dark|light"> 上切换;
     2) 想连基础 chrome 一起拿 —— default.css(近黑 + 全部构件)+ 这一份(补暖白)。
   两模共用同一套键名;footer-* 与 overlay-* 两模同值(页脚本来就是深色块、图上徽标本来就压在图里)。
   圆角 / 字号 / 布局刻度的 token 在 css/default.css 的 :root,本文件不重复(见 docs/usage.md §刻度)。
   真值源:tokens/semantic/dark.json 与 tokens/semantic/light.json;本文件的值由 scripts/assert_tokens.py 逐条比对。 */

[data-theme="dark"] {
  color-scheme: dark;

  --bg: #141413;
  --surface: #1b1b19;
  --surface-raised: #232320;
  --ink: #e8e6e1;
  --muted: #9a9793;
  --muted-soft: #6f6c68;
  --line: rgba(255, 255, 255, 0.0902);
  --line-hairline: rgba(255, 255, 255, 0.0510);
  --line-field: rgba(255, 255, 255, 0.1608);
  --line-control: rgba(255, 255, 255, 0.3608);
  --surface-hover: rgba(255, 255, 255, 0.0392);
  --surface-pressed: rgba(255, 255, 255, 0.0784);
  --accent: #e8e6e1;
  --on-accent: #141413;
  --promo-bg: #e8e6e1;
  --promo-fg: #141413;
  --promo-muted: rgba(20, 20, 19, 0.7);
  --promo-tag-bg: rgba(20, 20, 19, 0.12);
  --footer-bg: #0c0d09;
  --footer-fg: #fafaf9;
  --footer-strong: rgba(250, 250, 249, 0.9);
  --footer-link: rgba(250, 250, 249, 0.6);
  --footer-muted: rgba(250, 250, 249, 0.55);
  --footer-faint: rgba(250, 250, 249, 0.45);
  --footer-line: rgba(250, 250, 249, 0.12);
  --footer-line-strong: rgba(250, 250, 249, 0.18);
  --overlay-bg: rgba(20, 20, 19, 0.72);
  --overlay-fg: #f7f6f2;
  --overlay-line: rgba(255, 255, 255, 0.14);
  --shadow-btn: 0 1px rgba(0, 0, 0, 0.1020), 0 2px 4px rgba(0, 0, 0, 0.2000), 0 8px 22px -4px rgba(0, 0, 0, 0.3490);
  --shadow-card: 0 1px 2px rgba(0, 0, 0, 0.1333), 0 8px 24px -12px rgba(0, 0, 0, 0.2667);
  --shadow-pill: 0 1px rgba(0, 0, 0, 0.1490), 0 2px 4px rgba(0, 0, 0, 0.2000), 0 12px 28px -8px rgba(0, 0, 0, 0.3333);
}

[data-theme="light"] {
  color-scheme: light;

  --bg: #f7f6f2;
  --surface: #ffffff;
  --surface-raised: #faf9f5;
  --ink: #17170f;
  --muted: #6b6a64;
  --muted-soft: #96948d;
  --line: rgba(23, 23, 15, 0.1020);
  --line-hairline: rgba(23, 23, 15, 0.0588);
  --line-field: rgba(23, 23, 15, 0.2392);
  --line-control: rgba(23, 23, 15, 0.5020);
  --surface-hover: rgba(23, 23, 15, 0.0353);
  --surface-pressed: rgba(23, 23, 15, 0.0588);
  --accent: #17170f;
  --on-accent: #f7f6f2;
  --promo-bg: #17170f;
  --promo-fg: #f7f6f2;
  --promo-muted: rgba(247, 246, 242, 0.7);
  --promo-tag-bg: rgba(247, 246, 242, 0.16);
  --footer-bg: #11120d;
  --footer-fg: #fafaf9;
  --footer-strong: rgba(250, 250, 249, 0.9);
  --footer-link: rgba(250, 250, 249, 0.6);
  --footer-muted: rgba(250, 250, 249, 0.55);
  --footer-faint: rgba(250, 250, 249, 0.45);
  --footer-line: rgba(250, 250, 249, 0.12);
  --footer-line-strong: rgba(250, 250, 249, 0.18);
  --overlay-bg: rgba(20, 20, 19, 0.72);
  --overlay-fg: #f7f6f2;
  --overlay-line: rgba(255, 255, 255, 0.14);
  --shadow-btn: 0 1px rgba(0, 0, 0, 0.0588), 0 2px 4px rgba(26, 25, 24, 0.1412), 0 8px 22px -4px rgba(26, 25, 24, 0.2784);
  --shadow-card: 0 1px 2px rgba(23, 23, 15, 0.0392), 0 8px 24px -12px rgba(23, 23, 15, 0.1020);
  --shadow-pill: 0 1px rgba(26, 25, 24, 0.0510), 0 2px 4px rgba(26, 25, 24, 0.0588), 0 12px 28px -8px rgba(26, 25, 24, 0.1608);
}
tokens/absolute.json
{
  "id": "token-harbor",
  "note": "原色表:只收源样式表里实际出现的原子值(去重后 38 个色值 + 6 组影),不设近似值、不设外推色。色值一律 6 位 hex 或 rgba();影值里的每个颜色段也必须是这两种之一。",
  "alpha": "源表用 8 位 hex 写透明度(#rrggbbaa),本表统一折算为 rgba(r, g, b, aa/255) 并保留四位小数:23/255=0.0902、13/255=0.0510、41/255=0.1608、92/255=0.3608、10/255=0.0392、20/255=0.0784、26/255=0.1020、15/255=0.0588、61/255=0.2392、128/255=0.5020、9/255=0.0353、36/255=0.1412、71/255=0.2784、34/255=0.1333、68/255=0.2667、38/255=0.1490、51/255=0.2000、85/255=0.3333、89/255=0.3490。",
  "colors": {
    "#141413": {
      "section": ["变量块 · 暗模", "定价 · 主推卡"],
      "origin": ["--background", "--promo-fg", ".sku-card.is-featured 的文字与按钮底"],
      "used_as": ["暗模 bg", "accent 上的文字 on-accent", "promo-fg"]
    },
    "#1b1b19": {
      "section": ["变量块 · 暗模"],
      "origin": ["--card"],
      "used_as": ["暗模 surface(卡面、hero 胶囊底)"]
    },
    "#232320": {
      "section": ["变量块 · 暗模"],
      "origin": ["--raised"],
      "used_as": ["暗模 surface-raised(媒体框底)"]
    },
    "#e8e6e1": {
      "section": ["变量块 · 暗模", "定价 · 主推卡"],
      "origin": ["--foreground", "--accent-fg", "--promo-bg", ".sku-card.is-featured 的底与按钮文字"],
      "used_as": ["暗模 ink", "暗模 accent", "暗模 promo-bg"]
    },
    "#9a9793": {
      "section": ["变量块 · 暗模"],
      "origin": ["--muted"],
      "used_as": ["暗模 muted(次要文字、图注、导航默认色)"]
    },
    "#6f6c68": {
      "section": ["变量块 · 暗模"],
      "origin": ["--muted-soft"],
      "used_as": ["暗模 muted-soft(法务页脚注等最弱一档)"]
    },
    "rgba(255, 255, 255, 0.0902)": {
      "section": ["变量块 · 暗模"],
      "origin": ["--border"],
      "used_as": ["暗模 line(announce 条与吸顶 header 的分隔线)"]
    },
    "rgba(255, 255, 255, 0.0510)": {
      "section": ["变量块 · 暗模"],
      "origin": ["--border-hairline"],
      "used_as": ["暗模 line-hairline(卡片描边、卡内分隔线)"]
    },
    "rgba(255, 255, 255, 0.1608)": {
      "section": ["变量块 · 暗模"],
      "origin": ["--border-field"],
      "used_as": ["暗模 line-field(输入框与次要按钮描边)"]
    },
    "rgba(255, 255, 255, 0.3608)": {
      "section": ["变量块 · 暗模"],
      "origin": ["--border-control"],
      "used_as": ["暗模 line-control(交互描边、下划线)"]
    },
    "rgba(255, 255, 255, 0.0392)": {
      "section": ["变量块 · 暗模"],
      "origin": ["--surface-hover"],
      "used_as": ["暗模 surface-hover(悬停洗色)"]
    },
    "rgba(255, 255, 255, 0.0784)": {
      "section": ["变量块 · 暗模"],
      "origin": ["--surface-pressed", "--accent-bg"],
      "used_as": ["暗模 surface-pressed(tag 底、当前态洗色)"]
    },
    "#0c0d09": {
      "section": ["变量块 · 暗模"],
      "origin": ["--footer-bg"],
      "used_as": ["暗模 footer-bg"]
    },
    "#fafaf9": {
      "section": ["变量块 · 暗模", "变量块 · 亮模"],
      "origin": ["--footer-fg"],
      "used_as": ["两模共用的 footer-fg"]
    },
    "#f7f6f2": {
      "section": ["变量块 · 亮模", "作品卡 · 类型徽标"],
      "origin": ["--background", "--promo-fg", ".work-type 的文字", ".sku-card.is-featured 亮模的文字"],
      "used_as": ["亮模 bg", "亮模 on-accent", "亮模 promo-fg", "图上叠加 overlay-fg"]
    },
    "#ffffff": {
      "section": ["变量块 · 亮模"],
      "origin": ["--card"],
      "used_as": ["亮模 surface"]
    },
    "#faf9f5": {
      "section": ["变量块 · 亮模"],
      "origin": ["--raised"],
      "used_as": ["亮模 surface-raised"]
    },
    "#17170f": {
      "section": ["变量块 · 亮模", "定价 · 主推卡"],
      "origin": ["--foreground", "--accent-fg", "--promo-bg", ".sku-card.is-featured 亮模的底", ".sku-card.is-featured 亮模的按钮文字"],
      "used_as": ["亮模 ink", "亮模 accent", "亮模 promo-bg"]
    },
    "#6b6a64": {
      "section": ["变量块 · 亮模"],
      "origin": ["--muted"],
      "used_as": ["亮模 muted"]
    },
    "#96948d": {
      "section": ["变量块 · 亮模"],
      "origin": ["--muted-soft"],
      "used_as": ["亮模 muted-soft"]
    },
    "rgba(23, 23, 15, 0.1020)": {
      "section": ["变量块 · 亮模"],
      "origin": ["--border"],
      "used_as": ["亮模 line"]
    },
    "rgba(23, 23, 15, 0.0588)": {
      "section": ["变量块 · 亮模"],
      "origin": ["--border-hairline", "--surface-pressed"],
      "used_as": ["亮模 line-hairline 与 surface-pressed(同一原子)"]
    },
    "rgba(23, 23, 15, 0.2392)": {
      "section": ["变量块 · 亮模"],
      "origin": ["--border-field"],
      "used_as": ["亮模 line-field"]
    },
    "rgba(23, 23, 15, 0.5020)": {
      "section": ["变量块 · 亮模"],
      "origin": ["--border-control"],
      "used_as": ["亮模 line-control"]
    },
    "rgba(23, 23, 15, 0.0353)": {
      "section": ["变量块 · 亮模"],
      "origin": ["--surface-hover"],
      "used_as": ["亮模 surface-hover"]
    },
    "#11120d": {
      "section": ["变量块 · 亮模"],
      "origin": ["--footer-bg"],
      "used_as": ["亮模 footer-bg"]
    },
    "rgba(250, 250, 249, 0.9)": {
      "section": ["页脚"],
      "origin": [".footer-col h2"],
      "used_as": ["footer-strong(页脚列标题)"]
    },
    "rgba(250, 250, 249, 0.6)": {
      "section": ["页脚"],
      "origin": [".footer-col a", ".footer-lang a"],
      "used_as": ["footer-link(页脚链接)"]
    },
    "rgba(250, 250, 249, 0.55)": {
      "section": ["页脚"],
      "origin": [".footer-tagline", ".footer-company", ".footer-meta", ".footer-bottom"],
      "used_as": ["footer-muted(页脚正文)"]
    },
    "rgba(250, 250, 249, 0.45)": {
      "section": ["页脚"],
      "origin": [".footer-brand .brand-sub"],
      "used_as": ["footer-faint(页脚品牌副标)"]
    },
    "rgba(250, 250, 249, 0.12)": {
      "section": ["页脚"],
      "origin": [".footer-bottom 的上边线"],
      "used_as": ["footer-line"]
    },
    "rgba(250, 250, 249, 0.18)": {
      "section": ["页脚"],
      "origin": [".footer-brand .brand-sub 的左边线"],
      "used_as": ["footer-line-strong"]
    },
    "rgba(20, 20, 19, 0.72)": {
      "section": ["作品卡 · 类型徽标"],
      "origin": [".work-type 的底", ".work-type 的 backdrop-filter 底色"],
      "used_as": ["overlay-bg(压在媒体图上的徽标底)"]
    },
    "rgba(255, 255, 255, 0.14)": {
      "section": ["作品卡 · 类型徽标"],
      "origin": [".work-type 的描边"],
      "used_as": ["overlay-line"]
    },
    "rgba(20, 20, 19, 0.7)": {
      "section": ["定价 · 主推卡"],
      "origin": [".sku-card.is-featured 暗模的次要文字"],
      "used_as": ["暗模 promo-muted"]
    },
    "rgba(20, 20, 19, 0.12)": {
      "section": ["定价 · 主推卡"],
      "origin": [".sku-card.is-featured 暗模的 tag 底"],
      "used_as": ["暗模 promo-tag-bg"]
    },
    "rgba(247, 246, 242, 0.7)": {
      "section": ["定价 · 主推卡"],
      "origin": [".sku-card.is-featured 亮模的次要文字"],
      "used_as": ["亮模 promo-muted"]
    },
    "rgba(247, 246, 242, 0.16)": {
      "section": ["定价 · 主推卡"],
      "origin": [".sku-card.is-featured 亮模的 tag 底"],
      "used_as": ["亮模 promo-tag-bg"]
    }
  },
  "shadows": {
    "0 1px rgba(0, 0, 0, 0.1020), 0 2px 4px rgba(0, 0, 0, 0.2000), 0 8px 22px -4px rgba(0, 0, 0, 0.3490)": {
      "section": ["变量块 · 暗模"],
      "origin": ["--shadow-btn"],
      "used_as": ["暗模 shadow-btn"]
    },
    "0 1px 2px rgba(0, 0, 0, 0.1333), 0 8px 24px -12px rgba(0, 0, 0, 0.2667)": {
      "section": ["变量块 · 暗模"],
      "origin": ["--shadow-card"],
      "used_as": ["暗模 shadow-card"]
    },
    "0 1px rgba(0, 0, 0, 0.1490), 0 2px 4px rgba(0, 0, 0, 0.2000), 0 12px 28px -8px rgba(0, 0, 0, 0.3333)": {
      "section": ["变量块 · 暗模"],
      "origin": ["--shadow-pill"],
      "used_as": ["暗模 shadow-pill"]
    },
    "0 1px rgba(0, 0, 0, 0.0588), 0 2px 4px rgba(26, 25, 24, 0.1412), 0 8px 22px -4px rgba(26, 25, 24, 0.2784)": {
      "section": ["变量块 · 亮模"],
      "origin": ["--shadow-btn"],
      "used_as": ["亮模 shadow-btn"]
    },
    "0 1px 2px rgba(23, 23, 15, 0.0392), 0 8px 24px -12px rgba(23, 23, 15, 0.1020)": {
      "section": ["变量块 · 亮模"],
      "origin": ["--shadow-card"],
      "used_as": ["亮模 shadow-card"]
    },
    "0 1px rgba(26, 25, 24, 0.0510), 0 2px 4px rgba(26, 25, 24, 0.0588), 0 12px 28px -8px rgba(26, 25, 24, 0.1608)": {
      "section": ["变量块 · 亮模"],
      "origin": ["--shadow-pill"],
      "used_as": ["亮模 shadow-pill"]
    }
  },
  "folded_aliases": {
    "note": "源表里有 3 个变量只被定义、没有构件引用;本包不另立同名 token,值仍在,语义并入下列 token(出处见 docs/usage.md §token 折叠)。",
    "--accent-fg": "accent(= ink 本身)",
    "--accent-bg": "surface-pressed(同值原子)",
    "--border": "line(同一原子;源构件全部走 hairline / field / control 三档)"
  },
  "source_map": {
    "--background": "bg",
    "--card": "surface",
    "--raised": "surface-raised",
    "--foreground": "ink",
    "--muted": "muted",
    "--muted-soft": "muted-soft",
    "--border": "line",
    "--border-hairline": "line-hairline",
    "--border-field": "line-field",
    "--border-control": "line-control",
    "--surface-hover": "surface-hover",
    "--surface-pressed": "surface-pressed",
    "--accent-fg": "accent / on-accent(源表按钮文字误用 --card,本包统一为 on-accent)",
    "--promo-bg": "promo-bg",
    "--promo-fg": "promo-fg",
    "--footer-bg": "footer-bg",
    "--footer-fg": "footer-fg",
    "--shadow-btn": "shadow-btn",
    "--shadow-card": "shadow-card",
    "--shadow-pill": "shadow-pill"
  }
}
tokens/index.json
{
  "id": "token-harbor",
  "default": "dark",
  "note": "变体目录:两个变体(dark 近黑 / light 暖白),default = dark。两模共用同一套语义键名,只有中性色与影翻面;footer-* 与 overlay-* 是两模同值的常量(页脚本来就是深色块、图上徽标本来就压在图里),列在 invariant 里以免被误当成漏翻。",
  "variants": [
    {
      "id": "dark",
      "name": "近黑",
      "mode": "dark",
      "contrast": "high",
      "path": "tokens/semantic/dark.json",
      "default": true,
      "aliases": ["ink", "墨"],
      "note": "默认变体。css/default.css 的 :root 就是这一份。"
    },
    {
      "id": "light",
      "name": "暖白",
      "mode": "light",
      "contrast": "high",
      "path": "tokens/semantic/light.json",
      "default": false,
      "aliases": ["paper", "纸"],
      "note": "与 dark 并存时用 css/themes.css 里的 [data-theme=\"light\"]。"
    }
  ],
  "axes": {
    "theme": {
      "attr": "data-theme",
      "values": ["dark", "light"],
      "default": "dark",
      "note": "写在 <html> 上。dark 是默认,可省;light 需要同时引入 css/themes.css。切换按钮要写 aria-pressed 与 aria-label,并且不依赖 localStorage 也能看。"
    }
  },
  "invariant": {
    "note": "两模同值,不需要翻面;若你的项目只引 css/themes.css,这些值也已各写一份在两边的 token 块里。",
    "tokens": [
      "footer-bg",
      "footer-fg",
      "footer-strong",
      "footer-link",
      "footer-muted",
      "footer-faint",
      "footer-line",
      "footer-line-strong",
      "overlay-bg",
      "overlay-fg",
      "overlay-line"
    ]
  },
  "css_layers": {
    "css/default.css": ":root = dark 全量 token + 全部基础 chrome;单主题(近黑)直接可用",
    "css/themes.css": "只出 [data-theme=\"dark\"] / [data-theme=\"light\"] 两个作用域的 token 块,不含任何构件规则;与项目自带主题体系并存时用这一份"
  }
}
tokens/semantic/dark.json
{
  "id": "dark",
  "name": "近黑",
  "mode": "dark",
  "color_scheme": "dark",
  "note": "语义映射 · 默认变体。value 必须逐字等于 tokens/absolute.json 的原子值(atom 字段给出该原子的键);CSS 两份文件里的同名 token 由 scripts/assert_tokens.py 逐条比对,防止三处漂移。",
  "tokens": {
    "bg": {
      "value": "#141413",
      "kind": "color",
      "atom": "#141413",
      "use": "整页底:<body>、吸顶 header 的背景、表单控件的输入底、移动端展开导航的面板底"
    },
    "surface": {
      "value": "#1b1b19",
      "kind": "color",
      "atom": "#1b1b19",
      "use": "卡面:作品卡、服务卡、定价卡、案例卡、why 卡、表单卡、hero 胶囊;比 bg 亮一档,不用阴影也能起层"
    },
    "surface-raised": {
      "value": "#232320",
      "kind": "color",
      "atom": "#232320",
      "use": "再高一档的面:作品卡的媒体框底(图未加载/占位时的底)"
    },
    "ink": {
      "value": "#e8e6e1",
      "kind": "color",
      "atom": "#e8e6e1",
      "use": "正文与标题:body 默认字色、.h-display / .h-section / .h-card、卡标题、按钮文字(次要按钮)、表单标签"
    },
    "muted": {
      "value": "#9a9793",
      "kind": "color",
      "atom": "#9a9793",
      "use": "次要文字:lede 之外的小字、卡片描述、导航默认色、图注、faq 答案、页脚以外的说明文字"
    },
    "muted-soft": {
      "value": "#6f6c68",
      "kind": "color",
      "atom": "#6f6c68",
      "use": "最弱一档:法务页脚注(.legal-meta)、大段背景说明;不用于正文"
    },
    "line": {
      "value": "rgba(255, 255, 255, 0.0902)",
      "kind": "color",
      "atom": "rgba(255, 255, 255, 0.0902)",
      "use": "chrome 分隔线:announce 条下边线、吸顶 header 下边线(比 hairline 略实)"
    },
    "line-hairline": {
      "value": "rgba(255, 255, 255, 0.0510)",
      "kind": "color",
      "atom": "rgba(255, 255, 255, 0.0510)",
      "use": "最细的线:卡片描边、卡内 / 页脚以外的相邻块分隔、faq 上下线、proof 与 process 的分隔线"
    },
    "line-field": {
      "value": "rgba(255, 255, 255, 0.1608)",
      "kind": "color",
      "atom": "rgba(255, 255, 255, 0.1608)",
      "use": "控件描边:输入框 / 下拉 / 文本域、次要按钮(.btn-outline)的边框;卡悬停时描边提到这一档"
    },
    "line-control": {
      "value": "rgba(255, 255, 255, 0.3608)",
      "kind": "color",
      "atom": "rgba(255, 255, 255, 0.3608)",
      "use": "交互描边:次要按钮悬停时的边框、下划线的默认色(.work-all a / .case-foot a 的 text-decoration-color)"
    },
    "surface-hover": {
      "value": "rgba(255, 255, 255, 0.0392)",
      "kind": "color",
      "atom": "rgba(255, 255, 255, 0.0392)",
      "use": "悬停洗色:导航项、语言按钮、主题按钮、菜单按钮、次要按钮的 hover 底"
    },
    "surface-pressed": {
      "value": "rgba(255, 255, 255, 0.0784)",
      "kind": "color",
      "atom": "rgba(255, 255, 255, 0.0784)",
      "use": "按下去 / 当前态:tag 底、icon-chip 底、语言按钮的 .is-active 底、输入框聚焦时的外环"
    },
    "accent": {
      "value": "#e8e6e1",
      "kind": "color",
      "atom": "#e8e6e1",
      "use": "唯一强调色 = 墨本身:主按钮底、焦点环、::selection 底、勾选态 accent-color;不做彩色强调"
    },
    "on-accent": {
      "value": "#141413",
      "kind": "color",
      "atom": "#141413",
      "use": "压在 accent 上的文字:主按钮文字、nav-cta 移动端按钮文字、跳转链接(skip-link)与选中文本的颜色"
    },
    "promo-bg": {
      "value": "#e8e6e1",
      "kind": "color",
      "atom": "#e8e6e1",
      "use": "大面积反色块:顶部 announce 条的底、定价主推卡(.is-featured)的底"
    },
    "promo-fg": {
      "value": "#141413",
      "kind": "color",
      "atom": "#141413",
      "use": "反色块上的文字:announce 文案与小圆点、主推卡的标题 / 价格 / 清单 / 按钮文字"
    },
    "promo-muted": {
      "value": "rgba(20, 20, 19, 0.7)",
      "kind": "color",
      "atom": "rgba(20, 20, 19, 0.7)",
      "use": "反色块里的次要文字:主推卡的档位名、单位、描述"
    },
    "promo-tag-bg": {
      "value": "rgba(20, 20, 19, 0.12)",
      "kind": "color",
      "atom": "rgba(20, 20, 19, 0.12)",
      "use": "反色块里的 tag 底:主推卡上的「推荐」类标签"
    },
    "footer-bg": {
      "value": "#0c0d09",
      "kind": "color",
      "atom": "#0c0d09",
      "use": "页脚底:两模共用同一块深色,比暗模 bg 再深一档,保证页脚在亮模下也沉得下去"
    },
    "footer-fg": {
      "value": "#fafaf9",
      "kind": "color",
      "atom": "#fafaf9",
      "use": "页脚主文字与链接悬停色;页脚里的品牌名也用它"
    },
    "footer-strong": {
      "value": "rgba(250, 250, 249, 0.9)",
      "kind": "color",
      "atom": "rgba(250, 250, 249, 0.9)",
      "use": "页脚列标题(.footer-col h2)"
    },
    "footer-link": {
      "value": "rgba(250, 250, 249, 0.6)",
      "kind": "color",
      "atom": "rgba(250, 250, 249, 0.6)",
      "use": "页脚链接默认色(.footer-col a、.footer-lang a)"
    },
    "footer-muted": {
      "value": "rgba(250, 250, 249, 0.55)",
      "kind": "color",
      "atom": "rgba(250, 250, 249, 0.55)",
      "use": "页脚正文:标语、公司信息、元信息、底栏文字"
    },
    "footer-faint": {
      "value": "rgba(250, 250, 249, 0.45)",
      "kind": "color",
      "atom": "rgba(250, 250, 249, 0.45)",
      "use": "页脚最弱一档:品牌副标(.brand-sub)"
    },
    "footer-line": {
      "value": "rgba(250, 250, 249, 0.12)",
      "kind": "color",
      "atom": "rgba(250, 250, 249, 0.12)",
      "use": "页脚底栏上边线"
    },
    "footer-line-strong": {
      "value": "rgba(250, 250, 249, 0.18)",
      "kind": "color",
      "atom": "rgba(250, 250, 249, 0.18)",
      "use": "页脚里品牌副标的左边线(与 footer-faint 成对)"
    },
    "overlay-bg": {
      "value": "rgba(20, 20, 19, 0.72)",
      "kind": "color",
      "atom": "rgba(20, 20, 19, 0.72)",
      "use": "压在媒体图上的徽标底(.work-type),配 backdrop-filter 模糊"
    },
    "overlay-fg": {
      "value": "#f7f6f2",
      "kind": "color",
      "atom": "#f7f6f2",
      "use": "压在媒体图上的徽标文字(与主题无关,两模同值)"
    },
    "overlay-line": {
      "value": "rgba(255, 255, 255, 0.14)",
      "kind": "color",
      "atom": "rgba(255, 255, 255, 0.14)",
      "use": "媒体图徽标的描边"
    },
    "shadow-btn": {
      "value": "0 1px rgba(0, 0, 0, 0.1020), 0 2px 4px rgba(0, 0, 0, 0.2000), 0 8px 22px -4px rgba(0, 0, 0, 0.3490)",
      "kind": "shadow",
      "atom": "0 1px rgba(0, 0, 0, 0.1020), 0 2px 4px rgba(0, 0, 0, 0.2000), 0 8px 22px -4px rgba(0, 0, 0, 0.3490)",
      "use": "主按钮的三层影;悬停时按钮上浮 1px 全靠它"
    },
    "shadow-card": {
      "value": "0 1px 2px rgba(0, 0, 0, 0.1333), 0 8px 24px -12px rgba(0, 0, 0, 0.2667)",
      "kind": "shadow",
      "atom": "0 1px 2px rgba(0, 0, 0, 0.1333), 0 8px 24px -12px rgba(0, 0, 0, 0.2667)",
      "use": "卡片悬停的浮起影 + 表单卡的常驻影 + 主推卡的影"
    },
    "shadow-pill": {
      "value": "0 1px rgba(0, 0, 0, 0.1490), 0 2px 4px rgba(0, 0, 0, 0.2000), 0 12px 28px -8px rgba(0, 0, 0, 0.3333)",
      "kind": "shadow",
      "atom": "0 1px rgba(0, 0, 0, 0.1490), 0 2px 4px rgba(0, 0, 0, 0.2000), 0 12px 28px -8px rgba(0, 0, 0, 0.3333)",
      "use": "hero 胶囊(.hero-pill)的影;胶囊是页面里唯一的悬浮元素"
    }
  }
}
tokens/semantic/light.json
{
  "id": "light",
  "name": "暖白",
  "mode": "light",
  "color_scheme": "light",
  "note": "语义映射 · 暖白变体。键名与 dark 完全一致(两模可互换),只翻中性色与影;footer-* 与 overlay-* 与 dark 同值,是常量而非漏翻。",
  "tokens": {
    "bg": {
      "value": "#f7f6f2",
      "kind": "color",
      "atom": "#f7f6f2",
      "use": "整页底:<body>、吸顶 header 的背景、表单控件的输入底、移动端展开导航的面板底"
    },
    "surface": {
      "value": "#ffffff",
      "kind": "color",
      "atom": "#ffffff",
      "use": "卡面:作品卡、服务卡、定价卡、案例卡、why 卡、表单卡、hero 胶囊;亮模下卡面比底更白,靠这一档起层"
    },
    "surface-raised": {
      "value": "#faf9f5",
      "kind": "color",
      "atom": "#faf9f5",
      "use": "再高一档的面:作品卡的媒体框底(图未加载/占位时的底)"
    },
    "ink": {
      "value": "#17170f",
      "kind": "color",
      "atom": "#17170f",
      "use": "正文与标题:body 默认字色、.h-display / .h-section / .h-card、卡标题、次要按钮文字、表单标签"
    },
    "muted": {
      "value": "#6b6a64",
      "kind": "color",
      "atom": "#6b6a64",
      "use": "次要文字:卡片描述、导航默认色、图注、faq 答案、说明文字(5.02:1,是本语言里最小的一档正文对比度)"
    },
    "muted-soft": {
      "value": "#96948d",
      "kind": "color",
      "atom": "#96948d",
      "use": "最弱一档:法务页脚注(.legal-meta)、大段背景说明;亮模下不足 4.5:1,禁止用在正文"
    },
    "line": {
      "value": "rgba(23, 23, 15, 0.1020)",
      "kind": "color",
      "atom": "rgba(23, 23, 15, 0.1020)",
      "use": "chrome 分隔线:announce 条下边线、吸顶 header 下边线(比 hairline 略实)"
    },
    "line-hairline": {
      "value": "rgba(23, 23, 15, 0.0588)",
      "kind": "color",
      "atom": "rgba(23, 23, 15, 0.0588)",
      "use": "最细的线:卡片描边、相邻块分隔、faq 上下线、proof 与 process 的分隔线"
    },
    "line-field": {
      "value": "rgba(23, 23, 15, 0.2392)",
      "kind": "color",
      "atom": "rgba(23, 23, 15, 0.2392)",
      "use": "控件描边:输入框 / 下拉 / 文本域、次要按钮(.btn-outline)的边框;卡悬停时描边提到这一档"
    },
    "line-control": {
      "value": "rgba(23, 23, 15, 0.5020)",
      "kind": "color",
      "atom": "rgba(23, 23, 15, 0.5020)",
      "use": "交互描边:次要按钮悬停时的边框、下划线的默认色(.work-all a / .case-foot a 的 text-decoration-color)"
    },
    "surface-hover": {
      "value": "rgba(23, 23, 15, 0.0353)",
      "kind": "color",
      "atom": "rgba(23, 23, 15, 0.0353)",
      "use": "悬停洗色:导航项、语言按钮、主题按钮、菜单按钮、次要按钮的 hover 底"
    },
    "surface-pressed": {
      "value": "rgba(23, 23, 15, 0.0588)",
      "kind": "color",
      "atom": "rgba(23, 23, 15, 0.0588)",
      "use": "按下去 / 当前态:tag 底、icon-chip 底、语言按钮的 .is-active 底、输入框聚焦时的外环"
    },
    "accent": {
      "value": "#17170f",
      "kind": "color",
      "atom": "#17170f",
      "use": "唯一强调色 = 墨本身:主按钮底、焦点环、::selection 底、勾选态 accent-color"
    },
    "on-accent": {
      "value": "#f7f6f2",
      "kind": "color",
      "atom": "#f7f6f2",
      "use": "压在 accent 上的文字:主按钮文字、nav-cta 移动端按钮文字、跳转链接与选中文本的颜色"
    },
    "promo-bg": {
      "value": "#17170f",
      "kind": "color",
      "atom": "#17170f",
      "use": "大面积反色块:顶部 announce 条的底、定价主推卡(.is-featured)的底;两模互换的正是这一对墨/纸"
    },
    "promo-fg": {
      "value": "#f7f6f2",
      "kind": "color",
      "atom": "#f7f6f2",
      "use": "反色块上的文字:announce 文案与小圆点、主推卡的标题 / 价格 / 清单 / 按钮文字"
    },
    "promo-muted": {
      "value": "rgba(247, 246, 242, 0.7)",
      "kind": "color",
      "atom": "rgba(247, 246, 242, 0.7)",
      "use": "反色块里的次要文字:主推卡的档位名、单位、描述"
    },
    "promo-tag-bg": {
      "value": "rgba(247, 246, 242, 0.16)",
      "kind": "color",
      "atom": "rgba(247, 246, 242, 0.16)",
      "use": "反色块里的 tag 底:主推卡上的「推荐」类标签"
    },
    "footer-bg": {
      "value": "#11120d",
      "kind": "color",
      "atom": "#11120d",
      "use": "页脚底:亮模下仍是深色块(与暗模同一套页脚 token),保证页脚是全站唯一的固定深色区"
    },
    "footer-fg": {
      "value": "#fafaf9",
      "kind": "color",
      "atom": "#fafaf9",
      "use": "页脚主文字与链接悬停色;页脚里的品牌名也用它"
    },
    "footer-strong": {
      "value": "rgba(250, 250, 249, 0.9)",
      "kind": "color",
      "atom": "rgba(250, 250, 249, 0.9)",
      "use": "页脚列标题(.footer-col h2)"
    },
    "footer-link": {
      "value": "rgba(250, 250, 249, 0.6)",
      "kind": "color",
      "atom": "rgba(250, 250, 249, 0.6)",
      "use": "页脚链接默认色(.footer-col a、.footer-lang a)"
    },
    "footer-muted": {
      "value": "rgba(250, 250, 249, 0.55)",
      "kind": "color",
      "atom": "rgba(250, 250, 249, 0.55)",
      "use": "页脚正文:标语、公司信息、元信息、底栏文字"
    },
    "footer-faint": {
      "value": "rgba(250, 250, 249, 0.45)",
      "kind": "color",
      "atom": "rgba(250, 250, 249, 0.45)",
      "use": "页脚最弱一档:品牌副标(.brand-sub)"
    },
    "footer-line": {
      "value": "rgba(250, 250, 249, 0.12)",
      "kind": "color",
      "atom": "rgba(250, 250, 249, 0.12)",
      "use": "页脚底栏上边线"
    },
    "footer-line-strong": {
      "value": "rgba(250, 250, 249, 0.18)",
      "kind": "color",
      "atom": "rgba(250, 250, 249, 0.18)",
      "use": "页脚里品牌副标的左边线(与 footer-faint 成对)"
    },
    "overlay-bg": {
      "value": "rgba(20, 20, 19, 0.72)",
      "kind": "color",
      "atom": "rgba(20, 20, 19, 0.72)",
      "use": "压在媒体图上的徽标底(.work-type),配 backdrop-filter 模糊;与主题无关"
    },
    "overlay-fg": {
      "value": "#f7f6f2",
      "kind": "color",
      "atom": "#f7f6f2",
      "use": "压在媒体图上的徽标文字(两模同值)"
    },
    "overlay-line": {
      "value": "rgba(255, 255, 255, 0.14)",
      "kind": "color",
      "atom": "rgba(255, 255, 255, 0.14)",
      "use": "媒体图徽标的描边"
    },
    "shadow-btn": {
      "value": "0 1px rgba(0, 0, 0, 0.0588), 0 2px 4px rgba(26, 25, 24, 0.1412), 0 8px 22px -4px rgba(26, 25, 24, 0.2784)",
      "kind": "shadow",
      "atom": "0 1px rgba(0, 0, 0, 0.0588), 0 2px 4px rgba(26, 25, 24, 0.1412), 0 8px 22px -4px rgba(26, 25, 24, 0.2784)",
      "use": "主按钮的三层影;亮模下比暗模轻一档,避免在暖白底上糊边"
    },
    "shadow-card": {
      "value": "0 1px 2px rgba(23, 23, 15, 0.0392), 0 8px 24px -12px rgba(23, 23, 15, 0.1020)",
      "kind": "shadow",
      "atom": "0 1px 2px rgba(23, 23, 15, 0.0392), 0 8px 24px -12px rgba(23, 23, 15, 0.1020)",
      "use": "卡片悬停的浮起影 + 表单卡的常驻影 + 主推卡的影"
    },
    "shadow-pill": {
      "value": "0 1px rgba(26, 25, 24, 0.0510), 0 2px 4px rgba(26, 25, 24, 0.0588), 0 12px 28px -8px rgba(26, 25, 24, 0.1608)",
      "kind": "shadow",
      "atom": "0 1px rgba(26, 25, 24, 0.0510), 0 2px 4px rgba(26, 25, 24, 0.0588), 0 12px 28px -8px rgba(26, 25, 24, 0.1608)",
      "use": "hero 胶囊(.hero-pill)的影"
    }
  }
}
docs/usage.md
# usage · token-harbor 配对规则

> 这套语言的核心主张:**无色相**。唯一强调色就是墨色本身,层次靠墨/纸互换(反色块)与一条细线制造;
> 没有渐变、没有彩色状态色、标题不外挂衬线。任何"用颜色区分信息"的需求都不属于这里。

## 什么时候用

- 营销 / 服务型站点与产品落地页:要一套安静的、结构感强的设计语言,而不是靠配色抢眼。
- 需要深浅双模(近黑为默认、暖白并存),并且两模共用同一套语义键名。
- 需要成套构件:announce 条、吸顶 header、语言切换与主题按钮、tag / chip、作品卡、定价卡、案例卡、流程、FAQ、表单与 footer。
- 需要小字也达到 AA:正文与次要文字两档都必须 ≥ 4.5:1。

## 什么时候不用

- 内容型 / 杂志型长文排版(走 ouuut-editorial 或 paper-editorial)。
- 需要三套以上主题或换肤。
- 需要色相当信息编码(状态红绿、数据可视化配色)——这套语言里没有色相。
- 要的是动效而不是配色(走 motion-kit)。

## 组件 → token(配谁)

| UI 部位 | token | 说明 |
|---|---|---|
| 页面底、header 背景、输入底 | `--bg` | 近黑 `#141413` / 暖白 `#f7f6f2` |
| 卡面(作品 / 服务 / 定价 / 案例 / why / 表单卡、hero 胶囊) | `--surface` | 近黑比底亮一档,暖白比底白;卡面无常驻阴影 |
| 作品卡媒体框底 | `--surface-raised` | 再高一档的面 |
| 正文与标题 | `--ink` | 近黑 14.78:1 / 暖白 16.66:1 |
| 次要文字、描述、导航默认色、图注 | `--muted` | 近黑 6.34:1 / 暖白 5.02:1 |
| 法务页脚注等可放弃的小字 | `--muted-soft` | 近黑 3.53:1 / 暖白 2.81:1,**禁止用在正文与小字信息** |
| announce 条与吸顶 header 的下边线 | `--line` | chrome 分隔线,比 hairline 略实 |
| 卡片描边、卡内分隔、faq 上下线、proof / process 分隔 | `--line-hairline` | 最细一档 |
| 输入框 / 下拉 / 文本域、次要按钮描边、卡片悬停描边 | `--line-field` | 控件一档 |
| 次要按钮悬停描边、下划线默认色 | `--line-control` | 交互一档 |
| 悬停洗色(导航、语言按钮、开关、次要按钮) | `--surface-hover` | 半透明一层 |
| 当前态 / 按下(tag 底、chip 底、`.is-active`、聚焦外环) | `--surface-pressed` | 半透明两层 |
| 主按钮底、焦点环、选中文本底、勾选态 | `--accent` | 就是墨本身,不做彩色强调 |
| 压在 accent 上的文字 | `--on-accent` | 主按钮文字、移动端 `.nav-cta`、skip-link |
| announce 条底、定价主推卡底 | `--promo-bg` | 大面积反色块 |
| 反色块上的文字 | `--promo-fg` | 主推卡的标题 / 价格 / 清单 / 按钮文字 |
| 反色块里的次要文字 | `--promo-muted` | 主推卡的档位名、单位、描述 |
| 反色块里的 tag 底 | `--promo-tag-bg` | 主推卡上的「推荐」标签 |
| 页脚底 / 页脚文字 | `--footer-bg` · `--footer-fg` | 两模共用同一块深色,页脚是全站唯一固定深色区 |
| 页脚列标题 / 链接 / 正文 / 品牌副标 | `--footer-strong` · `--footer-link` · `--footer-muted` · `--footer-faint` | 页脚内部四级 |
| 页脚底栏上边线 / 品牌副标左边线 | `--footer-line` · `--footer-line-strong` | 页脚内部两条线 |
| 媒体图上的类型徽标 | `--overlay-bg` · `--overlay-fg` · `--overlay-line` | 与主题无关,两模同值 |
| 主按钮 / 卡片悬停 / hero 胶囊 | `--shadow-btn` · `--shadow-card` · `--shadow-pill` | 影只有三档,只给浮起元素 |

## 双模怎么切

```html
<html data-theme="dark">   <!-- 默认,可省 -->
<html data-theme="light">  <!-- 需要同时引入 css/themes.css -->
```

- `css/default.css` = `:root` 近黑 token + 全部基础 chrome;**单主题直接可用**,不引第二份文件也不会串色。
- `css/themes.css` = **只出** `[data-theme="dark"]` / `[data-theme="light"]` 两个作用域的 token 覆盖,不含构件规则;与项目自带主题体系并存时用这一份。
- 切换按钮:44px 命中区(`--hit`)、纯图标(浅色太阳 / 深色月亮)、`aria-pressed` 写当前是否暖白、`aria-label` 写"切到哪个模式";**不依赖 localStorage 也要能看**(预览页就是零存储的实现)。
- 想跟着系统走就加一份 `prefers-color-scheme` 的默认值,但页面上的显式 `data-theme` 必须优先。
- 建议同时更新 `<meta name="theme-color">`:近黑 `#141413`、暖白 `#f7f6f2`。

## token 折叠(源表变量 → 本包)

源样式表里有三个变量只被定义、没有被任何构件引用;本包不另立同名 token,值仍在:

| 源变量 | 本包 | 处理 |
|---|---|---|
| `--accent-fg` | `--accent` | 与墨色同值,语义并入 accent |
| `--accent-bg` | `--surface-pressed` | 与当前态洗色同值同原子 |
| `--border` | `--line` | 同原子;源构件全部走 hairline / field / control 三档,本包把 `--line` 用在 chrome 分隔线上 |

另有两处**刻意的归一化**(不是漏项,断言与文档同步):

1. 主按钮文字:源表用 `--card` 色,本包统一为 `--on-accent`(= 页面底)。差别只有 0.03 亮度,但口径统一后「accent 上的字」只有一条规则。
2. 主推卡:源表为暖白写了整整一组 `html[data-theme="light"]` 覆盖;本包改成 `--promo-*` 四件套,两模共用同一组规则,不再有模式分支。

## 刻度

字号十一档(`--fs-*`):`display 64` / `section 40` / `case 20` / `sub 18` / `card 17` / `lede 16` / `body 14` / `small 13` / `meta 12` / `caption 11` / `eyebrow 10.5`;
组件局部的 `10 / 11.5 / 12.5 / 13.5` 是子档,直接写字面值,不进 token(避免"每半像素一个变量")。

圆角(`--radius-*`):按钮与输入框 `4px`、移动端导航项 `6px`、icon chip `10px`、卡片与主推卡 `14px`、tag 与 hero 胶囊为整圆。

布局:`--maxw 1240px` / `--maxw-narrow 880px` / `--wrap-x 24px` / `--sec-y 80px` / 锚点偏移 `--anchor-offset 96px` / 最小命中区 `--hit 44px`。

动效(`--dur-*` + `--ease`):快互动 `0.16s`、常态 `0.18s`、影与主题过渡 `0.2s`、图像缩放 `0.4s`,`cubic-bezier(0.22, 0.61, 0.36, 1)`;
`prefers-reduced-motion: reduce` 下全部动画与过渡降到 `0.01ms`,卡片悬停不再位移。

## 表单校验态

这套语言没有色相,所以报错不靠红:靠三件事 —— 输入框描边提到墨色并加一圈内描边(`aria-invalid="true"`)、
错误行前置一个圆形叹号(`.field-error::before`)、一句说明文案。校验态与成功态都只改字重与描边:

```html
<label class="field">
  <span>邮箱</span>
  <input type="email" aria-invalid="true" aria-describedby="email-error">
  <span class="field-error" id="email-error">邮箱格式不对,例如 name@example.com</span>
</label>
```

- 提交结果写进 `.form-status`(`.is-ok` / `.is-error` 只加字重,不变色),容器带 `aria-live="polite"`。
- 通过校验后必须移除 `aria-invalid`,并把错误行 `hidden` 回去。
- 蜜罐字段用 `.honeypot`(移出视口,不占布局),不要用 `display:none`——那会被部分爬虫识别。

## 接入步骤

1. 读 `tokens/semantic/dark.json`(或 `light.json`)拿到语义色,**禁止自己编 hex**;每条的 `atom` 字段指向 `tokens/absolute.json` 里的原色原子。
2. 把 `css/default.css`(单主题)或 `css/default.css` + `css/themes.css`(双模)拷进项目静态资源目录。
3. 在 `<html>` 上打 `data-theme`(默认近黑可省),并按需在 `<body>` 上用 `.wrap` / `.section` 起版心与分区节奏。
4. 品牌标记 `.brand-mark` 是纯 CSS 画的方框含内芯,**不是**某个站点的 logo;换成自有图形时保持 28px(页脚 26px、窄屏 24px)与 `currentColor`,不要引入外部图片或图标字体。
5. 字体:包内**不引 webfont**(保证零外部子资源),用 `--font-sans` 的系统栈回退;项目要自托管字体时自行加 `@font-face`,不要改这套 token 的名字。
6. 自检:`python packs/token-harbor/scripts/assert_tokens.py` —— 它会把两组对比度实测值打印出来,并逐条比对两份 CSS 与语义表。

## 取用

```bash
python <sai-assets>/scripts/apply.py token-harbor --to src/styles
```

```html
<link rel="stylesheet" href="styles/token-harbor/default.css">
<link rel="stylesheet" href="styles/token-harbor/themes.css">
<html data-theme="dark">
```

消费后在项目 `design-lock.json` 记 `assets[]`:`pack=token-harbor`、`version`、`sha`(见 `docs/USAGE-INTEGRATION.md`)。

## 反模式

- 给这套语言加第二个彩色强调色;或者用彩色表示状态(成功 / 危险 / 警告)。这里只有墨色,a11y 状态靠文案与描边。
- 用 `muted-soft` 写正文或小字信息:近黑 3.53:1、暖白 2.81:1,是明确低于 AA 的一档。
- 给卡片加常驻阴影"分层";卡面靠 `--surface` 与一档细线,只有悬停才浮起。
- 用 `--accent` 之外的墨色值当强调(直接写 `#e8e6e1` / `#17170f` 之类字面值);硬编码会让两模与断言同时失效。
- 把 `[data-theme]` 写在 `<body>` 或单个卡片上:token 定义在 `:root` / `[data-theme]` 作用域,写在局部会漏掉页脚与表单。
- 用 `!important` 改 token,或在项目里再复制一份 `:root` 变量表(那就成了第二真相源,断言照不到)。
- 主推卡的按钮直接写死墨色;要用 `--promo-fg` / `--promo-bg` 这对(反色块里再翻一次)。
- 深浅切换偷偷写 `localStorage` 之后忘了无 JS 兜底:不写存储也必须能看,写了也要能在首屏前应用。
- 用渐变、玻璃拟态、彩色描边"提亮"这套语言;它要的就是无渐变、无色相。

## 来源与许可

- 来源:本站自有的营销 / 服务型站点样式表 `assets/css/site.css`(1025 行,只读原料),拆成 token 表 + 两份 CSS + 断言;见 `pack.json.attribution` 与 `tokens/absolute.json.source_map`。
- 许可:MIT(本家自产)。包内不含第三方素材、不含 webfont、不含站点自有 logo 图形。
- 文档里的邮箱、公司名、价格与案例文案都是中性占位,只为验证排版,不构成任何报价或背书。
SKILL.md
---
name: token-harbor
description: Apply the Token Harbor monochrome dual-theme design language — a near-black default and a warm-white variant sharing one semantic token set, 14px body, 4px button radius, 14px card radius, hairline hierarchy, no gradients and no hue. Use when a marketing or service site or product landing page needs a full component kit (announcement bar, sticky header with language and theme buttons, tags, pricing cards, case cards, forms with validation states, footer) plus per-purpose semantic tokens in both modes.
---

# token-harbor · 墨色双模设计语言

**无色相**的一套设计语言:近黑为默认、暖白并存,两模共用同一套语义键名;
唯一强调色就是墨色本身 —— 层次靠墨/纸互换与一条细线,不靠渐变、不靠彩色状态色、标题不外挂衬线。

## When to use

- 营销 / 服务型站点与产品落地页:要结构感与克制,不要靠配色抢眼。
- 要深浅双模(近黑默认 / 暖白并存),且两模键名一致、可互换。
- 要成套构件:announce 条、吸顶 header、语言切换与主题按钮、tag / chip、作品卡、定价卡(含主推反色卡)、案例卡、流程、FAQ、联系表单与 footer。
- 要小字也达 AA:正文与次要文字两档都 ≥ 4.5:1(已实测并写进断言)。

## When not to use

- 内容型 / 杂志型长文排版(走 ouuut-editorial 或 paper-editorial)。
- 需要三套以上主题或换肤。
- 需要色相当信息编码(状态红绿、数据可视化配色)——这套语言里没有色相。
- 要的是动效而不是配色(走 motion-kit)。

## Default

`data-theme="dark"`(近黑)。默认值只写在 `css/default.css` 的 `:root`,引一个文件就能用。

| role | 近黑(dark) | 暖白(light) |
|------|-----------|-------------|
| bg | `#141413` | `#f7f6f2` |
| surface | `#1b1b19` | `#ffffff` |
| ink(正文) | `#e8e6e1` | `#17170f` |
| muted(次要文字) | `#9a9793` | `#6b6a64` |
| accent(唯一强调 = 墨) | `#e8e6e1` | `#17170f` |
| promo(反色块) | 底 `#e8e6e1` / 字 `#141413` | 底 `#17170f` / 字 `#f7f6f2` |
| footer | 底 `#0c0d09` | 底 `#11120d`(两模都深) |

## Variants and axes

| 轴 | 属性 | 取值 | 说明 |
|---|---|---|---|
| 主题 | `data-theme` | `dark`(默认) / `light` | 只翻中性色与影;`footer-*` 与 `overlay-*` 两模同值 |

## Files

| path | use |
|---|---|
| `tokens/absolute.json` | 原色表:38 个去重色值 + 6 组影,每个原子标注来源小节;含源表变量 → 本包 token 的折叠表 |
| `tokens/index.json` | 变体目录(dark / light)+ default + 两模同值的常量清单 |
| `tokens/semantic/dark.json` | 暗模语义映射(32 个 token:值 / 原子 / 用在哪) |
| `tokens/semantic/light.json` | 亮模语义映射(键名与暗模逐一对应) |
| `css/default.css` | 近黑为默认:一份 `:root` token + 全部基础 chrome,单主题直接可用 |
| `css/themes.css` | 只出 `[data-theme="dark"]` / `[data-theme="light"]` 作用域的 token 覆盖,多主题并存用 |
| `docs/usage.md` | **配谁(组件 → token)+ 双模规则 + 刻度 + 校验态 + 反模式** |
| `scripts/assert_tokens.py` | 自检:原色表 / 语义键 / 色值合法 / CSS 与语义逐条一致 / 对比度双档 / 文档与实现标记 |
| `preview/index.html` | 构件画廊(自包含、零外部子资源、加载不跳转、不依赖 localStorage) |

## Agent apply steps

1. 读 `tokens/semantic/dark.json`(或 `light.json`),**禁止自己编 hex**;需要原值出处就看 `atom` 指向的 `tokens/absolute.json` 条目。
2. 拷 `css/default.css` 进项目样式目录;要同页双模再拷 `css/themes.css`。
3. 在 `<html>` 上打 `data-theme`(近黑可省),页面根用 `.wrap`(+ `.section`)起版心与分区节奏。
4. 按 `docs/usage.md` §组件 → token 落构件类名:`announce` / `site-header` + `nav` + `lang-switch` + `theme-toggle` / `hero` / `section-head` / `work-card` / `service-card` / `sku-card`(`.is-featured` 是反色主推卡)/ `case-card` / `process-grid` / `faq-item` / `contact-form-card` + `field` / `site-footer`。
5. 切换按钮用 `<button class="theme-toggle" aria-pressed>` + 太阳/月亮两个内联 SVG(靠 `html[data-theme="light"]` 规则换图),点击只改 `data-theme`;不写 localStorage 也要能看。
6. 表单校验态走 `aria-invalid="true"` + `.field-error` + `.form-status`(`aria-live="polite"`),不要引入红色。
7. 自检:`python packs/token-harbor/scripts/assert_tokens.py`(会打印两组对比度实测值并逐条比对 CSS 与语义表)。

## Hard rules

- 只用一个强调色 = 墨本身;禁止加第二个彩色强调,禁止用色相承担状态或数据编码。
- `muted-soft`(近黑 3.53:1 / 暖白 2.81:1)只给可放弃的小字(法务页脚注),**禁止写正文**。
- 分层不用常驻阴影:卡面靠 `--surface` + `--line-hairline`,只有悬停才用 `--shadow-card` 浮起。
- 两模必须共用同一组语义键名;`footer-*` / `overlay-*` 是常量,不要各写一套值。
- `data-theme` 只写在 `<html>` 上;写在局部会漏掉页脚与表单。
- 禁止在组件里写颜色字面值(`#e8e6e1` 之类);一律走 token,否则两模与断言同时失效。
- 无渐变、无 webfont(包内零外部子资源),品牌标记用 CSS 画,不引外部图片或图标字体。
- `prefers-reduced-motion: reduce` 的降级块不许删;`--hit`(44px)是最小命中区,不许改小。
- 不在包内写域名、盘符路径、内网地址、内部标识或客户代号;示例文案用中性占位(`example.com` 之类)。
- 消费后必须在项目 `design-lock.json` 记 `assets[]`(`pack` / `version` / `sha`)。

← 回索引