笔记
笔记是用于记录项目知识的可搜索外部记录。每个笔记都有标题和正文，也可以包含标签和资产引用。
选择共享或私有
Section titled “选择共享或私有”| 范围 | 存储 | 版本控制行为 |
|---|---|---|
| 共享 | <Project>/ProjectNotes/ |
可用时使用活动的 Unreal 版本控制提供程序 |
| 私有 | <Project>/Saved/Locus/PrivateNotes/ |
永远不会查询或更改提供程序 |
范围由存储根目录决定。Locus 不会在共享和私有之间转换已有笔记。
创建和整理笔记
Section titled “创建和整理笔记”使用新建笔记或 Ctrl+N，然后选择范围。Locus 会创建唯一的默认标题、保存笔记并开始编辑标题。使用新建文件夹或 Ctrl+Shift+N 整理树结构。
文件夹是范围内的逻辑整理层。删除文件夹需要确认；其中的笔记和子文件夹会移动到父文件夹，而不是被删除。在同一范围内拖动笔记或文件夹即可整理它们。这会更改笔记的文件夹分配，而不会移动其存储文件，因此普通的笔记整理不需要版本控制文件移动。按 F2 重命名选中的项目，按 Ctrl+D 复制选中的笔记。
Locus 首次打开项目时会过滤 笔记 至 私有。正常单击会选择一行； Ctrl/Shift-click 扩展了选择范围。 笔记 工具栏保留一行，将 插入引用、范围和创建操作逐渐移动到宽度较窄的省略号菜单中。
选择笔记以编辑标题、正文、标签和资产引用。Locus 会在短暂的编辑延迟后保存。按 Ctrl+S 立即写入待处理的更改或重试失败的保存。
默认的可读显示会将资产引用显示为标签。源显示会展示其创作时的令牌形式。可以在设置中更改默认显示、字体大小和自动换行。
文本搜索会匹配标题、正文、标签、资产标签和资产对象路径。可以与范围、标签或选定资产筛选器组合使用。选择多个标签时使用 AND 匹配，标签匹配不区分大小写。
使用内容浏览器上下文操作显示相关项目笔记，可以按选定资产筛选。创建项目笔记会创建与内容浏览器上下文关联的共享或私有笔记。
丰富的参考资料
Section titled “丰富的参考资料”使用 插入引用 搜索资产、标记点、笔记 或 文档。您还可以在支持的情况下键入 @，或将支持的 Locus 项目或 Content Browser 资源拖动到可编辑文本中。资源在编辑器中查找或打开，笔记 在 笔记 工作区中选择，文档 在 文档 编辑器选项卡中打开，标记点 使用正常导航。
要创作 Actor 参考，请将一个符合条件的已加载 Actor 从 World Outliner 拖动到可编辑的 笔记 中。 Identity 使用保存的 root World 和 Actor GUID，而不是其标签。 Actor 不由 插入引用 或 @ 提供；丢失或格式错误的参考文献仍然可见以供诊断。
共享 笔记 不能新引用私有 笔记 或私有 标记点。私有 笔记 可以引用共享或私有内容。
恢复和外部更改
Section titled “恢复和外部更改”恢复快照与权威笔记分开存储：
- 共享恢复：
<Project>/Saved/ProjectNotes/Recovery/ - 私有恢复：
<Project>/Saved/Locus/Recovery/PrivateNotes/
如果有可用恢复内容，请在选择恢复、恢复为新笔记或丢弃前先检查它。如果你有未保存的编辑，而文件在 Locus 外部发生更改，Locus 会阻止静默覆盖，并提供从磁盘重新加载、将本地文本保存为新笔记、复制本地文本或比较两个版本等安全操作。没有未保存本地编辑的干净笔记会从磁盘刷新。
删除选中的笔记需要确认，并会永久删除外部文件。无法通过 Unreal 的撤销系统恢复。启用版本控制时，如果是其他用户签出、文件已过时或状态无法验证等不安全状态，Locus 会拒绝删除。
版本控制和本地模式
Section titled “版本控制和本地模式”私有笔记始终与提供程序无关。选择、打开或阅读干净的受控共享笔记不会将其签出；在使用 签出操作前，它保持只读。签出成功后才能编辑；签出失败时笔记保持受保护状态，不提供强制写入的绕过方式。
新建共享笔记会先写入本地，然后标记为添加。如果提供程序操作失败，有效的本地文件仍会保留，可以重试该操作。
没有活动提供程序时，新建或未跟踪的共享笔记可以在本地模式中编辑。已经由仓库控制的笔记会保持受保护，直到提供程序恢复并明确签出。Locus 不会提交、同步、管理变更列表或更改存储库 typemap。请参阅版本控制和故障排除。
如果没有配置提供程序，笔记 不会显示源代码控制状态、工具提示、指导或操作。配置提供程序后，显示版本控制状态 仅控制紧凑行指示器，而不更改所需的安全反馈或操作资格。
- 笔记整理只能在已有的共享或私有范围内进行。
- 资产引用不会仅为列出或搜索笔记而加载资产。
- 版本控制支持受活动 Unreal 提供程序及其报告的文件状态限制。
Actor 创作仅限于将一个合格的加载 World Outliner Actor 放入可编辑的 笔记 中。列出或搜索参考不会加载资源、关卡或 Actor。