复用成熟 App 的主题配色:从原生模块到可复用数据(2):从基础色推导界面配色
- 从安装资源提取主题配置
- 从基础色推导界面配色(当前)
- 在 App 与 Figma 中复用配色
同一个基础色要生成主色、背景、文字和气泡,还要分别安排浅色与深色模式。QQ 9.9.36-53644 的四类模板使用 HCT 生成根色和色阶,再将它们映射到界面角色。这里的规则来自该版本的解析结果,HCT 只是求色工具,QQ 选择的常量与角色映射属于这套主题实现。
从一个基础色生成模板配色
在 QQ 安装目录的原生模块 wrapper.node 中追踪 GetTokenMapFromThemeInfo 的字符串引用,能找到模板派生函数和 Token 解析分支。派生函数先取得主色,转换成 HCT,再按模板编号选择规则;生成的根色和色阶最后由 colorful_theme 绑定到界面角色。
基础色先转换成 HCT
一套界面配色要分别控制颜色的倾向、鲜艳程度和明暗层级。RGB 的三个通道适合保存和显示颜色,但「把绿色通道减一点」很难直接表达「保留紫色倾向,让背景更浅、更柔和」这样的设计要求。
HSL 把颜色改写成色相、饱和度和亮度,也还没有解决感知明度的问题。例如下面两个纯色,HSL 的 L 都是 50%,转换成 CIE L* 后却差得很远。数值由配套的颜色模块计算:
| 颜色 | HEX | HSL | CIE L* / HCT T |
|---|---|---|---|
| 纯蓝 | #0000FF |
240° / 100% / 50% |
32.303 |
| 纯黄 | #FFFF00 |
60° / 100% / 50% |
97.138 |
如果用同一组 HSL 亮度直接生成蓝色、黄色主题,组件的明暗层级会随着色相改变。HCT 将色相 H、彩度 C 与感知明度 T 分开处理,方便用相同的明度规则生成不同主题。H、C 来自 CAM16 色貌模型,T 使用 CIE L*;H 是 0–360° 的角度,T 从 0 的黑到 100 的白,C 表示颜色偏离中性色的程度,它的可用上限随 H、T 改变。HCT 的实现与定义说明了这三个量的组合方式。
RGB 到感知明度之间还隔着一次线性化。HEX 里的 sRGB 通道经过非线性编码,字节值 128 并不代表白色一半的光强。把一个通道除以 255 得到 u,先按 sRGB 传递函数还原为线性通道值,再计算相对亮度 Y。以 0–1 为取值范围,公式是:
linear(u) = u / 12.92 当 u ≤ 0.04045
= ((u + 0.055) / 1.055) ^ 2.4 其他情况
Y = 0.2126 × Rlinear + 0.7152 × Glinear + 0.0722 × Blinear
绿色与蓝色对 Y 的权重不同,因此三个通道的数值平均不能表示明度。sRGB 的解码方式见 CSS Color 4 的颜色转换定义。T 再由 Y 计算成 CIE L*,使用分段函数近似感知明度:
T = (24389 / 27) × Y 当 Y ≤ 216 / 24389
= 116 × Y^(1/3) − 16 其他情况
H、C 则使用 RGB 转成的 XYZ 三刺激值继续计算。XYZ 是颜色测量的一种表示,Y 就是其中的亮度分量。CAM16 再根据参考白、背景和适应亮度等观察条件处理这些量,得到色相与彩度。CAM16 的实现包含这条转换链。本次复现使用库的默认观察条件,没有根据真实屏幕亮度或 QQ 窗口背景动态调整它们。
记基础色转换结果为 (h, c, t),QQ 的主题规则先定义两个明度范围:
const low = Math.max(10, Math.min(70, t));
const high = Math.max(70, Math.min(95, t));
const F = (h, c, t) => Hct.from(h, c, t).toInt();
例如种子明度是 30,low 为 30,high 为 70;种子明度是 90,low 为 70,high 为 90。它们把任意输入约束到两个范围,供不同界面角色选择。具体上限、下限属于 QQ 的主题规则,HCT 本身不会自动规定这些数值。
HCT 转回 RGB 时怎样处理色域
F 返回可显示的不透明 ARGB。它要同时寻找接近目标 H、C、T 的 sRGB 颜色,但屏幕能表示的 RGB 组合有限。
色域是一个颜色空间能够表示的颜色范围。同一个色相在不同明度下,可达到的最大彩度不同;接近白色或黑色时,许多鲜艳颜色无法同时满足指定的明度。
配套模块的 Hct.from() 会调用 HctSolver.solveToInt()。对普通有彩色目标,求解器先把 T 还原为目标 Y,再固定 H、C,迭代调整 CAM16 的明度参数 J,让反算的 RGB 具有目标 Y。J 与 HCT 的 T 是不同的量,因此这一步需要求解。本次附带版本使用近似牛顿迭代,最多进行 5 轮。
如果找不到范围合法的 RGB,求解器沿固定 Y 的平面与 RGB 色域边界的交线二分,寻找接近目标色相的可显示颜色。最后进行 sRGB 编码和 8 位量化。靠近黑、白或彩度接近零的输入有单独的灰阶分支。这些路径可以对照 HCT 求解器的实现。
以「香芋啵啵」的色相 304.365°、目标彩度 57.019 为例,只改变目标 T,求解器的实际结果如下:
| 目标 T | 求解后的 HEX | 实际 H | 实际 C | 实际 T |
|---|---|---|---|---|
| 20 | #400E81 |
304.011° | 57.102 | 20.000 |
| 50 | #8A61CD |
304.309° | 57.146 | 49.930 |
| 80 | #D5BAFF |
304.338° | 37.882 | 79.888 |
| 95 | #F7EDFF |
303.553° | 11.670 | 94.976 |
目标 T 为 80、95 时,实际彩度分别降到了 37.882、11.670,才能留在 sRGB 色域中;色相和明度也会有量化误差。因此根色规则里的三元组表示目标参数,读者拿最终 HEX 反算 HCT 时,不应要求三个参数逐字相等。派生时每个目标都从同一份原始 (h, c, t) 独立求解,避免把上一层已经降低的彩度继续传给下一层。
颜色与数值使用正文已有求解样本。虚线是目标彩度,柱形是最终颜色反算的实际彩度,不表示求解迭代过程。
三条色阶
| 系列 | 编号 | 主色阶彩度 cp |
|---|---|---|
| 缤纷时刻 | 1001 | max(c, 50) |
| 幻彩机核 | 1002 | c |
| 水墨国风 | 1003 | min(c, 30) |
| 神秘美学 | 1004 | c |
三条色阶都保持基础色色相 h:primary 使用 cp,secondary 使用 cp/3,neutral 使用 cp/6。primary_root、secondary_root、neutral_root 的明度都是 low;其余明度取固定列表:
100, 99, 98, 95, 90, 80, 70, 60, 50, 40, 35, 30, 25, 20, 15, 10, 5, 0
例如 secondary_95 = F(h, cp / 3, 95)。这三条色阶各包含 19 个颜色,并不等于 Material 的标准 CorePalette / Scheme。复用实现只调用 HCT 求解器,不套用标准主题角色和新版 TonalPalette 的额外调整。
降低 secondary、neutral 的彩度,会让辅助文字、边框和表面色保留一点主题色倾向,同时减弱鲜艳程度。再按角色选不同明度,就能用同一种色相形成清楚的层级。这是这组公式的效果;cp/3、cp/6 和固定明度列表是 QQ 的具体选择,其他产品可以采用不同的比例与层级。
四个系列的根色规则
下表每个三元组表示 F 的参数。s 只用于缤纷时刻:基础色色相 h 在 150°–330°(含端点)时为 +1,其他情况为 −1;偏移方向由基础色判断一次。
| 根色 | 缤纷时刻 1001 | 幻彩机核 1002 | 水墨国风 1003 | 神秘美学 1004 |
|---|---|---|---|---|
| root_a | (h, cp, 60) |
(h, c, low) |
(h, cp, low) |
(h, 60, 80) |
| root_b | (h, cp, 50) |
(h, c, high) |
(h, cp, high) |
(h, 50, 50) |
| root_c | (h, cp, 60) |
(h, c, high) |
(h, cp, low) |
(h, 60, 90) |
| root_d | (h+s×45, cp+20, 60) |
(h, c, high) |
(h, cp, low) |
(h−30, 60, 90) |
| root_e | (h, cp, 80) |
(h+210, c+10, 55) |
(h, 2×cp/3, 80) |
(h+30, 60, 90) |
| root_f | (h+s×60, cp, 80) |
(h+160, c, 50) |
(h, cp/3, 90) |
(h+30, 60, 80) |
| root_g | (h+s×120, cp, 80) |
(h+120, c+10, 40) |
(h, 2×cp/3, 80) |
(h−120, 60, 90) |
| root_h | 未生成 | 未生成 | (h, cp/3, 90) |
固定 #FFFFFF |
| root_i | (h, cp, 40) |
(h, c, high) |
(h, cp, high) |
(h, 50, 60) |
| root_j | (h+s×45, cp+20, 40) |
(h, c, high) |
(h, cp, high) |
(h−30, 50, 60) |
| root_k | (h, cp, 60),Alpha=204 |
同 root_e | (h, 2×cp/3, 40) |
(h+30, 50, 50),Alpha=127 |
| root_l | (h+s×60, cp, 60),Alpha=204 |
同 root_f | (h, cp/3, 50) |
(h+30, 50, 50),Alpha=165 |
| root_m | (h+s×120, cp, 60),Alpha=204 |
同 root_g | (h, 2×cp/3, 40) |
(h−120, 50, 50),Alpha=127 |
| root_n | 未生成 | 未生成 | (h, cp/3, 50) |
固定 #323232 |
未标 Alpha 的根色完全不透明。204/255 是 80% 不透明度;127/255 约 49.8039%,165/255 约 64.7059%。保留字节原值可以避免把 7F 或 A5 误写成四舍五入后的透明度。
把根色和色阶绑定到界面角色
原始 colorful_theme 保存了 91 个 Token 的浅色/深色绑定。先把字符串引用查成颜色,整数值保持不变。例如:
| Token | 浅色引用 | 深色引用 |
|---|---|---|
| brand_standard | primary_root | root_b |
| text_primary | secondary_10 | secondary_90 |
| bg_aio_1 / 2 / 3 / 4 | root_e / f / g / h | root_k / l / m / n |
| bubble_host_1 / 2 | root_c / d | root_i / j |
on_brand* 和 on_bubble* 是额外分支:它们表示主色或气泡上的前景色,按背景明度选择原始绑定的第一项(偏深)或第二项(偏浅)。
| 前景角色 | 浅色模式选择第一项的条件 | 深色模式选择第一项的条件 |
|---|---|---|
| on_brand* | 基础色 t > 60 |
基础色 t > 60 |
| on_bubble*,缤纷时刻 | 恒为真 | 恒为假 |
| on_bubble*,幻彩机核 | high > 60 |
high > 60 |
| on_bubble*,水墨国风 | low > 60 |
high > 60 |
| on_bubble*,神秘美学 | 恒为真 | 恒为真 |
严格大于 60,等于 60 时选第二项。缤纷时刻与幻彩机核缺少 root_h / root_n,原生 Token 解析函数遇到 bg_aio_4 的缺失引用会跳过整个 Token。复用实现把它保存在 unresolvedTokens;每套这两个系列的预设得到 90 个 Token,其余两个系列得到 91 个。没有补造第四个聊天背景色,也没有推断界面最终使用的回退色。
这里只选取三个界面角色。root 与色阶都从原始种子参数独立求解,避免沿用上一次求解后已经降低的彩度。
用一个主题串起整条计算链
「香芋啵啵」的种子 #B389F8 转成 HCT,得到 h ≈ 304.365°、c ≈ 57.019、t ≈ 65.162。它属于缤纷时刻,所以 cp = max(c, 50) ≈ 57.019,low 为 65.162,high 为 70;h 落在 150°–330° 内,色相偏移方向 s 为 +1。
三条色阶使用相同的 h,目标彩度分别是 57.019、19.006、9.503。根色按缤纷时刻的规则另行生成,再与色阶一起交给 Token 映射:
| 界面角色 | 浅色模式的计算路径 | 浅色色值 | 深色模式的计算路径 | 深色色值 |
|---|---|---|---|---|
| 主色 | primary_root = F(h, cp, low) |
#B389F8 |
root_b = F(h, cp, 50) |
#8A61CD |
| 我的气泡 1 | root_c = F(h, cp, 60) |
#A57BE9 |
root_i = F(h, cp, 40) |
#7047B2 |
| 我的气泡 2 | root_d = F(h+45, cp+20, 60) |
#EF55B3 |
root_j = F(h+45, cp+20, 40) |
#AF197E |
| 聊天背景 1 | root_e = F(h, cp, 80) |
#D5BAFF |
root_k = F(h, cp, 60),Alpha=204 |
#A57BE9CC |
| 主要文字 | secondary_10 = F(h, cp/3, 10) |
#20172E |
secondary_90 = F(h, cp/3, 90) |
#EBDDFC |
同一个主题的主色和气泡色也会不同,因为它们采用不同的明度目标;深色模式又重新选择一组角色颜色。知道角色的用途后,才知道该从色阶中取哪一层。primary_50 这样的名字描述颜色来源,brand_standard、text_primary 这样的名字描述界面用途,二者通过映射连接起来。
派生结果怎样核对
JavaScript 实现与原生仿真的 100 组输入、7000 个派生色和 18100 个 Token 色值逐项整数相等。原生颜色函数的仿真与验证样本弹窗保留输入、模拟与检查范围,完整实现见配色派生模块的完整源码弹窗。验证覆盖颜色函数和选择分支,纹理、渐变位置与最终界面合成仍需单独判断。
配色派生模块的完整源码
原生颜色函数的仿真与验证样本
打开原文件 native-color-fixtures.json
验证依据
安装模块 SHA-256 为 0d8b94448f4dafe7337b88d6a568b004224c37fcbe2bd1142c1af7624fbd534c。原生模板派生函数 RVA 是 0x581976,Token 解析函数是 0x57E7BA,明度列表生成函数是 0x577D2F,HCT 转换入口分别是 0x63E1F4 和 0x63E064。
使用 Unicorn 对该模块的 x86-64 指令做隔离仿真:输入查找、C++ 容器和字符串读写用适配函数替代,pow / fmod 使用标准数学函数,栈保护检查跳过;颜色运算、模板分支和 Token 选择分支执行原始指令,没有启动 QQ 或改动安装文件。
验证输入包括 20 个预设,以及黑、白、灰、RGB 纯色、额外基础色和 12 个固定随机色在四种模板中的结果,共 100 组。JavaScript 实现与原生仿真的 7000 个派生色、18100 个 Token 色值逐项整数相等。对照样本、模块哈希与函数入口保存在配套数据中。这个核对证明的是这些颜色函数和分支的输出,不包含纹理、渐变布局或 QQ 最终界面合成。