tako 文档 GitHub

60 · 前端多会话并发(单主视图 + 后台保留)

性质:实现真源(2026-11-01 立项并落地)。 状态:✅ 已落地(2026-11-01,A1–A6)。前端从「全局一个 useChat()」改成「每个打开过的会话一个实例,切走不打断、切回原样」。 代码落点:yk-tako-eino/web/src/{App.vue,chat.ts,chatpool.ts}、web/test/chatpool.test.ts、web/e2e/multisession.spec.ts(后端零改动、契约字节零变化)。 验收:npm run typecheck / npm run build / npm run test(19/19)/ npx playwright test(19/19)。 上游:doc/50 的侧栏树、doc/51 的 token 与控件规格;本篇新增的落点选择器与「+」沿用这两篇的样式口径。 台账:tmp/60-多会话并发/(不入库,验收后清理)。


0. 一句话结论

后端一直允许不同会话并发跑(会话闸 one_live_run_per_session 只管同一场,租户容量闸默认 8);限制全在前端:整个应用只调用一次 useChat(),切会话就是把这唯一一份状态清空重填。本篇把「谁在观察」从一份全局闭包变成一组并行实例——切走只是换 activeChat,旧实例的轮询、草稿、排队消息、游标都留在原地。

1. 病灶:两个会真实发生的故事

故事一:切走即失联

用户想让 agent 在 A 里跑一段两分钟的长任务,切到 B 看另一场对话。

  1. 在 A 发消息,气泡开始流式输出;
  2. 点侧栏 B:openSession 第一行 pollToken++(chat.ts 的轮询令牌),A 的帧轮询循环在下一个 await 后看到令牌失效就 return;
  3. 服务端的 run 照样跑完,但前端不再拉它的帧、不再收口;
  4. 切回 A 时 reconcile() 从头重拉历史、有活 run 就 frames(0) 重放——能恢复,但中间发生了什么(跑完、等人提问、失败)当场没人知道;侧栏也没有任何标记。

故事二:切走即丢件

  1. 在 A 输入框写了一段没发的话,或 A 正忙时又发了一条(进 pending 队列,等本轮收口后自动投);
  2. 点侧栏 B:openSession 把 draft、pending、attachments 全部清空;
  3. 切回 A:草稿没了,排队消息也没了,而且是静默消失——界面不提示这条消息没发出去。

这两个故事不修,多会话就不是「并发」,而是「轮流霸占同一个前端」。

端到端链路(改动后的每一环都能点名)

用户点侧栏某场会话
  → App.vue openChat(id):池里已有同 sid 实例就只 activate,没有就新建 useChat() 并 openSession
  → activeChat 换人:旧实例 setActive(false)(不再抢写 localStorage 的「最后打开的会话」),新实例 setActive(true)
  → 旧实例自己的轮询循环照旧每 400ms 拉 GET /api/runs/{runId}/frames(服务端纯 LRANGE,多读者无限制)
  → 帧写回旧实例自己的 bubbles / 游标(不碰激活实例)
  → 用户切回:模板直接绑定该实例的 bubbles / draft / pending,不重新 reconcile
  → 会话被删 / 换租户 / 超上限:dropChat 停轮询、清队列、移出池

2. 机制:实例管理器

2.1 App.vue 侧(App.vue:64)

没它会怎样:如果仍靠「清空 + 重建」,旧实例的轮询只能被全局令牌打断——这正是现状;管理器把「谁在观察」变成一组并行存在的对象,撤销全局令牌才有意义。

2.2 chat.ts 的最小改动(chat.ts:334)

2.3 生命周期

事件 处置
切到已有会话 只切 activeChat;不 increment 旧实例的 pollToken
新对话(当前实例有 sid) 旧实例留后台继续跑;新建空白实例。不弹确认框——它留在侧栏,点得回来
新对话(当前是空白实例且有草稿/附件) 弹确认框「这段还没发出去,新开后会丢。」;确认后丢弃
新对话(空白且无草稿) 直接丢弃,不弹
session_deleted 按 id 找实例(不限于激活):后台实例直接丢;正在看的保留实例、清成空白并显示死因横幅(:931)
workspace_deleted 名单里的实例全丢;跨窗口事件只带项目 id,用「落点 = 该项目」认出本 tab 的会话,并把它们的落点退回默认项目(:938)
切租户 / 退出 全部 dispose 后重建一份干净实例(:161)
实例上限 有 sid 的实例最多 8 个;超出时淘汰「有 sid、不在跑、没草稿/附件、最久未激活」的那个,切回时重建(chatpool.ts:17)

淘汰抽成纯函数 pickEviction,单测覆盖:上限内不淘汰、取最久、busy/dirty/空白不淘汰、激活实例不动。

3. 项目落点(A3b,2026-11-01 用户补报后增加)

用户报的缺口:无法在指定项目里创建对话;空对话也不能选择/修改项目。

核实结果:项目页「开新对话」本身是通的(空白、有草稿两条路径实测 POST /api/runs 都带 workspaceId);缺的是对话页没有入口、也看不到落点——activeWorkspaceId 原先只传给项目页。

改法:

4. 侧栏「运行中」(本地信号)

runningIds = {本 tab 里 busy 且有 sid 的实例}(App.vue:911)。侧栏对应会话行加 .recent-run 徽标(title="运行中",沿用 doc/51 的 accent token)。收口后 busy 变 false,标记自动消失,不重拉列表。

边界:这是本 tab 的一手信号,不是服务端事实——刷新页面或用另一台设备起的 run 不会出现在这里。见 §6。

5. 不做(及原因)

6. 后置阶段 P1:列表接口带运行状态

GET /api/sessions 每项加 liveRunId(可顺带 lastRunStatus)。

7. 验收

cd yk-tako-eino/web
npm run typecheck && npm run build && npm run test
npx playwright test

web/e2e/multisession.spec.ts 七条用例(登录走真后端,业务面用 page.route 造态,不依赖模型):

  1. 草稿随会话切换保留(A1 的红基线,A3 转绿);
  2. 排队消息切走再切回仍在;
  3. 空对话能改项目,发送落在所选项目(抓 POST /api/runs 的 workspaceId);
  4. 侧栏项目行的「+」直接在该项目开新对话;
  5. 打开已有会话时没有落点选择器;
  6. 切走后侧栏仍标「运行中」,terminal 帧到达后消失;
  7. 后台会话被删后从侧栏消失。

web/test/chatpool.test.ts 覆盖淘汰纯函数五条边界。

8. 代码落点

文件 内容
web/src/App.vue:62 管理器(chatList / activeChat / 同名 computed / activate / openChat / startNewChat / resetAllChats / dropChat / enforceCap)
web/src/App.vue:853 确认框规则(有 sid 不弹;空白有草稿才弹)与 startChatInProject
web/src/App.vue:897 落点选择器数据与 onPickLanding
web/src/App.vue:921 删除/项目删除的生命周期收口
web/src/App.vue:1530 侧栏项目行「+」
web/src/App.vue:1565 侧栏「运行中」徽标
web/src/App.vue:2068 输入区落点选择器
web/src/chat.ts:334 active / setActive / 条件写 localStorage
web/src/chat.ts:832 reconcile(id?)
web/src/chat.ts:1080 dispose()
web/src/chatpool.ts MAX_CHATS = 8 与淘汰纯函数
web/test/chatpool.test.ts 淘汰单测
web/e2e/multisession.spec.ts 七条活体用例