MIT ライセンスの DeepSeek Harness コンテキスト圧縮プラグインで、dsh-context-compression-selector の改良フォークです。既定でオフのコードスケルトンゲート、選択可能な圧縮プロファイル、監査できる節約トークン統計を追加し、`dsh plugin add` で dsh プロファイルに導入します。
DSH 統合
ネイティブ実行
作者による申告
安全性監査
未監査
最終検証日
2026-11-15
ライセンス
MIT
01どんなタスクに使えるのか?
長時間動く DeepSeek Harness セッションをコンテキスト予算内に保つために、溜まり続けるツール結果を圧縮する
選択可能で監査できるプロファイル(Fresh / Aggregate / History micro-compact / TailTrim / Native)で圧縮された短いツール結果コンテキストと、各削減の段階・reducer・トリガー・スキップ理由・正確なトークン数を記録した判断ログ
長いマルチターンのコーディング作業で DSH を使い、ツール出力が増え続けてコンテキストウィンドウが先に尽きる人
初出の巨大なソースコードのツール結果を、先頭を切り落とす代わりに「import と宣言」のスケルトンへ縮める
import と型 / 関数 / クラスの宣言を残し、関数本体をマーカーで省略し、省略した本体の中のエラー行は保持したスケルトン
`read_file` のようなツールで大きなソースファイルを読み、1 回の結果でコンテキストウィンドウが埋まるチーム
02DeepSeek Harness への導入方法
前提条件
- Node `^22.19.0 || >=24` と pnpm `11.7.0`(README に明記された要件です)
- 生成されたサポート対象ホスト一覧に載っている DeepSeek Harness の rc リリース(0.1.0 / 0.1.1 / 0.1.2 / 0.1.5 / 0.1.7 / 0.2.0 / 0.2.1 の 7 ライン、計 21 個の rc リリース)
- DeepSeek モデル専用です。可逆な計測と非可逆な圧縮は同梱の公式 DeepSeek トークナイザーに依存します
インストール手順
- 01
対象の Harness プロファイルに npm からインストールします:`dsh plugin --profile web add dsh-context-compression-improved@latest`(README の推奨手順で、1 つのバージョンがサポート対象のすべての Harness ラインをカバーします)
$ dsh plugin --profile web add dsh-context-compression-improved@latest
- 02
`dsh --profile web --dump-config` でプロファイル設定を出力します
$ dsh --profile web --dump-config
- 03
ソースから構築する場合:`git clone https://github.com/drscrewdriver/dsh-context-compression-improved.git` のあと `pnpm install --frozen-lockfile` と `pnpm build` を実行し、selector パッケージを pack して Harness プロファイルに追加します
$ git clone https://github.com/drscrewdriver/dsh-context-compression-improved.git
- 04
プラグインの設定セクションで圧縮プロファイルを選び、Auto Compact のトリガー水準を設定し、必要ならコードスケルトン圧縮をオンにします(出荷時の既定値は `codeSkeleton: { enabled: false }`)
導入成功の確認
- インストール後に `dsh --profile web --dump-config`(README がインストール直後に示すコマンド)を実行し、出力されるプロファイル設定に `dsh-context-compression-improved` が含まれているか確認します
- 設定のトグルは変更時に保存され、再読み込み後も保存済みの状態が表示されます
- リポジトリのインストールガイド `docs/installation.md` の検証手順に沿って確認します(README が verification と uninstall の手順を示しています)
ロールバック
- アンインストール手順はリポジトリのインストールガイド `docs/installation.md` に記載されています
- `~/.dsh/storages/dsh-context-compression/stats.sqlite` を削除すると、永続化された統計を完全にリセットできます
03DSH 統合と能力の範囲
`dsh plugin --profile web add …` で dsh プロファイルに導入する DeepSeek Harness プラグインです。公開された plugin / profile API のみを使い、Harness のコアコードは変更しません
コードスケルトン圧縮ゲート
サイズ超過の新しいソースコードのツール結果(大きな `read_file` など)→import と型 / 関数 / クラスの宣言からなるスケルトン。関数本体はマーカーで省略し、省略した本体のエラー行は保持します
既定ではオフで、`codeSkeleton: { enabled: false }` を自分で有効化するまで動作しませんスケルトンを生成・検証できない場合は元の先頭刈り込みにフォールバックします圧縮プロファイル
新規および蓄積されたツール結果コンテキスト→事前圧縮された新規セグメント、再圧縮された集約、置き換えられた古い履歴結果、任意の TailTrim、Harness 流の Native 刈り込み
監査可能な判断ログ
プラグインが下すすべての圧縮判断→段階、reducer、トリガー、スキップ理由、取得できる場合は正確なトークン数
圧縮モニターパネルと `/ccip` コマンド
圧縮が動作中のセッション→純 / 総節約量、オフセット、コンテキスト使用量、キャッシュヒット率、コスト見積もりをセッションのコンテキスト推移グラフの隣に表示します
`/ccip` でセッション単位に圧縮を再開・無効化できます(`session <id|latest|off>`)SQLite による統計の永続化
圧縮判断とリクエスト境界→ホスト再起動をまたいで保持されるストック・累計・節約金額の 3 種類の統計。履歴セッションはディスク上の記録からバックフィルされます
`~/.dsh/storages/dsh-context-compression/stats.sqlite` に書き込みます。ドライバ不足や書き込み失敗時は目に見える形でメモリフォールバックに劣化します記録は件数・通し番号・セッション識別子・列挙型のコンポーネント名のみで、原文や自由文がデータベースに入ることはありません
04誰に向いているのか?使うべきでない場面は?
向いている用途
- 長いマルチターンのコーディング作業で DSH を使い、ツール出力が増え続けてコンテキストウィンドウが先に尽きる人
- `read_file` のようなツールで大きなソースファイルを読み、1 回の結果でコンテキストウィンドウが埋まるチーム
不向きな用途
- DeepSeek モデル専用です。可逆な計測と非可逆な圧縮は同梱の公式 DeepSeek トークナイザー(`deepseek-v4-flash`、`deepseek-v4-pro`、`deepseek-v4-flash-vision-exp`)に依存し、それ以外では fail-open して元のツール結果をそのまま残します。
- コードスケルトンゲートは計測条件付きです。正確な DeepSeek トークナイザーが必要で、取得できない場合は fail-open となり圧縮しません。
- 設定はセッション凍結です。他の selector 設定と同様に、変更は新しく観測されたセッションにのみ影響し、実行中のセッションは以前の設定を引き継ぎます。
- `codeSkeleton` は厳密に `{ enabled: boolean }` である必要があります。形式が不正な値はランタイム側で例外となり、ブラウザ UI では読み取り不能として表示されます。
- README は公式アカウントの Messages API ルートよりも、独自の OpenAI 互換 `/v1/responses` エンドポイントを推奨しています。公式ルートの再開リプレイ 400 はプラグイン側から修復できないためです。
05互換性・メンテナンス・セキュリティ上の注意
- DeepSeek モデル専用です。可逆な計測と非可逆な圧縮は同梱の公式 DeepSeek トークナイザー(`deepseek-v4-flash`、`deepseek-v4-pro`、`deepseek-v4-flash-vision-exp`)に依存し、それ以外では fail-open して元のツール結果をそのまま残します。
- コードスケルトンゲートは計測条件付きです。正確な DeepSeek トークナイザーが必要で、取得できない場合は fail-open となり圧縮しません。
- 設定はセッション凍結です。他の selector 設定と同様に、変更は新しく観測されたセッションにのみ影響し、実行中のセッションは以前の設定を引き継ぎます。
- `codeSkeleton` は厳密に `{ enabled: boolean }` である必要があります。形式が不正な値はランタイム側で例外となり、ブラウザ UI では読み取り不能として表示されます。
- README は公式アカウントの Messages API ルートよりも、独自の OpenAI 互換 `/v1/responses` エンドポイントを推奨しています。公式ルートの再開リプレイ 400 はプラグイン側から修復できないためです。
- ソースからのビルドと開発フローには Node `^22.19.0 || >=24` と pnpm `11.7.0` が必要です。
- WilliamShi666/dsh-context-compression-selector の非公式なコミュニティフォークであり、DeepSeek との提携や推奨関係はありません。MIT の下で上流の著作権表示を保持しています。
MIT · latest release v0.11.2 (2026-11-14T17:14:44Z)
06よくある質問
コードスケルトンゲートを有効にすると、選んだ圧縮プロファイルは変わりますか?
いいえ。直交する仕組みで、`balanced`、`savings`、`cache-strict`、`adaptive`、`custom`、`off`、`native` のどのプロファイルでも使えます。既定はオフなので、`codeSkeleton.enabled` を true にするまでは何も変わりません。
DeepSeek 以外のモデルでも使えますか?
使えません。DeepSeek モデル専用で、可逆な計測と非可逆な圧縮は同梱の公式 DeepSeek トークナイザーに依存します。それ以外では fail-open し、元のツール結果がそのまま残ります。
スケルトン化でかえってコンテキストが悪化しませんか?
README は悪化しないと明言しています。スケルトンを生成・検証できなければ元の先頭刈り込みにフォールバックするため、このゲートがコンテキストを悪化させることはありません。
設定変更は今動いているセッションにすぐ反映されますか?
いいえ。他の selector 設定と同じくセッション凍結で、変更は新しく観測されたセッションにのみ影響します。
節約トークンの統計はどこに保存され、何が記録されますか?
`~/.dsh/storages/dsh-context-compression/stats.sqlite` の SQLite に保存され、ホスト再起動をまたいで残ります。ファイルを削除すれば統計は完全にリセットされます。記録されるのは件数・通し番号・セッション識別子・列挙型のコンポーネント名だけで、原文や自由文はデータベースに入りません。
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データと出典
The plugin uses only public Harness extension APIs and does not modify Harness core code.
- Built and tested against the official DeepSeek Harness releases; peers declare the full supported-hosts enum
このページは、プロジェクトの公開ドキュメント、リポジトリのメタデータ、および DSH Plugins の構造化解析に基づいて生成されています。最終検証日:2026-11-15。誤りを見つけた場合は、修正を送信してください。
dsh プラグイン おすすめ
最初に入れたい 12 のプラグイン。全カタログ・全カテゴリから厳選しました。
