跳转到主要内容
插件把 Agent 定义、规则(Rule)、技能(Skill)、视图(View)和项目依赖打包成可安装扩展,安装后在 Locus 中统一使用和更新。「插件」与「视图」两个顶部标签页分别管理它们。

插件能装什么

  • Agent 定义:新的 Agent 角色及其系统提示词。
  • Rule:注入 Agent 上下文的行为规则。
  • Skill:沉淀稳定工作流、检查项和工具使用规则的执行组件,Agent 在特定任务中按固定流程执行,详见技能与参考
  • View:在 Locus 中运行的自定义面板,见下文。
  • 项目依赖:声明插件所需的 Unity Package、程序集或资产,安装时可对照检查。

安装的三种途径

  • 插件 Hub:浏览注册表中的插件,支持搜索、安装更新StarGitHub 登录用于提高 release 元数据请求额度,并支持私有 GitHub 仓库。
  • 从链接导入插件:粘贴仓库、release 或 zip 链接直接安装。
  • 导入本地插件:选择本地的插件 zip 或目录。

作用域:App 级与项目级

安装时选择安装位置
  • 安装到 App:对本机所有项目生效,适合通用工作流。
  • 安装到项目:只对当前项目生效(需要先选择项目),适合与特定项目强绑定的技能和视图,可随项目仓库分发给团队。

更新、禁用与卸载

已安装列表或插件详情中操作:有新版本时显示更新停用临时移除插件的组件而保留文件;卸载彻底删除。插件详情页显示其组件构成、位置与兼容性要求(最低 Locus 版本)。

自定义注册表

插件 Hub 默认使用官方注册表,团队可以自建:在 Hub 的注册表配置中新增条目,填写名称地址(owner/repo 或完整地址)、分支路径。适合在组织内部分发未公开的插件。

视图

视图(View)是通过 Locus 自身前端运行的自定义项目编辑器面板:Agent 可以把 Vue 界面、运行脚本和 Unity 属性数据组合为一个 View package,作为独立工具运行,例如关卡配置表编辑器、技能数值面板。
  • 查看:顶部「视图」页列出当前工作区的全部视图,点击名称即可打开;部分视图需要 Unity 编辑器连接。
  • 创建:在会话中输入 /view 并描述需求,Agent 会进入 View 工作流创建或更新视图。
  • 整理:拖拽条目调整顺序或移入文件夹,右键条目可新建文件夹、重命名、移动或删除。由插件安装的视图随插件管理,需卸载插件后才能删除。
  • 列表入口:「设置 → 显示」的会话列表中显示视图可让视图入口出现在会话页左侧。

从会话创建与发布插件

在会话中输入 /plugin 加上需求,Agent 会进入插件工作流,创建或更新插件清单、组件目录和发布材料。发布到注册表:先在插件页面完成 GitHub 登录,再让 Agent 创建插件仓库并向注册表发起 Pull Request,合并后其他用户刷新插件页即可安装。