dsh-resume

dsh-resume

English

把 Codex、Claude Code、Cursor、Grok、Pi、Qoder、WorkBuddy、ZCode 的本机会话整理成可继续工作的上下文，在 DeepSeek Harness 中接着做。

安装

0.2.8 面向 DeepSeek Harness 0.2.1-rc.5。 安装包和仓库均包含编译好的插件，无需下载 Harness 源码或自行构建。读取历史需要本机有 Python 3；读取压缩的 Codex rollout 另需 zstd。

官方桌面端

1. 打开 插件 → 添加插件（部分版本入口在设置里）。
2. 在 包名或地址 中填入 github:aa2246740/dsh-resume#v0.2.8，然后安装并启用。
3. 按安装器提示完成激活，在输入框输入 /resume-，确认能看到下面列出的八条命令。

也可以在 v0.2.8 Release 下载 dsh-resume-0.2.8.tgz，把该文件的绝对路径填入同一安装框。桌面端使用自己的 desktop profile，无需运行 Web Host 命令。

Web Host

使用官方 CLI：

dsh plugin --profile web add github:aa2246740/dsh-resume#v0.2.8

或在下载的安装包所在目录运行：

dsh plugin --profile web add ./dsh-resume-0.2.8.tgz

需要官方 dsh 和 pnpm 可用，Node.js 版本为 ^22.19.0 或 >=24.0.0。使用与现有 Web Host 相同的 DSH_HOME；这条命令只安装到 Web profile，不会替桌面端安装。按官方安装器返回的提示完成激活；只有它要求重启时，再正常退出并重开原来的 Host，不要启动第二个 Host。

也可以从 npm 安装 @aa2246740/dsh-resume。npm 包与 GitHub 包提供同一个插件，选择其中一种安装，不要同时安装两份。

升级与卸载

升级时重复对应安装步骤即可。若从旧版手动挂载方式迁移，停用旧的重复挂载行，只保留包自带的 dsh-resume 实例。

桌面端通过插件管理器卸载。Web Host 使用：

dsh plugin --profile web remove dsh-resume

如果安装的是 npm 包，把上面的包名换成 @aa2246740/dsh-resume。

使用

输入 /resume-claude，另外七条同理。它只读本机那次会话，抽出还能接手的上下文，写成一张交接卡。旧进程不会被拉起来，别人的会话文件也不会被改。

六段按目标、文件、做到哪、还差什么、停在哪、读者警告来写。标题对不上号时不会猜，会列出候选让你挑。

命令

只读，不改任何一家的会话仓库。系统提示、隐藏推理、加密或坏掉的记录要么丢掉，要么标明不可用。历史里的结论先标成 HISTORY_REPORTED，这轮在当前仓库里核对过的才是 CURRENT_OBSERVED。Grok 只读看得见的 updates.jsonl。Pi 只跟当前这条分支。ZCode 只读 cli/db/db.sqlite，不回放调用、不复活进程。压缩只标成警告，库里仍在的更早记录会保留。废弃的 v2/sessions 和 cli/rollout JSONL 不是主存储；只有 sqlite 不在时，才对 projects/ 下的 JSONL 做带警告的尽力读取。Qoder 只读 QODER_CONFIG_DIR（默认 ~/.qoder，可用 QODER_HOME 兜底）projects/<目录别名>/<会话>.jsonl 转录，以及 Qoder IDE 的 SharedClientCache/cli/projects 平铺转录（可用 QODER_IDE_CACHE_DIR 覆盖）。加密的 state.json、logs/sessions 运行日志、.auth 凭据和 settings.json 一律不读；isSidechain 子代理记录和隐藏推理跳过并计警告。WorkBuddy 只读 projects/<工作区>/<会话 id>.jsonl（配置根目录按 WORKBUDDY_CONFIG_DIR → CODEBUDDY_CONFIG_DIR → ~/.workbuddy-ai/~/.workbuddy 解析），不回放调用、不复活应用；隐藏推理、meta/compact/steer/teammate 记录和 quick-ask 草稿会话都会被跳过，workbuddy.db 只是索引、不读取。

命令	从哪接着
/resume-codex [latest | 会话 id | 路径 | 标题]	Codex CLI / 应用
/resume-claude [latest | 会话 id | 路径 | 标题]	Claude Code
/resume-cursor [latest | 会话 id | 路径 | 标题]	Cursor
/resume-grok [latest | 会话 id | 路径 | 标题]	Grok
/resume-pi [latest | 会话 id | 路径 | 标题]	Pi
/resume-qoder [latest | 会话 id | 路径 | 标题]	Qoder CLI / IDE
/resume-workbuddy [latest | 会话 id | 路径 | 标题]	WorkBuddy
/resume-zcode [latest | 会话 id | 路径 | 标题]	ZCode

开发

corepack pnpm install
pnpm check

许可

Apache-2.0。见 LICENSE 和 NOTICE。