DESIGN.md · diff
git:20261107.da2f62b to git:20261109.2bf8c5a
59 added, 67 removed. Audit A to A.
What this update changes in the checks
No check changed: every fixed check gives the same answer before and after this update.
A tripped check is a label, not a verdict: read the matched text and the lines below. This week's updates that newly trip a check.
- # Hotline Agent · UI 设计系统(DESIGN 锚)
-
- > 聊天首页于 2026-11-07 调整为 Codex 风格:中性灰侧栏、白色工作面、深灰主操作和克制排版,保留 Hotline 耳机标识及现有功能。
- > 本文件是前端视觉的唯一事实源;聊天首页样式集中在 `frontend/src/chat.css`,其他页面继续使用 `style.css` / `harness.css` / `console.css` 中的现有主题。
-
- ## 聊天首页(优先于下方通用旧主题)
-
- - 使用场景:任务操作界面。保留工具导航、会话栏、聊天工作面与可选文件面板;通过排版和留白建立层级。
- - `.chat-page` 作用域:工作面 `#ffffff`、侧栏 `#f7f7f5`、hover `#eeefec`、分隔线 `#e4e5e1`、正文 `#242522`、次级文字 `#60625c`、辅助文字 `#70726c`、主操作 `#292a27`。运行、失败等状态保留语义色。
- - 桌面工具栏 52px、会话栏 248px;标题栏 54px;正文与输入区最大宽度 760px,侧栏和消息流独立滚动,页面限定为视口高度。
- - 空白会话:耳机标识、28px / 500 欢迎标题、14px 说明与输入框组成垂直居中的任务入口;模式选择紧邻输入框,三个推荐任务置于输入框下方。移除重复品牌眉题、装饰圆环和珊瑚色胶囊。
- - 有消息时恢复顶部消息流和底部输入框;输入框圆角 16px、1px 中性描边,聚焦加深描边,发送按钮为深灰圆形上箭头。禁用、停止、上传、模式切换沿用现有行为。
- - 导航与会话正文 13px,分组 11px、会话元信息 10px;选中用浅灰背景,避免彩色徽章堆叠。图标使用现有 Lucide 系列,按钮可见键盘焦点。
- - ≤960px 会话栏为抽屉,首页标题栏保留打开按钮;≤560px 推荐任务纵向排列,模式条可水平滚动,隐藏冗长输入提示以保证发送按钮可见。低高度窗口保持输入框可达。
- - 工作区上传确认、文件授权和项目命名窗口沿用首页中性色:白色面板、16px 圆角、单层柔和阴影、深灰主按钮、8px 按钮圆角,遮罩不使用模糊。文件夹名称与统计独立展示,下方提供最多 6 项文件预览;长路径换行,长清单内部滚动,按钮在窄屏和低高度窗口保持可达。支持 Tab 焦点约束、Escape 取消及关闭后恢复焦点;上传期间不允许关闭。浏览器原生目录选择与授权窗口保持系统外观。
- - 以上规则限聊天首页;Harness 和独立工具页的布局与主题不在本次调整范围。
-
- ## 1. 视觉主题与氛围
-
- 白色聊天画布、浅灰侧栏、白色输入区与珊瑚色交互强调。Hotline 通过客服耳机品牌标识和按功能语义区分的图标建立识别;保持克制、清晰,拒绝渐变与光晕。三栏布局、会话列表和聊天输入区保持现有产品约定,只做小幅视觉调整。
-
- ## 2. 色板与角色
-
- | 令牌 | 值 | 角色 |
- | --- | --- | --- |
- | `--canvas` | `#f5f6f4` | 应用外层画布;聊天工作区单独为白色 |
- | `--sidebar` | `#ecefeb` | 浅灰会话侧栏 |
- | `--surface` | `#ffffff` | 卡片/输入框/浮层 |
- | `--surface-hover` | `#edf1f7` | 浅灰蓝 hover 态 |
- | `--line` / `--line-soft` | `#d4dce8` / `#dfe5ee` | 描边(两档) |
- | `--text` / `--text-secondary` / `--muted` | `#222d40` / `#4c5a70` / `#68768b` | 三级文字 |
- | `--accent` | `#c96345` | 珊瑚强调:选中、链接与主要操作 |
- | 工具栏 | `#ffffff` | 白色聊天输入区 |
- | `--error` / `--warning` | `#c64f52` / `#a96918` | 语义色 |
- | 主按钮/发送 | 当前强调色 + 白字 | 主要操作 |
-
- 任务卡徽章(agent 类型):蓝 `#9db4ff` / 青 `#5ecfbc` / 琥珀 `#e5b16f` / 天蓝 `#67c3e8`,底为同色 12% 透明。状态点:运行中=薄荷绿脉冲、完成=绿 `#5ad08a`、失败=红、草稿=灰。
+ # Hotline Agent UI 设计系统
- ## 3. 排版规则
+ 本文件是前端视觉唯一事实源。聊天、独立工具页、Harness 和静态技能控制台共用中性色与语义色。统一调整于 2026-11-08。
- - 中文正文系统栈(PingFang SC → Microsoft YaHei → Noto Sans SC),正文 13–14px,行高 1.6+
- - 数字/耗时/版本号一律等宽 + `font-variant-numeric: tabular-nums`(Consolas 族)
- - 层级靠字重(400/500/600)与颜色,不靠放大字号;标题 `letter-spacing` 收紧
+ ## 样式入口
- ## 4. 组件样式
+ - `static/console/tokens.css` 定义共享颜色、字体、圆角、阴影、遮罩与旧变量别名。Vue 通过 `frontend/src/main.js` 导入,静态技能控制台通过 `/console/tokens.css` 加载。
+ - `frontend/src/style.css` 承载主应用和独立工具页的结构与组件样式。
+ - `frontend/src/chat.css` 承载聊天布局与工作区授权弹窗,使用共享颜色。
+ - `frontend/src/harness.css` 承载 Harness 布局。选择器限定在 `.harness-shell`,避免同名顶栏、时间线和按钮影响聊天页。
+ - `frontend/src/theme.css` 统一通用控件、焦点、禁用态、弹窗高度与小屏补充规则。
+ - `static/console/console.css` 承载独立技能控制台的结构与组件样式。
- - 会话=任务卡:两行结构(状态点+标题+耗时 / agent 徽章+相对时间),圆角 9px,运行中卡左侧 2px accent 竖条并置顶到「运行中」分组
- - 时间线:步骤条目(标记 + 描述 + 等宽耗时),完成后默认折叠为一行摘要「N 步 · 耗时」
- - 主按钮使用当前强调色;hover 只动背景与描边色,140ms ease-out
- - 控制台(/console)与主应用共用同一套令牌
+ ## 色板
- ## 5. 布局原则
+ | 令牌 | 浅色 | 深色 | 用途 |
+ | --- | --- | --- | --- |
+ | `--canvas` | `#ffffff` | `#1a1b18` | 工作画布 |
+ | `--sidebar` | `#f7f7f5` | `#202220` | 侧栏 |
+ | `--surface` | `#ffffff` | `#212320` | 表单、浮层和卡片 |
+ | `--surface-subtle` | `#f5f6f2` | `#242622` | 预览、代码片段和辅助区 |
+ | `--surface-hover` | `#eeefec` | `#2e312b` | 悬停和选中 |
+ | `--line` | `#dedfda` | `#484c42` | 控件和面板描边 |
+ | `--line-soft` | `#e4e5e1` | `#34372f` | 分隔线 |
+ | `--text` | `#242522` | `#e8eae4` | 正文 |
+ | `--text-secondary` | `#60625c` | `#b2b6ad` | 次级文字 |
+ | `--muted` | `#696c64` | `#a0a599` | 辅助文字 |
+ | `--accent` | `#292a27` | `#e9ece5` | 主操作 |
+ | `--on-accent` | `#ffffff` | `#1a1b18` | 主操作前景 |
+ | `--success` | `#287a50` | `#80c79a` | 成功和在线 |
+ | `--warning` | `#8a5c16` | `#e0b06a` | 等待、审批和警告 |
+ | `--error` | `#b73e43` | `#ef9696` | 失败和危险操作 |
- - 侧栏 256px 定宽、`height: 100dvh` 内部自滚动——**禁止让侧栏内容撑高文档**
- - 任务卡采用紧凑内边距(4px 8px)、徽章/时间 10–10.5px,两行结构保留信息;保持 Hotline 自己的图标与品牌元素
- - 主区三行:顶栏 57px / 消息流 `minmax(0,1fr)` / 输入区 auto,文档高度恒等于视口
- - 会话列表分组顺序:运行中 → 草稿 → 最近;空态必须给出下一步指引
+ 信息类链接与分类图标使用 `--info`、`--violet` 及对应浅背景。语义状态同时显示文字,避免只靠颜色传达信息。`--h-*`、`--bg`、`--card` 等兼容变量映射到共享令牌,不单独定义调色板。
- ## 6. 深度层级
+ 显式 `data-theme="light"` 或 `data-theme="dark"` 优先。未指定主题时通过 `prefers-color-scheme` 跟随系统,系统主题变化由 CSS 响应。代码高亮区保留深色代码背景。
- 无阴影堆叠;层级 = 背景色阶(canvas < sidebar < surface < hover)+ 描边。浮层(dialog/backdrop)用黑色 50–60% 遮罩 + surface 底。
+ ## 排版与控件
- ## 7. Do / Don't
+ - 系统字体栈优先使用 Segoe UI、苹方、微软雅黑和 Noto Sans SC。正文 13–14px,行高约 1.6。
+ - 聊天欢迎标题 28px,小屏 24px。独立工具页标题 24px,设置区标题 18px。Harness 保持紧凑信息密度,辅助文字至少 11px。
+ - 编号、版本、耗时与测量数据使用等宽字体和等宽数字。普通表单使用系统正文字体。
+ - 主要和次要操作采用 8px 圆角,常规按钮至少 38px 高。工具图标通常 32–36px,聊天发送按钮保留圆形。
+ - 需求澄清卡片用中性描边承载:标题行说明需要确认,三个方向各占一条(标题 + 一句话说明),下方留一个自由输入框与继续按钮;按钮 8px 圆角、常规高度不小于 38px,作答后收起输入区只留一行说明。
+ - 表单、按钮、链接、下拉框和折叠摘要均有可见键盘焦点。禁用控件保持禁用光标和降低透明度。
+ - 正文、表单和预览区使用主题令牌,避免在组件中写死浅色底与深色字。
- - ✅ 白色聊天画布、浅灰侧栏、白色聊天输入区、珊瑚强调色、等宽数字
- - ❌ 纯黑 `#000`、紫蓝渐变、玻璃拟态、外发光、`transition: all`
- - ❌ 斜体(中文);❌ 靠字号砸层级;❌ 危险操作无确认
+ ## 布局与响应式
- ## 8. 响应式
+ - 聊天桌面工具栏 52px、会话栏 248px、标题栏 54px。消息和输入区最大宽度 760px,页面限定为视口高度,侧栏和消息流独立滚动。
+ - 桌面各页面共用 52px 主导航栏、36px 导航按钮和 19px 图标,切换页面保持位置与尺寸一致。文档滚动条预留固定空间,避免内容横向跳动。
+ - 聊天输入区的模式栏、文字区和底部工具栏独立排列,文字区与工具栏间距 8px。聚焦时只加深圆角外框,内部文本框不再绘制矩形焦点框。多行输入在限定高度内滚动,切换页面后恢复草稿高度。
+ - 空白会话的欢迎标题与输入框居中。有消息时恢复顶部消息流和底部输入框。
+ - 主导航在 ≤960px 显示为底部图标栏,保留所有工具和设置入口并适配底部安全区。聊天在此尺寸使用会话抽屉,≤560px 推荐任务纵向排列,低高度窗口保持输入框可达。
+ - 独立工具页使用侧栏与工作面两列,≤760px 收敛为单列。插件操作在 ≤700px 分行,长名称和配置说明可换行。
+ - Harness 桌面导航约 232px,宽屏工作台按内容分列,中屏两列,≤780px 使用导航抽屉与单列内容。完整运行列表在小屏保持可访问。
+ - 宽表格在自身容器横向滚动。长路径、标识符和详情内容换行,不撑宽页面。
+ - 普通弹窗采用 16px 圆角,最大高度限制在视口内并可滚动。工作区上传、授权和命名窗口沿用聊天控件与焦点管理,上传期间不允许关闭。
+ - 添加工作区时默认折叠文件预览,只展示文件夹名称、文件数量和总大小。预览使用可点击和键盘操作的折叠标题,展开后显示最多 6 项文件与剩余数量,上传与取消按钮始终可达。
+ - 会话列表中的删除按钮直接执行删除。请求期间禁用删除按钮,成功后移除对应会话,失败时保留会话并显示错误提示。
- <800px 侧栏转 fixed 抽屉(`mobileSidebarOpen` 控制);任务卡两行结构在窄抽屉内不换行溢出(`min-width: 0` + ellipsis)。
+ ## 层级与动效
- ## 9. Motion 哲学
+ - 通过背景色阶、描边和留白区分层级。浮层使用单层柔和阴影与统一遮罩,不使用模糊遮罩。
+ - 保留 Hotline 耳机标识和现有 Lucide 图标系列。移除标题上重复的装饰性英文标签。
+ - 标题下不重复介绍页面功能,页脚不重复模块名称与职责。仅保留状态、错误、必要的格式约束和操作提示,空态使用简短说明。
+ - 悬停只调整颜色与描边,通常 130–140ms。用户选择减少动态效果时关闭循环动画与过渡。
+ - 演示、未接入、空态、加载与失败状态必须明确标注,保留现有功能含义。
+ - 流式回答的处理进度和参考来源默认折叠,输出期间保持收起,可手动展开。展开处理进度后显示当前阶段小字、文档名和工具名或技能名,过程列表使用 12px 次级文字与轻量状态图标,不添加卡片描边。仅展示实际收到的阶段,结束后折叠为步数和耗时,失败时展开记录。
- 只动 `transform` / `opacity`;状态点脉冲 1.6s(`prefers-reduced-motion` 时关闭);按压 `scale(0.97)`;列表 hover 130–140ms;无入场编排。
+ ## 验证
- ## 10. Harness 控制台
+ 前端修改运行 `npm --prefix frontend run build`。项目验证同时运行 `python -m compileall python_backend` 与 `python skill-center/test_center.py`,本机使用 `.venv/Scripts/python.exe`。
- - Harness 使用 Hotline 暖白画布、浅灰侧栏、白色工作面和珊瑚色主操作;运行、审批、失败分别使用绿色、琥珀、红色语义色。
- - 导航宽度约 232px;桌面工作台分为执行队列、运行详情、运行检查三列。指标与运行节点使用整行信息带,不嵌套卡片。
- - 中屏收敛为队列与详情两列,运行检查移至下方;窄屏使用导航抽屉与单列纵向阅读。宽表格在自身容器滚动,不撑宽页面。
- - 以描边和背景色阶区分面板;避免重阴影、渐变和玻璃效果。次要文字保持可读对比度,图标按钮至少 34px,主要操作至少 38px。
- - Harness 示例数据明确标注演示状态;未接入 API 的区域显示规划状态,不暗示能力已上线。
+ 视觉检查覆盖桌面、中屏、窄屏与低高度窗口,以及浅色、深色、焦点、禁用、空态、失败和长内容。实际业务数据与路由验证遵循根目录 `AGENTS.md`。