插件锻造工坊 huashenglian/dsh-plugin-forge

dsh-plugin-forge

把 DeepSeek Harness（DSH）插件从零做到发布 —— 包括两类最耗时间的故障：插件装得干干净净却从不出现，以及插件出现了、却只在运行时出问题。

安装

git clone https://github.com/huashenglian/dsh-plugin-forge.git ~/.agents/skills/dsh-plugin-forge

也可以下载后解压到智能体的技能目录，目录名保持不变。你在做 DSH 插件相关工作时，技能会自动触发 —— 声明 manifest、挂载工具行、调试已安装的插件，或者打包发布。

[!IMPORTANT]
Manifest、plugin_manager action 和工具面的事实，读自一份固定在 0.2.1-alpha.2 的 DSH 检出。这些内容会随版本变化。依赖它们之前，先从你的目标版本重新推导一遍。

为什么需要这个技能

DSH 插件的大多数故障都是静默的。没有报错，没有日志，也没有构建失败：

- 通过 bundle 补丁注册的工具行会落进全局工具层，于是每个预设里的每个智能体都能拿到它，哪怕这些预设从没挂载过它 —— 而且没有任何警告。
- 客户端 bundle 里只要有一处裸 ESM import，就会一次性搞坏所有插件，而浏览器会把第一个无辜的入口点指认为元凶。
- 没有 dsh.bundle 的插件永远无法列进 awesome-dsh-plugin 市场。这是结构性问题，不是提交失误。

这个技能里的每条规则都点明它防的是哪种故障，验证步骤的写法也保证静默故障无法蒙混过关。

工作流

SKILL.md 是入口：九个步骤，每一步都可能让下一步失效。

1. 确定平面 —— 这个包到底能不能声明 dsh.bundle。
2. 选择仓库模式 —— 外部包还是官方 monorepo。
3. 判定插件形态 —— 你注册在哪个扩展点上。
4. 声明 manifest —— dsh 块和包字段。
5. 打包 —— 复制匹配的模板，然后改。
6. 遵守编写规则 —— 注册、副作用、配置、入口形态。
7. 安装并验证 —— 类型检查通过不等于插件加载成功。
8. 发布 —— tarball、npm 和市场是三道独立的关卡。
9. 校验 —— 宣布做完之前，先跑一遍机械关卡。

里面有什么

| 路径 | 内容 |
| SKILL.md | 九步工作流，以及绝不能破的规则。刻意控制在 500 行以内。 |
| references/ | 27 份 Markdown 参考 + 2 份 JSON 策略文件，按需加载。references/README.md 是索引 —— 它告诉你哪项任务该读哪个文件，以及每份文件来自哪个上游。 |
| templates/ | tool-plugin（模型平面，不声明 dsh 块）、decoration（带 dsh.client 半边的 Web UI bundle）、mcp（纯配置 bundle）。 |
| scripts/ | 8 个工具，彼此没有依赖，每个都配一个 .check.mjs 自测。 |
| ATTRIBUTION.md | 每个上游来源的出处，附各自的许可条款。 |
| LICENSE | MIT。 |

先读 references/README.md —— 它是通往其他所有内容的地图。参考资料按任务分组：确定安装平面、命名与注册、插件形态、验证、发布，以及跨领域关注点。

脚本

| 脚本 | 用途 |
| validate-names.mjs | 离线命名校验，对照 dsh-plugin.naming.json。 |
| query-registry.mjs | 只读查询中央注册表。失败即关闭；报告 unknown，而不是 no match。 |
| check-pack-files.mjs | 发布前关卡：每个相对导入都必须在磁盘上存在，并且被 files 覆盖。专门抓那种只有用户才会遇到的 tarball 缺文件 bug。 |
| audit-published-secrets.mjs | 遍历 git 树，在发布前报告形似凭据的字符串。 |
| verify-release.mjs | 离线检查发布语义：tag 与 version 是否匹配、预发布状态、dist-tag 路由，并拒绝把 latest 往回移。绝不发布，也不碰网络。 |
| docker-release-smoke.mjs | 净室检查：把真正打包出来的产物装进全新容器并启动。需要支持 Linux 容器的 Docker。 |
| check-skill.mjs | 校验这个技能自身：frontmatter、名称与目录是否一致、每个被引用的路径是否都能解析。 |

自验证

这个技能自带关卡。在本文件夹下执行：

node scripts/check-skill.mjs # frontmatter + every referenced path resolves
node scripts/validate-names.check.mjs
node scripts/check-pack-files.check.mjs
node scripts/audit-published-secrets.check.mjs
node scripts/query-registry.check.mjs

[!NOTE]
container-runner.test.mjs 在 Windows 上会跳过自己的测试 —— 它的 fixture 是 POSIX 信号。docker-release-smoke.test.mjs 需要 Docker。

出处

这个技能是衍生作品，合并了多个 MIT 许可的上游，并加入大量新内容，自身也是 MIT。逐文件出处见 references/README.md；完整署名见 ATTRIBUTION.md。

这个技能是自包含的：每个上游都贡献了文本，但读它、装它、跑它都不需要任何一个上游。