首次权限与凭证配置——麦克风 / 辅助功能 / ASR / LLM 四件事
权限四件套（按平台）
macOS
OpenLess 在 macOS 上需要三项权限才能正常工作：
| 权限 | 在哪里设置 | 关键注意 |
|---|---|---|
| 麦克风 | 系统设置 → 隐私与安全性 → 麦克风 | 必须开，否则 ASR 拿不到音频 |
| 辅助功能 | 系统设置 → 隐私与安全性 → 辅助功能 | 必须开，快捷键监听 + 光标注入都靠它 |
| 输入监控 | 系统设置 → 隐私与安全性 → 输入监控 | 某些 macOS 版本需要额外授予 |
⚠️ 辅助功能授权后必须完全退出并重新启动 OpenLess——授权只在重启后生效。直接关窗口没用，要 Cmd + Q 退出再打开。
Windows
Windows 端权限相对简单：
| 权限 | 在哪里检查 |
|---|---|
| 麦克风 | 首次录音时弹窗允许；或系统设置 → 隐私和安全性 → 麦克风 |
| 全局快捷键监听器 | OpenLess → 设置 → 权限，状态显示「已启动」才正常 |
如果快捷键没反应，先去这里看监听器是不是卡在「未启动」。
Linux
- 音频——首次录音时系统可能弹出 PipeWire/Pulseaudio 权限请求，允许即可
- 热键监听——依赖窗口管理器的全局热键支持，OpenLess 用
Ctrl + /作为默认录音快捷键
填入 ASR 和 LLM 凭据
权限拿到后还不够——OpenLess 需要一个 ASR（语音识别）提供商和一个 润色 LLM 才能跑完整流程。默认推荐组合是 火山引擎 ASR + 火山方舟 Ark，国内网络延迟低、价格友好。
推荐：火山引擎 ASR + Ark 润色
打开 OpenLess → 设置 → AI 服务与模型：
语音识别（ASR）
点击「添加渠道」→ 选火山引擎 → 按界面提示填：
| 字段 | 说明 |
|---|---|
| 服务选择 | 普通服务（Standard）或 Agent Plan |
| App ID | 火山控制台语音识别应用的 App ID |
| Access Token | 语音识别访问凭据 |
| Resource ID | 语音识别资源 ID（留空时 OpenLess 会用默认值） |
保存后点「验证」——成功与否和时间会记录在渠道列表里。
语言模型（润色）
点击「添加渠道」→ 选火山方舟 → 填：
| 字段 | 说明 |
|---|---|
| 服务选择 | 普通火山方舟 / Agent Plan / Coding Plan |
| API Key | 方舟控制台创建的 API Key |
| Model ID | 要调用的模型 ID（如 doubao-pro-32k） |
| Endpoint | 默认 https://ark.cn-beijing.volces.com/api/v3/chat/completions |
同样保存后点验证。
凭据安全存储
所有凭据存操作系统级的安全存储，不会明文落到磁盘上：
| 平台 | 存储位置 |
|---|---|
| macOS | 系统 Keychain（service = com.openless.app） |
| Windows | Windows 凭证管理器 |
| Linux | 系统 keyring |
OpenLess 只会从 Keychain/凭证管理器里读取，不会生成明文配置文件。唯一会读取 JSON 的场景是旧版本（v1.x）明文配置的自动迁移——读一次、写进 Keychain、然后删掉旧 JSON。
凭证填完之后
凭据验证通过后，去 OpenLess 主窗口确认：
- 状态栏 / 概览页的 ASR 和 LLM 状态卡片都显示「已配置」（不再是「未配置」）
- 按默认快捷键（macOS 右 Option / Windows 右 Control / Linux Ctrl + /）开始录音，说话，松开——应该能看到屏幕边缘的状态胶囊先显示「录音中」，几秒后文字出现在当前光标位置