入门

本指南介绍 Locus 的三个工作区，无需源代码管理或在线账户即可使用。

1. 打开 Locus

打开 Window > Locus，使用内容浏览器工具栏中的 Locus 按钮，或按 Ctrl+Shift+L。顶部导航可以在 笔记、标记点和文档之间切换。设置按钮位于主工具栏右侧。

2. 创建笔记

打开 笔记，选择 新建笔记，然后选择范围：

• 共享会将 .uenote 文件保存到 <Project>/ProjectNotes/，用于项目协作。
• 私有会将文件保存到 <Project>/Saved/Locus/PrivateNotes/，用于当前本地项目工作区。

为笔记设置有用的标题，输入正文，并根据需要添加标签或资产引用。笔记会在短暂的编辑延迟后自动保存。按 Ctrl+S 可立即保存或重试失败的保存操作。

有关文件夹、搜索、恢复和冲突的信息，请参阅笔记。

3. 放置标记点

打开已保存的关卡，切换到标记点，然后选择共享或私有放置操作。在关卡视口中单击表面以放置标记点；按 Esc 退出放置模式。

标记点可以包含标题、正文、标签、评论和类型。它存储在地图外部的 .locuspin 文件中。放置或编辑标记点不会添加 Actor，也不会将地图包标记为已修改。

有关视口控制、已保存视图和可见性设置，请参阅标记点。

4. 创建文档

切换到文档。在 Locus 文档下创建 Locus 专用的 Markdown 文件，或在内容浏览器下创建映射到对应 /Game 文件夹的文档。两者都是 <Project>/ProjectDocuments/ 下的项目所有 .md 文件；根节点只说明显示方式，不会创建单独的存储库。新文档以未跟踪状态开始，因此可以先整理、重命名、移动和编辑，路径确定后再选择标记为添加。

文档使用显式保存：按 Ctrl+S。编辑模式显示 Markdown 源文本；阅读模式使用 Unreal 原生 UI 呈现受支持的 Markdown。可以同时打开多个文档。

有关内容浏览器映射、导入/导出和 Markdown 限制，请参阅文档。

本地模式

源代码控制是可选的。在没有配置提供程序的情况下，Locus 可以编辑 本地模式 中的本地和未跟踪文件，而无需提供程序操作或特定于源代码控制的 UI。通过配置的提供程序，新的共享 笔记 保留其创建后添加请求；新的共享 标记点 和 文档 保留为 Untracked，直到您明确选择 标记为添加。当其提供者不可用时，受控内容仍会受到保护，并且私有内容永远不会联系提供者。参见版本控制。

6. 调整工作区

打开设置，更改外观、编辑器呈现、字体大小、换行、树密度、工作区恢复和标记点呈现。重置操作只影响 UI 状态，不影响内容。请参阅设置和外观。

7. 连接 MCP 客户端（可选）

Unreal Editor 打开时，Locus 可以选择连接兼容的本地 MCP 客户端，以处理受支持的笔记、文档、标记点和状态信息。它不包含自主 AI 助手；AI 工作流由连接的客户端执行。准备设置时，请从 MCP 集成开始。

要报告问题或建议，请在 Locus 中选择提供反馈，或访问反馈网站。