dsh-plugin-forge
dsh 插件锻造工坊:一支专家 Agent 团队(队长/写手/测试/复核/发布/界面),从零把 dsh 插件锻造到可发布版本。An expert agent team that forges DeepSeek Harness (dsh) plugins from zero to release. 适合想要通过自然语言需求从零开发并发布DSH插件的开发者。
같은 패키지 이름의 다른 저장소
설치
검증된 bundle이 없거나 호환성 검사에 실패했습니다. 먼저 저장소 설명을 읽어 주세요. 전체 README 읽기 ↗
dsh-plugin-forge · 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 —— 衍生作品须同样开源。