快速判断

安装前先看这几项

配置资料: 配置资料完整
配置难度: 较高
适合新手: 建议具备相关经验
兼容状态: 不兼容当前版本
验证状态: 源码已审阅，未标记运行实测

本页目录（9）

中文教程

按照固定来源完成安装、配置与验证

教程包含独立 Profile、精确安装目标、配置证据、最小验证任务、回退和数据清理。

查看 pi2dsh 安装与配置教程 →

功能

这个插件能做什么

连接 Pi 与 DSH 插件生态，让符合 Pi Host ABI 的扩展作为 DSH 原生插件运行，并桥接工具、命令、模型、MCP、OAuth 与子 Agent 能力。

适合谁

需要插件安装、插件管理、插件更新能力的用户。

使用门槛

该插件涉及较高配置难度或敏感权限，不建议在生产工作区直接试装。

准备

安装前准备

独立测试 Profile（必需）：只在独立 web 或 dsh-tui Profile 中测试兼容层。
待接入的 Pi 扩展（必需）：先用作者 inspect 命令检查具体包和版本，不连接真实凭据。

安装

如何安装 pi2dsh

本页命令固定使用 DSH 0.1.1-rc.2，与 npm 默认版本分别维护。切换 DSH 前核对本插件的兼容记录；新版 Session API 与格式变化见0.1.3-alpha.1 升级说明。源码审阅不等于运行验证。

下面的命令使用本站核验的 DSH 基线，并锁定插件版本或 Git commit，避免默认分支变化导致安装内容漂移。本站已核对安装目标，但尚未在你的系统和 Profile 中实际执行。

安装到: web Profile
DSH 基线: 0.1.1-rc.2
安装来源: GitHub 源码（锁定提交）
固定目标: github:weijiafu14/pi2dsh#2f3ced97d0d1

既有插件教程与安装命令的固定 CLI 基线，独立于 npm 默认分发；不代表每个插件已在该版本或新版本运行验证。更新前须逐项审核配置证据。

DSH 版本组合来源 1（外部链接，在新标签页打开）

01
检查 Node.js 与 pnpm
DSH 当前基线需要 Node.js 22.19 或 Node.js 24 及以上，并且 pnpm 必须已在 PATH 中。先运行：
环境检查
```
node --version && pnpm --version
```
02
安装到 Web Profile
这条命令会把插件加入 web Profile，并在插件声明 DSH Bundle 时自动加入配置层。
GitHub 源码（锁定提交）
```
npx --yes @deepseek-ai/[email protected] plugin --profile web add github:weijiafu14/pi2dsh#2f3ced97d0d1
```
03
如遇构建脚本拦截
GitHub 源码插件可能通过 prepare 构建。pnpm 10 及以上会先阻止未授权构建；只把终端明确提示的包名加入该 Profile 的 pnpm-workspace.yaml 中 allowBuilds，审阅脚本后再重复上一步，不要使用全局放行。
04
确认 Bundle 已进入配置
安装成功后先导出组合配置，不启动 Agent。输出中应能找到包名 pi2dsh或对应 Bundle 层。
检查配置
```
npx --yes @deepseek-ai/[email protected] --profile web --dump-config
```
05
启动并完成最小验证
启动 Web Profile 后，只测试一个与插件功能直接相关的最小任务，并检查日志、文件、网络和凭据访问是否符合预期。
启动 DSH Web
```
npx --yes @deepseek-ai/[email protected] web
```

卸载与回退

测试不通过时先停止 DSH，再从同一 Profile 移除插件。移除后重新运行配置检查，确认对应 Bundle 层已经消失；插件自己创建的数据和外部账号配置可能需要另行清理。

从 Web Profile 移除

npx --yes @deepseek-ai/[email protected] plugin --profile web remove pi2dsh

阅读 DSH 插件安装基础指南核对项目 README

配置

插件专属配置

$DSH_HOME/profiles/<profile>/cordis.patch.yml: 控制是否把已发现的 Pi 包提供给 DSH 原生子 Agent。

原生子 Agent opt-in · yaml。示例中的账号、路径和凭据占位符必须替换，不要提交真实密钥。

复制原生子 Agent opt-in 配置

- id: pi2dsh
  config:
    serveNativeSubagents: false

核对配置证据（外部链接，在新标签页打开）

保持 serveNativeSubagents 为 false，先只安装一个无凭据、低权限的 Pi 扩展。
安装新 Pi 扩展前运行 npx pi2dsh inspect <包名>@<版本> 并核对构建脚本。

验证

配置检查与成功结果

01
检查 web Profile 的组合配置只出现 pi2dsh 和计划测试的扩展。
期望结果：没有意外的 Pi 包、凭据 Provider 或子 Agent 扩展进入 Profile。
02
在可丢弃工作区验证扩展的一个只读能力。
期望结果：结果通过 DSH 工具或命令返回，关闭插件后对应能力消失。

使用

第一次使用建议这样验证

先安装一个不需账号和写权限的 Pi 扩展，只调用一次只读能力并保存日志。

权限

它可能接触哪些数据和能力

执行本机命令使用服务凭据访问外部网络

会动态加载用户选择的 Pi npm 扩展；扩展可进入 DSH 工具、命令、模型、凭据、MCP、文件与子 Agent 链路，并与宿主进程共享权限

数据存储：pi2dsh 本身读取 DSH Profile、凭据引用与会话；具体新增存储由所安装的 Pi 扩展决定。

请注意：“源码已审阅”说明本站检查到的证据范围，不等于安全认证。重要工作区应锁定版本、备份数据并在最小权限下测试。

排查

故障排查与数据清理

扩展未加载: 运行 inspect，核对固定版本、构建脚本和 Profile，再重启 DSH。
权限范围不清楚: 停止使用并审阅该 Pi 扩展自身源码；兼容层审阅不能替代扩展审阅。

卸载后的清理步骤

先从 Profile 移除所有 Pi 扩展，再移除 pi2dsh。
检查扩展自己的配置、凭据、MCP 和缓存目录并按其文档清理。

深入审计：兼容性、数据流与来源

证据

兼容性与审阅记录

兼容性说明

DSH 0.2.0-rc.2 不兼容：0.23.0 声明的 DSH 依赖范围不包含 0.2.0-rc.2（如 @deepseek-ai/dsh-attachment），0.2.0 起会被拒绝安装或在启动时停用；固定 DSH 0.1.1-rc.2 的原审阅组合不受影响。原审阅结论：0.23.0 的 peer 依赖显式覆盖 DSH 0.1.0-rc.8、0.1.1-rc.1 与 0.1.2-alpha.1；52DSH 只完成固定提交静态审阅，未安装第三方扩展或运行端到端测试

数据流

DSH 会话、Profile 与凭据引用 → pi2dsh 兼容运行时 → 已安装的 Pi 扩展、MCP 或模型 Provider → 工具结果、附件与子会话事件返回 DSH。

源码审阅结论

对比旧固定提交后复核了 0.23.0 新增的双版本预检、模型登录卡、OAuth、MCP、代码导航、展示面和子 Agent 桥接。peer 范围包含 0.1.2-alpha.1 只代表作者声明兼容；Pi 扩展仍会作为宿主代码运行，可能读写文件、执行命令或访问外部服务，安装前应逐个审查扩展并先运行作者的 inspect 检查。

来源与维护信息

本页根据固定提交的仓库、包清单和本站审阅资料生成。版本变化后，请重新核对作者说明。

精确来源: GitHub：weijiafu14/pi2dsh（外部链接，在新标签页打开）
来源登记表: Awesome DSH Plugin（外部链接，在新标签页打开）
来源快照: 08f3df46cca1
固定提交: 2f3ced97d0d1
许可证: MIT
主要语言: TypeScript
中文资料: 有完整中文配置资料

查看开放注册表记录我是插件作者：认领或更新发现错误：提交纠正

pi2dsh