Godot 工具集 jxb01/godot-tools-dsh-plugin

godot-tools-dsh-plugin

DeepSeek Harness 的标准 bundle 包：原生智能体工具，直接驱动本地 Godot 4.x 可执行文件（headless CLI + 编辑器启动器）。不用 MCP 服务器，不联网，运行时也不装 npm 包。

旧的手动安装版（out-of-tree DIY 形态）在 jxb01/godot-tools-dsh。本仓库是标准 dsh.bundle 形态，可一键安装/卸载。

工具

| 工具 | 作用 |
| 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（分离进程） |
| godot_toggle | 会话内实时启用/停用 godot_* 工具，无需重启 |

安装（一条命令）

从 git 托管地址安装（不需要构建脚本——纯 JS，直接加载源码）：

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

或从本地 checkout 安装：

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

然后重启 dsh web。7 个工具会出现在智能体对话里。

⚠️ 如果你用的是源码 checkout，命令前缀为 pnpm dsh plugin ...。

配置

在配置档的 cordis.patch.yml 里覆盖（按 id 定位那一行）：

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

开关 / 停用

- 会话内：调用 godot_toggle(enabled: false | true)。重启后恢复为启用。
- 启动时：在配置档 patch 的那一行加上 disabled: !!js process.env.GODOT_TOOLS === '0'，然后用 GODOT_TOOLS=0 启动 dsh web。

卸载（一条命令）

dsh plugin --profile web remove godot-tools-dsh-plugin

中文说明

DeepSeek Harness 的标准 bundle 包：原生驱动本地 Godot 4.x 可执行文件的智能体工具（headless CLI + 编辑器启动）。无需 MCP、无网络依赖、运行时零 npm 安装。

工具

godot_check 无头校验 / godot_import 重导入 / godot_run_scene 跑场景 / godot_run_script 跑 GDScript / godot_list_assets 列资源 / godot_open_editor 打开编辑器 / godot_toggle 会话内开关。

一键安装

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

或本地目录 dsh plugin --profile web add /path/to/godot-tools-dsh-plugin，然后重启 dsh web 即可。

配置 / 开关 / 卸载

- 配置：在配置档的 cordis.patch.yml 按 id godot-tools 覆盖 config.godotExe
- 会话内开关：godot_toggle(enabled: bool)
- 卸载：dsh plugin --profile web remove godot-tools-dsh-plugin

License

MIT — see LICENSE.

第三方依赖许可证见 THIRD_PARTY_NOTICES.md。
Third-party license notices: THIRD_PARTY_NOTICES.md.