插件安装与更新

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 输入框中。