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

saaaai Paper · 暖纸浅底 + 陶土 accent

saaaai-paperv1.0.0 主题 MIT

暖纸浅底 + 陶土 accent，主页 t6;适用:陶土作唯一 accent;浅底卡片白抬升

不适用场景

禁用:和 Claude 色板完全照抄不改名;高饱和多色

新窗口 ↗
载入预览…

卡片与舞台里跑的是包内真实的预览页;WebGL 类需点“运行预览”才会建立渲染上下文。

元数据

类目
主题 · 配色与字体
版本
v1.0.0
许可
MIT
规模
12 文件 · 66 KB
来源项目
sai-theme-lab · themes/saaaai-paper.json

标签

  • light
  • theme
  • paper
  • warm

验证证据

2026-11-03 · python packs/saaaai-paper/scripts/assert_tokens.py

PASS assert_tokens saaaai-paper | variants=1 keys=19 hex=17 rgba=1 effects=1 contrast=ink/bg=7.93 onAccent/accent=4.53 | not_in_palette=[]

归属与许可

  • Sai Theme Lab · themes/saaaai-paper.json · MIT
    原色板来源(旧库原子,只读取用)

取用方式

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

源码与规则

pack.json
{
  "schema": 1,
  "id": "saaaai-paper",
  "title": "saaaai Paper · 暖纸浅底 + 陶土 accent",
  "kind": "theme",
  "category": "themes",
  "version": "1.0.0",
  "license": "MIT",
  "attribution": [
    {
      "name": "Sai Theme Lab · themes/saaaai-paper.json",
      "license": "MIT",
      "what": "原色板来源(旧库原子,只读取用)"
    }
  ],
  "origin": {
    "project": "sai-theme-lab",
    "path": "themes/saaaai-paper.json",
    "derived_from": null
  },
  "entry": "SKILL.md",
  "files": {
    "tokens": [
      "tokens/absolute.json",
      "tokens/index.json",
      "tokens/semantic/saaaai-paper.json"
    ],
    "css": [
      "css/default.css",
      "css/all.css",
      "css/themes.css"
    ],
    "usage": "docs/usage.md",
    "assert": "scripts/assert_tokens.py",
    "preview": "preview/index.html"
  },
  "tags": [
    "light",
    "theme",
    "paper",
    "warm"
  ],
  "when": "暖纸浅底 + 陶土 accent，主页 t6;适用:陶土作唯一 accent;浅底卡片白抬升",
  "not_for": "禁用:和 Claude 色板完全照抄不改名;高饱和多色",
  "default_variant": "saaaai-paper",
  "verified": {
    "date": "2026-11-03",
    "how": "python packs/saaaai-paper/scripts/assert_tokens.py",
    "evidence": "PASS assert_tokens saaaai-paper | variants=1 keys=19 hex=17 rgba=1 effects=1 contrast=ink/bg=7.93 onAccent/accent=4.53 | not_in_palette=[]"
  },
  "canonical_home": null,
  "changelog": [
    "1.0.0:语义层按 WCAG ≥4.5:1 修正 accent/on-accent 配对(见 tokens/semantic 的 a11y 与 docs/usage.md);tokens/absolute.json 未改。"
  ]
}
css/default.css
/* Default = saaaai-paper — 只链接这一份即最快 apply */
/* saaaai Paper — 暖纸浅底 + 陶土 accent，主页 t6 */
/* 语义变量与 --theme-* 别名双发;字体/圆角透传源令牌 */

:root,
[data-theme="saaaai-paper"],
.theme-saaaai-paper {
  color-scheme: light;
  --bg: #F5F2EC;
  --theme-bg: #F5F2EC;
  --bg-deep: #EBE6DC;
  --theme-bg-deep: #EBE6DC;
  --surface: #FFFFFF;
  --theme-surface: #FFFFFF;
  --surface-2: #F8F5F0;
  --theme-surface-2: #F8F5F0;
  --border: rgba(0,0,0,0.12);
  --theme-border: rgba(0,0,0,0.12);
  --ink: #4A4A4A;
  --theme-ink: #4A4A4A;
  --ink-muted: #6A6A6A;
  --theme-ink-muted: #6A6A6A;
  --ink-dim: #8A8A8A;
  --theme-ink-dim: #8A8A8A;
  --accent: #B85C3E;
  --theme-accent: #B85C3E;
  --accent-2: #CC7D5E;
  --theme-accent-2: #CC7D5E;
  --on-accent: #FFFFFF;
  --theme-on-accent: #FFFFFF;
  --red: #C64545;
  --theme-red: #C64545;
  --green: #3D9A55;
  --theme-green: #3D9A55;
  --aqua: #3D8A8A;
  --theme-aqua: #3D8A8A;
  --blue: #3D6A9A;
  --theme-blue: #3D6A9A;
  --purple: #8A5A7A;
  --theme-purple: #8A5A7A;
  --link: #CC7D5E;
  --theme-link: #CC7D5E;
  --code-bg: #1A1816;
  --theme-code-bg: #1A1816;
  --shadow: 0 10px 30px rgba(74,74,74,.10);
  --theme-shadow: 0 10px 30px rgba(74,74,74,.10);
  --radius-sm: 4px;
  --theme-radius-sm: 4px;
  --radius-md: 8px;
  --theme-radius-md: 8px;
  --radius-lg: 12px;
  --theme-radius-lg: 12px;
  --font-display: "Klee One", "Noto Serif SC", serif;
  --theme-font-display: "Klee One", "Noto Serif SC", serif;
  --font-body: "Klee One", "Noto Sans SC", sans-serif;
  --theme-font-body: "Klee One", "Noto Sans SC", sans-serif;
  --font-mono: "JetBrains Mono", ui-monospace, monospace;
  --theme-font-mono: "JetBrains Mono", ui-monospace, monospace;
}
css/all.css
/* saaaai Paper — 全部变体 + 基础 chrome */
/* 暖纸浅底 + 陶土 accent，主页 t6 */
/* 含 :root:单主题整站直接链接本文件 */

:root,
[data-theme="saaaai-paper"],
.theme-saaaai-paper {
  color-scheme: light;
  --bg: #F5F2EC;
  --theme-bg: #F5F2EC;
  --bg-deep: #EBE6DC;
  --theme-bg-deep: #EBE6DC;
  --surface: #FFFFFF;
  --theme-surface: #FFFFFF;
  --surface-2: #F8F5F0;
  --theme-surface-2: #F8F5F0;
  --border: rgba(0,0,0,0.12);
  --theme-border: rgba(0,0,0,0.12);
  --ink: #4A4A4A;
  --theme-ink: #4A4A4A;
  --ink-muted: #6A6A6A;
  --theme-ink-muted: #6A6A6A;
  --ink-dim: #8A8A8A;
  --theme-ink-dim: #8A8A8A;
  --accent: #B85C3E;
  --theme-accent: #B85C3E;
  --accent-2: #CC7D5E;
  --theme-accent-2: #CC7D5E;
  --on-accent: #FFFFFF;
  --theme-on-accent: #FFFFFF;
  --red: #C64545;
  --theme-red: #C64545;
  --green: #3D9A55;
  --theme-green: #3D9A55;
  --aqua: #3D8A8A;
  --theme-aqua: #3D8A8A;
  --blue: #3D6A9A;
  --theme-blue: #3D6A9A;
  --purple: #8A5A7A;
  --theme-purple: #8A5A7A;
  --link: #CC7D5E;
  --theme-link: #CC7D5E;
  --code-bg: #1A1816;
  --theme-code-bg: #1A1816;
  --shadow: 0 10px 30px rgba(74,74,74,.10);
  --theme-shadow: 0 10px 30px rgba(74,74,74,.10);
  --radius-sm: 4px;
  --theme-radius-sm: 4px;
  --radius-md: 8px;
  --theme-radius-md: 8px;
  --radius-lg: 12px;
  --theme-radius-lg: 12px;
  --font-display: "Klee One", "Noto Serif SC", serif;
  --theme-font-display: "Klee One", "Noto Serif SC", serif;
  --font-body: "Klee One", "Noto Sans SC", sans-serif;
  --theme-font-body: "Klee One", "Noto Sans SC", sans-serif;
  --font-mono: "JetBrains Mono", ui-monospace, monospace;
  --theme-font-mono: "JetBrains Mono", ui-monospace, monospace;
}

/* 基础 chrome(opt-in):<body class="theme-apply"> 或 [data-theme-apply] 上底色与基础件 */
.theme-apply,
[data-theme-apply] {
  background: var(--bg);
  color: var(--ink);
  font-family: var(--font-body, system-ui, sans-serif);
  line-height: 1.6;
}

.theme-apply a,
[data-theme-apply] a {
  color: var(--link, var(--accent));
}

.theme-apply code,
.theme-apply pre,
[data-theme-apply] code,
[data-theme-apply] pre {
  font-family: var(--font-mono, ui-monospace, monospace);
  background: var(--code-bg, var(--surface2, var(--surface)));
  border-radius: var(--radius-sm, 4px);
}

.theme-apply .panel,
[data-theme-apply] .panel {
  background: var(--surface);
  border: 1px solid var(--border);
  border-radius: var(--radius-md, 6px);
  box-shadow: var(--shadow, 0 10px 30px rgba(74,74,74,.10));
}

.theme-apply .btn-primary,
[data-theme-apply] .btn-primary {
  background: var(--accent);
  color: var(--on-accent);
  border-radius: var(--radius-sm, 4px);
}
css/themes.css
/* saaaai Paper · 共存版:只出 [data-theme] / .theme-<id> 作用域,不含 :root
   多主题应用(站点自带主题切换器)用这一份,避免全局覆盖项目自己的 token;
   单主题直接应用请用 css/default.css。color-scheme 只在 [data-theme] 块里给。 */

[data-theme="saaaai-paper"],
.theme-saaaai-paper {
  color-scheme: light;
  --bg: #F5F2EC;
  --theme-bg: #F5F2EC;
  --bg-deep: #EBE6DC;
  --theme-bg-deep: #EBE6DC;
  --surface: #FFFFFF;
  --theme-surface: #FFFFFF;
  --surface-2: #F8F5F0;
  --theme-surface-2: #F8F5F0;
  --border: rgba(0,0,0,0.12);
  --theme-border: rgba(0,0,0,0.12);
  --ink: #4A4A4A;
  --theme-ink: #4A4A4A;
  --ink-muted: #6A6A6A;
  --theme-ink-muted: #6A6A6A;
  --ink-dim: #8A8A8A;
  --theme-ink-dim: #8A8A8A;
  --accent: #B85C3E;
  --theme-accent: #B85C3E;
  --accent-2: #CC7D5E;
  --theme-accent-2: #CC7D5E;
  --on-accent: #FFFFFF;
  --theme-on-accent: #FFFFFF;
  --red: #C64545;
  --theme-red: #C64545;
  --green: #3D9A55;
  --theme-green: #3D9A55;
  --aqua: #3D8A8A;
  --theme-aqua: #3D8A8A;
  --blue: #3D6A9A;
  --theme-blue: #3D6A9A;
  --purple: #8A5A7A;
  --theme-purple: #8A5A7A;
  --link: #CC7D5E;
  --theme-link: #CC7D5E;
  --code-bg: #1A1816;
  --theme-code-bg: #1A1816;
  --shadow: 0 10px 30px rgba(74,74,74,.10);
  --theme-shadow: 0 10px 30px rgba(74,74,74,.10);
  --radius-sm: 4px;
  --theme-radius-sm: 4px;
  --radius-md: 8px;
  --theme-radius-md: 8px;
  --radius-lg: 12px;
  --theme-radius-lg: 12px;
  --font-display: "Klee One", "Noto Serif SC", serif;
  --theme-font-display: "Klee One", "Noto Serif SC", serif;
  --font-body: "Klee One", "Noto Sans SC", sans-serif;
  --theme-font-body: "Klee One", "Noto Sans SC", sans-serif;
  --font-mono: "JetBrains Mono", ui-monospace, monospace;
  --theme-font-mono: "JetBrains Mono", ui-monospace, monospace;
}

/* 基础 chrome(opt-in):<body class="theme-apply"> 或 [data-theme-apply] 上底色与基础件 */
.theme-apply,
[data-theme-apply] {
  background: var(--bg);
  color: var(--ink);
  font-family: var(--font-body, system-ui, sans-serif);
  line-height: 1.6;
}

.theme-apply a,
[data-theme-apply] a {
  color: var(--link, var(--accent));
}

.theme-apply code,
.theme-apply pre,
[data-theme-apply] code,
[data-theme-apply] pre {
  font-family: var(--font-mono, ui-monospace, monospace);
  background: var(--code-bg, var(--surface2, var(--surface)));
  border-radius: var(--radius-sm, 4px);
}

.theme-apply .panel,
[data-theme-apply] .panel {
  background: var(--surface);
  border: 1px solid var(--border);
  border-radius: var(--radius-md, 6px);
  box-shadow: var(--shadow, 0 10px 30px rgba(74,74,74,.10));
}

.theme-apply .btn-primary,
[data-theme-apply] .btn-primary {
  background: var(--accent);
  color: var(--on-accent);
  border-radius: var(--radius-sm, 4px);
}
tokens/absolute.json
{
  "id": "saaaai-paper",
  "name": "saaaai Paper",
  "mode": "light",
  "signature": "暖纸浅底 + 陶土 accent，主页 t6",
  "source": "themes/saaaai-paper.json",
  "colors": {
    "bg": "#F5F2EC",
    "bgDeep": "#EBE6DC",
    "surface": "#FFFFFF",
    "surface2": "#F8F5F0",
    "border": "rgba(0,0,0,0.12)",
    "ink": "#4A4A4A",
    "inkMuted": "#6A6A6A",
    "inkDim": "#8A8A8A",
    "accent": "#CC7D5E",
    "accent2": "#B85C3E",
    "onAccent": "#FFFFFF",
    "red": "#C64545",
    "green": "#3D9A55",
    "aqua": "#3D8A8A",
    "blue": "#3D6A9A",
    "purple": "#8A5A7A",
    "link": "#CC7D5E",
    "codeBg": "#1A1816",
    "shadow": "0 10px 30px rgba(74,74,74,.10)"
  }
}
tokens/index.json
{
  "default": "saaaai-paper",
  "themes": [
    {
      "id": "saaaai-paper",
      "name": "saaaai Paper",
      "mode": "light",
      "path": "tokens/semantic/saaaai-paper.json",
      "default": true
    }
  ]
}
tokens/semantic/saaaai-paper.json
{
  "id": "saaaai-paper",
  "name": "saaaai Paper",
  "mode": "light",
  "signature": "暖纸浅底 + 陶土 accent，主页 t6",
  "colors": {
    "bg": "#F5F2EC",
    "bgDeep": "#EBE6DC",
    "surface": "#FFFFFF",
    "surface2": "#F8F5F0",
    "border": "rgba(0,0,0,0.12)",
    "ink": "#4A4A4A",
    "inkMuted": "#6A6A6A",
    "inkDim": "#8A8A8A",
    "accent": "#B85C3E",
    "accent2": "#CC7D5E",
    "onAccent": "#FFFFFF",
    "red": "#C64545",
    "green": "#3D9A55",
    "aqua": "#3D8A8A",
    "blue": "#3D6A9A",
    "purple": "#8A5A7A",
    "link": "#CC7D5E",
    "codeBg": "#1A1816",
    "shadow": "0 10px 30px rgba(74,74,74,.10)"
  },
  "fonts": {
    "display": "\"Klee One\", \"Noto Serif SC\", serif",
    "body": "\"Klee One\", \"Noto Sans SC\", sans-serif",
    "mono": "\"JetBrains Mono\", ui-monospace, monospace"
  },
  "radius": {
    "sm": "4px",
    "md": "8px",
    "lg": "12px"
  },
  "derived": {
    "bg": "bg",
    "bgDeep": "bgDeep",
    "surface": "surface",
    "surface2": "surface2",
    "border": "border",
    "ink": "ink",
    "inkMuted": "inkMuted",
    "inkDim": "inkDim",
    "accent": "accent2",
    "accent2": "accent",
    "onAccent": "onAccent",
    "red": "red",
    "green": "green",
    "aqua": "aqua",
    "blue": "blue",
    "purple": "purple",
    "link": "link",
    "codeBg": "codeBg"
  },
  "a11y": {
    "contrast_min": 4.5,
    "pairs": {
      "ink/bg": 7.93,
      "onAccent/accent": 4.53
    },
    "adjusted": true,
    "notes": [
      "源 accent/onAccent 实测 3.15:1 < 4.5,按源色板把 --accent 改用 accent2(#B85C3E),配对 4.53:1"
    ]
  }
}
docs/usage.md
# saaaai Paper · 用法与配对规则

`saaaai-paper` · mode `light` · 默认变体 `saaaai-paper`

**signature**:暖纸浅底 + 陶土 accent，主页 t6

- 原色表:`tokens/absolute.json`(源盘 `colors` 原样,不改名不近似)。
- 语义映射:`tokens/semantic/saaaai-paper.json`(`derived` 记每个语义键取自哪个源键;`a11y` 记对比度实测)。
- 变量双发:裸语义名(`--bg`)与 `--theme-` 前缀别名(`--theme-bg`)同值,便于接既有项目。
- 你不需要发明 hex:缺哪个角色就用对应变量,不要拿别的色近似。

## 变体表

| id | mode | 何时用 |
|---|---|---|
| `saaaai-paper` | `light` | **默认**;暖纸浅底 + 陶土 accent，主页 t6 |

## 变量表(语义名 ↔ 前缀别名)

| 语义键 | CSS 变量 | 别名 |
|---|---|---|
| `bg` | `--bg` | `--theme-bg` |
| `bgDeep` | `--bg-deep` | `--theme-bg-deep` |
| `surface` | `--surface` | `--theme-surface` |
| `surface2` | `--surface-2` | `--theme-surface-2` |
| `border` | `--border` | `--theme-border` |
| `ink` | `--ink` | `--theme-ink` |
| `inkMuted` | `--ink-muted` | `--theme-ink-muted` |
| `inkDim` | `--ink-dim` | `--theme-ink-dim` |
| `accent` | `--accent` | `--theme-accent` |
| `accent2` | `--accent-2` | `--theme-accent-2` |
| `onAccent` | `--on-accent` | `--theme-on-accent` |
| `red` | `--red` | `--theme-red` |
| `green` | `--green` | `--theme-green` |
| `aqua` | `--aqua` | `--theme-aqua` |
| `blue` | `--blue` | `--theme-blue` |
| `purple` | `--purple` | `--theme-purple` |
| `link` | `--link` | `--theme-link` |
| `codeBg` | `--code-bg` | `--theme-code-bg` |
| `shadow` | `--shadow` | `--theme-shadow` |

## 配对规则(谁配谁)

| 用途 | 变量 | 口径 |
|---|---|---|
| 正文 / 段落 | `--ink` | 页面主文字色,始终用于 `--bg` 之上 |
| 次要文字 | `--ink-muted` / `--ink-dim` | 说明、元信息、时间戳;`--ink-muted` 比 `--ink-dim` 更接近正文 |
| 卡面 / 面板 | `--surface` + `--border` | 卡底用 `--surface`,描边用 `--border`;需要抬升时 `--surface-2` |
| 主按钮 | `--accent` + `--on-accent` | 一个视区只放一个主 CTA;文字色必须用 `--on-accent`(实测 4.53:1) |
| 链接 | `--link` | 链接一律用 `--link`;**强调色(`--accent`)不与链接同色** —— 本主题 `--link` = `#CC7D5E` 与 `--accent` = `#B85C3E` 不同值,可直接并置 |
| 危险 / 破坏性 | `--red` | 删除、错误、警报 |
| 成功 | `--green` | 通过、已完成 |
| 页面底 | `--bg` / `--bg-deep` | 大底用 `--bg`,更深的分层用 `--bg-deep` |

一行口径:正文 `--ink`,次要 `--ink-muted`/`--ink-dim`,卡面 `--surface`+`--border`,主按钮 `--accent`+`--on-accent`,链接 `--link`,危险 `--red`,成功 `--green`;强调色不做链接色。

## 字体配方(源 `fonts` 透传)

| 角色 | 变量 | 栈 |
|---|---|---|
| `display` | `--font-display` | "Klee One", "Noto Serif SC", serif |
| `body` | `--font-body` | "Klee One", "Noto Sans SC", sans-serif |
| `mono` | `--font-mono` | "JetBrains Mono", ui-monospace, monospace |

- 标题用 `var(--font-display)`,正文 `var(--font-body)`,代码/数字 `var(--font-mono)`;字重与字号档位不在本包内,按下方 `do` 的约束落地。

## 圆角(源 `radius` 透传)

| 变量 | 值 |
|---|---|
| `--radius-sm` | 4px |
| `--radius-md` | 8px |
| `--radius-lg` | 12px |

## 推荐做法(源 `do`)

- 陶土作唯一 accent
- 浅底卡片白抬升

## 反模式(源 `dont`)

- 和 Claude 色板完全照抄不改名
- 高饱和多色

## 对比度实测(WCAG,自写公式)

| 组合 | 实测 | 门槛 |
|---|---|---|
| `ink` on `bg` | 7.93:1 | ≥ 4.5:1 |
| `onAccent` on `accent` | 4.53:1 | ≥ 4.5:1 |

### 语义层留痕(透明记录)

- 源 accent/onAccent 实测 3.15:1 < 4.5,按源色板把 --accent 改用 accent2(#B85C3E),配对 4.53:1

## 应用片段

```css
/* 单主题:把 css/default.css 全文贴进项目,或在 <head> 里 link 它 */
/* 多主题共存:link css/themes.css,用 <html data-theme="saaaai-paper"> 决定何时生效(无 :root,不覆盖项目 token) */
```

```html
<html data-theme="saaaai-paper" class="theme-saaaai-paper" lang="zh-CN">
  <link rel="stylesheet" href="css/default.css">
```

## 来源 / Provenance

- 2026-09-30核验：saaaai.com线上实为黑底星空void风，与本主题无同源关系；本主题仅为暖纸通用件，禁再标主站t6同源
SKILL.md
---
name: saaaai-paper
description: "saaaai Paper(light 暖纸浅底 + 陶土 accent，主页 t6)。触发:saaaai Paper / saaaai-paper / 暖纸浅底 + 陶土 accent，主页 t6。不做整站重构。"

---

# saaaai-paper

让任何网页/面板变成 **saaaai Paper** 的样子,不用 agent 自己编 hex。

暖纸浅底 + 陶土 accent，主页 t6

## When to use

- 用户点名 saaaai Paper / saaaai-paper / 暖纸浅底 + 陶土 accent，主页 t6
- 需要整套配色(bg / bg-deep / surface / ink / accent / 状态色)而不是单个色值
- 需要 陶土作唯一 accent
- 需要 浅底卡片白抬升

## When not to use

- 整站品牌设计系统(要自定义组件/字体体系)→ 用设计类 skill
- 别的主题族(用户点名其它风格)
- 和 Claude 色板完全照抄不改名
- 高饱和多色

## Default

**`saaaai-paper`**(mode `light`)

| role | hex |
|---|---|
| `bg` | `#F5F2EC` |
| `bgDeep` | `#EBE6DC` |
| `surface` | `#FFFFFF` |
| `ink` | `#4A4A4A` |
| `accent` | `#B85C3E` |
| `link` | `#CC7D5E` |
| `red` | `#C64545` |

## Sub-themes (id → when)

| id | mode | contrast | pick when |
|---|---|---|---|
| `saaaai-paper` | `light` | — | **默认**;暖纸浅底 + 陶土 accent，主页 t6 |

## Files

| path | use |
|---|---|
| `tokens/absolute.json` | 源盘原色表(原样,含未参与语义映射的色) |
| `tokens/index.json` | 变体目录 + default |
| `tokens/semantic/saaaai-paper.json` | 语义映射 + `derived`(取源哪个键)+ `a11y`(对比度实测) |
| `css/default.css` | 默认变体一份,含 `:root`,最快 apply |
| `css/all.css` | 全部变体 + 基础 chrome,含 `:root` |
| `css/themes.css` | 共存版:同 all.css 但**无 `:root`**,只 `[data-theme]` / `.theme-<id>` 作用域 |
| `docs/usage.md` | 配对规则 / 字体配方 / 反模式(中文) |
| `preview/index.html` | 活预览(独立单文件) |

## Agent apply steps

1. **Pick variant** — 用户点名变体就用它;否则 `saaaai-paper`。
2. **Read tokens** — `tokens/semantic/saaaai-paper.json`(`colors` 是语义键,`derived` 说明它取自源盘哪个键)。
3. **写入 CSS 变量** — 项目已有 `--bg/--ink/--accent` 就沿用同名;否则整份贴,或同时写 `--theme-*` 别名。
4. **挂主题作用域** — `<html data-theme="saaaai-paper" class="theme-saaaai-paper">`;多主题站点用 `css/themes.css`。
5. **选文件** — 单主题 `css/default.css`;多主题 `css/all.css`(带 `:root`)或 `css/themes.css`(不带)。
6. **按角色套件**:
   - 页面底 → `--bg` / `--bg-deep`
   - 卡面面板 → `--surface` + `--border`
   - 正文 → `--ink`;次要 → `--ink-muted` / `--ink-dim`
   - 主按钮 → `--accent` + `--on-accent`(一屏一个 CTA)
   - 链接 → `--link`(**不**用 `--accent`,强调色不做链接色)
   - 危险 → `--red`;成功 → `--green`
7. **不要发明 hex** — 颜色只能来自 `tokens/absolute.json`;缺角色就跳过该变量。
8. **自检** — `python scripts/assert_tokens.py` 必须打印 `PASS assert_tokens saaaai-paper`。

### Minimal `:root` snippet (`saaaai-paper`)

```css
:root {
  color-scheme: light;
  --bg: #F5F2EC;
  --bg-deep: #EBE6DC;
  --surface: #FFFFFF;
  --surface-2: #F8F5F0;
  --border: rgba(0,0,0,0.12);
  --ink: #4A4A4A;
  --ink-muted: #6A6A6A;
  --ink-dim: #8A8A8A;
  --accent: #B85C3E;
  --accent-2: #CC7D5E;
  --on-accent: #FFFFFF;
  --red: #C64545;
  --green: #3D9A55;
  --aqua: #3D8A8A;
  --blue: #3D6A9A;
  --purple: #8A5A7A;
  --link: #CC7D5E;
  --code-bg: #1A1816;
  --shadow: 0 10px 30px rgba(74,74,74,.10);
}
```

### HTML switch

```html
<html data-theme="saaaai-paper" class="theme-saaaai-paper">
  <link rel="stylesheet" href="css/default.css">
```

## Hard rules

- **Never** 和 Claude 色板完全照抄不改名(源 `dont`)
- **Never** 高饱和多色(源 `dont`)

## Notes

- 预览:`preview/index.html`,单文件可直接打开
- 来源与语义层修正:`docs/usage.md` 末节。

← 回目录