翻译失败的排查需要按照“网络环境→翻译模式→配额余额→API状态→内容格式”的顺序逐层推进。桌面端本地翻译最常见的问题是外网不通或代理配置不正确，用户应首先检查电脑能否访问Google网页，再将代理切换到全局模式并更换节点测试。平台内置翻译的失败通常是配额不足，用户应查看账户中的积分余额并确认是否需要购买额外字符。绑定API后的失败需要登录对应的API平台后台检查密钥有效性和额度剩余情况，DeepL用户应特别注意免费版密钥在SaleSmartly中可能无法使用，需要升级到付费版API。通过分步骤的系统化排查，大多数翻译失败问题都可以定位原因并找到对应的解决方法。
检查网络环境是否为外网状态
桌面端本地翻译需要外网才能工作
当SaleSmartly桌面客户端的本地免费翻译出现失败时，首先要排查的就是电脑的网络环境。官方帮助文档明确指出，本地翻译功能“需要在外网环境下，才可正常翻译”，因为本地翻译的本质是调用用户的外网去请求翻译服务器，如果外网不通则翻译必然失败。用户可以通过在电脑浏览器中尝试打开Google网页来快速判断网络是否正常，如果无法打开Google网页说明本地网络不满足本地翻译的使用条件，需要先解决外网访问问题再尝试翻译。
科学上网已开启但翻译仍失败的原因
即使用户在电脑上开启了科学上网工具，但如果代理配置不正确，本地翻译同样会失败。大多数科学上网工具默认使用规则模式，只对浏览器访问网页的流量进行代理转发，SaleSmartly桌面客户端的翻译请求是非浏览器的API调用，可能未被规则模式覆盖。用户需要将代理软件切换到全局模式，确保电脑上所有应用的网络请求都通过代理通道转发，然后重启客户端再进行翻译测试。
切换外网节点或翻译线路恢复翻译
如果全局模式开启后翻译仍然失败，可能是当前使用的代理节点本身存在问题，该节点的IP地址可能被翻译服务器限制或封禁。用户可以尝试在代理软件中切换到其他可用节点，更换后重启客户端让新的网络配置生效。此外SaleSmartly桌面客户端左上角提供了切换翻译线路的选项，用户可以在代理配置无误后切换翻译线路并重新登录客户端来恢复翻译功能。
确认本地翻译功能是否已正确开启
检查桌面客户端本地翻译开关状态
桌面端本地免费翻译功能需要用户在电脑状态栏中找到SaleSmartly图标，右键点击并选择开启本地翻译才能生效。如果用户没有手动开启本地翻译开关，系统会默认使用平台内置的在线翻译服务而非本地翻译模式，此时翻译会正常消耗账户中的配额但不会因为网络问题而失败。用户需要确认本地翻译开关确实处于开启状态，如果开关未开启但翻译失败，问题在于配额是否充足而非网络环境。
本地翻译开启后翻译仍失败的排查
如果本地翻译开关已经开启但翻译仍然失败，可以尝试关闭本地翻译后重新开启，让系统重新加载本地翻译的网络配置。关闭本地翻译后系统会自动恢复使用平台内置翻译，如果此时翻译恢复正常但消耗了账户配额，说明本地翻译的网络通道确实存在问题。重新开启本地翻译后再次测试，如果仍然失败则继续排查网络环境或代理配置。
切换翻译模式对比测试
为了更准确地定位问题，用户可以进行翻译模式切换的对比测试。先关闭本地翻译使用平台内置翻译测试是否正常，如果平台内置翻译正常工作说明SaleSmartly系统功能正常，问题出在本地翻译的网络通道上。反之如果平台内置翻译也失败，说明可能是系统、账户或配额层面的问题而非网络问题。通过对比测试可以将问题范围缩小到具体环节。
查看账户翻译配额是否充足
免费版套餐积分用尽导致翻译失败
免费版套餐每月自带1万AI助理积分用于翻译和AI功能，如果当月的积分已经用完，用户使用平台内置翻译时会因为配额不足而失败。用户可以在系统中查看当前的积分余额，如果积分为零且未绑定第三方API或未开启本地翻译，翻译功能会暂停。解决方案包括等待下个月1号积分重置、开启桌面端本地翻译（电脑端）、绑定DeepL API使用免费额度、购买额外翻译字符套餐或升级到Pro版获得更多月度配额。
Pro版和Max版月度额度用尽的影响
Pro版每月10万积分和Max版每月100万积分同样存在用尽的情况。当月度积分用完后，使用平台内置翻译会失败，解决方法与免费版类似：等待下月重置、开启桌面本地翻译、绑定第三方API或购买额外字符套餐。对于Pro和Max版用户来说，购买额外字符套餐是积分耗尽时维持翻译服务连续性的最直接方式，购买的字符套餐无使用期限且全设备通用。
绑定API后API额度耗尽导致失败
如果用户绑定了DeepL API等第三方翻译服务，翻译失败可能是第三方平台的月度免费额度已经用完。DeepL每月提供50万字符免费额度，额度用完后继续使用DeepL翻译会出现失败。用户需要登录DeepL后台查看当前剩余额度，确认是否已到限额。解决方案包括等待下月额度重置、在SaleSmartly中切换到另一个仍有剩余额度的翻译API、切换到平台内置翻译消耗积分或购买额外字符。
检查API密钥是否有效或已过期
API密钥被停用或过期导致翻译失败
绑定的DeepL API密钥如果因为账号异常、订阅到期或用户在DeepL后台手动删除而失效，SaleSmartly在调用该API翻译时会返回错误。用户需要登录DeepL官网后台检查当前API密钥的状态，确认密钥是否仍然处于有效且激活的状态。如果密钥已经被删除或停用，用户需要重新生成新的API密钥并更新到SaleSmartly后台的翻译设置中。
API密钥余额不足导致调用被拒绝
对于DeepL付费版API密钥，如果用户的账户余额不足或信用卡支付失败，DeepL可能会暂停API服务直到用户完成支付。此时SaleSmartly调用DeepL翻译会失败，用户需要登录DeepL后台检查账户的支付状态和余额情况，完成欠费支付后API服务会自动恢复。定期检查DeepL后台的账单和支付状态可以避免因为余额问题导致翻译功能突然中断。
免费版API密钥被平台限制的排查
DeepL已经限制了SaleSmartly服务器IP地址使用免费版（以:fx结尾）密钥。如果用户尝试在SaleSmartly中使用免费版密钥，可能会遇到“翻译工具安装失败”的提示。用户可以通过将该API密钥放到第三方翻译服务如沉浸式翻译中测试，如果在第三方中验证通过但在SaleSmartly中不通过，说明DeepL确实限制了SaleSmartly的IP使用免费密钥。这种情况下只能更换为付费版API密钥或使用其他翻译服务。
检查翻译内容或格式是否异常
空内容或纯特殊符号导致翻译失败
如果客户发送的消息内容为空、仅包含表情符号或仅包含特殊符号而没有实质文字内容，翻译功能无法正常处理这类非文字内容。SaleSmartly的翻译功能仅能处理文字内容的语言转换，对于纯表情符号、纯图片或空消息，翻译请求会被系统拒绝或返回空结果。用户需要确认待翻译的内容确实包含有效的文字信息后再进行翻译操作。
翻译内容超过单次请求长度限制
Google和DeepL的翻译API对单次翻译请求都有字符长度限制，如果待翻译的客户消息内容过长，超过了API的单次最大处理长度，翻译请求会被API拒绝并返回错误。SaleSmartly系统通常会在发送请求前对内容进行分段处理，但在某些情况下大段的长文本仍然可能触发API的长度限制。用户可以尝试将长文本分成多个较短的部分分段翻译，而不是一次性翻译全部内容。
非文字消息无法翻译
翻译功能仅能处理文字内容的翻译，如果客户发送的是纯图片、语音消息、视频文件或文档附件，翻译功能无法对这些非文字内容进行处理。用户需要先通过其他方式获取文字内容——如果是图片可以提取图片中的文字后再进行翻译，如果是语音消息可以使用SaleSmartly的语音转录功能转换成文字后再翻译。本地翻译和API翻译都不支持非文字内容的语言转换。
常见问题FAQ
本地翻译失败了但平台内置翻译正常是什么原因？
说明问题出在本地翻译的网络通道而非SaleSmartly系统功能本身。用户需要检查电脑的外网环境是否正常、代理软件是否切换到全局模式、以及是否可以从本地网络访问Google服务。如果确认外网正常但本地翻译仍失败，可以尝试切换翻译线路后重新登录客户端。
翻译失败会扣除我的翻译配额吗？
不会。无论使用本地翻译还是平台内置翻译，只有翻译请求成功完成的情况下才会扣除对应的配额或字符。如果翻译请求失败（网络超时、API错误、内容异常等），系统不会从账户中扣除任何字符额度或积分。
多条消息中只有部分翻译失败是什么原因？
可能是网络波动导致部分翻译请求超时，或者某条消息的内容格式异常触发了API的限制。用户可以单独对失败的消息重新点击翻译按钮再试一次，如果重试成功说明是临时性的网络波动所致。如果某条消息反复翻译都失败，可以检查该消息的内容是否包含特殊字符或过长。