> ## 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.

# 页面提示

> 各个页面的简要使用提示

## 会话

<img src="https://mintcdn.com/farlocus/ZlI-W8lx6_9x2i0K/images/overview/page-tour/session.png?fit=max&auto=format&n=ZlI-W8lx6_9x2i0K&q=85&s=40d10fac25d25ef322adde99077ffa4e" alt="img" width="1339" height="900" data-path="images/overview/page-tour/session.png" />

发送消息前，请确认输入框左上角的`资产数据库`与`Unity编辑器连接`正常运作。

* **多模态输入**：输入框支持图片上传与解析，可以使用`CTRL+V`粘贴。
* **新建会话**：点击左上角的`+`图标或使用快捷键`CTRL+N`（快捷键可在设置页面自定义）
* **执行权限控制**：位于右下角。开启自动模式时，Agent 的工具调用将免审批执行；关闭后，Agent 的任何修改操作均会向用户请求权限，此模式安全性更高但需手动确认。
* **模型切换**：位于右下角，用于切换当前会话所使用的 AI 模型。
* **发送消息**：默认快捷键为`ENTER`，可在设置页面修改为`CTRL+ENTER`。
* **会话列表管理**：点击左侧列表项旁的`>`可展开查看 Subagent 的详细执行过程。列表项支持右键菜单（归档、删除等操作）以及按住`SHIFT`键进行批量多选。

## 协作

<img src="https://mintcdn.com/farlocus/OfAb3Fo_I43YNcC0/images/overview/page-tour/collaboration.png?fit=max&auto=format&n=OfAb3Fo_I43YNcC0&q=85&s=d3c64ca24b10cb6df9c6e9e95b33281f" alt="img" width="2203" height="1455" data-path="images/overview/page-tour/collaboration.png" />

* **版本控制交互**：底部命令行区域支持直接输入标准的 Git 指令或使用自然语言向 AI 下达指令。
* **修改列表显示模式切换**：修改列表右上角的三个按钮可以切换显示模式。
* **上下文菜单**：右键点击 Commit 记录或已修改的文件可唤出扩展功能菜单。
* **变更预览与解析**：点击右侧文件列表（涵盖 Commit、Stash、Unstaged/Staged 区域）可预览文件差异。系统原生支持 Unity YAML 资产文件（如 Scene、Prefab、ScriptableObject 等）的可视化解析。
* **冲突解决**：在合并发生冲突时，系统支持基于上下文的逐字段语义合并。
* **Locus 相关文件标记**：带有 Locus 标记的文件为 Agent 本身的知识或配置文件（默认情况下，除了 `user_preference` 外的记忆与理解在项目层级上共享）。如无需将其纳入项目的版本控制，建议将其加入 .gitignore 文件中

## 知识

<img src="https://mintcdn.com/farlocus/OfAb3Fo_I43YNcC0/images/overview/page-tour/knowledge-types.png?fit=max&auto=format&n=OfAb3Fo_I43YNcC0&q=85&s=326337ae9abcdcf94c389d70502d618a" alt="img" width="2021" height="1325" data-path="images/overview/page-tour/knowledge-types.png" />

### 知识类别

知识库是 Agent 获取项目上下文的核心来源。当前知识体系划分为以下四种类别：

* **Design（设计规范）**：记录项目设计需求与事实基准。AI 可在会话中根据业务需求自动更新此文档（需用户审批介入），用户也支持随时手动编辑维护。
* **Memory（记忆库）**：由 AI 自动维护的动态上下文。系统默认预设三个基础模块（用户偏好、错题本、项目理解）。用户可新建文档并定义专属的维护规则，AI 将按规则进行自动迭代。
* **Skill（技能库）**：用于固化标准化的高频工作流。用户可通过自然语言描述特定流程，指示 Agent 在遇到同类场景时按此 Skill 规范执行。
* **Reference（参考资料）**：外部只读文档库。目前支持导入 Unity API Reference 等本地文档或接入外部协作平台（如飞书文档）。

### 检索策略

系统支持以下两种文档检索机制：

* **词法索引（默认关闭）**：基于关键词提取进行精确文本匹配。
* **语义索引（需在下方检索设置中开启）**：基于文本向量化技术。系统会根据 AI 侧输出的语义片段，检索文档库中含义相近的段落，适用于文档的模糊查询。

<img src="https://mintcdn.com/farlocus/OfAb3Fo_I43YNcC0/images/overview/page-tour/knowledge-search.png?fit=max&auto=format&n=OfAb3Fo_I43YNcC0&q=85&s=a381adcbc1ed9a6255fb07d091914822" alt="img" width="1505" height="1001" data-path="images/overview/page-tour/knowledge-search.png" />

## 设置

设置页面用于管理全局系统配置。

### 模型配置

支持自定义模型参数、配置第三方 API 端点（Endpoint）以及管理订阅账号的登录与授权状态。

<img src="https://mintcdn.com/farlocus/OfAb3Fo_I43YNcC0/images/overview/page-tour/settings.png?fit=max&auto=format&n=OfAb3Fo_I43YNcC0&q=85&s=321a6bd1ce4c62759748bb54ce2fc7c2" alt="img" width="1505" height="1001" data-path="images/overview/page-tour/settings.png" />
