A team of long-lived bots for DeepSeek Harness, with main bots, bot-to-bot messages and group chats.
DS Bot UI 设计标准
版本:草案 0.2(2026-10-15,对照 dev 2f9300d 复核;0.1 为 2026-10-11)。适用于 ds-bot/src/client/ 里的全部界面。
0. 怎么用这份标准
- 等级:「必须」不能违反;「应该」默认照做,有理由可以例外,例外写进代码注释;「可以」是推荐做法。
- 数值来源:所有数值都取自当前代码(主题、样式和动效模块),不是凭空定的。每一节末尾的「现状偏差」列出代码里和标准不一致的地方,统一时以标准为准。
- 标杆界面:顶部胶囊(「灵动岛」)和设置里的用量页。新界面的动效以这两处为准。
- 方向:固化现状。数值以现有代码为准,只消除不一致,不重新定视觉;长期逐步形成 DS Bot 自己的设计语言。
- 有取舍时:不自行决定。做两种做法的对比预览,由维护者选;选定后写进第 14 节「决定记录」,以后按记录执行。
- 硬规则(来自
AGENTS.md):只用原创素材,不复制其他产品的代码、图标、图形;界面文案的源语言是英文,中文在i18n.js;不改 DSH 本身。
1. 设计原则
- 一个表面在变形。 状态切换时,同一个表面改变大小和内容,不是一个元素消失、另一个元素出现。顶部胶囊是范例。
- 形状只用弹簧。 尺寸、位置、圆角的变化必须用第 9 节的弹簧;只有颜色和透明度可以用固定时长。
- 有进就有出。 弹出层、对话框、菜单关闭时必须播放退场动画,不能直接卸载。
- 没事就安静。 头像和界面只在状态变化或用户操作时动。持续的环境动画只出现在「活泼」档(第 8.4 节)。
- 内容等表面到位。 表面在变形时,里面的内容不重排;大块内容在变形结束后再填入。
- 文案只写用户需要的信息。 不写开发讨论、计划、过程,见第 11 节。
- 颜色全部来自主题。 组件里不写死颜色,见第 2 节。
2. 颜色
2.1 主题
一个主题为浅色和深色各定义 8 个基础色。所有 --bt-* 变量都从这 8 个色推导,换主题就能给整个团队界面换色(themes.js)。
| 基础色 | 含义 |
|---|---|
bg |
主区背景 |
sidebar |
侧栏、设置导航背景 |
bubble |
Bot 消息气泡 |
card |
卡片、输入框、弹出卡 |
text |
正文 |
user / userText |
用户气泡和它的文字 |
accent |
强调色 |
内置主题:
| 主题 | 浅色 bg / text / accent | 深色 bg / text / accent |
|---|---|---|
| DeepSeek(默认) | #fcfcfc / #141414 / #4d6bfe |
#141414 / #f2f2f2 / #5b7bff |
| Mono | #ffffff / #0d0d0d / #0d0d0d |
#0f0f0f / #f4f4f4 / #f4f4f4 |
| Paper | #faf9f5 / #1f1e1b / #d97757 |
#1f1e1b / #f3f0e8 / #e08a6d |
| Moonlight | #f7f9fc / #121826 / #1e86ff |
#0b1020 / #e8edf7 / #4f9dff |
用户可以在设置 → 通用里覆盖强调色(7 种预设或自选)。预设色在浅色界面用 INKS[ink][0],深色界面用 INKS[ink][1];自选颜色两种界面同一个值。深色模式由 DSH 在 body 上标 data-ds-dark-theme。
2.2 语义变量
组件必须只用这些变量,不能直接写色值。
| 变量 | 推导 | 用途 |
|---|---|---|
--bt-ink |
text |
正文、图标 |
--bt-ink-2 |
text 60% |
次要文字、说明、默认图标 |
--bt-ink-3 |
text 36% |
弱文字、占位、空状态 |
--bt-main |
bg |
主区、菜单、对话框背景 |
--bt-sidebar |
sidebar |
侧栏、设置导航;徽标描边 |
--bt-card |
card |
卡片、输入框 |
--bt-bubble |
bubble |
Bot 气泡 |
--bt-line |
text 8% |
卡片、输入框边框(1px),分隔线 |
--bt-line-2 |
text 15% |
浮起表面的发丝边(.5px) |
--bt-hover |
浅色 rgba(119,119,119,.09),深色 rgba(160,160,160,.12) |
悬停底色;次按钮底色 |
--bt-active |
浅色 .17,深色 .2 |
选中、按下底色 |
--bt-accent / --bt-accent-ink |
accent;文字色取 #141414 和白色里对比度高的一个(2026-10-16 定) |
主按钮、开关、焦点环、未读点、「New」分隔线、新消息胶囊 |
--bt-user / --bt-user-ink |
user / userText |
用户气泡 |
--bt-tag-bg / --bt-tag-ink |
text 6%(深色 9%) / 58% |
标签 |
2.3 状态色
| 状态 | 值 | 用途 |
|---|---|---|
| 强调 | --bt-accent |
主操作、选中、焦点 |
| 成功 / 工作中 | --bt-green(#00c972) |
工作中徽标、完成对勾 |
| 主 Bot | --bt-star(#ff9800) |
主 Bot 星标 |
| 危险 | --bt-danger(#e02135,基础样式表设一次,两种界面同一个值) |
删除、错误文字、确认态底色(color-mix 10%) |
| 警告 / 等你回答 | 未定(见现状偏差) | 等你回答的点、需要注意的提示 |
| 提示点 / 录音 | 未定(见现状偏差) | 更新提示点、录音中的麦克风 |
状态徽标的底色应该和侧栏底色混合约 80%,让它柔和(color-mix(in srgb, <色> 80%, var(--bt-sidebar)))。
2.4 角色色
Bot 形象用的颜色(inks.js),每种都有浅色、深色两个值:
- 形象可选 12 色:black、brown、red、orange、yellow、green、cyan、blue、violet、magenta、gray,加一个渐变 aurora。
- 强调色预设 7 色:deepseek、charcoal、graphite、rose、sky、tangerine、cobalt。
- 新 Bot 没选颜色时,从去掉 black、gray、brown 和渐变后的颜色里,按 Bot id 确定地取一个。
- 第一个主 Bot 固定是 deepseek 蓝的鲸鱼。
Bot 名字、提及用同一个颜色写字;纯黑读起来像标题,所以写字时改用灰色。
2.5 规则
- 必须:只用第 2.2 节的变量和第 2.3 节的状态色。
- 必须:新颜色先加进主题推导(
themeVars),再在组件里用变量。 - 应该:强调色只用在主操作、选中状态、焦点环、未读提示上,一屏不超过两处大面积强调色。
- 应该:浮起表面(胶囊、菜单、对话框)用
.5px var(--bt-line-2)发丝边;平面卡片和输入框用1px var(--bt-line)。
现状偏差(2f9300d):
- 红色有 4 个值:
#e02135(17 处,危险)、#c21d2e(5 处:菜单危险项、Bot 设置危险区、模型缺失、文件夹和更新的错误文字)、#E5484D(2 处:更新提示点、连接警告点)、#ff3e51(录音中的麦克风、结束语音,另在自选色轮里)。统一为--bt-danger;提示点和录音是否另设一个变量,待定。 - 警告色没有定义,代码里有两套:
#e3a008(4 处:等你回答的点、反馈的警告级、关于页星标)配文字色#b7791f/ 深色#f0b84a(member-status.js);密钥卡片另用#b25e09/#f59e0b。统一为--bt-warn(+ 文字色)。 - 成功色除了
--bt-green,密钥卡片还写死了#16a34a,并给--bt-green设了不同的后备值#22a06b。 - 除去主题文件和变量定义,组件里写死的十六进制色约 80 处,分布在 15 个文件(近一半在
styles.js)。白色、黑色用在强调色上的文字和图标时,应改用--bt-accent-ink。
3. 字体
3.1 字族
- 界面:
var(--bt-font),即 DSH 的正文字体--dsw-font-family(用户在 DSH 里设了正文字体就用它);没有 DSH 主题时退回-apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif。 - 代码、密钥、路径:
ui-monospace, SFMono-Regular, Menlo, Consolas, monospace。 - 对话内容的字号跟随 DSH 的
--dsh-content-font-size(默认 14px)。 - 中文字体不点名:桌面应用把 DSH 的内置字体换成一份不写中文字体的(
app/src/fonts.css),中文交给系统回退(macOS 经-apple-system是苹方,Linux 由 fontconfig 选,Windows 用系统或用户装的中文字体);DSH Desktop / Web 里跟随 DSH。
3.2 字号档
必须只用下表的字号。
| 档 | 字号 / 行高 | 字重 | 用途 | 例子 |
|---|---|---|---|---|
| 图表 | 10 / 12 | 400 | 只用于图表刻度 | 用量热力图月份 |
| 注释 | 11 / 16 | 400–500 | 计数、时间、小芯片 | .bt-chip |
| 小 | 12 / 16 | 400–500 | 标签、说明、小按钮、错误 | .bt-tag、.bt-note、.bt-soft-sm |
| 正文 | 13 / 18 | 400 | 设置行、菜单项、面板正文、列表 | .bt-set-row、.bt-menu button |
| 内容 | 14 / 22 | 400 | 输入框、主按钮 | .bt-soft |
| 气泡 | 14 / 24 | 400 | 对话气泡的正文;行高是字号 + 10,跟随 --dsh-content-font-size | .bt-bubble、.bt-ububble |
| 胶囊 | 14 / 20 | 400 | 顶部胶囊 | .bt-pill |
| 小标题 | 15 / 20 | 600 | 对话框标题、卡片标题 | .bt-settings-head h2、.bt-q-title |
| 标题 | 17 / 24 | 500 | 详情面板里的 Bot 名 | .bt-drawer-name |
| 数字 | 22、34 | 600 | 用量页的大数字 | .bt-us-stat-value |
- 字重只用 400、500、600。分区标题 13/600(
.bt-set-section h3)。 - 数字列应该用等宽数字(
font-variant-numeric: tabular-nums)。
现状偏差(2f9300d):
- 12.5px 5 处(
browser-pane.js3、sidebar.js2:浏览器标签和卡片、更新卡片)改为 12 或 13;11.5px 1 处(secret-card.js,密钥说明里的代码)改为 11 或 12。 - 16px 3 处(
about.js:114、styles.js:198、styles.js:529)和 18px 1 处(styles.js:561)不在档位里,逐个归入相邻档或写明是图形。 - 字重 700 1 处(
styles.js:151,连接警告点里的「!」),属于图形,可以保留。 - 行高另有 17、19、21、26、28px 等约 10 种不在档位里的值(约 35 处),有一部分是为了让单行控件垂直居中。
- 8.5px 只用在状态徽标的「?」里,属于图形,保留。
4. 间距与尺寸
4.1 间距
以 4px 为基本单位,允许 2 和 6 作为半步。
| 值 | 用途 |
|---|---|
| 2 | 同组按钮之间、列表行之间、菜单项之间 |
| 4 | 图标和文字之间(紧凑) |
| 6 | 标签和字段之间、菜单容器内边距 |
| 8 | 最常用的组内间距;图标和文字之间(常规) |
| 10 / 12 | 卡片内边距、设置行内边距(10 × 12) |
| 16 | 对话框内边距、面板边距 |
| 20 / 24 | 分区之间 |
4.2 控件高度
| 高度 | 控件 |
|---|---|
| 20 | 开关 |
| 28 | 小按钮、图标按钮、对话里的发送键 |
| 32 | 紧凑输入框、标签条里的项 |
| 36 | 标准按钮、圆形按钮、输入框、侧栏行头像 |
| 40 | 顶部胶囊、主按钮(大) |
| 44 | 输入框卡片最小高度、面板标签条 |
可点击区域必须不小于 28 × 28。
4.3 布局尺寸
| 区域 | 尺寸 |
|---|---|
| 设置对话框 | 宽 min(1100px, 100vw - 48px),高 min(780px, …),所有页面同一尺寸(和用量页一致),切换页面时不变;左侧导航 198px |
| 记忆对话框 | 宽 min(680px, 100vw - 48px),高 min(760px, …) |
| 右侧面板 | 详情 320px;浏览器默认 520px,可拖动,最小 360px,对话列至少保留 420px |
| 左侧栏 | 和右侧面板一样不被挤窄。拖右边缘调宽度,264–420px;拖到 176px 以下松手,吸附成 88px 头像窄栏(头像 44px),从窄栏往外拖回到完整栏。左上角的开关(和快捷键)整列收起、再次点击恢复。窗口变窄时先收起右侧面板(放得下时自动回来),再把左侧栏收成头像窄栏;窄时打开面板,左侧栏先收成窄栏让位,仍放不下才盖住对话。Windows、macOS、网页都一样。桌面应用最小窗口宽 508px(窄栏 + 420) |
| 气泡 | Bot 气泡最宽 min(var(--bt-msg-w) × 100%, 100% - 82px),用户气泡最宽 var(--bt-msg-w) × 100%;--bt-msg-w 是设置里的气泡宽度(50%–100%,默认 80%) |
| 输入框卡片 | 最宽 min(992px, 100%) |
| 主 Bot 卡片 | 宽 95px |
4.4 头像尺寸
| 尺寸 | 位置 |
|---|---|
| 20 | 密钥卡片里的 Bot |
| 22 | 对话里消息旁边 |
| 24 | 顶部胶囊、命令面板 |
| 28 | 设置里的 Bot 列表、动作行(「X 正在…」) |
| 36 | 侧栏行 |
| 48 | 浏览器空状态 |
| 60 | 侧栏主 Bot 卡片 |
| 64 | 详情面板 |
5. 圆角
必须只用下表的圆角。
| 值 | 用途 |
|---|---|
| 4 | 标签、芯片 |
| 6 | 菜单项、迷你按钮 |
| 8 | 输入框、下拉框、分段按钮里的项 |
| 10 | 分段控件外框、侧栏行 |
| 12 | 卡片、菜单、主 Bot 卡片、Toast、命令面板、设置卡片 |
| 16 | 设置对话框 |
| 18 | 气泡 |
| 20 | 记忆对话框 |
| 22 | 输入框卡片(写成多行或带附件时 18) |
| 999px | 胶囊形:标准按钮、标签页、顶部胶囊、开关 |
| 50% | 圆形:头像、圆形按钮、徽标、色块 |
真圆:DSH 给所有元素设了 corner-shape: superellipse(1.5),border-radius: 50% 会画成圆角方块。要真圆的地方(徽标、状态点)必须加 corner-shape: round。桌面应用自己的页面不在 DSH 里:启动窗口(start.css)和页内卡片、选择器(page-card.css,卡片的 all:unset 也会清掉它)自己设同样的 superellipse(1.5),所以 999px 的按钮和插件里一样,是顶部胶囊那样的圆角矩形。
现状偏差(2f9300d):不在档位里的圆角约 20 处,集中在 browser-pane.js(9、7、5、3、2px,共 8 处)和 usage-page.js(9、5、3、14px、30%,共 7 处);另有 sidebar.js 14px、secret-card.js 5px、member-status.js 13px、styles.js 1px 和 9999px ×2。9 → 8 或 10;9999px → 999px;其余就近归入上表。用量页的图表元素(条、格)可以例外,写进注释。
6. 阴影与层级
6.1 高度档
| 档 | 阴影 | 边 | 用途 |
|---|---|---|---|
| 0 平面 | 无 | 1px var(--bt-line) |
卡片、输入框 |
| 1 浮起 | 0 2px 8px -1px rgba(0,0,0,.06), 0 1px 2px rgba(0,0,0,.04) |
.5px var(--bt-line-2) |
顶部胶囊;输入框卡片用同形的 .05 / .03 再加一圈 1px 外环 |
| 2 弹出 | 0 10px 20px -3px rgba(0,0,0,.1), 0 4px 6px -4px rgba(0,0,0,.1) |
.5px var(--bt-line-2) |
菜单、下拉、弹出卡 |
| 3 提示 | 0 8px 28px rgba(0,0,0,.14) |
1px var(--bt-line-2) |
Toast |
| 4 对话框 | 0 24px 80px rgba(0,0,0,.24) |
.5px var(--bt-line-2) |
设置、记忆;遮罩 rgba(0,0,0,.32) |
6.2 z-index
| 值 | 层 |
|---|---|
| 0–8 | 页面内的局部叠放 |
| 30 | 顶部胶囊的通知 |
| 40 | 右侧面板 |
| 45 | 拖动遮挡层、侧栏弹出窗格 |
| 60 | 菜单、设置对话框、表情条、更新卡片 |
| 61 | 记忆对话框 |
| 70 | 头像编辑器、提示气泡、命令面板 |
| 1000 | Toast |
现状偏差(2f9300d):代码里有 41 种阴影写法(10-11 时约 20 种),和 6.1 节第 1–4 档完全一致的只有 4 种。例如命令面板 .bt-palette 的 0 24px 48px -12px rgba(0,0,0,.25)、头像编辑器 .bt-avedit 的 0 12px 40px rgba(0,0,0,.18)、用量页日期选择 .bt-us-pick 的 0 22px 50px -18px rgba(0,0,0,.32),…。统一归入五档;描边类的 inset 0 0 0 1px var(--bt-line) 和徽标的底色描边环不算阴影档,单独列出。
7. 图标
- 必须:自绘,不用其他产品的图标。官方 DSH 鲸鱼(
FishLogo)只用来表示 DSH Agent。 - 画布:
viewBox="0 0 20 20",只描边不填充,stroke="currentColor",圆头圆角(stroke-linecap/linejoin: round)。 - 线宽:15px 图标 1.5;16–18px 图标 1.6;箭头可以 1.8。
- 尺寸:菜单和行内 14–15px;按钮里 16px;加号这类主操作 18px。
- 颜色跟随文字(
currentColor),默认--bt-ink-2,悬停变--bt-ink。 - 现有图标在
icons.js:加号、搜索、人、上箭头、麦克风、声波、分享、关闭、左右箭头、云下载、笑脸、回复、更多、对勾、下箭头、下载、仪表、插头、日历、连接器、切换、回形针、时钟、齿轮、图钉、未读、铅笔、星、复制、隐藏、删除、复制一份、滑杆、记忆、群聊。浏览器面板另有地球、前进、后退、刷新、锁(browser-pane.js)。
8. Bot 形象
8.1 形象
- 20 个原创形象,用
dev/characters.mjs生成:每个是一个小 3D 模型,从固定的三分之四视角描成平面层(身体、贴花、背光阴影、受光高光),放在 100 单位的画布里。 - 眼睛是从所有层上挖掉的洞,所以能透出背后的颜色。眼睛的位置和倾斜随表面变化,近眼比远眼宽。
- 形象列表:whale、star、moon、wave、squircle、zed、hex、gumdrop、peanut、saucer、bunny、kitty、beacon、plus、magnet、acorn、pebbles、cushion、ring、gem。
- 必须:新形象从生成器加,不手改
characters.js里的数据;不能用任何厂商标志做贴花。 - 用户也可以上传照片代替形象(圆形裁切)。
8.2 徽标
- 圆形徽标:直径 12px(工作中 8px),右下角贴边,
1.5px侧栏底色描边,corner-shape: round。工作中是绿点,等你回答是强调色的「?」。 - 主 Bot:一颗实心大星,大小随头像(头像的 36%,14–22px),用侧栏底色描边隔开。
- 群管理员:小圆底星(
AdminStar),用在群成员、群设置和新建群聊里。同一个 Bot 在群里既是主 Bot 又是管理员时,显示管理员小星。 - 详情面板和顶部胶囊里的大头像不显示徽标。
8.3 状态动作
| 状态 | 身体 | 眼睛 |
|---|---|---|
| 空闲 | 不动(活泼档另见 8.4) | 不动 |
| 思考 | 歪头慢慢起伏 2.2s | 眯眼 |
| 搜索 | 左右探 1s | 左右扫视 |
| 工作中 | 上下晃 1.6s(不同形状有晃、摇、压扁三种) | 眨眼 |
| 发消息 | 向前冲 1.1s | — |
| 等你回答 | 问题到达时跳两下 | — |
| 完成 | 压扁回弹一次 1.8s | — |
8.4 动画三档
设置 → Bot → 动画,对整个团队生效(body[data-bt-motion])。
| 档 | 内容 |
|---|---|
| 安静 | 只有 8.3 的状态动作 |
| 正常(默认) | 安静 + 互动:悬停头像时蹭、点击大头像转圈、眼睛跟随指针 |
| 活泼 | 正常 + 空闲时偶尔眨眼和小动作(跳、摇、伸懒腰、张望,每个 Bot 一种,9 秒一轮,彼此错开);等你回答时一直跳,「?」移到头顶 |
8.5 抚摸
- 只在头像上,或头像外一圈(宽度为头像尺寸的 20%)触发。
- 动作:弹簧歪向指针 8°,然后来回蹭(到 14°,周期 0.78s),持续到指针离开;离开后从当前姿势弹回。
- 眼睛:胶囊眼收起,换成「^ ^」闭眼弧。
- 只对空闲和等你回答的 Bot 生效。
9. 动效
9.1 弹簧
所有弹簧都由 springEasing(刚度, 阻尼) 采样成 CSS linear() 曲线(motion.js),CSS 过渡和 WAAPI 都能用。必须用下表的常量,不能在组件里自己定参数。
| 常量 | ω / ζ | 时长约 | 过冲 | 用途 |
|---|---|---|---|---|
SPRING_SHAPE |
20 / 0.78 | 420ms | 2% | 表面变形、对话框、页面、开关滑块 |
SPRING_TAP |
30 / 0.8 | 290ms | 1.5% | 按压、弹出层入场 |
SPRING_LIST |
22 / 0.8 | 190ms | 0 | 列表重排 |
SPRING_STRETCH |
18 / 0.56 | 560ms | 12% | 拉长展开的表面(胶囊里的「记忆已更新」) |
SPRING_POP |
22 / 0.49 | 430ms | 17% | 小标记弹出(对勾、图标) |
SPRING_LEAD / SPRING_TRAIL |
28 / 0.86,17 / 0.86 | 约 0.3s | ≈0 | 滑块的前沿 / 后沿 |
QUICK_EDGES |
30 / 0.85,20 / 0.85 | 约 0.3–0.45s | ≈0 | 跟随键盘和指针的高亮 |
| 布局滑动(未提成常量) | 31.6 / 1.0(springEasing(1000, 63)) |
约 0.3s | 0 | 侧栏行重排。现在只写在 sidebar.js:214 的 GLIDE 里,应该提到 motion.js 作为共用常量 |
spring(曲线, 属性…) 生成 transition 字符串,例如 spring(SPRING_TAP, 'scale')。
9.2 固定时长
只用于颜色、透明度和不涉及形状的变化:
| 时长 | 用途 |
|---|---|
| .12s ease | 悬停底色、文字颜色、边框(默认) |
| .16s | 退场淡出 |
| .22s ease-out | 内容模糊淡入(bt-veil-in)、遮罩淡入 |
cubic-bezier(.22,1,.36,1) |
用量页的级联入场、数字滚动(只在用量页) |
1 秒以上的时长是头像的循环动作(第 8.3 节),毫秒级的是错开延迟,都不受这张表限制。
现状偏差(2f9300d):
- 1 秒以内的固定时长,除了 .12、.16、.22s,还有 .1、.13、.14、.15、.18、.2、.24、.25、.28、.3、.32、.36、.4、.45s 等约 20 种,约 80 处。
cubic-bezier曲线有 10 种,共 40 处。其中(.34,1.56,.64,1)带过冲,有 6 处,属于形状变化,应改用SPRING_POP;(.22,1,.36,1)在用量页以外也在用(group-settings.js、schedules.js、secret-card.js、styles.js)。
9.3 共用件
| 名字 | 作用 | 用在 |
|---|---|---|
useGlide |
一个滑块滑到选中项;前沿快、后沿慢,所以移动时拉长、到位收回;中途改目标保留速度 | 设置导航、分段控件、各处标签页、命令面板高亮 |
Segmented |
带 useGlide 滑块的一排按钮(aria-pressed) |
动画三档、群聊「谁来回答」 |
useFlip |
列表项从旧位置滑到新位置,新项从模糊中清晰 | 命令面板结果、新对话下拉 |
useMorph |
容器高度跟着内容走弹簧 | 新对话下拉、连接器展开、「显示更多」 |
useLinger |
关闭后保留一会儿,播完退场再卸载 | 设置、记忆、菜单、模型菜单 |
bt-veil-in |
透明度 + 模糊 6px → 0,.22s | 所有入场的内容层 |
| 按压 | 独立的 scale 属性走 SPRING_TAP |
文字按钮 .96,图标按钮 .9 |
9.4 入场和退场
| 表面 | 入场 | 退场 |
|---|---|---|
| 菜单、下拉(向下展开) | bt-pop-drop:上移 4px、缩到 .96 → 原位,SPRING_TAP |
bt-pop-out:淡出、缩到 .97、模糊 2px,.12s |
| 向上展开的弹出层 | bt-pop-lift:下移 4px → 原位 |
同上 |
| 对话框 | bt-dialog-rise:下移 12px、缩到 .96 → 原位,SPRING_SHAPE;内容 bt-veil-in |
bt-dialog-sink:下沉 6px、缩到 .975、模糊 3px、淡出,.16s |
| 设置里的页面 | 进一层从右(18px),退一层从左,同层从下(10px) | — |
| Toast | 从下方 16px、缩到 .94 升起 | 淡出 |
- 必须:弹出层的关键帧只动独立的
translate/scale属性,不碰transform,这样已经用transform定位的元素不用改。 - 必须:关闭时用
useLinger保留到退场结束。
9.5 性能
- 必须:逐帧动画只动
transform、translate、scale、rotate、opacity。 - 必须:不逐帧动画会引起大面积重排的属性(
width、height、margin)。确实要变宽高时:- 表面变形期间,里面的内容固定为最终尺寸,只让边缘移动(右侧面板这样做)。
- 旁边的大块内容(对话列)只重排一次:表面变大时立刻让位,变小时等表面收完再收回。
- 应该:模糊只用在小面积的层上。整个面板、整个页面不加模糊。
- 应该:大块内容等外框变形结束后再渲染,用
startTransition让出主线程。
9.6 减少动态效果
系统打开「减少动态效果」时(prefers-reduced-motion: reduce):
- 必须:头像的所有动作停止。
- 必须:滑块直接跳到终点;对话框只淡入;其他新增动画关闭。
reducedMotion()在motion.js,JS 动画启动前必须先检查。
现状偏差(2f9300d,仍在):
browser-pane.js:31里有自己的一份SPRING_LEAD/SPRING_TRAIL(ω 24 / 12),和motion.js的共用值(ω 28 / 17)不同,改为引用motion.js。sidebar.js:214的GLIDE(ω≈31.6、ζ=1)数值本身是对的,只是没有放进motion.js;提成共用常量,数值不变。- 关键帧 99 个,有些只差一个数值。例如单纯的淡入就有
bt-fade、bt-fade-in、bt-blur-in、bt-veil-in、bt-us-fade几个。归并到第 9.4 节的几类。
10. 组件
每个组件写明:用途、尺寸、状态、动效。类名是当前代码里的类名。
10.1 按钮
| 种类 | 类名 | 尺寸 | 外观 | 用途 |
|---|---|---|---|---|
| 主按钮 | .bt-send |
高 40(小号 28),胶囊形 | 强调色底,--bt-accent-ink 字 |
每个界面最多一个:发送、创建、保存 |
| 次按钮 | .bt-soft / .bt-soft-sm |
高 36 / 28,胶囊形,左右 16 / 12 | --bt-hover 底 |
其他操作 |
| 圆形按钮 | .bt-round |
36 × 36 | 1px --bt-line 边,--bt-main 底 |
侧栏顶部的搜索、新建 |
| 图标按钮 | .bt-icon-btn |
28 × 28,圆形 | 透明底,--bt-ink-2 图标,悬停加底色 |
工具条、关闭 |
| 迷你按钮 | .bt-mini |
字号 12,圆角 6 | 透明底 | 行内的小操作(复制、更多) |
- 状态:悬停换底色(.12s);按下
scale.96(图标按钮 .9),SPRING_TAP;禁用opacity: .35,不响应按压。 - 危险操作:文字用危险色,放在菜单最后,前面加分隔线;不可撤销的操作要求再点一次确认。
10.2 输入
| 种类 | 类名 | 尺寸 |
|---|---|---|
| 输入框 | .bt-input |
高 36,圆角 8,1px --bt-line 边,--bt-card 底,字号 13 |
| 下拉框 | .bt-select |
高 34,圆角 8 |
| 多行输入 | .bt-input-area |
最小高 80 |
| 字段 | .bt-field |
标签(12,--bt-ink-2)在上,间距 6 |
10.3 选择
| 种类 | 类名 / 组件 | 规格 |
|---|---|---|
| 分段控件 | Segmented(.bt-seg) |
外框圆角 10、内边距 2、--bt-hover 底;按钮高 30、圆角 8;滑块用 useGlide,选中项 --bt-card 底加轻阴影 |
| 开关 | .bt-switch |
36 × 20,圆形滑块 16;打开时强调色;滑块走 SPRING_SHAPE;按住时滑块拉长到 21px |
| 色块 | .bt-swatch |
22 × 22 圆形,选中时 2px 描边 |
两到四个互斥选项用分段控件;开 / 关用开关;更多选项用下拉框。
10.4 标签与徽标
| 种类 | 类名 | 规格 |
|---|---|---|
| 标签 | .bt-tag |
字号 12,左右 6,圆角 4,--bt-tag-bg 底,最宽 96px,超出省略 |
| 芯片 | .bt-chip |
字号 11,圆角 4,1px 边 |
| 状态徽标 | .bt-badge-* |
见 8.2 |
10.5 菜单
.bt-menu:圆角 12,内边距 6,最小宽 200,--bt-main底,第 2 档阴影。- 菜单项:最小高 30,圆角 6,内边距 6 × 8,字号 13;图标 16px;悬停
--bt-hover。 - 分隔线
.bt-menu-sep;危险项放最后。 - 动效:见 9.4。键盘:
Esc关闭;应该支持方向键在菜单项之间移动(现状偏差 #11)。
10.6 对话框
- 结构:遮罩
.bt-scrim+ 对话框。对话框圆角 16(记忆 20),第 4 档阴影。 - 设置对话框:左侧导航 198px(
--bt-sidebar底,选中项用纵向useGlide滑块),右侧是页面。 - 页面内容用「分区 + 卡片 + 行」:
- 分区标题
h3:13 / 600,下边距 8。 - 卡片
.bt-set-card:圆角 12,1px--bt-line边,--bt-card底。 - 行
.bt-set-row:内边距 10 × 12,左边是标签,右边是控件;行之间 1px 分隔线。 - 行默认不加说明文字(第 11 节)。
- 分区标题
- 关闭:右上角关闭按钮、
Esc、点遮罩。
10.7 右侧面板
- 详情 320px;浏览器默认 520px,左边缘可拖动。
- 顶部标签条高 44:Bot 自己是第一个标签,浏览器的每个页面一个标签,侧边对话每条一个标签;选中标签下有一个用前后沿弹簧移动的滑块。
- 切换宽度时,标签条和视图固定为最终宽度、贴右边,只有面板左边缘在动(第 9.5 节)。
10.8 卡片
| 卡片 | 用途 | 规格 |
|---|---|---|
| 设置卡片 | 设置页 | 见 10.6 |
问题卡片 .bt-q |
Bot 向用户提问 | 白底卡片,1px 内描边,内边距 14 × 16,间距 12;选项行圆角 12、内边距 10 × 8,选项之间有分隔线(2026-10-11 问题卡片打磨后的样子)。从下方弹簧升起,提交键弹入 |
浏览器卡片 .bt-bcard |
详情里的打开页面 | 圆角 12,.5px 边,标题 + 文字预览 |
10.9 反馈
按问题的位置选:
| 种类 | 类名 | 什么时候用 |
|---|---|---|
| 行内错误 | .bt-error |
某个字段或某个操作失败,错误写在它旁边 |
| Toast | .bt-toast |
后台请求失败等不属于某个位置的消息;底部居中,圆角 12,第 3 档阴影,带「详情」链接 |
| 空状态 | .bt-empty |
列表为空;13 / --bt-ink-3,居中,一句话 |
| 骨架 | — | 加载时占位,不用转圈;内容到了用 bt-veil-in 替换 |
| 流光 | — | 进行中的文字(「正在思考…」),文字上扫过一道光 |
10.10 顶部胶囊(灵动岛)
- 高 40,胶囊形,左边 24px 头像,第 1 档阴影。
- 悬停弹出向右箭头(宽 0 → 18px,模糊淡入),点击打开右侧面板。
- 有事件时(如「记忆已更新」)向右拉长(
SPRING_STRETCH),图标弹出(SPRING_POP),然后收回(SPRING_SHAPE)。 - 这是动效标杆:新的可变形表面都按它的方式做。
10.11 侧栏
- 主 Bot 卡片:宽 95,圆角 12,60px 头像 + 名字 + 角色标签。
- 行:36px 头像 + 名字 + 一行预览;悬停
--bt-hover;选中--bt-active;置顶的行在名字旁边显示小图钉。 - 列表顺序变化时,行滑到新位置,用布局滑动弹簧(ω≈31.6、ζ=1)。现在这条弹簧只写在
sidebar.js的GLIDE里,要提到motion.js(现状偏差 #7)。
10.12 对话
- 气泡:圆角 18,内边距 7 × 12;Bot 气泡
--bt-bubble,用户气泡--bt-user。 - 输入框卡片:最小高 44,圆角 22(写成多行或带附件时 18),内边距 7.5,第 1 档阴影的输入框变体;左边「+」,右边麦克风和发送键。
- 动作行(「X 正在…」):高 36,28px 头像 + 流光文字。入场是缩放 .9 → 1 加淡入(
SPRING_TAP),退场 .14s 缩到 .92 加淡出和模糊。
11. 文案
- 必须:只写用户需要的信息。不把会话里的讨论、计划、过程写进界面(例如「马上」「稍后」「下个版本」),用户亲自给的原文除外。
- 必须:设置项默认不加说明文字。确实需要时只写一句中性的功能描述;不复述会话里的说法,不比较选项。拿不准就不写。
- 必须:源文案写英文,中文写进
i18n.js的ZH;渲染时用t()查,不缓存翻译结果。 - 应该:英文用句首大写(sentence case);标签和按钮不加句号;按钮用动词开头(Create、Save、Delete)。
- 应该:错误文案说清楚出了什么事和用户能做什么,放在出错的位置旁边。
- 术语:
| 英文 | 中文 |
|---|---|
| Bot | Bot |
| Main Bot | 主 Bot |
| Group chat | 群聊 |
| Group admin | 群管理员 |
| DSH Agent | DSH Agent |
| DeepSeek Harness / Harness | DeepSeek Harness / Harness |
| Memory | 记忆 |
| Connectors | 连接器 |
| Scheduled tasks | 定时任务 |
| Usage | 用量 |
12. 可访问性
- 必须:图标按钮有
aria-label;菜单role="menu",对话框role="dialog"+aria-modal,开关role="switch"+aria-checked,分段控件role="group"+ 按钮的aria-pressed。 - 必须:键盘可用。
Esc关闭最上层;Tab顺序和视觉顺序一致。 - 必须:可聚焦的控件有焦点环:
2px solid var(--bt-accent),偏移 1–2px,只在:focus-visible时显示。 - 必须:强调色上的文字和图标用
--bt-accent-ink。它取#141414和白色里对比度高的一个,不是按固定亮度阈值。 - 必须:遵守第 9.6 节的减少动态效果。
现状偏差(2f9300d)::focus-visible 一共 10 处,只覆盖开关、模型选择、密钥选项、顶部胶囊、问题卡片选项、工具行、记忆删除键。按钮、菜单项、标签页、侧栏行要补上。菜单(右键菜单、模型菜单、文件夹菜单、账户菜单、「+」菜单)只支持 Esc,不支持方向键;方向键目前只在命令面板、新对话下拉、记忆面板和顶部胶囊里有。
13. 现状偏差汇总
对照 dev 2f9300d(2026-10-15)。括号里是 10-11 草案 0.1 时的情况。
| # | 项 | 现状 | 标准 |
|---|---|---|---|
| 1 | 红色 | 4 个值:#e02135、#c21d2e、#E5484D、#ff3e51(0.1 时 2 个) |
一个 --bt-danger = #e02135(2026-10-15 定)。危险用途已统一(#268,2026-10-16);提示点 #E5484D 和录音 #ff3e51 待定。注意:#e02135 在深色底上做文字只有 3.2–3.9:1,是否给深色界面另设一个值待定 |
| 2 | 警告色、成功色 | 警告色未定义,代码里两套;成功色另有 #16a34a、#22a06b(0.1 未记) |
--bt-warn + 文字色;只用 --bt-green |
| 3 | 写死的颜色 | 组件里约 80 处十六进制色(0.1 未记) | 只用第 2.2、2.3 节的变量。未读点、「New」分隔线和新消息胶囊跟随强调色(2026-10-15 定) |
| 4 | 字号、字重 | 12.5px ×5、11.5px ×1、16px ×3、18px ×1;行高约 10 种在档外 | 只用 3.2 节的档 |
| 5 | 圆角 | 档外约 20 处,集中在浏览器面板和用量页 | 只用第 5 节的档 |
| 6 | 阴影 | 41 种写法(0.1 时约 20 种) | 6.1 节五档 |
| 7 | 自定弹簧 | browser-pane.js 的滑块弹簧和共用值不同;sidebar.js 的布局弹簧数值正确,只是没放进 motion.js |
都引用 motion.js;布局弹簧提成常量,数值不变 |
| 8 | 固定时长、曲线 | 约 20 种时长、10 种 cubic-bezier,其中 6 处带过冲(0.1 未记) |
9.2 节三种时长;形状变化用弹簧 |
| 9 | 关键帧 | 99 个(0.1 时约 100) | 归并到 9.4 节的几类 |
| 10 | 焦点环 | :focus-visible 10 处(未变) |
所有可聚焦控件 |
| 11 | 菜单键盘 | 5 种菜单只有 Esc(未变) |
方向键在菜单项之间移动 |
| 12 | 未覆盖的新界面 | 0.1 之后新增或大改:文件夹菜单、权限选择、批准提示、群成员状态(member-status.js) |
补进第 10 节 |
| 13 | 预设强调色在深色界面 | 7 个预设强调色存的是浅色值(prefs.accent = INKS[ink][0]),深色界面也用它。Charcoal #141416 在深色底 #141414 上 1.00:1,Graphite 1.34:1,Cobalt 2.48:1(2026-10-16 发现) |
已定(2026-10-16):深色界面取 INKS[ink][1],自定义颜色不变。修复见 #267 |
统一这些偏差会改动很多文件。建议分几次做,每次只改一项,每次都在 DSH 里对比截图。
14. 决定记录
做法有取舍、或曾有过两种候选的地方,维护者选定后记在这里。新的一条写日期、选了什么、依据或代价。
| 日期 | 项 | 决定 |
|---|---|---|
| 2026-10-10 | 设置对话框、详情标签页、菜单的动效 | 按顶部胶囊和用量页的手感:对话框弹簧升起和下沉,标签页有滑块,菜单弹簧弹出、0.12s 退场。结构、尺寸、配色不变 |
| 2026-10-15 | 标准的方向 | 固化现状,不重新定视觉。做法不一致时做对比预览,由维护者定 |
| 2026-10-15 | 设置对话框尺寸 | 所有页面统一用用量页的尺寸(min(1100px, 100vw - 48px) × min(780px, …)),切到用量页不再变大。两个候选尺寸(800 × 620、900 × 700)都不选。外观(圆角 16、.5px 边、遮罩、导航、卡片)保持现在。#224 |
| 2026-10-15 | 未读点、「New」分隔线、新消息胶囊 | 跟随强调色,不再固定用蓝色(#1084fe、#0c64c1)。#225 |
| 2026-10-15 | 危险色 | 统一为 #e02135(--bt-danger) |
| 2026-10-15 | 保持现在的几项 | 第三级文字 36%;深色底色 #141414 系、保留阴影;活动行(弹簧入场、满 1 分钟显示「· 1m」);用户气泡一律 18px;群聊名字直接用形象色;提示气泡用原生 title |
| 2026-10-16 | 强调色上的字色 | 取 #141414 和白色里对比度高的一个,不再用亮度 > 0.45 才用黑字。旧规则在 15 个强调色里有 8 个选了对比度低的一边,如 Tangerine 白字 2.89:1、黑字 6.38:1。代价:DeepSeek 深色、Moonlight、Paper 主题的发送键图标变成深色。改动在 #225 |
| 2026-10-16 | 预设强调色在深色界面(现状偏差 #13) | 预设色深色界面用它的深色值 INKS[ink][1],和 Bot 名字的颜色一致;自定义颜色两种界面同一个值。和预设浅色值完全相等才算预设(和设置页的判断一样)。深色底上对比度:Charcoal 1.00 → 16.45,Graphite 1.34 → 12.71,Cobalt 2.48 → 4.90。代价:同一个预设色在两种界面里颜色不同(Charcoal 浅色近黑、深色近白),和 Mono 主题一样。改动在 #267 |
| 2026-10-16 | 危险色落地(现状偏差 #1) | 基础样式表设 --bt-danger:#e02135,22 处危险色(17 处 #e02135、5 处 #c21d2e)改读它;确认态底色改 color-mix。反馈提示框带后备值 var(--bt-danger,#e02135),因为界面组装失败时它在没有基础样式表的情况下也要显示。录音和提示点的红色不动(待定)。代价:原 #c21d2e 的 5 处在浅色界面对比度从 5.98 降到 4.73:1(白底),深色界面从 3.08 升到 3.89:1。#268 |
| 2026-10-23 | 思考过程与上下文行 | 思考过程默认不显示,设置 → 通用 → 外观里可打开;Bot 对话不显示 DSH 的上下文行(如「工具已更新」);活动行是唯一的进行中提示(照 Grok)。#465 |