Skip to content

armgit / cindy

Public Imported from GitHub
0

Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。

docs(design): 同步登录组件表与 wave5 状态引用,门禁脚本改动拆出本 PR

kirozeng483135c87a59
diff --git a/docs/design-rules/DESIGN.md b/docs/design-rules/DESIGN.md
index 57f9ea926d..e1ddd69936 100644
--- a/docs/design-rules/DESIGN.md
+++ b/docs/design-rules/DESIGN.md
@@ -2094,8 +2094,8 @@ and media position (`ui/media-scrubber`, seconds in/out). Native media controls
| `LoginSocialButton` | 双 | 第三方 / SSO 圆钮 | `label`, `onClick`, `children`, `isLoading / busy` | 80×80 r50 `--login-primary-button-bg / -border`;icon 48 居中;仅 normal + hover(桌面)+ pressed,**无 disabled / loading 视觉态** |
| `LoginSocialGlyph` | 手机 | 社交图标矢量(Apple / Google / WeChat / SSO;**apple 分支仅非 iOS 场景**——iOS 走官方按钮不进圆钮行,见 §16.2) | 内部 | Google / WeChat 品牌色不变;Apple / SSO 单色随圆钮底反相(暗色白圆上 `#2A2828`) |
| `LoginBackButton` | 双 | 返回 | `label`, `onClick`, `disabled` | @(20,20) 60×60 r40 `--login-action-control-bg` / `--login-back-border`;chevron 24 |
-| `LoginTextLink`(桌)/ `LoginTextLinkSlot`(手) | 桌 / 手 | 重发链接 / 提示文案(**文字链接**,不承载「跳过登录」) | `variant`(link / countdown,桌), `tone`, `children` | @(70,238) 540×50 20;link 变体 `--login-link-text` 下划线可点、hover / pressed 变色;countdown / slot `--login-control-placeholder` 不可点 |
-| `LoginSkipEntry`(桌)/ `LoginSkipLoginLink`(手) | 桌 / 手 | 「跳过登录」入口(**文字按钮**,与上一行的文字链接是两种组件) | 桌:`children`, `onClick`, `disabled`, `testId`;手:`label`, `onPress`, `testID` | 槽 @(0,430) 680×60,文字 24 Regular + 下划线、`--login-secondary-text`(双模同值),**hover / pressed 不变色**;命中区 = 文字实宽 + 左右各扩(桌 30 / 手 50 设计px)、高占满 60 槽,容器不可点 —— 逐条口径见下方「登录文字按钮」 |
+| `LoginTextLink`(桌)/ `LoginTextLinkSlot`(手) | 桌 / 手 | 重发链接 / 提示文案(**文字链接**,不承载「跳过登录」) | `variant`(link / countdown,桌), `tone`, `children` | @(70,238) 540×50 20;link 变体 `--login-link-text` 下划线可点、hover / pressed 变色;countdown 变体(桌面)`--login-secondary-text`(墨水次要档 黑 56% / 白 55%)不可点;手机 `LoginTextLinkSlot` / 倒计时暂保留 `controlPlaceholder` 实色,另行收拢 |
+| `LoginSkipEntry`(桌)/ `LoginSkipLoginLink`(手) | 桌 / 手 | 「跳过登录」入口(**文字按钮**,与上一行的文字链接是两种组件) | 桌:`children`, `onClick`, `disabled`, `testId`;手:`label`, `onPress`, `testID` | 槽 @(0,430) 680×60,文字 24 Regular + 下划线、`--login-secondary-text`(桌面:墨水次要档 黑 56% / 白 55%;手机端该入口已剥离,见 §16.5 勘误),**hover / pressed 不变色**;命中区 = 文字实宽 + 左右各扩(桌 30 / 手 50 设计px)、高占满 60 槽,容器不可点 —— 逐条口径见下方「登录文字按钮」 |
| `LoginResendCountdown` | 手机 | 验证码重发(倒计时 / 重发二态) | `deadline`, `countdownTemplate`, `resendLabel`, `onResend` | @(70,238);`deadline=null` → 常驻可点无倒计时(SSO 验证码屏用) |
| `LoginMethodRow` | 双 | 方式选择行(企业 / 个人) | `top`, `title`, `subtitle`, `icon`(enterprise / person), `onClick` | 540×100 r60 `--login-action-control-bg` / `--login-control-border`;左图标 24@(27,37) / person 18×20@(30,39);右 share 18@(490,40);文字 @(67) 垂直居中 |
| `LoginErrorText` | 双 | 错误提示 | `children` | @(0,380) 680×50 20 `--login-error-fg` |
@@ -2106,7 +2106,7 @@ and media position (`ui/media-scrubber`, seconds in/out). Native media controls
| | **文字链接**(`LoginTextLink` / `LoginTextLinkSlot`) | **文字按钮**(`LoginSkipEntry` / `LoginSkipLoginLink`) |
| --------------- | ---------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 语义 | 链接:跳转 / 重试 / 次要说明(重发验证码、sso-org 帮助行) | 按钮:触发一次产品级动作(跳过登录 → 进入本地模式) |
-| 色 | `--login-link-text` 族(light `#2A2828` / dark `#EEEEEE`) | `--login-secondary-text`(墨水次要档 黑 56% / 白 55%,零新增 token;手机端暂为 `#6F6F6F`) |
+| 色 | `--login-link-text` 族(light `#2A2828` / dark `#EEEEEE`) | `--login-secondary-text`(墨水次要档 黑 56% / 白 55%,零新增 token;手机端无此入口,见 §16.5 勘误) |
| hover / pressed | 变色(`--login-link-hover` / `-pressed`) | **不变色**——只靠下划线常显 + 指针形状(桌面 `cursor:pointer`)给反馈 |
| 字号 / 槽 | 20,槽 540×50 @(70,238) | 24,槽 680×60 @(0,430) |
| 命中区 | 槽内整块 | **文字实宽 + 左右各扩**(桌面 30 / 移动 50 设计px),高度占满 60 槽;680×60 容器只做居中定位、自身不可点(桌面 `pointer-events:none` + 内层 button `auto`;移动 `pointerEvents="box-none"` + 内层 `Pressable`) |
diff --git a/docs/design-rules/token-decision-table.md b/docs/design-rules/token-decision-table.md
index 18b5d442e5..4796a898c5 100644
--- a/docs/design-rules/token-decision-table.md
+++ b/docs/design-rules/token-decision-table.md
@@ -10,7 +10,7 @@
>
> 〔wave4 段历史部分作废(2026-07-24 目录整编标注)〕:本段原钉死的画布落码方案——页面底消费 `var(--surface)`、两层 `#F70121` 渐变代码复现、`--login-window-border-outer/-inner` token——已被后续实现与实机走查推翻。**现行结论**:画布底走 `--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,组件库更新,权威 = `figma-component-spec §11`)**:(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_Normal` 20% / 浅底钮 10% / 行类 8%——**落码逐组件对拍 `figma-component-spec §11.1`,不按类别名推断**;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 注册,不提前占位。
+> **⚠ 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_Normal` 20% / 浅底钮 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` 为准〕
@@ -54,8 +54,8 @@
| `#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` 已采纳命名族) | 逐组件对拍 `figma-component-spec §11.1`,不按深浅归纳直取 | 全主题保持;组件内禁止字面 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 组 | 逐组件对拍 `figma-component-spec §11.1` 档位表 | 全主题保持 |
+| `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. 尺寸决策表
@@ -160,7 +160,7 @@ export const loginColors = {
- 国际区移动 `347:2857` 当前占位文案是手机号 + 国家区号,和桌面国际区邮箱登录不一致。实现前需要设计确认是节点误配还是国际区移动确实走手机号。
- 回调页 dark/white 是浏览器页面自身主题,不一定等于 app 当前主题;实现时要保留强制 preview 能力。
- disabled 按钮的 `rgba(255,255,255,0.7)` 需要 token 化,否则会违反「不硬编码 rgba」规则。
-- ~~如果后续新增 hover / pressed Figma 状态,应优先复用 `login-brand-bg-pressed` / `login-primary-button-bg`,不要把 hover 写成临时 hex。~~〔已关闭(wave5 2026-07-24):hover / pressed 状态已全量补齐并统一为「hover 叠白变亮 / pressed 叠黑」,叠层走 `--login-overlay-*` 二态 token 组,见 §3 表尾与 `figma-component-spec §11.1`;`login-brand-bg-pressed` 仅保留品牌红 accent 按压语义,不作 hover 兜底。〕
+- ~~如果后续新增 hover / pressed Figma 状态,应优先复用 `login-brand-bg-pressed` / `login-primary-button-bg`,不要把 hover 写成临时 hex。~~〔已关闭(wave5 2026-07-24):hover / pressed 状态已全量补齐并统一为「hover 叠白变亮 / pressed 叠黑」,叠层走 `--login-overlay-*` 二态 token 组,见 §3 表尾与 `DESIGN.md §16.5` 状态矩阵;`login-brand-bg-pressed` 仅保留品牌红 accent 按压语义,不作 hover 兜底。〕
## 9. 2026-08 Cindy 皮肤色阶改版(暖象牙 + 中性近黑)
diff --git a/scripts/check-pr-design-basis.mjs b/scripts/check-pr-design-basis.mjs
index 7ad107f146..76eba49731 100644
--- a/scripts/check-pr-design-basis.mjs
+++ b/scripts/check-pr-design-basis.mjs
@@ -33,7 +33,7 @@ const UI_FILE_SUFFIXES = ['.css', '.scss', '.less'];
const FIELD_LABEL = '引用的设计规范';
// 设计规范文档引用特征:docs/design-rules/ 目录或其下具体文档名。
const DESIGN_DOC_PATTERN =
- /(docs\/design-rules\/|DESIGN\.md|cindy-design-system|token-decision-table)/i;
+ /(docs\/design-rules\/|DESIGN\.md|cindy-design-system|figma-component-spec|token-decision-table)/i;
// 「不涉及」豁免在去掉该词与标点后至少要剩这么多字符,才算附了理由
// (放到 4 是为了让「纯逻辑重构」「无 UI 变化」这类最短合理理由能过)。
const MIN_EXEMPT_REASON_CHARS = 4;