排查录音、网络与转写故障
排查 Vowise 录音、网络、上传与转写故障，同时保护本地保留的录音。了解哪些内容保存在本地、哪些环节依赖网络连接，以及如何稳妥重试。
- 适合用户
- 工作流被卡住、需要一步步恢复的用户。
- 预计时间
- 16 分钟
- 难度
- 所有用户
使用场景
先确认这篇教程适合什么工作流，再进入操作步骤。
作为准备真实工作流的用户，我想有一份常见失败检查表，这样能修复问题，又不丢录音、不暴露隐私。
你可以判断问题大概发生在哪一层，并收集安全的支持信息。
完整步骤
先分类故障
先判断问题属于捕捉、上传、转写、模板输出、API 认证，还是复盘。
收集安全支持信息
截取能说明错误的截图或日志，但遮挡密钥、私人姓名和敏感原文。
重试最小安全步骤
用小样本录音或占位 API 请求重试，不要重复整个高风险流程。
为什么我的转写结果不对？
先找到最早出错的一层。音频缺失或不清晰时，先处理捕捉或输入；原始转写反复听错同一人名、缩写或产品术语时，先对照来源，再在当前转写路径支持词典的前提下测试一个精简词条；原始转写可用，但最终笔记改变了结构、重点或措辞时，应检查模板或 AI 输出层。一次只改一层，用真实短样本测试，复用前对照来源核验姓名、数字、日期、引语、决策和负责人。
症状 → 首先检查哪一层
| 看到的症状 | 首先检查 | 第一步 | 下一篇指南 |
|---|---|---|---|
| 音频缺失、极轻或输入源明显不对 | 捕捉 / 输入 | 修改 AI 设置前，检查麦克风、来源、权限和保存的源音频 | 第一次录音 |
| 原始转写在大部分片段里都听错普通语句 | 音频 / 转写 | 对照原音频，用当前输入和语言设置测试更短、更清晰的样本 | 第一次录音 |
| 主要是反复出现的人名、品牌、缩写或术语有误 | 词汇 | 保留来源；当前转写路径支持词典时，只测试重复且重要的词条 | 创建专有词词典 |
| 原始转写基本正确，但标题、行动项、摘要或格式不对 | 模板 / AI 输出 | 对照原文与整理结果；调整输出指令，不要改写不确定的原话 | 使用提示词模板 |
| 输出流畅，但引语、日期、数字、负责人或决策可能有误 | 核验 | 回到原音频或原文，标明不确定，不靠推断填空 | 第一次录音 / 与记录对话 |
| 处理卡住、失败或预期结果未出现 | 处理 / 工作流 | 先检查当前平台上可用的源音频或已存记录，再重试最小安全步骤 | 本页桌面录音恢复说明 |
一次只改一项，再测试
保留来源，每次对照结果，再重试更长的工作流。
- 1. 保留原始来源。不要因为第一次输出不对，就覆盖重要录音的唯一副本。
- 2. 找到最先出错的层：音频、原始转写、重复词汇、整理输出，还是后续理解。
- 3. 一次只改一个变量：输入、一个重复词条，或一条输出指令。
- 4. 使用短而有代表性的样本，保留相同的麦克风设置、语言模式和重要术语。
- 5. 对照来源。确认具体错误是否改善，再重试长录音或重要录音。
- 6. 复用前核验姓名、准确引语、数字、日期、决策、义务、负责人和截止时间。
示例：词汇、输出与捕捉
以下是帮助判断的假设示例，不是产品效果测试结果。
- 如果普通语句可读，但 PostHog 反复被听成其他词，可在支持词典的路径上测试这一正确写法，再对照新短样本。
- 如果原始转写没有把任务交给 Alex，而整理笔记却指定了 Alex，请检查输出指令、移除无依据的补全，不要反过来修改原文以匹配笔记。
- 录音空白或极轻时，先查捕捉、输入和已保存来源。词典或模板无法修复从未清晰录下的语音。
- 混合语言句子有误时，先核对当前平台和版本的语言、输入行为，再对照音频。不要假定所有平台都有相同控制项。
这些检查能解决什么、不能解决什么
Vowise 指南区分捕捉、转写复核、词汇和输出整理。具体可用性以当前平台与版本为准。
- 词典可辅助处理重复词汇，但不能还原不清晰或缺失的语音。
- 模板用于组织输出，不应编造或悄悄改正不确定的来源事实。
- AI 整理可能改变重点或措辞。应与可用的原始转写或原音频对照。
- 排查能减少不确定性，但不保证转写或 AI 输出完美。
常见问题：每个错词都应该加进词典吗？
不必。优先添加反复出现且重要的专名、产品名、缩写和领域术语。偶发听辨错误或缺失音频，不一定属于词汇问题。
常见问题：提示词模板能修复听错的人名吗？
模板能整理输出，但不应依赖它修复不确定的来源事实。先核对原始转写或音频；只有当前转写路径支持词典时，才用词典处理重复词汇。
常见问题：为什么最终笔记和原始转写不同？
转写后的模板或 AI 输出层可能重组措辞、标题、摘要或提取的行动项。先分别对照可用原文和整理结果，再判断是否属于语音识别失败。
常见问题：失败后应该立刻重新录音吗？
不一定。先保留并检查当前平台上可用的源音频或已存记录，区分捕捉、处理、转写和输出故障。来源不可用或当前恢复流程要求时，再重新录音。
常见问题：怎样做简短而稳妥的测试？
使用保持相同麦克风设置、语言模式和重要术语的短样本。只改一个变量、对照来源，然后再重试较长的工作流。
常见问题：分享或复用转写前，要核验什么？
对照原始来源或目前最可靠的一手记录，核验姓名、准确引语、数字、日期、决策、义务、负责人、截止时间及其他重要事实。
我可以在离线状态下使用 Vowise 吗？
根据当前已核验的产品行为，Vowise 不应被视为纯离线转写应用。在桌面端，当您停止一段包含实际音频的录音时，Vowise 会在网络转写或后续 AI 处理完成前，先将音频保存到本地 Records。如果网络或后续处理失败，请先检查已保留的本地记录并从该处重试，无需重复录制相同内容。
- 桌面端在网络转写或 AI 优化完成前，会优先在本地保留有效捕获的音频。
- 移动端近期更新日志说明了离线重试优化，但历史更新日志并不代表所有移动端版本或工作流在离线时表现完全一致。
常见问题：录音过程中网络断开，音频会丢失吗？
在桌面端，只要录音包含实际捕获的声音，停止录音时就会先保留在本地 Records，之后再发起网络转写或 AI 处理。这使得音频在后续处理失败时仍可恢复，但并不意味着所有平台或所有功能都支持完全离线运行。
常见问题：没有网络连接转写能完成吗？
不能这样假设。当前桌面端文档明确将“本地已存录音”与“网络转写”以及后续的“AI 处理”区分开来。若处理未能完成，请保留本地录音，待网络恢复后重试处理步骤。
常见问题：网络恢复后应该怎么做？
1. 打开 Records，找到停止录音时生成的录音条目。 2. 在重新录制前，先试听或检查保留的本地音频。 3. 重试最小的失败步骤，不要盲目重复整个流程。 4. 若其他在线操作正常而应用仍报告网络问题，请记录平台、版本号、时间戳和具体失败动作以便反馈。 5. 在支持报告中，切勿发送 API 密钥、Webhook 链接、密码或不必要的私人转写文本。
常见问题：在 iPhone 或 Android 上离线使用的情况如何？
移动端近期版本日志提到了更完善的离线重试能力，但这不足以作为所有当前 iOS 和 Android 录音、转写、同步与 AI 工作流完全离线运行的保证。在依赖特定离线行为前，请确认当前版本及工作流说明。
常见问题：本地保留录音是否意味着所有处理都在本地设备上进行？
并非如此。录音在后续处理前于本地保留，并不等同于“纯本地处理”或隐私承诺。本地存储、语音转写、AI 处理、云端同步以及隐私属于不同环节。请参阅隐私政策及最新产品说明了解具体的数据处理规则。
故障层级图
大多数问题只要先分清失败层级，就会容易很多。
- 捕捉：麦克风、权限、文件格式。
- 处理：上传、转写、长音频行为。
- 输出：模板质量、词典术语、复盘状态。
- 自动化：认证 Header、接口、密钥处理。
恢复已停止的桌面录音
桌面端录音停止时，只要存在实际音频，就会先保留到本地 Records，再执行后续处理。如果语音检测、网络、转写或 AI 处理失败，请先检查 Records，不要立即重新录音。
- 打开 Records，找到停止录音时创建的条目。
- 重试转写前，先播放或检查保留的音频。
- 如果本地没有条目，记录发生时间和捕捉状态，并在不暴露私人音频的前提下联系支持。
确认 AI 优化是否真的运行
桌面端可以在最后语音稳定时只启动一次 AI 优化，并在录音结束时复用这份预取结果。因此，finalize 很快返回不代表跳过了 AI，也不应该再触发第二次工作流。
- 先检查保存结果标记为已优化、原文降级、处理中还是失败；这些状态不能混为一谈。
- Records 重试成功后，桌面端诊断信息应保留服务端返回的实际 n8n 工作流名称、工作流 ID 和调用 ID。
- 联系支持时，提供时间和诊断日志中已脱敏的 workflow/call 标识；不要提供转写原文、API key 或 webhook URL。
- 预取缓存命中应复用第一次工作流调用，并跳过重复派发。
关联功能路径
这篇教程完成后，不应该停在这里。下面是它自然连接到的功能和下一步。