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'` 失敗
安裝步驟
- 01
在 DSH Desktop 開啟 **Plugins** 頁面,加入上游 git 套件 `github:xiaoshenming/dsh-session-surgeon#main`
- 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"
- 03
更新走 Plugins 頁面上這個外掛的 update 動作,或在 profile 裡執行 `cd ~/.dsh/profiles/desktop && pnpm update dsh-session-surgeon` —— 不需要重啟 `dsh web`,也不需要重新 add
$ dsh web
- 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 目錄
- 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`
- 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 外掛 —— 透過 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`。
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` 遇到載入不了的檔案直接拒絕,必須先停掉所有寫入端完成修復。
07相關的 DSH 工作流程
dsh-univer-office
作者 dream-num
在 DSH 內預覽、建立與編輯表格、文件和幻燈片,由 Univer 驅動
clearai-dsh
作者 clearailhc
ClearAI:以本體為綱的原生 DSH 外掛 —— 經證據核驗的研究長成可瀏覽的領域本體。 · ClearAI: an ontology-first DSH agent preset — evidence-checked research that grows into a domain ontology.
dsh-fish-memory
作者 yuuyuko-uu
🐋 DSH 魚的記憶:給會話一份會淡忘的長期記憶,每條都帶時間。名字裡的「魚」來自 DeepSeek 的鯨魚。
dsh-trading
作者 zhu1090093659
基於 DeepSeek Harness 的智慧體原生交易終端,三欄介面聚合幣圈、美股、A股與港股,內建 19+ 可熱插拔聯結器,預設模擬交易並需人工確認。
08資料與來源
dsh plugin --profile desktop add "github:xiaoshenming/dsh-session-surgeon#main"
The Desktop shell (bundled `@deepseek-ai/dsh-web-frontend@0.2.0-rc.2`) is what serves the `sidebar.panellist` / `main` s…
Agent tools after install: `session_scan` / `session_inspect` / `session_repair` (`apply` defaults to false).
此頁面根據專案公開文件、儲存庫中繼資料與 DSH Plugins 的結構化解析所產生;最後核實於 2026-11-16。發現錯誤?提交更正。
最佳 DeepSeek Harness 外掛
從全目錄挑出的 12 個值得優先安裝的外掛,涵蓋各個分類。
