DSH plugin 怎么安装？dsh plugin add 命令与 GitHub 仓库安装验证

DSH plugin 的安装命令就一条：dsh plugin --profile web add <插件包名或 GitHub 地址>，框架会把参数转发给 pnpm，自动把插件装进当前 profile。

安装前：先有 DSH

装 DSH plugin 的前提是先跑通 DSH 本体。 没装的话先看《DeepSeek Harness 怎么安装》，用 npx @deepseek-ai/dsh web 把 Web UI 跑起来。第一次启动时，web profile 会自动初始化，之后 dsh plugin 命令才有地方可装。

注意：dsh web 是 --profile web 的别名，所以装插件时 profile 写 web，就是装进 Web UI 正在用的那个 profile（来源）。DSH 内置 web 和 headless 两个 profile，都在首次使用时从自带模板自动初始化；其他名字的 profile 不存在时，需要先用 dsh plugin 创建。调用 dsh 的目录是默认工作区根目录，装完插件后的会话和工作区都围绕这个目录展开。

核心命令：dsh plugin add

装插件统一走 dsh plugin --profile <name> <pnpm 参数>，add 表示安装。 完整写法：

dsh plugin --profile web add <插件包名或GitHub地址>

• 插件是 npm 包时，直接写包名；
• 插件托管在 GitHub 时，写 github:用户名/仓库名 这样的引用（来源）。

dsh plugin 是 profile 插件管理的统一入口，add 只是其中一个动作，install / update / remove 都是同一条语法换参数。命令会把 --profile <名字> 之后的参数原样转发给 profile 目录里的 pnpm，相当于在 ~/.dsh/profiles/web 下执行 pnpm add（来源），所以动作词要写在命令最后。

命令执行后，插件会作为依赖装进 profile 目录（默认 ~/.dsh/profiles/web），DSH 下次启动时自动加载并注册它的能力。装进哪个 profile，插件就只影响哪个环境，web 和 headless 互不干扰。

真实 DSH plugin 示例

拿两个真实的 DSH plugin 练手。 界面类的 dsh-tui 是 Claude Code 风格的终端界面，安装命令：

dsh plugin --profile web add github:ccch1mneyyy/dsh-tui

工具类的 ModLens 是第一个视觉 DSH plugin，能让纯文本模型看懂图片，安装命令：

dsh plugin --profile web add github:liustack/modlens

更多插件到 dsh-plugin.org 插件中心 里挑，每个插件的详情页都带一行可直接复制的安装命令。这两个例子分别覆盖了界面类和工具类插件，装完你就能直观感受到 DSH plugin 的两种形态。

DSH plugin 装完怎么验证

重启 dsh web，看插件能力是否出现。 界面类插件会改 UI，工具类插件会出现在工具的列表里。装完没生效，先核对插件标注的兼容版本，再看下面的注意事项。想确认插件到底有没有加载，执行 dsh --dump-config 看组合后的配置树，插件注册没注册一眼能看出来；想知道某个插件为什么被装、被谁依赖，用 dsh plugin --profile web why <包名> 查依赖关系（来源）。

首次安装 git 插件的注意点

git 托管的插件首次 add 可能被 pnpm 的 allowBuilds 拦住。 pnpm 默认不放行 git 依赖的构建脚本，报错时按提示把允许 key 复制到 profile 目录的 pnpm-workspace.yaml，重新执行一次 add 即可。

另外，DSH 还在开发者预览阶段（当前版本 0.1.0-rc.6），安装命令和插件接口都可能变化，遇到问题以官方文档为准，也可以回来翻《DSH 常见问题排查》。

来源：dsh CLI README、官方 Quickstart