- 从 Releases 下载
OpenLess_<版本>_aarch64.dmg。 - 打开 dmg，将 OpenLess.app 拖入「应用程序」文件夹。
- 双击启动。
- 从 Releases 下载
OpenLess_<版本>_x64-setup.exe。 - 运行安装程序，按提示完成安装。
- 从开始菜单启动 OpenLess。
首次启动后，在「系统设置 → 隐私与安全」中授予以下权限：
- 麦克风 — 允许 OpenLess 录音。
- 辅助功能 — 允许 OpenLess 读写当前焦点输入框。授权后须完全退出并重新启动 OpenLess，快捷键才会生效。
- 按系统提示授予麦克风权限。
- 打开 OpenLess → 「设置 → 权限」，确认全局快捷键监听器状态显示为「已启动」。
不会配火山 ASR 的话，先看这篇图文引导：
OpenLess 火山 ASR 配置
打开 OpenLess → 设置，填入以下字段：
| 字段 | 说明 |
|---|---|
| 火山引擎 App ID | 语音识别服务的应用 ID |
| 火山引擎 Access Token | 语音识别访问凭据 |
| 火山引擎 Resource ID | 语音识别资源 ID |
| Ark API Key | 文本润色服务的 API Key |
| Ark Model ID | 使用的模型 ID（如 doubao-pro-32k） |
| Ark Endpoint | 接口地址，默认 https://ark.cn-beijing.volces.com/api/v3/chat/completions |
保存后设置立即生效，无需重启。
按下全局快捷键（默认 macOS 右 Option，Windows 右 Control）。
屏幕边缘会出现状态胶囊，显示「录音中」。
再次按下同一快捷键。OpenLess 会：
- 停止录音并发送音频进行转写。
- 对转写结果按当前输出模式进行润色。
- 将润色后的文字插入当前焦点输入框（失败时自动复制到剪贴板）。
录音过程中按 Esc，当前录音内容会被丢弃，不做任何插入。
在 OpenLess 主窗口的胶囊或「设置」中切换模式：
| 模式 | 说明 |
|---|---|
| 原文 | 直接输出转写文字，不做任何修改 |
| 轻度润色 | 修正语气词、标点、明显错字，保留原意 |
| 清晰结构（AI prompt 模式） | 把口语整理成有结构、有约束、有上下文的 prompt，适合直接喂给 ChatGPT / Claude / Cursor |
| 正式表达 | 将口语转换为正式书面语 |
词典用于提高特定词汇的识别准确率（产品名、人名、专有名词等）。
- 打开主窗口 → 词典。
- 点击「新建」，填入正确拼写、分类和备注。
- 启用后，词条会作为热词注入 ASR 识别阶段，并在润色阶段辅助语义判断。
主窗口 → 历史，可查看所有录音记录，包括原始转写和润色结果。
主窗口 → 设置 → 快捷键，选择触发键。
macOS 支持右侧修饰键（Option / Control / Command / Shift）；Windows 支持右 Control。
Q: 快捷键没反应？
macOS：确认已授予辅助功能权限，且授权后重启过 OpenLess。
Windows：在「设置 → 权限」中检查监听器状态。
Q: 识别结果为空或是占位文字？
检查火山引擎 ASR 凭据是否填写正确。填写正确后识别才能正常工作。
Q: 文字没有插入，只是复制到了剪贴板？
当目标输入框不支持辅助功能写入时（如某些安全限制的应用），OpenLess 会自动回退到剪贴板复制，手动粘贴即可。
Q: 润色结果和预期不符？
尝试切换输出模式，或在词典中添加相关专有名词。
欢迎通过 QQ 加入用户群，反馈问题或交流使用体验：
QQ 群：1078960553