CodeWF.Avalonia 文档
dotnet9
CodeWF.Avalonia / 文档 / 配色与排版令牌规则

配色与排版令牌规则

⏱ 预计阅读 23 分钟 适用于 net10.0 同步于 2026-11-08 来源: CodeWF · docs/配色与排版令牌规则.md ✎ 在 GitHub 编辑此页

状态:草案 v1(ruleVersion: 7) 地位:本文件(含附录 A 的机器可读数据块)是控件层配色、Markdown 层主题、密度与尺寸档的唯一事实源。 C# 派生引擎、三个 HTML 原型的生成器、Demo 与应用的一切令牌常数必须源自本文,禁止在代码内另行抄写常数。 常数标定阶段允许调整附录 A 的取值,调整后必须同步修改本文并递增 ruleVersion。 v6 变更:新增 §5.1 画布中性化——paper/surface 由引擎去色温为等明度中性灰,色相只留在墨、accent 与交互态(废止 v5 的"色温偏染 ≤ 5%"表述)。 v7 变更:新增派生键 accentInk(accent 作正文/代码文字时的文字级强调色,≥4.5:1)与 fieldBorder(输入类控件描边,≥3:1),见 §2/§3;沿用 §5.1 去色温画布。


§0 范围与分层

text
┌─ 控件层(不含 Markdown 渲染内容) ────────────────────────────┐
│ 8 色编写层 → 派生引擎 → 语义键(~30) → Semi/Ursa 覆写 → 控件    │
│ 密度三档(紧凑/正常/宽松):字号/控件高/间距/圆角               │
└──────────────────────────────────────────────────────────────┘
┌─ Markdown 层(渲染出的文档内容) ─────────────────────────────┐
│ 主题自成体系:accent/decoration × 双明暗 + 内置中性阶梯         │
│             + 排版相对量 + 纸面块(backdrop / contentSurface)  │
│ 尺寸档(紧凑/正常/宽松):基准 BodySize,与控件层密度独立       │
└──────────────────────────────────────────────────────────────┘

两层之间的四个接缝(全部边界,别在别处耦合):

  1. 明暗联动:切明暗时 Markdown 主题切到自己的 Dark 侧,但不随界面配色变;
  2. 纸面归属:无缝型主题渲染在控件层 Paper 上;成品型主题自带纸面(见 §8);
  3. Mermaid / 图表:图表需要多色,从控件层 accent 派生(维持现状映射,写在 §4);
  4. 编辑器源码区:chrome(背景/当前行/行号/选区)归控件层;字号归 Markdown 尺寸档——源码与预览都是"读文档",同档。

术语表

术语 含义
编写层 用户/设计者需要手写的最小输入(控件层 8 色、Markdown 主题参数)
消费层 控件与样式实际引用的稳定键(语义键、CodeWFMarkdown*),全部由派生引擎生成
派生 由基础色按固定公式(透明度叠加/混合)计算消费层取值
烘焙 派生时把透明度合成到已知底色上,输出不透明色;控件永远消费确定色
快照 从本规则生成、供各 HTML 原型使用的 CSS 令牌文件,带版本戳,禁止手写

第一部分 · 控件层

§1 基础色 8 键

每个键必须提供浅色、深色两态取值。最小编写量是 4 键(paper/surface/ink/accent):状态四键有全局默认值(附录 A statusDefaults),仅当与 accent 色相冲突时覆盖(如 Crimson 的 danger、Amber 的 warning)。

键 语义 浅色态取值原则 深色态取值原则
paper 纸面:编辑器、文档预览、阅读面的底 近白(中性化见 §5.1) 近黑(中性化见 §5.1)
surface 面板、侧栏、状态栏、卡片 比 paper 深一档(海拔 -1),与 paper 同为画布、引擎中性化(§5.1) 比 paper 亮一档(海拔 +1),同左
ink 主文字,也是一切中性派生的"墨" 深色(近黑带主题色温) 浅色(近白带主题色温)
accent 强调:链接、选中、焦点、品牌位 深而饱满(白字可读) 亮而饱满(墨字可读)
danger 错误状态 全局默认,冲突时覆盖 同左
success 成功状态 同上 同上
warning 警告状态 同上 同上
info 信息状态(缺省可复用 accent) 同上 同上

§2 九套高对比配色

**高对比 ≠ 高饱和。**本套配色的量化标准(生成器必须校验,见 §5):

  • 正文 ink↔paper ≥ 10:1(AAA 级);
  • 次要文字 muted ≥ 4.5:1;accent 作为文字(链接、选中标签、图标、描边)≥ 3:1——它是状态色而非正文字色, 按 WCAG 1.4.11(非文本内容与 UI 组件)判定;正文可读性由 ink/muted 两档的 4.5:1 守住。 实测九套浅底最差 3.26:1(鼠尾草,其余八套 ≥4.94)、深底最差 8.34:1;若按 4.5:1 硬判,等于逼着把品牌强调色整体压暗一档。
  • v7 起补充:当 accent 落在正文性文字上(Markdown 行内代码、代码关键字、选中项文字等成段阅读场景), 改用派生键 accentInk(见 §3),对 paper/surface ≥ 4.5:1——可读性按正文字色判定,不适用上一条的 3:1 豁免; 输入类控件的描边改用 fieldBorder,对所在面板 ≥ 3:1(WCAG 1.4.11 组件判定)。
  • 深色态表面至少有 2 级可感知海拔差;
  • 表面由引擎中性化(§5.1),色相只保留在墨、accent 与交互态;对比来自墨深 + accent 色度,不允许靠深艳纸面做对比。

九套名单(3×3 九宫格目录,数据见附录 A palettes):

Key 名称 定位
graphite 石墨 无彩色,纯明度对比的基准套
indigo 靛蓝 经典蓝,替代旧默认蓝的现代取值
teal 青碧 冷青
pine 松绿 沉稳绿
sky 天青 清朗蓝青,介于靛蓝与青碧之间
amber 琥珀 暖金
crimson 绯红 冷艳红
violet 紫晶 紫
terracotta 陶土 暖陶

替换声明:本 9 套直接替换库内现有 16 套内置配色,不做旧 key 兼容(自用为主)。原 16 套 axaml 在迁移时删除,StudioPalette 枚举改为字符串 Key 注册表(§13)。

§3 派生规则表

固定公式,不随配色变;@ 表示透明度叠加后烘焙到指定底色;mix(A→B, n%) 表示 A 向 B 混合 n%。

派生键 浅色态 深色态 说明
muted ink@64% → paper(不足 4.5:1 时按 1% 步进加深至恰好满足,见 §3 行动渐变端点同款约束) 同左 次要文字
accentInk mix(ink→accent, 40%)(v7;accent 作正文/代码文字时的文字色,对 paper/surface ≥ 4.5:1,见 §2) 同左 文字级强调色
disabled(文字) ink@40% → paper 同左
disabled(底) ink@6% → paper 同左
border ink@12% → paper ink@16% → paper 弱分隔线
controlBorder ink@20% → paper ink@26% → paper 一般控件描边
fieldBorder mix(paper→ink, 55%)(v7;输入类控件描边,对所在面板 ≥ 3:1) 同左 输入控件描边
hover ink@5% → surface ink@7% → surface 悬浮
raised ink@4% → paper ink@6% → paper 当前行、浅浮层底
selected accent@12% → paper accent@18% → paper 选中项背景
accentSoft accent@10% → paper(不足 4.5:1 时向 paper 回退,下限 3%,见下"软底收敛") 同左(起点 16%) 软强调背景
selection accent@24% → paper accent@30% → paper 文本选区
statusSoft status@12% → paper status@18% → paper danger/success/warning/info 各一份;按压档为软底 +4%;两档同受软底收敛约束
scrim 黑@40% 黑@60% 模态遮罩,用纯黑不用 ink
primaryHover mix(accent→paper, 8%)(不足 4.5:1 时向 accent 收敛,同行动渐变约束) mix(accent→白, 8%)(同左) 主按钮悬浮
primaryPressed mix(accent→ink, 10%) mix(accent→黑, 12%) 主按钮按压
primaryDisabled ink@12% → paper(底)/ ink@40%(字) 同左
gradientStart = accent = accent 标题渐变起点
gradientEnd mix(accent→白, 25%) mix(accent→paper, 20%) 渐变终点(全界面唯一渐变)
overlay = surface = surface 弹窗、菜单浮层底,靠阴影分层
onAccent 自动判定(见下) 同左 accent 上的文字

onAccent 自动判定:分别计算白字与黑字在 accent 上的对比度,取更高者(浅色态 ink 近黑、等价于黑字;深色态 ink 为亮色不可作 accent 上文字,故候选固定为黑)。

行动渐变端点约束:StudioActionGradient = accent → gradientEnd,onAccent 判定的文字色在渐变全插值区间须保持 ≥4.5:1。gradientEnd 按派生表混合,若与文字色对比不足 4.5:1,生成器/引擎向 accent 收敛混合比例直至恰好满足(中明度 accent 如青碧浅态会触发收敛)。

软底收敛(accentSoft / statusSoft 共用):软底上的前景就是它自己的强调色或状态色,底色越贴近 paper 前景越可读,故明暗两态都按 1% 减小透明度向 paper 回退,直到前景对软底 ≥4.5:1 或触到 3% 下限——再退就看不出这是一层底色,那不如承认这是最浅的一档。下限处仍不达标(浅底中明度强调色、按压档比软底更深一层)不再动底色,交给下面的状态色族收敛去动文字。4.5:1 是尽力值,落点仍按 §5 的强调字角色(3:1)复核,所以中明度 accent(鼠尾草)的 accentSoft 保持声明的浅底。

曾按明暗分成两个方向(浅色减透明度、深色加透明度)且深色态的比较写反(a > 0.40,从 0.18 起步即恒假),深色态一次都没步进,鼠尾草的按压底停在 4.24:1。方向的分歧来自一个误解:以为深色态要"更浓才看得出来"。深色态的 paper 本就偏暗,把状态色往上叠只会让字与底一起变暗,可读性反而更差。

状态色可读性约束:状态四键既作为徽标/卡片文字落在 paper 上,也作为语义图标落在 surface 上(§5 校验第 3 条)。浅色态 statusDefaults 的 danger/success/warning 对部分配色的 surface 只有 4.3–4.5:1(如靛蓝、陶土),生成器/引擎须以 1% 步进向 ink(浅色态)或白(深色态)收敛,直至对 paper 与 surface 同时 ≥4.5:1。收敛不改变附录 A 的原始取值(色卡与编写层仍显示声明值)。

状态色族(statusFamily):状态色与它的两档软底互为条件——色决定底,底又反过来约束色,所以不能顺序算一次。以不动点迭代求一致解:从收敛后的状态色出发,算软底与按压底,再要求状态色对 paper、软底、按压底三者同时 ≥4.5:1,不足则继续向 ink/白 收敛,直至不变(最多四轮)。曾顺序算完软底就不再复检,鼠尾草浅底的 danger 停在 4.44:1——纸面达标、自家软底差最后一档。

组件专用键覆盖(componentOverrides):个别组件键落在固定底色上(如通知卡为深色卡),简单继承全局 muted 不保证 4.5:1。此类键在附录 A componentOverrides 中声明「键 → 派生键」映射,由引擎以更强的派生值填充;新增组件键时先入表再实现。属性网格选中文字 PgSelectedText 落在 PgSelected(= accent)上,映射到 StudioOnPrimary。

烘焙原则:派生引擎输出的全部是不透明色。控件、导出、对比度校验永远面对确定色值;透明度只是规则的思维语言,不进入消费层。

§4 语义键全集(消费契约)

每个 StudioXxxColor 键都有成对的 StudioXxx Brush(现有惯例,保持)。

表面:StudioBackgroundColor(窗口舞台)、StudioSurfaceColor、StudioPaperColor、StudioRaisedColor、StudioOverlayColor 文字:StudioTextColor、StudioMutedColor、StudioDisabledColor、StudioOnPrimaryColor 品牌交互:StudioPrimaryColor、StudioPrimaryHoverColor、StudioPrimaryPressedColor、StudioPrimaryDisabledColor、StudioAccentColor、StudioAccentSoftColor、StudioSelectedColor、StudioFocusRingColor(= accent)、StudioGradientStartColor、StudioTextGradientEndColor 状态:StudioDangerColor、StudioDangerSoftColor、StudioSuccessColor、StudioSuccessSoftColor、StudioWarningColor、StudioWarningSoftColor、StudioInfoColor、StudioInfoSoftColor 结构线:StudioBorderColor、StudioControlBorderColor 遮罩/选区:StudioScrimColor、StudioSelectionColor

Studio → Semi 覆写映射(Ursa.Themes.Semi 消费 SemiColor*,自动跟随):

Studio 语义 Semi 键
Primary SemiColorPrimary
AccentSoft SemiColorPrimaryLight,其 Pointerover/Active = accent@14% / accent@18%
Paper SemiColorBg
Hover SemiColorFill
Border SemiColorBorder
Text SemiColorText
Danger / Success / Warning / Info SemiColorDanger 等,Soft → *Light,按压态 → *Active(= 状态色族收敛后的实色,与 *Danger 同值;底纹另见 *LightActive = 按压底)

Semi 的 Background0..4、Fill0..2 细分键按需在此表补映射;原则不变:语义键是唯一入口,映射表是唯一桥接处。

§5 Paper 约束与对比度校验

Paper 明度区间(无缝型 Markdown 主题解耦的前提,见 §8):浅色态相对亮度 ≥ 0.90,深色态 ≤ 0.12。

§5.1 画布中性化:paper 与 surface 是大面积画布,派生引擎在派生前把两键转换为等相对明度的中性灰(色度归零,海拔差保留)。色相只保留在 ink、accent、状态色与交互态(selected / hover / accentSoft 等小面积键)。附录 A 中两键的取值作为编写层声明(色卡展示与明度标定),其色温信息由引擎剥离。换界面配色因此只改变强调与交互态,不改变画布——浅色态恒为白系、深色态恒为近黑系。

ruleVersion 6 起生效,同时废止 v5 的"色温偏染 ≤ 5%"表述:该阈值按单色卡色度度量,5% 的色温铺满面板即是可感知的色块,与"近中性"的本意相悖。

校验清单(配色生成/导入时执行,全部给出具体数字报告):

  1. ink↔paper ≥ 10:1;muted↔paper ≥ 4.5:1;
  2. accent 作为文字在 paper / surface 上 ≥ 3:1(非文本角色,判定依据见 §2);accent↔accentSoft ≥ 3:1;onAccent↔accent ≥ 4.5:1;
  3. 状态色四键同上(对 paper 与 surface 同时 ≥ 4.5:1),且状态色族的字色对自家软底、按压底同时 ≥ 4.5:1;
  4. Paper 落在明度区间内(对中性化后的消费值校验)。

v6 内的公式更正(附录 A 常数未变,故不递增 ruleVersion;生成的快照文件头随包版本走): ① 第 2 条的 accent 字色阈值从 4.5:1 改为 3:1,按 §2 的非文本角色判定——此前鼠尾草浅底 3.26:1 会被判失败,而修正方式只能是把品牌色整体压暗一档; ② 软底收敛方向统一为向 paper 退(见 §3"软底收敛"),废止深色态"加透明度变浓"的旧方向; ③ 状态色与两档软底改由 statusFamily 不动点同时求解(见 §3"状态色族")。

失败策略:不阻断保存,但在配色编辑器逐条提示,并给出"最近的可达标取值"建议(如 accent 加深/提亮一档)。

§6 密度三档

显式值表,不用统一乘数(乘数会把图标压糊、让圆角失控,显式表可以单独钉住例外)。三档全部度量键:

键 紧凑 正常 宽松
FontSizeCaption / Body / Subtitle / Title / Display 11/12/14/17/22 12/14/16/20/26 12/15/17/21/28
ControlHeightSm / Md / Lg 24/28/34 28/32/38 32/36/44
PaddingSm / Md / Lg 4/8/12 6/10/14 8/12/18
GapSm / Md / Lg 4/8/12 6/10/16 8/12/20
CornerRadiusSm / Md / Lg 4/6/8 6/8/10 8/10/12
ListRowHeight 26 30 36
IconSize 14 16 18
  • 切换机制:Avalonia 侧三份显式 ResourceDictionary 整树换入换出;原型侧 :root[data-density=…]。
  • 边界:编辑器源码区字号不归此层(归 §11 尺寸档);源码区 chrome(行号、当前行、选区高亮)归此层。圆角跟密度走是刻意的——紧凑时内容受挤压,大圆角会切字。

§7 用户配色 JSON Schema

json
{
  "ruleVersion": 7,
  "key": "user:night-ink",              // 用户配色必须以 user: 前缀
  "name": "夜墨",
  "light": { "paper": "#FDFCF8", "surface": "#F2F1EA", "ink": "#1C1B16", "accent": "#3E5C46" },
  "dark":  { "paper": "#121410", "surface": "#1A1D18", "ink": "#E8EAE2", "accent": "#9DC7A8" },
  "overrides": {                        // 可选逃生门,覆盖任意派生键
    "light": { "border": "#D8D6CC" },
    "dark": {}
  }
}
  • 状态四键缺省取全局默认;可写在 light/dark 里覆盖;
  • overrides 默认为空,规则覆盖 95% 场景,剩余场景(品牌双色等)不破坏模型;
  • 生成器加载后即跑 §5 校验。

第二部分 · Markdown 层

§8 主题模型

编写层组成:accent(强调色)+ decoration(装饰色:标题线、引用条、tint)各浅/深两态 + 排版相对量(§10)+ 装饰偏好(标题装饰形式、引用样式、字体族)+ 纸面块(可选)。

两个主题原型:

原型 纸面 中性阶梯 适用
无缝型 不声明,渲染在控件层 Paper 上,跟随界面配色与明暗 内置默认阶梯(按近白/近黑纸调校) Basic、Simple、InkBlack
成品型 自带 backdrop(背景幕:纯色纸/渐变/纹理/彩底)+ contentSurface(文字真正落在的一面),各声明浅/深两态 携带为自己纸面调校的阶梯 GeekBlack、公众号风格

规则:

  1. 文字对比度永远对 contentSurface 校验(不是 backdrop);
  2. 预览视口的滚动条/选区/焦点环归控件层 chrome;
  3. 导出默认剥离 backdrop(公众号不支持全页背景,导出样式以 contentSurface 为准);主题可显式声明 keepBackdropOnExport(导出独立 HTML 场景)。

内置中性阶梯默认值(无缝型用;成品型可携带覆盖):

键 浅色态 深色态
正文 #30343B #E4E5E7
次要文字 #606770 #AFB4BB
边线 #DDE1E5 #484C53
代码底 #F6F7F8 #292B2F
tint 混色基纸 #FFFFFF #202124

§9 十二套主题清洗方案

定稿名单(现有 18 套精选 + 归并,直接替换,无兼容):

Key 原型 说明
Basic 无缝 默认主题,中性
Simple 无缝 极简,去装饰
InkBlack 无缝 墨黑,衬线气质
GeekBlack 成品 深纸阅读(成品型代表)
OrangeHeart 成品 暖纸橙
RedScarlet 成品 绯红装饰
ColorfulPurple 成品 紫
Yamabuki 成品 山吹黄暖纸
TechnologyBlue 成品 科技蓝(吸收 BlueGlow / FullStackBlue 的长处)
LanQing 成品 兰青清雅
TenderGreen 成品 绿系代表(吸收 Verdant / CuteGreen)
WeChatFormat 成品 公众号导出刚需

替换掉的 6 套(Verdant、CuteGreen、RosePurple、BlueGlow、FullStackBlue、FrontendPeak)不保留。

保留套的逐套改造清单(每套必做三件事):

  1. 对比度校验:accent/decoration 对各自 contentSurface 过 §5 同款阈值;
  2. 暗色侧检查:LightText/DarkText、纸面双态齐全且对比达标;
  3. 相对量化改造:绝对字号改为 §10 比例;成品型补纸面块声明。

§10 排版相对量规范

主题只定义比例,基准由尺寸档(§11)注入;基准一变全页等比缩放。默认比例(主题可覆盖):

元素 比例(× 基准 BodySize)
H1 / H2 / H3 / H4 / H5 / H6 字号 1.90 / 1.55 / 1.30 / 1.15 / 1.05 / 1.00
标题上边距 / 下边距 1.40 / 0.45
段落下边距 0.85
列表项间距 / 嵌套缩进 0.30 / 1.50
引用 padding(纵/横)/ 圆角 0.60 / 1.00 / 0.40
代码块字号 / padding(纵/横) 0.92 / 0.90 / 1.00
表格单元格 padding(纵/横) 0.45 / 0.75
分隔线上下边距 1.20

行高由主题声明(leading,推荐区间 1.5–1.9;标题行高固定 1.3)。字体族三选一:sans / serif / mono(解析沿用 ArticleTypography.ResolveFont)。

§11 尺寸档

档 基准 BodySize
紧凑 13
正常 15
宽松 17
  • 与控件层密度独立,不联动,无"跟随"开关——UI 密度是省空间,阅读字号是阅读偏好,动机会互相干扰;
  • 命名与控件层三档一致(紧凑/正常/宽松),存储与切换各自独立;
  • 预览与源码编辑区同档;
  • 档位只提供基准,段距/标题/引用等全部经 §10 比例自动等比,无额外间距键。

§12 导出约定

  • 导出 CSS(ExportCss / CompactExportCss)由主题参数生成,独立于运行时一切设置(UI 密度、尺寸档、明暗);
  • 导出基准字号固定 15(主题可用 exportBase 覆盖);
  • backdrop 默认剥离;主题声明 keepBackdropOnExport 时保留。

第三部分 · 共享

§13 用户自定义机制

注册表模式(照 MarkdownTypographyThemeRegistry 先例):配色与主题都是字符串 Key 注册表,运行时可注册。

增删改规则:内置只读;可"复制为我的配色/主题"(basedOn 或全量导出后编辑);用户项可增删改;删除即物理删除(自用为主,无 hidden 兼容负担)。

Markdown 主题 JSON Schema(示例):

json
{
  "ruleVersion": 5,
  "key": "user:misty-jade",
  "name": "雾玉",
  "basedOn": "LanQing",
  "accent":     { "light": "#2C7A7B", "dark": "#7FD1CC" },
  "decoration": { "light": "#B7791F", "dark": "#F6C667" },
  "paper": {
    "light": { "backdrop": "#F4F7F5", "contentSurface": "#FFFFFF" },
    "dark":  { "backdrop": "#14171A", "contentSurface": "#1B1F23" }
  },
  "typography": { "leading": 1.75, "font": "serif", "headings": { "h2Decor": "leftBar" } },
  "keepBackdropOnExport": false
}

不声明 paper 即无缝型。加载数据后反序列化为 ArticleTypography 同构 record,CreateResources() 注册,导出 CSS(含紧凑版)由模型生成。

§14 快照与版本化

  • palette-tokens.css(两个库原型)与 Vex 的 palettes.css 均由生成器从附录 A 产出,带版本戳 = 包版本(如 12.1.4.x),文件头注明上游版本;
  • 禁止手写快照(Toolkit 原型的快照已发生过漂移,此规则即为止血);
  • 各仓快照独立携带、构建时不跨仓读取;上游升版后重新生成并提交。

§15 装饰语言基线

组件样式改造时的对照原则(只定原则,不逐控件展开):

  1. 海拔分层,边框退位:层级用表面色阶差 + 极淡阴影表达;1px 边框只留给输入控件与分隔线;
  2. 圆角体系:6 / 8 / 12(小控件 / 卡片 / 浮层),随密度档缩放(§6);
  3. 字重:400 / 550 / 650 三档,标题靠字号与行高立层级,不用 700 加粗;
  4. 强调色唯一律:同一界面只有 accent 一个高饱和来源,其余中性化;
  5. 渐变唯一:标题/品牌位一处(gradientStart → gradientEnd);
  6. 阴影极轻:浮层阴影透明度 ≤ 16%,窗口阴影两层结构。

附录 A · 常数与数据

本代码块是机器可读事实源。C# 引擎与原型生成器直接解析本块(或到实现阶段抽取为独立文件),不另行抄写。

json
{
  "ruleVersion": 7,
  "statusDefaults": {
    "light": { "danger": "#DC2626", "success": "#15803D", "warning": "#B45309", "info": "#4338CA" },
    "dark":  { "danger": "#F87171", "success": "#4ADE80", "warning": "#FBBF24", "info": "#A5B4FC" }
  },
  "derivation": {
    "light": {
      "muted": "ink@64%", "disabledText": "ink@40%", "disabledBg": "ink@6%",
      "accentInk": "mix(ink->accent,40%)", "fieldBorder": "mix(paper->ink,55%)",
      "border": "ink@12%", "controlBorder": "ink@20%",
      "hover": "ink@5%", "raised": "ink@4%",
      "selected": "accent@12%", "accentSoft": "accent@10%", "selection": "accent@24%",
      "statusSoft": "status@12%", "scrim": "black@40%",
      "primaryHover": "mix(accent->paper,8%)", "primaryPressed": "mix(accent->ink,10%)",
      "gradientEnd": "mix(accent->white,25%)"
    },
    "dark": {
      "muted": "ink@64%", "disabledText": "ink@40%", "disabledBg": "ink@6%",
      "accentInk": "mix(ink->accent,40%)", "fieldBorder": "mix(paper->ink,55%)",
      "border": "ink@16%", "controlBorder": "ink@26%",
      "hover": "ink@7%", "raised": "ink@6%",
      "selected": "accent@18%", "accentSoft": "accent@16%", "selection": "accent@30%",
      "statusSoft": "status@18%", "scrim": "black@60%",
      "primaryHover": "mix(accent->white,8%)", "primaryPressed": "mix(accent->black,12%)",
      "gradientEnd": "mix(accent->paper,20%)"
    }
  },
  "density": {
    "compact": { "fontSize": [11,12,14,17,22], "controlHeight": [24,28,34], "padding": [4,8,12], "gap": [4,8,12], "cornerRadius": [4,6,8], "listRowHeight": 26, "iconSize": 14 },
    "normal":  { "fontSize": [12,14,16,20,26], "controlHeight": [28,32,38], "padding": [6,10,14], "gap": [6,10,16], "cornerRadius": [6,8,10], "listRowHeight": 30, "iconSize": 16 },
    "relaxed": { "fontSize": [12,15,17,21,28], "controlHeight": [32,36,44], "padding": [8,12,18], "gap": [8,12,20], "cornerRadius": [8,10,12], "listRowHeight": 36, "iconSize": 18 }
  },
  "markdownSizeTiers": { "compact": 13, "normal": 15, "relaxed": 17 },
  "componentOverrides": {
    "CodeWFLogDesktopNotificationMutedForeground": "notificationMuted",
    "PgSelectedText": "StudioOnPrimary"
  },
  "derivedComponentKeys": {
    "notificationMuted": "ink@85%"
  },
  "markdownNeutralLadder": {
    "light": { "text": "#30343B", "muted": "#606770", "border": "#DDE1E5", "codeBg": "#F6F7F8", "tintPaper": "#FFFFFF" },
    "dark":  { "text": "#E4E5E7", "muted": "#AFB4BB", "border": "#484C53", "codeBg": "#292B2F", "tintPaper": "#202124" }
  },
  "palettes": {
    "graphite":    { "label": "石墨", "en": "Graphite", "note": "无彩色 · 明度对比", "recommended": true,
                     "light": { "paper": "#FFFFFF", "surface": "#F4F4F5", "ink": "#18181B", "accent": "#3F3F46" },
                     "dark":  { "paper": "#101012", "surface": "#1C1C1F", "ink": "#F4F4F5", "accent": "#D4D4D8" } },
    "indigo":      { "label": "靛蓝", "en": "Indigo", "note": "经典蓝 · 日常默认", "recommended": true,
                     "light": { "paper": "#FDFDFE", "surface": "#F2F2F5", "ink": "#1B1D2E", "accent": "#4338CA" },
                     "dark":  { "paper": "#12131F", "surface": "#1B1C24", "ink": "#E6E7F2", "accent": "#A5B4FC" } },
    "teal":        { "label": "鼠尾草", "en": "Sage", "note": "暖白鼠尾草 · 温润写作", "recommended": true,
                     "light": { "paper": "#F5F5F1", "surface": "#F1F4EF", "ink": "#303B35", "accent": "#6F8F7D" },
                     "dark":  { "paper": "#1A1F1D", "surface": "#1E2422", "ink": "#D4DDD7", "accent": "#A2BEAD" } },
    "pine":        { "label": "松绿", "en": "Pine", "note": "松绿 · 沉稳专注", "recommended": true,
                     "light": { "paper": "#FBFDF9", "surface": "#F0F6EF", "ink": "#16241A", "accent": "#166534" },
                     "dark":  { "paper": "#0F1511", "surface": "#17211B", "ink": "#E2EFE6", "accent": "#86EFAC" } },
    "sky":         { "label": "天青", "en": "Sky", "note": "天青 · 清朗开阔", "recommended": false,
                     "light": { "paper": "#FBFDFF", "surface": "#EDF4FA", "ink": "#0F2233", "accent": "#0369A1" },
                     "dark":  { "paper": "#0D1420", "surface": "#16202E", "ink": "#DDEBF7", "accent": "#7DD3FC" } },
    "amber":       { "label": "琥珀", "en": "Amber", "note": "暖金 · 长时阅读", "recommended": false,
                     "light": { "paper": "#FEFDF9", "surface": "#F8F3E8", "ink": "#241E10", "accent": "#B45309" },
                     "dark":  { "paper": "#171310", "surface": "#221C15", "ink": "#F3EDDF", "accent": "#FCD34D" } },
    "crimson":     { "label": "绯红", "en": "Crimson", "note": "绯红 · 鲜明活力", "recommended": false,
                     "light": { "paper": "#FEFCFC", "surface": "#F6F1F0", "ink": "#2A1517", "accent": "#BE123C" },
                     "dark":  { "paper": "#170F11", "surface": "#211A1C", "ink": "#F6E7E9", "accent": "#FDA4AF" } },
    "violet":      { "label": "紫晶", "en": "Violet", "note": "紫晶 · 创意整理", "recommended": false,
                     "light": { "paper": "#FDFCFE", "surface": "#F3F1F5", "ink": "#1F1729", "accent": "#6D28D9" },
                     "dark":  { "paper": "#131019", "surface": "#1C1A24", "ink": "#ECE7F5", "accent": "#C4B5FD" } },
    "terracotta":  { "label": "陶土", "en": "Terracotta", "note": "暖陶 · 灵感手记", "recommended": false,
                     "light": { "paper": "#FEFCFA", "surface": "#F8F0E9", "ink": "#2B1E14", "accent": "#C2410C" },
                     "dark":  { "paper": "#171210", "surface": "#231A15", "ink": "#F4EAE2", "accent": "#FDBA74" } }
  },
  "default": "teal"
}

九套配色的取值为初值,标定阶段以视觉评估微调;调整即改本块并递增 ruleVersion。