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

dsh-plugin-forge · dsh 插件锻造工坊

License: GPL-3.0
Version
dsh

一句话：装上它，你的 dsh（DeepSeek Harness）里就住进一支插件锻造专家团队——你出需求，它们从零把一个 dsh 插件做到可发布的 1.0.0。

不是模板，不是脚手架，是一支会分工、会互查、会打回、会发版的 Agent 团队：写手实现 → 测试独立试用 → 复核角色攻击报告 → 发布角色打包双形态验证 → 定版挂 GitHub Release。
全程四值判定口径（通过/条件通过/不通过/未验证），不把没跑过的东西说成通过。

安装

方式一：直接装 GitHub 仓（推荐）
dsh plugin --profile add github:MYCF711/dsh-plugin-forge

方式二：从 Release 下载 tgz 后本地安装
dsh plugin --profile add

依赖 @nanmicoder/dsh-agent-teams（多 Agent 团队协作）。
若实例里没有，插件会给出安装指引；装完进程级重启一次即可。

快速开始

安装后，在 dsh 里选 「锻造队长」（forge-captain）agent，直接说需求：

帮我做一个 dsh 插件：把当前仓库生成 token 级代码地图，控制 token 预算。

队长会：复述目标为可验收的交付定义 → 经你确认计划后拉起团队 → 拆任务图分派 → 收证据、组织修复循环 → 汇总交付检阅。你只需要在两个点出现：确认计划、验收成果。

💡 这支团队经受过真实考验：它的第一件作品 dsh-repo-map（仓库代码地图工具）已由团队自己从 0.1.0 锻造到 1.0.0 定版——期间 tester 抓出 2 个缓存正确性缺陷、reviewer 打回 11 条、 releaser 发现 1 个制品级缺陷，全部走修复循环闭环。

团队阵容（6 个 Agent 预设）

| 预设 | 显示名 | 职责 | 铁律 |
| forge-captain | 锻造队长 | 唯一总控：拆任务图、派发、整合、交付 | 上下文能闭环就不派发；成员自报≠证据；验证按证据版本去重 |
| forge-writer | 锻造写手 | 按手册实现插件 + README 能力清单 | DoD 逐项自证后才许交付 |
| forge-tester | 锻造测试 | 四动作独立试用，只出证据 | 只判不改；原始命令+输出落盘 |
| forge-reviewer | 锻造复核 | 只读证据包，独立攻击报告 | 不重跑全量、不修复；增量复审 |
| forge-releaser | 锻造发布 | 版本判定、打包、双形态复验、发版 | 无敏感扫描不打包；无授权不触远端 |
| forge-ui | 锻造界面 | 在定稿合同内实装 UI slot / client bundle | 定稿后不改设计；逐项对照定稿预览 |

每个 preset 的 persona 都绑定一份角色合同（权责边界、输入输出义务、禁止事项），队长的 persona 内置调度铁律与 UI 四阶段流程（样例先行 → 预览迭代 → 定稿 → 后端连接）。

随包技能（6 册）

| 技能 | 内容 |
| forge-writing | 插件写作工艺：seam/bundle/Config/解析链/工具注册/DoD/崩法速查 |
| forge-testing | 测试方法论：四动作、能力清单、判定口径、归因表、报告模板 |
| forge-releasing | 定版与发布：版本判定表、打包清单、制品六验、GitHub 发版 |
| forge-teamwork | 团队协作：任务拆解、交接契约、独立复核、免费档模型风险 |
| forge-ui | UI/client 插件：主题 token 三类色、对比度、布局健壮性、预览定稿制 |
| forge-roles | 六份角色合同 + 调度铁律 + 跨轮任务账本（改编自 odai，MIT） |

设计纪律（为什么值得信）

- 四值判定：通过 / 条件通过 / 不通过 / 未验证——"没跑过"永远不许写成"通过"
- 独立复核：写作者与测试者永不同一人；复核角色只读不可变证据包
- 零删除：测试产物、日志、备份一律保留，全程可追溯
- 你日常的 dsh 实例只读：所有试错在隔离实例（独立 DSH_HOME）进行
- 方法学全部开源：docs/ 八篇手册（机制/开发/测试/装配/发布）每条结论标注"实测/推断"

文档

| 篇 | 内容 |
| docs/01 机制篇 | dsh 六层机制：seam/bundle/preset/agent/skill/AGENTS.md |
| docs/02 开发篇 | 从零写插件的完整工艺 |
| docs/03 测试篇 | 四动作测试法与独立复核 |
| docs/04 发布篇 | 定版判定与 GitHub 发布（含网络封锁应对实测） |
| docs/05 坑表 | 本机踩坑实录（杀软回滚 hosts、代理拦截、adb 通道…） |
| docs/06 装配篇 | preset/技能/团队模板的组装与验证 |

License

GPL-3.0 —— 衍生作品须同样开源。