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

# 通用设置

> 界面、通知、快捷键、代理、日志与运行时环境

「设置」左侧`通用`分组集中了界面与运行环境相关的配置，本页按标签逐个介绍。

## 通用

* **`界面语言`**：切换界面显示语言。
* **`调试模式`**：开启后每次大模型 HTTP 请求会被保存到调试目录（开发构建为 `debug/llm/`，发布构建为 `data/debug/llm/`），`Authorization` 等敏感请求头会被自动脱敏。排查请求内容时开启，平时保持关闭。
* **`模型请求自动重试`**：模型请求失败（连接错误、超时、HTTP 5xx 与 429 限流）时的自动重试次数，默认 3 次，可设 0 到 10；仅在尚未产生任何输出前重试，429 会遵循服务器的 Retry-After 建议，设为 0 关闭。
* **`Unity 后台加速`**：修复 Unity 窗口在后台时的编辑器循环降速，让 Agent 的编译与命令不必等你切回 Unity。
* **`关闭行为`**：点击关闭主窗口后`直接退出应用`或`最小化到托盘`。
* **`本地数据存储`**：会话与记忆文件的存放位置（Knowledge 保留在项目目录中），可`打开目录`或`更改位置`，迁移在重启后完成。
* **`临时文件`**：工具大输出与运行临时文件的存放处，`清理`可释放空间。清理后历史会话仍可打开，已清理的大工具输出会显示为`完整输出已删除`。
* **`Git 运行时`**：Locus 使用这里选择的 Git 执行版本控制、撤销和变更分析，可选托管 Git 或系统已安装的 Git。
* **`Python 运行时`**：bash 工具调用 `python` / `pip` 时使用的解释器，托管 Python 的依赖安装到数据目录，不污染系统环境。
* **`重置所有设置`**：清除当前配置并重新进入初始引导。

## 显示

* **`主题`**：主窗口与 Unity 嵌入窗口分别选择`跟随系统`、`亮色`或`暗色`。
* **`主界面`**：控制顶部导航入口的显隐，可分别开关`知识`、`协作`、`资产`、`视图`、`插件`、`Agent` 标签页。
* **`面板行为`**：任务列表与文件修改面板的自动打开与关闭，见[文件变更与撤回](/sessions/changes-and-undo)。
* **`字体`**：分别自定义界面、正文、行内代码、代码块与编辑器区域的字体。

## 通知

* **`系统通知`**：窗口未聚焦时为关键对话事件发送系统通知，可分别开关对话完成、Subagent 完成、需要输入、对话出错、需要确认五类事件。
* **`提示音`**：同样五类事件可播放提示音，支持内置音源（`柔和`、`清脆`、`警示`三种模式）或自定义音频文件，可调音量并预览。

## 快捷键

* **`发送方式`**：`Enter 发送`（修饰键+Enter 换行）或修饰键+`Enter 发送`（Enter 换行）。
* **`运行中发送`**：会话运行中发送消息的默认处理，`排为下一条`或`插入当前会话`，见[会话页面](/sessions/index)。
* **`新建会话`**：自定义组合键。点击`录制`后按下组合键，至少包含一个修饰键。

## 代理

`代理模式`决定 Locus 后端请求的网络路径：

* **`自动代理发现`**（默认）：读取环境变量和系统代理配置。
* **`系统代理`**：后端请求读取系统代理配置。
* **`手动配置代理`**：使用手动填写的`代理地址`，如 `http://127.0.0.1:7890`。
* **`禁用代理`**：后端请求直连。

页面下方的`请求路由`实时显示每类请求实际走的路径，便于确认代理是否生效。

## 控制台

查看前端与后端的统一调试输出。支持按级别（`Trace` 到 `Error`）与来源（`前端`/`后端`）过滤，按模块名或日志内容搜索。后端 debug 与 trace 级别日志受`通用 → 调试模式`控制。日志同步写入本地文件，崩溃后仍可查看；`导出日志`打包当前输出，`定位日志文件`直接打开日志所在目录，反馈问题时附上导出结果最有效。

## 归档会话

查看已归档的会话记录。归档后不会出现在会话列表中，但仍可在这里打开查看内容或`取消归档`恢复。

## 关于

显示当前版本与联络方式。`更新通道`可选`稳定版`或`实验性`：实验性通道更早拿到新功能，稳定性相对较弱。`检查更新`手动拉取最新版本信息。