> ## Documentation Index > Fetch the complete documentation index at: https://unity.farlocus.com/llms.txt > Use this file to discover all available pages before exploring further. # 连接与插件 > 安装 Unity 插件、理解连接状态与状态面板，以及编辑器内嵌窗口 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 依然可以执行代码、读取[运行时状态](/unity/runtime-state)，适合边玩边调；`重载中`、`编译中`表示编辑器暂时无法响应命令，Locus 会自动等待恢复，无需手动干预。脚本改动触发重编译时显示`Unity 重编译中，等待重连`。 ## 状态面板 点击状态指示展开详情面板，包含进程信息、当前`场景`、通信`延迟`，以及`原生桥接`、`状态探针`、`后台 Hook`等子系统状态（含义见[运行时状态与后台运行](/unity/runtime-state)）。面板中的`操作安全`行提示当前时机是否适合调用 Unity。 快捷操作： * **`启动`**：Unity 未运行时，直接从 Locus 启动当前项目。 * **`重编译`**：位于`Unity 热更新`面板，手动触发一次 Unity 重编译并等待编辑器重连，见[热更新](/unity/hot-reload)。 ## 编辑器内嵌窗口 在 Unity 菜单选择 `Window > Locus` 可以打开编辑器内嵌窗口，在 Unity 里直接与 Locus 对话，适合不想切换窗口的工作流。 配套的两个菜单项用于把编辑器中的内容发给 Locus：选中资产后使用 `Assets > Send to Locus`，选中场景对象后使用 `GameObject > Send to Locus`，所选内容会作为引用出现在 Locus 输入框中。 ## 团结引擎（Tuanjie） Locus 自动识别团结引擎（Unity 中国版）编辑器：启动发现、进程检测与连接流程与 Unity 完全一致，无需任何额外配置。