採 MIT 授權的網頁駕駛艙，在單一介面中執行 pi 程式設計代理與官方 DeepSeek Harness 執行環境（dsh）——支援串流對話、檔案樹、終端機、模型管理以及外掛／佈景主題系統，預設僅監聽本地回環位址。
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
02如何將外掛接入 DeepSeek 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`。
把 pi-web-ui 暴露到網路安全嗎？
預設僅綁定本地回環位址（127.0.0.1）。只有在需要區網 / 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
作者 adamplatin123
DSH Plugin Radar — 開源 DSH 外掛生態雷達：自動發現 15900+ 候選、k8s 執行級實測 10000+、15 分鐘快照管線；外掛目錄是其自動生成的 artifact
picgo-core
作者 picgo
強大的圖片上傳引擎，同時支援 CLI 與 API。
dsh-infinite-gen-3
作者 minglink
DeepSeek 專用破甲外掛「無限三代」dsh-infinite-gen-3 — armor-breaking plugin for DeepSeek，破甲版：穩定化破甲，求 Star 收藏 ⭐
helloagents
作者 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。發現錯誤？提交更正。
最佳 DeepSeek Harness 外掛
從全目錄挑出的 12 個值得優先安裝的外掛，涵蓋各個分類。