常见问题
遇到问题？先看这里。建议按“检查点 → 解决方法”的顺序排查，通常 1-2 步即可解决。
连接问题
提示“服务器连接失败”
可能原因：
- 网络不通
- 服务器地址错误
- 服务器暂时不可用
解决方法：
- 检查网络连接是否正常（可用浏览器打开任意网页测试）
- 退出并重新打开应用
- 若持续失败，可能是服务器维护，稍后再试
转写经常超时
可能原因：
- 网络延迟高
- 录音时间过长
解决方法：
- 检查网络状况
- 尽量控制单次录音在 2 分钟以内
- 长内容分多次录音
建议：长内容更适合用“文件转录”功能。
录音问题
热键录音没反应
检查点：
- 热键是否与其他软件冲突
- F1-F12 热键需要双击触发
- 应用是否在后台运行
解决方法：
- 换一个不常用的热键组合（如
Ctrl+Alt+R） - 组合键单击即可触发，更可靠
提示：热键设置在「设置 → 热键设置（或快捷键设置）」中修改。
录音开头被吞掉
原因：麦克风需要初始化时间
解决方法：
- 开启「麦克风持续预热」
- 设置位置：设置 → 热键设置（或快捷键设置） → 麦克风持续预热
说明：预热会稍微增加耗电，但能避免开头被吞。
麦克风没声音
检查点：
- 系统麦克风权限是否已授予
- 麦克风设备是否正常工作
- 是否选择了正确的输入设备
解决方法：
- 在系统设置中检查麦克风权限
- 用系统录音软件测试麦克风是否正常
- 重启应用后重试
识别问题
识别结果不准确
可能原因：
- 语音不清晰
- 背景噪音太大
- 专业术语未配置
解决方法：
- 说话清晰、语速适中
- 找安静的环境
- 使用「热词」功能添加专有名词
- 在「行业词汇」中配置常用术语
总是识别成其他语言
解决方法：
- 手动指定识别语言（主界面切换）
- 默认「自动」适合大多数情况，但有口音时可能出错
提示：双语/夹杂英文场景，手动指定更稳定。
英文单词被音译
例如：Kubernetes 被识别成「酷伯内提斯」
解决方法：
- 在「热词」中添加正确写法
- 在「行业词汇」中添加术语
- 开启 AI 优化，会自动还原常见英文名词
进一步说明见 行业词汇。
AI 功能问题
AI 优化没效果
检查点：
- AI 优化开关是否开启
- AI 处理方式是否选择了「云端处理」或配置了「本地处理」
解决方法：
- 确认主界面「AI 优化」开关已开启
- 检查 AI 服务配置是否正确
若使用自定义服务，建议先用短语音验证是否生效。
翻译失败
可能原因：
- AI 服务配置问题
- 网络超时
- API 额度用完
解决方法：
- 检查 AI 服务配置
- 如果使用自己的 API Key，检查账户余额
- 相关说明见 API 配置
网络不稳定也会导致翻译失败，可稍后重试。
自动粘贴问题
粘贴到了错误的地方
原因：粘贴时光标不在目标位置
解决方法：
- 增加自动粘贴延迟（设置 → 热键设置 → 自动粘贴延迟）
- 推荐 1000ms 或 2000ms
提示：录音结束后尽快切回目标输入框。
没有自动粘贴
检查点：
- 是否用热键触发的录音（点击录音不会自动粘贴）
- 自动粘贴是否开启
说明：
- 热键录音 → 自动粘贴
- 点击录音 → 只复制到剪贴板
若希望点击录音也粘贴，可改用热键录音方式。
悬浮球问题
双击没反应
解决方法：
- 双击悬浮球的边缘区域
- 或者使用悬浮球/浮动窗热键
悬浮球消失了
解决方法：
- 按悬浮球/浮动窗热键（如果设置了）
- 重新打开声墨应用
仍未出现时，尝试在任务栏切回主窗口。
其他问题
应用无法启动
检查点：
- 系统是否满足最低要求（Windows 10+）
- 是否被杀毒软件拦截
解决方法：
- 以管理员身份运行
- 将应用添加到杀毒软件白名单
历史记录加载失败
可能原因：数据库损坏
解决方法：
- 设置 → 数据管理 → 重置数据库
- ⚠️ 注意：这会清空所有历史记录
- 详见 数据管理
界面显示异常
解决方法：
- 关闭应用，重新打开
- 检查是否是最新版本
若问题持续，建议导出日志并提交 Issue。
还是解决不了？
- 查看应用日志（设置 → 数据管理 → 日志位置，见 数据管理）
- 在 GitHub 提交 Issue：FatalBlow-hub/voiceink-asr
- 提供以下信息：
- 系统版本
- 应用版本
- 问题描述
- 复现步骤
- 日志文件（如有）