排障参考
执行自动化操作后报错
Section titled “执行自动化操作后报错”展开全局任务浮窗查看完整错误。
失败任务可以普通重试。仍处于运行或排队状态但长时间没有进展时,使用 强制重试。
请阅读具体的错误信息,然后查看以下排障信息。
如果无法解决,请联系开发人员。
这通常表示网络不稳定,或供应商服务暂时不可用。可以尝试:
- 检查网络连接是否稳定
- 稍后再试
错误 401
Section titled “错误 401”错误信息类似:
API returned status 401: {"error":{"message":"Authentication Fails, Your api key: ****u2sd is invalid","type":"authentication_error","param":null,"code":"invalid_request_error"}}说明您提供的 API Key 无效,请检查:
- API Key 是否完整复制,没有多余空格
- 供应商和 API URL 是否匹配
错误 429
Section titled “错误 429”这通常表示供应商限流或并发过高。可以尝试:
- 尝试手动再次运行缺失项
- 修改速率限制设置(请参考供应商文档)
- 降低并发数
- 增加请求间隔
不建议直接选择全部重跑,这样可能会让情况更糟糕,可能会进一步触发供应商限流。
错误 400
Section titled “错误 400”表示API的请求有误,原因多种多样,需要看错误内容具体分析。
如果错误信息类似:
API returned status 400: {"error":{"message":"The supported API model names are deepseek-v4-pro or deepseek-v4-flash, but you passed deepseek-v4-pro1111.","type":"invalid_request_error","param":null,"code":"invalid_request_error"}}说明模型的标识符错误,请检查:
- 请检查标识符是否输入错误,请使用供应商提供的标识符而不是模型显示名称
- 供应商有可能删除了过时的模型,请尝试换用其他模型
如果错误信息类似:
API returned status 400: {"error":{"message":"Failed to deserialize the JSON body into the target type: messages[0]: unknown variant `image_url`, expected `text` at line 1 column 3061412","type":"invalid_request_error","param":null,"code":"invalid_request_error"}}可能是配置服务时,为模型指定了不正确的“模型能力”,例如:
- 为非视觉模型指定了视觉相关的任务
提示“Expected X translations but got Y”
Section titled “提示“Expected X translations but got Y””比如:
Expected 6 translations but got 7. The Al likely returned malformed content, pleasetry again.说明模型没有按照系统提示词逐条给出翻译,您可以:
- 修改模型配置,调高思考强度
- 改用其他模型
- 过一阵子再尝试相同模型
如果频发,通常意味着模型能力不胜任此任务,其遵循指令的能力不足
「选择供应商」界面中,加载失败
Section titled “「选择供应商」界面中,加载失败”可能您的网络有问题,请检查你的设备是否能连接到猫译员的主站
实在无法解决网络连接的问题,您也可以使用「手动添加」模式来新增您期望使用的供应商的配置。
文本块没检测出来,或者原文没有提取出来
Section titled “文本块没检测出来,或者原文没有提取出来”- 请确认源语言是否设置正确
- 检查原图是否清晰,文字是否过小、倾斜、遮挡或与背景融合
- 可以尝试使用不同的检测服务
- 一些难以识别的文字,如手写字、拟声词、装饰字体容易识别错误,您可以手动新增文本块,并人工输入原文
翻译按钮不可用
Section titled “翻译按钮不可用”翻译至少需要一个有原文的文本块,并且需要配置了 翻译 能力的模型。
若原文为空,请先运行文字提取或手动输入原文。
翻译错误如何排查
Section titled “翻译错误如何排查”请按如下顺序排查
- 先检查文本块的框选范围
- 检查提取出的原文文本是否正确,不正确请重新识别(如改用能力更强的视觉模型)或手动录入
- 尝试删除图片摘要信息再翻译,图片摘要信息可能提取错误,误导了翻译的模型
- 尝试改用能力更强的模型
导入 ZIP 时文件名乱码
Section titled “导入 ZIP 时文件名乱码”如果应用提示选择文件名编码,请切换编码并检查名称预览,确认名称正常且没有解码错误或重名后再继续。
工作区打开失败
Section titled “工作区打开失败”工作区打开失败时,界面上会提供的排查步骤,请先根据提示的步骤自行排查。
若仍无法解决,请联系开发人员获得帮助。
本地模型下载或导入失败
Section titled “本地模型下载或导入失败”- 检查磁盘空间和网络
- 导入 ZIP 失败、Hash 校验失败表示压缩包可能不完整、或者被篡改