安装 DSH 插件前先确认什么
DeepSeek Harness 以 Profile 组织运行组合。Profile 决定某个界面或工作流启动时加载哪些 Bundle 和外部插件，因此安装前第一件事不是复制命令，而是确认插件应该进入哪个 Profile。
官方提供 Web 与 Headless Profile 模板，社区项目还可能面向 TUI 或其他自定义 Profile。应优先使用插件作者或 Registry 页面明确给出的 Profile。
- 确认目标 Profile：web、headless、TUI 或其他命名 Profile。
- 确认作者提供的是 npm Package、GitHub/Git 地址还是其他 pnpm 可识别目标。
- 安装第三方代码前查看版本、许可证、仓库活跃度、依赖和安全信号。
- DeepSeek Harness 目前仍处于 developer preview，版本升级可能带来兼容性变化。
使用 dsh plugin 安装插件
DSH CLI 提供专门的插件管理模式：先选择 Profile，再把后续包管理参数转发到这个 Profile 的目录中。最常见的操作就是 add 加 Package 或 Git spec。
如果系统里已经可以直接执行 dsh，使用短命令即可；如果平时通过 npm 启动 Harness，也可以直接通过 npx 执行同一套插件管理命令。
dsh plugin --profile web add <package-or-git-spec>npx -y @deepseek-ai/dsh plugin --profile web add <package-or-git-spec>Package 名和 GitHub 地址并不是可以随意互换的两种写法，应使用项目当前文档明确支持的安装目标。
npm Package 与 GitHub 安装地址怎么选
很多社区插件会发布 npm 版本，也有项目直接从 Git 仓库安装。由于 dsh plugin 最终把包管理交给 pnpm，因此当插件文档明确给出对应 spec 时，可以使用 pnpm 支持的包地址形式。
npm Package
适合有正式版本发布的插件，版本解析、升级和移除都更标准。
GitHub / Git spec
适合直接从源码安装或仓库中包含特定插件路径的项目，应严格复制作者给出的 spec。
安装后检查 Profile 实际会加载什么
Package 下载成功不等于插件已经正确进入最终 Plugin Tree。安装后应查看 Profile 的组合结果，确认 Bundle 与 Patch 合成后的配置里确实存在目标插件。
- 确认插件或它的 Bundle Patch 插入的配置行已经出现。
- 确认安装时使用的 Profile 和真正启动的 Profile 一致。
- 长时间运行的 Profile 在安装或卸载插件后应重启，除非作者明确支持热加载。
- 如果插件提供 doctor、health check 或验证命令，安装后直接执行。
dsh --profile web --dump-configdsh web卸载与排查 DSH Plugin
插件管理命令支持 pnpm 风格的操作，所以卸载和依赖诊断同样按 Profile 进行。排查时要把“包是否安装”和“插件是否进入组合树”分开判断：Package 存在并不代表 Bundle 或 Patch 一定成功加载。
- 找不到 Package：检查 npm/Git spec 与项目是否真的发布了这个目标。
- 已安装但配置树里没有：检查 package.json 的 dsh.bundle 与 Patch 文件。
- 插件加载但功能没出现：确认所选 Profile 是否提供它依赖的 UI 或运行时 Service。
- 升级 Harness 后出错：对照插件支持的 DSH 版本和当前 Peer Dependencies。
dsh plugin --profile web remove <package>dsh plugin --profile web why <package>DSH 插件安装检查清单
1. 选 Profile
插件装到哪个 Profile，就应该在对应的 Web、Headless、TUI 或自定义组合中验证。
2. 用作者给出的目标
复制当前仓库或 Registry 中确认的 npm Package / Git spec。
3. 查看 Plugin Tree
通过 --dump-config 确认目标配置行真正进入最终组合。
4. 看运行证据
执行插件自己的验证命令，并结合版本兼容性证据判断是否可用。
一手资料
本文以 DeepSeek AI 官方 Harness 仓库与当前开发文档为主要依据；由于 Harness 仍处于 Developer Preview，具体命令与契约以后续官方版本为准。