返回目录

dsh-session-surgeon

精选清单收录维护状态: 活跃

xiaoshenming/dsh-session-surgeon

Repair DeepSeek Harness sessions that refuse to load. 修好打不开的 DSH 会话文件。

前往 GitHub项目主页
$ dsh plugin --profile desktop add "github:xiaoshenming/dsh-session-surgeon#main"

16

星标

3

Fork

JavaScript

语言

MIT

许可证

2026-08-18

创建于

2026-11-08

最近推送

MIT 的 JavaScript DSH 插件:复制会话 ID 让新会话接着旧会话做,并修复打不开的 DeepSeek Harness 会话日志 —— 默认 dry-run,写盘前先写 `.bak.<utc>`,不凭空补 seq、工具结果或 turn 边界。

DSH 适配

原生运行时

作者声明

安全审计

未审计

最后核验

2026-11-16

许可证

MIT

01它能帮你完成什么?

  • 从旧会话接着往下干:在会话 ⋯ 菜单里复制会话 ID,粘到新对话里,让新会话读到旧日志

    剪贴板上的会话 ID,以及粘进新对话的引用,例如 `Continue from session session-1e66cda9-a046-4893-8f4b-b817080acbea.`;接收方 agent 有工具时也可以直接写 `session_inspect id=…`

    像传 Codex 线程 ID 那样传会话 ID 的人,以及希望新 DSH 会话接着旧会话做、又不想 fork 出一份重复文件的人

  • 把打不开的会话救回来 —— seq 缺口、损坏的 zstd 帧、最后一个已提交帧之后补零的尾部、没有在策略链里排好序的 `llm/retry` 记录、孤立的代理项、缺 message id 的事件,以及被 seed/restore 关卡拒绝结算字段的 `assistant/message` / `assistant/attempt` 行

    默认给一份 dry-run 报告,点名是哪一行、哪个字段出的问题;加 `--apply` 才改写日志,改写前先写 `.bak.<utc>`,并把每条 `llm/retry` 链从 1 重新编号、统一 `retryId`

    `session.vN.jsonl.zstd` 已经坏掉的人 —— README 明确说,就算作者以后把加载器修好,也救不回已经坏掉的文件

  • 先把一个 sessions 根目录扫一遍,弄清哪些会话是健康的,再决定打开、交付还是修

    `scan` 列出会话、头部健康状态与遗留的 `.tmp`;`index` 输出 session / parent / goal / health 表;`--format text` 打印便于阅读的表格;退出码区分成功(0)、用法错误(2)与找不到或拒绝(1)

    机器上有多个 DSH home 的人(面板的 session root 选择器会列出能找到的每个 home),以及崩过一次之后想给机器做体检的人

  • 把很长的会话裁到最后几轮,或者把日志以 JSONL 交给别人,而不是丢过去一个 zstd 二进制文件

    seq 从 0 重新编号、turn/step 从 1 重新编号、切片内部的 seq 引用同步平移的压缩会话;或一份默认脱敏的 JSONL 导出

    要在机器之间搬会话、或把日志贴进 bug 报告的人 —— `~/.dsh/sessions` 里的原始文件本身就是隐私负担

02如何接入 DeepSeek Harness?

前置条件

  • DSH Desktop,或某个 DSH CLI profile —— 本插件安装所在的 profile 位于 `~/.dsh/profiles/desktop`
  • 以 `github:xiaoshenming/dsh-session-surgeon#main` 形式添加的上游 git 包;pnpm 会把 `#main` 解析成该 profile 里的 commit tarball
  • 本地开发时 README 要求使用锁定的 dsh 版本与 pnpm lockfile,并需要 Node.js 24
  • 不要用 npm 重装这份 checkout —— 出现重复的 `@deepseek-ai/dsh-tools` 物理副本会让工具调用以 `reading 'prepare'` 失败

安装步骤

  1. 01

    在 DSH Desktop 打开 **Plugins** 页面,添加上游 git 包 `github:xiaoshenming/dsh-session-surgeon#main`

  2. 02

    或在 CLI profile 里执行 `dsh plugin --profile desktop add "github:xiaoshenming/dsh-session-surgeon#main"`

    $ dsh plugin --profile desktop add "github:xiaoshenming/dsh-session-surgeon#main"

  3. 03

    更新走 Plugins 页面上这个插件的 update 操作,或在 profile 里执行 `cd ~/.dsh/profiles/desktop && pnpm update dsh-session-surgeon` —— 不需要重启 `dsh web`,也不需要重新 add

    $ dsh web

  4. 04

    可选:用 `mkdir -p ~/.dsh/skills` 加 `ln -sfn ~/.dsh/profiles/desktop/node_modules/dsh-session-surgeon/skills/dsh-session-surgeon-update ~/.dsh/skills/dsh-session-surgeon-update`,把自带的更新 skill 链接进 DSH 的 skill 目录

  5. 05

    本地开发:`pnpm install --frozen-lockfile`、`export DSH_HOME="$HOME/.dsh-surgeon-dev"`、`./node_modules/.bin/dsh plugin --profile web add "link:$(pwd)"`、`./node_modules/.bin/dsh web`

  6. 06

    完全不装插件时,CLI 也可以直接从 git 跑:`npx --yes github:xiaoshenming/dsh-session-surgeon scan`

    $ npx --yes github:xiaoshenming/dsh-session-surgeon scan

验证接入成功

  • 看左侧会话的 ⋯ 菜单:现在多了 复制会话 ID、inspect、dry-run repair
  • 侧边栏会多出 **会话医生 / Session surgeon**:一个真正的中栏页面,可以浏览会话、复制 id、dry-run 与 apply 修复、预览压缩、导出 JSONL
  • 在 agent 对话里,`session_scan` / `session_inspect` / `session_repair` 已可用,且 `apply` 默认为 false,第一次修复调用就是 dry-run
  • 在 shell 里执行 `npx --yes github:xiaoshenming/dsh-session-surgeon scan`,会列出会话、头部健康状态与遗留的 `.tmp`

回滚

  • 如果桌面提示插件不兼容,在 profile 里删掉再加回:`pnpm remove dsh-session-surgeon`,然后 `pnpm add "github:xiaoshenming/dsh-session-surgeon#main"`
  • 如果这样仍然解析到旧版本,就直接锁定 commit:`pnpm add "github:xiaoshenming/dsh-session-surgeon#<sha>"`
  • 已经修过的会话,可以从 `--apply` 改写前写下的 `.bak.<utc>` 文件还原

03DSH 适配与能力边界

DSH 适配原生运行时

DSH 插件 —— 通过 Desktop 的 `sidebar.panellist` / `main` 座位注册「会话医生 / Session surgeon」侧边栏条目与中栏页面,并提供 `session_scan` / `session_inspect` / `session_repair` 三个 agent 工具,安装命令为 `dsh plugin --profile desktop add "github:xiaoshenming/dsh-session-surgeon#main"`

  • 复制会话 ID

    不会在磁盘上复制任何文件 —— ID 由你手动粘进新对话;README 明确指出真正复制文件的是 Fork
  • 修复官方读取器拒绝的日志

    `--apply` 在日志旁写下 `.bak.<utc>` 之后才改写会话日志崩溃恢复写下的收尾记录与仍然活跃的写入方撞上时,丢掉这些合成收尾记录、保留活跃尾部,而不是在第一个缺口处截断
  • 只报警,不臆造

  • CLI 与 agent 工具共用一套操作

    `session_repair` 的 `apply` 默认为 false,不主动打开就只是 dry-run

04适合谁?何时不该用?

适合

  • 像传 Codex 线程 ID 那样传会话 ID 的人,以及希望新 DSH 会话接着旧会话做、又不想 fork 出一份重复文件的人
  • `session.vN.jsonl.zstd` 已经坏掉的人 —— README 明确说,就算作者以后把加载器修好,也救不回已经坏掉的文件
  • 机器上有多个 DSH home 的人(面板的 session root 选择器会列出能找到的每个 home),以及崩过一次之后想给机器做体检的人
  • 要在机器之间搬会话、或把日志贴进 bug 报告的人 —— `~/.dsh/sessions` 里的原始文件本身就是隐私负担

不适合

  • 兼容性由加载前校验的 `peerDependencies` 决定:范围不匹配时插件仍然装着,却永远不会激活,`pnpm update` 也修不好,而且插件自己报不出这个错 —— `apply()` 根本没跑。办法是删掉再加回。README 的核对对象是 `@deepseek-ai/dsh@0.1.7-rc.2` 与 DSH Desktop 所用的 0.2.x 线,最近一次是 `0.2.2-rc.1`。
  • 工具只走到日志能证明的地方:未知事件类型只报告、绝不删除;`compact` 遇到加载不了的文件直接拒绝、什么都不写,必须先停掉所有写入方再修。
  • 会话日志里有用户文本与密钥:不要提交 `~/.dsh/sessions` 里的原始文件;`export` 默认脱敏 `sk-*`、PEM 块与 home 路径,除非显式加 `--no-redact`。

05兼容性、维护与安全提示

  • 写路径是显式开关:默认只读,`--apply` 先写 `.bak.<utc>`;Windows 上只读备份句柄的 fsync 曾在拷贝已经成功之后以 `EPERM` 中断,现在按 best-effort 处理。
  • 兼容性由加载前校验的 `peerDependencies` 决定:范围不匹配时插件仍然装着,却永远不会激活,`pnpm update` 也修不好,而且插件自己报不出这个错 —— `apply()` 根本没跑。办法是删掉再加回。README 的核对对象是 `@deepseek-ai/dsh@0.1.7-rc.2` 与 DSH Desktop 所用的 0.2.x 线,最近一次是 `0.2.2-rc.1`。
  • 工具只走到日志能证明的地方:未知事件类型只报告、绝不删除;`compact` 遇到加载不了的文件直接拒绝、什么都不写,必须先停掉所有写入方再修。
  • 会话日志里有用户文本与密钥:不要提交 `~/.dsh/sessions` 里的原始文件;`export` 默认脱敏 `sk-*`、PEM 块与 home 路径,除非显式加 `--no-redact`。
2026-08-182026-11-08v0.1.0

MIT · 最新发布 v0.1.0(2026-08-18T06:41:58Z) · 修复打不开的 DSH 会话日志

06常见问题

怎么把 dsh-session-surgeon 装进 DeepSeek Harness?

在 DSH Desktop 打开 **Plugins** 页面,添加上游 git 包 `github:xiaoshenming/dsh-session-surgeon#main`;或在 CLI profile 里执行 `dsh plugin --profile desktop add "github:xiaoshenming/dsh-session-surgeon#main"`。profile 位于 `~/.dsh/profiles/desktop`,pnpm 会把 `#main` 解析成那里的一份 commit tarball。

默认会改动我的会话文件吗?

不会。默认只读,修复是 dry-run;加 `--apply` 才写盘,而且先写 `.bak.<utc>`,从不凭空补 seq,补 message id 时也不丢事件。agent 工具的行为一样:`session_repair` 的 `apply` 默认为 false。

在 DSH 会话里它长什么样?

是真正的 Desktop 界面,不是浮层:会话 ⋯ 菜单里多出 复制会话 ID、inspect、dry-run repair,侧边栏多出 **会话医生 / Session surgeon** 中栏页面,可以浏览会话、复制 id、dry-run 与 apply 修复、预览压缩、导出 JSONL。在 agent 对话里同样的操作由 `session_scan` / `session_inspect` / `session_repair` 提供。

支持哪些 DSH 版本?

README 的核对对象是 `@deepseek-ai/dsh@0.1.7-rc.2` 与 DSH Desktop 所用的 0.2.x 线,最近一次是 `0.2.2-rc.1`,`SESSION_FORMAT_VERSION` 仍是 4。如果桌面提示不兼容,就在 profile 里删掉再加回(`pnpm remove dsh-session-surgeon`,然后 `pnpm add "github:xiaoshenming/dsh-session-surgeon#main"`)—— `peerDependencies` 在加载前校验,`pnpm update` 修不好这个问题。

哪些情况它不会去修?

日志没说的一律不补。缺失的 seq、没有对应 `tool/result` 的 `tool/call`、接在日志已经关闭的 turn 后面的 step、空的 `tool_calls[].id` 都只报告不动手;未知事件类型只报告、绝不删除;`compact` 遇到加载不了的文件直接拒绝,必须先停掉所有写入方完成修复。

08数据与来源

  • 作者声明github.com44d7b3b3f870…

    dsh plugin --profile desktop add "github:xiaoshenming/dsh-session-surgeon#main"

  • 作者声明github.com44d7b3b3f870…

    The Desktop shell (bundled `@deepseek-ai/dsh-web-frontend@0.2.0-rc.2`) is what serves the `sidebar.panellist` / `main` s…

  • 作者声明github.com44d7b3b3f870…

    Agent tools after install: `session_scan` / `session_inspect` / `session_repair` (`apply` defaults to false).

页面基于项目公开文档、仓库元数据和 DSH Plugins 的结构化解析生成;最后核验于 2026-11-16。发现错误?提交更正。

🏆

最佳 DeepSeek Harness 插件

从全目录挑出的 12 个值得优先安装的插件,覆盖各个分类。

DSH Plugins 是独立的 DeepSeek Harness 插件目录,与 DeepSeek 官方无关,也不代表官方背书。第三方插件未经安全审计,安装前请审查源码。

每周获取最新的 DeepSeek Harness 插件,绝不滥发。