前言¶
DeepSeek Harness（DSH）把能力拆成插件，按需加载。若你在项目里想用 BMAD-Method——一套「先想清楚再写代码」的多角色工作流——原版通常要自己跑 npx bmad-method install、选模块、维护散落文件。维护者 ph1996-cn 的 dsh-BMAD-Method 把 BMAD 整套装进 DSH：装完插件即可用，模块与 skill 在插件内统一管理。下面介绍它是什么、能做什么，以及安装与日常用法。
这是什么¶
dsh-BMAD-Method（npm 包名 dsh-bmad-method，仓库与界面显示为 dsh-BMAD-Method）是 BMAD-Method 的封装插件，分类为工作流。它解决的是：在 DSH 内列出、开关、更新 BMAD 模块，并把约 90 个 skill 随包提供，无需在工作区单独安装 BMAD。
BMAD 把工作拆给不同角色（分析师、产品经理、架构师、开发、测试等），产出从需求到实现的文档。插件侧的承诺包括：7 个模块全在插件包里；首次打开设置卡片时自动把运行时铺到 ~/.dsh/bmad-method（README 称约 46 毫秒，不跑安装器、不联网）；更新插件即更新 BMAD（当前依赖 bmad-method 6.12.4，插件版本 0.2.3）。
核心功能¶
模块与 skill¶
七个模块：bmm（21 个 skill，PRD、架构、故事、代码审查等）、gds（33，游戏开发）、cis（10，创意）、tea（10，测试架构）、core（8，公共能力，无开关）、bmb（5，造模块）、bmad-loop（3，无人值守开发循环）。skill 不落用户工作区目录；README 说明 ~/.dsh/skills 里不应出现 bmad/gds 类 skill 文件。
模块开关¶
开关只决定模块是否参与，不删文件。关掉某模块后，其 skill 从清单消失；重新打开即恢复。状态写在 profile 的 cordis.patch.yml（disabled: true），重启 DSH 后仍保留。停用模块后一般不用重启 DSH；改插件代码本身仍需重启。
插件设置¶
在 设置 → 插件 → dsh-BMAD-Method 可配置：
| 项 | 说明 |
|---|---|
| 用户名 | 写入 BMAD 的 user_name，对话时使用 |
| 语言 | 沟通与文档输出语言，默认简体中文 |
| 工作区输出目录 | 产出文件位置，默认 _bmad-output（相对工作区） |
模型可调工具¶
插件注册三个工具：bmad_modules_list（列模块与开关状态）、bmad_module_toggle（开关模块）、bmad_update（官方安装器更新或补装；日常多数情况用不上，运行时随插件走）。
安装与启用¶
CLI 安装（命令来自仓库 README）：
dsh plugin add github:ph1996-cn/dsh-BMAD-Method
桌面版：设置 → 插件 → 从 GitHub 安装，填 ph1996-cn/dsh-BMAD-Method，或在插件市场搜 BMAD。
装完重启一次 DSH 才会加载插件。若需钉住版本：
"dsh-bmad-method": "github:ph1996-cn/dsh-BMAD-Method#v0.2.0"
注意：dsh-BMAD-Method 与旧包名 dsh-bmad-method 在 DSH 眼里是两个插件；从 0.1.x 升级时应先卸旧包，避免重复加载。
更新已装插件不要用 dsh plugin add（会 already-installed），应使用：
dsh plugin --profile desktop update dsh-bmad-method
--profile 换成你实际使用的 profile。更新后重启 DSH。
典型用法¶
用自然语言描述任务，对得上即用对应 skill；也可输入 /bmad- 查看补全（README 称共 90 个）。
| 你说 | 对应能力 |
|---|---|
| 「帮我写个 PRD」 | bmad-prd，结构化需求文档 |
| 「让 Winston 看看这个架构」 | 架构师 bmad-agent-architect |
| 「跑一遍代码审查」 | bmad-code-review |
| 「把需求拆成故事」 | bmad-create-epics-and-stories |
| 「这功能怎么做测试」 | bmad-testarch-test-design |
| 「我有个想法，帮我掂量掂量」 | bmad-forge-idea |
BMAD 运行时装在 ~/.dsh/bmad-method（全局），不会在项目里建 _bmad/；项目侧主要是产出目录（默认 _bmad-output/）。
适用场景与注意¶
适合谁：已在用或想用 DSH 做需求、架构、审查、测试设计等结构化工作流，且希望免本地跑 BMAD 安装器的开发者。
环境要求（来自 package.json 的 engines）：
- dsh：
>=0.2.0-rc.1 <0.2.1 || >=0.2.1-rc.1 <0.3.0-0（整个 0.2.x，含预发布；README 实测含0.2.1-rc.3、0.2.1-rc.5） - Node：
^22.19.0 || >=24
权限与安全：插件以当前 DSH 进程权限运行；安装前建议在 GitHub 查看源码与 MIT 许可证。社区目录 SkillHub 插件页 为独立站点，与 DeepSeek / 幻方无官方从属关系。
卸载：插件页卸载会移除 npm 包与 profile 声明，但不会删除 ~/.dsh/bmad-method/（含 custom/ 定制，约 34 KB 配置相关数据）。需彻底清理时自行删除该目录；卸载前若要保留定制，先备份 _bmad/custom。
常见问题：插件页看不到设置卡片 → 确认插件启用并重启；模块显示未安装 → 刷新卡片或调用 bmad_modules_list；更新后仍是旧代码 → 用 update 而非再次 add。
结尾¶
dsh-BMAD-Method 把 BMAD-Method 的模块、skill 与运行时管理收进 DSH 插件一条链路：安装后重启、在设置里配用户名与输出目录、用模块开关裁剪 skill 面，即可用中文指令走 PRD、架构、审查等工作流。
- 目录页：https://www.skillhub.cn/plugins/ph1996-cn/dsh-BMAD-Method
- 源码与文档：https://github.com/ph1996-cn/dsh-BMAD-Method
