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

FM Void · 全黑 void + 半透明等宽字

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

全黑 void + 半透明等宽字；戏在 canvas 背景;适用:UI 字小、letter-spacing 宽;背景用 canvas 表演;静音用 GainNode 思路

不适用场景

禁用:整屏 CSS 抖;第二层粒子堆叠;彩色 UI chrome

元数据

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

标签

  • dark
  • theme
  • mono
  • void

验证证据

2026-11-03 · python packs/fm-void/scripts/assert_tokens.py

PASS assert_tokens fm-void | variants=1 keys=19 hex=11 rgba=7 effects=1 contrast=ink/bg=19.26 onAccent/accent=21.00 | not_in_palette=[]

归属与许可

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

取用

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

源码与规则

pack.json
{
  "schema": 1,
  "id": "fm-void",
  "title": "FM Void · 全黑 void + 半透明等宽字",
  "kind": "theme",
  "category": "themes",
  "version": "1.0.0",
  "license": "MIT",
  "attribution": [
    {
      "name": "Sai Theme Lab · themes/fm-void.json",
      "license": "MIT",
      "what": "原色板来源(旧库原子,只读取用)"
    }
  ],
  "origin": {
    "project": "sai-theme-lab",
    "path": "themes/fm-void.json",
    "derived_from": null
  },
  "entry": "SKILL.md",
  "files": {
    "tokens": [
      "tokens/absolute.json",
      "tokens/index.json",
      "tokens/semantic/fm-void.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": [
    "dark",
    "theme",
    "mono",
    "void"
  ],
  "when": "全黑 void + 半透明等宽字；戏在 canvas 背景;适用:UI 字小、letter-spacing 宽;背景用 canvas 表演;静音用 GainNode 思路",
  "not_for": "禁用:整屏 CSS 抖;第二层粒子堆叠;彩色 UI chrome",
  "default_variant": "fm-void",
  "verified": {
    "date": "2026-11-03",
    "how": "python packs/fm-void/scripts/assert_tokens.py",
    "evidence": "PASS assert_tokens fm-void | variants=1 keys=19 hex=11 rgba=7 effects=1 contrast=ink/bg=19.26 onAccent/accent=21.00 | not_in_palette=[]"
  },
  "canonical_home": null
}
css/default.css
/* Default = fm-void — 只链接这一份即最快 apply */
/* FM Void — 全黑 void + 半透明等宽字；戏在 canvas 背景 */
/* 语义变量与 --theme-* 别名双发;字体/圆角透传源令牌 */

:root,
[data-theme="fm-void"],
.theme-fm-void {
  color-scheme: dark;
  --bg: #000000;
  --theme-bg: #000000;
  --bg-deep: #000000;
  --theme-bg-deep: #000000;
  --surface: rgba(255,255,255,0.04);
  --theme-surface: rgba(255,255,255,0.04);
  --surface-2: rgba(255,255,255,0.07);
  --theme-surface-2: rgba(255,255,255,0.07);
  --border: rgba(255,255,255,0.12);
  --theme-border: rgba(255,255,255,0.12);
  --ink: #f5f5f5;
  --theme-ink: #f5f5f5;
  --ink-muted: rgba(255,255,255,0.5);
  --theme-ink-muted: rgba(255,255,255,0.5);
  --ink-dim: rgba(255,255,255,0.35);
  --theme-ink-dim: rgba(255,255,255,0.35);
  --accent: #ffffff;
  --theme-accent: #ffffff;
  --accent-2: rgba(255,255,255,0.72);
  --theme-accent-2: rgba(255,255,255,0.72);
  --on-accent: #000000;
  --theme-on-accent: #000000;
  --red: #ff4d6d;
  --theme-red: #ff4d6d;
  --green: #7dffa3;
  --theme-green: #7dffa3;
  --aqua: #7dd3ff;
  --theme-aqua: #7dd3ff;
  --blue: #7dd3ff;
  --theme-blue: #7dd3ff;
  --purple: #d4a5ff;
  --theme-purple: #d4a5ff;
  --link: rgba(255,255,255,0.88);
  --theme-link: rgba(255,255,255,0.88);
  --code-bg: #0a0a0a;
  --theme-code-bg: #0a0a0a;
  --shadow: none;
  --theme-shadow: none;
  --radius-sm: 8px;
  --theme-radius-sm: 8px;
  --radius-md: 12px;
  --theme-radius-md: 12px;
  --radius-lg: 16px;
  --theme-radius-lg: 16px;
  --font-display: "JetBrains Mono", ui-monospace, Menlo, Consolas, monospace;
  --theme-font-display: "JetBrains Mono", ui-monospace, Menlo, Consolas, monospace;
  --font-body: "JetBrains Mono", ui-monospace, Menlo, Consolas, monospace;
  --theme-font-body: "JetBrains Mono", ui-monospace, Menlo, Consolas, monospace;
  --font-mono: "JetBrains Mono", ui-monospace, Menlo, Consolas, monospace;
  --theme-font-mono: "JetBrains Mono", ui-monospace, Menlo, Consolas, monospace;
}
css/all.css
/* FM Void — 全部变体 + 基础 chrome */
/* 全黑 void + 半透明等宽字；戏在 canvas 背景 */
/* 含 :root:单主题整站直接链接本文件 */

:root,
[data-theme="fm-void"],
.theme-fm-void {
  color-scheme: dark;
  --bg: #000000;
  --theme-bg: #000000;
  --bg-deep: #000000;
  --theme-bg-deep: #000000;
  --surface: rgba(255,255,255,0.04);
  --theme-surface: rgba(255,255,255,0.04);
  --surface-2: rgba(255,255,255,0.07);
  --theme-surface-2: rgba(255,255,255,0.07);
  --border: rgba(255,255,255,0.12);
  --theme-border: rgba(255,255,255,0.12);
  --ink: #f5f5f5;
  --theme-ink: #f5f5f5;
  --ink-muted: rgba(255,255,255,0.5);
  --theme-ink-muted: rgba(255,255,255,0.5);
  --ink-dim: rgba(255,255,255,0.35);
  --theme-ink-dim: rgba(255,255,255,0.35);
  --accent: #ffffff;
  --theme-accent: #ffffff;
  --accent-2: rgba(255,255,255,0.72);
  --theme-accent-2: rgba(255,255,255,0.72);
  --on-accent: #000000;
  --theme-on-accent: #000000;
  --red: #ff4d6d;
  --theme-red: #ff4d6d;
  --green: #7dffa3;
  --theme-green: #7dffa3;
  --aqua: #7dd3ff;
  --theme-aqua: #7dd3ff;
  --blue: #7dd3ff;
  --theme-blue: #7dd3ff;
  --purple: #d4a5ff;
  --theme-purple: #d4a5ff;
  --link: rgba(255,255,255,0.88);
  --theme-link: rgba(255,255,255,0.88);
  --code-bg: #0a0a0a;
  --theme-code-bg: #0a0a0a;
  --shadow: none;
  --theme-shadow: none;
  --radius-sm: 8px;
  --theme-radius-sm: 8px;
  --radius-md: 12px;
  --theme-radius-md: 12px;
  --radius-lg: 16px;
  --theme-radius-lg: 16px;
  --font-display: "JetBrains Mono", ui-monospace, Menlo, Consolas, monospace;
  --theme-font-display: "JetBrains Mono", ui-monospace, Menlo, Consolas, monospace;
  --font-body: "JetBrains Mono", ui-monospace, Menlo, Consolas, monospace;
  --theme-font-body: "JetBrains Mono", ui-monospace, Menlo, Consolas, monospace;
  --font-mono: "JetBrains Mono", ui-monospace, Menlo, Consolas, monospace;
  --theme-font-mono: "JetBrains Mono", ui-monospace, Menlo, Consolas, 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, none);
}

.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
/* FM Void · 共存版:只出 [data-theme] / .theme-<id> 作用域,不含 :root
   多主题应用(站点自带主题切换器)用这一份,避免全局覆盖项目自己的 token;
   单主题直接应用请用 css/default.css。color-scheme 只在 [data-theme] 块里给。 */

[data-theme="fm-void"],
.theme-fm-void {
  color-scheme: dark;
  --bg: #000000;
  --theme-bg: #000000;
  --bg-deep: #000000;
  --theme-bg-deep: #000000;
  --surface: rgba(255,255,255,0.04);
  --theme-surface: rgba(255,255,255,0.04);
  --surface-2: rgba(255,255,255,0.07);
  --theme-surface-2: rgba(255,255,255,0.07);
  --border: rgba(255,255,255,0.12);
  --theme-border: rgba(255,255,255,0.12);
  --ink: #f5f5f5;
  --theme-ink: #f5f5f5;
  --ink-muted: rgba(255,255,255,0.5);
  --theme-ink-muted: rgba(255,255,255,0.5);
  --ink-dim: rgba(255,255,255,0.35);
  --theme-ink-dim: rgba(255,255,255,0.35);
  --accent: #ffffff;
  --theme-accent: #ffffff;
  --accent-2: rgba(255,255,255,0.72);
  --theme-accent-2: rgba(255,255,255,0.72);
  --on-accent: #000000;
  --theme-on-accent: #000000;
  --red: #ff4d6d;
  --theme-red: #ff4d6d;
  --green: #7dffa3;
  --theme-green: #7dffa3;
  --aqua: #7dd3ff;
  --theme-aqua: #7dd3ff;
  --blue: #7dd3ff;
  --theme-blue: #7dd3ff;
  --purple: #d4a5ff;
  --theme-purple: #d4a5ff;
  --link: rgba(255,255,255,0.88);
  --theme-link: rgba(255,255,255,0.88);
  --code-bg: #0a0a0a;
  --theme-code-bg: #0a0a0a;
  --shadow: none;
  --theme-shadow: none;
  --radius-sm: 8px;
  --theme-radius-sm: 8px;
  --radius-md: 12px;
  --theme-radius-md: 12px;
  --radius-lg: 16px;
  --theme-radius-lg: 16px;
  --font-display: "JetBrains Mono", ui-monospace, Menlo, Consolas, monospace;
  --theme-font-display: "JetBrains Mono", ui-monospace, Menlo, Consolas, monospace;
  --font-body: "JetBrains Mono", ui-monospace, Menlo, Consolas, monospace;
  --theme-font-body: "JetBrains Mono", ui-monospace, Menlo, Consolas, monospace;
  --font-mono: "JetBrains Mono", ui-monospace, Menlo, Consolas, monospace;
  --theme-font-mono: "JetBrains Mono", ui-monospace, Menlo, Consolas, 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, none);
}

.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": "fm-void",
  "name": "FM Void",
  "mode": "dark",
  "signature": "全黑 void + 半透明等宽字；戏在 canvas 背景",
  "source": "themes/fm-void.json",
  "colors": {
    "bg": "#000000",
    "bgDeep": "#000000",
    "surface": "rgba(255,255,255,0.04)",
    "surface2": "rgba(255,255,255,0.07)",
    "border": "rgba(255,255,255,0.12)",
    "ink": "#f5f5f5",
    "inkMuted": "rgba(255,255,255,0.5)",
    "inkDim": "rgba(255,255,255,0.35)",
    "accent": "#ffffff",
    "accent2": "rgba(255,255,255,0.72)",
    "onAccent": "#000000",
    "red": "#ff4d6d",
    "green": "#7dffa3",
    "aqua": "#7dd3ff",
    "blue": "#7dd3ff",
    "purple": "#d4a5ff",
    "link": "rgba(255,255,255,0.88)",
    "codeBg": "#0a0a0a",
    "shadow": "none"
  }
}
tokens/index.json
{
  "default": "fm-void",
  "themes": [
    {
      "id": "fm-void",
      "name": "FM Void",
      "mode": "dark",
      "path": "tokens/semantic/fm-void.json",
      "default": true
    }
  ]
}
tokens/semantic/fm-void.json
{
  "id": "fm-void",
  "name": "FM Void",
  "mode": "dark",
  "signature": "全黑 void + 半透明等宽字；戏在 canvas 背景",
  "colors": {
    "bg": "#000000",
    "bgDeep": "#000000",
    "surface": "rgba(255,255,255,0.04)",
    "surface2": "rgba(255,255,255,0.07)",
    "border": "rgba(255,255,255,0.12)",
    "ink": "#f5f5f5",
    "inkMuted": "rgba(255,255,255,0.5)",
    "inkDim": "rgba(255,255,255,0.35)",
    "accent": "#ffffff",
    "accent2": "rgba(255,255,255,0.72)",
    "onAccent": "#000000",
    "red": "#ff4d6d",
    "green": "#7dffa3",
    "aqua": "#7dd3ff",
    "blue": "#7dd3ff",
    "purple": "#d4a5ff",
    "link": "rgba(255,255,255,0.88)",
    "codeBg": "#0a0a0a",
    "shadow": "none"
  },
  "fonts": {
    "display": "\"JetBrains Mono\", ui-monospace, Menlo, Consolas, monospace",
    "body": "\"JetBrains Mono\", ui-monospace, Menlo, Consolas, monospace",
    "mono": "\"JetBrains Mono\", ui-monospace, Menlo, Consolas, monospace"
  },
  "radius": {
    "sm": "8px",
    "md": "12px",
    "lg": "16px"
  },
  "derived": {
    "bg": "bg",
    "bgDeep": "bgDeep",
    "surface": "surface",
    "surface2": "surface2",
    "border": "border",
    "ink": "ink",
    "inkMuted": "inkMuted",
    "inkDim": "inkDim",
    "accent": "accent",
    "accent2": "accent2",
    "onAccent": "onAccent",
    "red": "red",
    "green": "green",
    "aqua": "aqua",
    "blue": "blue",
    "purple": "purple",
    "link": "link",
    "codeBg": "codeBg"
  },
  "a11y": {
    "contrast_min": 4.5,
    "pairs": {
      "ink/bg": 19.26,
      "onAccent/accent": 21.0
    },
    "adjusted": false,
    "notes": []
  }
}
docs/usage.md
# FM Void · 用法与配对规则

`fm-void` · mode `dark` · 默认变体 `fm-void`

**signature**:全黑 void + 半透明等宽字；戏在 canvas 背景

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

## 变体表

| id | mode | 何时用 |
|---|---|---|
| `fm-void` | `dark` | **默认**;全黑 void + 半透明等宽字；戏在 canvas 背景 |

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

| 语义键 | 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`(实测 21.00:1) |
| 链接 | `--link` | 链接一律用 `--link`;**强调色(`--accent`)不与链接同色** —— 本主题 `--link` = `rgba(255,255,255,0.88)` 与 `--accent` = `#ffffff` 不同值,可直接并置 |
| 危险 / 破坏性 | `--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` | "JetBrains Mono", ui-monospace, Menlo, Consolas, monospace |
| `body` | `--font-body` | "JetBrains Mono", ui-monospace, Menlo, Consolas, monospace |
| `mono` | `--font-mono` | "JetBrains Mono", ui-monospace, Menlo, Consolas, monospace |

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

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

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

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

- UI 字小、letter-spacing 宽
- 背景用 canvas 表演
- 静音用 GainNode 思路

## 反模式(源 `dont`)

- 整屏 CSS 抖
- 第二层粒子堆叠
- 彩色 UI chrome

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

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



## 应用片段

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

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

## 来源 / Provenance

- 本地来源(仅登记本机路径,已由 sanitize 处理):[本机路径已移除]
SKILL.md
---
name: fm-void
description: "FM Void(dark 全黑 void + 半透明等宽字；戏在 canvas 背景)。触发:FM Void / fm-void / 全黑 void + 半透明等宽字；戏在 canvas 背景。不做整站重构。"

---

# fm-void

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

全黑 void + 半透明等宽字；戏在 canvas 背景

## When to use

- 用户点名 FM Void / fm-void / 全黑 void + 半透明等宽字；戏在 canvas 背景
- 需要整套配色(bg / bg-deep / surface / ink / accent / 状态色)而不是单个色值
- 需要 UI 字小、letter-spacing 宽
- 需要 背景用 canvas 表演
- 需要 静音用 GainNode 思路

## When not to use

- 整站品牌设计系统(要自定义组件/字体体系)→ 用设计类 skill
- 别的主题族(用户点名其它风格)
- 整屏 CSS 抖
- 第二层粒子堆叠
- 彩色 UI chrome

## Default

**`fm-void`**(mode `dark`)

| role | hex |
|---|---|
| `bg` | `#000000` |
| `bgDeep` | `#000000` |
| `surface` | `rgba(255,255,255,0.04)` |
| `ink` | `#f5f5f5` |
| `accent` | `#ffffff` |
| `link` | `rgba(255,255,255,0.88)` |
| `red` | `#ff4d6d` |

## Sub-themes (id → when)

| id | mode | contrast | pick when |
|---|---|---|---|
| `fm-void` | `dark` | — | **默认**;全黑 void + 半透明等宽字；戏在 canvas 背景 |

## Files

| path | use |
|---|---|
| `tokens/absolute.json` | 源盘原色表(原样,含未参与语义映射的色) |
| `tokens/index.json` | 变体目录 + default |
| `tokens/semantic/fm-void.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** — 用户点名变体就用它;否则 `fm-void`。
2. **Read tokens** — `tokens/semantic/fm-void.json`(`colors` 是语义键,`derived` 说明它取自源盘哪个键)。
3. **写入 CSS 变量** — 项目已有 `--bg/--ink/--accent` 就沿用同名;否则整份贴,或同时写 `--theme-*` 别名。
4. **挂主题作用域** — `<html data-theme="fm-void" class="theme-fm-void">`;多主题站点用 `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 fm-void`。

### Minimal `:root` snippet (`fm-void`)

```css
:root {
  color-scheme: dark;
  --bg: #000000;
  --bg-deep: #000000;
  --surface: rgba(255,255,255,0.04);
  --surface-2: rgba(255,255,255,0.07);
  --border: rgba(255,255,255,0.12);
  --ink: #f5f5f5;
  --ink-muted: rgba(255,255,255,0.5);
  --ink-dim: rgba(255,255,255,0.35);
  --accent: #ffffff;
  --accent-2: rgba(255,255,255,0.72);
  --on-accent: #000000;
  --red: #ff4d6d;
  --green: #7dffa3;
  --aqua: #7dd3ff;
  --blue: #7dd3ff;
  --purple: #d4a5ff;
  --link: rgba(255,255,255,0.88);
  --code-bg: #0a0a0a;
  --shadow: none;
}
```

### HTML switch

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

## Hard rules

- **Never** 整屏 CSS 抖(源 `dont`)
- **Never** 第二层粒子堆叠(源 `dont`)
- **Never** 彩色 UI chrome(源 `dont`)

## Notes

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

← 回索引