插件上架 DSH Plugin Hub 的提审清单：DeepSeek Harness 常见退回原因

上架 DeepSeek Harness 插件到 DSH Plugin Hub 的提审只检验一件事：用户从市场点安装时能不能真的装上。 所以退回集中在「包不可安装」与「条目信息不全」，上架前的自检清单比代码更决定成败。本文按必备项、三条分发路线、五条退回原因与提交后跟进组织。

上架 DeepSeek Harness 插件前必备的四项与三条分发路线

一句话结论：包可安装、信息完整、来源可查、许可明确——四项缺一项都可能被退回。

1. 可安装的包：插件包已发布到市场能访问到的源，包名与版本可解析（这是硬门槛）。
2. 条目信息完整：名称、一句话说明、分类、依赖说明、安装方式。依赖一定要写——用户装失败最常因依赖缺失。
3. 来源与归属可查：仓库地址、维护者信息可核验，便于用户判断是否长期依赖。
4. README 与许可证：README 说明用法与权限；许可证明确使用条件。

方案 A：以 npm 包为主（主推路线）

一句话结论：包发布到公共源、市场条目指向该包——这是用户安装路径最短、也最符合市场预期的做法。

1. 准备 package.json：名称、版本、入口、依赖、仓库与许可证字段齐备。

npm view <你的包名> version      # 预期：能查到已发布版本

2. 发布版本（首次与后续更新同理）：

npm publish --access public
# 预期：发布成功后，npm view 能查到新版本

3. 在干净环境验证可安装性（这一步能挡掉大部分退回）：

dsh plugin add <你的包名>@<版本>
dsh plugin        # 预期：清单中出现你的插件

4. 提交条目：按官方发布文档的约定填写条目信息，指向上面这个包。
5. 取舍：包公开意味着实现公开，含敏感逻辑的插件应走方案 B。

方案 B：私有源分发 + 条目提交（内部分发）

一句话结论：只想给团队用就不必上公开市场——发布到私有源、把源配置写进团队文档即可。

1. 发布到私有 registry，并在团队文档里写明源地址与安装方式。
2. 条目信息仍要写全（至少写下名称、作用、依赖与版本），即使不上公开市场——半年后你自己也需要它。
3. 是否提交公开条目：如果插件不含敏感逻辑，提交条目能让更多人受益；反之保持私有不提交。
4. 注意版本同步：私有源上的版本要与文档一致，否则同事按文档装会失败（这与 离线与内网里用 npx @deepseek-ai/dsh web 里的私有源要求一致）。

方案 C：先内部验证、成熟再上架

一句话结论：不急着提交——先让小范围使用者跑一段时间，再上架，能避免「上线即被退回或立刻又被反馈坏」的循环。

1. 内部试用一轮：让两三个同事按你写的安装说明装一次，记录所有卡点。
2. 按卡点修文档与依赖说明——多数「用户装不上」其实源于说明不清，而非包有问题。
3. 补齐兼容性与版本范围：写明适配的 DeepSeek Harness 版本区间。
4. 再提交条目：此时条目信息通常已接近完整。
5. 取舍：多花一轮时间，换来更少退回与更少支持成本。

DSH plugin 上架的五条常见退回原因与自检

一句话结论：退回几乎都能在提交前自查出来——逐条对照，比退回后重来省事得多。

1. 再补一条自检：在干净 profile / 干净机器上完整跑「安装 → 使用 → 卸载」，任一步卡住就先别提交。
2. 记录自检结果：写下在哪台机器、哪个版本上验证过，后续被质疑时有据可依。

DeepSeek Harness 插件提交后的跟进三步

一句话结论：提交不是终点——跟进条目展示、用户反馈与版本更新三条线。

1. 看条目展示是否如你所写：说明被截断、分类归错、依赖没显示，都属于需要修正的情况。
2. 盯用户反馈：安装失败与功能异常的反馈优先修文档与依赖说明，而不是先怀疑用户操作。
3. 发布更新时同步条目范围：新版本改变了依赖或适配区间，条目信息要一起更新，否则会出现「装上了但用不了」。

DSH plugin 排查注意事项

一句话结论：上架类问题的排查对象是「条目与包的对应关系」，不是插件代码本身。

1. 用户说装不上→ 先让对方给出包名与版本，自己 npm view 验一次。
2. 用户说用不了→ 先核对依赖是否满足、本体版本是否在适配区间。
3. 自己被退回→ 按五条表逐条自查，别急着改代码。
4. 版本更新后出问题→ 检查条目里写的依赖与兼容范围是否还成立。
5. 想让插件更容易被发现→ 先把条目说明写清（用户是按说明找插件的），比在别处推广有效。
6. 修复状态如实：本文清单基于官方发布文档与通用包发布实践归纳；DSH Plugin Hub 的具体提交字段、审核口径与展示规则由平台与官方文档定义，提交前请以 docs/user/develop/basic/publish.md 与市场提交页的当前要求为准。

自检「装得上」这一步，可以用 DSH Plugin Hub 的安装入口走一遍——用户最终就是这么装的，先自己走通再提交。

来源：docs/user/develop/basic/publish.md、DSH Plugin Hub 插件条目、npm Docs · package.json。