错误码查询表
在 TalkTrack 看到形如
ASR-002的错误码？这里告诉你为什么和怎么解决。找不到你看到的错误码？翻到本页底部 UNK-000 一节告诉你怎么报告给我们。
ASR-XXX · 转写引擎
ASR-001：转写失败，ASR 服务账号验证未通过
原因：腾讯云 ASR 的 SecretId 或 SecretKey 错了、被禁用，或账号未开通语音识别服务。
解决步骤：
- 打开 TalkTrack 设置 → 转写引擎
- 确认「腾讯云 SecretId」和「SecretKey」复制完整、没有多余空格
- 登录 https://console.cloud.tencent.com/cam/capi 确认密钥没被禁用
- 仍失败？参考 配置腾讯云 ASR · 故障排查
ASR-002：转写失败，ASR 服务账号余额不足，请充值
原因：腾讯云账户没钱了，或者新用户代金券用完了。
解决步骤：
- 登录 https://console.cloud.tencent.com/expense/recharge 充值（¥10 起，足够内测期用很久）
- 充完后 5 分钟内重新点 测试连通性
ASR-003：转写失败，ASR 服务返回错误
原因：腾讯云返回了非鉴权类的业务错误（音频格式、语种、参数等）。具体看错误的「展开技术详情」里的原始 code + msg。
解决步骤：
- 看错误「技术详情」里的
code和msg - 对照 腾讯云 ASR 错误码文档 查具体含义
- 大多数是录音文件本身问题（采样率不对 / 文件损坏）→ 重新录一段
- 如果 code 是
InternalError/ServiceUnavailable→ 腾讯云临时故障，等几分钟重试
ASR-004：转写超时，请重试或换一段更短的录音
原因：转写任务超过 2 分钟未完成（腾讯云 / 火山引擎都可能触发）。多发于长会议或服务器临时压力大。
解决步骤：
- 重新转写：会议详情页 → 重新转写按钮
- 仍超时？把会议拆成小段（10-30 分钟一段），分别用「导入会议记录」处理
ASR-005：转写失败，火山引擎 ASR 服务异常
原因：火山引擎 ASR 调用失败。
解决步骤：
- 检查 设置 → 转写引擎 里的 AppId 和 Access Token
- 确认 https://console.volcengine.com 账户余额充足
- 临时切到腾讯云试试（更稳）
ASR-006：转写失败，找不到录音文件
原因：要转写的录音文件找不到——多半是文件被误删或会议记录损坏。
解决步骤：
- 退出 TalkTrack，重新打开
- 进入会议详情页查看「录音文件」是否还在
- 如果文件确实丢了，这场会议无法恢复——只能重新录
- 下次注意：录完先生成报告（这一步生成可保存的 markdown 文本），即使录音文件丢了报告还在
ASR-007：转写失败，录音文件格式异常
原因：录音文件结构损坏（缺少 data chunk）。
解决步骤：
- 用 macOS 自带 QuickTime Player 打开录音文件确认能播放
- 不能播放 → 录制时被中断，文件无法修复，重新录一段
- 能播放但仍报错 → 邮件 hello@talktrack.cn 附文件
LLM-XXX · AI 教练
LLM-001：AI 复盘失败，API Key 无效或已过期
原因：调 AI 服务时返回 401/403——Key 错了或被禁用。
解决步骤：
- 打开 TalkTrack 设置 → AI 教练
- 确认 API Key 复制完整（DeepSeek 以
sk-开头） - 去对应平台后台确认 Key 没被 revoke：
- 重新生成一个 Key 粘进 TalkTrack
- 仍失败？参考 配置 DeepSeek · 故障排查
LLM-002：AI 复盘失败，账号余额不足或已超出配额
原因：账户没钱了，或者短时间内调太频繁触发 rate limit。
解决步骤：
- 去对应平台充值：
- 等 1-2 分钟后重试（rate limit 通常很快恢复）
LLM-003：AI 复盘失败，AI 服务返回错误
原因：HTTP 4xx / 5xx 但不是鉴权或额度问题——可能是服务方临时故障、模型不存在、prompt 太长。
解决步骤：
- 看错误「技术详情」里的
status和body - 5xx（500/502/503）→ 服务方临时故障，等几分钟重试
- 400 / 422 → 多半是会议太长（>60 分钟）超过 context 上限，把会议拆段处理
- 404 → 模型不存在，临时换 provider 试试
LLM-004：AI 复盘失败，不支持的 AI 供应商配置
原因：你的设置里选了一个 TalkTrack 不支持的 provider——理论上不该出现，多半是配置文件被外部工具误改。
解决步骤：
- 设置 → AI 教练 重新选一个有效 provider（Claude / DeepSeek / OpenAI / MiniMax）
- 仍报错 → Cmd+Q 完全退出 TalkTrack 再开
KEY-XXX · API Key 配置
KEY-001：未找到 API Key，请先到设置页配置
原因：你还没配置该服务的 API Key 就开始用了。
解决步骤：
- 看错误「技术详情」里说的是哪个 provider（tencent / volcengine / claude / deepseek 等）
- 打开 设置 找到对应配置 Tab
- 详细步骤：
KEY-002：API Key 凭证不完整
原因：保存了一部分凭证但缺另一部分（例如腾讯云只填了 SecretId 没填 SecretKey）。
解决步骤：
- 打开 设置 → 对应 provider 的 Tab
- 把缺的字段补完
- 测试连通性 验证
PERM-XXX · 权限
PERM-001：无法录制系统音频，请授予屏幕与系统音频录制权限
原因：你点了开始录制，但 macOS 没给 TalkTrack 系统音频/屏幕录制权限——会议对方说话录不到。
解决步骤：
- 打开 系统设置 → 隐私与安全性
- 滚到 屏幕与系统音频录制
- 确认 TalkTrack 已勾选
- 完全退出 TalkTrack（Cmd + Q）重新打开
- 仍不行？参考 常见问题 → 录完发现录音是空的
PERM-002：无法录制麦克风，请授予麦克风权限
原因：你点了开始录制，但 macOS 没给 TalkTrack 麦克风权限——你说的话录不到。
解决步骤：
- 打开 系统设置 → 隐私与安全性
- 滚到 麦克风
- 确认 TalkTrack 已勾选
- 完全退出 TalkTrack（Cmd + Q）重新打开
NET-XXX · 网络
NET-001：网络请求失败，请检查网络连接
原因：网络层失败（DNS 错、连接超时、证书错）——和 TalkTrack 后端无关，是你 Mac 出网到第三方服务这一段出问题。
解决步骤：
- 打开浏览器试试能不能正常访问网页
- 检查代理 / VPN 是否开着（DeepSeek 国内直连最稳，Claude/OpenAI 国内通常需要代理）
- 切换网络试试（手机热点 → WiFi 或反过来）
- 仍失败 → 复制错误信息发给 hello@talktrack.cn
SKILL-XXX · 自定义分析模板
SKILL-001：上传失败，分析模板 ID 含非法字符或长度超限
解决步骤：
- 打开你要上传的 .md 文件，看 frontmatter 里
id字段 - id 只能是字母、数字、短横线
-，1-50 字符 - 不能用
_下划线、空格、中文、点号等 - 不能以
-开头或结尾（-bad/bad-都不行） - ✅ 合法示例：
my-grammar-coach/team-review-v2/interview-prep - ❌ 非法示例：
my_skill/My Skill/演讲教练/-bad/bad-
SKILL-002：上传失败，分析模板 ID 与内置模板冲突
含义：你上传的 skill 用了 TalkTrack 内置 skill 的 id（例如 meeting-review），系统拒绝覆盖内置。
解决步骤：
- 改 frontmatter 里的
id为别的（如meeting-review-v2/my-meeting-review） - 重新上传
SKILL-003：上传失败，分析模板格式异常
含义：frontmatter 缺关键字段，或正文不含任何占位符。
解决步骤：
- 文件必须以
---开头、---闭合 - frontmatter 必须含
id、name、description三个字段 - 正文必须至少含一个占位符（
//任选其一） - 完整模板示例见 skills 文档
SKILL-004：上传失败，分析模板文件超过 100 KB
含义：单个 skill 文件大小限制 100 KB（内置 skill 才 1.6 KB，正常远不会触发）。
解决步骤：
- 检查文件是否被错误塞了不必要内容（例如整段会议记录、大量样本对话）
- 删掉冗余示例后再上传
SKILL-005：操作失败，未找到分析模板
含义：删除或读取不存在的 skill。通常不会被用户看到——UI 已经隐藏了不存在的 skill 选项。
解决步骤：
- 重新加载设置页（点别的 section 再回来）
- 仍出现 → 联系 hello@talktrack.cn
SKILL-006：操作失败，无法删除内置分析模板
含义：试图删除 meeting-review 等内置 skill。有保护，不会删成功。
解决步骤：
不需要解决——内置 skill 是 app 自带，永远存在。如果你不想用它，上传一个自定义 skill 并设为默认即可。
UNK-000 · 未分类
如果你看到 UNK-000，意味着这条错误暂未归入分类——TalkTrack 在迭代中会逐步识别并归类。
你能做什么：
- 点错误下方的 「复制」 按钮
- 把内容邮件发给 hello@talktrack.cn
- 我们会在下个版本里给这个错误一个专属错误码
你的反馈直接帮我们优化文档——比起一个静默失败，能复制具体内容的报错信息对我们价值大得多。
还是没解决？
发邮件到 hello@talktrack.cn，附：
- 完整错误信息（直接点错误下方「复制」按钮粘贴）
- 你的 macOS 版本（点苹果图标 → 关于本机）
- TalkTrack 版本（设置页底部）
- 怎么操作可以重现这个问题（最重要！）
工作日 24 小时内一定回。