安装 DSH 插件

最后更新 2026-11-09

DSH 的插件安装走宿主自己的包管理器，本质是往 profile 目录里加一个依赖，再把它的组合包补丁插进启动配置。

一条命令

$ dsh plugin --profile web add <包名或来源>

来源可以是 npm 包名（some-plugin）、固定到提交的 Git 地址、本地目录或 tgz。执行后 DSH 会调用 pnpm 安装，写入 profile 的 package.json，并在 cordis.patch.yml 里插入插件条目。

装完为什么没反应

两种生效方式：

• 启用了 HMR 的 profile：插件会热加载，刷新页面即可看到新页签或设置项；
• 没启用 HMR：需要重启 DSH，否则条目已写入但未加载。

版本不兼容会直接拒绝

安装前宿主会检查插件的 engines.dsh（没有则看 @deepseek-ai/dsh-* 的 peer 依赖）是否接受当前 DSH 版本。不接受时不会下载任何东西，也不会运行安装脚本。确认风险后可以授予精确版本的豁免，再用同一命令重试。

安装脚本默认被拦截

pnpm 11 会拦下依赖的构建脚本。安装失败时回执里带 pendingBuilds，需要你明确批准后重试；批准会以宿主用户权限执行命令，请先确认这个包确实需要构建。