採 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 工作流程
last30days-skill-cn
作者 jesseovo
last30days-cn 是一個 AI Agent 技能（Skill），能夠自動搜尋中國網際網路 8 大主流平臺最近 30 天的內容，綜合分析後生成有據可查的研究報告。
browser4
作者 platonai
面向自主智慧體與大規模網頁自動化的 AI 原生瀏覽器引擎，支援智慧內容抽取。
modsearch
作者 liustack
🥇 The strongest free web search plugin for DeepSeek Harness, and the search bridge for every model without native web access. Free, no signup, no API key. Ask the web or X, get structured JSON evidence. | 🥇 全網最強的 DeepSeek Harness 免費聯網搜尋外掛，免費免註冊免 API key。為不能聯網的模型補上搜索，問網頁或 X，拿回結構化 JSON 證據（搜尋、抓取、引用）。
anysearch-dsh
作者 anysearch-team
為 DeepSeek Harness 提供的 AnySearch 網頁搜尋提供方與高階搜尋工具。
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 個值得優先安裝的外掛，涵蓋各個分類。