原生 DSH 兼容层,通过一个桥接把未修改的 Pi 生态插件当作 DSH 插件运行。通过 `dsh plugin --profile web add pi2dsh` 安装;重启 dsh 以挂载。需要 Node.js 22.19+。
DSH 适配
原生运行时
作者声明
安全审计
未审计
最后核验
2026-08-23
许可证
MIT
01它能帮你完成什么?
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
02如何接入 DeepSeek Harness?
前置条件
- Node.js 22.19+
- DeepSeek Harness installed with the `dsh plugin` command
安装步骤
- 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
验证接入成功
作者未说明
回滚
- 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 适配与能力边界
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
04适合谁?何时不该用?
适合
- DeepSeek Harness users who want Pi's mature plugin ecosystem (web search, memory, code nav, subagents, vision) without per-package adapters
不适合
- 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.
05兼容性、维护与安全提示
- 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)
06常见问题
怎么安装 pi2dsh?
执行 `dsh plugin --profile web add pi2dsh`(想要 MCP 管理器则再加 `dsh plugin --profile web add pi-mcp-adapter`),然后重启 `dsh`。插件在启动时挂载。
需要修改 Pi 插件吗?
不需要。pi2dsh 在 DSH 原生服务之上实现 Pi 的公开扩展 ABI,Pi 包以原样发布方式运行——不分叉、不打补丁、无需逐包适配器。
为什么添加时出现 ERR_PNPM_IGNORED_BUILDS?
pnpm 默认拦截依赖的构建脚本。在 $DSH_HOME/profiles/web 内运行 `pnpm approve-builds`(或在该 profile 的 pnpm-workspace.yaml 的 allowBuilds 下放行这些包),再重新执行添加。
MCP 适配器有什么用?
`pi-mcp-adapter` 提供全屏 MCP 服务器管理器(stdio / Streamable HTTP / SSE、发现、代理工具、资源、提示),作为 `/pi-mcp` 与 DSH 原生的 `/mcp` 并存。
07相关的 DSH 工作流
distilly
作者 titanwings
Distilly — Distill how they think into reusable Skills for any Agent or Bot. Formerly Colleague Skill(原同事 Skill).
dsh-market
作者 dsh-market
The plugin market inside DeepSeek Harness — browse, search, one-click install · DSH 可视化插件市场
ai_animation
作者 unclecheng-li
本项目整理了用于生成[炫酷 HTML 动画网页]的 AI Prompts,涵盖动画效果、3D 可视化、PPT 风格演示、UI 美化等多个类别。
aegis
作者 ganyuanran
让 AI 编码智能体具备架构意识:基线优先、证据验证、漂移检查,保障长任务安全。
08数据与来源
pi2dsh is one compatibility layer that implements Pi's public extension ABI on
dsh plugin --profile web add pi2dsh
页面基于项目公开文档、仓库元数据和 DSH Plugins 的结构化解析生成;最后核验于 2026-08-23。发现错误?提交更正。
最佳 DeepSeek Harness 插件
从全目录挑出的 12 个值得优先安装的插件,覆盖各个分类。
