DSH web UI をエディタに埋め込み、`dsh web` のライフサイクルを管理し、DSH のトークン認証を loopback で中継し、エディタ操作をパネルへ橋渡しする MIT の VS Code 拡張機能。
DSH 統合
ネイティブ実行
作者による申告
安全性監査
未監査
最終検証日
2026-11-20
ライセンス
MIT
01どんなタスクに使えるのか?
コードの隣で DeepSeek Harness と話す。ターミナルもブラウザタブも開かない
左のアクティビティバーまたは右のセカンダリサイドバーに埋め込まれた DSH web UI。サービスは拡張機能が再利用または起動する
一日中エディタに居て、エージェントのためにもう一つウィンドウを開きたくない VS Code ユーザー
DSH が必須にしたブラウザ認証を、クロスサイトの webview でも成立させる
ワンタイムの起動 URL を 30 日間のセッション cookie に交換し、loopback リレー経由でパネルに渡すので、iframe がログイン画面や 401 で止まらない
DSH 0.1.2 以降を使っていて、そうしなければ埋め込みパネルがログインを要求し続ける人
埋め込まれた DSH ページを、閉じ込められた iframe ではなくエディタの一員として動かす
クリックできるファイルパス、システムブラウザで開く外部リンク、動くコピーボタン、復活した元に戻す/やり直し、視覚非対応モデル向けの画像フォールバック
エージェントパネルでファイルパスを開き、コードブロックをコピーし、スクリーンショットを貼る毎日を過ごす開発者
02DeepSeek Harness への導入方法
前提条件
- PATH の通った `dsh` CLI(DeepSeek Harness から導入)、または Windows なら DSH Desktop
- VS Code ≥ 1.91(README の開発要件)。Node.js ≥ 22 はソースから拡張機能をビルドする場合のみ必要
インストール手順
- 01
Marketplace から導入: `code --install-extension Fengze233.dsh-vscode-panel`
- 02
または Releases から最新の `dsh-vscode.vsix` を取得し、VS Code で `Extensions: Install from VSIX...` を実行してウィンドウを再読み込み
- 03
左のアクティビティバーか右のセカンダリサイドバーにある DSH のクジラアイコンをクリック — 拡張機能が `dsh web` を起動(または再利用)し、パネルのサインインまで済ませる
$ dsh web
導入成功の確認
- ステータスバーにサービスの状態が出る: running / starting / stopping / failed / stopped
- `DSH: Show Logs` で検出された `dsh` のパス・取得元・バージョンが表示される
- ブリッジの確認: DSH パネルの DevTools コンソールに `[dsh-vscode-bridge] handshake ok, v0.4.4, imageFallback=true` が出る
ロールバック
- 拡張機能をアンインストールする: VS Code が `uninstall` フックを実行し、`cordis.patch.yml` の目印付きエントリとブリッジディレクトリを削除する
- または `DSH: Uninstall Bridge` を実行し、ブリッジパッケージだけを外して `cordis.patch.yml` を元に戻す(拡張機能は残る)
03DSH 統合と能力の範囲
公式の `dsh web` を VS Code の webview に包み、サービスのライフサイクルを管理し、DSH のワンタイムトークン認証を loopback で中継し、`dsh-vscode-bridge` クライアントプラグインを DSH プロファイルに導入する
サービスのライフサイクル管理
`dsh.profile`、`dsh.port`、`dsh.launchPreference`(`auto` / `npm` / `desktop`)、`dsh.autoStart`→再利用または新規起動された `dsh web`。指定ポートが埋まっていれば、そのセッションだけ最初の空きポートに切り替える
最後のウィンドウを閉じても止まるのは拡張機能自身が起動したサービスだけ認証リレー(auth relay)
`dsh web` が出力するワンタイムの起動 URL→セッション cookie を拡張機能のプライベートストレージに保存し、`127.0.0.1` のランダムポートで動く loopback リレーから iframe に渡す
リレーは 30 日間のセッションを保持するため、そのランダムポートを見つけたローカルプロセスは誰でもそのセッションを操作できる拡張機能が起動していない DSH サービスでは、起動 URL を一度貼り付ける必要があるDSH ページへのブリッジ
`$DSH_HOME/profiles/<dsh.profile>`(既定は `~/.dsh/profiles/web`)配下の DSH ユーザーディレクトリ→パネル内のファイルジャンプ、外部リンクのブラウザ起動、クリップボードコピー、元に戻す/やり直し、画像フォールバック
`cordis.patch.yml` に `# dsh-vscode-bridge: begin/end` で囲まれたブロックを書き、ユーザープロファイル側にブリッジディレクトリを作る(DSH のインストール先には一切書かない)同梱バージョンまたは `client.js` の内容が異なれば強制的に再インストールする視覚非対応モデル向けの画像フォールバック
貼り付けた画像と、開いているワークスペースフォルダー→画像をワークスペース直下にキャッシュし、ファイルパス参照としてモデルへ送る(モデルは画像ツールで読む)
一時画像は使用後に削除され、残りは `DSH: Clean Up Image Cache` で掃除できるリモート環境
`dsh.remote.enabled` と、リモートホスト側に導入した拡張機能→SSH Remote・Dev Containers・Codespaces ではリモートで `dsh` を動かしトンネル経由でパネルを開く。WSL はトンネル不要
04誰に向いているのか?使うべきでない場面は?
向いている用途
- 一日中エディタに居て、エージェントのためにもう一つウィンドウを開きたくない VS Code ユーザー
- DSH 0.1.2 以降を使っていて、そうしなければ埋め込みパネルがログインを要求し続ける人
- エージェントパネルでファイルパスを開き、コードブロックをコピーし、スクリーンショットを貼る毎日を過ごす開発者
不向きな用途
- loopback リレーは `127.0.0.1` だけで待ち受けるが、30 日間のセッションを保持する。そのランダムポートを見つけたローカルプロセス(同じ端末の別ユーザーを含む)は誰でもその DSH セッションを操作できる。README はこの露出を明記し、認証のない DSH 0.1.1 以前が `127.0.0.1:3080` で待ち受けている状態と同等だと述べている。
- DSH Desktop は `desktop` プロファイル、VS Code は既定で `web` プロファイルを使う。セッションと設定は `~/.dsh` 配下で共有されるが、プラグインはプロファイル単位で導入されるため、VS Code のパネルで DSH プラグインを使うには `web` プロファイルへ入れる必要がある。
- モデル API が HTTP/HTTPS プロキシ経由でしか到達できない場合、プロキシ変数を `dsh web` 子プロセスに渡す必要がある。`dsh.useEnvProxy: true` を有効にするか、`dsh.env` で `NODE_OPTIONS=--use-env-proxy` と `HTTPS_PROXY` / `HTTP_PROXY` を注入する。
05互換性・メンテナンス・セキュリティ上の注意
- loopback リレーは `127.0.0.1` だけで待ち受けるが、30 日間のセッションを保持する。そのランダムポートを見つけたローカルプロセス(同じ端末の別ユーザーを含む)は誰でもその DSH セッションを操作できる。README はこの露出を明記し、認証のない DSH 0.1.1 以前が `127.0.0.1:3080` で待ち受けている状態と同等だと述べている。
- DSH Desktop は `desktop` プロファイル、VS Code は既定で `web` プロファイルを使う。セッションと設定は `~/.dsh` 配下で共有されるが、プラグインはプロファイル単位で導入されるため、VS Code のパネルで DSH プラグインを使うには `web` プロファイルへ入れる必要がある。
- モデル API が HTTP/HTTPS プロキシ経由でしか到達できない場合、プロキシ変数を `dsh web` 子プロセスに渡す必要がある。`dsh.useEnvProxy: true` を有効にするか、`dsh.env` で `NODE_OPTIONS=--use-env-proxy` と `HTTPS_PROXY` / `HTTP_PROXY` を注入する。
- README に記載された既知の制約が三つある。VS Code 1.140 以降エクスプローラーからのドラッグが webview に届かない(上流の回帰で修正は未マージ)、画像フォールバックはワークスペースフォルダーを開いている必要がある(キャッシュはルート直下)、SSH Remote / Dev Containers / Codespaces は `dsh.remote.enabled` を有効にするまで使えない。
MIT · 活発に保守(最新 release V0.4.4、2026-11-08)
06よくある質問
DSH を VS Code に入れるには?
Marketplace から `Fengze233.dsh-vscode-panel` を導入するか、`code --install-extension Fengze233.dsh-vscode-panel` を実行します。Releases の `.vsix` を `Extensions: Install from VSIX...` で入れる方法もあります。前提は PATH の通った `dsh` CLI、Windows なら DSH Desktop でも構いません。そのあとアクティビティバーのクジラアイコンをクリックすれば、拡張機能が `dsh web` を起動または再利用してサインインまで済ませます。
パネルにログイン画面や 401 が出るのはなぜ?
DSH 0.1.2 でブラウザ認証が必須になりました。拡張機能自身が起動したサービスなら自動でサインインします。VS Code の外(systemd やターミナル)で DSH を起動した場合、拡張機能はそのプロセスのログを読めないため、一度だけ貼り付けるサインインページを表示します。サービスログの起動 URL を一度貼れば最長 30 日間有効で、再起動しても貼り直しは不要です。
dsh not found と出たら?
`dsh` CLI(`npm i -g @deepseek-ai/dsh`)か DSH Desktop を導入し、コマンドが PATH にあることを確認してください。`dsh.launchPreference: auto` では npm を優先し、無ければ Desktop に切り替わります。Desktop が独自ディレクトリにある場合は `dsh.desktopCommandPath`、ラッパースクリプトを使う場合は `dsh.executablePath` を設定します。`DSH: Copy Logs` で検出されたパス・取得元・バージョンを確認できます。
入れた DSH プラグインが VS Code のパネルに出てこない
DSH Desktop は `desktop`、VS Code は既定で `web` プロファイルを使います。セッションと設定は `~/.dsh` 配下で共有されますが、プラグインはプロファイル単位なので `web` プロファイルへ入れる必要があります(`dsh.profile` で使うプロファイルを指定しても構いません)。
DSH セッションがネットワークに露出することはある?
ありません。拡張機能が受け付けるのは loopback アドレス(`127.0.0.1` / `localhost` / `[::1]`)だけで、リレーもネットワークには公開されません。ただし README にある通りリレーは 30 日間のセッションを保持するため、ローカルプロセスがランダムポートを見つければそのセッションを操作できます。露出としては、認証のない DSH 0.1.1 以前が loopback で待ち受けている状態と同じです。
07関連する DSH ワークフロー
ds-harness-remote
by liguobao
DeepSeek Harnessのマルチデバイス遠隔アクセスプラグイン。低遅延・エンドツーエンド暗号化のP2P優先ネットワークで、PC・Android・WebからリモートのHarnessを安全に操作できます。
dsh-windows-mcp
by hellohub1212
CursorTouchとWindows-MCPをDSHにつなぐWindowsデスクトップ自動化ブリッジ。Computer Useは初期オフで、依存関係をアプリ内インストーラーから導入できます。
dsh-desktop
by anywhere-labs
DeepSeek Harness(dsh)プラグインエコシステム向けのモダンなデスクトップクライアント。すべてが「プラグイン」であり、デスクトップそのものもプラグインとして機能します。
dsh-go
by ccch1mneyyy
DeepSeek Harnessをスマートフォン上で動かし、外出先から自分のパソコンを遠隔操作できるツールです。
08データと出典
Click the whale and get the full DSH web UI beside your code — the extension starts or reuses `dsh web`, handles DSH's o…
Works with **DSH 0.1.2 and newer**, including its browser authentication (auto sign-in, no manual step).
**Install / uninstall transparency.** The bridge is installed into `$DSH_HOME/profiles/<dsh.profile>` (default `~/.dsh/p…
このページは、プロジェクトの公開ドキュメント、リポジトリのメタデータ、および DSH Plugins の構造化解析に基づいて生成されています。最終検証日:2026-11-20。誤りを見つけた場合は、修正を送信してください。
dsh プラグイン おすすめ
最初に入れたい 12 のプラグイン。全カタログ・全カテゴリから厳選しました。
