0
3 分钟快速开始（推荐）
- 下载并安装 ChordVox。
- 首次启动后，授予麦克风权限。
- 在设置中选择默认语音引擎（建议先用内置引擎）。
- 设置一个顺手的热键（如 Fn / Globe 或自定义组合键）。
- 按住热键说话，松开后检查是否自动粘贴到目标应用。
建议：
先把「识别可用 + 自动粘贴可用」跑通，再做 AI 提示词和词典优化，学习成本最低。
1
安装与首次启动
macOS
下载 `.dmg` 后拖拽到 Applications。若提示“无法验证开发者”，为非 App Store 下载软件正常提示。打开「终端」应用，粘贴以下命令并回车即可解除限制（该命令仅移除系统的下载标记，不会修改任何文件）：
xattr -dr com.apple.quarantine /Applications/ChordVox.app
open /Applications/ChordVox.appWindows / Linux
Windows 使用安装包 `.exe`；Linux 使用 `.AppImage` 或 `.deb`。 首次启动建议先确认系统输入设备与默认麦克风。
2
系统权限与环境检查
| 平台 | 你要检查什么 | 常见问题 |
|---|---|---|
| macOS | 系统设置 → 隐私与安全性 → 麦克风 | 未授权导致无录音 |
| Windows | 设置 → 隐私 → 麦克风（允许应用访问） | 系统总开关关闭 |
| Linux | 检查输入设备（如 `pavucontrol`）与剪贴板工具 | Wayland 剪贴板不可用 |
验证标准：
不是“程序在运行”，而是“说一句话后能产出文本并自动粘贴到目标输入框”。
3
AI 配置（模型 / API / 本地方案）
ChordVox 支持 OpenAI / Claude / Gemini / Groq 等云端 API，也支持本地 GGUF 模型。 建议先用一个云端模型跑通，再逐步切换到你想要的质量与成本组合。
| 方案 | 特点 | 适合场景 |
|---|---|---|
| Groq（云端） | 响应快，延迟低 | 快速草稿、实时聊天输入 |
| GPT / Claude（云端） | 文本质量高 | 正式写作、邮件、长文本润色 |
| 本地 GGUF | 隐私强，可离线 | 内网、敏感信息场景 |
推荐配置顺序
- 先固定一个可用模型，避免多变量排错。
- 确认“转写成功 + 润色成功 + 自动粘贴成功”。
- 再创建第二套配置（用于速度/质量切换）。
4
热键与自动粘贴工作流
按下热键
→
说话录音
→
本地/云端转写
→
AI 润色
→
自动粘贴
配置 A：高速草稿
用于会议、即时聊天、快速记录。目标是“快且可读”。
配置 B：正式输出
用于邮件、文档、对外沟通。目标是“语气稳、格式好”。
5
自定义词典：准确率提升关键
建议按“人名 / 产品名 / 缩写 / 专业术语”四类维护，并每周迭代一次。
示例（技术团队）
ChordVox
whisper.cpp
Parakeet
SenseVoice
GGUF
Lemon Squeezy
6
常见问题排错
有录音但没文字
优先检查麦克风权限、输入设备和模型可用性；然后再检查 API 与网络。
识别结果为空或异常短
检查是否误触热键、音量过低、缓存异常；必要时清理本地缓存后重试。
Linux 粘贴失败
Wayland 下优先安装 `wl-clipboard`，并确认系统粘贴工具已正确安装。
Windows 无窗口或无响应
先查看系统托盘，再尝试关闭 GPU 启动参数与安全软件拦截排查。
7
给新用户的使用建议
- 先追求稳定可用，再追求模型最优。
- 把“快捷键 + 模型 + 提示词”按场景拆成两套配置。
- 每周更新一次词典，准确率会持续提升。
- 如果你面向客户交付，建议把本页教程链接直接放进产品首页。