DSH 插件安装失败：incompatible with dsh

这个报错是什么意思

dsh: installation rejected: Plugin dsh-better-sidebar@0.28.0 is incompatible with dsh 0.2.0-rc.2: peerDependencies {"@deepseek-ai/dsh-tools":"^0.2.1-rc.1", …}. Running it may cause crashes or data loss. …
dsh: nothing was installed.

从 0.2.0-rc.1（2026 年 9 月 28 日发布）起，DeepSeek Harness 装插件之前会先核对它声明的 dsh 版本范围：先看插件 package.json 里的 engines.dsh，没写的话就逐个看@deepseek-ai/dsh* 的 peer 依赖。当前的 dsh 不在范围里，就直接拒装，并把 profile 还原。8 月写的插件大多声明的是 ^0.1.0-rc.6 这类范围，一个 0.2 版本都不包含。

有两点最容易踩：

• 整条命令一起被拒。dsh plugin add a b c 里只要有一个不在范围内，三个都装不上——一组明明各自能用的插件，合在一起就是装不上，原因就在这。
• 这是版本问题，不是质量问题。同一个插件，在这一版 DeepSeek Harness 上能装，到下一版可能就被拒。升级 harness 可能触发它，升级 harness 也可能解决它。

有多常见

目前我们在 DeepSeek Harness 0.2.0-rc.2 上实测了 1,236 个插件，每个都在一次性 sandbox 的干净 profile 里装。其中 190 个在这一步被拒，被拒的里面有 42 个，换成旧版之后在同一个 dsh 上装得干干净净。目录里其余的插件正在重跑，数字会跟着更新。

解决办法，从省事的开始

1. 让 CLI 自己挑版本。npx dshmarketplace-cli add <插件> 会先读你本机的 dsh 版本，再装 harness 能接受的最新一版，判断规则和 harness 自己的一样。一次装多个也行，预设套装也是这么装的。
2. 自己钉版本。我们在当前 dsh 上跑过的每条记录，都写着实际装上的那一版和对应命令， 比如 dsh plugin --profile web add dsh-better-sidebar@0.26.1。下面的表列了 Star 最多的那些。
3. 明知有风险，硬装。报错里自己就给了按版本豁免的命令：dsh plugin --profile web allow-version <包名>@<版本> --dsh-version <你的 dsh> --accept-risk。harness 自己的警告照样成立——可能崩溃或丢数据——所以只留给没有兼容版本、而且你读过源码的插件。
4. 升级，或者等。有时候是最新版要的 dsh 比你装的新：dsh-better-sidebar 0.28.0 要求 ^0.2.1-rc.1，升级 DeepSeek Harness 就好了。其余情况只能等作者把范围放宽。

如果你是插件作者

在 package.json 里写上 engines.dsh，把你测过的 DeepSeek Harness 版本都覆盖进去。从 0.2.1 起 harness 会先看它、再看 peer 范围，而且写了 engines.dsh 就只看它——它是决定插件能不能装的那一个字段。你的插件在本站的记录里写着我们的 sandbox 在当前 dsh 上看到了什么，实测说明讲了是怎么跑的。

其他装不上的情况

• 显示装好了，但什么都没出现。dsh plugin 是往某个 profile 里装，不带 --profile 就没有地方可装。本站每条命令都带 --profile web，你用别的 profile 就换成它的名字。
• pnpm 拦了构建脚本。没进白名单的构建脚本 pnpm 不会跑，在那之前 harness 可能根本不注册这个插件。把 pnpm 打印出来的 key 加进 profile 里 pnpm-workspace.yaml 的 allowBuilds，再跑一次——或者交给 dshmarketplace-cli。
• 从 GitHub 装，卡在 prepare 脚本。源码安装要在你机器上构建，pnpm 一样会拦。办法同上；记录里有 npm 包的话，直接装 npm 包更省事。

在 DeepSeek Harness 0.2.0-rc.2 上被拒、Star 最多的插件