tako 文档 GitHub

50 · 侧栏项目树(项目 → 对话二级)

性质:方案(2026-10-24 立项)。 状态:✅ 已落地——A1(数据层:会话按项目分组、默认项目第一、未归项目殿后)、A2(二级树与空态)、A3(展示更多 +10 / 收起)、A4(整栏 10 条 + 项目内 10 条双层上限、文件夹图标)均已施工并浏览器验收;A5 于 2026-11-15 收口:workspace_renamed / workspace_deleted 触发侧栏树重拉(App.vue 的 onMutation),窄屏一项由 doc/51 U6 覆盖。验收:web/e2e/sidebar-events.spec.ts 三条(同窗口改名、跨窗口改名、跨窗口删项目),先红后绿;npm run typecheck / npm run build 通过。commit cba0339。台账 tmp/50-侧栏项目树/(不入库)。 真源关系:侧栏现状来自 doc/48 A2(「最近会话」快捷回跳);会话与项目的归属规则是 doc/42、doc/44;跨窗口失效逻辑是 doc/46。 呈现层已重排(2026-10-24):doc/51 U2/U6 把侧栏改成三段式,并在 ≤860px 收成 52px 顶栏 + 280px 抽屉——树本身的结构与交互(折叠、整栏 10 条 / 项目内 10 条、「展示全部」)仍是本文真源。A5 的「窄屏」一项已由 doc/51 U6 实测覆盖(390×844 聊天列表 699px、抽屉遮罩 / Esc / 开会话三法关闭);A5 的 workspace_renamed / workspace_deleted 事件重载已于 2026-11-15 落地。 不改后端契约:GET /api/workspaces + GET /api/sessions 的现有字段已经够拼出这棵树。


0. 病灶:侧栏找不到「那个项目里的那个对话」

用户在 A 项目里和 agent 调了十几轮,过两天回来想接着聊。侧栏只有一列「最近会话」:扁平的 10 条标题,项目名一个都不在,第 11 条起要靠列表内部那条滚动条去翻。翻不到时唯一的出路是点「在项目页看全部 →」跳到项目页,点开项目、找到会话、再点回来——回一个对话要三步,而侧栏本来就是为「一步回去」建的。

更糟的是「没有把所有项目都显示出来」:一个项目最近没动静,它的对话就彻底沉到 10 条之外,用户在侧栏上看到的世界和真实存在的项目对不上。

修完的目标:侧栏本身就是一张全量目录——所有项目都在,每个项目下面挂着它的对话,项目可以收起/展开;整栏再多也只在 10 条以内,想看更多点「展示更多」,不出现列表内滚动条。

1. 目标形态(三问已拍,2026-10-24)

决策 取值
「展示更多」口径 整栏合计 10 条对话;点一次就地再放 10 条;全部展开后按钮变「收起」,点回收起到 10 条
项目范围 全部项目都列;空项目下显示一行灰色「还没有对话」
展开状态 默认全部展开;点项目行收起/展开(手风琴)
项目内口径(2026-10-24 追加) 每个项目再限 10 条;项目内超 10 条时该项目下出「展示全部」,点开只放开这一个项目(按钮变「收起」),其它项目仍受整栏上限
项目行识别(2026-10-24 追加) 项目名前的记号是文件夹图标,展开态画开口文件夹、折叠态画合口文件夹(图标本身就是状态指示,不再另画 ▸/▾)

2. 数据从哪来(零后端改动)

一次 GET /api/workspaces(本人项目,服务端按 created_at 升序;默认项目不保证在第一——实测本账号「验收项目」比「默认」早建 107 ms)+ 一次 GET /api/sessions(不带 workspaceId = 本人全部会话,每行带 workspaceId)。

客户端把会话按 workspaceId 挂到项目下:

3. 交互细节

4. 别的窗口改了数据怎么办(doc/46)

5. 验收

6. 明确不做