✨ feat(vscode): 会话交接改走阿里云 OSS 收件箱、换 xz 压缩，另加从 env 文件配置移交存储的 URI
- 会话包传到 OSS 上收件人的收件箱 spx-handoff/<owner>/<repo>/session/<收件人>/<sid>!<发送人>!<会话名>.tar.xz，对象私有；owner/repo/收件人转小写 - 待接收列表就是列自己的收件箱；同一会话再交给同一人先删旧包；接收后删包，包已被别处收走时提示并刷新 - 打包换成 xz 1 级，和工单移交共用 packHandoff / unpackHandoff，删掉 gzip 版 - 删掉邮箱工单整套（mailboxIssue、MAILBOX_*、isMailboxIssue 及看板 / webhook 里的过滤、附件名编解码）和不再用的 Gitea 附件、标签、建工单接口 - session-handoff/accept 与待接收项改用 OSS 对象 key 标识 - 没配移交存储时发送、接收、刷新都提示去配，刷新回空列表 - 进度提示照工单移交：同一条提示依次显示打包、上传、下载多少 MB、解包、装会话 - 新增 URI configure-handoff-store?envFile=<绝对路径>：读 OSS_ENDPOINT / OSS_BUCKET_NAME / OSS_ACCESS_KEY / OSS_SECRET_KEY 保存，和命令共用 saveHandoffStore；URI 入口按 path 统一分发，未知 path 报错
This commit is contained in:
cruldra committed
1 parent
81fe14f6dc
commit
fcee4143d4
26 files changed
+542
-515
No files matched your search
@@ -27,7 +27,7 @@
|
||||
|
||||
- **发送方**：当前持有 worktree / 会话的机器（同事）。
|
||||
- **接管方**：目标 assignee 的机器（我）。
|
||||
- **会话包**：tar.xz，OSS 对象 key 为 `spx-handoff/<owner>/<repo>/issue-<N>-<UTC 时间>.tar.xz`（时间形如 `20261008T010203Z`，同一工单多次移交不撞名）。
|
||||
- **会话包**：tar.xz，OSS 对象 key 为 `spx-handoff/<owner>/<repo>/issue-<N>-<UTC 时间>.tar.xz`（时间形如 `20261008T010203Z`，同一工单多次移交不撞名）。会话交接的包另放在收件箱目录下，见下文「会话交接（单个会话）」。
|
||||
- **移交存储**：放会话包的 OSS 存储桶，见下文「移交存储配置」。
|
||||
|
||||
## 会话包格式
|
||||
@@ -77,7 +77,9 @@ codex/YYYY/MM/DD/rollout-*.jsonl 审查会话（存在才有）
|
||||
|
||||
命令「Superpowers: 配置移交存储」（`superpowers.configureHandoffStore`）依次弹四个输入框：endpoint（如 `oss-cn-beijing.aliyuncs.com`）、bucket、AccessKey ID、AccessKey Secret（密码框）。框里预填已有值；四项都填完才保存，中途 Esc 什么都不改。endpoint、bucket 存扩展设置（`settings/store.ts` 的 `handoffOssEndpoint` / `handoffOssBucket`），两个 AccessKey 存 VS Code SecretStorage（`auth/secrets.ts`），整台机器共用一份。
|
||||
|
||||
四项缺一项就算没配置：移交、接管、同意移交申请都直接 toast 提示去跑这个命令，什么都不改（同意申请时也不把它记成申请失败的原因）。
|
||||
也可以从 env 文件一次配好：`vscode://clurdra.superpowers-vscode-clurdra/configure-handoff-store?envFile=<env 文件绝对路径>`，读文件里的 `OSS_ENDPOINT`、`OSS_BUCKET_NAME`、`OSS_ACCESS_KEY`、`OSS_SECRET_KEY`（luffy-agent-platform 后端 `.env` 的写法，`KEY=value`，注释和别的变量跳过；endpoint 去掉 `https://`），四项齐了按命令同样的方式保存并提示「移交存储已保存：<bucket>（<endpoint>）」；参数不对、文件读不到、缺项只报错（只报变量名），什么都不改。AccessKey 不进日志、不进提示。URI 参数值按入口的编码契约做两层 urlencode（见 `uri/uriHandler.ts`）。
|
||||
|
||||
四项缺一项就算没配置：移交、接管、同意移交申请，以及会话交接的发送、接收、刷新待接收列表，都直接 toast 提示去跑这个命令，什么都不改（同意申请时也不把它记成申请失败的原因；刷新时给 webview 回空列表）。
|
||||
|
||||
## 发送方：移交
|
||||
|
||||
@@ -121,6 +123,17 @@ codex/YYYY/MM/DD/rollout-*.jsonl 审查会话（存在才有）
|
||||
|
||||
幂等：3、4 可重复执行；6 之前失败会话包仍在，按钮仍显示，用户可重试。
|
||||
|
||||
## 会话交接（单个会话）
|
||||
|
||||
会话 tab 里的一个 claude 会话交给同事，和工单无关，也走移交存储。
|
||||
|
||||
- **收件箱**：每人每仓库一个 OSS 目录 `spx-handoff/<owner>/<repo>/session/<收件人>/`。会话包 key 为 `<收件箱><sid>!<发送人>!<会话名 slug>.tar.xz`，slug 把字母、数字、`._-` 以外的字符换成 `_`、最长 40 字。owner / repo / 收件人 / 发送人只收 `[\w.-]`，sid 必须是 UUID，否则拒绝生成。owner / repo / 收件人转小写（Gitea 不分大小写，各人 remote 地址的写法可能不同）。key 的生成与解析在 `cc/sessionHandoff.ts`（`sessionInboxPrefix` / `sessionHandoffKey` / `parseSessionHandoffKey`）。
|
||||
- **包内容**：`handoff.json`（`kind: 'managed-session'`，含 from / to / workspacePath / session）+ `claude/<sid>.jsonl` + `claude/<sid>/`，xz 1 级，和工单移交共用 `packHandoff` / `unpackHandoff`。
|
||||
- **发送**（`session-handoff/start { sessionId, to }`）：关掉该会话的终端等 600ms → 收集会话、写清单、打包 → 列对方收件箱，删掉同 sid 的旧包 → 分片上传（对象私有）→ 本机会话记录写 `handedOffTo` / `handedOffAt`。
|
||||
- **待接收列表**（`session-handoff/refresh` → `session-handoff/pending { items: [{ key, sid, from, name }] }`）：列自己的收件箱，从 key 解析出 sid / 发送人 / 会话名，不下载。面板加载时和每次发送、接收后各拉一次，没有推送。
|
||||
- **接收**（`session-handoff/accept { key }`）：key 必须解析得出、且落在我在当前仓库的收件箱里，否则拒绝 → 下载（包名固定，不拿 key 拼本机路径）→ 解包、校验清单（收件人是我、会话 id 和 key 一致）→ 工作区路径不同就改写会话里的路径 → 装到 `projectsDirFor(workspaceRoot)`（先清同 sid 副本）→ 写会话 tab 记录 → 删 OSS 上的包（失败只 warn）。包已不在（别处收过）时提示并刷新列表。
|
||||
- 进度提示和工单移交一样：同一条 toast 依次显示 关闭终端、收集会话、`打包 x MB`、`上传 x MB / y MB`；接收方 `下载 x MB / y MB`、解包、装会话、写入会话列表，完成前不消失。
|
||||
|
||||
## 附带修正
|
||||
|
||||
完成列流程里「把 jsonl 拷回主仓库」（`panel/handlers/issues.ts` ~L388）改为整包**搬迁**：jsonl + `<sid>/` 一起移动到 `projectsDirFor(workspaceRoot)`，并删除源文件——否则新版 claude 因重复 sid 拒绝 resume。与接管方第 4 步共用同一个安装函数。
|
||||
@@ -131,14 +144,18 @@ codex/YYYY/MM/DD/rollout-*.jsonl 审查会话（存在才有）
|
||||
|---|---|---|
|
||||
| `cc/sessionBundle.ts` | 纯 fs：`findClaudeSessionFiles(sid, projectsRoot)`、`installClaudeSession(sid, srcDir, dstProjectsDir, projectsRoot)`（先删本机所有副本再拷）、`codexRolloutPathFor(sid, codexRoot)`、`installCodexSession(relPath, srcFile, codexRoot)` | 临时目录 vitest |
|
||||
| `cc/handoffManifest.ts` | 清单类型、`buildHandoffManifest(...)`、`parseHandoffManifest(json)`、OSS 对象 key `handoffBundleKey(...)` | 纯函数 vitest |
|
||||
| `cc/handoffArchive.ts` | `packHandoff(stagingDir, outFile, { onProgress })` / `unpackHandoff(file, dstDir)`，xz 1 级；另有会话交接（单会话，仍走 Gitea 附件，白名单没有 .xz）用的 gzip 版 `packSessionHandoff` / `unpackSessionHandoff` | 真 tar 往返 vitest |
|
||||
| `cc/handoffArchive.ts` | `packHandoff(stagingDir, outFile, { onProgress })` / `unpackHandoff(file, dstDir)`，xz 1 级，工单移交和会话交接共用 | 真 tar 往返 vitest |
|
||||
| `cc/sessionHandoff.ts` | 会话交接：收件箱前缀、包 key 的生成与解析，`managed-session` 清单 | 纯函数 vitest |
|
||||
| `git/worktreePath.ts` | 从 `panel/handlers/sessions.ts` 抽出 `resolveWorktreeDir`、`deriveSlug`，新增 `slugFromBranch` | 纯函数 vitest |
|
||||
| `git/worktree.ts` | 导出 `runGit`、`findLiveWorktreeForBranch`；新增 `ensureWorktreeFromRemote` | `test/git/` mock child_process |
|
||||
| `gitea/api.ts` | `listRepoAssignees` | — |
|
||||
| `oss/handoffStore.ts` | 纯 Node：`uploadHandoffBundle`（分片上传、私有权限、进度）、`downloadHandoffBundle`（流式写文件、进度、空闲超时）、`deleteHandoffBundle` | 真机往返脚本（不进仓库） |
|
||||
| `oss/handoffStoreSetup.ts` | `readHandoffStore(ctx)`、「配置移交存储」命令 | — |
|
||||
| `oss/handoffStore.ts` | 纯 Node：`uploadHandoffBundle`（分片上传、私有权限、进度）、`downloadHandoffBundle`（流式写文件、进度、空闲超时）、`deleteHandoffBundle`、`listHandoffBundles`（按前缀列、翻页）、`isHandoffBundleMissing` | 真机往返脚本（不进仓库） |
|
||||
| `oss/handoffStoreSetup.ts` | `readHandoffStore(ctx)`、「配置移交存储」命令、`saveHandoffStore`（命令和 URI 共用） | — |
|
||||
| `oss/handoffStoreEnv.ts` | `parseHandoffStoreEnv(text)`：从 env 文本读四项 | 纯函数 vitest |
|
||||
| `uri/uriHandler.ts` | 外部 URI 按 path 分发：`/create-session`、`/configure-handoff-store`，未知 path 报错 | — |
|
||||
| `panel/handlers/handoff.ts` | 纯决策：`canStartHandoff(issue)`、`canAcceptHandoff(issue, me)`、`handoffStateExtra` / `handoffUiPatch` 两套 payload、`worktreePushedCheck` 结果判定、`transferProgressText` 进度文案 | vitest |
|
||||
| `panel/handlers/handoffFlow.ts` | 两个 orchestrator：`handleHandoffStart`、`handleHandoffAccept`、`handleHandoffUsers` | — |
|
||||
| `panel/handlers/handoffFlow.ts` | 两个 orchestrator：`handleHandoffStart`、`handleHandoffAccept`、`handleHandoffUsers`；`progressToast`、`requireHandoffStore` 会话交接也用 | — |
|
||||
| `panel/handlers/sessionHandoff.ts` | 会话交接：选人、发送、待接收列表、接收 | — |
|
||||
| webview | `HandoffModal.tsx`、`IssueDetailPanel` 两个按钮、`IssueCard` 角标、`useIssues` 三个 postMessage、`me` 状态 | — |
|
||||
|
||||
消息（`src/panel/messages.ts` 与 `webview-ui/src/lib/messages.ts` 镜像）：
|
||||
@@ -150,6 +167,7 @@ codex/YYYY/MM/DD/rollout-*.jsonl 审查会话（存在才有）
|
||||
|
||||
- `pnpm test` / `pnpm lint` / `pnpm typecheck`；`cd cli && make test`。
|
||||
- OSS 真机往返（临时脚本，不进仓库，对象放 `spx-handoff/_selftest/` 下）：上传 → 匿名 `curl` 必须 403 → 下载 → 解包一致 → 删除 → 匿名 `curl` 404、带密钥下载报 NoSuchKey。分片上传（≥100KB）和单次上传（<100KB）两条路都测私有权限。
|
||||
- 会话交接真机往返（同上）：上传进收件箱 → 按收件人前缀列到、key 解析回 sid / 发送人 / 会话名，相近名字的收件箱列不到 → 匿名 `curl` 403 → 同一 sid 再交一次只剩新包 → 下载解包一致 → 删除后收件箱为空、再下载报对象不存在 → `_selftest/` 下 0 个对象。
|
||||
- 端到端：本机用两个 VS Code 窗口（不同 Gitea 账号 token）走一遍 移交 → 接管 → 恢复实施会话 → 拖到完成。
|
||||
|
||||
## 不做
|
||||
|
||||
Reference in new issue
Block a user