jxb01 / godot-tools-dsh-plugin

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-plugin

Or from a local checkout:

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

Then 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'   # optional

Toggle / 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 start dsh web with GODOT_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 按 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.