前言¶
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
