$ cat ~/map/pi2dsh.md
pi2dsh
让 DeepSeek Harness 直接运行 pi 生态包的兼容桥，通过把 pi 公共扩展 ABI 映射到 DSH 原生服务实现无修改复用。
tools✓ 10月16日
事实速查
- GitHub Stars
- ★ 217
- Forks
- 34
- 许可证
- MIT
- npm / 月
- —
- 最后推送
- 2026年10月14日
安装
dsh plugin add pi2dsh## 速览
让 DeepSeek Harness 原样运行 pi 生态插件的兼容桥——先用 dsh plugin add pi2dsh 装一次引擎，之后任何 pi 包直接从 npm 添加：不改代码、不打补丁、无需逐包适配。
## 要点
- $在 DSH 原生服务之上实现 pi 的公共扩展 ABI，pi 包以发布原样在 DSH 上运行；核心代码不含任何逐包特判——修好一个 ABI 缺口，所有踩到该缺口的包同时受益。
- $一个桥接实例通过单一引擎挂载 profile 里的全部 pi 包——一个模型目录、一次登录、一份凭据存储、一个升级单元。插件在启动时挂载，增删任何东西后都要重启 dsh。
- $日常操作就是普通的 dsh plugin add/remove；npx pi2dsh inspect <pkg>@<version> 在升级插件前输出兼容性报告，npx pi2dsh matrix --json 导出完整能力矩阵，npx pi2dsh mcp-config 把 pi 的 mcpServers 配置翻译为官方 DSH MCP 条目。
- $为 pi-mcp-adapter、@tintinweb/pi-subagents、@kassing/pi-vision、pi-hermes-memory、pi-background-tasks、pi-btw 等插件提供了端到端验证与可运行示例；另外还把 pi 目录按月下载量前 50 的包逐一挂载进真实 DSH 运行时并探测，逐包证据发布在仓库里。
- $订阅登录在 DSH 上可用：桥接层补上 pi 的交互式 OAuth，pi 官方四个流程（OpenAI Codex、Anthropic、GitHub Copilot、Kimi Code）内置；凭据按 pi 的 auth.json 语义持久化，并经标准 dsh-credentials provider 按请求解析。
- $需要 Node.js 22.19+ 与 DeepSeek Harness。引擎只有一个可选配置项 serveNativeSubagents——开启后 DSH 原生 subagent 也会在自己的 agent 作用域上获得该 profile 的 pi 包。
## 常见问题
Q 引擎和插件分别怎么升级？
dsh plugin add <pkg>@latest 只升级单个插件、不动引擎；dsh plugin add pi2dsh@latest 只升级引擎、不动插件。移除引擎之前应先移除插件。
Q 为什么 add 悄悄装了旧版本？
pnpm 的 minimumReleaseAge 会跳过刚发布不久的版本——用 dsh plugin add pi2dsh@<version> 固定版本。若 pnpm 拦截依赖构建脚本（ERR_PNPM_IGNORED_BUILDS），在 $DSH_HOME/profiles/<profile> 里跑 pnpm approve-builds，或在 allowBuilds 下放行列出的包，然后重新执行 add。
Q 所有 pi 插件都能用吗？
以仓库里的证据为准，没有一刀切的保证。端到端验证过的插件各带可运行示例；前 50 名探测只说明桥接覆盖了该插件触碰到的部分。没有安全映射的能力会用明文如实报告，而不是假装成功。
## 参考链接
## 相关条目
最后更新: 2026年8月31日