跳转到主要内容
Locus 通过 Unity 插件与编辑器通信,实现状态检测、C# 代码执行、资产定位等能力。插件装好后,Locus 会自动发现并连接当前项目对应的 Unity 编辑器进程。

插件安装与更新

img 插件默认安装路径为 Packages/com.farlocus.locus。检测到旧版 Assets/Locus 安装时,点击更新会自动迁移到新的包路径。首次使用在引导流程中安装,之后也可以在会话页面随时安装。 Locus 升级后,若项目中的插件版本落后,Unity 状态指示会显示插件需更新,点击即可更新(未安装时显示插件未安装点击安装)。更新需要替换 Unity 已加载的 DLL 时,Locus 会弹出关闭 Unity 后更新插件确认:先关闭当前 Unity 项目,更新完成后自动重新打开。

连接状态

会话输入框上方的 Unity 状态指示显示当前连接情况:
  • Unity编辑器未连接:未检测到运行中的编辑器。此时文件级操作(读写代码、资产分析)不受影响,但无法执行编辑器内的操作。
  • Unity编辑器已打开,等待连接:编辑器进程在运行,插件握手尚未完成;刚装完插件时 Unity 需要先完成一次编译。
  • Unity编辑器启动中 / Unity编辑器已启动,等待连接:通过 Locus 启动 Unity 后的过渡状态。
  • 已连接:指示切换为语义状态,显示 Unity 正在做什么:Unity 编辑态Unity 运行态Unity 暂停Unity 重载中等。
各状态下的能力差异:编辑态下全部能力可用;运行态暂停下 Agent 依然可以执行代码、读取运行时状态,适合边玩边调;重载中编译中表示编辑器暂时无法响应命令,Locus 会自动等待恢复,无需手动干预。脚本改动触发重编译时显示Unity 重编译中,等待重连

状态面板

点击状态指示展开详情面板,包含进程信息、当前场景、通信延迟,以及原生桥接状态探针后台 Hook等子系统状态(含义见运行时状态与后台运行)。面板中的操作安全行提示当前时机是否适合调用 Unity。 快捷操作:
  • 启动:Unity 未运行时,直接从 Locus 启动当前项目。
  • 重编译:位于Unity 热更新面板,手动触发一次 Unity 重编译并等待编辑器重连,见热更新

编辑器内嵌窗口

在 Unity 菜单选择 Window > Locus 可以打开编辑器内嵌窗口,在 Unity 里直接与 Locus 对话,适合不想切换窗口的工作流。 配套的两个菜单项用于把编辑器中的内容发给 Locus:选中资产后使用 Assets > Send to Locus,选中场景对象后使用 GameObject > Send to Locus,所选内容会作为引用出现在 Locus 输入框中。

团结引擎(Tuanjie)

Locus 自动识别团结引擎(Unity 中国版)编辑器:启动发现、进程检测与连接流程与 Unity 完全一致,无需任何额外配置。