Godot Tools DSH 插件：驱动本地 Godot 4.x

在智能体开发中，直接控制本地 Godot 4.x 项目（如校验资源、运行脚本）是常见需求。传统方式往往需要手动维护进程或编写复杂脚本。DeepSeek Harness (DSH) 的这套插件提供了标准 bundle 包，让智能体可以通过原生工具调用本地 Godot 可执行文件，支持无头 CLI 模式和编辑器启动。

插件定位¶

这是一个 DSH bundle 插件，由用户 jxb01 维护。它不依赖 MCP 服务器，不进行网络通信，也不需要在运行时安装 npm 包。

核心功能¶

插件提供了以下工具，用于与本地 Godot 4.x 环境交互：

godot_check：在无头模式下校验 Godot 项目（执行导入和第一帧渲染）。
godot_import：在无头模式下重新导入所有资源。
godot_run_scene：在无头模式下运行指定场景 N 帧。
godot_run_script：在无头模式下运行 GDScript（基于 SceneTree/MainLoop），可捕获 print() 输出和退出码。
godot_list_assets：递归列出项目中的 .tscn、.gd 和 .tres 文件。
godot_open_editor：启动 Godot 编辑器 GUI（detached 模式）。
godot_toggle：在会话内实时启用或禁用 godot_* 工具，无需重启。

安装与启用¶

从 Git 仓库安装（无需构建脚本，纯 JS 源码）：

dsh plugin --profile web add github:jxb01/godot-tools-dsh-plugin

或从本地目录安装：

dsh plugin --profile web add /path/to/godot-tools-dsh-plugin

安装完成后，重启 dsh web，这 7 个工具将出现在 Agent 的可用工具列表中。

配置与使用¶

指定 Godot 可执行文件¶

默认情况下，插件会使用系统环境变量或 DSH 上下文中的 Godot 路径。若需覆盖，需编辑用户 Profile 中的 cordis.patch.yml 文件，按 id godot-tools 定位并配置：

- id: godot-tools
  config:
    godotExe: 'D:/path/to/Godot_v4.7.1-stable_win64_console.exe'

会话内开关¶

在对话会话中，可以直接调用 godot_toggle 函数来控制工具的启用状态：

godot_toggle(enabled: false | true)

若要在启动时默认禁用，可在 Profile 的 patch 文件中添加：

- id: godot-tools
  disabled: !!js process.env.GODOT_TOOLS === '0'

注意事项¶

权限与运行环境：插件以当前 DSH 进程的权限运行，安装前应检查源码与许可证。
第三方依赖：MIT 许可证。第三方依赖许可证详见 THIRD_PARTY_NOTICES.md。
旧版说明：旧的手动安装版（out-of-tree DIY 形态）在 jxb01/godot-tools-dsh 仓库。本仓库为标准 dsh.bundle 形态。