OpenLess快速上手指南:10分钟完成安装、权限与密钥配置,告别逐字敲键盘
【免费下载链接】openlessHold a key, speak, release — AI-polished text appears at your cursor in any app. Open-source voice input for macOS & Windows. (按住快捷键说话,松开即得润色后的文字)项目地址: https://gitcode.com/gh_mirrors/op/openless
OpenLess 是一款面向 macOS 与 Windows 的开源语音输入工具:按住快捷键说话,松开后 AI 润色后的文字会直接插入当前光标处,让你彻底告别逐字敲键盘。本指南带你完成安装、权限授权与 API 密钥配置三步,10 分钟即可上手。
一、为什么选择 OpenLess 语音输入?
与逐字转写的听写工具不同,OpenLess 的核心能力是AI 润色:口语里的语气词、断句和错别字都会被自动清理,并按你选择的风格输出。它具备:
- 🎙️四种输出模式:原文、轻度润色、清晰结构(AI Prompt 模式)、正式表达;
- ⚡流式插入:润色后的文字逐字流入光标处,几乎与思考同速;
- 📖会学习的词典:专有名词、人名加入词典后识别更准,纠错还会主动提醒你收藏;
- 🔒本地优先:数据留在本机,API 密钥存入系统安全存储,支持自带任意云厂商凭据。
二、一键安装步骤:macOS 与 Windows
到项目的 Releases 页面下载对应安装包:
| 平台 | 安装包 | 说明 |
|---|---|---|
| macOS | OpenLess_<版本>_aarch64.dmg/x64.dmg | 分别对应 Apple Silicon 与 Intel |
| Windows | OpenLess_<版本>_x64-setup.exe | 双击运行安装程序 |
macOS 安装步骤
- 打开 dmg 文件,把OpenLess.app 拖入「应用程序」文件夹;
- 由于官方构建是临时签名(未做 Apple 公证),首次启动前在终端执行一次以下命令,绕过 Gatekeeper 的"已损坏"警告:
xattr -cr /Applications/OpenLess.app- 双击启动应用。
💡 也可以直接用 Homebrew 安装与升级:
brew install --cask openless,升级用brew upgrade openless。
Windows 安装步骤
- 运行下载的
setup.exe安装程序,按提示完成安装; - 从开始菜单启动 OpenLess 即可。
三、首次启动:系统权限授权指南
macOS 权限(麦克风 + 辅助功能)
在「系统设置 → 隐私与安全」中依次授予两项权限:
- 麦克风—— 允许 OpenLess 录音;
- 辅助功能—— 允许 OpenLess 把文字写入当前焦点输入框。
⚠️ 关键点:授予辅助功能权限后,必须完全退出并重新启动 OpenLess,快捷键才会生效。这是新手最容易踩的坑。
Windows 权限(麦克风 + 快捷键监听)
- 按系统弹窗授予麦克风权限;
- 打开 OpenLess →设置 → 权限,确认全局快捷键监听器状态显示为「已启动」。
四、密钥配置:填写 ASR 与润色凭据
打开设置,填入两类凭据(以火山引擎为例,这也是官方文档推荐的组合):
| 字段 | 说明 |
|---|---|
| 火山引擎 App ID | 语音识别(ASR)服务的应用 ID |
| 火山引擎 Access Token | 语音识别访问凭据 |
| 火山引擎 Resource ID | 语音识别资源 ID |
| Ark API Key | 文本润色服务的 API Key |
| Ark Model ID | 使用的模型 ID(如doubao-pro-32k) |
| Ark Endpoint | 接口地址,默认已填好,一般无需修改 |
- 详细图文配置流程见 docs/volcengine-setup.md;
- 使用讯飞实时语音转写的用户(AppID + API Key)见 docs/xfyun-asr.md;
- 除火山引擎外,还支持腾讯云、阿里百炼、OpenAI 兼容端点等十余种 ASR / 润色供应商,均可自带凭据(BYOK),无厂商锁定。
✅ 保存后设置立即生效,无需重启。密钥统一存入系统安全存储(macOS 钥匙串 / Windows 凭据管理器 / Linux keyring),不会以明文保存在配置文件中。
五、10 秒上手:按住快捷键说话
全部配置完成后,使用只有三个动作:
- 按住全局快捷键(默认:macOS 右 Option,Windows 右 Control)——屏幕边缘出现状态胶囊,开始录音;
- 松开同一快捷键——自动转写 → AI 润色 → 插入光标处;
- 录错内容?按
Esc随时取消,丢弃本次录音。
如果目标输入框不允许程序写入,OpenLess 会自动把结果复制到剪贴板,手动Ctrl/Cmd+V即可,内容绝不丢失。
在设置或状态胶囊中可切换输出模式:写 AI 提示词选清晰结构,写邮件选轻度润色,需要正式书面语选正式表达。
六、常见问题快速排查
| 问题 | 解决办法 |
|---|---|
| 快捷键没反应 | macOS:确认已授予辅助功能权限并重启过应用;Windows:检查「设置 → 权限」监听器状态 |
| 识别结果为空 | 检查 ASR 凭据(App ID / Access Token)是否填写正确 |
| 文字只进了剪贴板 | 目标应用限制了程序写入,直接粘贴即可 |
| 润色结果和预期不符 | 切换输出模式,或在词典中添加相关专有名词 |
更多资料
- 完整用户手册:USAGE.md
- 中文 README(功能总览):README.zh.md
- 架构说明:docs/architecture.md
安装、授权、填密钥——这三步完成后,"按住说话,松开落字"就成为你的默认输入方式。祝使用愉快!
【免费下载链接】openlessHold a key, speak, release — AI-polished text appears at your cursor in any app. Open-source voice input for macOS & Windows. (按住快捷键说话,松开即得润色后的文字)项目地址: https://gitcode.com/gh_mirrors/op/openless
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考