MIT の JavaScript 製 DSH プラグイン。セッション ID のコピーで新しいチャットを過去の続きにし、開けなくなった DeepSeek Harness のセッションログを修復します。既定はドライラン、書き込み前には `.bak.<utc>`、seq・ツール結果・ターン境界の捏造はなし。
DSH 統合
ネイティブ実行
作者による申告
安全性監査
未監査
最終検証日
2026-11-16
ライセンス
MIT
01どんなタスクに使えるのか?
過去のセッションから作業を続ける。セッションの ⋯ メニューでセッション ID をコピーし、新しいチャットに貼り付けて、新しいセッションが古いログを読めるようにする
クリップボード上のセッション ID と、`Continue from session session-1e66cda9-a046-4893-8f4b-b817080acbea.` のような貼り付けた参照。ツールを持つエージェントなら `session_inspect id=…` でも同じことができる
Codex のスレッド ID を渡すのと同じ感覚でセッション ID を回したい人、そして重複ファイルを fork せずに新しい DSH セッションを古いセッションの続きにしたい人
開けなくなったセッションを復旧する —— seq の欠番、壊れた zstd フレーム、最後にコミットされたフレーム以降がゼロ埋めされた末尾、ポリシーチェーン内で順序付けられていない `llm/retry` の記録、孤立サロゲート、message id を欠いたイベント、seed/restore ゲートが拒否する settlement フィールドを持つ `assistant/message` / `assistant/attempt` の行
既定ではドライランのレポートで、どの行のどのフィールドが原因かを名指しする。`--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 をすべて一覧する)や、クラッシュ後にマシンを点検したい人
長いセッションを直近の数ターンに切り詰める、またはログを zstd のバイナリではなく JSONL で渡す
seq を 0 から、turn/step を 1 から振り直し、スライス内に残る seq 参照もずらした圧縮済みセッション。あるいは既定で秘密情報をマスクした JSONL エクスポート
セッションをマシン間で移す人、ログをバグ報告に添付する人 —— `~/.dsh/sessions` の生ファイル自体がリスクになる
02DeepSeek Harness への導入方法
前提条件
- DSH Desktop、または DSH の CLI プロファイル —— このプラグインを入れるプロファイルは `~/.dsh/profiles/desktop` にある
- `github:xiaoshenming/dsh-session-surgeon#main` の形で追加する上流の git パッケージ。pnpm は `#main` をそのプロファイル内のコミット tarball に解決する
- ローカル開発では README が固定した dsh バージョンと pnpm の lockfile を使い、Node.js 24 を要求する
- このチェックアウトを npm で入れ直さないこと —— `@deepseek-ai/dsh-tools` の実体コピーが重複すると、ツール呼び出しが `reading 'prepare'` で失敗する
インストール手順
- 01
DSH Desktop の **Plugins** ページを開き、上流の git パッケージ `github:xiaoshenming/dsh-session-surgeon#main` を追加する
- 02
CLI プロファイルからなら `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 操作、またはプロファイルで `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 のコピー、ドライランと適用の修復、圧縮のプレビュー、JSONL のエクスポートができる本物の中央カラムページ
- エージェントとのチャットで `session_scan` / `session_inspect` / `session_repair` が使え、`apply` の既定は false なので最初の修復呼び出しはドライランになる
- シェルから `npx --yes github:xiaoshenming/dsh-session-surgeon scan` を実行すると、セッション一覧・ヘッダーの健全性・残留した `.tmp` が出る
ロールバック
- デスクトップが互換性なしと表示したら、プロファイルで外して入れ直す: `pnpm remove dsh-session-surgeon` のあと `pnpm add "github:xiaoshenming/dsh-session-surgeon#main"`
- それでも古いバージョンに解決されるなら、コミットを固定する: `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` のエージェントツールを追加します。導入は `dsh plugin --profile desktop add "github:xiaoshenming/dsh-session-surgeon#main"`
セッション ID のコピー
ディスク上にファイルを複製しない —— ID は自分で新しいチャットに貼る。ファイルを複製するのは Fork だと README が明言している公式リーダーが拒否するログの修復
`--apply` はセッションログの隣に `.bak.<utc>` を書いてから書き換えるクラッシュ復旧のクローザーが稼働中のライターと衝突した場合、その合成クローザーを捨てて生きた末尾を残す(最初の欠番で切り捨てない)警告はするが、作り話はしない
CLI とエージェントツールで同じ操作
`session_repair` の `apply` は既定で false なので、明示的に有効にしない限りドライランのまま
04誰に向いているのか?使うべきでない場面は?
向いている用途
- Codex のスレッド ID を渡すのと同じ感覚でセッション ID を回したい人、そして重複ファイルを fork せずに新しい DSH セッションを古いセッションの続きにしたい人
- `session.vN.jsonl.zstd` がすでに壊れてしまった人 —— README は、あとで作者がローダーを直しても壊れたファイルは救えないと明言している
- マシン上に複数の DSH home がある人(パネルの session root ピッカーは見つかる home をすべて一覧する)や、クラッシュ後にマシンを点検したい人
- セッションをマシン間で移す人、ログをバグ報告に添付する人 —— `~/.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` は `--no-redact` を明示しない限り `sk-*`、PEM ブロック、home パスをマスクします。
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` は `--no-redact` を明示しない限り `sk-*`、PEM ブロック、home パスをマスクします。
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 プロファイルから `dsh plugin --profile desktop add "github:xiaoshenming/dsh-session-surgeon#main"` を実行します。プロファイルは `~/.dsh/profiles/desktop` にあり、pnpm が `#main` をそこでのコミット tarball に解決します。
既定でセッションファイルは書き換えられますか?
いいえ。既定は読み取り専用で、修復はドライランです。`--apply` を付けたときだけ、`.bak.<utc>` を先に書いてから書き換え、足りない seq を捏造せず、message id を補ってもイベントは落としません。エージェントツールも同じで、`session_repair` の `apply` は既定 false です。
DSH のセッション内ではどう見えますか?
オーバーレイではなく本物の Desktop UI です。セッションの ⋯ メニューに 复制会话 ID・inspect・dry-run repair が増え、サイドバーには **会话医生 / Session surgeon** の中央カラムページが増えます。セッション一覧、id のコピー、ドライランと適用の修復、圧縮プレビュー、JSONL エクスポートができます。エージェントとのチャットでは同じ操作を `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 です。デスクトップが互換性なしと表示したら、プロファイルで外して入れ直します(`pnpm remove dsh-session-surgeon`、続いて `pnpm add "github:xiaoshenming/dsh-session-surgeon#main"`)。`peerDependencies` は読み込み前に検証されるため、`pnpm update` では直りません。
どこまでなら修復しないのですか?
ログに書かれていないことは補いません。欠けた seq、対応する `tool/result` が無い `tool/call`、すでに閉じたターンの続きになる step、空の `tool_calls[].id` は報告だけで手を出しません。未知のイベント種別は報告のみで決して削除せず、`compact` は読み込めないファイルを拒否し、先にすべてのライターを止めて修復するよう求めます。
07関連する DSH ワークフロー
dsh-univer-office
by dream-num
DSH 内で Office 文書をプレビュー・作成・編集(Univer 搭載)
clearai-dsh
by clearailhc
DeepSeek HarnessにEpistemic Loopを導入するネイティブDSHプラグイン。
dsh-fish-memory
by yuuyuko-uu
DSHのセッションに、時間情報付きの少しずつ薄れる長期記憶を与えます。
dsh-trading
by zhu1090093659
DeepSeek Harness上に構築したエージェント型トレーディングターミナル。仮想通貨・米国・中国・香港市場を3列GUIで一括表示、19以上の着脱式コネクタ、デフォルトでドライラン(本番注文は人間承認)対応。BYOKでデータ外部送信なし。
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。誤りを見つけた場合は、修正を送信してください。
dsh プラグイン おすすめ
最初に入れたい 12 のプラグイン。全カタログ・全カテゴリから厳選しました。
