---
title: 设置参考
---

# 设置参考

当前 Koharu 的 Settings 页面主要包含以下 6 个区域：

- `Appearance`
- `Engines`
- `API Keys`
- `Keybinds`
- `Runtime`
- `About`

本页基于当前应用实现说明这些设置项的实际行为。

## Appearance

`Appearance` 标签页当前包含：

- 主题：`Light`、`Dark`、`System`
- 从内置翻译资源中选择 UI 语言
- 用于渲染译文的 `Rendering Font`

主题、语言和渲染字体的变更都会在前端立即生效。

## Engines

`Engines` 标签页用于选择各个流水线阶段使用的后端：

- `Detector`
- `Bubble Detector`
- `Font Detector`
- `Segmenter`
- `OCR`
- `Translator`
- `Inpainter`
- `Renderer`

这些值会写入共享应用配置，并在修改时立即保存。

## API Keys

`API Keys` 标签页当前覆盖以下内置提供方：

- `OpenAI`
- `Gemini`
- `Claude`
- `DeepSeek`
- `DeepL`
- `Google Cloud Translation`
- `Caiyun`
- `OpenAI Compatible`

每个提供方都以折叠面板形式展示，并带有一个状态指示点：

- 绿色：已就绪（密钥已保存且发现成功）
- 琥珀色：缺少必需的配置项（API key，或 `OpenAI Compatible` 的 base URL）
- 红色：在已配置的端点上发现失败
- 灰色：尚未配置

当前行为：

- 提供方 API key 不会写入 `config.toml`
- 在 macOS 和 Windows 上，提供方 API key 存储在系统 keyring 中
- 在 Linux 上，提供方 API key 存储在应用数据目录下的 Koharu 本地文件系统凭据存储中，并使用仅所有者可访问的文件权限
- 提供方的 `Base URL` 保存在共享应用配置中
- `OpenAI Compatible` 需要自定义 `Base URL`；模型列表通过对该 URL 调用 `GET /v1/models` 动态发现
- 机器翻译提供方（`DeepL`、`Google Cloud Translation`、`Caiyun`）只需要 API key；`Caiyun` 仅支持有限的目标语言
- 清除密钥会把它从凭据存储中删除

API 响应不会返回原始密钥，而是返回已遮罩的值。

Linux 文件系统凭据存储依赖本地文件系统权限，而不是操作系统级加密。

## Keybinds

`Keybinds` 标签页可用于重新绑定工具切换、笔刷大小快捷键以及撤销/重做的按键。

当前行为：

- 选择 / 块 / 笔刷 / 橡皮 / 修复笔刷工具的默认按键分别为 `V`/`M`/`B`/`E`/`R`
- 笔刷大小步进的默认按键为 `[` 和 `]`
- 撤销与重做的默认按键为 `Ctrl + Z` 和 `Ctrl + Shift + Z`（macOS 上为 `Cmd + Z` 和 `Cmd + Shift + Z`）
- 画布缩放（`Ctrl` + 滚轮）、平移（`Ctrl` + 拖动）、全选（`Ctrl + A`）以及旧版 `Ctrl + Y` 重做备用方式不可重新绑定
- 编辑器中会高亮显示冲突；在同一界面也可以恢复默认值

快捷键偏好保存在前端 preferences 层中，而不是 `config.toml` 里。

完整的默认列表请参见 [键盘快捷键](keyboard-shortcuts.md)。

## Runtime

`Runtime` 标签页集中放置会影响共享本地运行时、且需要重启后生效的设置：

- `Data Path`
- `HTTP Connect Timeout`
- `HTTP Read Timeout`
- `HTTP Max Retries`

当前行为：

- `Data Path` 控制运行时包、下载模型、页面清单和图像 blob 的存储位置
- `HTTP Connect Timeout` 控制建立 HTTP 连接时的最长等待时间
- `HTTP Read Timeout` 控制读取 HTTP 响应时的最长等待时间
- `HTTP Max Retries` 控制遇到临时 HTTP 故障时的自动重试次数
- 这些 HTTP 值会应用到下载和提供方请求共用的运行时 HTTP 客户端
- 由于这些值在启动时加载，应用变更时会先保存配置，再重启桌面应用

## About

`About` 标签页当前显示：

- 当前应用版本
- 是否存在更新的 GitHub release
- 作者链接
- 仓库链接

在打包应用模式下，版本检查会把本地版本与 `mayocream/koharu` 的最新 GitHub release 进行比较。

## 持久化模型

当前设置数据分布在多个存储层中：

- `config.toml` 保存 `data`、`http`、`pipeline` 以及提供方 `baseUrl` 等共享配置
- 提供方 API key 通过上文所述的平台凭据存储与 `config.toml` 分开保存
- 主题、语言和渲染字体存储在前端 preferences 层中

因此，清除前端 preferences 并不等于清除已保存的提供方 API key 或共享运行时配置。

## 相关页面

- [使用 OpenAI 兼容 API](../how-to/use-openai-compatible-api.md)
- [模型与提供方](../explanation/models-and-providers.md)
- [HTTP API 参考](http-api.md)