如何安装 DeepSeek Harness(DSH)插件:分步指南
安装DSH 插件(DeepSeek Harness 插件)是一行命令的事——前提是先装好 DeepSeek Harness 本身。本指南覆盖全部三种安装来源:GitHub、npm 和本地目录。
开始之前:安装 DeepSeek Harness
npm install -g @deepseek-ai/dsh
npx @deepseek-ai/dsh web
网页界面在 http://127.0.0.1:3080 打开。从这一步起,dsh 命令就在你的终端可用了。
方式一:从 GitHub 安装 DSH 插件(最常见)
社区插件托管在 GitHub,通过 dsh-plugin topic 被发现。本目录每个插件页面都显示了它确切的安装命令:
dsh plugin add github:owner/repo
例如,安装正则工具插件:
dsh plugin add github:omdsh-dev/dsh-tool-regex
CLI 会:
- 解析仓库,确认它声明为插件;
- 核验来源(谁拥有它、它会运行什么);
- 安装到当前配置。
如需可复现安装,请固定 commit 哈希:
dsh plugin add github:omdsh-dev/dsh-tool-regex#ec533420e133
方式二:从 npm 安装 DSH 插件
发布到 npm 仓库的插件可以按包名安装:
dsh plugin add @scope/package-name
npm 来源的插件与 GitHub 来源执行相同的来源核验。
方式三:安装本地 DSH 插件(开发)
如果你在构建自己的插件,直接从文件夹安装:
dsh plugin add ./path/to/your-plugin
本地安装跳过网络获取,非常适合开发迭代。完整教程见如何构建 DSH 插件。
验证安装
dsh plugins list
输出中应该能看到你的插件。部分插件需要重启 Harness 才能生效——如果界面里没立刻出现,重启一下网页界面。
常见问题排查
| 问题 | 解决方法 |
|---|---|
| “需要构建审批” | 检查插件将要运行的内容,然后批准。只安装你信任的插件。 |
| 找不到插件 | 确保仓库公开且带有 dsh-plugin topic。 |
| 命令无法识别 | 重装 CLI:npm install -g @deepseek-ai/dsh,然后开新终端。 |
| 想卸载 | dsh plugin remove <名称>,然后重启 Harness。 |
一句话总结
dsh plugin add github:owner/repo 可以安装任何社区 DSH 插件。浏览插件目录寻找带已验证安装命令的精选插件;安装未知来源的插件前,请先看安全指南。
DeepSeek Harness 插件常见问题
如何安装 DSH 插件?
在 DeepSeek Harness 终端运行 dsh plugin add github:owner/repo 即可。CLI 会从 GitHub 解析插件、核验来源,并安装到当前配置中。
DSH 插件从哪里来?
DSH 插件有三个来源:GitHub 仓库(最常见,通过 dsh-plugin topic 发现)、npm 仓库(已发布的包)、本地目录(开发时使用)。
为什么安装插件时需要构建审批?
来自 GitHub 的插件在安装时可能运行构建脚本。DeepSeek Harness 会先征求你的批准,让你在允许前检查插件将要运行的内容。
如何卸载 DSH 插件?
运行 dsh plugin remove <插件名>,或在网页界面的插件列表中移除,然后重启 Harness。