Godot AI多编辑器并行开发：会话路由与session_id定向控制完全教程

Godot AI多编辑器并行开发会话路由与session_id定向控制完全教程【免费下载链接】godot-aiProduction-grade MCP server and AI tools for the Godot engine. A Snap to install. Totally free and fun.项目地址: https://gitcode.com/gh_mirrors/go/godot-aiGodot AI是一款面向 Godot 引擎的生产级MCP 服务器与 AI 工具集能让 Claude Code、Cursor、VS Code 等 AI 客户端直接操控正在运行的 Godot 编辑器建场景、改节点、写脚本、连信号全部由 AI 完成。当你同时开着多个 Godot 编辑器多个项目、多个 worktree时如何用会话路由和session_id让 AI 的命令精准落到目标编辑器就是本篇要讲的核心——多编辑器并行开发的完全教程。一、为什么需要多编辑器并行开发日常开发中你经常会同时打开多个 Godot 编辑器窗口一个开主项目一个开演示项目用 git worktree 做并行插件开发每个工作树一个编辑器或者单纯想让 AI 同时盯着两个项目做A/B 对比。好消息是Godot AI 的架构天然支持这一点。所有编辑器插件都连接到同一个 MCP 服务器本地 8000 端口服务器内部维护一张会话表每个编辑器各占一行、互不干扰。也就是说一个 MCP 服务器N 个 Godot 编辑器无需为每个编辑器单独起一套服务。二、会话路由是如何工作的一张表 一个活动指针理解了实现原理用起来就不慌。核心逻辑在 src/godot_ai/sessions/registry.py每个编辑器 一个会话Session。编辑器插件通过 WebSocket 连上服务器后会注册一个唯一session_id格式为项目名16位十六进制例如my_game7f9c3a10d8e426b1。每个会话带完整快照Godot 版本、项目路径、当前场景、播放状态、就绪状态readiness、连接时间等见 Session 数据类。服务器同时维护一个活动会话指针。没有指定目标时所有命令默认发给这个活动会话。两个自动行为值得记住先连上的编辑器自动成为活动会话无需手动设置活动会话断开时自动补位如果只剩一个编辑器还连着服务器会自动把它提升为活动会话见 自动提升逻辑你甚至不会察觉。 简单说只有一个编辑器时你什么都不用做一旦开第二个就需要用下面的方法点名了。三、session_id定向控制三步上手1️⃣ 先列出所有会话看看谁连着调用session_manage(oplist)或读取godot://sessions资源详见 docs/TOOLS.md返回每个编辑器的session_id、短名称项目文件夹名、project_path、当前场景、is_active标记等。这是所有路由操作的起点——先知道桌上有几副牌。2️⃣ 一键锁定session_activate 定向切换session_activate是核心工具作用是把后续所有调用固定到指定编辑器。它接受的session_id参数有两种写法实现在 src/godot_ai/handlers/session.py写法示例特点精确 IDmy_game7f9c3a10d8e426b1永远优先命中最稳妥子串提示my_game匹配短名称、项目路径或 ID必须唯一命中命中多个会返回错误并列出所有候选让你补充更精确的子串所以日常用起来非常简单对 AI 说一句激活 test_project 那个编辑器AI 就会调用session_activate(session_idtest_project)完成切换之后的建场景、改脚本等操作全部落在该项目上。3️⃣ 单次点名逐调用的 session_id 免切换如果你只是偶尔要在另一台编辑器上执行一条命令不想动活动会话可以用逐调用路由所有domain_manage聚合工具都接受一个顶层session_id参数与op、params平级不要嵌进params里例如project_manage(opstop, session_iddemo_game7f9c3a10…)→ 只停掉那一个编辑器的游戏editor_manage(opstate, session_idmain…)→ 只查那一个编辑器的状态这条规则在 docs/TOOLS.md 中有明确约定。逐调用session_id适合巡检式操作而session_activate适合整段工作在哪个编辑器上做的长流程。四、实战场景两个最常见用法场景 Aworktree 并行开发官方推荐姿势Godot AI 官方文档 docs/worktrees.md 明确支持这种玩法多个 Godot 编辑器每个 worktree 一个全部连到同一个 8000 端口的 MCP 服务器然后用session_activate或逐调用session_id路由命令。相比杀掉另一个编辑器的进程或把代码 rsync 过去多开编辑器 会话路由是官方文档里推荐的做法——互不干扰随时切换。场景 BAI 双开巡检让 AI依次检查两个项目的编辑器状态对每个会话各发一次带session_id的editor_manage(opstate)再汇总readiness、play_state、新增错误计数。因为快照按会话独立维护错误水印、场景变更都是 per-session 的见 record_readiness两个项目的日志和错误绝不会串台。五、常见问题与排查FAQ❓ 提示词匹配到多个会话怎么办session_activate会返回status: error并附上全部候选session_idnameproject_path。把子串写得更具体比如带上一级目录名或直接粘贴完整 ID。❓ 某台编辑器关掉后命令会报错吗不会乱发。活动会话断开时会自动补位到唯一幸存者若中途断开的正是目标会话正在飞行的请求会收到明确的EDITOR_DISCONNECTED错误断开即失败所有在途请求而不是静默落到别的编辑器上——这是防止命令串台的关键设计。❓ 两个编辑器同名项目子串会冲突吗会。此时必须用完整session_id后面的十六进制部分保证了唯一性。❓ 命令默认发给谁发给活动会话。记住这条默认规则就不会奇怪为什么 AI 改到了另一个项目——那是它正钉在另一个会话上session_activate一下即可。六、延伸阅读与源码导航想了解去哪看全部 46 个工具与session_id约定docs/TOOLS.md多编辑器 / worktree 并行开发规范docs/worktrees.md会话表实现注册、路由、自动补位src/godot_ai/sessions/registry.py激活逻辑精确 ID 优先 子串唯一命中src/godot_ai/handlers/session.pyMCP 工具注册session_activate / session_managesrc/godot_ai/tools/session.py运行时会话绑定防止并发期间指针漂移src/godot_ai/runtime/direct.py掌握先 list、再 activate、必要时逐调用点名这套组合拳你就能在同一台机器上放心地多开 Godot 编辑器让 AI 在同一座 MCP 服务器里游刃有余地穿梭——多编辑器并行开发从此不串台。【免费下载链接】godot-aiProduction-grade MCP server and AI tools for the Godot engine. A Snap to install. Totally free and fun.项目地址: https://gitcode.com/gh_mirrors/go/godot-ai创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考