tako 文档 GitHub

51 · UI 视觉重做(中性现代风 + 手机抽屉)

性质:已落地(2026-10-24,U1–U7)。 状态:✅ 落地。U1 token 层 / U2 侧栏三段式 / U3 侧栏收色 / U4 三页骨架与弹层 / U5 气泡与输入区 / U6 手机抽屉 / U7 四档收口全部施工并机器验收;实测数字见 §7。 来源:2026-10-24 用户「现在挺差的,你可以去优化 UI 设计了」;两问已拍——视觉方向 = 中性现代风(浅灰白 + 单一强调色),手机 ≤860px = 抽屉式。 真源关系:侧栏树的结构与交互(折叠、10 条上限、展示全部)仍由 doc/50 定义,本篇只改呈现层;页面职责是 doc/44、doc/42;响应信封 doc/40 不动。 不改后端契约、不改交互流程,只动 CSS 与少量模板结构(抽屉重复使用同一棵树的 DOM/状态,没有复制数据)。


0. 病灶:在真屏幕上,这套界面有四个具体失败

2026-10-24 用 Playwright 无头跑 1440×900 与 390×844 两档实拍(图在 /tmp/tako-ui/,不入库),不是凭印象:

  1. 侧栏底部压住内容(1440×900)。.rail 是 flex 列、.recent 有 min-height: 0 但树内容 overflow: visible,.rail-foot 又是 margin-top: auto。10 条会话 + 3 个项目行超过可用高度后,树继续往下画,用户卡片和「退出」直接盖在「验收项目」和「展示更多」上——最下面那行会话点不到。
  2. 手机端聊天被挤成一条(390×844)。≤860px 时 .rail 变成三行 grid,整棵项目树留在顶栏里,占掉约 560px;聊天正文只剩底部约 120px,输入框贴底。打开会话要先看过半屏的目录。
  3. 没有层级与比例。同一页里:页面标题 24.8px/620、卡片标题 14px、正文 15px、侧栏会话 12.8px、按钮 12.8px;圆角同时存在 999 / 22 / 18 / 14 / 10 / 5px 六种;阴影里外混用;卡片是暖白贴米底,几乎看不出边界。
  4. 对话像两块贴纸。用户气泡 474px 宽、助手气泡 232px 宽,宽度全由内容决定、左右跳动;用量与「复制」是 12px 灰字塞在气泡底部,读起来像脚注;助手气泡的表格/代码块没有统一的内边距。

第 1、2 条是功能伤(点不到 / 没法用),第 3、4 条是观感伤。先修功能伤再统一观感。

1. 拍板(2026-10-24)

项 取值
视觉方向 中性现代风:浅灰白底、白色卡片、1px 细边、单一蓝色强调色;去掉米色与暖阴影
手机 ≤860px 抽屉式:顶栏只留 品牌 / 新对话 / 菜单;导航 + 项目树 + 账户进左侧抽屉;聊天占满屏

2. 为什么先做 Token 层

现在颜色和尺寸是散着写的:8 个组件里 150 处硬编码颜色(App.vue 99、Configure.vue 16、ProjectsView.vue 12、MembersView.vue 8、ConfirmDialog.vue 6、InviteLanding.vue 5、PlanDoc.vue 3、PendingInvites.vue 1),还有 #f6f1e7、#8fbfb0、rgba(15,110,86,.1) 这类直接写死的值。方向一换,逐页找颜色改必然漏,而且下次再换还来一遍。所以第一拍只做一件事:把颜色/字阶/间距/圆角/阴影收进 base.css 的变量,组件里换成变量引用;视觉变化先只在 token 层生效,结构不动。

3. Token 取值(落 web/src/base.css)

--bg: #f6f7f9;          /* 页面底:冷灰白 */
--bg-raised: #ffffff;   /* 卡片/气泡 */
--sidebar: #fbfbfc;     /* 侧栏:比页面略亮 */
--ink: #14161a;         /* 主文字 */
--ink-soft: #3d434d;    /* 次要文字 */
--muted: #6b7280;       /* 说明/时间 */
--line: #e6e8ec;
--line-strong: #d3d7de;
--accent: #2f6feb;      /* 单一强调色 */
--accent-ink: #1d4ed8;
--accent-soft: #eaf1fe;
--danger: #d92d20;  --danger-soft: #fef3f2;
--warn: #b54708;    --warn-soft: #fffaeb;
--shadow: 0 1px 2px rgba(16,17,20,.05), 0 12px 32px rgba(16,17,20,.08);
--radius: 12px;

字阶与间距(同样进 :root):

名称 值 用在哪
--text-xs 12px 时间、kicker、徽标
--text-sm 13px 按钮、侧栏、次要说明
--text-base 14px 卡片正文、表单
--text-md 15px 对话正文
--text-lg 17px 卡片标题、区块标题
--text-xl 22px 页面标题
--space-1..6 4 / 8 / 12 / 16 / 24 / 32px 全站间距

圆角只有三档:8px(控件)/ 12px(卡片、气泡)/ 16px(面板、抽屉);999px 只给状态徽标与 chip。

4. 侧栏:三段式(修病灶 1)

5. 手机抽屉(修病灶 2)

6. 其余三块

页面骨架(项目 / 助手 / 团队)

对话页(修病灶 4)

细节

7. 验收

四档截图:1440×900、1024×768、700×900、390×844(Playwright 无头,脚本放 tmp/51-UI重做/)。判据都能脚本断言:

  1. 侧栏不重叠:900px 高、10 条会话时,rail-foot 的 top ≥ tree 的 bottom;.tree 的 scrollHeight === clientHeight。
  2. 手机可用:390×844 时聊天列表可视高度 ≥ 560px;抽屉能用遮罩 / Esc / 打开会话三种方式关闭。
  3. 对比度:正文对背景 ≥ 7:1,次要文字 ≥ 4.5:1(按相对亮度脚本算)。
  4. 无横向溢出:四档 document.documentElement.scrollWidth === clientWidth。
  5. 一致性:控件(有边框或实色底的按钮/输入)高度只有 28(小号)与 32(普通)两档,列表行 30(会话)与 34(项目);圆角只出现 4 / 8 / 12 / 14 / 16 / 999 / 50%(气泡 14 与同侧下角 4 在 U5 定义)。
  6. 回归:npm run typecheck、npm test;scripts/check-master-plan.sh。

实测(2026-10-24,U7 收口)

node tmp/51-UI重做/verify.mjs all,同一账号打开有问答的会话逐档量(Playwright 无头,Node 22):

档位 溢出 正文对比度 次要文字对比度 圆角集合 控件高 / 行高
1440×900 0 16.88:1(--on-ink on --ink) 4.51:1(--muted on --bg) 4/8/14/16/50% 28/32 · 30/34
1024×768 0 同上 同上 同上 同上
700×900 0 同上 同上 同上 32 · —(树在抽屉里)
390×844 0 同上 同上 同上 32 · —

8. 明确不做