Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。
Cindy 登录新设计 token 决策表
范围:仅为登录 / 浏览器跳转 / 回调页设计稿(逐屏规格见设计阶段工作文件
DESIGN-login,不入仓库)中出现的色值与关键尺寸做 token 决策。本文不改源码。本表自 2026-07-24 起随docs/design-rules/入仓维护(原docs/login-redesign/路径已随开源清理移除)。⚠ 角色定位(2026-07-24):本表是实现前的决策记录 + 后续增补台账,其「现有体系盘点」「建议新增 N 个」「示例代码」反映的是各 wave 决策时点的状态,登录 token 体系落码后未逐段回写——现行 token 清单、命名与双态值以
DESIGN.md §16.1和apps/desktop/src/renderer/themes/colors.ts为准(例:原案名login-brand-bg落码时已改名login-brand-accent;旧登录页 9 个login-*alias 已随换肤退役)。查「某个值该不该新 token / 复用谁」的判定理由用本表;查「现在到底有哪些 token、值是多少」不要用本表。已读取现有体系:
DESIGN.md第 2 节 / 第 10 节、apps/desktop/src/renderer/themes/colors.ts、apps/desktop/src/renderer/themes/registry.ts、apps/mobile/src/theme/tokens.ts、apps/mobile/src/theme/index.ts、apps/mobile/src/theme/ThemeProvider.tsx。⚠ wave4 改判(2026-07-20,PR0-docs 回写):登录流程全端从品牌红全屏底改为白底体系。本表内
#DF0C27及同族红底背景 token 的语义改判为 accent 专用(Global pill、字标红元素等品牌点缀),禁止表达页面/画板背景——token 命名与注释不得含 background/背景 语义(此判仍现行,落码 token 名为login-brand-accent,原案名login-brand-bg已弃用)。〔wave4 段历史部分作废(2026-07-24 目录整编标注)〕:本段原钉死的画布落码方案——页面底消费
var(--surface)、两层#F70121渐变代码复现、--login-window-border-outer/-innertoken——已被后续实现与实机走查推翻。现行结论:画布底走--login-bg-base双态(亮#F2F2ED/ 暗#181818,2026-10-01 起与 CINDY 皮肤页底同值;此前为#EDEDED/#1F1F1E),两模式纯平,--login-bg-gradient-radial/-linear仅保留 override 锚、值恒none,window-border token 已删除。现行权威 =DESIGN.md §16.1 / §16.5与apps/desktop/src/renderer/themes/colors.ts;本段与本表任何段落均不再对冲突拥有优先级,冲突一律以DESIGN.md §16为准。⚠ wave5 增补(2026-07-24,组件库更新,权威 =
DESIGN.md §16.5状态矩阵;原figma-component-spec §11已于 2026-10-23 移除,其现行内容已迁入该矩阵,追史见提交70b32d7578):(a) hover 统一「叠白变亮」口径——全按钮族 hover = normal 底叠rgba(255,255,255,0.08/0.1)(深底 8% / 浅底 10%;唯一例外back亮色 hover 维持既有白 70%),旧「白底钮 hover 叠黑」方向作废;pressed 叠黑分档含例外:深底强调钮 50%(log_in_button、light_button_highlight,不论尺寸)/Dark_button_Normal20% / 浅底钮 10% / 行类 8%——落码逐组件对拍DESIGN.md §16.5状态矩阵,不按类别名推断;hover / pressed 叠层统一由--login-overlay-*二态 token 组承载(DESIGN.md §16.5已采纳),禁止新增字面 rgba 叠层;〔落码状态〕本口径当前仅文档层生效,as-built 组件仍消费改判前旧叠层值,同步随暗色实现 PR 的 overlay token 化落地(DESIGN.md §16.5(1))。(b) 新组件 radiobutton(协议勾选)与双色模式小按钮(服务条款弹窗)带来的新色值决策已补入 §3 表尾;对应 token 建议随游客登录 / 协议 UI 实现 PR 注册,不提前占位。
1. 现有主题体系结论〔2026-07 决策时点快照,现状以 colors.ts 为准〕
- 桌面端颜色通过
ColorRegistry.registerColor(id, { light, dark }, description)注册,组件消费 CSS variable--<id>。colors.ts分为 semantic slot、component alias、singleton 三层。 DESIGN.md第 10 节明确:组件里不能硬编码 hex / rgba;能用 slot 就用 slot,找不到语义时新增 slot / alias / singleton;HSL token 必须以hsl(var(--xxx))消费,不能直接var(--xxx)。- 现有登录 token 只有旧登录页 alias:
login-bg、login-card-bg、login-card-border、login-divider、login-btn-bg、login-btn-text、login-btn-hover、login-help-text、login-error-text。它们无法完整表达新设计的品牌红背景、固定白面板、输入状态、暗色回调卡片、反相按钮。 - 内置主题实际注册见
registry.ts:default-light、atom-one-light、solarized-light、cindy-light、default-dark、eclipse、one-dark-pro、github-dark、monokai-pro、material-ocean-hc、cindy-dark。新登录 UI 是品牌入口,建议大多数新增 login alias 在所有主题保持设计稿值,不随编辑器主题染色。 - 移动端
ThemeColors是固定 key 集合,颜色字符串以 hex / rgba 暴露;spacing 为4/8/12/16/24/32,radius 为4/8/12/9999,typeScale 最大hero=40。新登录稿的36/40/50/60圆角、80/100/440/680尺寸不在现有阶梯中,不能用通用 spacing/radius 假装适配。
2. 新增 token 摘要〔决策时点提案,落码后的实际清单以 DESIGN.md §16.1 + colors.ts 为准〕
建议新增 47 个 token / constants:
- 颜色 23 个:
login-brand-bg、login-brand-bg-pressed、login-panel-bg、login-panel-border、login-control-bg、login-control-border、login-control-border-active、login-control-border-disabled、login-control-text、login-control-placeholder、login-title-text、login-secondary-text、login-primary-button-bg、login-primary-button-border、login-primary-button-text、login-inverted-button-bg、login-inverted-button-border、login-inverted-button-text、login-disabled-button-overlay、login-result-page-bg、login-global-badge-bg、login-link-text、login-link-hover。 - 尺寸 25 个:
login-stage-width、login-stage-height、login-desktop-hero-size、login-wordmark-frame-width、login-wordmark-frame-height、login-slogan-width、login-slogan-height、login-panel-width、login-panel-height、login-flow-height、login-panel-radius、login-control-width、login-control-height、login-control-radius、login-social-size、login-social-gap、login-back-size、login-code-link-height、login-method-row-height、login-method-row-radius、login-result-card-size、login-result-visual-size、login-mobile-width、login-mobile-tall-height、login-mobile-short-height。
不建议新增通用 semantic slot。原因:这些值服务 Cindy 品牌登录入口和浏览器回调页,不应把 #df0c27、#fbfbfb、36px 圆角提升成全应用通用语言。颜色走 component alias;尺寸走 login component singleton constants。
3. 色值决策表
| Figma 值 | 出现场景 | 决策 | token / 类型 | 默认值建议 | 非默认主题 override 评估 |
|---|---|---|---|---|---|
#df0c27 |
新增(语义改判为 accent 专用) | login-brand-bg / component alias〔wave4 改判:命名/注释禁止 background 语义,PR0a 注册时按 accent 语义定名〕 |
light/dark 均 #df0c27;HSL 352.3 89.8% 46.1% 仅在需要 hsl() 时注册 companion |
全主题保持;这是 Cindy 品牌登录,不随代码编辑器主题变化 | |
#a61629 |
Color System 品牌深红;可作为 pressed/hover | 新增 | login-brand-bg-pressed / component alias |
light/dark 均 #a61629;HSL 352.1 76.6% 36.9% |
全主题保持;若当前稿没有 hover 节点,可先注册但只在 press/hover 需要时使用 |
#fbfbfb |
登录白面板、回调 White 卡片 | 新增 | login-panel-bg / component alias |
light #fbfbfb;dark 回调语义用 #312f2f,不要用此 token 的 dark 值承载两套模式时可拆 mode |
非默认主题不 override;100% 还原设计稿 |
#312f2f |
回调 Dark 卡片 | 新增到同一 token dark 值或单独 mode map | login-panel-bg dark / component alias |
dark #312f2f;HSL 0 2.1% 18.8% |
只在回调 dark / dark preview 生效;非默认主题保持 |
#d4d4d4 |
输入边框、placeholder、主按钮文字、回调 White 边框、Dark 标题 | 新增别名分语义,不共用一个 token | login-control-border、login-control-placeholder、login-primary-button-text、login-panel-border |
均可解析到 #d4d4d4,HSL 0 0% 83.1% |
不建议复用 text-primary dark 或旧 border,避免 light 主题被换成 #d7d7d4 |
#eeeeee |
输入背景、返回按钮背景、Dark 回调 CTA、移动 White 页面内容底 | 新增别名分语义 | login-control-bg、login-inverted-button-bg、login-result-page-bg light |
#eeeeee,HSL 0 0% 93.3% |
全主题保持;不是通用 surface-chip,CINDY light 主题的 chip 是 #f4f4f4 |
#2a2828 |
主按钮 / 社交按钮背景、active 边框、Dark 回调页面底、Dark CTA 文本 | 新增别名分语义 | login-primary-button-bg、login-control-border-active、login-inverted-button-text、login-result-page-bg dark、login-link-text |
#2a2828,HSL 0 2.4% 16.1% |
全主题保持;CINDY dark surface 同值但语义不同 |
#434343 |
主按钮 / 社交按钮边框、Dark 回调卡片边框 | 新增 | login-primary-button-border、login-panel-border dark |
#434343,HSL 0 0% 26.3% |
全主题保持;可由 CINDY dark border-default 提供但 login alias 更稳 |
#252222 |
标题、输入已填文本 | 新增 | login-title-text、login-control-text |
#252222,HSL 0 4.2% 13.9% |
全主题保持;不复用 text-primary,因为 default light 是 #262626、CINDY light 是 #3c3f43 |
#6f6f6f |
副标题、回调正文、「跳过登录」文字按钮(2026-07-27 新增消费点) | 新增 | login-secondary-text |
#6f6f6f,HSL 0 0% 43.5%;light / dark 同值 |
〔2026-10-23 改判:Desktop 改为墨水次要档 黑 56% / 白 55%,与主界面 text-secondary 同值,见 DESIGN.md §16.1;Mobile 暂保留 #6f6f6f〕。「跳过登录」文字按钮走本 token、不走 login-link-* 族(文字按钮 ≠ 文字链接:不做 hover / pressed 变色),故本次改版零新增颜色 token |
#ffffff |
Global 文字、返回按钮边框、Dark 回调按钮边框、状态栏变量 | 语义豁免或 alias | login-inverted-button-border;Global text 可用 login-inverted-button-border 或 dedicated constant |
#ffffff,HSL 0 0% 100% |
白色在这些场景是设计稿固定高对比值;不走 surface-elevated,避免主题污染 |
#d91f37 |
错误原因文字 | 复用现有名并改默认 / override | login-error-text / existing component alias |
建议把旧 login-error-text 从 error-flat(#ef4444) 调整为 #d91f37,HSL 352.3 75% 48.6% |
全主题保持;错误色是登录设计稿专用,不应和通用 destructive 混同 |
#b4b4b4 |
disabled 按钮边框 | 新增 | login-control-border-disabled / component alias |
#b4b4b4,HSL 0 0% 70.6% |
全主题保持 |
#4a4848 |
Text_link hover(仅桌面) | 新增 | login-link-hover / component alias |
#4a4848,light/dark 同值 |
全主题保持(豁免族);来源 figma §4.7 wave3 实测 358:792;〔lead 裁决 2026-07-20:决策表快照(2026-07-19)滞后于 wave3 追加,属表滞后修订非表外发明,与 U-9 pressed 同族同性质〕 |
rgba(255,255,255,0.7) |
disabled 按钮叠层(2026-10-27 随禁用态改写退役,ID 保留、组件不再消费) | 新增 | login-disabled-button-overlay / component alias singleton |
light/dark 均 rgba(255,255,255,0.7) |
全主题保持;不要硬写在组件里 |
#c5c5c5 |
Figma canvas / 工作区灰底 | 语义豁免,不进产品 UI | 无 | 无 | 不进实现 |
#fefefe / #f1f2f3 |
浏览器 shell 顶部模拟控件 | 语义豁免或资源内色 | 无或 login-browser-chrome-* 后续再加 |
当前仅浏览器 mock shell,生产系统浏览器不可控 | 不需要 app token |
#ededed, #f8f8f8, #dcdfe3, #3c3f43, #9a9da3, #bfc1c4, #d8d9db, #504f4f, #3b3a3a |
CINDY Light / Dark 主题基础色,不是登录帧直接结构色 | 复用现有 Cindy theme overrides | semantic slots:surface、surface-elevated、border-default、text-primary、text-secondary、text-tertiary、text-disabled |
已在 cindy-light.ts / cindy-dark.ts 作为主题色出现 |
非登录组件继续按主题体系消费;登录不要直接拿这些替代设计稿登录 alias |
#f1f0f1 |
radiobutton 浅色圈底 / 暗模式选中底(wave5,600:626/602:1093);亦为 wave4 帧底色 |
新增(随协议 UI 实现 PR 注册) | 建议 login-radio-bg / component alias(light #f1f0f1,dark 槽按 §16.1 口径核验后填) |
#f1f0f1 |
全主题保持;帧底色语义已由 --login-bg-base 承载,不复用本 token |
#434141 |
暗色模式普通小按钮底(wave5,602:1294) |
新增(随协议弹窗 / 小按钮 PR 注册) | 建议 login-dialog-secondary-bg dark 槽 / component alias |
dark #434141(light 槽 #eeeeee 对应 light_button_Normal) |
全主题保持 |
#565454 |
暗色模式普通小按钮描边(wave5,602:1294) |
新增(随协议弹窗 / 小按钮 PR 注册) | 建议 login-dialog-secondary-border dark 槽 / component alias |
dark #565454(light 槽 #ffffff) |
全主题保持 |
rgba(255,255,255,0.08) / rgba(255,255,255,0.1) |
hover 变亮叠层:深底 8% / 浅底 10%(wave5 统一口径,含 white_button 由黑 5% 改判;例外:back 亮色 hover 维持既有 rgba(255,255,255,0.7),沿 247:1637) |
新增 | --login-overlay-hover-* 二态 token 组(DESIGN.md §16.5 已采纳命名族) |
逐组件对拍 DESIGN.md §16.5 状态矩阵,不按深浅归纳直取 |
全主题保持;组件内禁止字面 rgba |
rgba(0,0,0,0.08/0.1/0.2/0.5) |
pressed 叠层四档:行类 8% / 浅底钮 10% / Dark_button_Normal 20% / 深底强调钮 50%(log_in_button、light_button_highlight,不论尺寸) |
新增 | --login-overlay-pressed-* 二态 token 组 |
逐组件对拍 DESIGN.md §16.5 状态矩阵的档位 |
全主题保持 |
4. 尺寸决策表
桌面 ColorRegistry 当前只管颜色。尺寸建议放在共享 login layout token / constants 模块中,例如:
- desktop renderer:
apps/desktop/src/renderer/components/login/loginDesignTokens.ts - mobile:
apps/mobile/src/theme/loginTokens.ts或apps/mobile/src/auth/loginDesignTokens.ts - browser callback main:独立 HTML renderer 使用同一份可序列化常量,避免手写散落数值
| Figma 值 | 出现场景 | 决策 | token / 类型 | 说明 |
|---|---|---|---|---|
1819 |
桌面设计画布宽 | 新增 | login-stage-width / singleton constant |
仅设计坐标基准,不必直接等于窗口宽 |
2098 |
桌面设计画布高 | 新增 | login-stage-height / singleton constant |
与 login-stage-width 成组,用于 scale / transform 计算 |
934 |
桌面 Cindy 立绘尺寸 | 新增 | login-desktop-hero-size |
CINDY_Client 正方形 |
680 |
桌面登录组宽、WORD_MARK 宽、失败 / Warning 回调卡片尺寸 | 新增 | login-panel-width、login-wordmark-frame-width、login-result-card-size |
语义不同,不建议只留一个 magic number;成功回调当前使用独立紧凑尺寸 |
560 x 500 |
Desktop 登录成功回调紧凑卡片 | 新增 | login-result-success-card-size(browser callback serialized layout constant) |
2026-09-02 产品 UX 覆盖旧成功态 680 x 680 + CTA;仅成功态使用,失败 / Warning 不变 |
180 |
桌面 / 移动 WORD_MARK frame 高 | 新增 | login-wordmark-frame-height |
字标外框高度,不等于内部实际图片高度 |
460 x 134 |
SLOGAN frame | 新增 | login-slogan-width、login-slogan-height |
短屏移动端会缩放该 frame,但设计基准仍需保留 |
620 |
登录整体高度含第三方入口 | 新增 | login-flow-height |
面板 500 + gap 40 + social 80。2026-07-27 登录改版由 560 改 620(面板增高 60 随之);双端落码 = 桌面 LOGIN_GROUP.height / 手机 loginSizes.flowHeight + LOGIN_GROUP.height |
500 |
登录面板高度 | 新增 | login-panel-height |
浏览器等待 / 准备 / 错误态也用(登录全步骤恒定,步骤间不得跳变)。2026-07-27 登录改版由 440 改 500——增的 60 = 面板内新增「跳过登录」槽(figma 700:791 / 705:886 / 705:1062)。Splash 借用登录面板时不跟随,仍为 440(SPLASH_PANEL.height 独立常量:Splash 五帧无该入口、设计稿未改版) |
680 x 60 |
「跳过登录」文字按钮槽(面板内 @y430) | 新增 | login-skip-entry-*(槽 680×60、字号 24 / 行框 29、命中区左右扩张 桌面 30 / 移动 50) |
2026-07-27 新增(figma 705:1068 容器 / 705:1069 文本 / 桌面 700:910)。槽仅作布局容器、本身不可点;字号取稿值 24,≠ Text_link 的 20,故单列不复用 login-code-link-*;命中区 = 当前语言实际文字渲染宽度 + 左右各扩(用户拍板),移动端用放大 Pressable bounds、不用 hitSlop(slop 不越父 View 边界,Android 界外触摸不派发)。落码 = 桌面 SKIP_ENTRY / 手机 LOGIN_SKIP_LOGIN |
y=540 |
圆钮行落位(= 面板底 500 + gap 40) | 复用推导 | 由 login-panel-height + 40 推导,不新增 token |
2026-07-27 由 480 改 540;协议行同理由 582 改 642(= 组高 620 + 22);error 槽保持 680×50 @y380 不随之移动 |
36 |
面板 / 回调卡片圆角 | 新增 | login-panel-radius |
不复用 mobile radius.container=12 |
540 |
输入框 / 按钮宽 | 新增 | login-control-width |
面板左右边距 70 推导,但以节点值为准 |
80 |
输入、按钮、社交圆钮高度 | 新增 | login-control-height、login-social-size |
控件和社交语义不同 |
40 |
输入 / 按钮圆角、Log_in gap、Global pill radius | 新增 / 复用局部 | login-control-radius;gap 可使用 login-panel-social-gap-y 或从 flow constants 推导 |
40 不是通用 spacing 阶梯 |
50 |
社交按钮圆角、验证码链接高度 | 新增 | login-social-radius 可由 login-social-size / 2 推导;login-code-link-height 独立 |
社交圆钮建议用 50% 或 size/2,不必新 token;链接高度需 token |
60 |
返回按钮尺寸、方式选择行圆角 | 新增 | login-back-size、login-method-row-radius |
语义不同 |
100 |
企业 / 个人登录方式行高 | 新增 | login-method-row-height |
方式选择专用 |
70 |
控件左右边距、社交 gap、回调 CTA x | 新增 | login-social-gap;左右边距可由 (680-540)/2 推导 |
社交 gap 是真实布局参数 |
24 |
spinner / 图标尺寸 | 复用现有图标尺寸或新增局部 | desktop 可用现有 icon size;mobile 可用 iconSize 若已有 24 |
若现有阶梯没有 exact 24,新增 login-spinner-size |
280 |
回调表情图容器 | 新增 | login-result-visual-size |
浏览器 HTML 也要用 |
750 |
移动画板宽 | 新增 | login-mobile-width |
@2x 设计基准;实现可换算为 375pt |
1624 |
移动 tall 画板高 | 新增 | login-mobile-tall-height |
对应约 812pt |
1334 |
移动 short 画板高 | 新增 | login-mobile-short-height |
对应约 667pt |
115.672 |
状态栏 mock 高 | 不进产品 token | 无 | 只是 Figma iOS mock;真实 RN 走 safe-area |
勘误(2026-07-28):「跳过登录」仅桌面落地,手机端整体剥离(见
design-decision-log.md「2026-07-28」条)。故本表 §4 里login-panel-height的440→500、login-skip-entry-*尺寸族与「命中区移动端扩 50 / 落码手机LOGIN_SKIP_LOGIN」均只对桌面成立;手机端loginSizes.panelHeight仍为440、无LOGIN_SKIP_LOGIN常量。
「跳过登录」文字按钮的色源(2026-07-27):文字色 = --login-secondary-text(#6F6F6F,light / dark 同值,见 §3 对应行),不走 --login-link-* 族——文字按钮与文字链接是两种组件,前者不做 hover / pressed 变色,因此本次改版没有新增任何颜色 token。
尺寸新增清单中不包含可由其它 token稳定推导的值(例如社交半径 80/2、输入左右边距 (680-540)/2)。若实现希望所有数值全命名,可额外补 login-panel-horizontal-padding=70、login-panel-title-y=31、login-panel-subtitle-y=75 等布局常量,但它们更适合在组件局部用结构化对象表达。
5. 桌面 token 落地建议
5.1 colors.ts
〔历史示例,勿照抄(2026-07-24 标注)〕:下方代码块是决策时点的注册示意,已由实际落码取代——真实注册见 apps/desktop/src/renderer/themes/colors.ts 的 --login-* 双态族(品牌红 token 落码名为 login-brand-accent,原案名 login-brand-bg 弃用)。保留仅为记录「component alias + hex 直读」的决策形态。
// 历史示意(token 名/值以 colors.ts 现行注册为准):
registerColor('login-brand-accent', { light: '#df0c27', dark: '#df0c27' }, 'Cindy login brand red accent (wave4 改判: accent 专用,禁止表达页面背景)');
registerColor('login-panel-bg', { light: '#fbfbfb', dark: '#312f2f' }, 'Cindy login panel / callback card bg');
registerColor('login-control-bg', { light: '#eeeeee', dark: '#eeeeee' }, 'Cindy login input bg');
不要新增 HSL companion,除非 shadcn 原语必须以 HSL 三元组消费。普通 CSS / Tailwind arbitrary var 均应使用 hex token(如 background: var(--login-brand-accent))。
5.2 非默认主题
| 主题类别 | 建议 |
|---|---|
| Default Light / Default Dark | 新 login alias 直接解析为 Figma 值;不继承默认主题的旧黑白 login token |
| Cindy Light / Cindy Dark | 对已有 Cindy 主题基础色无冲突;login alias 保持 Figma 帧值 |
| Atom One Light / Solarized Light / Eclipse / One Dark Pro / GitHub Dark / Monokai Pro / Material Ocean HC | 不 override login alias。登录是品牌场景,主题只影响登录后工作区 |
如后续产品要求「登录页也跟随编辑器主题」,应重新设计所有主题下的品牌页视觉,而不是让现有 semantic slots 自动染色。
6. 移动端 token 落地建议
移动端当前 ThemeColors 是固定 key 集合。建议不要把 22 个登录颜色全部塞入通用 ThemeColors 顶层,避免污染非登录页面;改为导出专用 login token:
export const loginColors = {
brandBg: '#df0c27', // wave4 改判: accent 专用(Global pill/字标红元素),禁止用作页面背景
panelBg: '#fbfbfb',
controlBg: '#eeeeee',
controlBorder: '#d4d4d4',
controlBorderActive: '#2a2828',
titleText: '#252222',
secondaryText: '#6f6f6f',
primaryButtonBg: '#2a2828',
primaryButtonBorder: '#434343',
primaryButtonText: '#d4d4d4',
} as const;
回调页如果在 RN WebView / 系统浏览器外壳中复用,应使用 loginResultColors.light / loginResultColors.dark,不要从系统 useColorScheme() 自行推导灰阶。
7. 复用 / 新增 / 豁免总表
| 类型 | 数量 | 内容 |
|---|---|---|
| 复用现有 token | 1 | login-error-text 复用名称,但建议调整到 Figma 错误红 #d91f37;CINDY theme 基础 slot 继续服务非登录 UI |
| 新增颜色 token | 22 | 见 §2 |
| 新增尺寸 constants | 25 | 见 §2 / §4 |
| 语义豁免 | 4 类 | Figma canvas 灰 #c5c5c5、浏览器 chrome mock 色、真实 iOS status bar mock 尺寸、回调图像资源内部裁切百分比 |
8. 风险与确认项
- 国际区移动
347:2857当前占位文案是手机号 + 国家区号,和桌面国际区邮箱登录不一致。实现前需要设计确认是节点误配还是国际区移动确实走手机号。 - 回调页 dark/white 是浏览器页面自身主题,不一定等于 app 当前主题;实现时要保留强制 preview 能力。
- disabled 按钮的
rgba(255,255,255,0.7)需要 token 化,否则会违反「不硬编码 rgba」规则。 如果后续新增 hover / pressed Figma 状态,应优先复用〔已关闭(wave5 2026-07-24):hover / pressed 状态已全量补齐并统一为「hover 叠白变亮 / pressed 叠黑」,叠层走login-brand-bg-pressed/login-primary-button-bg,不要把 hover 写成临时 hex。--login-overlay-*二态 token 组,见 §3 表尾与DESIGN.md §16.5状态矩阵;login-brand-bg-pressed仅保留品牌红 accent 按压语义,不作 hover 兜底。〕
9. 2026-08 Cindy 皮肤色阶改版(暖象牙 + 中性近黑)
用户在 2026-08-11 ~ 2026-08-14 的交互式调参会话中逐项批准;本节为该轮全部色值改动的 唯一权威,取代 §3 中被覆盖的条目(§3 其余条目继续有效)。冻结载体:
apps/desktop/src/renderer/themes/__tests__/cindyDecisionData.ts(103 条更新 + 32 条新入表)。 规则正文另见DESIGN.md§15.16。
9.1 推导规则(先于任何单值)
| 规则 | 内容 |
|---|---|
| 暖度基准(light) | 一切面: B = R−5(与页底同一暖差);唯一暖度常数,不得混用别的暖差。边框与交互态改为墨水后从底色继承暖感。天花板例外: 需最大抬升的浮起面保留纯白 #FFFFFF(现仅 ask-option-list-bg) |
| 中性基准(dark) | 一切面/文字: R=G=B,零暖差(2026-07 的微暖 +2 一并归零) |
| 文字墨水(2026-10-22 起) | 文字一律中性墨水加透明度:浅色黑、深色白,层级只靠透明度区分(§9.4);暖感来自透出的底色,不再逐档调暖。取代原「文字渐进暖」 |
| 等亮度换算 | 换色相时保持 WCAG 相对亮度不变(对比度只增不减);冷转暖边框按等亮度求解 |
| 墨水交互态(2026-10-22 起) | 悬停、标签底、选中、按下与边框改为同一墨水的低透明度(§9.2 交互态表),叠在页面、卡片、弹层上都深(暗色为亮)同一档,不再分页面/卡片两套值。取代原「双锚定」 |
| 双写同步 | 同色 HEX/rgba 与 HSL 两种写法(24 组)逐值一致,半透明档两种写法带同一透明度;聚焦描边等控件轮廓保留自身取值,不再从文字档派生 |
| 信息类文字地板 | 三级及以上的信息类文字对比度 ≥3.0(页面、卡片、悬停面上实测);占位/禁用/未激活态按 WCAG 豁免不抬 |
| 豁免不碰 | login-* 全族(60 token;值自 2026-10-23 文字、2026-10-27 面板 / 控件 / 主按钮起与本表同口径,但仍不随主题覆盖)、diff-*/error-*/overlay-*、语义状态色、阴影(§10/§16 + protected-tokens.ts) |
9.2 Light 面阶梯(暖象牙)
| 档 | 值 | 用途 | vs 页底亮度差 |
|---|---|---|---|
| 近白 | #FFFFFA |
composer pill / 控件底 | +11.2% |
| 卡片 | #FDFDF8 |
卡片/输入框/弹窗/气泡 | +9.4% |
| 次级卡片 | #FAFAF5 |
chip-alt / 代码块底(perm-code-bg) |
+6.8% |
| 页底 | #F2F2ED |
surface / titlebar / panel | 0 |
| 侧栏 | #EEEEE9 @ 85% 玻璃 |
独立面(玻璃遮盖度用户调参) | −3.3% |
交互态与边框(2026-10-22 用户裁决起为墨水,叠在任何底上都偏移同一档;浅色黑 / 深色白):
| 档 | Light | Dark | 用途 |
|---|---|---|---|
| 柔和 hover | 3.5% | 4% | surface-hover-soft、设置退出 hover、计划行 hover |
| 悬停 / 标签底 | 5% | 6% | surface-hover、surface-chip、菜单 hover、命令面板行 hover、下拉行 hover 等 |
| 选中 / 按下 | 8% | 10% | 弹层选中、设置菜单选中、计划大纲激活、提问卡标签 |
| 弱档 | 10% | 13% | file-chip / 滚动条 hover |
| 边框 / 分割线 | 8% | 10% | border-default 及各组件边框、分割线 |
浅色关闭态开关轨道随悬停加深由 #888888 改为 #808080,压在悬停行上保住 3:1。Fast/思考小开关的关闭轨道
(fast-toggle-track)原本借用禁用文字色,在 Cindy 改为跟随 switch-track-off,两类开关关闭态一致且滑块对比保持 ≥3:1。
9.3 Dark 面阶梯(中性近黑,自 2026-07 值整体平移)
页底 #181818 / 卡片 #1F1F1F / composer pill #272727 / 禁用底 #323232 /
侧栏玻璃 rgba(5,5,5,0.85)(用户调参 2026-08-11)。交互态与边框见 §9.2 交互态表(白色墨水)。
2026-10-22 起悬停与标签底叠在卡片上也比卡片亮,原「settings-menu-bg-selected 抬到卡片之上」(2026-08-13)的特例不再需要。
已知债: 近黑压缩使层次观感只保留 2026-07 版的 ~65%,修复方案(等亮度阶梯)与实测数据
记录于 issue #2559,独立一轮处理。
9.4 文字阶梯与对比度
2026-10-22 用户裁决:文字改为中性墨水加透明度(苹果 label 色的做法),取代 2026-08 的实色暖阶梯与 U2 例外。 层级严格由深到浅;对比度为叠在页面底色上的实算值,括号内为叠在悬停面上的值。
| 档 | 代表 token | Light(黑) | 对比度 | Dark(白) | 对比度 |
|---|---|---|---|---|---|
| 强调 | text-primary-emphasis |
95% | 17.4 | 100% | 17.8 |
| 正文 | text-primary |
88% | 15.0 | 82% | 12.1 |
| 说明 | text-secondary-mid、settings-section-desc、form-field-hint |
70% | 8.1 | 66% | 8.2 |
| 次要/meta | text-secondary、cmd-palette-item-meta |
56% | 4.8(4.65) | 55% | 6.1 |
| 三级/侧栏灰字 | text-tertiary、sidebar-list-muted |
44% | 3.2(3.13) | 40% | 3.8 |
| 占位/禁用 | text-placeholder、text-disabled |
32% | 2.2 | 30% | 2.7 |
- 每个文字 token 按它在 Classic 主题里的档位归入上表(Classic
#262626→ 正文、#525252→ 说明、#737373→ 次要、#A3A3A3→ 三级、#C4C4C4/#D4D4D4→ 占位/禁用)。 - 反相面上的文字(选中胶囊、tooltip、CTA)用各自专用前景色,不用半透明墨水档。
- 组件里不再借用其他档做占位文字,也不在文字色上叠
opacity-*凑中间档;由textTierDiscipline.test.ts守卫。 - 思考过程正文
thinking-body-text在 Cindy 指向次要档(2026-10-23 用户裁决;三级下浅 3.2、深 3.8 过淡)。 - 反相中性 CTA: dark 深字
#252222→#151515(对比度 13.60 → 15.74)。 - 控件轮廓保留原值、不随文字档派生:
chat-input-border-focus(lightrgba(107,107,103,.30)/ darkrgba(193,193,193,.30))、侧栏用户卡 hover/border(rgba(26,26,26,.06/.10))。 - 范围:Desktop 的 Cindy 皮肤;其他内置皮肤与用户主题不变;Mobile 另行阶段。
9.5 预览与杂项
settings-theme-auto-light = #F2F2ED、settings-theme-auto-dark = #181818(两模式文件同步);
md-table-bg 随页底;surface-translucent-overlay light 暖化 / dark 平移。
移动端未随本轮同步(342 处命中 + 冷更确认),为已登记 follow-up;
text-secondary/text-tertiary 命名倒置(改名方案)见 issue #2559。