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通过。commitcba0339。台账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 挂到项目下:
- 项目顺序:默认项目排第一(
isDefault),其后按接口给的created_at升序。 workspaceId = null的存量游离会话:只有存在时才多出一组「未归项目」,排在最后(实测开发库有 4 条)。- 会话在组内按
createdAt倒序(最近的在上)。
3. 交互细节
- 项目行:整行是一个按钮,左侧
▾/▸,右侧项目名;点击切换aria-expanded,展开态显示其下会话(缩进一级、字号略小)。 - 当前会话:保持高亮;打开某会话时,若它所属项目是收起状态,自动展开(否则人会「跳到一个看不见的条目」)。
- 10 条上限按整栏算:所有会话先按
createdAt倒序排成一条全局列表,取前 N 条(初始 N=10),项目分组只渲染这 N 条里属于它的条目。有会话但都被截掉的项目不显示「还没有对话」——那一行只属于真正空的项目,否则等于骗人。 - 展示更多/收起:
N += 10;当N ≥ 会话总数,按钮文案变「收起」,点击把 N 重置回 10(同时收回所有项目内的放开,否则按了看着没变)。 - 项目内也限 10 条:某一组最多先显示 10 条;组内还有没露出的(被这一层或整栏上限截住),组下出「展示全部」,点开只把这一个项目放全,按钮变「收起」。打开一条被截住的会话时,自动只放开它所属的那一个项目。
- 项目行前是文件夹图标(
--accent,15px 线稿):项目行与会话行字号只差 0.02rem,靠缩进认层级不够;展开/折叠两态用开口/合口两个 SVG,状态由图标自身表达。 - 去掉列表内滚动:删掉
.recent-list的max-height: 14rem与overflow-y: auto(含窄屏那条max-height: 9rem);高度完全由「上限 + 折叠」控制。
4. 别的窗口改了数据怎么办(doc/46)
session_deleted:从对应项目组里剪掉(现有逻辑是过滤扁平列表,改成过滤分组)。workspace_renamed:重拉一次树(loadSidebarTree())。侧栏常驻项目名,不重拉就会一直显示旧名——改名当事 tab 也一样:broadcastMutation的自回声被sourceId挡掉,兑现它的是服务端事件流(SSE 按租户扇出,不排除发起连接)。workspace_deleted:先沿用现有onWorkspaceDeleted(丢弃该项目下的会话实例、把落点清回默认项目),再重拉树——侧栏自己存着项目行,只清实例不重拉会留下一个点进去 404 的死项目。磁盘清理补偿完成时还会再发一次同 id 事件,重拉是幂等的。- 新会话出现:沿用现有重拉点(切换会话、一轮收口)。不新增
session_created事件——那是事件通道的另一个方案。
5. 验收
- 数据:
curl GET /api/workspaces与curl GET /api/sessions的返回里能拿到项目名、isDefault、每行workspaceId、createdAt(这一拍证明零后端可行)。 - 交互(浏览器):项目可收起/展开;空项目显示「还没有对话」;超过 10 条时出现「展示更多」,点击就地 +10,全部展开后变「收起」;
document.querySelector('.recent-list').scrollHeight === clientHeight(无内部滚动);打开老会话时侧栏高亮且该项目展开。 - 回归:
npm run typecheck、npm test;窄屏 700/380 两档侧栏不溢出。 - 事件重载(A5,
cd web && npx playwright test e2e/sidebar-events.spec.ts):造一个时间戳命名的项目、收尾删掉,不碰开发库既有项目。三条都先在未改代码时跑成红(红停在最终断言):①同一窗口在项目页改名后侧栏当场换名;②另一个窗口经 API 改名,本窗口不刷新就换名;③别处删项目,两个窗口的侧栏那一行自己消失。
6. 明确不做
- 不做后端分组端点:两次现有请求在客户端合并不值得动契约。
- 不做折叠状态持久化:刷新后回到「全部展开」,少一处存储与一处不一致。
- 不在侧栏做项目增删改:那是项目页的职责(doc/44)。
- 不解决「别的窗口新建会话不实时出现」:事件通道没有
session_created,本次只在切会话/收口时重拉。