采用 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 个值得优先安装的插件，覆盖各个分类。