常见问题解答 (FAQ)

Saber Translator 的常见问题解答页面。在寻求帮助之前，建议先在这里查找是否已经有对应答案。

---

一、安装与运行

Q1: 我应该下载哪个文件？整合包和源代码有什么区别？

A1:

• 源代码（Source code）：更适合愿意自己配置环境的用户
  • 优点：更新更快、占用空间更小、可自定义程度更高
  • 要求：需要自行安装 Python、依赖和相关模型
• 整合包：更适合普通用户
  • 优点：解压即可使用
  • 缺点：更新通常需要重新下载完整包

Q2: 程序双击后闪退，或者只出现黑色命令行窗口，但浏览器没有打开，怎么办？

A2: 这通常由以下原因造成：

1. 运行路径包含中文
2. 文件解压不完整，或被杀毒软件误删
3. 默认端口被其他程序占用
4. 首次启动还在加载模型，需要再等一会儿

建议优先检查：

• 路径是否为纯英文
• 程序目录是否完整
• logs/ 目录中的最新日志

Q3: 启动很慢，正常吗？

A3: 正常。首次启动或长时间未使用后再次启动时，程序需要加载多个模型到内存或显存中，例如检测模型、OCR、修复模型等，启动速度会明显慢一些。

---

二、基本功能

Q4: 源语言选择英文、韩文等非日文语言时无法翻译，翻译结束后图片中没有嵌入任何文字

A4: 这种情况通常与 OCR 初始化异常有关，最常见原因仍然是运行路径包含中文。请把程序移动到纯英文路径后再试。

Q5: 开始翻译后报错“缺少必要的参数”

A5: 这通常表示模型配置没有填完整。请先参考模型服务配置，把当前要使用的服务商、API Key 和模型名称填写完整。

Q6: 报错 “AuthenticationError / Invalid token / 401 / BadRequestError” 一类错误

A6: 一般优先检查：

1. API Key 是否填错
2. 模型名称是否与当前服务商匹配
3. 自定义 Base URL 是否填错

例如：

• 选择 DeepSeek 服务商时，应填写 DeepSeek 自己支持的模型名
• 选择 SiliconFlow 服务商时，应填写 SiliconFlow 侧的模型名

Q7: 翻译完成后除了译文，还出现了很多模型思考过程

A7: 这通常说明您使用了推理模型，或者没有正确关闭相关思考输出。最稳妥的做法是改用更适合翻译的非推理模型。

Q8: 在图片之间快速来回切换后，主图和缩略图不一致，或者把某一张图的翻译嵌到了另一张图上

A8: 这类问题通常与高频切换过程中的重渲染冲突有关。建议在切换页面时稍等当前渲染完成，不要在短时间内连续快速切换多张图。

Q9: 使用 AI 视觉 OCR、高质量翻译或 AI 校对时报错 “The model is not a VLM”

A9: 这说明当前模型不支持图片输入。AI 视觉 OCR、高质量翻译、AI 校对都需要使用支持视觉能力的多模态模型。

Q10: 高质量翻译和 AI 校对时报错 “thinking is not supported by this model...”

A10: 这说明当前模型不支持“取消思考”或相关 Thinking 参数。请关闭对应选项后再试。

Q11: 支持哪些图片格式？可以处理整个文件夹吗？

A11: 支持常见图片格式，例如 JPG、PNG、WebP 等，也支持 PDF、MOBI、AZW、AZW3。您可以一次选择多张图片或多个文件批量导入。

Q12: 为什么翻译结果不准确或不通顺？

A12: 建议按这个顺序排查：

1. OCR 是否识别正确
2. 检测框是否合理
3. 模型是否适合当前任务
4. 提示词和术语约束是否合适

如果是重要作品，推荐：

• 先整理术语表/禁翻表
• 再尝试高质量翻译
• 最后用AI 校对继续打磨

Q13: 如何保存我翻译好的图片？

A13: 常见方式有两种：

• 单张保存：对当前图片另存为
• 批量导出：使用“下载所有图片”，导出为 ZIP、PDF 或 CBZ

Q14: 什么是“仅消除文字”功能？它和翻译有什么区别？

A14: “仅消除文字”会执行检测、OCR 和背景修复，但跳过翻译和文字渲染。最终得到的是一张去除了原文的无字图，适合后续自己手动嵌字。

Q15: 什么是会话？

A15: 会话可以理解为一个完整的章节工作进度，通常包含：

• 已加载的图片
• 翻译结果
• 检测框
• 编辑样式
• 当前设置

从书架章节进入翻译后，可以保存并在下次继续加载。

Q16: 快速翻译模式和书架模式有什么区别？

A16:

• 快速翻译模式：直接上传图片，适合临时处理
• 书架模式：从书架章节进入，适合正式项目

书架模式的额外优势：

• 可保存和恢复章节进度
• 可使用术语表/禁翻表
• 更适合长篇、连载和后续维护

Q17: 为什么我看不到术语表/禁翻表入口？

A17: 最常见原因是您当前不在书架模式。请先在书架系统中创建书籍和章节，再从章节进入翻译页面，左侧栏才会出现“书籍约束”区域。

Q18: 高质量翻译模式和 AI 校对模式分别适合什么时候用？

A18:

• 高质量翻译模式：适合做高质量初稿，尤其适合复杂场景、多角色对话和需要结合画面理解的页面
• AI 校对模式：适合在已有译文基础上继续润色、纠错和统一风格

简单理解：

• 没有初稿时先用高质量翻译
• 已有初稿但还想继续打磨时用 AI 校对

Q19: 我可以把翻译文本导出去用别的软件校对吗？

A19: 可以。程序支持导出和导入结构化翻译文本。您可以把文本整理后再导回，让当前图片重新使用更新后的译文。

---

三、配置与扩展

Q20: 我可以在哪里获取 API Key？

A20: 您需要前往对应服务商官网注册并创建 API Key。详细步骤请参考如何获取 API Key。

Q21: 我想用自己的字体，怎么办？

A21: 在文字设置中的字体选择区域，可上传本地字体文件（如 .ttf、.ttc、.otf）。上传成功后即可在字体列表中使用。

Q22: 插件系统在哪里打开？

A22: 插件系统入口在翻译页顶部的设置窗口中，进入“插件管理”页签即可看到插件列表、启用禁用、刷新、配置、导入导出等功能。详细说明请参考插件系统。

Q23: 自动生成插件前需要先做什么准备？

A23: 建议至少先准备好以下内容：

1. 明确您想让插件做什么
2. 在插件管理中打开“自动生成插件”
3. 先配置好插件 Agent所需的模型服务
4. 生成后先检查结果，再刷新插件列表并测试

如果只是普通用户，不需要一次把需求写得特别复杂，先从简单插件开始更稳。

---

四、故障排除

Q24: 翻译失败时应该先检查什么？

A24: 优先检查：

1. API Key 是否正确
2. 模型名称是否与服务商匹配
3. 当前模型是否具备对应能力
4. 网络或额度是否正常

Q25: 检测不到气泡怎么办？

A25: 建议按顺序尝试：

1. 切换检测器
2. 调整检测阈值
3. 开启辅助 YSGYolo 检测
4. 开启 SaberYOLO 二阶段纠错
5. 在编辑模式中手动补框

Q26: LAMA 修复效果不好怎么办？

A26: 可以尝试：

1. 启用精确掩膜
2. 调整掩膜膨胀大小
3. 在编辑模式中使用“修复”按钮重做局部区域
4. 使用修复笔刷和还原笔刷手动微调

Q27: 文字显示不全怎么办？

A27: 常见处理方式：

1. 减小字号
2. 调整排版方向
3. 扩大气泡框
4. 调整文本框扩展参数

---

五、数据管理

Q28: 如何保存翻译进度？

A28:

1. 先在书架系统中创建书籍和章节
2. 从章节进入翻译页面
3. 在翻译过程中点击保存按钮

注意

直接上传图片的快速翻译模式不适合作为正式保存进度的方式。

Q29: 如何迁移数据？

A29: 一般只需复制整个 data 目录，即可带走书架、章节、会话和相关结果。

Q30: 如何备份数据？

A30: 最简单的方式是定期备份整个 data 目录。

---

六、其他问题

Q31: 如何更新版本？

A31: 常见做法是：

1. 先备份 data 目录
2. 下载或拉取最新版本
3. 再把 data 目录放回新版本中

Q32: 漫画续写为什么提示缺少分析数据，无法直接开始？

A32: 因为漫画续写依赖已有分析结果来理解原作剧情、角色关系和故事上下文。通常需要先完成足够完整的漫画分析，必要时还要补齐续写所需的生图模型配置。

Q33: 角色工坊和漫画分析里的角色摘要有什么区别？

A33: 漫画分析里的角色摘要更偏“看结果”，而角色工坊更偏“做资料”。角色工坊适合把角色整理成可编辑、可导出、可长期维护的角色文档。

Q34: 如何提交问题反馈？

A34: 建议在 GitHub Issues 提交，并尽量附上：

1. 操作系统和版本信息
2. 错误截图或日志
3. 复现步骤
4. 当前使用的服务商、模型和相关配置