本文由本站基于该插件已收录的字段自动派生（wiki / faq / compatibility_json / readme），非 AI 即时创作。每节末尾标源字段。

快速上手

pi2dsh

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add pi2dsh

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

关键要点

• ERR_PNPM_IGNORED_BUILDS：pnpm 默认拦截依赖的构建脚本。在
• 刚发版后 add 装到了旧版本：pnpm 的 minimumReleaseAge 会跳过刚发布不久
• • id: qwen/qwen2.5-vl-72b-instruct
• DSH 已经有的东西，绝不再造一遍。 工具进 DSH 的工具注册表，模型进 DSH 的
• 你面前永远没有 Pi。 你要配的、要读的、要敲的，全是 DSH 形状：DSH 设置、

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

安装时遇到 ERR_PNPM_IGNORED_BUILDS 怎么办？

pnpm 默认拦截依赖的构建脚本。在 profile 目录下跑 pnpm approve-builds，或在 profile 的 pnpm-workspace.yaml 的 allowBuilds 下把需要的包设为 true，然后重新 add。这是用户的安全决定，桥不会自动绕过。

发版后立刻 add 安装到了旧版本怎么办？

pnpm 11 的 minimumReleaseAge 会跳过刚发布不久的版本。用 dsh plugin add pi2dsh@<版本> 显式钉版本即可。

引擎安装后还需要再装一次吗？

不用。pi2dsh 是引擎，安装一次，之后所有 Pi 插件都用 dsh plugin add <任意 Pi 包> 当作普通 npm 依赖装。重启 dsh 后引擎会读 profile 的直接依赖并自动挂载。

引擎如何识别哪些依赖是 Pi 插件？

引擎读 profile package.json 的 dependencies 字段，依赖自身的 pi manifest 字段或 Pi 的目录约定（extensions/skills/prompts 目录）。声明了 dsh.bundle 的不算 Pi 包。

默认的纯文本模型能接收图片吗？

引擎会为每个纯文本路由自动注册一个 <路由>-vision 伴生路由，用于接收粘贴图片，委托给挂载的视觉插件分析，分析结果以注入上下文的形式回到这一轮。像 GPT-5/o 系列不要用作视觉后端，因为它们会拒绝某些插件发送的非默认 temperature 参数。

订阅型账号（ChatGPT/Claude/Copilot/Kimi）能在 DSH 上用吗？

可以。引擎内建四个 Pi 官方 OAuth 流程，/login 就能登录，凭证以 Pi 的 auth.json 语义持久化，并通过标准 dsh-credentials 解析，调用走 DSH 原生 LLM 路径。

升级引擎会影响已装的 Pi 插件吗？

不会。升级引擎（dsh plugin add pi2dsh@latest）和升级 Pi 插件（dsh plugin add @latest）互不干扰，是独立的升级单元。

安装命令需要写 profile 名吗？

DSH 有多个 profile 时需要。落地页命令带 --profile web，意思是装到 web 这个 profile 上。

— 源: plugin_wiki.faq_json

兼容性

• DSH: 0.1.0-rc.8+（依赖 rc.8 一组 dsh-* peerDependencies）
• Node: >=22.19.0

— 源: plugin_wiki.compatibility_json

踩坑提醒

安装前请审阅上游仓库；本指南基于已收录字段自动派生，可能滞后于最新版本。如发现与官方文档冲突，请以上游为准。

— 来源：通用规则