ディレクトリに戻る

dsh-auxiliary

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

dsh-plugins/dsh-auxiliary

専用モデルルートで視覚理解とコンテキスト圧縮を提供する DeepSeek Harness 補助モデルプラグイン

GitHub で見るホームページ
$ dsh plugin --profile <PROFILE> add @dsh-plugin/dsh-auxiliary

16

スター

4

フォーク

TypeScript

言語

LGPL-3.0

ライセンス

2026-08-14

作成日

2026-11-20

最終プッシュ

LGPL-3.0 の TypeScript 製 DSH バンドルプラグイン。視覚・圧縮・レビュー・タイトル・画像生成の呼び出しにそれぞれモデルルートを割り当て、reconcile による実行時の再設定を行い、メインセッションのルートは変更しない。

DSH 統合

ネイティブ実行

作者による申告

安全性監査

未監査

最終検証日

2026-11-16

ライセンス

LGPL-3.0

01どんなタスクに使えるのか?

  • コンテキスト圧縮・セッションタイトル・承認レビューといった狭い呼び出しカテゴリだけを、会話を動かすモデルを変えずに専用の安価な/高性能なモデルへ移す

    その呼び出しはプラグインカードで設定した provider/model の組に届く。置き換わるのは provider/model だけなので、タイムアウト・リトライ・フォールバック・メインセッションのルートは harness 側のまま

    メインに高価なモデルを使い、圧縮要約やセッションタイトルは安価なルートに、自動レビューはより強いモデルに任せたい人

  • テキストのみを受け付けるメインモデルのセッションでも画像を使えるようにする

    画像は受け入れ判定を通り、テキスト専用ルートには永続的な `[image: {…}]` テキスト参照が渡り、モデルは `describe_image` を呼んで説明を得る。画像対応ルートは元の `ImageBlock` をそのまま受け取る

    メインルートがテキスト専用で、スクリーンショットや貼り付けた画像を読ませたいセッション

  • セッション内から、プロファイルがすでに認可している images API で画像を生成・編集する

    作業ディレクトリの `.dsh/generated/` に置かれた PNG ファイルをパスとして返し、メインモデルは `inspect_image` で確認できる

    OpenAI 互換の images プロバイダーを設定済みで、同じ会話の中で挿絵を生成して検証したいプロファイル

  • プロファイルを動かしたまま、Web UI から任意のルート(プロバイダー、モデル、画像ハンドオフ、圧縮しきい値)を調整し直す

    以降のリクエストは新しいルートで処理される。各機能は `reconcile*()` と disposer の組で管理され、条件が変わった部分だけが登録・破棄される

    実行中のプロファイルで機能ごとにコストと品質を見直したい人

02DeepSeek Harness への導入方法

前提条件

  • Node.js 24.9+ と dsh-loader 2.x(プラグインは 2.x のファサードを利用する)
  • DSH が次の6つのリリース系列のいずれか: `0.1.5`、`0.1.6`、`0.1.7`、`0.2.0`、`0.2.1`、`0.2.2`(プレリリースも含む)
  • 導入先のプロファイル(README のインストール手順は `<PROFILE>` を取る。指定がなければ先に確認する)
  • 公式の Models ページで設定済みの provider/model ルート ID(カードは既存ルートを指すだけ)
  • 視覚プロバイダー側に画像入力対応モデルが必要。`generate_image` には上流エンドポイントが実際に画像生成できるモデルを使う

インストール手順

  1. 01

    対象プロファイルに依存を追加: `dsh plugin --profile <PROFILE> add @dsh-plugin/dsh-auxiliary`(またはそのプロファイルのプラグインマネージャーコマンド)

    $ dsh plugin --profile <PROFILE> add @dsh-plugin/dsh-auxiliary

  2. 02

    0.4.1 以降このパッケージはバンドルプラグインなので、`dsh plugin add` が `dsh.profile.bundles` へも自動で追記する(`cordis.patch.yml` への手動挿入は不要)

    $ dsh plugin add

  3. 03

    pnpm が `ERR_PNPM_IGNORED_BUILDS` で止まったら、プロファイルの `pnpm-workspace.yaml`(`allowBuilds`)で `prepack` ビルドを承認して再試行する

  4. 04

    `cordis.patch.yml` に 0.4.1 以前の手動挿入行が残っている場合は削除する。残すとバンドル層と二重にマウントされる

  5. 05

    `node_modules/@dsh-plugin/dsh-auxiliary` に `lib/index.js` と `lib/client.js` があることを確認する。ビルド成果物がなければプラグインディレクトリで `npm run build` を実行して追加し直す

    $ npm run build

  6. 06

    loader 管理のプラグイン設定を開き provider/model の組を入力し、Settings → Models で使用するモデルにマークを付ける

導入成功の確認

  • `node_modules/@dsh-plugin/dsh-auxiliary` にビルド済みの `lib/`(少なくとも `lib/index.js` と `lib/client.js`)がある
  • Host から読めるパスに対して agent に `inspect_image` を実行させる。README の例は `Use inspect_image to analyze screenshots/error.png`
  • インストール手順は検証まで。プロファイルは起動せず、変更内容だけを報告する

03DSH 統合と能力の範囲

DSH 統合ネイティブ実行

DSH バンドルプラグイン(harness の LLM seam 上): `dsh plugin --profile <PROFILE> add @dsh-plugin/dsh-auxiliary` で導入し `dsh.bundle.patch` 経由でマウントされ、`llm/stream` ウォーターフォールリスナーが `ctx.llm` 経由で用途別に呼び出しを再ルーティングし、`ctx.tools.register` が `inspect_image`・`describe_image`・`generate_image` の3ツールを登録する

  • 用途キーによるモデルルーティング

    プラグインカードで入力する provider/model の組(Models ページで設定済みのルートを指す)→一致した呼び出しが凍結した代替設定で `ctx.llm.stream()` に再入する。それ以外の呼び出しはそのまま通過する

    機能を有効にすると `llm/stream` リスナーは常駐し、完全なルートが揃うまでは純粋なパススルーとして動作する代替設定は同じルートマーカーを保つため、等値判定でルーター自身の再入とは一致しない
  • `inspect_image` による視覚理解

    Host から読める画像パス(絶対パスまたはワークスペース相対)と任意の質問→選択した視覚モデルのテキスト回答(`vision.maxTokens` で切り詰め可能)

    `ctx.attachments` seam 経由で画像ファイルを登録する`tool.enabled` が有効で完全な視覚ルートがある間だけツールが登録される`tool.maxImageBytes` が1ファイルの上限、`tool.timeoutMs` が協調的なツール呼び出し予算
  • `describe_image` による画像ハンドオフ

    テキスト専用と宣言されたルートで画像を含むリクエスト→画像ブロックの代わりに永続的なテキスト参照を渡し、`describe_image` 呼び出しでテキスト説明を得る

    ハンドオフ有効中は実行時ラッパーがテキスト専用メインルートに画像入力を宣言し、受け入れ事前判定を通すそのリクエストの画像ブロックはテキスト参照に置き換わり、ツール結果内のネストした画像も書き換えられる書き換えはリクエスト単位で、中断・エラー・イテレーターの早期クローズ・プラグイン破棄でもホストのストリーム意味論を保つ
  • 圧縮ルートと任意の圧縮エンジン

    Context compaction グループの provider/model の組。エンジンには `engine.enabled` と `engine.compressPrompt` も必要→`purpose: 'compaction'` の要約呼び出しはすべて補助モデルが担当する。エンジンを有効にすると要約は明示的な圧縮指示に従い、`engine.thresholdRatio` で自動的に発火する

    `engine.enabled: true` は標準の圧縮バックエンドを置き換える。`@deepseek-ai/dsh-compaction-basic` を同時に読み込むと競合を検出して警告を出し、自前のエンジンをスキップするしきい値は保持率(`engine.retainRatio`、既定 16%)より大きく保つ必要がある
  • 承認レビューとセッションタイトルのルート

    Approval model と Title model グループの provider/model の組→公式の自動レビュー呼び出しと `purpose: 'session-title'` 呼び出しが選択したモデルで処理され、プロバイダー自身の設定とメインセッションのルートは変わらない

    置き換わるのは provider/model だけで、ポリシー・入力・Session の帰属・キャンセル・判定はネイティブのまま公式の自動レビュープラグインとその Auto 権限モードは別途有効にする必要があるセッションタイトルのプロバイダーは独自のデプロイ設定を保ち、`purpose: 'session-title'` の呼び出しだけが移る
  • `generate_image` による画像生成

    プロンプト、任意の `size` と `n`、任意の `reference`(1つのパス、または複数参照編集用のパス配列)→作業ディレクトリの `.dsh/generated/` に置かれた PNG ファイルをパスで返す

    プロバイダーの OpenAI 互換 images API の `POST {baseURL}/images/generations` または `POST {baseURL}/images/edits` を呼ぶ呼び出しごとに harness の資格情報 seam 経由で `apiKeyEnv` を解決する(`process.env` は使わない)生成した画像を作業ディレクトリの `.dsh/generated/` に書き出す

04誰に向いているのか?使うべきでない場面は?

向いている用途

  • メインに高価なモデルを使い、圧縮要約やセッションタイトルは安価なルートに、自動レビューはより強いモデルに任せたい人
  • メインルートがテキスト専用で、スクリーンショットや貼り付けた画像を読ませたいセッション
  • OpenAI 互換の images プロバイダーを設定済みで、同じ会話の中で挿絵を生成して検証したいプロファイル
  • 実行中のプロファイルで機能ごとにコストと品質を見直したい人

不向きな用途

  • 対応範囲は Node.js 24.9+、dsh-loader 2.x、および6つの DSH リリース系列(`0.1.5`、`0.1.6`、`0.1.7`、`0.2.0`、`0.2.1`、`0.2.2`、プレリリース含む)に固定されている。README に他のバージョンの記載はない。
  • `engine.enabled: true` は標準の圧縮バックエンドを置き換えるため、`@deepseek-ai/dsh-compaction-basic` と同時には動かせない。プラグインは競合を検出して警告とともに自前のエンジンをスキップし、独自の圧縮指示は効かなくなる。
  • `Allow image input` チェックボックスはモデルの正規の `input` 宣言を書き込むだけで、テキスト専用モデルに視覚能力を追加はしない。上流エンドポイントが実際に画像を受け付ける場合にだけチェックする。
  • 設定は `<profile>/config/dsh-auxiliary/config.json` に保存される。旧 1.x の `dsh-auxiliary` 設定名前空間は自動移行されないため手作業でのコピーが必要で、ファイルを手で編集した場合はプラグインの再読み込みか再起動が要る。

05互換性・メンテナンス・セキュリティ上の注意

  • 対応範囲は Node.js 24.9+、dsh-loader 2.x、および6つの DSH リリース系列(`0.1.5`、`0.1.6`、`0.1.7`、`0.2.0`、`0.2.1`、`0.2.2`、プレリリース含む)に固定されている。README に他のバージョンの記載はない。
  • `engine.enabled: true` は標準の圧縮バックエンドを置き換えるため、`@deepseek-ai/dsh-compaction-basic` と同時には動かせない。プラグインは競合を検出して警告とともに自前のエンジンをスキップし、独自の圧縮指示は効かなくなる。
  • `Allow image input` チェックボックスはモデルの正規の `input` 宣言を書き込むだけで、テキスト専用モデルに視覚能力を追加はしない。上流エンドポイントが実際に画像を受け付ける場合にだけチェックする。
  • 設定は `<profile>/config/dsh-auxiliary/config.json` に保存される。旧 1.x の `dsh-auxiliary` 設定名前空間は自動移行されないため手作業でのコピーが必要で、ファイルを手で編集した場合はプラグインの再読み込みか再起動が要る。
2026-08-142026-11-13作者は未記載

LGPL-3.0 · リリースなし · 継続メンテナンス中、最終 push 2026-11-13

06よくある質問

dsh-auxiliary を DeepSeek Harness に導入するには?

対象プロファイルで `dsh plugin --profile <PROFILE> add @dsh-plugin/dsh-auxiliary` を実行します(プロファイル未指定なら先に確認します)。0.4.1 以降このパッケージは `dsh.bundle.patch` を宣言するバンドルプラグインなので、この追加で `dsh.profile.bundles` にも自動で書き込まれ、`cordis.patch.yml` の手動編集は不要です。pnpm が `ERR_PNPM_IGNORED_BUILDS` で止まる場合は `pnpm-workspace.yaml` の `allowBuilds` で `prepack` ビルドを承認して再試行し、0.4.1 以前の手動挿入行が残っていれば二重マウントを避けるため削除します。

メインの会話モデルは変わりますか?

いいえ。各ルートは1つの呼び出しカテゴリ(`purpose: 'compaction'`、`purpose: 'session-title'`、公式の自動レビュー呼び出し、または自身が登録するツール)だけに一致し、provider/model だけを置き換えて `ctx.llm.stream()` に再入します。完全なルートが揃うまでリスナーは純粋なパススルーなので、未設定の機能は何も変えません。

DSH セッション内でルートはどこで設定しますか?

loader 管理のプラグイン設定です。折りたたまれた1枚のカードに視覚・圧縮・承認・タイトル・画像生成・圧縮エンジンの設定がまとまっています。公式の Models ページで設定済みの provider/model ID を入力し、保存は以降のリクエストに適用されて再起動は不要です。設定は `<profile>/config/dsh-auxiliary/config.json` にあり、旧 1.x の名前空間は自動移行されず、ファイルを手で編集した場合はプラグインの再読み込みか再起動が必要です。

対応する DSH バージョンと実行環境は?

Node.js 24.9+ と dsh-loader 2.x、DSH 側は6つのリリース系列(`0.1.5`、`0.1.6`、`0.1.7`、`0.2.0`、`0.2.1`、`0.2.2`、プレリリース含む)に対応します。`0.1.6-alpha.2` より前は Settings → Plugin configuration、それ以降はプラグイン詳細ページで設定します。

メインモデルがテキスト専用のとき画像はどうなりますか?

既定で有効な画像ハンドオフにより、`ctx.llm.resolveModelInfo` の実行時ラッパーが画像を受け入れ事前判定に通し、テキスト専用リクエストには永続的な `[image: …]` 参照が渡り、モデルは `describe_image` を呼んで視覚ルートから説明を得ます。画像対応ルートは元の画像ブロックのままです。`vision.handoff` を無効にすると元の受け入れ判定とストリーム動作に戻ります。なお `Allow image input` チェックボックスはテキスト専用モデルに視覚能力を追加できません。

08データと出典

  • 作者による申告github.com9228fa9d05bd…

    `dsh-auxiliary` is a [DeepSeek Harness](https://deepseek-harness.github.io/deepseek-harness/) plugin that layers auxilia…

  • 作者による申告github.com9228fa9d05bd…

    Add the plugin dependency: `dsh plugin --profile <PROFILE> add @dsh-plugin/dsh-auxiliary` (or the equivalent plugin-mana…

  • 作者による申告github.com9228fa9d05bd…

    Since 0.4.1 the package is a bundle plugin (declares `dsh.bundle.patch`), so `dsh plugin add` also appends it to `dsh.pr…

  • 作者による申告github.com9228fa9d05bd…

    Tools are registered with `ctx.tools.register(defineTool(...))` and announced to the model through `ctx.systemPrompt.sec…

このページは、プロジェクトの公開ドキュメント、リポジトリのメタデータ、および DSH Plugins の構造化解析に基づいて生成されています。最終検証日:2026-11-16。誤りを見つけた場合は、修正を送信してください。

🏆

dsh プラグイン おすすめ

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

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

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