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。

152 KB
Raw Blame

Cindy 设计决策史(design-decision-log)

DESIGN.md 只保留「现行有效」的规范;历史决策、被推翻的方案、勘误过程按日期 归档在本文件(中文)。每条记录:日期 / 决策 / 背景与被取代方案 / 现行落点 (DESIGN.md 章节 + token / 冻结测试)。 本文件是只增不改的台账,不承载任何现行规范——与 DESIGN.md 冲突时以 DESIGN.md 为准。

范围现状:2026-07-24 建档,首批归档原 DESIGN.md §13 的 G1–G4 勘误全文; 2026-07-25 起 §15 CINDY 皮肤族的决策史(红色体系重构、caret 改稿、vibrancy 定稿等)已随 §15 保号重构迁入本文件,DESIGN.md §15 只保留现行规范。

2026-10

  • 10-27 登录页面板、控件、描边、主按钮与悬停/按下并入墨水口径——用户先看了亮 / 深两套「现在 vs 方案」对比稿,深色面板在 A(#1F1F1F,主界面卡片档)与 B(#272727,输入框档)之间选了 A,其余按方案执行。被取代:登录页自有的「墨黑–米白反色」实色(面板 #FBFBFB / #312F2F、控件 #EEEEEE / #2C2A2A、主按钮 #2A2828 / #EEEEEE、暖灰描边与白边)、2026-07-24 Figma「全按钮族 hover 叠白」口径及其状态矩阵、禁用钮「深底叠白 70%」。现行:面板 = 主界面卡片面,控件 = 墨水填充,描边 = 墨水线,主按钮 = 主界面反相 CTA(亮色因此由暖黑变为 #3C3F43),填充控件悬停 / 按下叠同色墨水加深一档,反相按钮叠黑;Apple 圆钮另设 login-overlay-apple-*;禁用主按钮 = 墨水填充 + 占位字,login-disabled-button-overlay 退役(ID 按治理合同 §4 保留);旧版导出的本地主题(至少 10 个登录色同时等于历史值才认定为旧快照)里等于该模式历史默认值的 login-* override 在加载期丢弃(对照表取自冻结快照全部历史,loginLegacyDefaults.json)(不沿用主界面 Button 的 60% 透明度,因首屏主按钮默认禁用)。反相按钮按下叠黑亮色取 40%(用户看实图后要求比悬停明显更深)。浏览器回调页内联常量同步。login-* 仍是独立 token 族,不跟随扩展主题;Mobile 登录皮暂不改。落点:DESIGN.md §16.1 / §16.5、loginInkLadder.test.ts、desktop-color-defaults.json。

  • 10-26 滚动截图沿用截图流程,不新增独立面板——用户指出缩小预览/保存面板割裂体验。滚动时保留原选区,在选区外预览拼接结果并提供编辑、保存、取消、完成;完成复制并关闭,编辑回原标注器。预览缩放不得降低导出尺寸。落点:DESIGN.md §4、RegionScreenshotOverlay、ScrollCaptureOverlay。

  • 10-26 群聊顶栏群名下一行改为人数,不再列出所有成员——用户指出群名下面把成员名用「、」平铺列满,跨账号的群里「Miao (dash)、Cindy (chris)、dash、Opus (dash)…」又长又乱,要求「不能列满」。现行:Desktop 与 Mobile 群聊顶栏群名下只写「N 位成员」(人与伙伴一起算,Desktop 用等宽数字),不再在这一行标「负责人」;Desktop 有人在发言、安排或做某一步时,这一行换成原有的进行中状态(✨「X 正在说…」),结束后回到人数;Mobile 群聊主界面始终显示人数,不做该状态切换。完整名单移到悬停提示(Desktop)与读屏标签(Mobile),群设置的成员列表不变;私聊仍显示对方名字。memberCount 文案由「N 位伙伴」改为「N 位成员」,因为群里也有人类成员,群设置抽屉同步受益。被取代:bot-group-chat.md §5「成员名单(负责人带标)」。落点:BotGroupChatView.tsx 顶栏、BotGroupChatScreen.tsx 副标题;单页场景 group-chat --case crowded。

  • 10-24 手机退役「任务/伙伴」两种首页模式:伙伴与任务完全打平,和电脑一致——用户指出伙伴段上线后抽屉里的「任务 | 伙伴」切换和标题范围菜单里的「伙伴」仍是一套独立筛选,既然伙伴已经并入任务首页就不应再有独立筛选。现行:首页只有一种;抽屉不再放任务/伙伴分段控件,标题范围菜单不再列出伙伴;首页搜索同时列出匹配的伙伴;伙伴未读显示在伙伴段行与头像条蓝点上。被取代:10-13 的任务/伙伴左右滑动切换、伙伴首页、分段计数与菜单键注意点(menu-attention 资源已删除)。旧版本存下的「上次停在伙伴页」偏好在下次写入时清除,不再恢复。落点:DESIGN.md 手机首页段落;apps/mobile/src/session/HomeSurface.tsx、HomeTeammatesSection.tsx、useHomeMode.ts。

  • 10-23 登录页文字并入墨水阶梯;移除 figma-component-spec.md——用户裁决:登录页不再单独挑灰,文字与主界面共用一条墨水阶梯,规则只写一处。login-* 仍是独立 token 族(只跟随 light / dark、受主题导入保护),但标题、输入已填字、回调页标题取正文档 88% / 82%,副标题 / 倒计时 / 「跳过登录」/ 回调页正文取次要档 56% / 55%,输入占位取占位档 32% / 30%;品牌回调页(oauthResultPage.ts)的标题、正文与错误码细节同步改用墨水档;新增 loginInkLadder.test.ts 断言六个 token 与 CINDY 主界面同值。背景:原副标题双模同值 #6F6F6F 在深色面板 #312F2F 上只有 2.6:1(现 5.2:1);亮色输入占位 #D4D4D4 在输入框上 1.3:1 几乎看不见(现 2.2:1);其余各档视觉基本不变(亮色副标题 4.9 → 4.9,深色已填字 12.3 → 10.1)。按钮前景(主按钮字、链接字、禁用钮字)不属文字档,保留实色。同批移除 figma-component-spec.md:它是 2026-07 的 Figma 组件逐态读取记录,7 月底后未再回写(10-01 画布底改值等均未跟进),现行值早已以 DESIGN.md §16 与代码常量为准;仍现行的按钮族 hover / pressed 状态矩阵已迁入 §16.5,其余为历史读取记录,可在移除前的提交 70b32d7578 查阅。范围:Desktop;Mobile 登录皮暂保留原实色,另行收拢。现行落点:DESIGN.md §16.1 / §16.2 / §16.5,colors.ts login 组,oauthResultPage.ts 品牌回调页。

  • 10-22 Cindy 中性色改为墨水加透明度(苹果 label 色做法):文字、悬停与选中底、边框;退役 U2、2026-08 文字暖阶梯与双锚定——用户在实验皮肤 Cindy Next 里对比后裁决:Cindy 的中性色不再逐档挑实色灰,统一为浅色黑、深色白加透明度。文字:强调 95/100%、正文 88/82%、说明 70/66%、次要 56/55%、三级 44/40%、占位与禁用 32/30%,层级严格由深到浅;填充与线:柔和悬停 3.5/4%、悬停与标签底 5/6%、选中与按下 8/10%、弱档 10/13%、边框与分割线 8/10%;浅色关闭态开关轨道随之由 #888888 加深到 #808080,压在悬停行上保住 3:1;Fast/思考小开关的关闭轨道原本借用禁用文字色,改为跟随开关关闭轨道;三处设置输入框去掉叠在占位色上的额外透明度,与标准输入框一致;随后整体复查,把组件里不合规则的文字一并收回到档位:借用三级/说明/次要档的占位文字 25 处改用占位档,在文字色上再叠透明度假装层级的 110 处改用最接近的档位(深色悬浮提示等反色底、分段选择器内的计数、拖动影子 9 处按规则保留),写死的灰色 1 处改用次要档,主聊天输入框占位不再叠 40%,并新增 textTierDiscipline 守卫防止退回。10-23 用户追加裁决:思考过程正文由三级改为次要(三级下浅色 3.2、深色 3.8 过淡;次要浅色与改前持平 4.8、深色 6.1)。同时修复半透明墨水带来的图标问题:多段描边的图标在笔画交叉处叠色出深点(浅色)/亮点(深色),改为整枚合成(globals.css,lucide 自动生效,手画多段单色图标加 data-ink-icon)。背景:原 Cindy 的三级比次要更醒目(浅 #6B6B67 对 #888883,深 #C1C1C1 对 #6F6F6F),「平时三级、悬停变次要」会越悬停越淡;占位与三级同值,读起来像已填写;深色下标签底 #1D1D1D 比卡片 #1F1F1F 还暗;实色灰和实色边框压在毛玻璃、壁纸上会丢层级或变成一道道白线。实测:壁纸·浅色时侧栏的时间、项目名、分组标题约 1.5:1 → 约 2.7:1,浅色悬停与页面色差 1.04 → 1.10。用户确认范围时已知悉:壁纸上的分割线会明显变淡(嫌淡可把边框提到 10–12%)。被取代:§15.5 U2(及其反向冻结)、§15.16 浅色「文字渐进暖」与「双锚定」。同时改写壁纸一节「Never reduce text or control opacity」的措辞:原意是调壁纸可见度时不淡化文字与控件,并非禁止半透明文字色。范围:Desktop 的 Cindy 皮肤;其他内置皮肤与用户主题不变,Mobile 另行阶段。现行落点:DESIGN.md §2 / §7 / §10 / §15.5 / §15.6 / §15.16,token-decision-table.md §9.1–§9.4。

  • 10-22 伙伴输入框双按钮切换——用户审核交互原型后确认:空输入保留听写与语音对话两个按钮,有可发送内容后在同一槽位显示发送。初稿缩放不明显,按用户反馈扩大到图标 55% ↔ 100%,保留 250ms;按钮壳和命中区固定,不弹跳。只用于本机一对一伙伴,录音、停止、排队和编辑待发内容沿用现有语义。现行依据见 DESIGN.md §14.4,实现为 ChatInput / SendButton,真实组件回归与单页验证随 #6768 交付。

  • 10-22 消息平台隐藏任务记录登记为无框文字点击层——用户要求点击记录进入只读详情,并保留列表原有样式;中国大陆版 macOS 测试包已验收。现行:BotChannelsPage 的记录名称与摘要是一处窄口径无框文字控件,静止、悬停和按下都不加底、边框或圆角;「重新开始」仍是已登记的紧凑次要按钮,不属于该豁免。键盘焦点用 --focus-ring 的 box-shadow ring,因为全局规则会抹掉非输入控件的 outline。这不是设置页其他操作的通用豁免,也不新增键盘焦点的实机截图结论。落点:DESIGN.md §4 Desktop hidden channel records、§5 已登记无框按钮例外。

  • 10-21 群聊话题未读沿用伙伴未读蓝点——用户确认 r4 独立话题原型(话题入口「N 条新回复」「@你」、输入框上方右下角的话题提示与本群话题列表、话题面板「新回复」分隔线)。原型里未读字用蓝色;为守住「近乎全灰」规则,实现只把伙伴未读 token --bot-unread-bg 用在 6px 圆点上,旁边文字保持 --text-primary 中粗。DESIGN.md §2 Bot Unread Badge 的作用域加上这四处话题未读标记,仅限圆点、不作文字色。提示是普通按钮(胶囊档)、列表是普通容器(12px、行 8px),不新增登记形状。现行规则见 bot-group-chat.md §10「话题未读与提示」。

  • 10-20 Desktop 群聊进行中胶囊登记——#6549 的群聊设计采用输入框上方居中、按内容宽的进行中胶囊,展开过程时转为面板。补齐 DESIGN.md §5 的具体形状登记与 §4 组件条目,使其与 bot-group-chat.md §5 一致:登记仅覆盖 BotGroupProgressStrip 收起时承载状态与独立操作的外层可见框;展开面板、内部按钮和其它工具栏不继承此例外。本次只补文档,不改变实现或视觉,也不新增实机验收结论。

  • 10-19 取代注记:Bot Market 开场气泡改为轻量样式,不再使用主按钮同色——用户反馈 10-16 取代注记里的 --accent-cta-bg 底「跟 button 一样、颜色太重」。现行:气泡底 --surface-elevated、1px --border-default 描边、正文 --text-primary、发送图标 --text-secondary-mid,与用户自己的消息气泡(--msg-user-*)同配方,Light/Dark 同源;悬停与键盘焦点底色升到 --surface-hover,仍有「可点」反馈(早期纯 --surface 无描边版在 Light 下看不清,描边正是为此补上)。尾巴填充随气泡底色,另用 SVG 描边把气泡边框续接过曲线与底边;气泡形状登记范围不变(仅此一处)。同日:模块大标题「一起工作的方式」改为「我的配置」(英文 My Setup),四个模块标题前加同源图标(技能、知识与记忆、例行任务引用伙伴设置的 botSettingsIcons.ts;工作工具即插件,引用侧栏「插件」导航项图标),入口菜单文案与弹窗标题同用「发现伙伴」。同日用户追加:例行任务列表每一行前面的单条图标不再显示(标题、「· 节奏」、说明与「默认关闭」左对齐),10-16 presentation.detailZh 条里「例行任务 = 图标 + 标题」的部分被取代;客户端对包内 routine icon 字段读取时接受并忽略(旧包与去掉该字段的新包都可读),不再有行内图标表。用户再追加:「列表前不要图标」适用于详情页所有列表项——工作工具每一行前的插件图标 / 拼图占位块一并去掉(只留「名称 + 用途 + 右侧安装状态」,同卡内文字左对齐),客户端不再读取已装插件的 iconDataUrl;仅分区标题图标与头部「关键能力」三项图标保留。10-16 presentation.detailZh 条里「工作工具 = 20px 图标 + 名称 + 用途」的图标部分被取代。10-16 取代注记里的颜色一句与 10-15 的颜色一句均被本条取代;旧条目保留不改。

2026-10-18:手机错误卡片增加呼吸空间

用户指出紧凑版按钮和文字太挤:保留操作集中与可换行结构,卡片内边距和说明到操作区改为 16pt,标题与说明间距 8pt;按钮增加内部留白与 12pt 操作间距,视觉高度 36pt、触控区仍至少 44pt。详情保留弱化文字入口,窄屏优先换行。

2026-10-18:手机错误卡片进一步紧凑化

用户看过实际截图后选择紧凑卡片:说明集中在标题下,重试/Fork/详情共用换行操作区;关闭入口替代「忽略」,沿用原回调与忙碌/只读门控。按钮缩小视觉底板,保留 44pt 热区。原生表单错误由 Section 承载,移除双层卡片。现行规范见 DESIGN.md「Error notices」。

  • 10-18 补齐独立错误卡片,手机改为纵向排版——用户要求统一整理适合卡片化的错误提示,并优化手机版。补齐文件保存、搜索、插件加载与市场操作、模型与目录选择、任务详情、设备管理及自动任务失败等入口。手机说明与操作分行,操作使用完整宽度与至少 44pt 热区;SwiftUI 表单使用同款原生卡片。字段校验、状态徽标、内嵌工具结果与系统警告不强制卡片化,避免重复容器。恢复与 Fork 判据保持原样。

  • 10-18 错误提示统一为中性卡片,历史恢复沿用 Fork 图标——用户认为原有大面积红底错误提示难看,且「可读历史」「内部加密信息」等文案难懂,要求统一错误提示。错误卡片使用中性底色、细边框、小红色图标和清晰操作,技术详情默认折叠;历史恢复改为「在新任务中继续」。用户特别澄清,图标应与消息 Fork「开启一个新任务」入口一致,使用 Split。桌面与移动端分别复用 ErrorNotice。示意图用于确认方向,不代表实机视觉验收。

  • 10-18 「主题」改为单行下拉,与显示模式之间恢复分割线——用户要求主题选择做成一行,并指定用「通用 → 显示语言」同款的胶囊下拉。现行:「主题」左侧名称、右侧 320×36 胶囊下拉,触发器、展开面板、选项与选中样式与「显示语言」同一实现(Radix Select),单方案主题的「仅浅色 / 仅深色」标记保留在当前值与选项上;「主题」「显示模式」「本地主题」三行之间都用分割线隔开。被取代:同日的整行宽下拉与「主题、显示模式之间不加分割线」。落点:DESIGN.md Theme switching 段;AppearanceSection.tsx FamilyDropdown。验证为开发版实测(两只下拉同为 320×36)与截图。

  • 10-18 外观页首卡去掉节标题——用户裁决:页面标题「外观」下直接接主题卡片,不再另设「主题」节标题;卡片内下拉框名称由「配色」改回「主题」并去掉说明小字;「主题」与「显示模式」之间不加分割线(两者是一组:主题决定可用模式),「本地主题」前保留分割线。被取代:同日早些时候的「主题」节标题与「配色」命名。落点:DESIGN.md Theme switching 段。

  • 10-18 「外观」恢复页面标题,显示模式改为窗口缩略图——用户更正:左侧菜单的「外观」与页内「外观」是两层,页内的是整页标题,应保留,并问是否该更大。现行:页内标题 20px / 500、行高 1.3,下距首节 24px,比各节标题 16px 高一级(取桌面标题段白名单的下一档);「配色」名称保留。显示模式按用户给的参考图改为一行:左侧名称,右侧三张 92×60 的迷你 Cindy 窗口缩略图(侧栏、右上用户消息、几行回复、底部输入框与发送键)加 12px 说明,颜色直接取所选配色的浅 / 深方案,「跟随系统」左浅右深;选中项外圈 2px 描边加 2px 间隙,未选中悬停显出普通描边。缩略图不用品牌红(品牌红只用于品牌画布)。同日用户要求去掉「本地主题」与「壁纸」下方的小字说明。被取代:三张大图标卡片(太阳 / 月亮 / 显示器)与当日早些时候「页内不重复页名」的做法。落点:DESIGN.md Theme switching 段;测试:AppearanceSection.accessibility.test.tsx。验证为开发版实机截图(浅 / 深色、Eclipse 仅深色、Solarized 仅浅色)。

  • 10-18 「外观」栏目内重排信息层级——用户指出「外观」已是独立栏目,页内不应再以「外观」为标题,各栏目也应重新梳理层级与标题。现行:去掉页内「外观」大标题,分为主题、壁纸、字体、侧边栏与面板、回复动效五节,标题在卡片外,卡片内按设置行排并以分割线隔开;主题节内的下拉框改名「配色」以免与节标题重复,「本地主题」补一句说明并把四个按钮移到行右侧;壁纸的「恢复默认」移到节标题右侧,原卡片内小标题与说明改为节标题与节说明;「面板布局」并入侧边栏与面板卡片;字号的恢复默认按钮改用与其他恢复默认一致的回退图标;设置搜索为「字体」「侧边栏与面板」两节补入口。字体与配色下拉框保持整行宽度,因为展开面板须与触发器同宽,压窄会挤坏字体预览与自定义输入。同日用户裁决:设置页下拉框的当前值与选项统一为常规字重 400,选中项只靠勾与底色表示;壁纸滑块名称保持 12px。被取代:页内「外观」大标题与单卡堆叠。落点:DESIGN.md Theme switching 段与「Desktop settings rows」;测试:settingsSearchCatalog.test.ts、AppearanceSection.accessibility.test.tsx。验证为开发版实机截图与逐元素字号字重测量。

  • 10-17 桌面设置拆出「外观」栏目,「通用」页重排;单方案主题锁定显示模式——用户认为外观相关设置值得单列,并要求桌面端先拆。现行:设置左侧菜单「通用」下新增「外观」,收纳主题与显示模式、本地主题、壁纸、字体与字号、侧边栏样式、插件面板恢复入口、面板布局,以及原在「个性化」的「回复动效」;旧的「通用 → 外观」「个性化 → 回复动效」链接与搜索结果自动落到新栏目,帮助助手知识拆为「外观」和「语言与通知」两篇。「通用」按常用程度重排为:账号、语言、通知、应用行为、消息输入、伙伴、协同、Agent 资源占用、Git 安全、Pi 扩展、实验性功能;「消息输入」按用户裁决不挪到「键盘快捷键」。排版统一为「标题在卡片外、同类设置同卡多行、行间分割线」:应用行为与实验性功能各合成一张卡,消息输入改为与其他行一致的字号字色,Pi 扩展补标题并改为带箭头的标准行,伙伴的默认模型改为「左名称说明、右选择器」,备用模型单列一行并带添加按钮;Agent 资源占用的长说明经用户同意精简为一句,生效时机挪到各行说明。用户同时指出部分主题没有浅色或深色方案:主题改排在显示模式之前,主题列表给单方案主题标「仅浅色 / 仅深色」,选中时显示模式只读并说明原因,保存的模式不变。被取代:外观作为「通用」中的一节、单方案主题仅在卡片底部给一行提示。落点:DESIGN.md「Desktop settings rows」与 Theme switching 段;settingsRowClasses.ts;测试:settingsSearchCatalog.test.ts、AppearanceSection.accessibility.test.tsx。验证为开发版实机截图(浅 / 深色、Eclipse 单方案、备用模型增删);其他设置页仍有 20px 单行卡片,未声明统一。

  • 10-16 macOS 菜单栏余量面板改为暖色液体(B2)+ Barlow 数字——用户反馈浅色面板和 Cindy 的配色不搭(系统冷灰毛玻璃加纯黑白液柱),并希望动效更生动、点击有反馈。用户先后看过 HTML 方案 A / B 及降低液柱对比度的 A2 / B2,选定 B2 并指定第二款数字字体(Barlow Condensed)。现行:材质上叠暖色调与左上角极淡的 Heart Orange 光晕,文字与填充改为暖灰;液柱为玻璃槽内的柔和渐变,浅色按用户要求再降一档对比度;数字与 % 号统一用 Barlow,% 约为数值的 60%,只有纯数字用 Barlow,同日用户看测试环境后改判:中英文与数字混排的文字(如「15天12时后重置」「周四 14:13」)整段用系统字体,不再把数字拆出来用窄体;“打开 Cindy”前加 Logo 的红色 >。动效按用户裁决只表达“正在消耗”:本机有运行中任务正在使用的来源,液面轻微荡漾,没在用的来源完全平静;不要气泡;推荐光环与低余量光晕保持静止;同日用户裁决把推荐柱的外圈描边从 1.5pt 深色减弱为 1pt 次要灰(液柱变柔和后深色描边成了最强的对比,像“选中”或“出错”),保留淡光晕,由标题前的图标与光晕负责对号入座。同日后续裁决:面板半透明,所有中性色(文字、描边、分割线、卡片、玻璃槽、液体、中性圆环)一律用暖黑 / 暖白加透明度,不再用实色灰;液体去掉渐变,改为单色加透明度;详情页圆环的 Codex 蓝、Claude 橙等品牌色保留;水柱升起时带轻微晃动,停住后再按惯性晃动并平静。同日再裁决:去掉标题前的推荐来源图标(标题文字已写明来源)和推荐柱外的光晕,推荐柱只保留 1pt 次要灰描边;鼠标移到柱子上时液面轻晃一下。被取代:v6 原型的冷灰材质、纯黑白液柱、系统数字字体与 0.5s 液柱填充。落点:DESIGN.md「macOS menu bar quota panel」与 §14.4 菜单栏动效登记;数据:MenubarSourceCell.active、MenubarView.headlineAlert;测试:collect.test.ts、snapshot.test.ts。验证为 helper 预览截图(浅 / 深、中文 / 英文、矮屏布局)与逐帧像素对比;未在真实菜单栏点开实测。

  • 10-16 取代注记:Bot Market 开场气泡颜色与详情模块展示以现行实现为准——10-15「开场气泡」一条里的颜色(--surface、悬停 --surface-chip)已被现行实现取代:气泡与尾巴走 --accent-cta-bg,文字 --accent-pure-cta-fg,悬停与键盘焦点 --accent-hover,与 docs/product-rules/bot-market-native.md 一致,Light/Dark 同源;气泡形状的登记范围不变。10-16「纵向四模块」一条里的「长内容预览 3 行渐隐、展开上限 320px、同模块手风琴」及同日第二轮的展开/收起按钮已被后一条 presentation.detailZh 的展示取代:现为技能最多两行描述、知识最多三行说明,没有展开与手风琴。其余裁决不变;旧条目保留不改。

  • 10-16 Bot Market 详情弹窗内「会记住你的」偏好标签不用 --surface-chip,改用卡片层 + 细边框——场景:伙伴详情「知识与记忆」模块下的偏好标签行(开场确认后会记住的时区、关注的主题等)。偏离:DESIGN.md「Chip & Button Neutrals」规定 tag pill 用 --surface-chip,本处改用 --surface-elevated 底 + 1px --border-default + --text-secondary-mid 文字。理由:Dark 下 --surface-chip 与弹窗底色无法区分,标签看起来是纯文字(截图证据:tmp/opus-build/shots-t6/modules-cooper-dark-1280x800.png 对比修正后的 shots-t6b/modules-cooper-dark-1280x800.png),而同模块的技能/知识/工具卡与伙伴群 BotGroupPlan.tsx 现有药丸标签用的就是 --surface-elevated + --border-default,Light/Dark 都清晰。范围:仅 BotMarketModules 里的这一个标签组件;不改全局 --surface-chip(其它位置仍在用),不推广到其它弹窗。

  • 10-16 Bot Market 详情页展示字段改为包作者撰写的 presentation.detailZh,取消步骤列表与展开——取代同日上一条里「技能的操作顺序、方法参考正文、预览 3 行渐隐/展开」的做法:技能 = 名称 + 最多两行描述;知识 = 标题 + 最多三行说明,其下一行小标题「会记住你的」+ 偏好标签;工作工具 = 一张卡内逐行,20px 图标 + 名称 + 用途同一行;例行任务 = 图标 + 标题 ·节奏 同一行、下一行单行说明、右侧「默认关闭」。客户端不再从技能步骤、方法文档或例行任务指令里截取文字,不再有展开/手风琴;没有工具或例行任务的包整块隐藏。现行落点:DESIGN.md §14.4(已删「展开预览」一句)、docs/product-rules/bot-market-native.md。

  • 10-16 Bot Market 详情页改为纵向四模块、吸顶主操作,并登记详情入场错峰为窄例外——用户批准设计稿:「一起工作的方式」不用 Tab,改为技能 → 知识与记忆 → 工作工具 → 例行任务四个纵向模块,每块展示包内真实字段(技能的操作顺序、方法参考正文与开场会了解的偏好、插件名称/说明/安装状态、例行任务的人话节奏与任务说明);条目卡 12px 容器圆角 + Board 描边,长内容预览 3 行渐隐,「展开」上限 320px,同模块手风琴。大头像滚出可视区后,顶栏淡入小头像、名称与紧凑主按钮(与身份区按钮共用 busy 状态)。详情打开时身份区、能力带与各模块依次淡入并上移 6px,相邻错峰 30ms、最多 6 段(--motion-base / --motion-ease-out,减弱动态效果直落终态)——现行规范只允许 composer 容器 ≤20ms 逐行错峰,这是用户批准的窄例外,登记为 DESIGN.md §14.4 第八类,范围只限此详情页,不推广到列表、其他弹窗或页面。加载占位 300ms 后才出现、静态无 shimmer。正文类文字用 --text-secondary-mid(Cindy Light/Dark 实测 5.25 / 9.16),不用 --text-secondary(3.5 / 3.3,对正文太淡)。例行任务展示的是包内示例节奏,不带时区;用户的真实时区、时间与启用在开场设置里确认。同日第二轮:展开/收起是带 ChevronDown 的安静文字按钮(热区 ≥28px,展开时图标旋转 180°,--motion-fast);节奏用当前语言说不出来就隐藏该行;插件说明只取第一个分句、单行;开场技能与脚本/模板计数不显示;步骤、知识与例行任务文字统一做维护者措辞的句级过滤。

  • 10-15 Bot Market 详情开场气泡使用带尾巴样式(仅此一处)——用户裁决:详情页身份区下方的开场白是伙伴发给用户的话,做成 IM 常见的圆角气泡,左下角带一个同色弯曲小尾巴(CSS/SVG,颜色走 --surface(比弹窗底低一档,两种模式都可见),悬停与键盘焦点走 --surface-chip,Light/Dark 同源)。气泡本体 12px 容器圆角、左下角收直角与尾巴相接;不带头像,也不再显示详情头部的一句话副标题(列表页保留)。这是 DESIGN.md §5 Step 1 已登记形状之外的内容形状,登记范围只限 BotMarketDialog 的这一处气泡,不推广到聊天消息或其它气泡;桌面没有“对方消息气泡”色 token(助手消息是无底正文,--msg-user-* 是用户自己的气泡),蓝色气泡需新增 token,等用户确认再议。

  • 10-13 伙伴私聊与群聊顶栏对齐任务详情:系统返回、两个独立圆钮、渐隐模糊底——用户指出这两个聊天页的返回按钮、右上两个图标的粗细、以及顶栏下方的“分割线”都和任务详情不同。身份区按用户裁决保持靠左;返回改为与任务详情相同的系统箭头。右上待办、设置一度被合进一个玻璃胶囊并换成系统图标,用户否决:保留两个独立圆钮和原有图标,只把线宽从约 1.5pt 调到约 1.65pt。所谓分割线并不是画出来的线,而是顶栏底色不透明:私聊用实色底盖住了任务页同款的渐隐模糊,群聊顶栏与消息区上下分开,消息在顶栏下沿被直接切断。现在 iOS 上两者都浮在任务页同款的渐隐模糊上,消息从下面滚过。删除了从未接入的 CompanionBackButton。同日追加:用户截图指出聊天页模糊开始得太高,名字下方副标题旁的消息文字仍清晰可见。原因是通用模糊从顶栏下沿往上 24pt 开始变淡,而聊天顶栏是两行身份信息,副标题正落在变淡段。聊天顶栏改为整段保持完全模糊,只在下沿以外 16pt 内渐隐;任务页和首页的单行顶栏不变。同日再追加:用户认为设置页(系统柔和滚动边缘)的过渡更柔和。差别在于自绘顶栏只有一层固定强度的模糊,靠透明度淡出,过渡区里清楚的字和模糊的影子叠在一起;系统效果是模糊程度本身逐渐减弱。iOS 所有页面的顶栏模糊改为三层等强度模糊叠加,逐层提前淡出,形成渐进效果,外侧渐隐从 16pt 拉长到 24pt;底部输入框的模糊不变。

  • 10-13 任务/伙伴滑动改用临界阻尼弹簧,顶部模糊固定不随页面滑动——review 发现两处问题:一是原 250ms 先慢后快再慢的曲线,在快速反向切换时会从零开始慢起步,剩余距离很短时也要重走整段时长;二是模糊背景跟着页面一起滑动,离开的一页立刻失去模糊,滑动途中顶部半边模糊、半边清晰。现改用不回弹的临界阻尼弹簧,并作为移动端例外登记在 DESIGN.md §14.4;模糊由 HomeModePanes 在滑动层外统一绘制一层。滑动进度只保留 ResidentHomeListProvider 这一处来源,左右两页与宽屏任务列表使用同一滑动距离。

  • 10-13 任务/伙伴作为左右页签滑动切换,菜单提示点收口为 6pt——用户指出直接切换缺乏左右 tab 的方向感,且标题下拉选择也应同样转场。所有入口由 HomeModePanes 统一横向滑动,任务在左、伙伴在右;保留列表状态、快速反向及减弱动态效果降级。用户截图中的大黑点来自 iOS header 将空 Badge 作为文字徽章创建;改用固定 6pt 圆点的模板图,普通、Duo 和 Android 伙伴入口统一可见点尺寸,计数徽章保持原有角色。现行依据见 DESIGN.md §5。

  • 10-13 iOS 两个首页共用导航组件,伙伴标题允许独立对齐——用户指出任务、伙伴菜单按钮与顶部高度不一致,并要求真正复用组件。批准首批改造时明确伙伴标题可与任务采用不同对齐规则。两个首页共用 HomeStackHeader,任务长名称避让与伙伴居中分别由标题内容负责;伙伴新建使用系统工具栏,隐藏首页不注册导航项,保留抽屉、未读提示与创建语义。现行规则见 DESIGN.md §5 与 Mobile 设计指南。首批只覆盖 iOS 两个首页,其他页面后续处理;不代表实机视觉验收通过。

  • 10-13 手机端自动化组展开箭头移到标题后——用户反馈手机首页 / 设备页的定时任务分组展开后,子任务看起来比上面的分组更靠左,层级容易误读。原因是组行把展开箭头放在行首,箭头列把组行图标与标题推右约 30pt(标题 94pt),而子行只比普通行多缩进 16pt(标题 80pt)。现行:箭头紧跟组行标题(与桌面 AutomationSessionGroupItem 一致),仍是独立热区;组行图标 / 标题与同级普通任务对齐(项目内标题 64pt),子行比组行深一档,「查看全部 N 次运行」继续对齐子行文字。被取代:行首箭头(与项目组行首 chevron 对齐的旧做法)。落点:apps/mobile/src/session/HomeSurface.tsx 的 sessionGroupChevronCell。

  • 10-09 伙伴设备导航热区收缩(#5648)——侧栏与伙伴详情顶部的设备触发器随名称收缩,保留 24px 高度,侧栏其余区域仍打开聊天。设备列表需要同时显示名称、离线与未读状态,因此仅这两处采用独立的 256px 列表宽度并受窗口可用宽度约束;普通表单 Select 继续与触发器等宽。顶部长名称上限 176px,保留截断和完整 title。现行规则:DESIGN.md §4 Select & Dropdown;实现:CindyDevicePicker / CindyDeviceRow;验证:生产组件浏览器夹具的浅深、宽窄、点击边界与键盘场景。该验证不代表 Electron 实机或真实跨设备验收。

  • 10-04 Desktop 弹窗外框统一:遮罩加背景模糊、面板同一套外观——用户要求检查全部弹窗(含手写弹窗),「统一都加背景模糊,Windows 不需要」,目标是「所有弹窗的样式、规则都一致」。盘点到 67 个带遮罩的弹窗(61 个 Radix + 6 个手写):遮罩有 8 种写法(6 处色板写死、4 处内联、插件外链确认完全透明;只有飞书冲突弹窗与浏览器标签页崩溃提示带模糊);64 个居中面板有 24 种外观组合——6 种底色写法(--confirm-bg、--surface-elevated、带毛玻璃的 --cmd-palette-bg、--surface、两种设置卡片色)、8 / 12 / 14 / 16 / 18px 圆角、描边有无不一,规范要求的 --confirm-shadow 写成了不生效的 shadow-[var(--confirm-shadow)],实际几乎都没有阴影。现行:遮罩一律 .modal-scrim(--overlay-modal + 4px 背景模糊,Windows 不模糊,与菜单毛玻璃的 Windows 口径一致),面板一律 .modal-panel(12px、--confirm-bg、1px Board 描边,阴影与下拉菜单同一个登记浮层阴影 --shadow-menu——初稿按 §6 定为无阴影,用户在 Design Lab 看过后改判「这个弹框应该也要加和下拉菜单一样的阴影」,取代 §4 原写的 --confirm-shadow;伙伴界面的零阴影约束只管页内表面,伙伴弹窗同样用这个面板);手写弹窗(Mermaid 源码编辑、新建 Worker、添加供应商向导、自定义供应商表单、浏览器标签页崩溃提示、插件卡片外链确认)同样改用这两个类;Radix 侧边抽屉只共用遮罩。出现 / 消失动画同日统一(用户问「弹出框现在有出现动画吗」并指定参考 Fluid Functionalism 的 chat-message):原先只有约 20 个弹窗按 §14.4 淡入 + 缩放,47 个直接出现;现由两个共享类提供——面板淡入 + 上浮 8px + 0.96→1(--motion-enter / --motion-ease-out),消失只淡出(--motion-exit / --motion-ease-in),调用处的 animate-confirm-* 全部删去。保留:宽度、定位、内边距、层级与点遮罩不关闭的规则。不含:整窗退出提示、Diff 面板抽屉遮罩、媒体灯箱、登录品牌画布(§16)。落点:DESIGN §4 Dialog & Modal「Overlay / Container」;守护:modalSurfaceContract.test.ts(遮罩 / 面板必须用共享类且不得自带颜色、模糊、圆角、底色、描边、阴影,含 dark: 等变体)。Windows 未实机验收。

  • 10-04 输入框菜单与手写菜单接入共享下拉菜单外观——承接 10-03 与 09-30(#5272)「不含」的两类菜单。①输入框菜单(模型 / 权限 / + / 智能体选择、/ 与 @ 面板、伙伴群聊 @ 点名、设置搜索结果、模型配置浮层)保留各自外壳(MorphPopover 容器形变 §14.4 不变;/、@、伙伴 @、设置搜索的焦点继续留在输入框),只换用共享菜单的行零件:共享逻辑抽到 components/ui/menu-row.tsx(行文字、悬停 500、图标 1.5 → 2、宽度预留、整面板一块滑动高亮),attachMenuHighlight 新增可配置的「当前项」,让焦点留在输入框的列表按自己的当前序号驱动高亮。按 Design Lab Dropdown Menu v8 的建议实现,用户要求据此完成(原话「做完上面的任务」),逐项最终确认在草稿 PR 阶段进行:悬停色由 --model-item-hover 改为共享菜单的 --sidebar-item-hover(Cindy 浅 1.11 / 深 1.25:1,原 1.13 / 1.16:1);选中行「勾 + 500、不铺底」,适用于权限 / + / 智能体菜单;用户看过测试版后明确模型菜单是例外(原话「保持整行灰底,不要打钩;模型名保持加粗;面板是毛玻璃,这个地方特例」):选中模型行保留整行 --sidebar-item-hover 底色、不加勾,2026-08-13 裁决继续有效,面板仍用共享毛玻璃与滑动高亮;/ 与 @ 面板阴影由 --cmd-palette-shadow 改为登记阴影 --shadow-menu;MorphPopover 终态材质改为共享菜单的毛玻璃(--menu-panel-surface,Windows 实色);模型配置浮层 16px 圆角改为 12px 并修正无效的阴影写法。被取代:2026-07-22「三个输入框菜单行用 --model-item-hover 悬停与选中铺底」契约(模型菜单的选中铺底保留)。②手写或直接调用 Radix 的点击菜单改用共享组件:更新公告版本跳转(当前版本改为单选勾选行)、右侧面板「添加标签页」、发布到市场与编辑市场信息里的标签多选(CheckboxItem,勾选后菜单不关)。发布团队 / 可用范围选择器(TeamScopePicker.tsx)未接入任何界面,不在本次范围。行为不变,另外获得共享组件自带的方向键、Home / End、首字母跳转与关闭后焦点回到触发按钮。悬停打开的协同面板 Worker 列表 / 显示方式菜单与折叠侧栏的项目 / 对话面板若换成共享菜单会改变打开方式,本次不动,单列报告。落点:DESIGN §4「Composer dropdown rows」「Menu hover highlight」;守护:composerMenuHighlight.test.tsx、sharedMenuCallers.test.tsx、PlatformTagSelector.test.tsx、dropdownMenuHighlight.test.tsx。本条为方向与规则裁决;macOS 浅 / 深色用 Design Lab 真组件对比过,Windows 未实机验收。

  • 10-03 Desktop 下拉菜单调用方改回共享默认——承接 09-30(#5272)「明确不包含」中自带逐行底色的菜单:文件树 / 右侧栏页签 / 会话页签右键菜单、项目切换、自动化与运行记录、插件页与插件详情、技能市场、套餐、伙伴触发器、审查面板、iOS 模拟器、标题栏菜单按钮等调用方,删去行级 focus: / hover: / data-[state=open]: 底色、行圆角 / 字号 / 字色、面板圆角 / 底色 / 描边色 / 阴影覆盖(含无效的 shadow-[var(--shadow-menu)]、shadow-none 与内联 boxShadow: 'none')及分隔线颜色,改由共享面板与滑动高亮接管;自带淡红底的危险项改为 variant="danger"(灰底红字);原来不是红字的「删除自动化」与技能「卸载」也按用户确认改为危险项,伙伴分组计划菜单的分组标题删去字重与字色覆盖、回到共享 Label 默认。行内文字同样收口(用户确认「两类都改」):两行菜单的主标题(内置工具 / 插件作用范围、安卓设备、账号切换、伙伴添加成员)删去常驻 13px / 500,回到行默认 14px、悬停变 500;行内辅助说明(项目进行中数、成员说明、画质当前值、提交相对时间、副本路径、版本号及上述两行菜单的说明行)由 10–12px 与各自的灰统一为 text-12 leading-[1.33] text-[var(--cmd-palette-item-meta)],与共享快捷键、侧栏菜单一致。按键标签(审查提交快捷键)与面板底部的说明段落不在此列。用户确认:行高统一为共享默认 32px / 14px,原 28px / 13px 的紧凑右键菜单与 36–40px 的加高菜单都不留例外(原话「都可以统一」);标题栏菜单按钮不再用 bg-titlebar / titlebar-button-hover,改用共享菜单配色。保留:宽度、定位、层级,DESIGN §5 允许的 6–8px 面板内边距,以及有状态含义的字色字重(当前项加粗、被拒设备灰字、脱敏 Key 等宽灰字)。不含:输入框内模型 / 权限 / + 菜单(MorphPopover)、手写菜单(FileBodyView、FileTabsBar、UpdateNoticeDialog)、Select、弹窗与 Popover。实测(dev 实例,Cindy 浅 / 深):旧悬停与面板 1.02–1.14:1(深色多处悬停色比面板更暗),新灰高亮 1.12(浅)/ 1.28–1.31:1(深)。落点:DESIGN §4 Select & Dropdown;守护:dropdownMenuHighlight.test.tsx、IOSSimulatorTabBody.test.tsx。macOS 实机看过浅深两种模式,Windows 未实机验收。

  • 10-02 手机端任务标签同样紧跟标题——勘误 09-28 条目「手机端原本已在标题后常显,不变」:手机首页/设备任务列表的色球虽在代码顺序上排在标题后,但标题占满整行剩余宽度,色球实际被挤到行尾、贴着来源与时间;iPhone 横屏/折叠屏系统标题栏分支未传入标签,色球不显示。现行:列表行标题与色球成组,标题只取文字宽度、过长截断,色球紧跟标题,来源与时间仍靠右;横屏/折叠屏标题栏与竖屏一致在标题后显示色球、点击打开任务详情。竖屏原生标题栏与安卓标题栏原本已紧跟标题,不变。落点:apps/mobile/src/session/HomeSurface.tsx、HomeListVisuals.tsx、app/sessions/[sessionId].tsx,守护测试 homeDesktopFirst.test.ts、sessionHeaderDesktopFirst.test.ts。本条为方向裁决,不代表实机视觉验收。

  • 10-01 所有模态弹窗点遮罩都不关闭——用户在「复制到本机」弹窗上发现点窗口外部会直接关掉,要求这类窗口一律不因点外部而关闭,并排查全项目同类问题。原规则(09-24)只覆盖带「取消」的表单类弹窗,说明型提示仍允许点背景关闭。现行:表单、向导、确认、进度 / 复制、更新说明等说明型提示,桌面与手机端都只能用自身按钮(取消 / 主操作 / ×)或 Esc(安卓返回键)关闭。本次补齐任务复制弹窗、更新说明弹窗、插件外链确认框与手机端「访问已撤销」提示;同日用户确认插件卡片的提示词输入浮层(锚在按钮下方、无遮罩外观)也改为点外部不收起,避免误点丢掉已输入的文字。图片 / 视频等查看器、普通弹出菜单、侧滑面板与手机底部浮窗保留点外部关闭。旧数据迁移失败整屏页(无按钮、点任意处继续)维持现状。Cindy Make 前置准备弹窗的「点遮罩先弹确认」例外(09-20)不变。落点:DESIGN.md §4 Dialog & Modal 的 Closing affordance;dialogScrimDismissal.test.ts 静态守护所有 Radix Dialog.Content,TaskMigrationDialog.test.tsx 覆盖行为。本条为规则裁决,不代表实机视觉验收。

2026-09

  • 09-30 移动端列表展开 / 收起改为 iOS 节奏——用户要求任务列表及同类列表从折叠到展开的过程「丝滑、符合 iOS 节奏」,并明确箭头不需要动画。排查发现原有的 150ms 折叠动画(RN LayoutAnimation)在本 App 里从未生效:Reanimated 接管了 Fabric 挂载层,分组实际是一帧跳变(模拟器录屏逐帧确认)。现行:改用 Reanimated 布局动画,仅在过渡窗口内挂上;列表行的位置与高度以 225ms 二次缓出变化(约 150ms 完成九成位移,无回弹;同日用户要求把首版 450ms 加快一倍),行裁剪内容,新行由变高的分组从标题下逐步露出,下方的行同步下移;收起反向合上,被移除的行临近结束才淡掉;箭头仍直接切换。覆盖首页置顶 / 共享 / 项目 / 对话分组、首页与设备页的自动化组;同日用户要求把设置页的调试分组与任务行的归档 / 置顶移位也接上同一套过渡(被移走的行保持可见、被下方上移的行盖住后淡掉;原来这两处用的旧写法同样从未生效),旧的 configureCollapseAnimation 随之删除。录音胶囊(红点 + 计时)展开 / 收回原先也依赖同样失效的 LayoutAnimation,一直是跳变;改为 Reanimated 直接驱动语音按钮外框与工具排占位的宽度,参数不变(motionDuration.base + motionEasing.move,仍在 §14.4 登记的 ≤240ms 窄变体内)。同日被取代:箭头随动画旋转与新行淡入的首版方案。同日用户反馈触发有卡顿,实测点击到开始动需要 250–390ms:开关放在页面状态、点击后整页重渲染一遍再等一帧才执行。改为开关只在包住列表的一层里切换、分组块内的逐行只在嵌套分组切换时登记、手指按下即提前准备,降到约 45–80ms(开发构建实测);动画常驻、用 UI 线程开关控制的做法会在滚动位置恢复后把行画错位置,已放弃。控制器逻辑独立成纯模块并有单测,「减弱动态效果」偏好未查到(null)时按不播处理。桌面 base 200ms 不变,本条只是移动端例外。落点:DESIGN.md §14.4、apps/mobile/src/theme/tokens.ts 的 listDisclosureMotion、apps/mobile/src/session/listDisclosureTransition.tsx。模拟器录屏已确认置顶组与项目组的展开 / 收起过程,实机手感待用户验收。

  • 09-29 移动端新建按钮形变登记为动效例外——用户确认保留侧栏抽屉导航与首页悬浮新建按钮:按下即原位拉长成等高输入框药丸,带一次可见的 iOS 式回弹(刚度 305、阻尼比 0.67);手动点药丸再向上展开成卡片(临界阻尼、无回弹)后聚焦。登记为 DESIGN.md §14.4 第七类动效例外,仅限该按钮与药丸,减弱动态效果时直接到位。方向授权不代表真机帧率验收。

  • 09-28 任务标签改为紧跟标题常显——用户要求任务标签不再作为「任务信息」里可选的显示项,而是跟在任务标题后面必然显示。桌面侧栏移除「任务信息 → 标签」复选项;文字版、列表版色球由行尾信息槽移到标题之后,置顶卡片版由底部信息行移到标题首行之后。聊天标题栏与手机端原本已在标题后常显,不变。同日用户指出悬停任务时色球「变大、描边消失」:根因是悬停把外圈改为半透明的 sidebar-item-hover,透出色球本色;改为悬停不换外圈色,选中与当前任务仍跟随不透明行底。被取代:09 月「标签」与时间并列、默认勾选并留在行尾信息槽的处理。现行行为见 docs/product-rules/task-tags.md;本条为方向裁决,不代表实机视觉验收。

  • 09-27 移动端主菜单账号层级与抽屉层次——用户要求姓名放大、默认头像取代公司大 Logo、公司 Logo 缩为小图标、不展示 ID;左侧菜单滑出更流畅,右侧有圆角和适当阴影。账号头以用户姓名为主,邮箱与组织信息为辅;仅首页主菜单抽屉(含伙伴入口)登记柔和投影例外,取代该处零阴影要求,不扩展到页面卡片与任务列表侧栏。落点:DESIGN.md §6、mobile-design-guide.md §1、HomeChromeDrawer.tsx 与 homeDrawerShadow 色板 token。方向授权不代表实机视觉验收。

  • 09-27 字重 / 字号 / 行高规则复核补丁——整体复核后补齐遗漏并澄清三条口径:chip 底上的徽标与字母标记可用 600(按图形元素处理,不受「浅色字不配粗字重」限制);文字需与相邻图标、按钮或行内正文对齐时,行高跟随被对齐对象(对齐例外);只有单行输入框不设行高,多行编辑区可配标准行高。同时补齐:iOS 对话输入框占位字改用 textPlaceholder;队友主页顶栏标题与「所有任务」一致(20 · 600);远程任务建议空状态标题、浏览器菜单标题、伙伴邀请等待页标题改为 600;伙伴变体里的二级色类别标签改为 500;计划正文由 12 改为 13;11 处独立段落的非标准行高回到标准配对。本条为规则裁决,不代表实机视觉验收。

  • 09-27 移动端文字行高补齐并按字号成对——字号收拢后单独一轮处理行高。约 330 处没配行高的文字样式(含 30 处内联样式)按标准配对补齐:11/16、12/18、13/18、15/20、16/22、17/26、18/26、20/25、24/30、30/36、40/44;20 号标题统一回 20/25(原 19 号并入的首页顶栏标题 27、弹窗标题 26),删除不再使用的 27 行高(listTitleCompact)。保留的登记场景:首页列表与队友行节奏值、代码 / diff 紧凑行高、对话流 Markdown 标题、长文阅读 24。输入框不设行高(iOS 占位字与光标会偏位),登录画布不动。新增守护测试:设了字号的文字样式必须同时设行高。落点:apps/mobile/src/theme/tokens.ts、typographyTokenDiscipline.test.ts、mobile-design-guide.md §3。本条为规则裁决,不代表实机视觉验收。

  • 09-27 移动端字号收拢为 11 档,按角色选字号——字重、字色收拢后,用户确认按角色表收拢字号:删除 14(listBody,21 处并入 15)与 19(listTitle,3 处并入 20,含首页顶栏「所有任务」);原 15 号 code 更名为 bodySmall(次级正文与等宽代码共用);12 号只留给短元数据,约 85 处成句的说明、提示、报错与分组小标签由 12 改为 13。现行阶梯 11 / 12 / 13 / 15 / 16 / 17 / 18 / 20 / 24 / 30 / 40。行高补齐单独一轮处理,本轮不改行高(原 19 号标题暂沿用 27 行高)。落点:apps/mobile/src/theme/tokens.ts、themeTokens.test.ts、mobile-design-guide.md §3。本条为规则裁决,不代表实机视觉验收。

  • 09-27 移动端中性字色收拢为五档,占位字单列——用户要求整理移动端全部字色并判断是否过多。结论:主界面收拢为正文、二级、三级、占位字、反色字五档;新增占位字专用 textPlaceholder(浅色 #858581、深色 #757575,页面 / 卡片 / chip 上 ≥ 3:1,是低于三档文字 4.5:1 的登记例外,只用于输入框占位字与同源的语音态提示),三级色不再兼任占位字;删除与正文同值的 sheetActionText(改用 textPrimary);3 处把页面底色 surface 当字色的深底按钮改用 ctaText;共享任务危险按钮文字由 #fffefa / #272727 并入 #FFFFFF / #121212(红底上 6.3 / 8.5:1)。同日设置页行标题改为正文色 500、16pt,取值退为二级色,说明文字 13pt;新建任务页选择器文字改为二级色。登录页自带的灰阶暂不动,另行评估。落点:apps/mobile/src/theme/tokens.ts、themeTokens.test.ts、DESIGN.md §15.13、mobile-design-guide.md §2 / §8。本条为规则裁决,不代表实机视觉验收。

  • 09-26 移动端文字按角色选字重,浮层卡两模式都不透明——象牙白色板定稿后,用户确认按角色搭配字重与字色:页面 / 导航 / 弹窗 / 面板标题 600,列表行、选项、卡片标题、按钮文字 500(首页任务标题由 600 改为 500),正文与说明 400,时间 / 元数据 / 占位字 400,分组小标签与徽标 600;浅色字不配粗字重(三级色只配 400,分组小标签除外;二级色只配 400 / 500),同字号内的主次与选中态靠颜色区分。被取代:移动端「默认 500、600 仅限大写微标签」的旧口径。同日把深色浮层卡 surfaceGlassPanel 由 rgba(36,36,36,.95) 改为不透明 #242424,与浅色 #FFFFFC 一致。落点:mobile-design-guide.md §3、DESIGN.md 排版节、apps/mobile/src/theme/tokens.ts 与各屏样式。同日用户把移动端浅色正文近黑由 #1A1A1A 加深到 #0F0F0F(页面上 16.5 → 18.2:1),cta、homeListFab、sheetActionText、errorText 随正文一起变;深色不变,桌面 #262626 不变。本条为规则裁决,不代表实机视觉验收。

  • 09-26 移动端色板独立并改为「象牙白 / 中性近黑」,加入显示模式设置——用户 09-25 确认移动端设计规范与组件可与桌面解耦(共享品牌与业务语义、自定色阶与对比度,要求更高对比度);09-26 在 Design Lab 对比多版方案后定稿,并要求设置里提供跟随系统 / 浅色 / 深色。被取代:2026-07-18「双端色彩同构」基线与 2026-08 待办的移动端同步、移动端浅色边框例外 #C6C9CE、U2 在移动端的适用(二级文字 #8C8E94 / #6F6F6F 比三级更浅且仅 2.8 / 2.9:1)。现行:浅色页面 #F9F9F6(用户指定;比桌面 #F2F2ED 更亮,暖度 B = R−3)、卡片 #FFFFFC、正文 #1A1A1A、二级 #4D4D4A、三级 #686864;深色页面 #121212、卡片 #1E1E1E、正文 #EDEDED、二级 #BDBDBD、三级 #999999;三档文字在所在底色上均 ≥ 4.5:1。近白页面只给浅色卡片留 1.05 的抬升(桌面 1.12),因此浅色浮起面以 1px border 分层,代码卡改为下沉 #F1F1EC。落点:DESIGN.md §15.13(§15.5 标注仅桌面)、apps/mobile/src/theme/tokens.ts、themeTokens.test.ts、theme-colors-snapshot.json、mobile-design-guide.md §2。各轮候选与对比保留在 Design Lab colors 专题。本条为方向与色值裁决,不代表实机视觉验收。

  • 09-26 用量历史每日柱图改用自绘悬停浮层——所有者看过原生 title 提示的截图后要求「重绘,要更好看、有设计感」。每日 token 柱图改用整张图共用的 UsageBarsTooltip:日期与大号总量、与柱段同色的占比条、按 token 降序的模型明细(色块、token、占比,最多 6 行)。深底白字与 12px 圆角沿用共享 Tooltip;色块与占比条沿用 usage-token-bar 的 2px 数据图元角,不新增形状登记。本条替代 DESIGN.md 对两张用量图「保留原生 tooltip」的要求中柱图部分,热力图仍用原生 title。现行规格见 usage-history-charts.md「每日柱图悬停浮层」;本条为需求授权记录,实机视觉验收待所有者完成。

  • 09-21 Cindy 设备选择器沿用未读语义色——Cindy 在多设备聚合后仍表示同一个任务的未读消息;侧栏设备行、设备选择器的入口/选项以及共享聊天头设备选择器沿用 --bot-unread-bg / --bot-unread-fg,与伙伴列表未读数量和待处理点保持一致。作用域扩展到 features/bots 的 Cindy 设备未读指示器,仍不用于连接状态、其它徽章或表面;两种模式保持同一蓝白配对,现行规范见 DESIGN.md §2、§10。

  • 09-21 Cindy Make 个人版左对齐并常显括号状态(后续修订)——用户指出个人版看起来没有与 main 左对齐,并要求名称后加括号描述状态。去掉标识底色与额外内边距,使图标从 main 行相同的左边界起排;显示“图标 + cindy-personal(已是最新/有更新/版本状态未确认)”,整组随状态着色,SHA 和修改数量仍在后面。取代同日仅在悬停时显示状态词的处理,现行规范见 DESIGN.md §2。

  • 09-21 Cindy Make 个人版状态图标前置、名称随状态着色(最终修订)——用户纠正合并后的样式,要求图标放最前,cindy-personal 名称按最新/不是最新显示颜色。标识只显示图标与名称,移除旁边重复的状态词;最新为绿色,有更新使用兼容明暗模式的更新提示色,未确认保持灰色。完整状态由悬停/键盘聚焦提示与无障碍名称承载。覆盖前两次同日布局,现行规范见 DESIGN.md §2。

  • 09-21 Cindy Make 个人版标题与状态合并(后续修订)——用户看过新增状态的实机截图后,要求与 cindy-personal 标题合并显示。标题和状态共用一个胶囊,排在 SHA 与个人修改数量之前;两行版本信息分别换行,避免合并后的标题撑宽 main 行的标题列。状态含义与配色沿用同日裁决;落点为 DESIGN.md §2 与 CindyMakeSourceDetails。

  • 09-21 Cindy Make 个人版增加醒目的线上版本状态——用户指出「已包含本地 main」不容易看出个人版是否跟上线上最新版本,要求一致和不一致都有状态。个人版 SHA 后显示带图标的状态胶囊:已包含线上全部更新为「已是最新」,确认缺少线上更新为「有更新」,查询失败或关系无法确认时为「版本状态未确认」;个人修改数量继续用次要文字显示。绿色使用 status-success,更新提示的图标使用 warning-fg、文字使用 text-primary 保证浅色模式可读,未知使用 text-secondary,底色复用 surface-chip。个人改动导致 SHA 不同不能判为落后,仅包含本地 main 也不能直接判为线上最新。落点为 DESIGN.md §2 与 CindyMakeSourceDetails;本条不代表实机视觉验收。

  • 09-20 Cindy Make 的 main 版本合为一行(后续修订)——用户要求本地 main 与线上 main 合并显示:相同 SHA 只显示一次并用绿色;不同时显示灰色本地 SHA → 绿色线上 SHA,保留提交差距。personal 独占下一行,继续显示其 SHA 与本地 main 的关系,取代此前三行排列。复用 text-secondary、text-tertiary、status-success,两种主题同样适用;落点为 DESIGN.md §2 与 CindyMakeSourceDetails。此条记录用户方向授权,不表示实机视觉验收。

  • 09-20 Cindy Make 合并上游概览布局——用户确认个人版源码、当前版本和切换入口合并到版本控制概览,保留该页创建入口;正常时显示实际版本差距,更新成功仅提示一次,进度及异常共用状态区域。前置弹窗保留右上角关闭与状态确认,继续制作按钮移到底部。版本对比颜色角色沿用语义 token,见 DESIGN.md §2;行为与回归见 docs/cindy-make-upstream.md。方向授权不等于实机视觉验收。

  • 09-20 Cindy Make 前置准备弹窗改用右上角关闭图标——用户指出准备结果下方单独一行「取消」显得奇怪,要求改为右上角关闭图标,并根据当前状态二次提示。仅此前置弹窗移除底部取消;关闭图标、Esc 和遮罩点击统一确认,实时说明环境/源码准备、上游查询与已结束状态下的关闭影响,创建任务期间禁止关闭。标题及关闭入口固定,报告单独滚动。现行落点:DESIGN.md §4 Dialog & Modal 的局部例外与 CindyMakePreflightDialog.test.tsx;这是方向授权,不代表实机视觉已验收。

  • 09-18 搜索命中层级(Issue #4650,用户授权实施):全局 Ctrl+F 普通与当前命中原本同色,且两模式底色与内容表面接近。增强普通命中,新增当前命中的独立金色背景与深色文字;全局保留下划线,文件预览与编辑器保留描边,统一消费搜索语义 token。旧 ID 与显式主题覆盖保留。方向授权不等于最终实机验收。落点:DESIGN.md §10、themes/colors.ts、颜色冻结快照与 searchHighlightContrast.test.ts。

  • 09-17(撤销 CINDY placeholder 降对比度):用户明确要求撤销提交 7bf645447cf9ae8feeffb781220d44aab79cde45。CINDY Light / Dark 的 text-placeholder 恢复为 #6B6B67 / #C1C1C1,DTCG 数值源、内置主题与独立冻结预期同步恢复;取代 09-16 降低占位文字显著程度的决定。09-16 原记录作为历史保留,Cindy Make 与后续 Switch 改动不受影响。现行规则见 DESIGN.md §4 / §15;本条不代表 Light/Dark 实机视觉验收。

  • 09-16(Switch 亮滑块与轻微形变):用户确认 HTML 并要求应用到当前 Cindy Switch。CINDY Dark 的开/关滑块统一为 #FCFCFC,开启轨道沿用蓝色 #417CDD;新增 switch-thumb-on,默认跟随旧 background,保留其他主题与用户覆盖。参考 Fluid Functionalism 后,用户认为压缩过大,将按压由 20×12 收敛到 18×14、悬停由 18×16 收敛到 17×16,静止仍为 16×16;沿用 Cindy 150ms 缓动和 80ms 轨道变色,无过冲、无阴影。共享 Desktop 组件支持拖动,保留 Radix 的 ref、checked/defaultChecked、键盘与表单回调;禁用与减少动态效果适配。规范见 DESIGN.md §14.4 / §15.17。本次为独立有意可见变化,DS-10 #4427 已合并,DS-11 #4455 的远端内容不在本次修改范围。

  • 09-15(CINDY 开关开启态改蓝):用户查看浅深模式 HTML 对比后明确要求「把开关打开状态改成蓝色 #417CDD 应用到 Cindy UI」。Desktop CINDY Light / Dark 的 switch-track-on 同为 #417CDD,取代 2026-08-05 的 Light #4A4D51 / Dark #EEEEEE。关闭轨道、滑块、禁用透明度、尺寸与焦点处理沿用既有合同;普通主操作保持中性,其他主题与 Mobile 不扩展。蓝色与光标、焦点、自动批准同色但不互相绑定。现行规范见 DESIGN.md §2 / §10 / §15.17;DTCG 主题源生成生产值,cindyDecisionData.ts 与内置主题快照独立锁定新预期。此裁决独立于仍待合并的 DS-10 / DS-11,不将旧截图或其验收结论当作本次改色的实机证据。

  • 09-12 IM 上下文卡片的轻量折叠入口(#4367,补记已确认方向):用户看过深浅 HTML 示意后确认统一所有 IM bot 的折叠分组与数字展示。本轮补齐组件登记:仅 HookTaskCard 的长正文和附带上下文开关使用无背景、无边框的文字控件;不将其他聊天操作豁免为裸文字按钮。两处共用点击留白与独立键盘焦点处理,分组不套背景框;规范落点为 DESIGN.md §4。本条记录既有需求与展示方向,不表示真实客户端双模式或真实 IM 端到端已经验收。

  • 09-12 侧栏整理菜单收为子菜单——用户逐轮确认 HTML 后授权实施:一级为分组、任务排序、项目排序、任务状态、筛选、显示、任务信息,右侧均显示当前选择。任务排序直接并列优先级、最近活动、创建时间;优先级列首不改变默认值。筛选维度名为 Harness,补 Pi;任务状态独立于内容筛选的计数和重置。所有菜单行配图标,分组入口按真实侧栏的组标题与缩进任务行绘制,取代网格及 FolderTree 候选。替代旧菜单的平铺区块、嵌套时间排序及部分行刻意无图标的处理。现行行为见 docs/product-rules/sidebar-redesign-plan.md §3,实现为 SidebarFilterPopover.tsx;本条记录设计批准,不代表客户端实机验收通过。

  • 09-09 用量历史 pi 标记改为青绿——所有者试用后认为 Codex 蓝色与 pi 紫色不易区分,指定 pi 改用青绿。仅用量历史 harness 表的 pi 三处标记改为 --usage-model-1,随 Light/Dark 使用已有青绿值;Claude 陶土橙和 Codex 蓝色保留。替代本日上一条 pi 紫色选择,不修改全局 --engine-badge-pi 或模型配色。

  • 09-09 用量历史 harness 改用已有引擎身份色——所有者要求 Claude 品牌偏橙、Codex 蓝色,pi 可自选但不用红色。替代本日早先的青绿 / 靛蓝 / 琥珀方案:复用 --engine-badge-cc / --engine-badge-codex / --engine-badge-pi,分别为陶土橙 / 蓝 / 紫;三种标记位置同步,沿用这些身份 Token 的 Light/Dark 固定值合同。仅扩展这些既有 Token 在用量历史 Agent/harness 表中的消费范围,不改 Token 值、模型配色或其他功能。当前规则见 usage-history-charts.md。

  • 09-09 用量历史:Agent 分类上色,模型配色取消前五名上限——所有者根据真实用量截图要求 Agent/harness 区块有颜色,且无论模型数量多少都能分配颜色。Agent 顶部占比条、行前色块和行内占比条固定对应青绿 / 靛蓝 / 琥珀;模型沿用现有五个主题色作为种子,为后续模型派生色相。完整历史模型统一登记,切换筛选不跳色,历史用量排名更新可重新分配;模型表与柱图片段保持一致,不再把第六名起的真实模型全部染灰。派生公式与当前范围见 usage-history-charts.md,数值来源仍为 colors.ts 的既有 Token,动态计算留在 usageHistoryColors.ts(治理合同 §3.4)。大量模型可能颜色近似,不承诺无限可辨识颜色;名称和 tooltip 保留。本次只优化分类颜色,不改日期筛选、几何、热力图蓝色、动效或统计口径,不扩张首页金额与任务表配色。本条为需求授权记录,不表示视觉验收已通过。

  • 09-08 DS-6 表单五项裁决(用户已采纳):输入焦点环按 soft/50% 实施,实际亮暗/错误/旧主题可辨识度仍须验收;保留 elevated 默认及有明确白面板用途的 ivory。普通确认复用标准按钮但保留中性反相/轮廓主次、排列、默认取消焦点和显式/typed 分支,不整体改为 CTA、不迁授权。必填/格式错误移到字段并定位首错,服务失败仍 Toast;真正保存时防重复并禁止关闭,成功关闭、失败恢复,独立连接测试/模型获取不被锁住。取代治理 §10 对这三组视觉项的 pending,以及 §4 对 ivory 暂留/焦点偏差和普通确认焦点的旧描述。业务规则、payload、凭证和配置语义不变。落点:DESIGN.md §4、治理 §10、真实 provider/MCP 表单;工程/证据/G2 状态分别见 证据索引,批准不等于验证通过。

  • 09-08 手机版操作菜单图标统一为 18 pt——用户对照现有手机版菜单后确认「好的,统一一下,并且作为以后的规范」。消息、任务、文件操作菜单以 iconSize.lg = 18、iconStroke.regular = 2 为基线;原生菜单资源按 18 / 36 / 54 px 输出,保留桌面同名 Lucide 的 24-unit viewBox 与笔画几何。替代本次恢复图标时误选的 24 pt,以及尚未实施的 20 pt 建议。既有紧凑筛选/导航菜单的 16 档、工具栏/lightbox 的 20 档保留各自用途,不全局改尺寸。落点:DESIGN.md §15.13 Iconography 与消息菜单资源尺寸校验;本条记录规范裁决,不代表用户已验收最终画面。

  • 09-08 同一操作的双端图标必须完全一致——用户在手机版消息菜单图标恢复过程中明确要求「图标需要和桌面版的完全一致。这个设计原则你也要记录一下」。裁决:同一操作复用相同来源的图形与笔画几何,Lucide 使用同名 glyph,不以语义相近的 SF Symbols 替代;尺寸可适配平台,颜色继续走 Light/Dark 语义 token。消息菜单对应 MessageSquarePlus / Link2 / Undo2 / Trash2。本条替代原先只要求普通图标「语义等价」的宽松口径,落点为 DESIGN.md §15.13 Iconography;记录裁决不代表实现或实机验收已完成。

  • 09-07 圆角体系改为「可见层 + 登记驱动」,新增 data mark 类目—— 决策依据: 项目所有者授权本轮采用独立评审定案;条款由 AI 整理。授权记录:项目所有者 kirozeng 以 PR #4072 作者身份提交并全程推进本裁决(PR 描述载明「按所有者已定案方案;所有者 2026-09-07 圆角裁决」);2026-09-08 所有者指示补记本条并解除全部合并阻塞。PR 作者身份、描述原文与所有者本人执行的合并操作互为可核验佐证。本条确定规范目标,不表示实现已完成或视觉验收已通过。 背景:同一缺陷两次发作。 ①PR #3802(09-03 合入)给用量历史热力图与每日 token 柱图加日期点击,为可点击把图元包成 <button>;自动 review 据 §5「every button is a pill」连提两轮 P1,作者依次给外层按钮、再给实际可见的彩色内层加 rounded-full,方格变圆点、柱变胶囊;另一条 24×24 命中区 P2 促使热力图 cellSize 12→24、柱图容器最小宽度撑到 807px 并横向滚动。#3802 记录了筛选与点击的手工验证,但缺少可复核的完整视觉验收证据,不能据此推断无人看过界面。②PR #4001(09-06 合入)将快捷键外框登记为 4px 特例,但保留了与之冲突的「三档且仅此三档」和「唯一豁免」措辞。 根因不是这两个组件,是 §5 的分类锚点。 旧条文没有明确区分动作外框与其内部图元;在 #3802 的两轮审查中,review bot 将 <button> 标签作为套用 pill 的充分依据,并进一步要求实际可见的图元服从该半径。规则虽保留申请批准例外的路径,但默认分类缺少数据图元的明确分流,因而把新增交互引向形状变化。 裁决:

    1. 判定对象改为「可见层」(某一层框 / 表面 / 裁剪轮廓),不是 DOM 标签也不是整个组件。父层半径不作为其内含层的归档依据;容器已批准的内容裁剪继续有效,但交互包装层不得用自身几何替换内含图元的登记几何。
    2. 两步判定树,登记优先:Step 1 已登记形状(keycap / data mark)→ Step 2 控件三档。§5 为半径归档的唯一权威,§§1/4/7/9 与组件条目只引用、不另立归档规则。
    3. 新增 data mark 类目,取值 0px 或 2px,按成员钉死,调用方无可选项。首批四个成员均为四角 2px:usage-heatmap-day、usage-token-bar、workflow-status-cell、system-category-square。0px 保留为可登记值,本批未使用。登记单位是稳定的可见角色 ID + 明确作用层,不是文件名或整个组件子树;语义不变的重构只更新引用,扩大用途或改变几何才重新裁决。
    4. 三条判据降为登记申请时的举证要求,不作为作者自助分类的准入门。评审反例证明其无法稳定划界:数据筛剩一条时「同构成组」失效、给 aria-label 补动作说明反而使图元掉出类目、日期选择器与灰度强度选项三条全中。
    5. 区分「普通控件表面」与「独立焦点指示」:无框可圆的层无需归档,但控件不得靠省略填充/边框摆脱其规定的框处理;hover / pressed 的临时表面仍是该控件的框、取其档位。焦点或选中指示是独立视觉处理,其出现本身不创建普通控件框、不重新归类关联层——已登记的裸文本按钮保持无框并保留可见焦点处理。判定须跨状态评估已批准的组件处理(含共享样式与伪元素);局部没有 bg/border 类不构成无框证据。
    6. 交互不改变归类:命中判定与图元几何是两项独立职责,可共用同一 DOM 元素或绘制图元,不要求额外包装层;命中几何不得替换、裁剪或扭曲图元的登记几何与数据映射。指示器可画在既有元素、伪元素、浮层或绘制表面上,但不得改变图元登记几何与数据编码。承载数据的层上,hover 不得改动编码数据的视觉映射。同一数据与显示配置下,登记图元的几何与角处理不得仅因交互启用/停用而改变;独立的 hover / focus / 选中指示允许存在。
    7. 命中尺寸:采用 Equivalent 路径。 用量历史同页补足覆盖全部可选日期、产生相同单日筛选结果的合规日期选择控件,与密集图表恢复同 PR 交付。现有相对时间范围预设不足以替代任意单日选择;在等价控件可用前,不以待办承诺缩小目标。不同日期的目标重叠不是合格的扩大手段。此次不批准 data mark 类目的 Essential 通用豁免。 键盘可达与可见焦点仍独立要求。
    8. 去绝对化:every button / the only exemption / Anything that triggers an action 改为「未命中 Step 1 的普通控件框」。保留「"it looks small" is never a reason to move a layer down a tier」但限定只在 Step 2 内生效。
    9. 补内容轮廓与未决分类出口:图像/图标等资产内部的像素与固有几何不是控件框,已有内容与裁剪规范按其组件规范执行,外围动作框单独归档;新的内容自有轮廓或混合对象须送裁决,评审报告分类未决、请求缺失决定,不得仅因可点击就强制归入 pill,也不得自行批准未登记例外。 两处实质范围变更,显式登记,不得默认推广:
    • 解除 non-interactive 限定:07-28 微格例外原文限定非交互;归入 data mark 后,状态微格将来可点仍为 2px。
    • ≤8px 不再是归类边界:尺寸不再作为该类归档依据。已有微格的实际尺寸与用途继续留在组件条目约束,这不是全局任意放大许可,也不推广到所有状态徽标。 边界说明(非放宽): 数值清单只穷尽受治理的角圆角,不穷尽可见几何;固有内容与图元几何在清单之外。 明确不改: keycap 4px 的值与适用对象(09-06 裁决)不重开,本次只整理其归属与优先级;控件三档的数值与常规用途不变。 每日 token 柱:四角统一 2px。 恢复 #3802 前柱体自身的 2px 全角处理;本次不采用上角 2px、基线两角 0,也不采用全 0。命中区与焦点/选中指示不得将柱体重新改为 pill。 实施状态:待迁移。 本 PR 仅修改规范与登记,不修改产品渲染。main 上 UsageHeatmap 的交互/非交互半径分支、UsageTokenBars 的 pill 柱体以及相关命中布局,作为已知待修差异在迁移台账对应条目记录负责人与后续 PR,本次不记为已合规。后续视觉修复一并落实登记形状、等价单日选择与密度处理,并交付实际视觉证据。该过渡记录不授权新增同类偏差。 注意热力图 3px → 2px 是本次新裁决的视觉调整、不是原样回退;只有柱体 2px 可称恢复——后续 PR 应命名为「按裁决修复图表形状与日期选择」,不得整体描述为纯回退。 落点: DESIGN.md §5(本节重写)、§1 line 19/21、§7 line 355/363/368、§9 line 418、§4 line 274;design-governance.md §13(同 PR)。
  • 09-07 设置分段选中态与用量数据图形修复(用户要求修复;图表方向选定“恢复方格和细柱”):分段选项误借页面级 chat-input-chip-bg,CINDY Dark 下选中 #1D1D1D 与卡底 #1F1F1F 几乎同色;统一复用 SettingsSegmentedControl,补完整 radio 键盘语义。用户后续选择原「浏览器自动化目标」效果:无外描边的 surface-chip 轨道,选中使用 surface-elevated 与 border-default 胶囊边框;链接打开方式与浏览器自动化目标采用同一组件。用量历史 #3802 将点击日期图形套成胶囊,并以 24px 最小列宽撑大图表;用户选定恢复紧凑方格和细柱、保留点击筛选及灰度配色。DESIGN.md §4/§5 登记数据图形例外,防止按“按钮胶囊”再次改变数据编码。此记录是修复方向裁决,不代表最终实机视觉已验收。

  • 09-08(同步本地优化供评审)——所有者获知 #4076 远端未包含最后一轮本地修改及命中尺寸缺口后,明确要求“同步上去”。据此同步热力格选中描边、七日范围强调、60% 柱体不透明度、最终排版(概览 16px/500)及移除新增日期入口;保留远端 779f9f47b 的颜色分类登记修复。本次授权为本地版本与 PR 同步,不作为 Equivalent 已满足、Essential 豁免或合并授权。替代此前仅限本地、待命中方案确定后再提交的交付时序;合入前仍须解决命中尺寸。测试按已批准的日期入口删除更新为两张图表的筛选路径,不以旧表单存在性作为当前功能要求,也不把行为测试当成命中尺寸合规证明。

  • 09-08 概览数值缩小至 16px——所有者反馈概览的 20px 数值太大,调整为 16px/500;替代本日排版预览中的概览数值档位,其余字号层级保持不变。当前为本地试用,未提交、未作视觉验收结论。

  • 09-08 用量历史排版对齐设置页面——所有者试用反馈“文字偏小”,授权优化整个用量历史页面的字号和字重。页面标题 16px/500、分区标题 14px/500、正文与表格 13px、辅助信息 12px、图表注释 11px、概览数值 20px/500;沿用 §3 既有 Token,长统计值允许换行。仅调整该页排版,不修改共享首页热力图的字号、筛选功能或全局字体设置。当前为未提交的本地预览,不表示人工视觉验收通过;具体层级见 usage-history-charts.md。

  • 09-08(选中反馈再调整)——所有者在实机试用后明确要求热力图选中时放大并带明暗主题描边、最近 7 天对应柱图高亮、选中超出 30 天的日期时柱图无选中,以及降低未选中柱的透明程度。据此仅热力图恢复独立的 1px 中性描边,与放大后的方格间隔 1px;柱图保持无框,非强调柱从 24% 调为 60% 不透明度。最近七个日历日(含今天与零值日)新增视觉范围强调,单日选中优先;图外日期没有柱选中,也不把整图淡化。范围强调不伪造七个 aria-pressed 单日选择、不同时放大七柱,不改统计筛选或固定图表窗口。这是对先前“不增加”边界的本次明确视觉联动授权,不推广为其他新功能;取消点击/范围选择功能均不添加。另按所有者明确选择,新增日期输入入口已移除,替代命中布局仍待裁决,当前密集布局仅供预览,不宣称原 Equivalent 条件已满足。最终视觉验收待所有者完成。

  • 09-08(撤回热力图品牌红试用)——所有者查看测试环境后明确要求“不好看,还是退回原来的蓝色吧”。恢复此前热力图蓝色色阶及 usage-heatmap-high 对进程蓝的引用,撤销本日前条热力图品牌红的用途许可与对应白名单增补。仅撤回本轮红色试用;柱图配色、交互与移除新增日期入口的改动保持原状。本条优先于紧邻的品牌红试用记录。

  • 09-08(热力图品牌红) 用量热力图改用 Cindy UI 品牌红色阶——所有者在测试环境要求“上面热力图的颜色能否用 Cindy 的品牌红色去做变色”。据此将 usage-heatmap-high 从进程蓝色别名改为 login-brand-accent 的品牌红别名,Light/Dark 共用已登记的 UI 品牌红,强度仍按四档与各模式底色混合;零值保持中性。替代本日早先热力图蓝色裁决,仅扩展这一已登记数据图元的配色用途,不新增形状或产品功能;柱图配色、日期窗口、选择行为、统计口径及命中布局不变。同步 §2/§10/§15.10/§16.1 与品牌红许可表,品牌色值本身不改,不借用错误状态色或修改标志资产。最终实机视觉验收仍待所有者完成。

  • 09-08(参考图微调) 用量柱图配色与无框选中反馈——所有者指出首版多色堆叠“有一点脏”,提供参考图 3 要求微调,并明确“选中之后不要外面有一个框,参考截图 4”。据此将五个 usage-model 角色由进程色别名改为专属青绿、珊瑚红、紫、靛蓝、琥珀 Light/Dark 配色,数值仅由 colors.ts 维护;热力图蓝色与原进程颜色不变。两图取消鼠标选中外框,保留轻弹和选中放大;柱图内存在选中日时,其他柱降为 24% 不透明度,选中柱与临时悬停/键盘聚焦柱保持全色,无选中日或日期在图外时不淡化。此限定调整替代本日早先“数据颜色交互呈现一概不变”及组件条目的选中细框处理;类别 Token、堆叠比例、柱高、基线和命中框不变,热力图强度不参与淡化。键盘 :focus-visible 仍保留独立可见提示,不将鼠标去框误用于无障碍焦点。没有新增图形成员或改变四角 2px。最后一行全空已核实来自隔离演示 fixture 每 7 天固定零值恰逢星期六;重采样时改为分散零值日,生产日期与零值算法不改,不把模拟数据问题描述为产品修复。方向授权不等于最终实机视觉批准,后者仍待所有者验收。

  • 09-08 用量历史采用蓝色热力图、多色模型柱图与悬停微弹——所有者在本轮选择卡明确选择“蓝色热力图+多色柱图(推荐)”和“悬停微弹,选中保持(推荐)”,作为 #4076 的后续设计裁决。热力图沿用强度映射,蓝色高值端;柱图前五模型用既有蓝/青/紫/绿/琥珀调色板,新图表用途通过 colors.ts 的 usage 专属别名登记,不改变原进程/状态语义;模型表色块与柱段对应,Agent/任务色保持中性。仅 usage-heatmap-day、usage-token-bar 登记悬停/焦点/选中的可见尺寸扩张:格子宽高各加 2px,柱体仅宽加 2px;基准形状、四角 2px、柱高、基线、数据颜色、堆叠比例及点击命中框不变。直接过渡宽/高,200ms 一次轻微回弹,150ms 退出;选中保持,减少动态效果时立即切换。本条明确替代 09-07 对这两个成员交互几何一概不变的限制,不推广给其他图元,亦不新增形状成员。§14.4 同步登记为独立于 Done 的窄范围回弹,§2/§10 登记颜色用途;具体交互规格见 usage-history-charts.md。等价日期选择与密度修复保留;设计方向已批准,最终实机视觉验收仍待所有者完成,不是 AI 自批截图。

  • 09-06 键盘快捷键外框统一使用 4px 圆角(用户裁决,PR #4001):所有可见快捷键外框,无论使用 <kbd> 还是承载快捷键的交互按钮,统一采用 rounded-[4px];边框、填充、内边距和文字颜色按所在表面保留上下文差异。该规则是圆角体系的注册例外,覆盖 08-29「4px 不入档」对键盘键帽的适用范围;DESIGN.md §5 与 design-governance.md §10 已同步回写。

  • 09-06 首页撤掉订阅与赠送余额告知大卡(拍板人 = 用户)——用户重申: 「我要求撤掉的……重新发个 pr,按我要求调整。」 首页改版最初提交 已撤掉两张卡,但后续评审 根据旧注释把移除判成 P1,随后恢复生产挂载并反向修改测试。 本次明确取代旧的「有模型仍须告知一次」要求:删除「已沿用本机订阅」与 「已为你开通 Cindy AI / 赠送余额到账」两张首页卡及其专用实现, 不迁成另一处自动告知。余额、有效期与订阅详情继续在既有设置入口查看, 不改变实际订阅继承、赠送发放或计费行为。 逐项核对原 PR 后续提交:失败建议 prompt 清理、日语错字、任务/工作目录措辞、 规范圆角和字号修正保留;建议数量、轮换、整块关闭与零模型登录流程未被另改方向。 现行落点:DESIGN.md §1.1、NewMakerDraftRoute.tsx。

  • 09-03 DS-4 Button / Input 规格缺口六项裁决(拍板人 = 用户/设计师)—— 背景:DESIGN.md §4 按钮 height ⚠ not yet specified,hover / pressed / 字号字重 / secondary token 归属 / SettingsTextInput ivory 底均未写死。本张把既有 PillButton / CtaPillButton / SettingsTextInput 升格进 components/ui/, 规格按下列裁决回写 §4(去掉 ⚠ not yet specified)。

    1. G1 高度:按钮双档 32/36px、输入框三档 32/36/40px,共用 4px 步进;按钮不设 40, 不为对称造无消费者的档。
    2. G2 hover:机制统一为换色 token,禁用透明度 hover。Cta 私有原型的 hover:opacity-90 换成 --accent-hover 是有意视觉变化。
    3. G3 pressed:进最低状态矩阵。 值的实现方式在 2026-09-04 self-review 后改过一轮:初版把 hover 记账成 既有 slot 的 alias(primary hover → --surface-hover、secondary pressed → --surface-chip),pressed 用字面量(#cfcfcd / #4a4a48 / #1a1a1a)。 复核发现两类问题:
      • 暗色状态不可区分(真实缺陷):暗色下 --surface-hover 与 --surface-chip 同值,default-dark / cindy-dark / one-dark-pro / monokai-pro 四个主题 primary 悬停零反馈;--surface-hover-soft 在 cindy-dark 距 --surface-elevated 仅 2/255,secondary 同样失效。违反 DESIGN.md §10 双模式交付门槛。
      • 字面量 pressed 不跟主题:monokai-pro 色板 #403E41,按下会跳到 无关的 #4a4a48。 改法与比例经用户 2026-09-04 补批(越界经过见下方 09-04 条):每一档从 本变体的 rest 底色朝本变体的前景色混色——hover 8%、pressed 自 hover 再 10%; cta hover 仍是 --accent-hover,另给组件名 --button-cta-hover 便于 DS-8 落回 semantic。11 个内置主题实测每档 ΔRGB ≥ 8。守卫 themes/__tests__/buttonStateContrast.test.ts。这五个派生值按治理合同 §3.4 只登记不进 DTCG 影子层。
    4. G4 字号字重:text-13 + font-medium(500),直接写进 §4。
    5. G5 secondary token:ui/button secondary 绑 Tier-1 (--surface-elevated + --border-default),不继承 --settings-btn-secondary-*。 同值性核查(默认 Light/Dark 快照):不同值——Light fill settings-btn-secondary-bg → --surface-chip-alt #e5e5e5 vs --surface-elevated #ffffff;Dark fill 同值 #2c2c2a。用户 2026-09-03 看对照图后裁决接受有意统一成白底(设置页这批灰药丸改成规范次级; 亮色从灰变白,暗色几乎不变)。2026-09-04 用户在隔离沙箱实机 (CINDY Light,设置通用 / 模型供应商)确认空心描边「可以,没问题」。
    6. G6 ivory:保留为显式 surface="ivory" variant,三处标登记债 (§4 / 台账 desktop.settings 下一动作 / 组件注释)。本张不翻案。 落点:DESIGN.md §4、components/ui/button.tsx、components/ui/input.tsx、 colors.ts button-* token、影子包 src/component/color.json。
  • 09-04 Button 状态梯改为派生,比例 hover 8% / pressed 10%(拍板人 = 用户/设计师)—— 取代 09-03 G2/G3 原本的「值从 --surface-hover 族现值取 / 用现有 chip-hover token 加深一档」。改法的动因是缺陷,比例是新裁决:

    • 照原指令实现后,--surface-hover 在暗色下与 --surface-chip 同值, default-dark / cindy-dark / one-dark-pro / monokai-pro 的 primary 悬停零反馈; --surface-hover-soft 在 cindy-dark 距 --surface-elevated 仅 2/255,secondary 同样失效。 字面量 pressed 则不跟主题(monokai-pro 色板 #403E41,按下会跳到无关的 #4a4a48)。
    • 定案:每档从本变体 rest 底色朝本变体前景色混色,hover 8%、pressed 自 hover 再 10%。 这与 G2 当初选换色 token 的理由同向——「能被主题 override,直接关系换风格只改颜料表」; 派生跟随任何主题覆盖,固定色号做不到。
    • 实机验证(CINDY Dark,即修复前坏得最厉害的主题):secondary rest #1F1F1F → hover 45,45,45 → pressed 62,62,62,悬停差值由 2 拉到 14。

    同时记下一次流程越界,供后续张次引用:计划 §5 要求「六项裁决之外若再遇现状差异, 列出报告,不擅自统一」,G2/G3 也明确「值走记账,设计师 review 批」。执行方虽然报告了 暗色撞色这一差异,但在收到「全部修」后自行选定了派生方案与 8% / 10% 两个比例并直接落地, 没有把方案本身回交裁决——落地时这两个比例处于未获批状态,直到 2026-09-04 用户补批。 治理合同 §1.1 把这类具体色号列为「记账值」,合法改值路径是「同 PR 更新快照 + 交证据 + 设计师批准」;前三步当时已完成,缺的正是第四步。结论不是「派生错了」,而是 「修缺陷可以自主,定值不可以」——本条留档,避免被后人当成「执行方可自行发明设计值」的先例。

  • 09-04 DS-4 两项次要差异裁决:输入框禁用态保留、域 alias 不回退(拍板人 = 用户/设计师)—— 这两项是 self-review 时补申报、当时尚未单独获批的差异。逐条走查后裁决:

    1. 输入框禁用态 60% 不透明度:保留。 全仓 19 个输入调用点里只有 1 个会传 disabled(AgentResourceSection 的「并发命令上限」,仅在三档预设写盘在途时为真)。 关键事实:该输入框改造前就已经传 disabled,只是没有任何视觉表现;而同一 section 的三档预设按钮改造前就带 opacity-60(AgentResourceSection.tsx 既有代码)。 所以改造前的实际观感是「按钮变淡、紧邻的数字框不变」——本项不是新增禁用观感, 是补齐同屏不一致。CINDY Light 合成后:边框 #E4E4DF→#EEEEE9、数字 #1A1A1A→#757573、填充与卡片同色故无变化。
    2. ui/input 保持绑 Tier-1,不回退域 alias。 分裂风险已量化:仅在用户持有 「新建本地副本」导出型本地主题时可见。该导出把全部 520 个 token 解析成字面量 写进 JSON(theme-service.ts exportThemeColors 遍历整个 colorRegistry),而 resolveThemeValue 优先读本地主题字面量——于是这类用户改 border-default 时, 标准输入框(6 处)跟着变,被字面量钉住的 --settings-input-border 消费者(138 处)不变。 判定保留的三条理由:(a) 导入型 VSCode / Obsidian 主题零影响——导入器只写 108 个 token、不含 settings-input-*,那批消费者会向上回落到同一个 slot,一致; (b) 这条断层线既存、非 DS-4 新造:导出型主题里「直接读 border-default」(全仓 513 处)与「读 settings-input-border」(138 处)本来就会因改其一而分裂,DS-4 只是把 6 个调用点从 138 那侧挪到 513 那侧,即让标准件站到人多的一侧; (c) settings-input-placeholder 一项本就被 local-themes-normalize 丢弃并转成 text-placeholder,零影响。 代价照实登记:那 138 处(连同同族共 49 个文件)的收口作为 DS-5 待办写入 design-inventory.md 的 desktop.settings 人工区下一动作;因其跨 6 个其它 surface, 须整族一次收口,不按 surface 零敲。修的方向是把未收口的一侧拉过来,而非把标准件退回去。 本条不带任何产品代码改动——两项实现在 self-review 时已落地,这里只补裁决与登记。
  • 09-04 DS-4 self-review 追加的三项收口(非新裁决,是修缺陷与补申报)——

    1. 禁用态不再触发 hover 换色:ui/button 的 hover / active 一律加 enabled: 前缀。CSS 的 :hover 对 disabled 元素照样匹配,而 globals.css 只把禁用态 指针收成普通箭头、不管背景;旧 PillButton 根本没有 hover,所以这属 DS-4 迁移引入的行为回归(ProvidersSection 多处传 disabled={busy})。
    2. §4 input/text 的 focus 槽还原为 --focus-ring-soft:初版把规范值改成 opaque --focus-ring 去迁就实现,但这不在六项裁决里。按「六项裁决之外遇到 现状差异只登记、不擅自统一」还原 spec,偏差登记进 design-governance.md §10 待裁决表。
    3. ui/input 换绑 Tier-1 的事实补申报:border / text / placeholder / focus-border 从 --settings-input-* 域 alias 改绑 --border-default / --text-primary / --text-placeholder / --text-tertiary-stone(与 G5 对 button/secondary 同一条判据)。11 个内置 主题与外部主题导入 allowlist 均未 override 这些 alias,故默认外观逐值不变; 变的是 override 面——手写过 settings-input-* 的用户本地主题不再作用于本组件。 旧 token ID 一个未删,兼容红线未破。

2026-08

  • 08-29 圆角三档写死:按钮一律胶囊、4px 不入档(拍板人 = 用户)—— 背景:设计系统改造调研发现 PermissionPrompt 混用 rounded-[8px]×4 / rounded-[4px]×4 / rounded-[12px]×1,与 §5 三档冲突;全仓走查 rounded-[4px] 生产存量共 30 处(2026-08-29 快照,不止权限弹窗,是普遍债; 仅为字面量语法局部计数,裸 rounded / rounded-sm 等价写法见下方口径块 与补充裁决 (6))。 计数口径(design-governance.md §9 计数纪律,均为当日快照):

    # PermissionPrompt 内圆角分布(2026-08-29 快照:8px×4 / 4px×4 / 12px×1)
    git grep -o 'rounded-\[8px\]' -- apps/desktop/src/renderer/components/new-chat/PermissionPrompt.tsx | wc -l
    git grep -o 'rounded-\[4px\]' -- apps/desktop/src/renderer/components/new-chat/PermissionPrompt.tsx | wc -l
    git grep -o 'rounded-\[12px\]' -- apps/desktop/src/renderer/components/new-chat/PermissionPrompt.tsx | wc -l
    # 全仓 rounded-[4px] 存量(2026-08-29 快照:30;字面量语法,全 renderer 无 tests/vendor 命中)
    git grep -o "rounded-\[4px\]" -- apps/desktop/src/renderer | wc -l
    # 解析后等价 4px 的其它写法(2026-08-29 快照;生产代码 = pathspec 排除 tests/vendor)。
    # 数值依据:tailwind.config.ts 的 borderRadius.lg/md/sm 基于 var(--radius) 派生;
    # --radius 由 theme-service 运行时注入(colors.ts registerColor('radius', 0.5rem)
    # → serializeThemeCss 写入 :root,dark 主题经 resolveThemeValue 回退 light 默认),
    # 故 rounded-sm = calc(0.5rem − 4px) = 4px、rounded-md = calc(0.5rem − 2px) = 6px,
    # 裸 rounded = Tailwind DEFAULT 0.25rem = 4px。
    # ⚠ 上述求值以「主题未覆盖 colors.radius」为前提:resolveThemeValue 优先读
    # theme.colors[id],本地主题 JSON 手写 colors.radius(如 '1rem')会整体平移
    # rounded-sm/md 的 computed 值(sm 变 12px、md 变 14px)——外部主题导入的
    # 108-token allowlist 不含 radius,但本地主题无白名单过滤。按类名的档位分类
    # 只对内置 / 未覆盖 radius 的主题成立;「radius 是否冻结为不可覆盖不变量」
    # 登记为待裁决项(见下方补充裁决 (7)),裁决前 DS-7 棘轮按类名建基线、
    # 以默认主题 computed 值为准。
    # 裸 rounded 计数限定「字符串字面量内的独立 token」(PCRE 词边界 + 前瞻排除
    # rounded-* 变体;grep -v 排除 `${rounded}` 模板插值)——旧口径曾把注释与局部
    # 变量名(如 turnUsageTooltip.ts 的 const rounded)计入 80,属假阳性,已修正为 58。
    # DS-6 迁移与 DS-7 棘轮的基线按三语法合计(30+58+11)建立;此为静态扫描近似,
    # 棘轮落地时应以 AST / 编译产物扫描为准。
    git grep -oP "[\"'\`][^\"'\`]*\brounded\b(?![-a-zA-Z\[])[^\"'\`]*[\"'\`]" -- apps/desktop/src/renderer ':!*/__tests__/*' ':!*.test.*' ':!*/vendor/*' | grep -v '\${rounded' | wc -l    # 裸 rounded:58
    git grep -oP "[\"'\`][^\"'\`]*\brounded-sm\b(?![-a-zA-Z\[])[^\"'\`]*[\"'\`]" -- apps/desktop/src/renderer ':!*/__tests__/*' ':!*.test.*' ':!*/vendor/*' | wc -l                                 # rounded-sm:11
    # 同为非档位值的 rounded-md(6px,亦不入 §5 三档;供 DS-7 棘轮一并建基线)
    git grep -oP "[\"'\`][^\"'\`]*\brounded-md\b(?![-a-zA-Z\[])[^\"'\`]*[\"'\`]" -- apps/desktop/src/renderer ':!*/__tests__/*' ':!*.test.*' ':!*/vendor/*' | grep -v '\${rounded' | wc -l   # rounded-md:196
    

    裁决四条:(1) 三档不变、不加档,把 §5 的软表述写死——会提交决定 / 触发动作 的按钮一律胶囊(权限允许/拒绝按钮包含在内),原「only for small interactive pieces that cannot wear the pill」的主观逃生口删除;(2) 8px 档的判据改为 「套在盒子里、自己不是按钮」(textarea、菜单行高亮、块内小格照旧合法); (3) 4px 不入档:存量登记为债、随设计系统迁移逐步偿还,新代码禁止再写 (机器拦截随棘轮 PR 落地,此前靠 review 按 §5 执行);(4) 「看起来小」不是 改档的理由——元素按「是什么」(按钮 / 盒子 / 盒内非按钮)定档,不按尺寸。 2026-07-28 已登记的 status micro-cells 2px 窄豁免(非交互、≤8px、仅状态) 维持不变,不因本裁决扩大或收回。尚未裁决、随 Permission 迁移再关:允许 / 拒绝按钮的视觉主次、危险授权样式、Desktop 与 Mobile 权限弹窗几何是否一致。 (→ DESIGN.md §5 Border Radius Scale;治理合同 design-governance.md §10 待裁决登记表「PermissionPrompt 圆角」行已随本裁决改为已关闭;迁移执行 = 设计系统路线图 DS-6 / 棘轮 = DS-7, 见 design-governance.md §12)

  • 08-29(补充裁决,随 #3619 review 落定) 圆角判据二则收口:textarea 单一 归档、裸文字按钮豁免(拍板人 = 用户)——review 指出 §4/§5/§7/§9 四处对 textarea 的判据互相冲突(「盒内非按钮」vs「无条件 8px」vs「所有交互元素胶囊」), 以及 §5「every button is a pill — no exceptions」与 §4 向导「← 上一步」裸文字 按钮互相矛盾。两条收口:(1) textarea 一律 8px——不设嵌套前提,嵌在 12px 容器内或作为表单最外层控件都是同一档(胶囊对高框体会变形,8px 是其唯一档位); §5 判据句同步改写,§4/§7/§9 摘要句逐一对齐,并声明 §5 为唯一裁决源、摘要句 漂移时以 §5 为准。(2) 无自身背景的裸文字按钮豁免胶囊——「← 上一步」与 §16.3 登录文字按钮这类只有文字、没有可圆角的填充底色的按钮不带任何圆角; 豁免随组件条目登记(§4 向导条目已写明),新增裸文字按钮用法须在引入它的 组件条目登记。AddProviderWizard.tsx 现行实现(无圆角文字按钮)与裁决一致, 无需迁移。(→ DESIGN.md §5 / §4 Inputs & Forms / §4 Multi-step dialogs / §7 / §9) 追加两处(第二轮 review 指出同节残留):(3) §5 判据分类句由三分类 「button / box / nested non-button」扩为四分类「button / box / textarea(一律 8px)/ nested non-button」,独立 textarea 不再落在分类缝隙里;(4) §7「Keep all buttons at 10px 24px padding with pill shape」与 §5 Spacing「consistent across all buttons」两处绝对表述收窄为「filled buttons」,裸文字按钮不受 pill padding 约束、按其组件条目执行;§5 Pill 档首句同步由「every button」改「every filled button」。(同上条落点) 追加修正(第三轮 review 指出 (4) 的「filled」限定误伤透明控件):(5) 撤销 「filled」反向排除措辞——透明填充 / 仅描边的交互控件(对话框 secondary/cancel 透明填充按钮、inactive tab、composer chip 静止态 borderless)都保留胶囊,「fill 样式从不改变档位」。豁免改回直接正向表述:唯一豁免 = 已登记的裸文字按钮, §1 / §5 Pill 档(首句恢复「every button」,豁免句同步改为「no shape to round」)/ §5 Spacing / §7 Do 共五处统一为「all (buttons|interactive elements) + registered bare text buttons are the only exemption」;(4) 中「filled buttons」字样随本轮撤销作废,裸文字按钮不受 pill padding 约束的实质不变。 (同上条落点) 追加修正(第五轮 review 指出 4px 计数口径漏等价写法;第六轮 review 指出注入链 未交代、裸 rounded 计数混入非样式文本):(6) 「4px 不入档」的禁令覆盖所有解析后 等价于 4px 的写法——本仓 tailwind.config.ts 只覆盖 borderRadius.lg/md/sm (基于 var(--radius) 派生),裸 rounded(Tailwind DEFAULT 0.25rem)与 rounded-sm(8px−4px)同样解析为 4px,与 rounded-[4px] 同属禁止档位的等价 语法;rounded-md(8px−2px=6px)亦不入三档。--radius 的数值依据:该变量 不在任何静态 CSS 文件中,由 theme-service.ts 运行时注入——colors.ts registerColor('radius', { light: '0.5rem' }) 经 serializeThemeCss 写入 :root(dark 主题经 resolveThemeValue 回退 light 默认,值不变),故 rounded-sm/rounded-md 的 calc(var(--radius) ± Npx) 在运行时有效求值。 主裁决「全仓 30 处」只是 rounded-[4px] 字面量语法的局部计数——生产代码中 裸 rounded 另有 58 处(字符串字面量内独立 token 口径;旧口径 80 曾混入注释与 局部变量名假阳性,如 turnUsageTooltip.ts 的 const rounded、 AppearanceSection.tsx 注释行,已修正)、rounded-sm 11 处(计数命令见上方 口径块);DS-6 迁移与 DS-7 棘轮建基线时必须按三种 4px 等价语法合计(30+58+11) 建立,并把 rounded-md 的 196 处一并纳入非档位值清理范围,不得只按 30 建基线。 静态计数是近似口径,棘轮落地时应以 AST / 编译产物扫描复核。§5 行内数字句同步补 「in ANY of its equivalent spellings」限定并指向口径块。(同上条落点) 追加(第七轮 review 指出主题覆盖可平移派生值):(7) rounded-sm/rounded-md 的档位分类以「主题未覆盖 colors.radius」为前提——resolveThemeValue 优先读 theme.colors[id],本地主题 JSON 手写 colors.radius(如 '1rem')会把 rounded-sm 平移到 12px、rounded-md 到 14px(外部主题导入的 108-token allowlist 不含 radius,本地主题无白名单过滤)。口径块已补 ⚠ 前提说明;DS-7 棘轮按类名建基线、以默认主题 computed 值为准。待裁决(随 DS-7 棘轮设计一并关): radius 是否冻结为不可覆盖的主题不变量(冻结则类名分类对全部主题成立;不冻结则 棘轮须按 computed value 分类或豁免覆盖主题)——冻结涉及 local-themes-normalize 加白名单与既有本地主题兼容(治理合同兼容红线:用户主题不改写磁盘),属代码改动, 不随本纯文档 PR 落地。(同上条落点)

  • 08-16 登录:唯一 SSO 不再经过 method-choice(拍板人 = 用户)—— 用户已经从登录首页选了企业 SSO(组织标识探测),或邮箱 / 组织探测结果只剩 一条 SSO、没有个人邮箱验证码替补时,再出「选择登录方式」是假选择(截图上只剩 「以企业身份登录」一行)。soleAutoStartSsoMethod 命中后直接进入 browser-redirect。仍经过 method-choice 的:企业 SSO + 个人邮箱;多条 SSO 连接。跨区企业仍先 realm-confirmation,确认后再套同一条唯一 SSO 规则。 跨区「连接企业所在区域」点继续后,确认窗必须立刻消失并进入等待登录;桌面 renderer 在 method-choice 唯一 SSO 时改派 start-browser,复用既有 browser-redirect 乐观投影,不得在 main 里套住浏览器授权把确认框卡住。 个人邮箱探测若只剩验证码一种方式,同样不经过「以个人身份登录」假选择,直接发码。 (→ DESIGN.md §16.4 method-choice 行;packages/auth-client soleAutoStartSsoMethod)

  • 08-03 排版立法:字重梯改四档、桌面字号白名单建档(拍板人 = 用户,issue #1505)—— 本条推翻原 DESIGN.md §3 的「字重只允许 400/500、never bold」表述(§3 Principles / §7 Don'ts / §9 Iteration Guide 三处同步改写)。背景:2026-08-03 全仓走查发现桌面端在无守卫 状态下已实际漂移——font-semibold(600)生产代码 ×72(含测试 ×74)、font-bold(700)×11、 font-extrabold(800)×1,任意值字号 text-[Npx] 生产代码约 549 处(含 21 处小数、 7 处 <10px:6×9px + 1×8.4px;计数口径 = 生产代码 occurrence,测试与注释另计); 而手机端 2026-07 已收敛到 400/500/600/700 四档 token 并有 typographyTokenDiscipline.test.ts 守卫。三项决策: (1) 字重四档收编:400/500/600/700,与手机端 fontWeight token 对齐,两端一张梯子; 600 收编存量 72 处 semibold(合法化、不改代码),700 只许经豁免登记表(markdown <strong> / hljs 主题移植 / 登录品牌画布),800 清零。工程理由:桌面未设 font-synthesis: none, PingFang 公开档位到 600,UI 用 700 会触发中文伪粗体——中文层级不得依赖 600 vs 700。 (2) 字号「只归写法、不动数值」:本轮不做档位迁移,白名单 = UI 段 {10–16} + 标题段 {18, 20, 24, 28};只做小数吸附、<10px 升下限、任意值归 text-<n> token;语义别名只收编 xs/sm/base/lg,源码侧禁止 xl 及以上(由守卫拦截)。theme.extend.fontSize 中的 xl..5xl 遗留项不在配置侧删除范围,避免删除后静默回退到 Tailwind 内置固定值、失去用户字号缩放; 配置遗留项的清理另行处理。 任意值归 token 的附带修复: doc 紧凑模式(.chat-rail-compact)按类名枚举缩字号,任意值不在枚举内会静默漏缩。 (3) LegacyMigrationDialog 裁决:其 23/19/17 字号是登录画布 680→490(×0.72)的缩放 产物而非手滑,但仍吸附回白名单(24/18/16,±1px);字重 700 归登录品牌域豁免。 line-height 混轨、语义类 text-xs/sm 机械统一等登记为 non-goals。 (→ DESIGN.md §3「字重阶梯 / 桌面 UI 字号白名单 / 排版豁免登记表 / 排版 non-goals」 四个新小节;施工与守卫拆四个 PR,台账 = issue #1505)

2026-07

  • 07-29 「跳过登录」恢复过协议门 + 协议行整行热区 + 未登录态命名(拍板人 = 用户)—— 本条推翻 07-27 记录里的「跳过登录免协议门」(桌面侧;那条其余内容——入口形态换文字按钮、 面板 440→500、圆钮行删游客——继续有效)。三项决策: (1) 跳过登录过协议门:不登录账号也是在使用 Cindy 客户端,面板内「跳过登录」文字按钮与 桌面 error 步 footer 逃生口都改回经 requireConsent——未勾选先弹服务条款 / 隐私协议弹窗, 同意后才进未登录状态,并写入统计采集同意。是否真的上报仍由 main 侧闸决定 (analyticsSettingsService 对本地会话一律 !isLocalMode() 不放行,该逻辑不动)。 ⚠️ 合规实现约束(#907 review 引出,勿改顺序):这条链路的同意记录必须落在 auth:enter-local 之后——acceptPrivacyConsent 会同步广播 allowed,提前落时 isLocalMode() 还是 false,allowed:true 会让 TapDB 当场 init 并发 device_login, 把「未登录态不上报」破一个窗口。落码 = deferConsentPersist 选项 + openLocalMode 自己落同意,顺序由 consent 测试的 invocationCallOrder 断言锁住。同批还要求切换窗口内 不接任何新动作(requireConsent 顶部 localModePendingRef guard;企业 SSO 入口与 error 步 reset 因绕过 requireConsent 另行自挡),否则窗口里点邮箱 / 社交会走 「放行即落同意」分支再次广播 allowed:true。取舍:用行为层 guard 而非给全部控件加 disabled(窗口只有几十毫秒,全量 disabled 会换来可见闪变)。 (2) 协议同意行整行可点:热区由 radio 的 24px 圈体扩到整行 680×40(原来要瞄准一个小圆点); 两个内联链接与 radio 自身 stopPropagation(前者只开链接,后者防冒泡二次 toggle), 行容器不加 role / tabIndex(radio 仍是唯一无障碍交互点),整行 select-none。 (3) 未登录态改名:应用内不再出现「本地模式」这个说法——账号状态名统一为「未登录」 (侧边栏账号胶囊、设置页资料卡、语音服务提示四语同步),动作名沿用「跳过登录」; 未登录态头像不再取状态文案首字(会渲染成「未」/「N」)或写死「L」,改中性人形图标。 代码内部标识(AuthState mode='local'、authEnterLocal IPC、data owner)不受影响,仍用 local。 术语已登记 not-signed-in / skip-sign-in 两条 proposed(i18n/glossary.json)。 (→ DESIGN.md §16 协议门表 + 协议行整行热区条 / LoginPage.consent.test.tsx 与 LoginPage.region.harness.test.tsx 的过门断言 / UserInfoSection 的组件行为测试)
  • 07-29 手机端功能区落位改回新稿标注值(拍板人 = 用户,依据 = 实机比例对照图)—— 本条修正下方 07-28 记录里「功能区落位保持 main 原值不动」那一句(该句作废,原记录 保留在册)。背景:07-28 剥离手机端跳过登录时,把功能区落位一并退回 main (loginY 694 / 933、锚常量 dh-640),但品牌簇已整档换成新稿基准——两半来自不同 构图,拼接后「字标底↔面板顶」间距变成 短屏 92 / 长屏 131.65 设计px,而 main 是 18.98 / 22、新稿是 20 / 25.65,该值在任何一份稿里都不存在;实机折算短屏多空 ≈38pt、 长屏 ≈57pt(约半个输入框高),肉眼可见。当时的不变式只断言「字标底 < 面板顶」(不重叠), 对「空太多」无感,故静默通过。 决策(方案 B):loginY 取新稿标注值 622 / 827(figma 705:915 / 705:799 的 Log_in 组 @(35,622) / @(35,827))。间距回到稿内 20 / 25.65。dh<1334 段改为 min(622, max(0, dh-640))——保留紧凑底距 18 再钳到短屏档落位;曾试过把锚常量直接 改成 dh-712,被 review 实算否掉:那会让 dh∈[712,1222) 全段字标被不透明面板盖住 (dh=1000 压 40 设计px),因为短屏档那 90 的底距只属于 dh≥1334,窄屏空间不足时不该保留。 已知偏离:新稿手机帧面板为 500 高(含「跳过登录」栏),手机端已剥离该入口、面板回 440、 组回 560,少掉的 60 全部落到底部留白(90 / 175,稿内为 30 / 115)。 被否方案 A:品牌簇整体下移 60(loginY 682 / 887),可让间距与底距双双回稿值, 代价是品牌簇整体比稿位低 60(叠加避脸上移后立绘顶 120 / 166);审图后不采纳——优先 保真品牌簇的稿内顶部构图。 pad 竖屏不受影响:无 figma 新稿帧、品牌簇未换基准,内部自洽,保持 621 / 158。 防回归:loginSkinLayout.test.ts 新增三条不变式——「间距上界不变式」(= 稿值,取代 原先只判不重叠的下界)、「锚常量连续性不变式」(dh=1334 上下不跳变)、「间距不变式 (短屏以下分支)」(dh∈[850,1334) 采样点面板顶不得压到字标底);任一侧单独改动、或窄屏 分支被改出压盖,都先在此红(已用注入 dh-712 实测:2 条转红)。 (→ DESIGN.md §16.2 几何表 + 「面板 500→440 少掉的 60 去向」条 + §16 末尾勘误块 (6); cindy-design-system.md 版本记录 2026-07-29 行)
  • 07-28 手机端「跳过登录」与无账号通路整体剥离(拍板人 = 用户)——本条修正下方 两条 07-27 记录(「手机端新增跳过登录入口与无账号通路」及其连带的移动端键盘锚 / 配置错误屏 逃生口 / 移动命中区 50),07-27 那两条作废但保留在册(决策轨迹不删)。背景:本轮 PR 的 任务边界是「登录页只改 UI」;独立核实确认 (a) 手机端在 main 基线(55e3eac2b)从无 游客 / 无账号功能,(b) 2026-07-24 产品拍板「手机 / pad 为远程连接客户端、必须有账号、 不加游客登录」仍然有效——07-27 的「推翻」缺产品侧确认,且 loginConsent.test.ts 里 锁死该拍板的反向断言当时被改写掉了。故手机端跳过登录属越界新增功能,整体剥离。 剥离范围:删 localModeStore / skipLoginGate / homeRemoteSyncGate / authGeneration 及其测试;AuthContext 回 main 等价(无 isLocalMode / enterLocalMode / 冷启动恢复 / 账号优先清标记,clearLocalSession 回裸 generation bump, acceptOutcome / completeOAuthCallback 的 expectedGeneration 一并回退——它是跳过登录 review 引出的改动,越界不留);登录页删入口挂载与协议门豁免、路由门回 isAuthenticated、 首页回 main 行为、删 LoginSkipLoginLink 组件与 skipLogin 四语 key;几何回 main (面板 440、组 560、圆钮行 480、协议行 582、error 槽 680×60 @380、删 LOGIN_SKIP_LOGIN 与 键盘停靠锚常量、pad 竖屏推导值回原值);loginConsent.test.ts 恢复 2026-07-24 三条反向断言。 保留的手机端视觉改版(与跳过登录无关,本轮唯一保留项):短屏 / 长屏品牌簇换新稿 705:915 / 705:799 逐字段基准(cindy / slogan / word),含 07-27 拍板的避脸落值 (长屏 slogan 下移 31.32 距字标 24px、短屏立绘上移至 y=60);功能区落位 loginY (694 / 933 / dh-640)与面板几何同源,保持 main 原值不动。 桌面端不动:桌面本来就有 local-mode 能力,UI 换成「跳过登录」文字按钮合法, 07-27 的桌面侧决策继续有效。手机端保持无游客 / 无账号行为不变。 (→ DESIGN.md §16 末尾勘误块 / cindy-design-system.md 变更史 2026-07-28 行)
  • 07-27 登录页改版:「跳过登录」取代游客圆钮入口,且免协议门(拍板人 = 用户; 依据 = figma 新稿 705:915 / 705:799 / 700:783 + 本轮任务指令)。第三方圆钮行 删除游客人形圆钮(guest 图标资产一并删除,count 按 provider 动态:CN = Apple+SSO 2 颗 / Global = Apple+Google+SSO 3 颗),入口改为面板内「跳过登录」文字按钮 (新稿容器 705:1068 / 700:910 680×60 @面板内 y430)。同时推翻 2026-07-24 「个人登录一律先同意协议再发起(含游客)」:跳过登录 / 本地模式(含桌面 error 步 footer 逃生口)不过 requireConsent、radio 未勾选也直接进主界面,且不写入统计 采集同意(不创建账号、不上报数据,没有明示同意就保持采集闸关闭);其余个人链路协议门 与企业 SSO 豁免均不变。(→ §16.2 几何表 / §16.3 组件表 / §16.4 协议门过门点与豁免 / §16.5 决策记录;figma-component-spec §12.1)
  • 07-27 手机端新增「跳过登录」入口与无账号通路(拍板人 = 用户;依据同上,新稿 手机帧已画出该入口)——推翻 2026-07-24「手机 / pad 为远程连接客户端、必须有账号、 不加游客登录」。落点:AuthContext.isLocalMode 与登录态正交(本态下无 token / user,业务请求仍 UNAUTHENTICATED,只有路由门「有账号 ∨ 已跳过」并列放行),标记跨重启 保留(AsyncStorage cindy.mobile.auth.localMode,非凭证不占安全存储);账号优先—— 真正登录成功即清标记,登出 / 会话终止一并清除回登录页。原锁死该拍板的测试断言 (mobile 登录源码不得出现 localMode 入口)随之改写。(→ §16.3 组件表 / §16.4 逐屏表)
  • 07-27 面板 440→500、登录组 560→620(拍板人 = 用户;依据 = 新稿三端一致 680×500,700:791 / 705:886 / 705:1062,同文件旧稿对照 440)。增的 60 全部给面板内 新增的「跳过登录」槽(430..490,槽底距面板底 10),面板内其余元素 y 坐标一律不动 (标题 31 / 副标题 75 / 输入框 158 / 主按钮 300 / error 380);error 槽由 h60 回到 680×50 @380(2026-07-24 的「占满到面板底 h60」是面板 440 时代的等价写法),与跳过槽 首尾相接、同时可见不重叠;圆钮行 480→540、协议行 582→642 随组顺移(圆钮行距 面板底恒 40、协议行距组底恒 22 均不变)。Splash 借用登录面板时不跟随 500,保持 440 (拆出 SPLASH_PANEL.height:Splash 五帧无该入口、设计稿未改版,跟随会在启动态凭空多 50 CSS px 空白;同批把 Splash 的 no-drag 盒高度从登录组高 620 收到面板高 440——盒语义 是「只有面板内容不参与窗口拖拽」,跟着组高会把面板下方空白也划成不可拖拽区)。 (→ §16.2 / §16.3 LoginPanel;token-decision-table §4)
  • 07-27 「登录文字按钮」定性为新组件类别,与「文字链接」分家(拍板人 = 用户)。 LoginSkipEntry(桌)/ LoginSkipLoginLink(手)不是 LoginTextLink:色走 --login-secondary-text(#6F6F6F,light / dark 同值,零新增 token、不走 --login-link-* 族),hover / pressed 不变色(只靠常显下划线 + 指针形状反馈), 字号取稿值 24(≠ Text_link 的 20);热区 = 当前语言实际文字渲染宽度 + 左右各扩 (桌面 30 / 移动 50 设计px)、高度占满 60 槽,680×60 仅布局容器且自身不可点 (桌面 pointer-events:none + 内层 button;移动 box-none + 内层 Pressable 放大 bounds——不用 hitSlop,它不越父 View 边界、Android 界外触摸不派发);超长译文靠 maxWidth 680 + 单行 + ellipsis 防御兜底,可见截断 = 文案 bug(改文案不改布局)。 文案复用既有 login.localModeEntry(四语齐全,mobile 影子 catalog 新增同译法 skipLogin key;孤儿 key login.returnToLocalMode 四语删除)。 (→ §16.3「登录文字按钮」/ §16.2 长度预算表;figma-component-spec §12.1)
  • 07-27 移动端键盘停靠锚由「面板底」改为「error 槽底」(面板坐标 y=430) (拍板人 = 用户)。背景:面板 440→500 后若继续拿面板底当停靠锚,每次停靠会比改版前多顶 60 设计px,短屏更容易触发 clamped-fallback 把品牌层 / 标题挤掉。取舍:键盘弹起时 「跳过登录」槽(430..490)允许被遮挡——它不是输入链路必需元素,收起键盘即可见;停靠引擎 (10px 贴附 + safe-top 上限 + clamped-fallback)与悬浮相交判定锚(输入框 ∪ 主按钮)不变。 (→ §16.2「键盘停靠锚」)
  • 07-27 SLOGAN 避脸:长屏 slogan 下移 31.32(距字标留 24px)+ 短屏立绘上移 27 (拍板人 = 用户,审 demo 两次拍板:先「slogan 下移不挡脸也不压字标」,再「短屏走方案 B 立绘上移」)。判据是像素级实测而非目测:立绘脸部 skin 连通域 x402..552 / y315..475、 slogan 资产 ink 5244px,双方按各自 contain 折算到 stage 求交——长屏原值 y=536.68 时 ink ∩ 脸 = 290px、短屏 = 91px、中段 dh≈1400 最高 113px。落值:长屏 slogan inner y 536.68→568(容器 514→545.32,x / 宽高不动),底 645.29 距字标顶 669.17 = 23.88 (该档硬上限,再下移撞字标);短屏无下移余量(底距字标顶仅 5.83),改为立绘 y 87→60, 改后 dh ≤1450 全段 ink ∩ 脸 = 0,dh 1500..1624 残留 3..9px(仅下巴尖,受长屏 24px 上限约束)。边界:可见发顶 = 60 + 86×0.79823 = 128.65,仍在 Status Bar 下沿 115.67 之下 12.98(资产 y<86 是透明留白),不侵入状态栏、无顶部裁切;底部淡出渐隐,上移后尾部由 「藏在面板下 20.6」变成「露出面板上 6.4」(长屏本来就露 25,同款观感)。 (→ §16.2「移动端 stage 几何」/「SLOGAN 避脸」)
  • 07-27 手机 stage 几何整档换新稿基准(依据 = 新稿 705:915 / 705:799 逐字段 实测;其中立绘 / slogan 的 y 随同日「避脸」拍板再修正,见上一条):短屏 dh=1334 (立绘 599×720@(75,60)、slogan 254.01×72.8@(462.55,408.37)、 字标 335×115@(208,487)、loginY 622)、长屏 dh=1624(立绘 750×902@(0,106)、 slogan 269.66×77.29@(444.9,568)、字标 387×132.18@(182,669.17)、loginY 827); 短屏以下锚常量 dh-640→dh-712(= 组底 682 + 新稿底距 30,在 dh=1334 处与 loginY=622 连续)。2026-07-24「视觉+功能区整体上移 40 设计px」拍板由本次新稿取代 (那条是为修旧稿协议行溢出,新稿自带 30 底距,不再叠加)。pad 竖屏无 figma 新稿: 按「组底仍落 1114.94 / 字标框底↔面板顶仍 14.84 / splash 期簇位不变」三条不变量,把品牌簇 与登录组一起上移 60 × 0.794117 = 47.647 设计px(loginY 621→573.353,splashOffset 158→206)——该值为推导、非设计源,用户 2026-07-27 接受推导,竖屏几何待设计侧回看确认; pad 横屏组底 774.95 仍在 stage 820 内,几何原值不动。(→ §16.2「移动端 stage 几何」; figma-component-spec §5.4)
  • 07-26 外部主题导入(VSCode / Obsidian)落地,同批引入 Markdown 文字色 token。 两条关键决策: ① 转换模板不新设计,取自已有的人工移植成果。 apps/desktop/src/renderer/themes/builtin/ 下 7 个从 VSCode 移植的社区主题,colors 的 key 集合逐字相同(91 个 token = 35 个 Tier1 slot + 56 个 alias/singleton),值全部由同一组 13 个色板角色派生; apps/desktop/src/shared/theme-import/palette.ts 就是那套派生规则的代码化,并以这些主题自身做 golden 对照(喂入其手写色板常量应重现其 colors)。选 allow-list(只产出这 91 个 key)而非"先大量产出再过滤",因为这 7 个主题本来就没碰豁免族,照抄 key 列表即 自动守住 §10/§16 边界。 ② --md-h1-fg…--md-h6-fg / --md-strong-fg 默认值定为 inherit,不是 var(--text-primary)。这些元素在引入 token 前的颜色就是继承来的 (baseComponents 只给字号字重);若默认接主文字槽,blockquote / tool card / secondary 文字区里的标题与加粗会由弱化色变回主色 —— 那是实打实的观感回退。 inherit 让全部内置主题渲染结果不变,同时给导入主题(Obsidian --hN-color / VSCode markup.heading)留出可覆盖槽位。守卫见 themes/__tests__/markdownColorTokens.test.ts。 连带扩展:本地主题 JSON 新增可选 family 字段,让 Obsidian 双态 CSS 的两个产物 合成一个可跟随 Light/Dark 的家族;无该字段的老主题家族 id 与行为逐字不变。 已知取舍:Obsidian 侧是调色板导入(只取 CSS 变量,布局/圆角/字体一律丢弃, color-mix() 等动态值跳过并计入报告),还原度低于 VSCode 侧,UI 文案如实说明。
  • 07-26 §10「双模式交付门槛」放宽为「实现硬性 / 目检尽力」:实现两模式(走语义 token、禁单模式硬编码、覆盖本次改动涉及的状态)仍是硬性要求;两模式实机目检从 硬门槛降为尽力项——做不到不阻塞交付,但必须在 commit / PR 验证说明里写明哪种模式 未验证,且不得把「复用既有 themed 样式、无新增裸色值」当作「双模式已验证」;一旦目检 发现某模式不可读 / 无区分 / 缺态 / 明显回退,仍按真实缺陷处理必须修。背景:原门槛 要求每次 UI 改动都实机跑两遍,纯复用 themed 样式的小改动也被卡在「未完成」上,与 Agent 日常交付节奏不匹配(用户拍板)。同步改 AGENTS.md 规则索引对应条目。
  • 07-25(梳理批次 2) DESIGN.md §15 保号重构:小节编号冻结为稳定标识 (15.9 从未分配;15.13 物理位置移回 15.12 与 15.14 之间),各小节只留现行规范, 决策史迁入本文件;§10/§11/§14/§15 及 §2/§4/§5 残留中文段英文化(§16 冻结暂缓, 外部引用的关键标题保留中文括注);§16 两处「§2 双模式交付门槛」误指修正为 §10 (门槛正文在 §10,冻结例外,一行级)。
  • 07-24(梳理批次 1) 设计文档整体梳理启动:DESIGN.md 去除 Ollama 官网叙事(标题改 Cindy Design System,§4/§5/§8/§9 官网内容删除或重写为 Cindy 自述); §12 结构化组件规格试点采纳并入 §4(§12 编号保留占位);§13 G1–G4 归档至本文件; focus ring 文档追平代码(#3b82f6 → #417CDD,代码 2026-07-17 已定稿,文档滞后); §2/§9 二级三级文字与 chip 双 slot 表述修正(以 colors.ts 为准); §10 写死 token 计数移除(以 colors.ts 为准);§10 Tier-1 表删除幽灵行 --accent-fg-on-pure(colors.ts 无注册,值与 --surface-on-card 重复)。
  • 07-22 splash 字标资产统一:白字(DARK 用)/深字(LIGHT 用)两版统一为 459×156(@2x),渲染框 229.5×78 恰为 2x 满框——此前白字版 486×184 塞同框被 object-contain 缩小 ~10%,DARK 字标偏小(用户实机发现,换图修复);同日拍板 splash 字标双模式均不带投影(原 drop-shadow 移除),SplashScreen.test.tsx 反向断言。(→ §15.7)
  • 07-20 U2 二级信息色 light 两轮调参定稿:#9A9DA3(Figma 原值)→ #919399 → #8C8E94,桌面 cindy-light 与移动 tokens.ts 同步;dark #6F6F6F 不变; text-secondary-cross light 未随调仍 #9A9DA3。cindyThemes.test.ts ⑦ 锁值。(→ §15.5)
  • 07-20 sidebar-item-active 撤红改反相胶囊(light 深底 #3C3F43+浅字 #FCFCFC / dark 浅底 #EEEEEE+深字 #252222,描边 transparent;用户三轮改稿 定稿,PR #174/#190 落地),同时退出红例外 map。(→ §15.10)
  • 07-19 drop-overlay-bg 红 10% 撤红回中性灰遮罩(用户实机否决:整窗红罩语义 似警报);migration-bar-fill 随主干迁移条退役(token 已删,非撤红);splash 根 容器由半透改不透明 --surface(加载完成前必须完全遮盖已挂载主界面);vibrancy 材质缺省定稿 hud(sidebar 实测回写)。(→ §15.10/§15.12)
  • 07-18 caret 光标:日间定品牌红 #DF0C27、当晚被用户覆盖定稿为蓝 #417CDD (与 focus ring 同值,双端一致);历史文档中「caret 品牌红」表述一律作废。(→ §15.11)
  • 07-18 vibrancy 体系定稿:透壁纸三重管线经实机 A/B 实证(窗口创建期设透明底
    • 根容器让路 + 禁 CSS backdrop-filter);唯一半透面 token surface-translucent-sidebar;浅色红渐变层经用户确认设计稿无此元素整层砍除, splash 渐变辉光层未实现入 backlog。同日发布双端换肤定稿规则(§15.13)。(→ §15.12/§15.13)
  • 07-17 E1D 红色体系重构(用户批准):常规主操作弃品牌红改反相中性四态 (light #3C3F43/#FCFCFC,hover #2E3237,pressed #25282C;dark #EEEEEE/ #252222,hover #E2E2E2,pressed #D4D4D4)。B 类改中性 11 项: accent-cta-bg/-pure/-emphasis/-soft/-hover、update-btn-border/-text、 confirm-btn-primary、perm-allow-btn、primary、settings-btn-primary(alias)、 accent-pure-cta-fg/settings-btn-primary-text(中性字)。C 类逐项裁决:confirm 普通中性(danger 另设)/ perm-allow 中性+警示橙 chip / primary 中性 / sidebar-item-active 当时 light 红胶囊、dark 深红(07-20 撤红,见上)/ migration-bar-fill 保留红(07-19 退役)/ drop-overlay 保留红 10%(07-19 撤红)/ brand-login-cta 不动。send-btn 族六 token 纳入 CINDY override 值表 + disabled 灰 #444242/#585555;侧栏颜色层级整改(正文/二级暗灰/选中胶囊/running 橙, 详见 §15.10 现行文)。三份新 map(NEUTRAL_PRIMARY_EXPECTED_BY_ID/ NEUTRAL_PRIMARY_FOREGROUND_BY_ID + RED_EXCEPTION_ALLOWED_IDS)取代旧 BRAND_RED_*;D2T ⑤/⑦/⑧ 迁移。(→ §15.2/§15.10)
  • 07-17 〔归档〕E1D 前的旧 BRAND_RED_* 三份名单原文(cindyDecisionData.ts 中 保留供 D2T 迁移、迁完删):
    • BRAND_RED_EXPECTED_BY_ID(必须等于品牌红/深红):accent-cta-bg/ accent-cta-bg-pure/accent-emphasis/confirm-btn-primary-bg/ perm-allow-btn-bg/update-btn-border/update-btn-text(均 #DF0C27); primary(HSL,RGB 归一等价品牌红)。
    • BRAND_RED_ALLOWED_IDS(允许含红全集 = EXPECTED ∪ 派生):上述 + accent-soft/accent-hover/confirm-btn-primary-hover/ settings-btn-primary-bg/-border/-hover-bg。
    • CTA_FOREGROUND_WHITE_IDS(红底白前景):accent-pure-cta-fg/ confirm-btn-primary-text/perm-allow-btn-text/primary-foreground/ settings-btn-primary-text。
  • 07-17 status-badge-fg 拆分推导:橙徽章此前借用 accent-pure-cta-fg 白字, #FFFFFF×旧橙 #FF6600=2.94:1 不达标 → 拆独立 token,default 镜像 accent-pure-cta-fg(9 主题零变化),CINDY 两模式 override #1F1F1F (×新橙 #EA6B17=5.19:1 ≥4.5,用户亲批;不达 4.5 则加深 #000000);覆盖数组 115→116;消费点迁移见 §15.8 现行文。(→ §15.8)
  • 07-17 hljs 语法高亮双门槛 D 裁决全推导:hljs 属辅助性视觉编码,对齐 selection/边界 3:1 口径(语法色 ≥3:1、正文 ≥4.5:1)。light 三项 <4.5 但 ≥3 (keyword 4.31 / built_in 3.29 / name 4.36)判 default 同源折损不整改,逐项落 豁免档;dark .hljs-section #1f6feb×#312F2F=2.87 <3 补 [data-theme="cindy-dark"] 提亮 #2573ec(H212 S84% L52→53.5%,=3.00); .hljs-punctuation/.hljs-tag github-dark 无显式色,继承 text #c9d1d9 (8.62 达标),防御性补显式覆盖。落档 cindyCodeBlockContrast.test.ts。(→ §15.4)
  • 07-16 U2 裁决:二级信息色 (b) 忠于 Figma 原值,接受可读性折损(实测 × surface 2.32/2.92:1 等,均低于 AA 4.5:1),作为记录在案的显式偏离; #686B72 加深方案证伪仅存档。(→ §15.5)
  • 〔勘误注记〕brand-login-* 已退役:brand-login-bg/brand-login-error-border/ brand-login-error-text(E1D A 类「保留红」)已随 wave4 登录白底改版退役—— colors.ts 无注册,仅存于 cindyDecisionData.ts 红例外白名单字符串(白名单语义 是"允许存在",token 不存在时无害);现行品牌红唯一出口为 --login-brand-accent (§16.1)。

2026-06 · Spec / Token Gaps 勘误(原 DESIGN.md §13 全文归档)

§12 结构化重写过程中暴露的设计系统欠债。下列"现状"均已 grep 源码核实(以源码 为准),非臆测。四条均已解决,结论已并入 §2 / §4 / §5 / §10。

  • G1 — 白底次按钮文字 #404040「Button Text Dark」是文档漂移,非真 token(已解决 2026-06) 现状:§2 / §4 称其"专用于白底按钮文字",但全仓库只有 features/maker-experimental/MakerExperimentalView.tsx(实验视图,裸 hardcode)出现 #404040,无任何真实次按钮用它做文字色;§10 也无对应 token。 处理:§2 标废弃、§4 White Pill 文字改引 --text-primary(#262626)。未动 token,纯文档。

  • G2 — 次按钮边框 #d4d4d4「Border Light」同为漂移(已解决 2026-06) 现状:§4 称白底按钮边框 1px solid #d4d4d4,但无真实组件这么用;#d4d4d4 的线上出现要么在实验视图(裸 hardcode),要么是暗色主文字(--text-primary dark = #d4d4d4,如 SchedulerPage CTA 注释),与"边框"无关。真边框 token 是 --border-default(#d7d7d4)。 处理:§2 标废弃、§4 White Pill 边框改引 --border-default(#d7d7d4)。纯文档。

  • G3 — placeholder token 碎片化 + 取值自相矛盾(真欠债)(已解决 2026-06) 现状:4 个 per-surface alias 无统一 slot,且取值打架——--settings-input-placeholder = #c4c4c4(§4 认证的"淡到读着像空"),但 --chat-input-placeholder = var(--text-tertiary) = #a3a3a3(Silver),而 §4 白纸黑字说 Silver 太显眼、读着像已填、不可做 placeholder。即聊天输入框 placeholder 实际违反了我们自己的 §4 规范。 处理:colors.ts 新增语义 slot --text-placeholder(#c4c4c4 / #525252),4 个 alias(chat/ask/settings/plan-action-fb)default 收口为 var(--text-placeholder);7 套非默认主题原 settings-input-placeholder override 就地改名为 text-placeholder(沿用原常量,避免回退,符合第 10 节对每套主题的 override 评估)。默认主题下 chat placeholder 由 #a3a3a3 修正为 #c4c4c4。2 套亮色主题(atom-one-light / solarized-light)的 text-placeholder 进一步从 tertiary 改用各自 disabled 档(更淡)——亮色背景下 tertiary≈2.6:1 命中 §4 禁用 Silver 的对比度,placeholder 须更淡才读着像空(2026-06 review 反馈)。本地/复制主题兼容:slot 引入前创建的本地主题快照只冻结了旧 per-surface placeholder key、无 text-placeholder,加载期 mapWireTheme 经 local-themes-normalize.ts 归一化——缺 text-placeholder 时从旧 settings-input-placeholder(或任一 per-surface 值)播种并丢弃 4 个旧 per-surface override,使四个输入面统一走新 slot(不改写盘上 JSON、幂等;2026-06 review 反馈)。

  • G4 — --radius(8px)与容器圆角同名不同义(已解决 2026-06) 现状:--radius 实为 0.5rem(8px,shadcn 原语用);容器 12px 圆角实际靠 Tailwind rounded-xl 直接量实现。 处理:圆角体系正式从"二元"改为"三档"(8px 内层控件 / 12px 容器 / 9999px pill,见 §5 + §7 + §1)。8px 这一档窄范围限定多行输入框、下拉 / 菜单选中行、段内小单元,实现为 rounded-lg;shadcn --radius(8px)与这个内层档数值相同但语义独立(原语专用),容器仍走 rounded-xl(12px)。本次纯文档,未动 token。是否进一步 token 化为 --radius-inner(8px)/ --radius-container(12px)/ --radius-pill(9999px),收益偏低、暂缓,要做走第 10 节的新增 token 流程。

Backlog(已知、刻意搁置)

  • MakerExperimentalView.tsx 裸 hardcode hex 清理(已解决 2026-08-31) 现状:诊断页通篇裸 hardcode 暗色 hex(页面文字、卡片、输入框、按钮、事件流等), 违反 DESIGN.md 第 10 节 token 规则;路由生产包按 URL 可达,Light 主题下不可读。 处理:全量改成语义 token(text-primary / text-secondary / text-tertiary / surface-elevated / border-default / accent-cta-bg / accent-pure-cta-fg / error-flat / surface-chip / surface-chip-alt), 双模式由 token 体系自动覆盖;新增源契约守卫 makerExperimentalThemeContract.test.ts 锁「零裸色 + token 已注册 + light/dark 双槽位」。 合并范围(与 PR 3 同一「renderer 硬编码颜色清理」):CCAgentSessionView handoff pill 两处裸灰文字色改 text-muted-foreground;context 环阈值红/橙改 error-flat / warning-fg 语义 token,双模式由 token 体系覆盖。 review 修订(PR 3686 auto-review P1):事件流标题从 warning-accent 改为 text-secondary——11px 小字在 Light 白色 surface-elevated 上对比度不足,且 warning-accent 语义限定运行/警告状态表面,普通诊断事件标题不在其列。
  • R2 §4.3 Project_List 五点差异(2026-07-17 lead 裁决本轮不做,出处为设计阶段工作文件 2026-07-17-r2-ui-specs.md §4.3,不入仓库):① Project_List 三态拆分(active-task-pill / project-card / flat-list-row 不共用 sidebar-item-active);② 项目 header / list card 选中应中性底(#312F2F/#F6F6F6,非 #DF0C27 大红);③ 去 Project_List 选中组 focus-ring-soft 蓝 ring,改 card stroke #DCDFE3/#434343;④ 小箭头 #A61629 强调(非整行红底);⑤ 本轮收敛不扩战线,后续另开。
  • splash 渐变辉光层未实现(2026-07-18 backlog,待用户表态)。

2026-09-11 DS-8 内置主题依据迁移

本条只迁移既有依据,不批准改色。摘录自接管前 4f03ea9a7b5f6425e517acd91071df6d397c6079 的 apps/desktop/src/renderer/themes/builtin/*.ts;原行尾 Token 说明继续随 DTCG $description 生成, 以下跨 Token、分组和否决式决定保存在生成区外。现行规则以 DESIGN.md §4/§10/§15 为准, 数值仍仅编辑 packages/design-tokens/src/{reference,themes};兼容预期见 builtinThemesFreeze.test.ts 与 cindyThemes.test.ts。旧常量名只用于解释历史角色,不能恢复为第二数值源。

atom-one-light

CREATE AGENT 卡片 / 顶部 pill / 分段开关 + composer pill(#607): 卡片底与 surface 同值收敛(模板惯例),icon 圆底用 CHIP,send 走 tier1 反相 CTA。 用 disabled(比 tertiary 更淡)而非 tertiary:亮色背景下 tertiary≈2.6:1, 命中 docs/design-rules/cindy-design-system.md §4 禁用 Silver 的对比度,placeholder 需更淡才"读着像空"。

cindy-dark

菜单行说明对应 model-item-hover,侧栏说明对应 surface-translucent-sidebar。 “色阶改版”与“对侧入表”指 token-decision-table.md §9 及 cindyDecisionData.ts 的双边冻结; 这些是历史分组依据,不授权将原 alias 改成固定色。

下拉行 hover/选中底:必须比弹层面板(surface-elevated #312F2F)更亮才可见。 surface-hover(#2F2D2D)是为"压在页面底 #2A2828 上"调的,比抬起的面板还暗→行高亮隐形。 故菜单行专用 token 单独抬亮一档(+12/通道),模型/权限/+ 三个菜单共用它,hover 统一可见。 侧栏玻璃: 用户调参 2026-08-11(黑 5 度 85%) ── 2026-08 色阶改版新增 override(原走注册表默认值,现按新阶梯定值;决策表 §9)── ── 对侧入表锚定: 值 = 本侧此前的注册表解析原值(解析结果不变, 仅为决策表双边冻结)──

cindy-light

菜单行说明对应 model-item-hover,侧栏说明对应 surface-translucent-sidebar。 “色阶改版”与“对侧入表”指 token-decision-table.md §9 及 cindyDecisionData.ts 的双边冻结; 这些是历史分组依据,不授权将原 alias 改成固定色。

下拉行 hover/选中底:surface-hover(#F1F1F1)相对面板(#F8F8F8)只差 7,行高亮几乎看不清。 菜单行专用 token 压深一档(-14/通道)使 hover 在面板上清晰,模型/权限/+ 三菜单共用。 侧栏面: 独立压暗一档+85% 遮盖(用户调参 2026-08-17, 与深色对齐) ── 2026-08 色阶改版新增 override(原走注册表默认值,现按新阶梯定值;决策表 §9)── ── 对侧入表锚定: 值 = 本侧此前的注册表解析原值(解析结果不变, 仅为决策表双边冻结)──

eclipse

CREATE AGENT 卡片 / 顶部 pill / 分段开关 + composer pill(#607): 卡片底与 surface 同值收敛(模板惯例),icon 圆底用 CHIP,send 走 tier1 反相 CTA。

github-dark

CREATE AGENT 卡片 / 顶部 pill / 分段开关 + composer pill(#607): 卡片底与 surface 同值收敛(模板惯例),icon 圆底用 CHIP,send 走 tier1 反相 CTA。

material-ocean-hc

CREATE AGENT 卡片 / 顶部 pill / 分段开关 + composer pill(#607): 卡片底与 surface 同值收敛(模板惯例),icon 圆底用 CHIP,send 走 tier1 反相 CTA。

monokai-pro

CREATE AGENT 卡片 / 顶部 pill / 分段开关 + composer pill(#607): 卡片底与 surface 同值收敛(模板惯例),icon 圆底用 CHIP,send 走 tier1 反相 CTA。

one-dark-pro

CREATE AGENT 卡片 / 顶部 pill / 分段开关 + composer pill(#607): 卡片底与 surface 同值收敛(模板惯例),icon 圆底用 CHIP,send 走 tier1 反相 CTA。

solarized-light

旧常量角色:SURFACE_BG → surface(base3),CHIP_BG → surface-chip(base2), BORDER_BG → border-default,TEXT_PRIMARY/SECONDARY/TERTIARY → 对应 text 槽。 下面的卡片说明对应 create-agent-control-* / create-agent-quick-card-*;placeholder 对应 text-placeholder。

base3 ELEVATED (Card 层) 与 Chip 同色 = base2。Solarized 官方只有两档色板, docs/design-rules/cindy-design-system.md §2.54 也明文承认 Dark Mode 里 "Card layer color and chip color collapse to the same value — both represent one step lifted off Surface" 这里把同一惯例搬到 light 模式:Card 比 Surface 略深一档 (94% → 88% L, 差 6%) 产生"下沉式抬起"视觉,与 macOS 浅色模式 input 类似。 base2 — Card / Chip / Hover / sidebar-active 同源 base2 加深,1px 分界 中性灰,正文,刻意比 default-light 淡 label / desc meta / 弱化 CREATE AGENT 快速开始卡片 / 顶部 pill / 分段开关(#607): 卡片用 base2(CHIP)下沉式抬起,与 chat-input 同层;边框/文字走 tier1 同源常量。 hover 必须提亮到 base3(SURFACE):CHIP 与 HOVER 在本主题同值,沿用 HOVER 会让 卡片 default/hover 同色、icon 圆底与卡片同色(codex P1 3671116833)。 icon 圆底 resting 提到 base3(SURFACE) 与 base2 卡片区分;hover 时卡片升到 base3、圆底由模板规则落回 base2(CHIP),两态均可分(codex P1 3671457570)。 send 不用 accent(green) 底:共享 send token 还渲染 10-12px 文本 (VoiceInputOverlay / SessionHandoffCard),白字仅 3.20:1,不达 DESIGN.md §10 小字 4.5:1;回退 registry 反相中性(codex P1 3671457561),故本主题不覆盖 send-btn-*。 用 disabled(比 tertiary 更淡)而非 tertiary:亮色背景下 tertiary 偏深, 命中 docs/design-rules/cindy-design-system.md §4 禁用 Silver 的对比度,placeholder 需更淡才"读着像空"。

2026-09-11 DS-8 默认代码字体依据迁移

接管前 globals.css 已明确:默认代码字体使用系统等宽字体(macOS 的 SF Mono 不以该字体名暴露给网页,实际命中 Menlo;Windows 命中 Consolas),CJK 显式回退 PingFang / 微软雅黑。JetBrains Mono 已降级为可选预设、不再是默认。DS-8 将这条依据保存在 reference/foundations.json 的 app-font-code-default.$description,字体家族、顺序和用户选字体逻辑均不变。DESIGN.md §3 的 JetBrains Mono 排版样本是历史设计样本,不能据此把默认代码字体改回 JetBrains Mono;当前默认来源为该 DTCG token,运行期字体选择仍由原适配器负责。

2026-09-16 · Settings placeholder and Cindy Make task list

  • 用户指出设置中的 placeholder 看起来与普通文字相同,要求降低其显著程度。CINDY Light/Dark 的 text-placeholder 改为沿用 DESIGN §4 的空输入色阶(Light #C4C4C4 / Dark #525252), 不再复用三级文字;修改 DTCG 正本并生成内置主题,同时更新独立预期。其它文字色阶不变。
  • 用户要求多个未完成制作可容纳、可重新打开,归档可恢复,完成与放弃后清理。Settings 采用 搜索+列表/详情双栏,560px 以下改为上下布局;只显示当前选中项详情,列表与详情内容 分别滚动,底部操作不随长需求滚出。全部表面、边框、文字与焦点使用语义 token,按钮复用 标准组件。完成、归档和删除的具体合同见 Cindy Make。
  • 这是根据用户反馈完成的实现决定,不代表用户已经对最终视觉签字验收。

2026-09-11 · DS-9 Desktop 范围与授权呈现

  • 决定人:用户/设计师。 用户将本期余项合为 DS-9(桌面聊天、跨入口、桌面授权)与 DS-10(成熟保护、维护、最终验收),Mobile 以后独立做;内部工序不另编号或拆批。
  • 在隔离 Electron 中以真实 PermissionPrompt 制作现状/主次降低/宽松密度对照,可切换默认与 CINDY Light/Dark、窄栏;按钮回调为受控记录,不执行命令。用户分别明确选择“允许一次突出”“保持中性”“沿用当前密度”。
  • Desktop Allow once 沿用 perm-allow 局部色为主,其余为次;没有可信风险字段,不从命令名或 autoReviewUnavailable 推断高风险;保留输入区内的位置、信息顺序与密度。已有胶囊按钮、键帽 4px 决定直接实施,不重投票。授权含义、默认、顺序、快捷键、提交与恢复行为不变,Mobile 对应视觉决定后续独立处理。
  • 同批聊天按 DESIGN §5 / §14 复用现有数值链、消息与活动行呈现,补图标 Tip、键盘可见焦点、代码与附件操作一致性;业务状态仍由原组件持有。
  • 用户授权交付到本地实现与视觉测试环境,并明确免本地双审;此记录不表示提交、合并或最终人工视觉已验收。实施证据见 docs/design-evidence/2026-09-11/ds9-desktop-core.md。

2026-09-15 — DS-11 复核收尾,以 Cindy 皮肤效果为准

  • 决定人:用户在本次实施指令中授权全部已确认修复、逐项前后审核,并指定 Cindy Light / Dark 效果优先于相冲突的外观描述;不是旧主题兼容或业务权限的豁免。
  • 保留:字号公开别名、已裁决标题角色/控件尺寸、历史无单位行高、CINDY/U2 原色与用户局部覆盖。FormField hint 消费 text-secondary-mid,Cindy 两模式默认色与原 hint 相同。
  • 修订:标准 Button 固定高度垂直居中;普通确认默认 Cancel;选择即安装的 InstallTargetPicker 初始 Cancel、闲时 Esc/遮罩可关闭、安装忙碌期阻止重复与关闭;MarketCard 标题登记为卡内容内的无框文字入口,焦点指示独立,不改变整卡/管理动作。
  • 用量页补 36px 任意日期输入,与图表共用 day 筛选;保留已登记数据标记形状及密度。
  • 实施、验证与用户逐项视觉验收分别记录;代码修复和截图自审不记为用户已批准最终结果。

DS-11 补充分类:实际文字或动作换行的 Toast 外框按 §5 内容容器取 12px;短通知仍为 pill。依据同日用户明确要求以 Cindy 实际 UI 效果为先,消除长通知被撑成大椭圆的效果;颜色与默认停留时长不改。最终亮暗截图供用户逐项验收,不把实现裁决写成最终验收通过。

DS-11 帮助文字补验:新增 form-field-hint,默认保持 text-secondary-mid 运行期 alias,Cindy 原色不变。One Dark Pro 的帮助角色为 #8b909a,Solarized Light 为 #686868,仅修说明文字,不调整原 secondary/tertiary 或用户主题文件。独立冻结预期只添加此 ID 和两项覆盖,不自动刷全部快照。

2026-09-17 — Slider 三变体统一

用户要求在一个 PR 中落地 Design Lab v6,并统一调用入口。普通数值 Slider 原先轨道与滑块在 暗色中不易分辨,改成独立中性色 token、无描边浅阴影滑块;hover 放大、按压成为真正药丸形、 左右箭头光标。推理强度是明确例外:保留原彩色圆块的面板描边与外晕,只增加同族交互。 媒体进度条保留细轨道,增加透明点击区、拖动与键盘定位。原生播放器不改。

入口:外观的界面字号/代码字号,压缩阈值 Claude/Pi,Work Louder 键盘亮度;模型配置推理强度; 音频卡、音效卡、插件音频插槽。键盘亮度原使用 Switch token,导致预览曾误用蓝色;现在与 Switch 解耦。插件插槽挂载同一个媒体组件,不再维护单独拖动实现。规范见 DESIGN §15.18。

2026-09-18 — Desktop Segmented v8

用户确认将 Design Lab v8 落到 Desktop,全量复用共享 SegmentedControl;仅自审和 E2E,不做本地双审。轨道用浅色黑 6% / 暗色黑 25% 透明叠加,选中药丸用低对比描边和两层轻阴影。保留各场景密度、业务回调及独立分离式选项;Mobile / iOS 延后。规范见 DESIGN.md §4 Desktop segmented controls,精确颜色/阴影进入 DTCG。实施与实际验证另见本次证据,不把线上设计预览等同客户端验收。

2026-09-30 — 共享下拉菜单:面板、悬停与侧栏菜单统一(#5272)

  • 决定人:用户/设计师(经 Orca lead 转达,Design Lab #/dropdown-menu v3–v7 对比后确认)。关键原话: 「我倾向于选择A,有阴影的」「悬停时字色不变,只变字重;锁住面板宽度,长文字悬停时下拉框不再变宽」 「危险项悬停底色还是和普通状态的底色一样就好了」「整体都用半透明 + 毛玻璃效果,……如果windows实现不了 或者性能会变差,那windows下就不用实色」(按上下文应为「用实色」,笔误已确认)。
  • 最终规则(DESIGN §4 Select & Dropdown、§14.4、§15.12):
    • 面板:12px、p-1、登记阴影 shadow-[shadow:var(--shadow-menu)](阴影方案 A);--cmd-palette-bg / --cmd-palette-border / --cmd-palette-item-text。macOS Cindy 主题下为毛玻璃,Windows 一律实色、无模糊。 PopoverContent 仍为不透明 bg-popover;Select 面板不改。
    • 文字:14px / leading-[1.43](32px 行),快捷键与分组标题 12px --cmd-palette-item-meta,危险项 variant="danger" 用 --error-fg。字色悬停前后不变;高亮 / 勾选 / 展开行 400 → 500,行内 Lucide 图标 1.5 → 2,--motion-instant。
    • 悬停:每个面板一块 --sidebar-item-hover 高亮,整面板最近行判定、跨分隔线连续滑动;危险行同为灰底。
    • 宽度:行文字与 truncate 用零高度 ::after 预留 500 宽度,面板排版后锁宽。
    • 分隔线:bg-muted → --cmd-palette-border(与面板描边同色)。
    • 侧栏菜单:menuStyles.ts 只保留 h-8 gap-2(触发行加 cursor-pointer),并入共享高亮; ConversationSearchBox、SessionProjectMoveSubmenu、MessageActionBar 的副本改为共享写法,四处手写 红字删除行改为 variant="danger"。
  • 试过又撤回:按分隔线分组淡入淡出(试用时读成「跳一下」);平时文字 --text-tertiary、高亮恢复(浅色下 对比度偏低);菜单毛玻璃不透明度 0.94(随平时灰字撤回而不再需要);危险项淡红底 --error-bg(浅色下读作粉红)。
  • 关键实测:无类型的 shadow-[var(--shadow-menu)] 被 Tailwind 当成阴影颜色、不产生阴影;暗色旧悬停色 --cmd-palette-item-hover #1D1D1D 比面板还暗(1.02–1.07:1),新高亮 #2B2B2B / #333333(1.28–1.30:1); 分隔线 #1D1D1D → #313131;长文字行变粗曾把面板撑宽 459.89 → 465.69px,锁宽后逐帧不变;主字色浅色 最差 13.39:1、深色最差 6.57:1。
  • 明确不包含:其余约 68 处 shadow-[var(--shadow-menu)]、24 处 --confirm-shadow 等无效阴影写法; 自带逐行底色(含 focus:bg-[var(--error-bg)] 的插件页、套餐、iOS 模拟器等)或不走共享高亮的菜单,后续清理 方向为统一成灰底;Popover 与 Select。
  • 危险红字:保持 --error-fg,高亮时不换 --error-fg-strong。原话「红字先保持现在的红(B)吧。」浅色灰高亮上 只有 4.23:1(不透明)/ 4.15:1(毛玻璃),低于 4.5:1(换 -strong 为 7.27 / 7.14:1),用户知情后选择保留。
  • 以上为 Design Lab 对比与 dev 实例实测,不代表 Windows 实机已验收。

2026-10-12: 手机版「我的消息气泡颜色」

用户在 iPhone 试用包上多轮调整后决定先提交手机版,桌面端暂不提交。预设定名为初稿、晨光、灵感、梦境、夜猫、项圈:「心动」是公司名不用;夹在灵感与梦境之间、辨识度不足的青绿色去掉,改为取品牌红色相的「项圈」。系统 ColorPicker 面板过重、大圆盘不好看,改为点选「自定义颜色」后才展开的彩虹色带。自定义色放宽柔化(浅色 30%、深色 18%),深色上限受 7:1 对比度约束。设置预览的描边与内边距按真实气泡(#5787 后的 border、compact 密度)对齐。实现见 DESIGN §2「Personal message bubble colors」。本条记录方案裁决,不代表最终视觉验收。

2026-10-26: 截图模式入口移到屏幕顶部

用户验收指出底部工具栏过密,要求将截图、滚动截图、区域录制、GIF 和 Cindy 放到屏幕顶部;底部保留标注和输出,滚动/录制框选后由开始按钮启动。用户随后明确“长截图改为滚动截图”“采集的单独工具栏也不要”。滚动过程中沿用原全屏截图浮层,选区内透明并把滚轮交给原窗口;选区外显示拼接缩略图与编辑、保存、取消、完成图标,自动滚动/停止滚动按钮贴近选区。支持手动向上和向下拼接,已截内容不重复追加;完成直接复制并关闭,编辑回原标注器,不增加结果页面。静止和短暂局部重绘不提示接不上,持续丢失重叠时停止自动滚动并保留已截内容。本条为产品方向与实现记录,实机验证以当次验收报告为准。

双屏补验确认:顶部模式条只显示在鼠标当前操作的屏幕,鼠标跨屏后转移;非当前屏幕不常驻重复的工具栏和操作提示。

顶部栏拖动补验确认:左侧独立手柄左右拖动,纵向保持在顶部;两端限制在当前屏幕内。拖动不切换模式、不触发选区,本次截图内保留各屏的位置,新截图恢复居中。

滚动预览补充裁决(2026-10-26):用户指出窄缩略卡片与期望体验不同。预览优先使用选区旁可用空间,随选区宽度扩展、最大宽度 640 DIP,随内容增高至屏幕可用高度;图片按宽度保持比例,超高后在预览内滚动,不再随整图长度继续缩小。新增长图向下/向上扩展时分别跟随尾部/头部,停止增长时可滚轮回看。