dsh-godot-ai：DeepSeek Harness 的 Godot 游戏开发模式

前言¶

DeepSeek Harness (DSH) 是一个插件化架构。dsh-godot-ai 插件为 DSH 增加了一个专门针对 Godot 游戏开发的 Godot Creator 模式。它通过原版 Godot AI 操作编辑器，实现从场景搭建、脚本编写、UI 制作到运行验证的全流程自动化。

插件介绍¶

该插件由 gosomea 维护，旨在解决 Godot 开发中频繁切换工具、手动编辑场景与脚本效率低的问题。它不替代游戏引擎，而是作为一个模式层，集中管理 Godot 专属规则、技能和工作流。

核心功能¶

插件具备以下能力：

工程操作：创建和修改场景、节点、GDScript/C# 脚本、资源、信号及输入设置。
资源制作：制作 UI、动画、材质、Shader、粒子、音频、相机和环境。
运行与验证：运行游戏，检查场景树、运行状态、报错、警告、日志和画面；在工具支持范围内模拟输入。
工作流：遵循“读取 → 小批次修改 → 回读 → 运行 → 验证”的循环，失败时可从已验证阶段恢复。
创作台与市场：在创作台查看项目、Addon、后端和版本状态；在 Skill 市场审阅、安装、更新及回滚第三方知识。

安装与启用¶

1. 环境准备¶

需要满足以下环境要求：
* DSH 版本：0.2.0-rc.2 Web
* Node.js：22.19+ 的 22.x 或 24+（不使用 Node 23）
* 工具：uvx
* Godot：最低 4.5，推荐 4.7+

首先检查 uvx 版本：

uvx --version

2. 安装插件¶

使用与你的 Web 实例相同的 profile 进行安装。例如本地 web-rc2：

dsh plugin --profile web-rc2 add dsh-godot-ai@0.7.0

安装完成后，在当前任务结束时重启原来的 Web 命令。Godot Creator 会自动出现在 Agent 预设列表中，无需额外点击“安装游戏创造模式”。

3. 在 Godot 项目中启用 Addon¶

插件依赖原版 Godot AI，需手动安装：

用 Godot 打开目标项目。
在 AssetLib 搜索 Godot AI，安装与后端兼容的 3.1.5 版本。
打开 Project → Project Settings → Plugins，启用 Godot AI。
保持项目在编辑器中打开。

典型用法¶

在 DSH 中新建会话并选择 Godot Creator。打开顶部的游戏创作台，确认连接状态和目标项目，然后输入需求。

例如，创建一个 480×720 的 2D 躲避游戏：

创建一个 480×720 的 2D 躲避游戏。
玩家可以左右移动和跳跃，碰到障碍后重生，走到终点显示胜利，
并提供重新开始按钮。完成后运行游戏，检查日志和画面。

适用场景与注意¶

适用场景：需要通过 AI 协助搭建 Godot 场景、编写 GDScript/C# 脚本、调试运行状态的开发者。
注意：
- Godot AI 后端固定在已验证的 3.1.5 版本，不自动更换。
- 所有能力集中在一个 godot-creator preset，不再提供 Adaptive 模式。
- 第三方 Skill 不运行脚本或安装器，critical 风险硬阻断；市场数据保存在 $DSH_HOME/dsh-godot-ai/skill-market/v1。
- 旧 godot-creator-adaptive 会话不做无损恢复承诺。

结尾¶

该插件采用 MIT 许可证，所有能力集成在 godot-creator 预设中。如需更多信息，可访问插件目录或 GitHub 仓库。