故障排除
按症状分类的故障排除指南。如果以下方法无法解决问题，请收集日志文件联系技术支持。
插件在 Trados 中不显示
可能原因
- 插件未正确安装或版本不匹配
- 未在「文件」视图中查看（插件工具栏仅在文件视图显示）
- Trados Studio 缓存未刷新
解决步骤
- 确认下载的插件版本与 Trados 版本匹配
- 切换到「文件」视图查看
- 完全关闭 Trados Studio（检查任务管理器确保进程已退出），重新启动
- 检查
%AppData%\Trados\Trados Studio\17\Plugins\Packages\目录下是否有 AIHub 相关文件 - 如仍不显示，卸载后重新安装
服务器连接失败（测试连接不通过）
可能原因
- API 地址拼写错误
- API 密钥无效或已过期
- 网络无法访问 API 服务器（防火墙/代理阻断）
- 模型名称填写错误
解决步骤
- 检查端点地址格式是否正确（如
https://api.deepseek.com/v1） - 确认 API 密钥是否有余额、未过期
- 用浏览器或 curl 测试 API 是否可达
- 检查代理设置：如有代理需在系统网络设置中配置
- 确认模型名称与 API 文档中的一致
- 尝试增加超时时间（如从 120 秒增加到 300 秒）
翻译过程中频繁超时或报错
可能原因
- 并发数过高，服务器处理不过来
- 超时时间太短
- 上下文窗口太大，单次请求内容过多
- 网络不稳定
解决步骤
- 降低并发数（建议先从 5 开始测试，稳定后再提高）
- 增加超时时间（180 ~ 300 秒）
- 减小上下文合并大小（如将字符数从 1000 降到 500）
- 切换到「单句并行」模式测试是否稳定
- 检查网络连接，切换 VPN 或更换网络环境
翻译结果为空或格式异常
可能原因
- API 返回格式不符合解析器预期
- 提示词模板导致模型输出格式异常
- 响应被截断（Token 限制）
解决步骤
- 在翻译日志中查看原始 API 响应内容
- 尝试增大「最大 Token」参数
- 检查提示词模板是否包含格式要求（如 "返回 JSON 数组"）
- 恢复使用默认提示词模板测试
- 降低温度参数减少输出变化
翻译向导秒完成，已翻译句段数为 0
可能原因
- 文件全部是已翻译句段，被排除规则过滤
- 文件内句段全部为空（如 .xlf.sdlxliff 格式的文件在 v3.3.7 及更早版本中可能无法正确提取句段）
解决步骤
- 检查排除设置——是否误勾选了"未翻译"
- 在 Trados 编辑器中确认文件是否有可翻译的句段原文
- 如使用的是 .xlf.sdlxliff 格式文件，确保插件版本 >= v3.3.8（早期版本对特定扩展名存在兼容性问题）
注册失败或许可证异常
可能原因
- 机器码与注册码不匹配
- 注册信息文件损坏
- 网络时间无法获取（影响试用期计算）
- 注册已过期
解决步骤
- 确认机器码是否正确复制发送给开发者
- 确认注册码没有被截断或包含错误字符
- 检查网络连接，确保 NTP 时间同步正常
- 尝试删除
C:\AIHub\reg.dat，重新注册 - 检查系统时间是否正确（与互联网时间一致）
数据库异常或初始化失败
可能原因
- 数据库文件损坏
C:\AIHub\目录权限不足- 磁盘空间不足
解决步骤
- 关闭 Trados Studio
- 备份
C:\AIHub\AIHubData.db文件（如果可以访问） - 删除
C:\AIHub\AIHubData.db - 重启 Trados Studio，插件会自动重建数据库
- 如有备份，通过设置→数据库页面恢复数据
- 检查
C:\AIHub\目录的写入权限
注意
删除数据库会丢失服务器节点配置、提示词模板和术语库。操作前请确保有备份。
翻译后标签丢失或格式错乱
可能原因
- 未启用纯文本模式
- 标签恢复失败（AI 输出中缺少标签占位符）
- 标签类型特殊，恢复机制不支持
解决步骤
- 确认已开启「纯文本模式」
- 降低温度参数以减少 AI 输出变化
- 使用「多句并行」模式替代「单句并行」
- 在提示词中要求 AI 保留占位符（如 "保留所有 {...} 格式的标记"）
如何获取技术支持
如果以上方法无法解决问题，请准备以下信息联系我们：
- AIHub 插件版本号（在设置 → 关于中查看）
- Trados Studio 版本号
- 操作系统版本
- 日志文件（位于
C:\AIHub\logs\） - 问题复现步骤和截图
QQ 群：1032374012 ｜ 邮箱：viu@qq.com ｜ 官网：plugins.m3loc.com