返回目錄

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 外掛,絕不濫發。