Skip to content

fix(client): 多开 Unity 时优先连接当前项目实例#45

Open
daixian wants to merge 1 commit into
Besty0728:betafrom
daixian:fix/current-project-auto-discovery
Open

fix(client): 多开 Unity 时优先连接当前项目实例#45
daixian wants to merge 1 commit into
Besty0728:betafrom
daixian:fix/current-project-auto-discovery

Conversation

@daixian

@daixian daixian commented Jul 13, 2026

Copy link
Copy Markdown
Contributor

背景

当同时运行多个 Unity Editor 实例时,Python 客户端原本仅根据注册表中的 last_active 心跳时间选择实例,优先连接最近更新心跳的 Unity。

但各个 Unity 实例会独立、周期性地更新心跳,因此“最新心跳”只取决于客户端发起连接时各实例的心跳更新时间,并不能代表当前命令所属的项目。随着不同实例交替更新心跳,同一工作目录下连续执行相同命令,也可能被自动路由到不同的 Unity 实例。

这会带来两个问题:

  • 客户端可能连接到其他 Unity 项目,导致命令作用于错误的场景或资源。
  • 自动发现结果不稳定,脚本和 AI Agent 的连续操作可能在多个 Unity 实例之间切换,难以复现和排查。

因此,自动发现应优先依据当前工作目录确定目标项目;只有找不到匹配项目时,才使用心跳时间选择其他可用实例。

修改内容

  • 对项目路径进行规范化,提升跨平台路径比较的可靠性。
  • 判断当前工作目录是否属于已注册的 Unity 项目。
  • 自动发现时优先连接当前目录对应的项目实例。
  • 支持从 Unity 项目的子目录中执行命令。
  • 存在嵌套项目路径时,优先选择匹配程度最高的项目。
  • 保留原有的心跳时间排序和 8090-8100 端口扫描兜底逻辑。

自动发现顺序

  1. 与当前工作目录匹配的有效注册实例。
  2. 其他有效注册实例,按最新心跳时间排序。
  3. 扫描 8090-8100 端口。

显式指定 urlporttargetversion 时的行为保持不变。

验证

  • Python AST 语法解析通过。
  • git diff --check 检查通过。
  • 已对照 RegistryService 确认注册表的数据结构。

@Besty0728

Copy link
Copy Markdown
Owner

This looks like a valid PR for Unity multi-instance scenarios. Please provide the actual test results following your changes; if the outcome meets expectations, I will merge the PR.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants