godot-tools-dsh-plugin
Standard bundle package for DeepSeek Harness: native agent tools that drive a local Godot 4.x executable (headless CLI + editor launcher). No MCP server, no network, no runtime npm installs.
> 旧的手动安装版（out-of-tree DIY 形态）在 jxb01/godot-tools-dsh。本仓库是标准 dsh.bundle 形态，可一键安装/卸载。
Tools
| Tool | What it does |
|---|---|
godot_check | Validate a Godot project headless (import + first frame) |
godot_import | Re-import all assets headless |
godot_run_scene | Run a scene headless for N frames |
godot_run_script | Run a GDScript headless (SceneTree/MainLoop); captures print() and exit code |
godot_list_assets | Recursively list .tscn / .gd / .tres |
godot_open_editor | Launch the Godot editor GUI (detached) |
godot_toggle | Live enable/disable of the godot_* tools in-session, no restart |
Install (one command)
From a git host (no build script needed — pure JS, ships sources that load directly):
dsh plugin --profile web add github:jxb01/godot-tools-dsh-pluginOr from a local checkout:
dsh plugin --profile web add /path/to/godot-tools-dsh-pluginThen restart dsh web. The 7 tools appear in the agent chat.
> ⚠️ 如果你用的是源码 checkout，命令前缀为 pnpm dsh plugin ...。
Configure
Override in your profile's cordis.patch.yml (target the row by id):
- id: godot-tools
config:
godotExe: 'D:/path/to/Godot_v4.7.1-stable_win64_console.exe' # optionalToggle / disable
- In-session: call
godot_toggle(enabled: false | true). Resets to enabled on restart. - At boot: add
disabled: !!js process.env.GODOT_TOOLS === '0'to the row in your profile's patch, then startdsh webwithGODOT_TOOLS=0.
Uninstall (one command)
dsh plugin --profile web remove godot-tools-dsh-plugin---
中文说明
DeepSeek Harness 的标准 bundle 包：原生驱动本地 Godot 4.x 可执行文件的 Agent 工具（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 即可。
配置 / 开关 / 卸载
- 配置：在 profile 的
cordis.patch.yml按 idgodot-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_NOTICES.md)。 Third-party license notices: [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md).