|
15 | 15 |
|
16 | 16 | ### 🌍 多语言支持 |
17 | 17 |
|
18 | | -支持18种目标语言,按优先级分组: |
| 18 | +- 目标语言从 `Localization-Resource-Pack/languages.json` 动态加载。默认包含 19 种语言(含 `zh_cn`)。 |
| 19 | +- 如需增删语言,请编辑 `Localization-Resource-Pack/languages.json` 并提交 PR;本地运行直接修改该文件即可。 |
19 | 20 |
|
20 | | -#### 第一优先级(强烈推荐) |
| 21 | +当前默认语言: |
21 | 22 |
|
22 | 23 | - `en_us` - English (US) |
23 | 24 | - `pt_br` - Portuguese (Brazil) |
24 | 25 | - `ru_ru` - Russian |
25 | 26 | - `de_de` - German |
26 | | - |
27 | | -#### 第二优先级(推荐) |
28 | | - |
29 | 27 | - `es_es` - Spanish (Spain) |
30 | 28 | - `es_mx` - Spanish (Mexico) |
31 | 29 | - `fr_fr` - French (France) |
32 | 30 | - `fr_ca` - French (Canada) |
33 | 31 | - `tr_tr` - Turkish |
34 | 32 | - `ja_jp` - Japanese |
35 | 33 | - `ko_kr` - Korean |
36 | | - |
37 | | -#### 第三优先级(可选) |
38 | | - |
39 | 34 | - `pl_pl` - Polish |
40 | 35 | - `nl_nl` - Dutch |
41 | 36 | - `it_it` - Italian |
42 | 37 | - `id_id` - Indonesian |
43 | 38 | - `vi_vn` - Vietnamese |
44 | 39 | - `zh_tw` - Traditional Chinese (Taiwan) |
45 | 40 | - `zh_hk` - Traditional Chinese (Hong Kong) |
| 41 | +- `zh_cn` - Simplified Chinese (China) |
46 | 42 |
|
47 | 43 | ### 🔍 质量保证 |
48 | 44 |
|
|
51 | 47 | - **智能重试机制** - 区分API失败和验证失败,各自独立重试(最多10次),并结合温度调整和思考模式切换策略,确保翻译成功率。 |
52 | 48 | - **详细日志记录** - 记录翻译失败的详细信息、错误原因、模型、温度、命名空间和目标语言。 |
53 | 49 |
|
| 50 | +### ⚙️ 并发与重试优化 |
| 51 | + |
| 52 | +- **并发批处理** - 使用线程池并发执行请求,默认每批 `40` 个键;超出将自动分批并保留上下文片段以提高一致性。 |
| 53 | +- **独立重试计数** - 对 API 失败与验证失败分别计数,单类失败最多重试 `10` 次,失败总览会在日志中汇总显示。 |
| 54 | +- **自适应温度与模式** - 验证失败前 `1–5` 次按温度序列 `[1.3, 1.3, 1.2, 1.0, 0.7]` 保持当前模式;之后按同温度序列交替切换思考/非思考模式,帮助稳定结果。 |
| 55 | +- **进度与批次日志** - 输出批次规模与总进度,失败时记录尝试次数、失败类型与等待回退时间。 |
| 56 | + |
54 | 57 | ### ⚡ 自动化工作流 |
55 | 58 |
|
56 | 59 | - **智能触发** - 监听源文件变更自动执行翻译 |
@@ -134,6 +137,8 @@ python .github/scripts/translate.py |
134 | 137 | - `DEEPSEEK_API_KEY` - DeepSeek API密钥(在GitHub Secrets中配置) |
135 | 138 | - `FORCE_TRANSLATE` - 强制重新翻译所有文件(可选,默认为false) |
136 | 139 | - `NON_THINKING_MODE` - 使用非思考模式翻译(可选,默认为false) |
| 140 | +- `TRANSLATION_DEBUG` - 开启详细请求/响应记录(可选,默认为false) |
| 141 | +- `GITHUB_ACTIONS` - CI环境标识,启用日志分组与提示格式(自动) |
137 | 142 |
|
138 | 143 | ### 提示词模板变量 |
139 | 144 |
|
@@ -168,14 +173,16 @@ python .github/scripts/translate.py |
168 | 173 | ### 日志查看 |
169 | 174 |
|
170 | 175 | - **GitHub Actions日志** - 查看工作流运行的详细过程 |
171 | | -- **本地日志文件** - 翻译失败时在 `logs/` 目录生成详细日志 |
| 176 | +- **本地主日志** - 在仓库根目录生成 `translation.log` |
| 177 | +- **详细失败日志** - 在 `.github/scripts/logs/` 目录生成失败明细于 `error_summary.log` |
172 | 178 |
|
173 | 179 | ## 📈 更新历史 |
174 | 180 |
|
175 | 181 | - **v1.4** - 添加质量保证功能:占位符验证、JSON完整性检查、重试机制 |
176 | 182 | - **v1.5** - 支持DeepSeek-V3.2-Exp双模式,添加非思考模式选项 |
177 | 183 | - **v1.6** - 优化工作流,移除冗余步骤,完善日志系统 |
178 | 184 | - **v1.7** - 优化重试机制(独立计数、智能调整)、完善日志记录(模型、温度、命名空间、目标语言)、优化提示词。 |
| 185 | +- **v1.8** - 新增环境变量(`TRANSLATION_DEBUG`、改进 `FORCE_TRANSLATE` 行为)、完善并发批处理与自适应重试(API/验证各自最多10次),目标语言包含 `zh_cn`,缺失/清理逻辑以 `translate/` 为准并在构建时与 `assets/` 合并。 |
179 | 186 |
|
180 | 187 | ## 🤝 贡献指南 |
181 | 188 |
|
|
0 commit comments