#功能说明

本工具专为多语言本地化场景打造，集成了批量处理、高性能缓存、智能上下文处理、多语言导出等能力，帮助您构建高效、稳定的翻译工作流。

#核心特性

#多语言翻译：一次翻译，输出多语种

你可以将同一个文件同时翻译为多种语言，适合多语种字幕或国际化项目：

• 示例：将英文字幕翻译为中文、日语、德语、法语等
• 当前支持 70+ 种语言，后续将持续增加

#高性能翻译缓存

工具内置了企业级的即时缓存系统，底层由 IndexedDB 数据库驱动：

• 无限容量：突破了浏览器 LocalStorage 的存储限制，支持保存数百万条翻译记录，不占用内存资源。
• 持久化存储：翻译结果永久保存，刷新或关闭浏览器不丢失。
• 智能命中：基于 源文本_目标语言_源语言_翻译 API_模型设置 生成唯一 key。参数一致时直接调用缓存，实现"一次翻译，永久秒开"。
• 按需管理：支持特定场景（如调试 Prompt）手动禁用缓存，或在设置中一键清理。

#智能并发与长文本优化

针对长文档和批量任务，工具重构了任务调度引擎：

• 并发控制：内置请求队列机制，支持自定义翻译速率。既能全速跑满付费 API 的额度，也能通过限流保护免费接口不被封禁。
• 大文件支持：采用流式处理与分块策略，轻松应对超大文档，且支持编辑框内的大文本并发渲染。
• 上下文感知：在字幕或文档翻译中，智能切分上下文窗口，确保 LLM 理解剧情连贯性，提升翻译准确度。

---

#翻译模式与工作流

工具会自动识别用户行为并切换模式：

• 批量模式（默认）：拖拽多个文件上传，自动进入队列处理，翻译完成后自动打包下载。
• 单文件模式：上传单个文件或粘贴文本，支持实时预览对照、逐行校对修改。

补充：如果当前工具支持，你也可以在高级设置中手动切换“单文件模式”，用于强制进入适合校对/预览的工作流。

#翻译后处理

支持在翻译完成后自动执行文本清理，结果将同步应用到所有输出文件：

• 字符过滤：自动移除无关符号（如字幕中的 ♪ ♫ 音乐符）。
• 格式修正：统一标点风格或移除特定的 HTML 杂讯。

#高级设置

#设置导入/导出

支持一键备份当前的所有配置（含 API Key、Prompt 设置），生成的配置文件可跨设备导入，便于团队协作或环境迁移。

#通用翻译选项

• 使用缓存（Use Cache）：默认启用。参数一致时直接命中 IndexedDB 缓存，显著加速批量任务；在调试 Prompt/模型设置时也可临时关闭。
• 重试次数（Retry Count）：当请求失败时的最大重试次数（建议在网络不稳定或免费接口易限流时适当提高）。
• 超时（Retry Timeout）：单次请求的超时阈值（单位：秒）。当接口响应慢或长文本较多时可适当增大。
• 翻译后移除字符：输入需要在结果中自动移除的字符或片段（例如字幕里的 ♪，或多余的 HTML 片段如 <i>）。
• 自定义导出文件名：用于批量导出/下载时统一命名，支持占位符：{name}（原文件名，不含扩展名）、{lang}（目标语言）、{ext}（扩展名）、{date}（日期，YYYY-MM-DD）、{time}（时间，HHMMSS）。示例：{name}_{lang}_{date}_{time}.{ext}。

#API 参数调优

为了平衡翻译质量与速度，建议根据所选 API 类型调整以下参数：

#分块大小

对于非 LLM 接口（如 Google/Azure API），工具会将长文本切分为小块。分块大小即指每个打包块的字符数上限。以下是常见接口的最大字符限制：

⚠️ 注意：Google Translate 网页版可能破坏换行符，因此未使用分块翻译方式。

#延迟时间 (ms)

分块请求之间的冷却时间，有助于避免频繁请求失败：

• 建议在网络较差或使用免费 API时设置更高延迟
• 例如：使用 Azure Translate 免费接口时，建议设置为 5000ms 以上

#并发行数

• 默认值：20
• 说明：同时能翻译的最大行数。
• 注意：数值设置过高可能导致 API 速率限制 (Rate Limiting) 或返回空结果。

#上下文行数

• 默认值：50
• 说明：上下文关联翻译模式下，每一批次包含的行数。
• 注意：数值越高提供的上下文越丰富，但可能超出模型的 Token 上下文限制。