DeepSeek Harness 发布插件：npm 生态与发布流程

插件写好了（见 插件开发），怎么让别人装上？DSH 的插件分发走 npm 生态：发布到 npm，别人一条命令安装。这一篇讲从打包到被发现的完整路径。

DSH 插件分发的基本盘：npm

• 官方组织 @deepseek-ai/* 是内置包的命名空间
• 社区插件是普通 npm 包，没有特殊注册中心
• 用户安装走 profile 的插件管理命令（pnpm 转发）

所以发布 DSH 插件 ≈ 发布一个 npm 包，只是包内容遵循插件约定。

发布前清单

检查项	说明
导出正确	包的入口要导出插件的 name/inject/apply（见 插件开发）
依赖声明完整	inject 里的服务，其提供方要作为依赖声明进 package.json
版本语义	从 0.x 起步，遵循语义化版本
许可证	选一个明确的开源协议（MIT/Apache-2.0 常见）

发布流程

1. 准备 npm 账户，登录：

npm login

2. 发布：

npm publish

3. 验证：在某个 profile 里安装，确认能挂载：

dsh plugin --profile <name> add your-plugin

（dsh plugin 是转发给 pnpm 的插件管理命令，具体子命令以 pnpm 语法为准。）

让别人发现你的插件：dsh-plugin 话题

官方指定的发现渠道：给插件仓库加 GitHub 话题 dsh-plugin。这是官方 README 里明确的约定——加上话题的仓库会被聚合，方便生态检索。

其他发现渠道：

• GitHub Discussions 的社区板块
• 第三方聚合清单（如 awesome-deepseek-harness 类仓库）

发布之后的三件正事

1. 写清楚 README：插件做什么、依赖什么服务、如何安装三件套
2. 维护变更记录：DSH 处于开发者预览期（见 什么是 DSH），上游可能有破坏性变更——插件要及时跟进，README 里写明兼容的 DSH 版本范围
3. 响应用户反馈：GitHub Issues 保持开放

常见问题

问题	解答
必须发到 npm 吗？	目前生态以 npm 为主流分发方式
包名有要求吗？	无强制前缀，社区常用 dsh- 前缀便于识别
能发私有包吗？	可以走 npm 私有源，团队内部分发
插件坏了谁负责？	社区插件由作者维护，官方只维护 @deepseek-ai/* 命名空间

接下来读什么

• 插件开发回顾 → 插件开发：从零编写第一个插件
• 生态入口总览 → 资源与社区入口
• 官方文档查证 → 官方文档地图

---

← 上一篇：5.4 创建 Agent Preset：自定义预设教程 | 下一篇：6.1 CLI 命令参考 →

↑ 返回 教程总目录