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