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 形態。