配置指南

altgo 使用 TOML 格式的配置文件，所有字段都有默认值，只需修改你需要的部分。

配置文件位置

~/.config/altgo/altgo.toml

转写引擎配置

本地 SenseVoice（唯一转写方式，无需 API 密钥）

[transcriber]
model = "sense-voice"   # 设置页下载后自动填入；也可填模型目录路径
language = "zh"          # 空字符串 = 自动检测（中/英/日/韩/粤）
threads = 0              # 0 = 自动取满 CPU 核数

润色配置

altgo 支持通过 LLM 对转写文本进行润色。

润色级别

级别	效果	需要 API 密钥
none	不润色，直接输出转写文本	否
light	修正标点和错别字	是
medium	修正语法、改善语序通顺度	是
heavy	结构化重写，适合正式文档	是

配置示例

[polisher]
level = "medium"
protocol = "openai"
api_key = "sk-your-key"
api_base_url = "https://..."
model = "your-model"

api_base_url 写法

两种写法都支持，应用会自动拼出正确的请求地址：

• 不带版本路径（origin）：如 https://api.deepseek.com、https://api.anthropic.com，自动补 /v1/chat/completions 或 /v1/messages；
• 带版本路径：如 https://api.moonshot.cn/v1、https://open.bigmodel.cn/api/paas/v4、https://dashscope.aliyuncs.com/compatible-mode/v1，只在后面接 /chat/completions 或 /messages。

也可以直接填完整 endpoint（以 /chat/completions 或 /messages 结尾），此时原样使用。

设置页的「润色」分区有测试连接按钮：选好供应商预设、填入密钥后点击，会立即发一次最小请求并给出可读的结果（密钥无效、地址不对、超时等），无需先保存或实际录音验证。

支持的 Provider

OpenAI

[polisher]
protocol = "openai"
api_key = "sk-your-key"
api_base_url = "https://api.openai.com"
model = "gpt-3.5-turbo"

DeepSeek

[polisher]
protocol = "openai"
api_key = "sk-your-key"
api_base_url = "https://api.deepseek.com"
model = "deepseek-chat"

Anthropic

[polisher]
protocol = "anthropic"
api_key = "sk-ant-your-key"
api_base_url = "https://api.anthropic.com"
model = "claude-sonnet-4-20250514"

火山方舟（豆包）

[polisher]
protocol = "openai"
api_key = "your-ark-key"
api_base_url = "https://ark.cn-beijing.volces.com/api/v3"
model = "doubao-seed-1.6-flash-250828"

百度千帆

[polisher]
protocol = "openai"
api_key = "your-qianfan-key"
api_base_url = "https://qianfan.baidubce.com/v2"
model = "ernie-4.5-turbo-128k"

MiniMax

[polisher]
protocol = "openai"
api_key = "your-minimax-key"
api_base_url = "https://api.minimaxi.com/v1"
model = "MiniMax-M3"

OpenRouter

[polisher]
protocol = "openai"
api_key = "your-openrouter-key"
api_base_url = "https://openrouter.ai/api/v1"
model = "deepseek/deepseek-chat"

Google Gemini（OpenAI 兼容端点）

[polisher]
protocol = "openai"
api_key = "your-google-key"
api_base_url = "https://generativelanguage.googleapis.com/v1beta/openai"
model = "gemini-2.5-flash-lite"

本地 Ollama

[polisher]
protocol = "openai"
api_key = "ollama"
api_base_url = "http://localhost:11434"
model = "qwen2.5:7b"

设置页内置约百家供应商预设（原生 13 家 + 迁移自 cc-switch 的 86 家，涵盖国产官方、聚合服务与第三方中转的 Anthropic / OpenAI 双协议端点），选择后自动填入地址与协议，只需补上密钥。带有 (Anthropic) / (OpenAI) 后缀的是同一供应商的不同协议端点。

默认关闭「思考」

语音润色是轻量文本任务，推理模型先「思考」再回答会凭空多出数秒延迟和 token 花费。对支持关闭思考的服务商，应用会自动在请求中附带关闭参数，无需配置：

服务商	自动附带的参数
通义（dashscope）、SiliconFlow	enable_thinking: false
智谱、火山方舟、MiniMax	thinking: {"type": "disabled"}
OpenRouter	reasoning: {"enabled": false}

其他服务商（OpenAI、DeepSeek、Anthropic、千帆、Gemini、Ollama）的推荐模型默认不思考，无需处理。注意个别强制思考的模型（如智谱 GLM-5.3）不接受关闭参数，选择预设推荐的模型即可避开。

环境变量覆盖密钥：

export ALTGO_POLISHER_API_KEY="sk-your-key"

按键配置

与 configs/altgo.toml 一致；默认触发键为 右 Alt。若在设置页使用「按下以设置」，Linux 会写入 linux_evdev_code 字段。

[key_listener]
key_name = "Alt_R"                 # 触发键（示例：右 Alt；左 Alt 可用 Alt_L）
long_press_threshold_ms = 200      # 长按判定阈值 (ms)
double_click_interval_ms = 300     # 双击判定间隔 (ms)
min_press_duration_ms = 100        # 最短按下时长，过滤 IME 抖动

录音配置

[recorder]
sample_rate = 16000                # SenseVoice 固定采样率；其他值会被拒绝
channels = 1                       # 单声道

输出配置

[output]
prefer_polished = true             # 剪贴板/注入优先使用润色成功且非空的文本

Linux 需要可用的 xclip、xsel 或 wl-copy 之一，否则自动写剪贴板会失败（仍可用悬浮窗或历史页复制）。

日志配置

[logging]
level = "info"                     # debug / info / warn / error

也可以通过环境变量：

# Linux
RUST_LOG=altgo=debug altgo

优先级

环境变量 > 配置文件 > 代码默认值

环境变量	覆盖字段
ALTGO_POLISHER_API_KEY	polisher.api_key
RUST_LOG	日志级别