MIT ライセンスのブラウザ操作盤。pi コーディングエージェントと公式 DeepSeek Harness ランタイム（dsh）の両方を単一の Web UI で実行し、ストリーミングチャット・ファイルツリー・ターミナル・モデル管理・プラグイン／テーマ機能を提供。既定ではループバック（127.0.0.1）のみ待ち受けます。
DSH 統合
ネイティブ実行
作者による申告
安全性監査
未監査
最終検証日
2026-09-03
ライセンス
MIT
01どんなタスクに使えるのか？
Drive the pi / DeepSeek Harness coding agent from a polished browser cockpit
Streaming chat with thinking blocks, tool-call cards, a live file tree, a built-in terminal, model management and a full settings panel
Developers who run the pi coding agent or DeepSeek Harness and want a web UI instead of a bare terminal
Run the official DeepSeek Harness runtime behind a web UI
The DSH engine drives the official @deepseek-ai/dsh runtime as a subprocess over the same chat/terminal/plugin wire protocol, with goal mode, MCP bridging and skill toggles
DeepSeek Harness users who want a browser UI with goal mode, MCP bridges and runtime skill enable/disable
02DeepSeek Harness への導入方法
前提条件
- Node.js ≥ 22.19
- A configured pi install
- For the DSH engine: install the @deepseek-ai/dsh runtime and set a DeepSeek API key
インストール手順
- 01
Install globally: `npm i -g pi-web-ui`
$ npm i -g pi-web-ui
- 02
Start the web UI: `pi-web-ui` (serves http://localhost:8787)
- 03
Run with the DeepSeek Harness engine: `pi-web-ui --engine dsh --port 9000 --cwd /path/to/project`
- 04
Or set the runtime separately: `npm i -g @deepseek-ai/dsh@0.1.1-rc.2`
$ npm i -g @deepseek-ai/dsh@0.1.1-rc.2
- 05
On npm 12+, allow native build scripts: `npm i -g --allow-scripts=node-pty,@google/genai,protobufjs pi-web-ui@latest`
$ npm i -g --allow-scripts=node-pty,@google/genai,protobufjs pi-web-ui@latest
導入成功の確認
- Open http://localhost:8787 and confirm the footer shows a DSH badge when running with `--engine dsh`
- Call `GET /api/health` — the `engine` field reports `dsh` when the DeepSeek Harness engine is active
03DSH 統合と能力の範囲
Switchable engine: set `PI_WEB_ENGINE=dsh` (or `--engine dsh`) to drive the official @deepseek-ai/dsh runtime as a subprocess; shares the same WebSocket wire protocol as the pi engine (goal mode, SCM, terminals, plugins, MCP bridge all work).
Streaming chat cockpit
natural-language prompts, attached files and images→streaming replies with thinking blocks, tool-call cards and live bash output
Built-in terminal & Git panel
shell commands and git operations→xterm.js terminal with per-client PTY plus a Git status / branch / diff / commit UI
spawns a per-client PTY processruns git status/branch/push/pull in the visible terminalDeepSeek Harness engine (dsh)
DSH engine mode (PI_WEB_ENGINE=dsh / --engine dsh)→drives the official @deepseek-ai/dsh runtime as a subprocess with the same wire protocol
spawns the official @deepseek-ai/dsh runtime as a subprocessPlugin & theme extensibility
drop-in UI plugins and pure-CSS themes→extra top-bar tabs + agent tools, and :root palette theme overrides
DSH skill & MCP bridge
DSH skill catalog and mcp.json MCP servers→bridges plugin AI tools and external MCP servers into the DSH runtime; exposes skill enable/disable in Settings
04誰に向いているのか？使うべきでない場面は？
向いている用途
- Developers who run the pi coding agent or DeepSeek Harness and want a web UI instead of a bare terminal
- DeepSeek Harness users who want a browser UI with goal mode, MCP bridges and runtime skill enable/disable
不向きな用途
- Requires Node.js ≥ 22.19 and a configured pi install to run pi-web-ui at all.
- On npm 12+, dependency install scripts are blocked by default, so you must allow node-pty's install script (a native module) or it will not build.
- The server is loopback-only (127.0.0.1) by default; setting PI_WEB_HOST=0.0.0.0 exposes it on the LAN / to containers, so pair it with a firewall rule.
05互換性・メンテナンス・セキュリティ上の注意
- Requires Node.js ≥ 22.19 and a configured pi install to run pi-web-ui at all.
- On npm 12+, dependency install scripts are blocked by default, so you must allow node-pty's install script (a native module) or it will not build.
- The server is loopback-only (127.0.0.1) by default; setting PI_WEB_HOST=0.0.0.0 exposes it on the LAN / to containers, so pair it with a firewall rule.
MIT · last push 2026-09-02 · 84 stars · 19 forks
06よくある質問
DeepSeek Harness エンジンで pi-web-ui を動かすには？
まず `npm i -g @deepseek-ai/dsh@0.1.1-rc.2` でランタイムをインストールし、`--engine dsh` 付きで起動（例: `pi-web-ui --engine dsh --port 9000 --cwd /path/to/project`）するか、`PI_WEB_ENGINE=dsh` を設定します。フッターに DSH バッジが表示され、`/api/health` で現在のエンジンを確認できます。
DSH エンジンはプラグインや MCP サーバーに対応していますか？
対応しています。プラグインの AI ツールや `mcp.json` に列挙した外部 MCP サーバーは DSH ランタイムにブリッジされサーバー側で実行されるため、DSH モデルから呼び出せます。DSH スキルカタログも設定画面に公開され、実行時にスキルの有効／無効を切り替えられます。
前提条件は何ですか？
Node.js ≥ 22.19 と設定済みの pi インストールが必要です。npm 12+ では依存のインストールスクリプトが既定でブロックされるため、node-pty のビルドスクリプトを許可してください: `npm i -g --allow-scripts=node-pty,@google/genai,protobufjs pi-web-ui@latest`。
ネットワークに公開しても安全ですか？
既定ではループバック（127.0.0.1）のみバインドします。LAN / Docker からのアクセスが必要な場合のみ `PI_WEB_HOST=0.0.0.0` を設定し、ファイアウォールと併用してください。プロバイダーのヘッダー（API キーを含む）がサーバー外へ出ることはなく、WebSocket 接続は Origin と Host が一致しない場合に拒否されます。
更新や削除はどうしますか？
アップグレードは `npm i -g pi-web-ui@latest` の後 `pi-web-ui server restart` を実行し、アンインストールは `npm uninstall -g pi-web-ui` です。`~/.pi-web` のセッションデータはアンインストール／アップグレード後も残ります。README に自動ロールバックの手順はなく、ダウングレードする場合は該当バージョンを再インストールしてください。
07関連する DSH ワークフロー
dsh-plugin-radar
by adamplatin123
DSH プラグイン生態系のオープンソース・レーダー。1.5 万件超の候補を自動発見し、k8s ランタイムで 1 万件超を実測、15 分ごとのスナップショット処理を実行。プラグイン目録は自動生成される成果物です。
picgo-core
by picgo
CLI と API の両方で使える画像アップロードエンジン
dsh-infinite-gen-3
by minglink
DeepSeek専用の破アーマープラグイン「無限三代」。脱獄動作を安定化させ、Starで応援をお願いします。
helloagents
by hellowind777
問題を分析するだけでなく、実装と検証が完了するまで自律的に働き続ける高度なエージェント
08データと出典
the **DSH engine** runs the official [`@deepseek-ai/dsh`](https://github.com/deepseek-ai/dsh) (DeepSeek Harness) runtime…
plugin AI tools and external MCP servers (`mcp.json`) are bridged into the DSH runtime, so the DSH model can call them (…
このページは、プロジェクトの公開ドキュメント、リポジトリのメタデータ、および DSH Plugins の構造化解析に基づいて生成されています。最終検証日：2026-09-03。誤りを見つけた場合は、修正を送信してください。
dsh プラグイン おすすめ
最初に入れたい 12 のプラグイン。全カタログ・全カテゴリから厳選しました。