# 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 推荐任务纵向排列，模式条可水平滚动，隐藏冗长输入提示以保证发送按钮可见。低高度窗口保持输入框可达。
- 以上规则限聊天首页；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`、失败=红、草稿=灰。

## 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 的区域显示规划状态，不暗示能力已上线。
