🤖 Open-source, local-first alternative to Grok Bot, OpenAI dots and Claude Duet. Your own AI bots on any model: GPT, Claude, Gemini, Grok, DeepSeek, Kimi, GLM and 70+ more through one Modelflare key. Reach them in the app, WeChat or Feishu; they remember you, work in the background, run commands and use your computer. Pay per use.
AnyModelBot 设计库
界面样式的唯一来源。无构建步骤:原生 CSS(@layer + 自定义属性)+ Preact/htm 组件。
- 样例页:本机服务的
/amb/static/design/index.html。token 表直接从tokens/*.css解析,不会和代码脱节;支持浅色/深色和双主题对照,也能模拟"减少动态效果";设置 › 外观里的偏好(字体大小、字体、动画)在样例页里同样生效。 - 守卫测试:
test/design-system.unit.test.ts。npm test时检查规范有没有被破坏(规则见文末)。
目录
ui/design/
index.css 入口:声明层顺序并按层引入下面所有文件
tokens/
primitives.css L1 原始值:品牌/状态色板,间距、字号、圆角、控件高度、层级等尺度
semantic.css L2 语义 token:按用途命名、按主题取值(浅色 + 深色);另有与主题无关的间距角色、字体与用户偏好
motion.css 动效 token:时长、缓动、位移量、--motion 开关
base/
reset.css 重置、焦点环、可选中规则
motion.css 关键帧库 + .anim-* 工具类 + 减少动态效果
typography.css 文字角色 .t-*(在 utilities 层)
utilities.css .stack .cluster .grow .truncate .tone-* .sr-only
components/ 一个组件一个文件:icon glass button field badge list seg switch stops popover model-family sheet splitter toast notice feedback avatar
motion.js ms("--dur-base")、usePresence()、useListPresence()、reducedMotion()
index.html / gallery.* 样例页
ui/css/ 页面样式(shell / chat / settings / guide),放在 app 层
ui/components/ui.js 组件的 JS 写法:Icon Button IconButton Notice Skeleton Seg Switch Stops Menu MenuButton Sheet …
层叠顺序
@layer tokens, base, components, app, utilities;
后面的层总是赢,和选择器权重无关:
- 页面样式(
ui/css/*.css,整个文件包在@layer app { … }里)可以直接覆盖组件,不用拼权重。 - 工具类和文字角色在最后,加上就生效。
- 新的页面样式文件也要包进
@layer app,否则它会是"无层"样式,压过所有层。
Token
分两层。 原始值(--lime-500、--space-3、--r-md)描述"有什么";语义 token(--primary、--line、--muted)描述"用在哪"。
| 类别 | 规则 |
|---|---|
| 颜色 | 页面和组件只用语义色。原始色板只在 semantic.css 里引用。新颜色先加语义 token(两个主题都要给值),再用。 |
| 字号 | 9 级 --fs-2xs … --fs-4xl(11 / 12 / 13 / 13 / 14 / 15 / 18 / 20 / 24,不用半像素,控件和界面正文同为 13),都乘以 --fs-scale(设置 › 外观 › 字体大小)。新界面优先用文字角色 .t-*;跟着文字走的长度(比如输入框行高 --composer-line)也乘 --fs-scale。 |
| 字重与字距 | --fw-semibold 只给标题:页面、分组、对话框、顶栏与面板标题、提问卡的问题、正文里的标题、11px 小标签。名称一类(机器人名、文件名、模板名、账户名、信息面板的行)用 --fw-medium;设置页的行名称用常规字重,层次交给分组标题和 --muted 的说明。大标题用 --tracking-tighter(-.015em)、二级标题 --tracking-tight(-.01em)——中文字形本来就满,不要收得更紧;行高用 --lh-*,不写 1.45 这类散值。 |
| 字体 | 只用 --font / --code。它们默认是各平台的系统字体 --font-system / --code-system,用户可以换成衬线 --font-serif 或自定义字体(见「用户偏好」)。 |
| 圆角 | --r-xs … --r-3xl、--r-full。同一种面用同一个圆角角色:--r-well(内容里的一组)、--r-pane(面板与浮层)、--r-bubble(消息气泡),见「容器与层次」。嵌套时内层 = 外层 − 内边距(.seg、.pop 里的列表项就是这样算的)。圆形用 50%。 |
| 间距 | 4 的倍数 --space-1 … --space-16,另有 -0-5 / -1-5 / -2-5 / -3-5 半步。页面和组件先用按用途命名的间距角色(见下文「间距」)。写死的像素只允许 0、≤1px 的细线,以及同一行带 /* 微调:… */ 注释的光学微调。 |
| 控件高度 | --ctl-xs … --ctl-2xl(22 / 24 / 28 / 32 / 36 / 44)。 |
| 细线 | --hairline:一个物理像素(普通屏 1px,高分屏 .5px)。面板、浮层的细边都用它——写死 .5px 在 1x 屏上会被抗锯齿成一道若有若无的虚影。 |
| 层次 | --well / --well-hover / --well-press(内容里的一组,只有这一层);--line-2(行间细线);--ctl-edge / --ctl-edge-hover(输入框的边,≥ 3:1);--red-wash / --amber-wash(提示行的淡底)。规则见「容器与层次」。 |
| 投影 | 分三档,只给浮在内容上的东西,都很淡:--shadow-float(输入框、回到底部、提示胶囊)、--shadow-pop(菜单、引导卡片、抽屉)、--shadow-modal(对话框、命令面板)。--shadow-pane 只有一道细线(面板)。--seg-edge 是分段 thumb、开关圆钮的一点点影子。见「容器与层次」。 |
| 层级 | 只用 --z-*;同一窗格内的浮动件用 calc(var(--z-float) ± 1)。 |
| 焦点 | 输入框:accent 描边(浅色墨、深色近白)+ box-shadow: var(--ring) 中性光晕(错误时 --ring-danger);其他控件:全局 :focus-visible 2px 描边、外移 2px,装在会裁切的容器里时用 --focus-offset 往里收。 |
现有语义色名(--bg --card --pill --line --fg --muted --accent …)沿用 magpie 的叫法,分组见 semantic.css 里的 /* —— 组 —— */ 注释。
间距
页面和组件先用间距角色(semantic.css 里与主题无关的 :root 块,样例页「间距与尺寸」里有表),没有合适的角色时才直接用 --space-*。一个角色只用一个值:同一种用途不要这里 10、那里 12、别处 14。
| 角色 | token | 值 | 用在哪 |
|---|---|---|---|
| 面板间隙 | --pane-gap |
8 | 主区、信息面板离窗口边缘;弹出层离窗口边缘 |
| 面板内容边距 | --pane-px |
16 | 信息面板的标题与行文字、对话顶栏的头像 |
| 顶栏边距 | --head-px |
10 | 对话、信息面板、新建页的顶栏到首尾按钮 |
| 工具栏间隙 | --bar-gap |
4 | 一排图标按钮:顶栏、输入框工具栏、消息操作 |
| 侧栏边距 | --side-inset |
8 | 侧栏的行、搜索框、顶部按钮、账户离侧栏边缘 |
| 侧栏行内边距 | --side-row-px |
10 | 机器人行、设置导航、账户、返回、搜索框 |
| 侧栏行间隙 | --side-row-gap |
2 | 相邻两行 |
| 内容列边距 | --page-gutter |
24(窗口窄于 1000px 时 16) | 对话列、输入框、设置页、新建页、引导页两侧至少留这么多 |
| 页面上 / 下边距 | --page-top / --page-bottom |
40 / 64 | 设置页、新建页、引导页 |
| 分组间距 | --section-gap / --section-gap-sm |
32 / 20 | 页面里 / 窄面板里分组标题的上方 |
| 标题到内容 | --heading-gap |
8 | 页面分组标题的下方 |
| 卡片内边距 | --card-pad |
16 | 提问 / 审批卡、引导页卡片、侧栏空状态、模板卡 |
| 对话框内边距 | --sheet-pad |
20 | .sheet |
| 按钮组间隙 | --ctl-gap |
8 | 对话框、卡片、展开编辑区里的一组操作 |
| 浮层离窗口 | --float-inset |
16 | 提示胶囊、命令面板、对话框 |
| 弹出层离锚点 | --pop-offset |
6 | usePopPosition(JS 读 token 的像素值,不写死) |
对齐的线,改间距时守住:
- 顶部中线:侧栏顶部先让出
--pane-gap再放--head-h,新建按钮和主区、信息面板的顶栏按钮在同一条水平线上;搜索框的上沿就是顶栏的下沿。顶栏里的图标按钮一律 28(--ctl-md):16 的图标四周各 6,算对齐时按图标的外沿算。 - 窗口标题栏:桌面版没有系统标题栏,侧栏顶部这一行就是标题栏。左上角看平台:macOS 让给红绿灯(
--titlebar-inset),不放 Logo(应用名在菜单栏里);Windows(:root.win-app)放应用图标(--brand-mark20)+「AnyModelBot」,图标的左沿落在侧栏竖线上,整块是拖动区。Windows 的右上角是系统画的最小化 / 最大化 / 关闭,和这一行一样高、贴住窗口右上角。最右边的面板(信息面板开着时是它,抽屉也是;关着时是主区)贴住这个角:上、右不留--pane-gap,右边两个角是直角,按钮落在它的顶栏上,底下没有一截环境光,也没有面板的边、圆角和投影;底边照旧离窗口下沿--pane-gap。这块面板的顶栏往上长出--pane-gap,内容仍在顶部中线上,右边多让出按钮的宽度--caption-w,这时两种顶栏不再左右对称。信息面板开合时,主区的角和顶栏跟着列宽一起滑。样例页「Windows 标题栏」里有模拟的窗口,右上角的按钮是替身。信息面板自己的关闭钮在 Windows 上不放,免得和窗口的关闭钮挨成两个 ×。浏览器里和 Linux 桌面版用的是系统 / 浏览器的标题栏,这些都不出现。 - 底边:侧栏的账户行离窗口下沿
--pane-gap,和主区、信息面板的下沿对齐;"已保存"浮在账户行上方一个--side-inset,左边和侧栏的行对齐。 - 侧栏竖线:行、搜索框、账户的边离侧栏边缘
--side-inset;头像、导航图标、搜索图标、返回箭头都在--side-inset + --side-row-px(18);搜索框的文字、"返回应用"和设置导航的文字在同一条竖线上(搜索图标 14 + 间隙 12 = 导航图标 16 + 间隙 10)。新建按钮的图标右沿落在行文字的右边线上(同样离侧栏右边 18),和机器人行的时间右对齐。机器人列表的右边距用外边距:滚动条贴着行的右边,不落进侧栏和主区之间的空隙(那里是分隔条)。 - 空隙:侧栏与主区、主区与信息面板之间都是
--pane-gap;分隔条就放在空隙正中(见「分隔条」)。 - 面板竖线:信息面板的标题、分组标题、行文字、展开编辑区、待审批说明都在
--pane-px(16);对话顶栏是--head-px+ 按钮自带的 6,头像也落在 16。两种顶栏都左右对称:最右边那个图标的外沿同样离面板右边 16。 - 输入框:加号钮和发送钮都是 32 的圆、离输入框的边
--composer-pad(8),加号的图标框正好落在文字的起点(16)上;模型、权限胶囊矮一档(28),不和两端的圆钮抢。 - 居中列:对话列和输入框同宽
min(--col-w, 100% − 2 × --page-gutter),设置页、新建页、引导页两侧也至少--page-gutter。对话列的下边距和"回到底部"的位置由输入框高度--composer-h算出来。 - 弹出层:列表离边缘
--pop-pad(4),项再缩进 8,于是项的文字、分组名、分隔线、搜索图标、空状态都在离边缘 12 的线上。 - 行:默认行上下 6,"标题 + 说明"两行的行和一行的行一样高(48);
.row.compact只是矮一些,左右和默认行一样;.row-edit的左右也和行一样,输入框和上面那行的文字对齐。
写死的像素只允许三种:0;≤1px 的细线(比如 right: -1px 压住描边);同一行带 /* 微调:理由 */ 注释的光学微调,守卫测试认这个注释。尺寸(宽、高、控件大小)不算间距,但 calc() 里加减的像素算(calc(100% - 48px) 其实是两侧的边距)。
品牌色
品牌色是 Modelflare 的信号黄绿 #d7ff00 + 墨色 #161a00。界面骨架是纯灰阶(布局参考 Grok Bot / Codex),颜色留给机器人头像和状态。
一句话:操作是中性的(浅色墨、深色近白),黄绿只是很小的信号,不做底色。 用户 2026-11-03 要求减少酸性色,尤其是作为背景色。
| 角色 | token | 浅色 | 深色 |
|---|---|---|---|
| 主操作:主按钮、打开的开关、滑块 | --primary / --on-primary |
墨底白字 | 近白底墨字 |
| 发送 / 停止 | --send-bg / --send-fg |
墨色圆钮 + 黄绿箭头 | 近白圆钮 + 墨色箭头 |
| 焦点、勾选、链接 | --accent |
墨色 | 近白 |
| 输入框聚焦光晕 | --ring(--accent-soft) |
中性 | 中性 |
| 选中文字、定位闪烁 | --mark / --on-mark |
一层灰 | 一层白 |
| "有新东西"的小点:未读、上新、回到底部、新版本 | --signal |
墨色 | 黄绿 |
| 品牌填充:只给应用标志 | --brand / --on-brand / --brand-line |
黄绿底墨字 | 同左 |
黄绿能出现的地方只有上面三处(浅色的发送箭头、深色的小点、应用标志),外加模型选择器的彩蛋(两个滑块都拉满时才有)。不要用黄绿铺底:按钮、提示胶囊、选中态、进度、图表都用中性色;状态(成功、工作中)用 --green,不要用黄绿冒充。
余额(账户浮层、设置 › Modelflare,Balance 组件):一个安静的数字。低于提醒线时数字不变色(红字像欠费),只多一行带琥珀色小点的小字;侧栏底部是一行灰底提示(.side-note),不写金额。
材质
窗口只有几种面,越往上越亮。层次靠底色和一道细线,不靠投影和透明(参考 Codex、Grok)。
| 层 | 是什么 | token |
|---|---|---|
| 窗口底色 | 窗口最底层,侧栏就是它:一层纯色的中性灰,不放光晕、不随机器人变色(用户 2026-11-03 要求)。.app、引导页、样例页的 .window-bg 共用 |
--bg(--glass-side 是透明) |
| 主区、信息面板、引导页卡片 | 窗口底色上的圆角面板,四周留 --pane-gap |
--surface、--glass-panel,--shadow-pane |
| 顶栏、输入框、回到底部 | 盖在滚动内容上,几乎不透,内容从底下滚过只隐约看得到 | --glass-chrome、--glass-float + --glass-filter |
| 菜单、命令面板、提示、对话框 | 最上层,基本是实色 | --glass-pop、--glass-sheet + --glass-filter-lg |
写法:
.pop { background: var(--glass-pop); backdrop-filter: var(--glass-filter-lg); box-shadow: var(--shadow-pop); }
<div class="glass" style="--glass-bg: var(--glass-chrome)">…</div> /* 临时用:.glass + --glass-bg / --glass-blur / --glass-shadow */
不用磨砂颗粒,也不用顶边高光:干净比质感重要。
- 填充、悬停、描边都是半透明的一层(
--pill*、--side-*、--line*、--sel*),放在玻璃和实色上都对。不要在玻璃上用实色灰。 backdrop-filter和transform会让元素变成position: fixed子元素的包含块。对话框(.scrim)还是渲染在原地的,所以侧栏、主区、.chat不要加;下拉不受影响,Popover挂在<body>下。- 系统开了"降低透明度"(
prefers-reduced-transparency,解析成<html data-glass="off">)时,盖在内容上的几样换成实色、--glass-filter*变成none。不做成用户设置:材质本来就几乎不透,开关看不出差别(用户 2026-11-03 定的,Cursor 也没有这个选项)。 - 模糊只给浮层:对话框、命令面板后面的遮罩只压暗、不模糊——对话框自己的玻璃已经模糊了一层,两层叠在一起既糊又费 GPU。
容器与层次
一句话:成组靠底色和间距,不靠描边;一组里面不再套一组;投影只给真正浮在内容上的东西。
| 层 | 是什么 | 底色 | 边 | 投影 |
|---|---|---|---|---|
| 0 窗口 | 窗口底色、侧栏 | --bg |
无 | 无 |
| 1 面板 | 主区、信息面板、引导页卡片 | --surface / --glass-panel |
一道细线 --shadow-pane |
无 |
| 2 组(只有这一层) | 设置分组 .list、提问 / 审批卡 .card、代码块、文件、模板卡、行内提示、展开的编辑区 |
--well,可点的组悬停 --well-hover、按下 --well-press |
无 | 无 |
| 组里的东西 | 行、命令、选项、按钮、输入框 | 直接排在组里,行与行之间一条 --line-2 |
只有输入框有 | 无 |
| 顶栏 | 盖在滚动内容上 | --glass-chrome |
滚动后下面一条细线 | 无 |
| 3 常驻浮件 | 对话输入框、回到底部、提示胶囊 | --glass-float / --glass-pop |
一道细线 | --shadow-float,很淡 |
| 4 临时弹出 | 菜单、引导卡片、窄窗口的抽屉 | --glass-pop |
一道细线 | --shadow-pop |
| 5 模态 | 对话框、命令面板,后面有遮罩 | --glass-sheet / --glass-pop |
一道细线 | --shadow-modal |
选中、悬停都是平的:侧栏行、设置导航是同一种灰深一级(
--side-hover→--side-active),没有投影、不浮起。一层只有一种写法:要加新东西时先想它在第几层,照那一层写,不要自己调投影。
深色下越往上越亮:
--bg→--surface→--glass-float/--glass-pop→--glass-sheet,投影只是辅助。不嵌套:
--well里不再放--well、卡片或描边框。审批卡里的write_file …就是一行等宽字;选项字母平时只是一列字,选中才填成一块(这是状态,不是容器);图标不套底片(模板卡选中时图标换成主操作色的一片,也是状态)。对话框里不再套卡片:"更换密钥"的表单直接排在对话框的内边距里。信息面板上的行直接排在面板上,只有展开的编辑区和待审批是一层--well。描边只给两种东西:
- 文字输入框
.field:--ctl-edge,对它可能落在的每一种表面(主区、信息面板、对话框、--well)都 ≥ 3:1(两个主题都约 3.2:1),底色透明;悬停--ctl-edge-hover,聚焦换 accent +--ring。这是界面里唯一常驻的边——看到边就知道"这里能打字"。 - 浮层玻璃的细边
--glass-edge,以及应用标志的墨色细边--brand-line(黄绿在白底上只有 1.15:1)。
- 文字输入框
分隔线只用在行与行之间(列表行、表格行、菜单分隔、正文
hr、"用时"下面),≤ 1px 的--line-2(表头下沿用--line)。表格不画格子:没有外框、竖线和表头底色,第一列贴着正文左边。不加侧边色条:提示
.notice是一行淡底(--red-wash/--amber-wash/--well)+ 左边一个图标 +--fg的字(在淡底上 ≥ 14:1);语气靠图标颜色,不要"淡红底 + 红边 + 左侧粗红条",也不要淡红底上的红字(对比度不够)。引文blockquote的灰色竖线是排版记号,可以留。描边和投影不另外叠加:内容里的组两样都不要;浮层只用上面那三档(细线已经在里面);分段 thumb、开关圆钮只有
--seg-edge。状态用点,不用彩色胶囊:
.badge是"状态点 + 文字"(和设置页的「● 已连接」同一种写法);只有计数.badge.count保留一小块底。小标签:分组名、菜单分组一律
.t-label(11px semibold、--muted),不全大写、不加字距、不用--faint(读不清)。同一种面同一个圆角:
--r-well(12)、--r-pane(14)、--r-bubble(20)。不用装饰性 emoji:服务端用
⚠️标记出错的消息(微信、飞书里只能这样),界面里显示前去掉,语气交给Notice的图标。
可交互的东西要认得出来(非文字对比度 ≥ 3:1,或者有等效的提示):
- 输入框:
--ctl-edge本身 ≥ 3:1。 - 对话输入框认得出它靠一道细边、常显的占位文字(
--placeholder,3:1)、工具栏和发送钮、固定在底部的位置,输入时边深一级;侧栏搜索框靠放大镜图标 + 占位文字 + 底色,聚焦时一道--line-strong的边。 - 按钮、分段、开关、下拉靠文字和填充;键盘焦点一律 2px accent 描边(
:focus-visible),输入框是 accent 描边 +--ring。
真的需要一道边时,在同一行写 /* 描边:理由 */,守卫测试认这个注释(ui/ 下除 token 文件外的所有 CSS)。
状态
每个可交互组件都要把下面这些状态想到;样例页的「状态矩阵」把它们按浅色 / 深色并排画出来(伪类规则被复制成 .is-hover / .is-active / .is-focus,和真实交互是同一份样式)。
| 状态 | 怎么表现 | 用什么 |
|---|---|---|
| 悬停 | 叠一层半透明,静默控件的字从 --ctl-fg 变 --fg;可点的组(模板卡)底色深一级,不浮起、不加描边 |
--pill → --pill-hover,--well → --well-hover;侧栏里是一层淡灰 --side-hover |
| 按下 | 再深一级,不缩小、不回弹 | --pill-press、--sel-press、--side-press |
| 键盘焦点 | :focus-visible 2px --accent 描边;输入框是描边 + 光晕 |
--focus-offset、--ring |
| 打开 | 菜单展开时触发它的按钮保持"按住"的样子,箭头翻转,加号转成叉 | [aria-expanded="true"],.icon-btn.on |
| 选中 / 当前 | 侧栏行和设置导航是同一种灰深一级,没有投影;菜单当前项打勾;模板卡底色深一级、图标换成主操作色的一片;头像选择是底色深一级 + 名字变实(头像在"听")。都不描边 | --side-active,--well-press,--pill-press |
| 禁用 | --o-disabled,不响应悬停和按下;主按钮和发送钮退成中性灰(半透明的主操作色会发浑) |
:disabled |
| 加载 | 转圈,颜色不变,只是不可点(aria-busy) |
Button loading |
| 错误 | 红描边,聚焦时红光晕 | .err / aria-invalid,--ring-danger |
| 只读 | 次级底,聚焦不发光 | [readonly] |
| 滚动边缘 | 内容滚到顶栏底下时,顶栏才出现一条细线 | .chat.scrolled |
分隔条
两块面板之间的空隙可以拖:侧栏 | 主区、主区 | 信息面板。组件是 Splitter(ui/components/ui.js),样式在 components/splitter.css。
| 方面 | 规范 |
|---|---|
| 位置 | 就是面板之间那道 --pane-gap 空隙,分隔条的中线落在空隙正中;能抓住的宽度 --split-hit(12)比空隙宽一点,两边各探进面板 2px。Electron 里是 no-drag,盖在顶栏的拖动区上也抓得住 |
| 平时 | 看不见,指针移上去只变成 ↔(col-resize) |
| 悬停 | 停住 --dur-intent 后空隙中间从中点长出一道 2px 的细线 --split-line;只是划过去不闪,移开立刻消失。细线只画在面板直边那一段(上下让出 --pane-gap + --r-pane) |
| 拖动 | 细线换成 --split-line-on(--accent:浅色墨、深色近白);整个窗口都是 ↔、不会选中文字(<html data-resizing>);宽度跟手(直接写 CSS 变量,不经过渲染,列宽不过渡);离默认宽度 6px 以内吸附回默认;到了最窄 / 最宽,指针换成单向箭头 |
| 范围 | --side-w-min … min(--side-w-max, --side-w-cap)(220 … 400,且不超过窗口的 36%),信息面板 --panel-w-min … min(--panel-w-max, --panel-w-cap)(280 … 440,34%);拖动时还要给主区留至少 --main-w-min |
| 恢复 | 双击分隔条恢复默认宽度,列宽用 --dur-slow + --ease-spring 滑回去 |
| 键盘 | role="separator",可以 Tab 到;焦点就是那道 accent 细线(不画外描边)。← → 一次 8px、Shift 一次 32px,Home / End 最窄 / 最宽,Enter 恢复默认 |
| 保存 | 松手、键盘、双击时提交一次:lib/prefs.js 的 sideW / panelW(px,0 = 默认),每个窗口各一份;首帧前 index.html 先写到 <html> 上的 --side-w-user / --panel-w-user,不闪 |
| 不出现 | 窗口窄于 1180px 时信息面板是浮在对话上的抽屉,它的分隔条隐藏 |
页面怎么接:列宽在 .app 上用 clamp(-min, var(-user, 默认), min(-max, -cap)) 算出来(--side-col、--panel-col),分隔条用 --split-x 定位到空隙中线:
.app > .split-side { --split-x: calc(var(--side-col) - var(--pane-gap) / 2); }
<${Splitter} class="split-side" size="--side-w" label="调整侧栏宽度" value=${sideW} room=${…} onCommit=${(px) => setPrefs({ sideW: px })} />
--side-col、--panel-track(信息面板那一列此刻的宽度:关着是 0)注册成 <length>(@property,不继承),所以信息面板开合、恢复默认时列宽能平滑过渡:面板本身定宽,列变窄时它往右滑出窗口,里面的内容不会被挤扁重排。
主题
<html data-theme>总是解析后的light/dark(index.html首帧前设置,lib/theme.js同步)。- 主题可以局部生效:任何元素加
data-theme="dark",它的子树就换一套语义 token(样例页的双主题对照就是这样做的)。 - 因此不要写
:root[data-theme="dark"] .xxx { … }这类按主题的覆盖。需要两个主题不同的值,就加一个语义 token。 - 由其他语义 token 推导的值(
--ring、--code-bg)写在:root, [data-theme] { … }里,每个作用域都会重新计算。
用户偏好
设置 › 外观(和常规里的发送键、通知)是本机界面偏好,和主题一样存在 localStorage(amb-prefs,lib/prefs.js),每个浏览器 / 桌面窗口各一份。外观类的偏好解析成 <html> 上的属性,semantic.css 的「用户偏好」块和 motion.css 把属性翻译成 token——页面和组件只用 token,不认这些属性:
| 属性 | 取值 | 翻译成 |
|---|---|---|
data-text |
sm / md / lg / xl |
--fs-scale(.92 / 1 / 1.1 / 1.2):只放大文字,控件高度、图标、间距不变;整体放大是桌面版的「界面缩放」(Electron zoom) |
data-font |
system / serif / custom |
--font;custom 时 prefs.js 在 <html> 上内联 --font: "自定义", var(--font-system)。自定义代码字体同样内联 --code |
data-width |
normal / wide / full |
--col-w、--bubble-w(对话列和输入框) |
data-code-wrap |
on / off |
--code-wrap(代码块的 white-space) |
data-glass |
on / off |
不是用户设置,只跟随系统的"降低透明度";翻译成材质(见「材质」) |
data-motion |
full / reduce / off |
--motion、--dur-*(见「动效」) |
- 首帧前
index.html的内联脚本按同样的规则先套一遍,避免闪;改解析规则时它和prefs.js的apply()一起改。 - "跟随系统"在 JS 里解析:属性永远是解析后的值,CSS 里不写
@media (prefers-reduced-*)。
组件
每个组件把可调的地方开放成自己的变量。变体、尺寸和上下文覆盖都只改变量,不改属性:
.btn.primary { --btn-bg: var(--primary); --btn-fg: var(--on-primary); … } /* 变体 */
.notice .btn { --btn-h: var(--ctl-sm); --btn-px: var(--space-2-5); } /* 上下文 */
| 组件 | 类名 API | 变量 |
|---|---|---|
| 按钮 | .btn [primary|ghost|danger] [sm|lg] [block] |
--btn-h --btn-px --btn-r --btn-fs --btn-bg --btn-bg-hover --btn-bg-press --btn-fg --btn-fg-hover |
| 毛玻璃 | .glass(组件自己是玻璃时直接写三行,见「材质」) |
--glass-bg --glass-blur --glass-shadow |
| 图标 | Icon(svg.ic [ic-xs|ic-sm|ic-md|ic-lg|ic-xl] [ic-strong]),见下文「图标」 |
--ic-size --ic-w |
| 图标按钮 | .icon-btn [xs] [on];IconButton 的 iconSize 缺省 sm |
--ib-size --ib-r --ib-fg --ib-fg-hover --ib-bg-hover --ib-bg-on --ib-bg-press |
| 文字按钮 | .text [danger|accent] |
— |
| 输入框 | .field [mono] [err],.field-wrap > .field + .tail;边是 --ctl-edge(≥ 3:1),底透明 |
--field-h --field-px --field-r --field-bg --field-edge --field-edge-hover --field-edge-focus --field-ring |
| 状态 / 计数 / 点 | .badge [ok|err|warn|off](状态点 + 文字),.badge.count [warn](计数,唯一带底的徽标),.dot [ok|err|warn] |
--badge-fg(点的颜色;计数的字色)--badge-bg(只对计数),--dot-bg |
| 列表行 | .list > .row [compact] [clickable] [off] [flash],.row-edit,.list-head;.list 是一块 --well,行间 --line-2 |
--row-h --row-py --row-pl --row-pr --row-gap |
| 分段 | Seg 组件(.seg > .thumb + button),两个以上的选项 |
--seg-r --seg-pad --seg-thumb --seg-on |
| 开关 | Switch 组件(button.switch[role=switch] [sm]),只有开 / 关 |
--switch-w --switch-h --switch-pad --switch-track --switch-track-hover --switch-dot |
| 档位滑块 | Stops 组件(.stops[role=slider] [custom] > .stops-fill + .stops-dot + .stops-knob),几档离散的值;value = -1 不在任何一档上 |
--stops-h --stops-pad --stops-track --stops-fill-bg --stops-knob-bg --stops-dot-bg --stops-dot-on |
| 菜单 | .pick,.pop,.palette,Menu / MenuButton / Popover。Popover 挂在 <body> 下,滚动时跟着锚点,只淡入 |
--pop-r --pop-pad |
| 对话框 | Sheet / confirmSheet()(.scrim > .sheet [wide]);标题行右边是关闭钮(确认框没有);扫码、等待授权的内容放在 .qr-flow 里居中 |
--sheet-w --sheet-r |
| 分隔条 | Splitter(.splitter [dragging]),见下文「分隔条」 |
--split-x --split-hit --split-line-w --split-inset --split-line-on;悬停色是语义 token --split-line |
| 提示胶囊 | toast() / saved() / failed()(.toast [ok|err|warn]) |
--toast-bg --toast-fg |
| 行内提示 | Notice(自带图标)/ .notice [amber|red]:淡底 + 图标 + --fg 字,不描边 |
--notice-bg --notice-ic |
| 加载 | Spinner、Skeleton(.skel [circle])、.empty-state |
— |
| 头像 | BotAvatar [bot|char] [state] [cue] [lively] [pokeable] [greet] [neutral]、AvatarPicker、AppMark;6 个内置角色,见下文「头像」 |
--avatar-aura --avatar-shadow(主题),角色颜色 --bot-*(原画色,两个主题相同) |
JS 组件(ui/components/ui.js)只是给常用组合一个带逻辑的写法(loading、图标、无障碍属性);直接写类名同样合法。
图标
线性图标,16 格画布、currentColor、圆头圆角(ui.js 的 P,样式 components/icon.css)。细、轻、少:图标是文字旁边的记号,不和文字抢分量。
| 档 | size |
像素 | 用在 |
|---|---|---|---|
| xs | "xs" |
12 | 下拉箭头(.pick、模型胶囊,上下文自动给)、.icon-btn.xs 里的关闭、实心圆点里的勾、列表行尾的 › |
| sm | "sm" |
14 | 默认:Button / IconButton / Notice / 菜单的图标和勾、输入框尾部、行内操作(刷新、删除、复制)、侧栏和弹出层的搜索 |
| md | "md" |
16 | 顶栏与工具栏按钮(新对话、信息面板、关闭)、侧栏的新建 / 导航 / 账户 / 返回、对话输入框(加号、发送、停止、回到底部)、命令面板搜索 |
| lg | "lg" |
20 | 模板卡 |
| xl | "xl" |
24 | 文件卡片 |
- 线宽按显示像素算:
--ic-stroke(1.25px)对所有尺寸都一样,12px 的箭头和 24px 的文件图标一样细;icon.css把它换算回画布单位(× 16 / 尺寸)。只有实心面上的图标加strong(--ic-stroke-strong1.6px):发送钮的箭头、完成圆点里的勾——细线压在实心面上会发虚。不要再传任意的stroke。 - 只用这五档,不写 13、15、17 这类中间值。图标和旁边的文字差不多高或略高一点:12.5–13px 的控件文字配 14,侧栏和顶栏配 16。
- 上下文改尺寸只改
--ic-size(.pick .ic { --ic-size: var(--ic-xs) }),不要直接写width / height——那样线宽会跟着缩放。icon.css全部包在:where()里,任何上下文选择器都能盖过size属性。 - 实心的小部件(信息 / 警告的点、省略号、停止方块、调色盘的色点)在
P里写成{ s: 描边, f: 实心 },用dot(x, y, r)画圆点,不靠加粗线头冒充圆点。 - 新图标:留 1.75 格左右的边距(主体落在 2–14 之间),拐角 .75 的圆角,能用一条线就不用两条;画好在样例页「图标」一节里和现有图标并排看一遍粗细和大小。
动效
| 用途 | 时长 | 缓动 |
|---|---|---|
| 悬停、按下、颜色变化,下拉菜单出现 | --dur-fast 100ms(--t-fast) |
--ease-out |
| 出现 / 消失、提示胶囊、对话框、视图切换 | --dur-base 140ms |
入场 --ease-out,退场 --ease-in |
| 分段 thumb | --dur-moderate 180ms |
--ease-out |
| 布局滑动:信息面板开合、分隔条恢复默认 / 键盘调宽 | --dur-slow 240ms |
--ease-spring |
| 悬停意图:停住多久才亮起提示(分隔条的细线) | --dur-intent 240ms |
只延迟出现,移开立刻消失 |
| 循环(转圈、骨架、文字微光、呼吸、光标) | --dur-spin --dur-shimmer --dur-sheen --dur-pulse --dur-blink |
linear / --ease-in-out |
- 简约(用户 2026-11-03 要求):出现 / 消失只淡入淡出,不位移、不缩放、不回弹;按下只深一级底色。唯一的位移是窄窗口的信息面板抽屉;机器人头像的动作不算在内。
- 关键帧库(
base/motion.css):fade-in/out、slide-in/out(只给抽屉)、flash、spin、shimmer、sheen(文字微光,配background-clip: text)、breathe、blink。关键帧只描述起止,时长缓动由使用处给 token。 - 减少 / 关闭动画:看
<html data-motion>(full | reduce | off,设置 › 外观 › 动画;跟随系统时看prefers-reduced-motion)。抽屉的位移乘以--motion;reduce时--motion: 0,抽屉退化成纯淡入,过渡几乎瞬时;off时--dur-fast … --dur-slow也变成--dur-off,出现 / 消失 / 视图切换瞬时完成,只留转圈、骨架、光标这类"正在进行"的循环和定位闪烁。新写的关键帧也要乘--motion;CSS 里不要再写@media (prefers-reduced-motion),JS 用reducedMotion()(design/motion.js)。 - 退场动画:用
usePresence(open)(design/motion.js)让组件在退场时长内保持挂载,并给元素加.leaving/.anim-*-out。DialogHost是参考实现。列表里的行增删用useListPresence(items):新行淡入,删掉的行留在原位淡出,见侧栏的机器人列表。 - JS 里不写死毫秒数:
ms("--dur-base")读 token(toast 的移除时机就是这样同步的)。 - 每个动画都要有明确的表意:只用来表达状态变化(出现 / 消失、选中、成功 / 失败)、对操作的反馈、真实在进行的过程(加载、生成、传输)、机器人的状态。严禁背景 / 装饰层的动画——背景、光晕、边框、纹理一律静止:不做自己循环的光圈 / 光框扩散("隧道"、涟漪、雷达波)、呼吸的光晕、沿边框巡游的扫光、漂浮的光斑 / 粒子、跟随指针的点阵 / 聚光灯。说不出"它在告诉用户什么"的动画一律不加(官网同一条,见
site/README.md)。 - 只给
transform和opacity做动画;空闲列表保持安静(头像空闲时只在指针靠近时看过去、悬停时抖一下天线,不自己动)。唯一的例外是对话里很快答完时工作状态行的收起(.work.gone,grid1fr → 0fr,只播一次),为的是正文不跳。
对话流的编排(ui/css/chat.css):发出 → 思考 → 输出 → 收尾,每一步只动一样东西,只淡入淡出,循环都放慢、对比只差一档,余光里知道"在动"就够了。
| 环节 | 动什么 | 怎么动 |
|---|---|---|
| 发出 | 你的气泡 | fade-in(base) |
| 思考 | 工作状态行 | 比气泡晚 --stagger 淡入;"思考中"是 sheen 微光 |
| 输出 | 新段落 / 列表项 | 新挂载的块淡入(moderate),已在的不重播;最后一段末尾一个 breathe 小点(代码块、表格结尾不画) |
| 收尾 | 状态行、操作 | "用时"换字淡入、细线淡入;短于 3 秒的整行平滑收起;最后一条回复的复制 / 时刻晚一拍淡入 |
| 插入 | 提问 / 审批卡、出错提示、交付的文件 | fade-in |
| 输入框 | 边、发送钮 | 聚焦时边深一级;发送、停止互换时图标淡入;点发送 / 停止不抢输入框焦点 |
| 其他 | 首次加载、回到底部 | 历史读到后整列淡入一次;回到底部淡入淡出 |
头像
内置毛绒角色分两组:6 个基础角色(原图在 anymodelbot_design/logo avator/)和 12 个领域专家(原图在它下面的 专家/)。蓝色的天天是默认头像:默认机器人、新建页的默认选择、启动和连接页的吉祥物都是它。
角色只决定长相和小动作,不决定机器人做什么:不要给基础角色写岗位或"适合配给谁",模板也不绑定角色。领域专家的形象带领域(用户 2026-11-03 要的),选了也只换长相,人设、模型和能力不变。
| 角色 | key | 招牌动作 |
|---|---|---|
| 天天 | blue |
天线晃、天线球亮、一圈圈发信号 |
| 闪闪 | yellow |
星星一闪一闪、完成时像硬币一样转 |
| 芽芽 | green |
叶子被风吹、完成时长高一截、出错时蔫了 |
| 哒哒 | red |
耳机灯带跟着节拍亮、耳机震 |
| 晶晶 | purple |
宝石浮起来转、霓虹线一明一暗 |
| 飞飞 | orange |
眼睛大范围搜寻、护目镜反光 |
领域专家(选择器里单独一组,名字下面写领域):
| 角色 | key | 领域 | 招牌动作 |
|---|---|---|---|
| 衡衡 | law |
法律 | 天平左右晃 |
| 安安 | health |
医疗健康 | 爱心一跳一跳 |
| 元元 | finance |
金融 | 金币闪一下,完成时翻两圈 |
| 码码 | code |
编程 | 霓虹线一明一暗(发光层),完成时闪三下 |
| 彩彩 | design |
设计 | 调色盘左右晃 |
| 墨墨 | writing |
写作 | 羽毛被风吹,完成时竖高一点 |
| 学学 | education |
教育 | 帽子不动:流苏垂到头上,帽子一动就断开 |
| 泡泡 | science |
科研 | 烧瓶一亮一亮,完成时长高一点 |
| 数数 | data |
数据分析 | 柱子一亮一亮,完成时长高一点 |
| 响响 | marketing |
营销 | 喇叭跟着节拍震 |
| 香香 | cooking |
烹饪 | 厨师帽左右晃 |
| 通通 | translate |
翻译 | 地球仪慢慢转,完成时转两圈 |
- 选择:机器人设置的
settings.avatar(新建页和机器人设置里选);没选过时charOf(bot)由 id 稳定地在基础角色里挑一个(不能用全部角色,否则加角色时老机器人的头像会变),default机器人是天天。 - 持续状态
state:idle、listening(你在输入)、thinking(还没出字)、replying、working(后台任务)、waiting(等你批准)、sleep(连不上本机服务)。 - 一次性反应
cue={ kind, at }:hello(新建 / 打招呼,greet在挂载时播)、done(忙 → 不忙时自动播)、error、以及戳头像触发的poke/love(连戳三下)/dizzy(戳六下)。时长是tokens/motion.css的--bot-*。 - lively:只给大头像(空态、新建页、启动页):呼吸、眨眼、四处看、脚下有影子。小于 36px 不画粒子。
- 图层:
python3 scripts/build-bot-avatars.py把每张原图拆成头(眼睛已抹掉)、两只耳朵、头顶配件和发光部分,输出design/bots/<key>.webp(8 格精灵图)。眼睛是avatar.js画的 SVG,才能眨眼和换表情(睁眼、开心、闭眼、难过、××、晕、爱心)。换原图后重跑脚本,几何有变化时同步BOT_CHARS里的百分比。
文案
最短、能说清就行:不加解释性的括号,不写说明段落。健康、空闲时什么都不显示。
一行里有状态,又跟着别的状态或事实(时间、花费、次数)时,写成一句自然的短句,不用「·」把碎片串起来:
写成 不写成 进行中,有个问题等你回答 进行中 · 有个问题 已进行 12 分钟,花了约 $0.08 进行中 · 12 分钟 · 约 $0.08 观察中,明天 08:00 再运行 观察中 · 下次 明天 08:00 第 1 次运行,用了 12 分钟 第 1 次 · 开始 · 34 步 · 12 分钟 天天的「GPU 价格调研」在等你回答 天天 · GPU 价格调研 · 等你回答 后台任务「GPU 价格调研」进行中 后台任务 · GPU 价格调研 · 进行中 规则「看 X 价格」已观察 3 次,需要你来决定是否执行 已观察 3 次 · 改为执行? 句子里不帮人做决定的细节直接去掉,不往句子里塞(上面的「开始」「34 步」就是这样去掉的)。
不把「·」换成逗号了事:「Marla,由企业钱包付费」「需要你的批准,编号 A7K2」这样只是标签加碎片的,要么写成一句不带逗号的完整的话(「Marla 的费用由企业钱包支付」),要么留着「·」(「需要你的批准 · A7K2」)。
「·」只留给没有状态词、让人扫一眼的紧凑元信息:模型的上下文 · 能力 · 价格,「微信 · 3 天前」这样的来源和时间,运行记录展开后的「第 1 版 · 只读 · 手动运行」,诊断信息。
英文同样写成自然的句子,不照搬中文的断句:「Observing, next run tomorrow 08:00」「Run 1 took 12m 0s」「Ping: “GPU price research” is waiting for your answer」。句中的 today、tomorrow 小写。
中文、英文都要有(
ui/locales/,服务端的在src/i18n/messages/)。
新增或修改
- 先在样例页里找现成的 token、组件、文字角色。
- 缺颜色 →
semantic.css加语义 token(浅色、深色各一个值);缺间距 → 先找同一用途的间距角色,没有再在semantic.css的间距块里加一个(取值来自--space-*);缺尺度 →primitives.css。 - 新组件 →
components/<name>.css,开放--<name>-*变量,在index.css按层引入;需要逻辑时在ui/components/ui.js加 JS 写法;在gallery.js加样例。 - 页面专属样式写在
ui/css/*.css的@layer app里,只引用 token。 - 跑
npm test。
守卫测试会拦下
ui/design/tokens/之外出现原始颜色(#hex、不含var()的rgb()/hsl())font-size/font里写死 pxborder-radius写死 ≥ 3px(1–2px 的细节、50%不算)transition/animation里写死时长或缓动(linear、steps()可以)z-index写死数字- 间距写死 px:
margin/padding/gap/inset/top|right|bottom|left/scroll-margin|padding,以及--*-gap|pad|px|py|pl|pr|pt|pb|inset|gutter这类间距变量;calc()里加减写死的 px。0、≤1px 细线、同一行带/* 微调:… */注释的除外 - JS 内联样式里写死颜色、字号或间距
- 描边容器:
border/outline带宽度,或box-shadow(包括自定义属性的值)里画一圈0 0 0 <宽>的边,而同一行没有/* 描边:… */;:focus*选择器里的焦点描边除外 - 侧边色条:左右两侧 ≥ 2px 的
border,或box-shadow: inset Npx 0 0;以及上下 > 1px 的分隔线(var(--hairline)算 1px) - JS 内联样式里画边框
text-transform: uppercase和正的letter-spacing(小标签不全大写、不加字距)- 引用了没定义的
var(--x)(带回退值的除外) - 有组件或基础样式文件没在
index.css里引入
组件文件里确实需要的"魔法数"(比如头像的眨眼周期),先起名再用:--bf-blink: 4.2s。自定义属性的定义不受时长规则限制,但要写清楚用途。