A native DSH compatibility layer that runs unmodified Pi ecosystem plugins as DSH plugins via one bridge. Install via `dsh plugin --profile web add pi2dsh`; restart dsh to mount. Requires Node.js 22.19+.
DSH integration
Native runtime
Author-claimed
Safety audit
Unaudited
Last verified
2026-08-23
License
MIT
01What can it help you accomplish?
Run Pi ecosystem plugins on DeepSeek Harness, unmodified
Pi npm packages mounted as native DSH plugins through a single bridge instance (one model directory, one login, one credential store)
DeepSeek Harness users who want Pi's mature plugin ecosystem (web search, memory, code nav, subagents, vision) without per-package adapters
02How to install into DeepSeek Harness
Prerequisites
- Node.js 22.19+
- DeepSeek Harness installed with the `dsh plugin` command
Installation steps
- 01
Run `dsh plugin --profile web add pi2dsh` (and `dsh plugin --profile web add pi-mcp-adapter` for the MCP adapter)
$ dsh plugin --profile web add pi2dsh
- 02
Restart `dsh` — plugins mount at startup
$ dsh
Verify the integration
Not specified by the author
Rollback
- Remove a plugin with `dsh plugin remove <pkg>` before removing the engine; upgrade the engine with `dsh plugin add pi2dsh@latest`. The README gives no explicit full-uninstall command beyond `dsh plugin remove`.
03DSH integration and capability boundaries
Native DSH compatibility layer: implements Pi's public extension ABI on top of DSH's native services so unmodified Pi packages run as DSH plugins.
Pi → DSH bridge (host + browser)
Unmodified Pi npm packages→Pi plugins surfaced through DSH's tool registry, models/llm config, skills, and user questions
One ABI gap fixed unlocks every package that hits it; the bridge keeps no per-package special casesTools go to DSH's tool registry; questions go to DSH's user questions — no second bridge-owned implementation of a DSH-native capabilityMCP adapter (pi-mcp-adapter)
Host-configured MCP server definitions→Full-screen MCP server manager with stdio/Streamable HTTP/SSE, discovery, proxy tools, resources, prompts
The Pi adapter's `/pi-mcp` runs beside DSH's native `/mcp`; both stay availableCompatibility CLI helpers
Package names / versions→`npx pi2dsh inspect <pkg>@<version>` (pre-upgrade report), `npx pi2dsh matrix --json` (capability matrix), `npx pi2dsh mcp-config` (Pi → DSH MCP entries)
`npx pi2dsh mcp-config` translates Pi mcpServers config into @deepseek-ai/dsh-mcp-client patch entries; plaintext keys trigger a warning
04Who is it for? When not to use it?
Good for
- DeepSeek Harness users who want Pi's mature plugin ecosystem (web search, memory, code nav, subagents, vision) without per-package adapters
Not for
- pnpm blocks dependency build scripts by default; if an add fails with ERR_PNPM_IGNORED_BUILDS, run `pnpm approve-builds` inside $DSH_HOME/profiles/web or allow them in pnpm-workspace.yaml.
- Where the bridge must bypass, degrade, or cannot express a Pi capability, it reports a known architectural gap rather than faking success; some Pi capabilities have no safe DSH mapping and are marked unusable with a removal hint.
05Compatibility, maintenance and safety notes
- Plugins mount only at DSH startup, so you must restart `dsh` after adding pi2dsh or any Pi plugin for it to take effect.
- pnpm blocks dependency build scripts by default; if an add fails with ERR_PNPM_IGNORED_BUILDS, run `pnpm approve-builds` inside $DSH_HOME/profiles/web or allow them in pnpm-workspace.yaml.
- Where the bridge must bypass, degrade, or cannot express a Pi capability, it reports a known architectural gap rather than faking success; some Pi capabilities have no safe DSH mapping and are marked unusable with a removal hint.
MIT · 由 facts pack 抓取（README 分支 main）
06Frequently asked questions
How do I install pi2dsh?
Run `dsh plugin --profile web add pi2dsh` (and `dsh plugin --profile web add pi-mcp-adapter` if you want the MCP manager), then restart `dsh`. Plugins mount at startup.
Do I need to modify Pi plugins?
No. pi2dsh implements Pi's public extension ABI on DSH's native services, so a Pi package runs as published — no fork, no patch, no per-package adapter.
Why did my add fail with ERR_PNPM_IGNORED_BUILDS?
pnpm blocks dependency build scripts by default. Run `pnpm approve-builds` inside $DSH_HOME/profiles/web (or allow the packages under allowBuilds in that profile's pnpm-workspace.yaml) and re-run the add.
What does the MCP adapter give me?
`pi-mcp-adapter` adds a full-screen MCP server manager (stdio/Streamable HTTP/SSE, discovery, proxy tools, resources, prompts) that runs beside DSH's native `/mcp` as `/pi-mcp`.
07Related DSH workflows
distilly
by titanwings
Meta-skill turning source material into a versioned Person Profile skill with incremental merge, correction layer, rollback, per-host install.
dsh-market
by dsh-market
插件市场 (plugin marketplace): 打开 Settings → Plugin Market 浏览/搜索/一键安装社区插件；安装源限制为 curated awesome-dsh-plugin 注册表（其余拒绝），默认禁用构建脚本（pnpm>=10 需显式开启）。
ai_animation
by unclecheng-li
Generate standalone animated HTML diagrams, presentations, notes, protocol visualizations, and UI demos from prompts.
aegis
by ganyuanran
Make AI coding agents architecture-aware: baseline-first, evidence-verified, drift-checked, and safe across long tasks.
08Data and sources
pi2dsh is one compatibility layer that implements Pi's public extension ABI on
dsh plugin --profile web add pi2dsh
This page is generated from the project’s public documentation, repository metadata and a structured parse of DSH Plugins; last verified on 2026-08-23. Found an error? Submit a correction.
Best DeepSeek Harness Plugins
Twelve plugins worth installing first — picked from the whole catalog, across every category.