> For the complete documentation index, see [llms.txt](https://docs.acestudio.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.acestudio.ai/docs/product-wiki-zh/zhang-hu-yu-she-zhi/preferences.md).
# 偏好设置
自定义并管理 ACE Studio 的设置。
对于 Windows 用户，你可以在主菜单的 \[File] 下找到偏好设置。
对于 Mac 用户，你可以在主菜单的 \[ACE Studio] 下找到偏好设置。
你也可以点击 :gear: 右下角的齿轮图标以打开偏好设置。
## 常规
### 语言
* **界面**：为整个用户界面设置显示语言，包括菜单、按钮和工具提示。默认情况下，应用会尝试匹配你的操作系统语言。
* **默认演唱语言**：决定你创建的新人声轨道所分配的默认语言。“使用歌手母语”选项会自动将轨道语言设置为所选歌手的母语。
### 自动翻页
这些设置用于配置播放期间时间线的自动翻页行为，确保播放头始终可见。
* **动画**：自定义视图推进时自动翻页动画的样式和速度。
* **滚动触发点**：定义自动翻页被激活的时机。
* **滚动取消**：在你放大进行精细编辑时，防止自动翻页。例如，“<2.5s 音阶”会在当前可见时间线少于 2.5 秒时禁用自动翻页，避免不必要的屏幕跳动。
### 调试
* **调试日志**：管理应用日志文件的存储，这有助于开发者诊断问题。你可以设置日志保留时长。
### 导入MIDI
* **八度偏移**：允许你将导入的 MIDI 文件中的所有音符上移或下移一个或多个八度。
### 外部智能体访问
通过 MCP 或命令行将 AI 智能体和助手连接到 ACE Studio。有关设置指南，请参见 [外部智能体访问](/docs/product-wiki-zh/ai-zhi-neng-ti/external-agent-access.md).
* **MCP 服务器（stdio）**：点击 **复制命令** 以复制 ACE Studio 的 MCP 服务器启动命令，然后将其添加到你的 MCP 客户端配置中。
* **acestudio-cli 二进制文件路径**：点击 **复制** 以复制命令行工具的路径，供会编写脚本或自动化 ACE Studio 的智能体和高级用户使用。
## 音频
{% hint style="warning" %}
对于 Windows 用户：
由于 ASIO 的独占性，它一次只能支持一个程序。如果你要使用 ASIO 设备，请确保没有其他程序同时使用 ASIO。更多信息请参阅[ASIO Problem?](/trouble-shooting/audio-issues/readme.md)
{% endhint %}
### 设备
本部分控制应用用于音频的硬件和驱动程序。
* **设备类型**：选择用于与硬件通信的音频驱动模型。
> 在 **macOS**，这通常会是 **CoreAudio**.
>
> 在 **Windows**，强烈建议选择 **ASIO** 如果你有带专用 ASIO 驱动的音频接口，建议选择它，因为它可提供最低延迟和最佳性能。
* **输入**：选择用于录制音频的设备。
* **输出**：选择用于音频播放的设备。
* **输出通道**：如果您选定的输出设备具有多个物理输出，您可以在此选择使用哪一对。
* **新设备通知**：勾选后，如果检测到音频设备已连接或断开，应用程序将通知您，以便您检查设置。
### 录音与播放
这些设置可微调音频性能、音质和录音行为。
* **采样率**：决定数字音频质量。48000 Hz 或 96000 Hz 等更高数值可提供更高保真度，但会导致文件更大。44100 Hz 是 CD 的标准，而 48000 Hz 常用于视频和专业音频。
* **缓冲区大小**：控制一次处理的数据量，直接影响延迟。
* **低缓冲区大小** （例如 128、256）：可实现非常低的延迟，这非常适合实时录音和监听。不过，它需要更多 CPU 性能，并且在性能较弱的系统上可能会出现咔哒声或爆音。
* **高缓冲区大小** （例如 512、1024）：会增加延迟，但能让播放更稳定，并降低 CPU 负载。这非常适合在不录音时进行混音和播放。
* **延迟补偿**：手动修正实时输入与工程播放之间的任何时间差。如果您发现录制内容与节拍略有不同步，请以毫秒（ms）为单位调整此数值，直到录制音频完全对齐。
* **预备拍**：用于在 [录音](/docs/product-wiki-zh/gong-cheng/arrangement-in-canvas/record.md) 开始前设置节拍器预备拍。例如，选择“1 小节”将播放一个小节的节拍器提示音，让您在录音于第一拍开始前有时间准备。
## 渲染
该 **渲染** 选项卡可让您配置应用程序生成合成人声音频的方式。应用程序支持两种主要渲染模式：默认的 **云端渲染** 以及提升性能的 **Turbo Mode**.
这些设置当前适用于 [V2 模型](/docs/product-wiki-zh/ai-sheng-yue-he-cheng/voice-library/vocal-synth-models.md#model-generations) 仅限。
* **测试 Turbo Mode：** 单击此按钮开始 1 分钟的性能基准测试。
* **Turbo Mode**：通过成功的性能测试解锁后，您可以使用此复选框启用或禁用 Turbo Mode。
* **预渲染：** 勾选后，应用程序会在您完成对音符或参数的编辑后，立即在后台主动开始渲染歌声。这意味着在您按下空格键之前，音频通常就已准备就绪，从而带来更灵敏、更流畅的编辑体验。
有关渲染的更多信息，请参阅 [本地渲染](/docs/product-wiki-zh/ai-xuan-ran/local-rendering.md).
## 视频
该 **视频** 选项卡控制 ACE Studio 如何在 [视频轨道](/docs/product-wiki-zh/gong-cheng/arrangement-in-canvas/video-track.md).
### 视频预览代理
* **代理预览**：勾选后，ACE Studio 会在后台转码高于代理分辨率的视频，并预览轻量级代理文件而非原始文件。导出始终使用原始文件。
* **代理分辨率**：代理的分辨率。建议使用 720p。
* **代理关键帧**：代理中存储关键帧的频率。 **每秒一次** （推荐）可将磁盘占用减半； **每帧一次** 可获得最平滑的拖动预览。
### 代理缓存
* **代理位置**: 代理文件存放的文件夹。单击 **更改…** 以选择其他文件夹，或 **在 Finder 中显示** （macOS）/ **在资源管理器中显示** （Windows）以打开当前文件夹。
* **磁盘占用**: 当前代理缓存的大小。单击 **清除缓存** 以删除所有代理文件。下次需要时，它们会重新生成。
## 插件
使用此选项卡管理 ACE Bridge 和第三方插件。
### ACE Bridge
安装或卸载 [ACE Bridge 2](/docs/product-wiki-zh/daw-ji-cheng/ace-bridge-2.md) 在此处。如果插件停止工作，请在此处重新安装。ACE Studio 还会在有可用更新时通知你。
> 此设置仅适用于 **macOS**. 在 **Windows**，ACE Bridge 2 会随 ACE Studio 一起安装，并可通过重新安装 ACE Studio 恢复。
### 重新扫描插件
ACE Studio 会扫描标准系统插件文件夹——VST3 和 AU，包括效果器和乐器：
| 格式 | 位置 |
| ----------------- | -------------------------------------------------------------------------- |
| **VST3（Windows）** | `%LOCALAPPDATA%\Programs\Common\VST3` 和 `%ProgramFiles%\Common Files\VST3` |
| **VST3（macOS）** | `~/Library/音频/Plug-Ins/VST3` 和 `/Library/音频/Plug-Ins/VST3` |
| **AU（macOS）** | `~/Library/音频/Plug-Ins/Components` 和 `/Library/音频/Plug-Ins/Components` |
效果插件会显示在 FX 资料库中（请参阅 [第三方效果](/docs/product-wiki-zh/gong-cheng/mixing/effects/third-party-effects.md)）；乐器插件会显示在 **插件** 选项卡的 [乐器库](/docs/product-wiki-zh/yue-qi/instrument-library.md).
ACE Studio 会在首次启动时全面扫描您的插件文件夹，后续启动时则仅检测已更改的插件文件。如果新安装或更新的插件未显示，请在此处刷新列表：
* **重新扫描**：扫描新安装或更新的插件，并将其添加到效果浏览器和乐器资料库中。
* 若要从头重建列表，请按住 Alt / 选项 在单击时 **重新扫描** 以强制重新扫描所有插件。这会更慢，但可解决插件列表不同步的问题。
{% hint style="info" %}
如果插件在扫描过程中卡住或失败，你可以 **禁用** 它——它将不会再次被扫描——或者 **跳过** 它并继续。
{% endhint %}
## 更新
你可以在此手动更新到 ACE Studio 的最新版本。
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.
Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:
```
GET https://docs.acestudio.ai/docs/product-wiki-zh/zhang-hu-yu-she-zhi/preferences.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.