ディレクトリに戻る

dsh-session-surgeon

キュレーションリスト掲載メンテナンス: 活発

xiaoshenming/dsh-session-surgeon

開けない DSH セッションファイルを修復

GitHub で見るホームページ
$ dsh plugin --profile desktop add "github:xiaoshenming/dsh-session-surgeon#main"

16

スター

3

フォーク

JavaScript

言語

MIT

ライセンス

2026-08-18

作成日

2026-11-08

最終プッシュ

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'` で失敗する

インストール手順

  1. 01

    DSH Desktop の **Plugins** ページを開き、上流の git パッケージ `github:xiaoshenming/dsh-session-surgeon#main` を追加する

  2. 02

    CLI プロファイルからなら `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 操作、またはプロファイルで `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 のコピー、ドライランと適用の修復、圧縮のプレビュー、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 統合ネイティブ実行

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 パスをマスクします。
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 プロファイルから `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` は読み込めないファイルを拒否し、先にすべてのライターを止めて修復するよう求めます。

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。誤りを見つけた場合は、修正を送信してください。

🏆

dsh プラグイン おすすめ

最初に入れたい 12 のプラグイン。全カタログ・全カテゴリから厳選しました。

DSH Plugins は DeepSeek Harness プラグインの独立したコミュニティ ディレクトリです。DeepSeek との提携・公認はありません。サードパーティ製プラグインはセキュリティ監査を受けていません。インストール前にソースコードをご確認ください。

DeepSeek Harnessの新着プラグインを毎週お届け。スパムはありません。