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