DeepSeek Harness Game Studio 插件

前言¶

DeepSeek Harness (DSH) 的核心理念是「一切皆插件」。對於遊戲開發場景，開發者通常需要處理引擎交互、狀態管理、代碼審查和持續集成。dsh-game-studio 插件旨在將 DSH 轉化爲一個 AI-native Game Development Runtime，補齊 Runtime、Routing、State、Engine Tooling 和 Verification 等能力。

插件介紹¶

dsh-game-studio 是一個面向遊戲項目的 DSH 社區插件。它由 T-Markus-Liang 維護，基於 MIT 許可證發佈。該插件爲遊戲開發流程提供了一套標準化的工作流，包括項目初始化、Bug 修復、功能構建、測試執行和代碼審查。

核心價值在於它將 DeepSeek Harness 變成了一個可安裝、可卸載、可升級的遊戲開發工作室。它通過動態 Agent Pool 和引擎適配器，連接了 49 個角色元數據與實際的構建系統。

核心功能¶

1. `/game` 子命令體系¶

插件提供了一個統一的命令入口 /game，包含以下子命令：

工作流命令：start（初始化/接管項目）、build（功能開發）、debug（Bug 修復）、test（運行引擎測試）、review（綜合 Review）。
狀態與管理：status（查看當前項目/任務/門禁狀態）、mode（切換 Review Mode，如 solo/lean/studio）。
輔助與調試：agents / skills（列出註冊表）、help（用法幫助）。
未來計劃：design、prototype、perf、ship（設計/原型/性能/發佈 workflow）。

2. 模型工具與機制¶

6 個模型工具：
- game_studio_status：返回項目/引擎/任務/門禁狀態 JSON。
- game_studio_route：意圖分類，返回選配的 plan（agents/skills/gates）。
- game_studio_dispatch：派發 subagent，組裝 persona + skill + contract。
- game_studio_engine：引擎適配器統一入口（detect/build/test/run/logs）。
- game_studio_gate：跑確定性質量門禁 + 可選 Verifier 裁決。
- game_studio_state：狀態讀寫（白名單操作）。
動態 Agent Pool：索引 49 個角色元數據，每次任務按需選配 ≤6 個併發（1 Orchestrator + 1 Lead + 1..3 Specialist + 1 Verifier）。
三檔 Review Mode：
- solo：Coder → Test。
- lean（默認）：+ Verifier。
- studio：Lead → Specialist → Test → Verifier → Director Gate。
確定性質量門 + Verifier：build-pass/tests-pass/scope-clean 由代碼判定；Verifier 是獨立 persona subagent，默認最多 2 輪修復迴路。

3. 引擎適配器¶

支持 Godot 4.x（完整實現 detect/build/test）。
支持 Unity / UE5（提供 detect + 適配器模板）。

安裝與啓用¶

在 DSH 的 web profile 中安裝：

pnpm dsh plugin --profile web add "github:T-Markus-Liang/dsh-game-studio"

注意：本插件已針對 DSH 0.1.1-rc.2 覈對兼容性。安裝時請確保不要同時將插件加入 dsh.profile.bundles 和手動 cordis.patch.yml insert，這會導致雙加載風險。

典型用法¶

在遊戲項目根目錄打開的 DSH 會話中，可以使用以下命令：

初始化/接管項目：

    /game start

插件會檢測引擎（如 godot 4.x）、創建狀態目錄 `.dsh/game-studio/` 並給出引導語。

Bug 修復 workflow：

    /game debug 玩家偶發雙跳

命令 handler 會生成 Focus Contract 骨架，模型通過 `game_studio_route` 分類意圖，派發 specialist 修代碼，通過 `game_studio_engine` 執行構建測試，最終由 `game_studio_gate` 判定結果。

查看狀態：

    /game status

適用場景與注意¶

適用場景：需要將 AI 集成到遊戲開發工作流中，希望利用 AI 進行代碼審查、Bug 修復、構建測試和項目狀態管理的開發者。
注意：
- 插件以當前 DSH 進程權限運行，安裝前應檢查源碼與許可證。
- 狀態目錄 .dsh/game-studio/ 會持久化任務狀態，包含 decisions.jsonl 和 issues.jsonl。
- 引擎日誌建議加入 .gitignore。

結語¶

dsh-game-studio 提供了一套從設計到交付的閉環工作流。更多技術細節、兼容性記錄及設計文檔可參考項目倉庫。

GitHub: https://github.com/T-Markus-Liang/dsh-game-studio
社區目錄: https://www.skillhub.cn/plugins/T-Markus-Liang/dsh-game-studio