Smalldy/godot-bridge
61最近提交 2026年8月15日
godot-bridge DSH 插件
godot-bridge 是一个 DeepSeek Harness (DSH) 插件，用于启动 Godot 4.x 游戏进程，并通过 TCP 与游戏内的 McpInteractionServer 通信。它提供 16 个工具，涵盖项目管理、场景检查、无头操作等，无需 MCP 服务器或 Python。通过 DSH CLI 安装，无缝集成到 DSH 会话中。
如何安装 godot-bridge DSH 插件
dsh plugin --profile web add github:Smalldy/godot-bridge复制不会执行命令。安装 godot-bridge DSH 插件前请核对仓库和版本。
godot-bridge DSH 插件数据来源
godot-bridge DSH 插件快照日期：2026年8月16日
discovered
godot-bridge DSH 插件能做什么
- 以调试模式启动和停止 Godot 4.x 项目，并自动安装交互服务器自动加载脚本。
- 通过单个 godot_command 工具发送 130 多种交互服务器命令（如 get_scene_tree、eval、click、screenshot）。
- 执行无头操作（读取/修改场景、附加脚本、创建资源等），无需运行游戏。
- 管理项目设置、自动加载、输入映射、导出预设和 GDScript 模板。
- 使用 godot_screenshot 捕获视口截图并返回 base64 编码的 PNG。
- 加载时检查插件版本并提示更新。
- 通过设置持久化 Godot 引擎路径，支持热重载。
godot-bridge DSH 插件适合哪些场景
- 自动化游戏测试：运行项目，执行 UI 交互，并编程截图。
- AI 辅助游戏开发：让代理检查场景图、修改属性、验证脚本。
- 无头构建流水线：使用无头操作导出项目或管理导出预设。
- 调试和故障排除：获取调试输出、ping 游戏服务器、从错误中恢复。
- 将 Godot 项目管理集成到 DSH 工作流：创建项目、设置主场景、管理层。
godot-bridge DSH 插件适合谁
- 需要 AI 驱动自动化和测试的 Godot 4.x 游戏开发者。
- 需要在 DSH 会话中控制和检查 Godot 游戏的 DSH 用户。
- 使用 AI 代理与游戏 UI 交互的游戏测试人员和 QA 工程师。
godot-bridge DSH 插件的限制
- 需要 Godot 4.x 项目并带有 McpInteractionServer 自动加载（缺失时自动安装）。
- Godot 可执行文件路径必须是真实 exe，不能是版本管理器 shim，否则进程管理会出错。
- 插件必须通过 bundle 机制安装（不能手动复制文件），否则 Node 模块解析失败。
- eval 命令在调试模式下可能因编译错误导致游戏暂停，需停止并重启恢复。
- 更新检查需要启动时联网，在某些极简预设中可能被抑制。
godot-bridge DSH 插件的仓库 README 摘录
以下文字摘自 godot-bridge DSH 插件的上游仓库 Smalldy/godot-bridge 的 README，版权归原作者，仅作引用。
**English** | [中文](README.zh-CN.md) # godot-bridge [](https://awesome-dsh-plugin.com) Native **DeepSeek Harness (DSH)** plugin that launches and drives a running **Godot 4.x** game through its in-game TCP interaction server — replacing the [`godot-mcp`](https://github.com/tugcantopaloglu/godot-mcp) MCP server with first-class agent tools. No MCP protocol, no Python server, no editor addon. The game side is untouched: `McpInteractionServer` (the `mcp_interaction_server.gd` autoload) already listens on `127.0.0.1:9090` and speaks newline-delimited JSON — godot-bridge speaks the same protocol natively from inside the DSH host. ## Tools | Tool | Replaces (godot-mcp) | Purpose | | --- | --- | --- | | `godot_run_project` | `run_project` | Launch the project in debug mode (`godot -d --path …`), wait for port 9090 | | `godot_stop_project` | `stop_project` | Terminate the game process (tree-scoped kill) | | `godot_get_debug_output` | `get_debug_output` | Incremental stdout/stderr of the launched process | | `godot_command` | all `game_*` (~130) | Send any interaction-server command: `get_scene_tree`, `get_ui_elements`, `ev
阅读完整 README仓库许可: MIT
godot-bridge DSH 插件常见问题
如何安装 godot-bridge？
在终端中运行 `dsh plugin --profile web add github:Smalldy/godot-bridge`。此命令会将包安装到配置文件的 node_modules 中，并添加 bundle 层。重启 DSH 后，该配置文件上的所有会话都会出现 16 个 godot_* 工具。
使用 godot-bridge 需要哪些条件？
你需要一个带有宿主运行时的 DSH 会话、一个带有 McpInteractionServer 自动加载的 Godot 4.x 项目（godot-bridge 可以自动安装缺失的文件）、PATH 上有 Node.js 以及一个 Godot 可执行文件。如果 'godot' 在 PATH 上，可自动检测；否则，请在插件设置（Web 插件配置页面或 settings.yaml）中设置路径。
如何设置 Godot 可执行文件路径？
你可以通过每个工具的 `godot_path` 参数设置，也可以在插件设置中全局设置。前往 Web 插件配置页面的 'godot-bridge' 部分，或编辑 `settings.yaml` 中 `godot-bridge:` 下的键。请使用 Godot 可执行文件的真实完整路径，不要使用版本管理器 shim，以避免进程管理问题。
为什么 godot-bridge 每个命令都会生成一个子进程？
每个命令都会生成一个一次性 `node -e` 桥接器，连接到游戏服务器，发送一行数据，然后退出。游戏服务器是单连接、单命令的，因此短生命周期连接非常合适。这种设计避免了持久连接，简化了错误处理。
安装后如何更新 godot-bridge？
运行 `dsh plugin --profile web update godot-bridge`，然后重启 DSH。插件在加载时会通过获取仓库最新的 package.json 检查更新。如果发现新版本，它会添加一个系统提示部分，让模型通知你，直到你更新为止。