跳到正文

weijiafu14/pi2dsh

131最近提交 2026年8月16日

pi2dsh DSH 插件

pi2dsh 在 DSH 原生服务之上实现了 Pi 的公开扩展 ABI，允许任何 Pi 包作为 DSH 插件安装。它是一个桥接器，使 DSH 用户能够使用 Pi 生态中的视觉、搜索、记忆、子代理等能力。该桥接是临时方案，DSH 自己的生态最终会提供原生替代方案。

developer-toolsremote-execution

如何安装 pi2dsh DSH 插件

dsh plugin add pi2dsh          # once

复制不会执行命令。安装 pi2dsh DSH 插件前请核对仓库和版本。

pi2dsh DSH 插件数据来源

pi2dsh DSH 插件快照日期：2026年8月16日

discovered

pi2dsh DSH 插件能做什么

  • 使用标准 `dsh plugin add` 命令安装任何 Pi 插件作为 DSH 插件。
  • 无需修改、无需分支或补丁即可运行 Pi 插件。
  • 提供视觉桥接，通过 Pi 视觉插件为纯文本模型添加图像分析能力。
  • 支持多种 Pi 插件：网络搜索、记忆、子代理、代码导航、审批、侧对话、MCP 适配器等。
  • 自动为纯文本模型创建图像接纳配套路由。
  • 提供 `npx pi2dsh inspect` 命令在升级前检查插件。

pi2dsh DSH 插件适合哪些场景

  • 通过安装 Pi 视觉插件并配置视觉模型端点，为纯文本 DeepSeek 模型启用图像分析。
  • 使用 pi-btw 插件通过 `/btw` 命令在 DSH 中运行侧对话，创建子会话。
  • 使用 pi-hermes-memory 跨会话持久化记忆，在多个 DSH 进程间读写记忆。
  • 使用 pi-approval-guardian 为所有工具调用添加第二个模型审批门，增强安全性。
  • 通过 pi-mcp-adapter 或 pi-mcp-extension 连接 MCP 工具，扩展 DSH 的能力。

pi2dsh DSH 插件适合谁

  • DeepSeek Harness 用户，希望利用成熟的 Pi 插件生态。
  • 使用 DSH 但需要视觉、搜索、记忆、子代理等原生尚不支持的能力的开发者。

pi2dsh DSH 插件的限制

  • 需要 Node.js 22.19+ 和已安装的 DeepSeek Harness。
  • Pi 插件可能需要用户手动设置环境变量进行配置（例如视觉模型 API 密钥）。
  • 该桥接是临时解决方案；DSH 自己的生态最终会提供原生替代方案，用户应在可用时切换。
  • 并非所有 Pi 插件都经过完全验证；只有前 50 个中的一部分经过了端到端测试。某些功能可能需要填补 ABI 间隙。
  • 安装可能受 pnpm 默认行为（阻止构建脚本、最小发布年龄）影响，需要手动干预。

pi2dsh DSH 插件的仓库 README 摘录

以下文字摘自 pi2dsh DSH 插件的上游仓库 weijiafu14/pi2dsh 的 README，版权归原作者，仅作引用。

**English** | [中文](README.zh.md) **Run the Pi ecosystem's plugins on DeepSeek Harness, unmodified.** ```sh dsh plugin add pi2dsh # once dsh plugin add <any-pi-plugin> # then any Pi plugin, straight from npm ``` ## Why this exists [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) is built on ideas worth betting on — a durable, reconstructable session log, a clean service composition, an agent loop you can actually reason about. What it does not have yet is a large plugin ecosystem: it is early, and the plugins people want on day one — web search, memory, code navigation, subagents, vision — are mostly not written for it yet. [Pi](https://pi.dev/) has that ecosystem already, and it is mature: hundreds of published packages, many with real users. pi2dsh is one compatibility layer that implements Pi's public extension ABI on top of DSH's native services, so a Pi package runs on DSH **as published** — no fork, no patch, no per-package adapter. You install a Pi plugin the same way you install anything else in DSH, and it works. This is deliberately a bridge, not a destination. Every capability you reach through pi2dsh is a capability DSH's own ecosystem

阅读完整 README仓库许可: MIT

pi2dsh DSH 插件常见问题

如何安装 pi2dsh？

运行 `dsh plugin --profile web add pi2dsh` 安装引擎。安装后重启 `dsh` 以挂载插件。之后你可以使用 `dsh plugin add <包名>` 添加任何 Pi 插件。

pi2dsh 支持所有 Pi 插件吗？

理论上，任何遵循公开扩展 ABI 的 Pi 插件都可以工作。但只有前 50 个最常下载的包中的一部分经过了测试。README 中包含已验证列表；对于列表之外的插件，你可能遇到需要填补的 ABI 间隙。

如何为 pi2dsh 配置视觉模型？

设置环境变量 `VISION_BRIDGE_BASE_URL`、`VISION_BRIDGE_MODEL` 和 `VISION_BRIDGE_API_KEY`，指向 OpenAI 兼容的视觉端点。插件在运行时读取这些变量。你也可以通过 `settings.yaml` 将模型添加到 DSH 的模型选择器中。

安装后插件不工作怎么办？

常见问题包括 pnpm 的 `ERR_PNPM_IGNORED_BUILDS` 错误，需要你通过 `pnpm approve-builds` 批准构建脚本或编辑 `pnpm-workspace.yaml`。另外，pnpm 的 `minimumReleaseAge` 可能暂时锁定旧版本；使用 `dsh plugin add <包名>@<版本>` 强制指定版本。

pi2dsh 是永久解决方案吗？

不是，pi2dsh 明确是一个桥接器。README 指出 DSH 自己的生态最终会为通过该桥接访问的能力提供原生替代方案。当原生插件可用时，你应该切换过去，因为桥接被设计为临时方案。