baiqing
7f83bca5b6
- 两个 README 改为描述 Tauri 2 + Rust + React/TS，macOS 12+ 和 Windows - Badges：去掉 Swift/macOS15+，加 Tauri/Rust/Windows/macOS12+ - 状态章节：v1.0 Swift → v1.1 Tauri - 构建说明：Tauri 优先，Swift 降为 legacy - 架构章节：更新为 Tauri 模块表 - Roadmap：删除已完成项（Developer ID + Sparkle） - 下载说明：更新为 DMG/MSI 安装流程 - 发布检查：更新为 tag CI 流程 - 新增 USAGE.md（快速上手指南，中文） - QQ 群号 1078960553 加入显眼位置（README 标题区 + USAGE） - CLAUDE.md：补充 whisper ASR、HotkeySettingsContext、cargo check
3.8 KiB
3.8 KiB
OpenLess 使用指南
安装
macOS
- 从 Releases 下载
OpenLess_<版本>_aarch64.dmg。 - 打开 dmg，将 OpenLess.app 拖入「应用程序」文件夹。
- 双击启动。
Windows
- 从 Releases 下载
OpenLess_<版本>_x64-setup.exe。 - 运行安装程序，按提示完成安装。
- 从开始菜单启动 OpenLess。
首次配置
macOS 权限
首次启动后，在「系统设置 → 隐私与安全」中授予以下权限：
- 麦克风 — 允许 OpenLess 录音。
- 辅助功能 — 允许 OpenLess 读写当前焦点输入框。授权后须完全退出并重新启动 OpenLess，快捷键才会生效。
Windows 权限
- 按系统提示授予麦克风权限。
- 打开 OpenLess → 「设置 → 权限」，确认全局快捷键监听器状态显示为「已启动」。
填入凭据
打开 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