DESIGN.md · diff

git:20261026.edece16 to git:20261027.f9237d2

7 added, 0 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-10-25:保留现有三栏工作台、会话列表和聊天输入区;Hotline 用暖白底、珊瑚强调色和耳机标识建立识别。
> 本文件是前端视觉的唯一事实源;改风格先改这里,再动 `style.css` / `console.css`。
## 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`、失败=红、草稿=灰。
## 3. 排版规则
- 中文正文系统栈(PingFang SC → Microsoft YaHei → Noto Sans SC),正文 13–14px,行高 1.6+
- 数字/耗时/版本号一律等宽 + `font-variant-numeric: tabular-nums`(Consolas 族)
- 层级靠字重(400/500/600)与颜色,不靠放大字号;标题 `letter-spacing` 收紧
## 4. 组件样式
- 会话=任务卡:两行结构(状态点+标题+耗时 / agent 徽章+相对时间),圆角 9px,运行中卡左侧 2px accent 竖条并置顶到「运行中」分组
- 时间线:步骤条目(标记 + 描述 + 等宽耗时),完成后默认折叠为一行摘要「N 步 · 耗时」
- 主按钮使用当前强调色;hover 只动背景与描边色,140ms ease-out
- 控制台(/console)与主应用共用同一套令牌
## 5. 布局原则
- 侧栏 256px 定宽、`height: 100dvh` 内部自滚动——**禁止让侧栏内容撑高文档**
- 任务卡采用紧凑内边距(4px 8px)、徽章/时间 10–10.5px,两行结构保留信息;保持 Hotline 自己的图标与品牌元素
- 主区三行:顶栏 57px / 消息流 `minmax(0,1fr)` / 输入区 auto,文档高度恒等于视口
- 会话列表分组顺序:运行中 → 草稿 → 最近;空态必须给出下一步指引
## 6. 深度层级
无阴影堆叠;层级 = 背景色阶(canvas < sidebar < surface < hover)+ 描边。浮层(dialog/backdrop)用黑色 50–60% 遮罩 + surface 底。
## 7. Do / Don't
- ✅ 白色聊天画布、浅灰侧栏、白色聊天输入区、珊瑚强调色、等宽数字
- ❌ 纯黑 `#000`、紫蓝渐变、玻璃拟态、外发光、`transition: all`
- ❌ 斜体(中文);❌ 靠字号砸层级;❌ 危险操作无确认
## 8. 响应式
<800px 侧栏转 fixed 抽屉(`mobileSidebarOpen` 控制);任务卡两行结构在窄抽屉内不换行溢出(`min-width: 0` + ellipsis)。
## 9. Motion 哲学
只动 `transform` / `opacity`;状态点脉冲 1.6s(`prefers-reduced-motion` 时关闭);按压 `scale(0.97)`;列表 hover 130–140ms;无入场编排。
+ ## 10. Harness 控制台
+
+ - Harness 使用 Hotline 暖白画布、浅灰侧栏、白色工作面和珊瑚色主操作;运行、审批、失败分别使用绿色、琥珀、红色语义色。
+ - 导航宽度约 232px;桌面工作台分为执行队列、运行详情、运行检查三列。指标与运行节点使用整行信息带,不嵌套卡片。
+ - 中屏收敛为队列与详情两列,运行检查移至下方;窄屏使用导航抽屉与单列纵向阅读。宽表格在自身容器滚动,不撑宽页面。
+ - 以描边和背景色阶区分面板;避免重阴影、渐变和玻璃效果。次要文字保持可读对比度,图标按钮至少 34px,主要操作至少 38px。
+ - Harness 示例数据明确标注演示状态;未接入 API 的区域显示规划状态,不暗示能力已上线。