エージェントに「見えるもの」を決める：dsh-agent-studio 図解セットアップ
118 秒の実録をフレームごとに分解：モデルが各ターンで読むのはシステムプロンプト・ツール目録・スキル目録の 3 つだけ。インストール、3 つのホワイトリスト作成、プリセットのバインド、ひと言送信、そして dsh-context で削減後のコンテキストを検証まで。
最終更新: 2026-10-25
2026-09-22、投稿者 我可是森森呢 さんが自身の開発したオープンソースプラグイン thissensen/dsh-agent-studio を 118 秒の実録でデモ（2026-10-25 の Bilibili view API 実測で 7,481 再生）：プロンプト、ツール、スキル、サブエージェント、予備モデルを視覚的に組み立て、エージェントごとのホワイトリストを作ります——リスト外のものはコンテキストに入りません。本ページの全フレームはこの録画から、手順と設定項目はリポジトリの README と照合済みです。
仕組みは一言でいえます：モデルが各ターンで読むのは、システムプロンプト・ツール目録・スキル目録の 3 つだけ。プラグインやツールや MCP を増やすほど、この 3 つは膨らみ続けます。dsh-agent-studio の方式は、エージェントごとにホワイトリストを書くこと：リスト外のセグメントは配送されず、リスト外のツールは提供されず、リスト外のスキルは見えません。設定はプラグイン自身のデータに保存され、ホストのプリセットは触らず、アンインストールすれば元に戻ります。
まず結論
- ▸モデルが各ターンで読むのは 3 つの目録だけ：システムプロンプト、ツール目録、スキル目録。インストールするほど膨らみます。
- ▸dsh-agent-studio はエージェントごとに 3 目録それぞれへホワイトリストを編成：リスト外のセグメントは配送されず、ツールは提供されず、スキルは見えません。設定はプラグイン自身のデータに保存、プリセットには触らず、アンインストールで復元。
- ▸サブエージェントはモデル・思考強度・プロンプト・ツール・スキルを独立設定。主モデルのレート制限や障害時には、プロバイダー横断の予備候補チェーンが順番に引き継ぎます——未設定なら一切介入しません。
- ▸インストール経路は 3 つ：npm の 1 コマンド、GitHub Release のオフライン tgz、ソースの link:。インストール後は DSH を再起動して 設定 → Agent 中心 のパネルを確認。npm 最新は 0.1.8（2026-10-20 公開）。
9 ステップでホワイトリスト Agent を作る
なぜ必要か
- 1
まず基本：モデルは各ターンで 3 つの目録しか読まない
README は率直です：モデルが各ターンで見るものは、システムプロンプト・ツール目録・スキル目録の正確に 3 つ。プリセットに登録されたセグメントはそのまま配送され、ツール面はインストール済みプラグインから全量提供され、AI が呼び出せるスキルはすべて目録に入ります。DSH 標準のサブエージェント設定も極めて貧弱で、プロンプトやツールやモデルを簡単には変えられません。dsh-agent-studio はエージェントを組み立て式にします：プロンプトセット・ツールセット・スキルセットで 1 体を組み立て、サブエージェントも同じく細かく設定でき、公式 PTC モードにも対応し、プロバイダー横断の予備候補チェーンも使えます。
インストールと再起動
- 2
3 つのインストール経路、終わったら再起動
環境に合わせて選びます：ネットワークがあれば npm の 1 コマンド。オフラインや社内ネットなら Releases の tgz（npm と同じパッケージでビルド不要。ファイル名のバージョンはダウンロードしたものに合わせて）。コードを触るならソースから link: で、lib/ の編集は即反映。--profile は web（純 Web 版）か desktop（デスクトップ版）。どの経路でも最後に DSH を 1 回再起動し、設定 → Agent 中心 にパネルが出れば成功です。プラグインは dsh >= 0.2.1-alpha.2 を要求します（全機能の下限。委譲はこのバージョンの API に依存）。コミュニティのデスクトップ版は内蔵プラットフォームが下限に届かないため、そちらは旧版 dsh-agent-studio@0.1.5 を。
$dsh plugin --profile web add dsh-agent-studio$dsh plugin --profile web add "./dsh-agent-studio-0.1.8.tgz"$dsh plugin --profile web add "link:<源码目录的绝对路径>"
エージェント別に 3 目録を削る
- 3
ホワイトリスト 1：プロンプトセットでシステムプロンプトを削る
設定 → Agent 中心 を開き、まずプロンプトセットを作ります。セグメントは 2 種類：プラットフォームプリセットセグメントは読み取り専用でプラットフォームの更新に追従し（PTC 専用の tools:sdk など）、カスタムセグメントは本文を自分で書けて、プラットフォーム登録済みの補間変数が使えます。動画では投稿者が狼烟提示詞（id prompt-set-3）のセグメントを 1 つずつ確認し、必要なものだけにチェック——1 つも装着しなければ空プロンプトが配送され、セット内の順序がそのまま配送順になります。
$编辑「狼烟提示词」$id prompt-set-3$tools:sdk$PTC 专属$+ 平台预设
プラットフォームプリセットセグメントは読み取り専用で更新に追従。カスタムセグメントは自分で書きます。Bilibili で見る（0:45） - 4
ホワイトリスト 2：ツールセットで残りを隠す
ツール候補はソース別にグループ化され、パネルはそのプリセットの現在のツール面を直接読みます——テスト送信は不要。動画で作ったセットは候補 37 個：その他のソース 0/10 と、dsh-agent-studio 自身の 0/2（studio_delegate と studio_list_subagents）。このエージェントに必要なものだけを選び、1 つも入れなければツールは 1 つも渡りません。skill は必須項目——これがないと AI がスキルを自律呼び出しできません。
$编辑「未命名工具集」$id tool-set-6$候选 1 / 共 37$dsh-agent-studio 0/2
候補はソース別にグループ化。チェックしたものだけがモデルに見えます。Bilibili で見る（0:55） - 5
バックグラウンドツールは必要分だけ、スキルも同様
下にスクロールするとバックグラウンドジョブのグループ：job_kill・job_list・job_output の 3 つに全チェック（3/3）、dsh-skill の skill にもチェック（1/1）——このエージェントはバックグラウンドジョブを管理しスキルを自律呼び出しできる一方、他のグループのツールは一切見えません。スキルセットも同様に、候補はソース別で折りたたみ可能。チェックしたものだけがモデルに見えます。
$dsh-tool-jobs 3/3$job_kill$job_list$job_output$dsh-skill 1/1
このエージェントはバックグラウンドジョブを管理しスキルを呼び出せる一方、他のグループは見えません。Bilibili で見る（1:05）
サブエージェントと予備チェーン
- 6
サブエージェントのモデルを独立させる
エージェント編集画面には「サブエージェントとして使われるとき」のモデル設定があります：プロバイダーのドロップダウンには 継承本会話（セッション継承）のほか SenseAudio・CCSwitch・Command Code・DeepSeek・Qoder が並び、思考強度と予備モデルも別途設定——公式 subagent は主エージェントを丸ごと継承するしかありません。前提が 2 つ：委譲はプラグイン同梱の studio_delegate ツールを使ってこそ役割登録が効きます（公式 subagent ツールの委譲には役割登録が付きません）。各エージェントの備考欄が配送先の判断材料で、モデルはこれで仕事の割り先を決めます。
$(继承本会话)$SenseAudio$CCSwitch$Command Code$DeepSeek$Qoder
リトライ回数の既定は 5。studio_delegate 経由の委譲ではじめて役割登録が行われます。Bilibili で見る（1:25） - 7
予備候補チェーン：主モデル障害時は順番に交代
モデルとバックグラウンドモードのセクションでは、プロバイダーをまたげる予備候補チェーンを組めます：動画の主選は Command Code の DeepSeek V4.1 Flash（思考強度 Low、バックグラウンドモードは AI が決定）、予備1 には別プロバイダー。リトライ回数の既定は 5 で候補ごとに数え、空レスポンス・レート制限・タイムアウトなど再試行可能なエラーは上限まで粘ってから次へ、クォータ枯渇や認証切れは即交代。チェーン未設定なら一切介入せず、順調なうちはプラグインは選択に触れません。全チェーンを使い果たして初めてリクエスト失敗になり、セッションが自動で戻ることはありません。
$重试次数 5$DeepSeek V4.1 Flash$AI自行决定$备用1$Command Code
予備候補はプロバイダーをまたげます。チェーン未設定ならリトライに一切介入しません。Bilibili で見る（1:30）
プリセットのバインドと検証
- 8
プリセットを作り、エージェントにバインド
Agent プリセットページで新規作成：新規作成はソースプリセットの目録全体（プロンプト組み合わせ、スキル、リソース込み）のコピーで、ソースは無傷——動画では 標準模式 を選び、新 id は test。バインドの規則はどこも同じひと言：装着しなければ何も渡らない。プリセットを設定済みエージェントにバインドし、保存を押して完了——保存して初めてディスクに書き込まれるので忘れずに。
$新建预设$来源 标准模式$新 id test$创建
ソースのプリセットは無傷。バインドしたエージェントが取り仕切ります。Bilibili で見る（1:35） - 9
ひと言送って、dsh-context で検証
バインドしたプリセットで新しい会話を開き、挨拶を 1 つ送り、dsh-context のコンテキストページでこのターンを読みます：現在のコンテキスト 113、システムプロンプト 1 セグメント ≈6（使用コンテキストの 6%）——ホワイトリストが本当に 3 つの目録を削った証拠です。動画の締めもこの場面で、プラグインパネルには dsh-context（bowenliang123/dsh-context）が見え、README も検証用の相棒として挙げています。
$113 系统提示词 ≈6 (6%)$系统提示词 1 段$deepseek/deepseek-v4.1-flash · command-code同じフレームの別の読み取り：合計 191、アシスタント出力が 81.7%。Bilibili で見る（1:50）
よくある質問
インストール・安全な境界・検証に関する 5 つの質問。
インストールしたのにパネルが出ません
よくある原因は 3 つ：再起動していない——どの経路でも DSH の再起動が 1 回必要です。場所違い——パネルは 設定 → Agent 中心 に常駐します（パネル下部の「メインページに登録」スイッチを入れると、メインページとサイドバーに入口が現れます）。profile 違い——--profile web は純 Web 版に、--profile desktop はデスクトップ版に入り、起動した profile の方にしか出ません。なおコミュニティのデスクトップ版は内蔵プラットフォームのバージョンが下限に届かないため、そちらは旧版 dsh-agent-studio@0.1.5 が必要です。
既存のプリセットを壊しませんか
壊しません。設定はすべてプラグイン自身の settings 名前空間 agent-studio の下にあり、ホストの既存プリセット定義は 1 字も変えません。要らなくなればバインドを解除すればその場で元通り、完全にアンインストールするには dsh plugin --profile web remove dsh-agent-studio——ホスト設定に痕跡は残りません。唯一の例外は逆向きで、minimal 系のプリセットはそもそも組み替えの対象になりません——プラットフォームの仕様で、セグメントが 1 つしかないため影響もごく僅かです。
モデルは各ターンで何を見ているのか
3 つです：システムプロンプト、ツール目録、スキル目録。dsh-agent-studio の意味論的な規則は「装着しなければ何も渡らない」：プロンプトセットが 1 つもなければ空プロンプトを配送、ツールセットがなければツールは 0、スキルセットがなければスキルは 0 露出。装着すればチェックしたものだけが通ります。同一エージェントに載せるセット同士でメンバーの重複は禁止で、UI と書き込みエンドポイントの両方が検査します。
ホワイトリストが効いたかどうか確かめるには
dsh-context（bowenliang123/dsh-context、Apache-2.0）を組み合わせます。モデルがこのターンに実際に受け取ったプロンプト・ツール・スキルがそのまま見え、動画の締めの検収場面も dsh-context のコンテキストページです——バインド後の最初のターンで、システムプロンプト 1 セグメント ≈6、使用コンテキストの 6%。本サイトにも dsh-context の専用解説（コンテキスト可視化）があります。
サブエージェントのモデルだけ変えるには
エージェント編集で「サブエージェントとして使われるとき」のモデル・思考強度・予備モデルはすべて独立に設定でき、主エージェントの丸ごと継承から抜けられます。前提を 2 つ：委譲はプラグイン同梱の studio_delegate ツール経由でないとその独立設定が効きません（公式 subagent ツールの委譲には役割登録が付かない）。同時に複数派しても大丈夫で、役割は呼び出しの前に登録済みです。
関連ガイド
隣接するけれど別の問題——それぞれひと言で境界を引きます。
Agent チームダッシュボード実践
AgentTeams はチーム全体をダッシュボードに載せて実行を見る仕組み。本ページの Agent 中心が扱うのは、エージェント 1 体の 3 目録をどう削るかです。
ガイドを読むカスタム DSH Agent プリセットを作る
Creator モードはプリセット自身のプロンプト組み合わせを変える仕組み。本ページはプリセット定義に触れず、エージェントごとにホワイトリストを掛け、解除すれば元に戻ります。
ガイドを読むDeepSeek Harness に MCP サーバーを接続する
MCP を接いだ分だけツールは増える一方。本ページはエージェント側で、どのツールが本当に目録に入るかを決めます。
ガイドを読むトークン削減：dsh-ops 実測レポート
あちらは実行時のトークン削減（ログ再生・PTC モード・dsh-ops 実測）。本ページは組み立て時点でコンテキストを削り、両者は補完関係です。
ガイドを読む出典とクレジット
本ページの 7 枚のフレームはすべて 我可是森森呢 さんの録画（BV18ihr6mEno、118 秒、2026-09-22 公開；2026-10-25 の Bilibili view API 実測で 7,481 再生）からのスクリーンショットで、1 枚ごとに出典とタイムスタンプ付きリンクを付け、焼き込み字幕と隅のウォーターマークは書き出し時に取り除いてあります（2026-10-25 に 1080p ソースの該当秒と全フレームを照合）。事実の基準は thissensen/dsh-agent-studio の README（2026-10-25 に GitHub API で確認：★41、MIT、created 2026-09-18、pushed 2026-10-20；npm 最新 0.1.8 も 2026-10-20 公開；README にはオンラインドキュメントと CI バッジがあり、npm パッケージ・ドキュメント・CI の 3 つの工学的シグナル）。動画の説明文はこのリポジトリを自己申告しており、Bilibili 名「我可是森森呢」と GitHub ユーザー名 thissensen は響き合いますが、同一性の第三者確認はないため本ページでは未検証として扱います。検収フレームは相棒プラグイン dsh-context（bowenliang123/dsh-context、Apache-2.0、★3540、2026-10-24 にプッシュ）のコンテキストページで、スタジオのパネルとは区別して記載します。