☰
OpenLess快速上手指南:10分钟完成安装、权限与密钥配置,告别逐字敲键盘
2026/9/26 2:17:44 网站建设 项目流程

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 页面下载对应安装包:

平台安装包说明
macOSOpenLess_<版本>_aarch64.dmg/x64.dmg分别对应 Apple Silicon 与 Intel
WindowsOpenLess_<版本>_x64-setup.exe双击运行安装程序

macOS 安装步骤

  1. 打开 dmg 文件,把OpenLess.app 拖入「应用程序」文件夹;
  2. 由于官方构建是临时签名(未做 Apple 公证),首次启动前在终端执行一次以下命令,绕过 Gatekeeper 的"已损坏"警告:
xattr -cr /Applications/OpenLess.app
  1. 双击启动应用。

💡 也可以直接用 Homebrew 安装与升级:brew install --cask openless,升级用brew upgrade openless。

Windows 安装步骤

  1. 运行下载的setup.exe安装程序,按提示完成安装;
  2. 从开始菜单启动 OpenLess 即可。

三、首次启动:系统权限授权指南

macOS 权限(麦克风 + 辅助功能)

在「系统设置 → 隐私与安全」中依次授予两项权限:

  1. 麦克风—— 允许 OpenLess 录音;
  2. 辅助功能—— 允许 OpenLess 把文字写入当前焦点输入框。

⚠️ 关键点:授予辅助功能权限后,必须完全退出并重新启动 OpenLess,快捷键才会生效。这是新手最容易踩的坑。

Windows 权限(麦克风 + 快捷键监听)

  1. 按系统弹窗授予麦克风权限;
  2. 打开 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 秒上手:按住快捷键说话

全部配置完成后,使用只有三个动作:

  1. 按住全局快捷键(默认:macOS 右 Option,Windows 右 Control)——屏幕边缘出现状态胶囊,开始录音;
  2. 松开同一快捷键——自动转写 → AI 润色 → 插入光标处;
  3. 录错内容?按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),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询