Skip to content

Commit 0067403

Browse files
committed
docs: update desktop UI navigation references
1 parent 28c9604 commit 0067403

12 files changed

Lines changed: 122 additions & 99 deletions

README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -356,7 +356,7 @@ python -m manga_translator --help
356356

357357
### 翻译效果不理想
358358

359-
1. 在"基础设置"中勾选 **详细日志**
359+
1. 在"设置" -> "通用"中勾选 **详细日志**
360360
2. 查看 `result/` 目录中的调试文件
361361
3. 调整检测器和 OCR 参数
362362
4. 排查完成后按文档清理旧日志(避免 `result/` 目录过大)

doc/API_CONFIG.md

Lines changed: 11 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -122,8 +122,8 @@ OpenAI 翻译器**几乎支持市面上所有模型**,因为几乎所有的 AI
122122
### 3. 配置到程序中
123123

124124
1. 打开程序
125-
2. 在"基础设置"→"翻译器"中选择"OpenAI"
126-
3. 在"高级设置"中填写:
125+
2. 在"设置" -> "翻译"中将"翻译器"设为"OpenAI"
126+
3. 在"API 管理" -> "翻译"中填写:
127127
- **API Key**:你的硅基流动 API Key
128128
- **Base URL**`https://api.siliconflow.cn/v1`
129129
- **模型**:在 [模型广场](https://cloud.siliconflow.cn/models) 查看所有可用模型
@@ -145,8 +145,8 @@ OpenAI 翻译器**几乎支持市面上所有模型**,因为几乎所有的 AI
145145
### 2. 配置到程序中
146146

147147
1. 打开程序
148-
2. 在"基础设置"→"翻译器"中选择"OpenAI"(如需多模态可选"高质量翻译 OpenAI")
149-
3. 在"高级设置"中填写:
148+
2. 在"设置" -> "翻译"中将"翻译器"设为"OpenAI"(如需多模态可选"高质量翻译 OpenAI")
149+
3. 在"API 管理" -> "翻译"中填写:
150150
- **API Key**:填入你的 Atlas Cloud API Key
151151
- **Base URL**`https://api.atlascloud.ai/v1`
152152
- **模型**
@@ -207,8 +207,8 @@ DeepSeek 提供高质量、低成本的 AI 翻译服务,非常适合漫画翻
207207
### 4. 配置到程序中
208208

209209
1. 打开程序
210-
2. 在"基础设置"→"翻译器"中选择"OpenAI"
211-
3. 在"高级设置"中填写:
210+
2. 在"设置" -> "翻译"中将"翻译器"设为"OpenAI"
211+
3. 在"API 管理" -> "翻译"中填写:
212212
- **API Key**:填入你的 DeepSeek API Key(`sk-xxxxxxxxxxxxxxxx`
213213
- **Base URL**:填入 `https://api.deepseek.com/v1`
214214
- **模型**:选择以下两种之一:
@@ -236,13 +236,13 @@ Google Gemini 是 Google 最新的多模态 AI 模型,性能强劲。
236236
### 2. 配置到程序中
237237

238238
1. 打开程序
239-
2. 在"基础设置"→"翻译器"中选择"高质量翻译 Gemini"或"Gemini"
240-
3. 在"高级设置"中填写:
239+
2. 在"设置" -> "翻译"中将"翻译器"设为"高质量翻译 Gemini"或"Gemini"
240+
3. 在"API 管理" -> "翻译"中填写:
241241
- **API Key**:你的 Gemini API Key
242242
- **Base URL**:无需填写(自动使用默认地址)
243-
- **模型**
244-
- `gemini-2.5-pro`:断句稳定,质量最高 ⭐ 推荐
245-
- `gemini-2.5-flash`:速度快,价格便宜
243+
- **模型**
244+
- `gemini-2.5-pro`:断句稳定,质量最高 ⭐ 推荐
245+
- `gemini-2.5-flash`:速度快,价格便宜
246246
4. 你的 Google Cloud / Vertex 相关 API Key 也直接填写到 Gemini 配置即可
247247
5. `Base URL` 保持默认官方地址 `https://generativelanguage.googleapis.com` 即可,无需改成其他地址
248248

doc/DEBUGGING.md

Lines changed: 6 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@
1212

1313
## 开启详细日志
1414

15-
在"基础设置"标签页中,勾选 **详细日志** 选项。
15+
在左侧"设置" -> "通用"中,勾选 **详细日志** 选项。
1616

1717
### 详细日志会产生什么
1818

@@ -93,10 +93,12 @@
9393

9494
## 可调节参数
9595

96-
如果检测或识别效果不理想,可以在"高级设置"标签页中调节以下参数
96+
如果检测或识别效果不理想,可以在左侧"设置"页中调节以下参数
9797

9898
### 检测器参数
9999

100+
位置:`设置` -> `检测`
101+
100102
- **文本置信度**(text_threshold):`0.1 - 0.9`,默认 `0.5`
101103
- 检测器判断某个区域是否为文本的置信度阈值
102104
- **降低**:检测更多文本,但可能误检非文本区域
@@ -114,6 +116,8 @@
114116

115117
### OCR 参数
116118

119+
位置:`设置` -> `OCR`
120+
117121
- **OCR 置信度**(prob):`0.0 - 1.0`,默认 `0.1`
118122
- OCR 识别文字的置信度阈值
119123
- **降低**:保留更多识别结果,但可能包含错误识别

doc/INSTALLATION.md

Lines changed: 11 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -594,26 +594,27 @@ A: 运行 `./macOS_4_更新维护.sh`,选择"完整更新"即可。
594594
- 初始化翻译引擎
595595
- 打开主界面
596596

597-
### 2. 基础设置(CPU 版本用户必看)
597+
### 2. 通用设置(CPU 版本用户必看)
598598

599599
如果使用 **CPU 版本**,请务必:
600600

601-
1. 点击"基础设置"标签页
602-
2. **取消勾选"使用 GPU"**
603-
3. 点击"保存配置"
601+
1. 点击左侧导航的"设置"
602+
2. 打开"通用"页
603+
3. **取消勾选"使用 GPU"**,修改会自动保存
604604

605605
> ⚠️ **重要**:CPU 版本如果启用 GPU 会导致程序崩溃!
606606
607607
### 3. 设置输出目录
608608

609-
1. 在主界面点击"选择输出文件夹"按钮
610-
2. 选择翻译结果的保存位置
611-
3. 程序会记住此设置
609+
1. 点击左侧导航的"翻译界面"
610+
2. 在"翻译任务"区域找到"输出目录:"
611+
3. 点击"浏览..."选择翻译结果的保存位置
612+
4. 也可以直接输入路径或拖拽输出文件夹到输入框,程序会记住此设置
612613

613614
### 4. 选择翻译器
614615

615-
1. 在"基础设置"中找到"翻译器"下拉菜单
616-
2. 首次使用推荐选择
616+
1. 点击左侧导航的"设置",打开"翻译"页
617+
2. 在"翻译器"下拉菜单中选择
617618
- **高质量翻译 OpenAI****高质量翻译 Gemini**(多模态,看图翻译,效果最好)⭐ 强烈推荐
618619
- 如需把 Google 官方 Key 与 Gemini 配置隔离,可选 **高质量翻译 Vertex**
619620
- 需要配置 API Key → [查看 API 配置教程](API_CONFIG.md)
@@ -675,7 +676,7 @@ A: 运行 `./macOS_4_更新维护.sh`,选择"完整更新"即可。
675676
**解决方法**
676677
1. 检查图片格式是否支持
677678
2. 确认 `models/` 目录中的模型文件完整
678-
3. 在"基础设置"中勾选"详细日志"查看错误信息
679+
3. 在"设置" -> "通用"中勾选"详细日志"查看错误信息
679680
4. 查看 `logs/app.log` 文件
680681

681682
### 模型加载缓慢

doc/SETTINGS.md

Lines changed: 18 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -6,23 +6,33 @@
66

77
## 📖 参数详解
88

9-
界面分为三个标签页,每个标签页包含不同的设置选项:
9+
当前桌面端通过左侧"设置"进入参数页,实际页签由 `desktop_qt_ui/locales/settings_tab_layout.json` 定义,主要包括:
10+
11+
- **通用**:语言、主题、详细日志、GPU、输出格式、批量大小、PSD 导出等
12+
- **OCR**:OCR 模型、混合 OCR、AI OCR 提示词与相关阈值
13+
- **检测**:检测器、检测大小、文本阈值、YOLO 辅助检测等
14+
- **翻译**:翻译器、目标语言、保留源语言、流式传输、术语提取等
15+
- **修复**:修复模型、修复大小、修复精度、蒙版相关设置
16+
- **排版**:渲染器、字体、方向、对齐、AI 断句、气泡排版等
17+
- **模式相关**:替换翻译、超分、上色等工作流相关设置
1018

1119
---
1220

13-
## 基础设置
21+
## 翻译与通用设置
1422

1523
### 翻译器设置
1624

1725
- **翻译器 (translator)**:选择翻译引擎
26+
- 位置:设置 -> 翻译
1827
- 在线翻译器:OpenAI、Google Gemini、Vertex、DeepL、百度翻译等
1928
- 高质量翻译器:高质量翻译 OpenAI、高质量翻译 Gemini、高质量翻译 Vertex(推荐)
2029

2130
- **目标语言 (target_lang)**:翻译的目标语言
31+
- 位置:设置 -> 翻译
2232
- 简体中文、繁体中文、英语、日语、韩语等
2333

2434
- **保留源语言 (keep_lang)**:文本框合并完成后,按识别出的源语言过滤哪些文本区域继续进入后续处理;不匹配的区域会保持原图,不擦除、不翻译、不渲染
25-
- 位置:翻译设置 → 翻译器
35+
- 位置:设置 -> 翻译
2636
- 默认:`none`(不过滤)
2737
- 适用场景:英文版日漫只保留英文文本,尽量跳过保留原样的日文标题、拟声词和装饰字
2838
- 工作阶段:仅作用于正常的 OCR → 文本框合并 → 修复 / 翻译 / 渲染 主流程,在文本框合并后执行
@@ -135,6 +145,7 @@
135145
### CLI 选项
136146

137147
- **详细日志 (verbose)**:输出详细的调试信息(问题排查建议开启)
148+
- 位置:设置 -> 通用
138149
- 默认:关闭(`false`)
139150
- 开启后:
140151
- 日志窗口会显示更多 `DEBUG` 级别过程日志(检测、OCR、渲染等中间步骤)
@@ -147,8 +158,10 @@
147158
- 排查完成后清理旧日志,避免 `result/` 目录持续膨胀
148159

149160
- **使用 GPU (use_gpu)**:启用 GPU 加速
161+
- 位置:设置 -> 通用
150162

151163
- **禁用 ONNX GPU 加速 (disable_onnx_gpu)**:禁用 ONNX Runtime 的 GPU 加速,强制使用 `CPUExecutionProvider`
164+
- 位置:设置 -> 通用
152165
- 默认:关闭(`false`)
153166
- 适用场景:GPU 模式下 ONNX Runtime 出现兼容性、驱动或 provider 初始化问题时
154167
- 说明:该选项只影响 ONNX Runtime 路径,不会关闭整个程序的 GPU 开关
@@ -242,7 +255,7 @@
242255

243256
---
244257

245-
## 高级设置
258+
## 检测、修复、排版与模式相关设置
246259

247260
### 检测器设置
248261

@@ -468,7 +481,7 @@
468481

469482
---
470483

471-
## 选项
484+
## OCR 与 API 相关设置
472485

473486
### OCR 设置
474487

doc/USAGE.md

Lines changed: 22 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -68,17 +68,18 @@
6868

6969
如果使用 **CPU 版本**或没有 NVIDIA 显卡:
7070

71-
1. 点击"**基础设置**"标签页
72-
2. **取消勾选"使用 GPU"**
73-
3. 点击"**保存配置**"
71+
1. 点击左侧导航的"**设置**"
72+
2. 打开"**通用**"页
73+
3. **取消勾选"使用 GPU"**,修改会自动保存
7474

7575
> ⚠️ **重要**:CPU 版本或没有 NVIDIA 显卡时启用 GPU 会导致程序崩溃!
7676
7777
### 4. 设置输出目录
7878

79-
1. 在主界面点击"**选择输出文件夹**"按钮
80-
2. 选择翻译结果的保存位置
81-
3. 程序会自动记住此设置
79+
1. 点击左侧导航的"**翻译界面**"
80+
2. 在"**翻译任务**"区域找到"**输出目录:**"
81+
3. 点击"**浏览...**"选择翻译结果的保存位置
82+
4. 也可以直接输入路径或拖拽输出文件夹到输入框,程序会自动记住此设置
8283

8384
---
8485

@@ -105,8 +106,9 @@
105106

106107
### 选择翻译器
107108

108-
1. 在"**基础设置**"标签页找到"**翻译器**"下拉菜单
109-
2. 首次使用推荐选择:
109+
1. 点击左侧导航的"**设置**",打开"**翻译**"页
110+
2. 找到"**翻译器**"下拉菜单
111+
3. 首次使用推荐选择:
110112
- **高质量翻译 OpenAI****高质量翻译 Gemini**(多模态,看图翻译,效果最好)⭐ 强烈推荐
111113
- **OpenAI****Gemini**(纯文本翻译,需配置 API)
112114

@@ -118,8 +120,9 @@
118120
119121
### 选择目标语言
120122

121-
1. 在"**基础设置**"中找到"**目标语言**"下拉菜单
122-
2. 常用选择:
123+
1. 点击左侧导航的"**设置**",打开"**翻译**"页
124+
2. 找到"**目标语言**"下拉菜单
125+
3. 常用选择:
123126
- **简体中文**(CHS)
124127
- **繁体中文**(CHT)
125128
- **英语**(ENG)
@@ -238,7 +241,7 @@
238241

239242
### OCR 模型选择
240243

241-
"**选项**"标签页中选择 OCR 模型:
244+
在左侧"**设置**" -> "**OCR**"页中选择 OCR 模型:
242245

243246
- **32px**:旧版轻量模型,可作兼容性备选
244247
- **48px**(推荐):默认模型,平衡速度和准确率
@@ -261,7 +264,7 @@
261264

262265
### 保留源语言过滤
263266

264-
"**翻译设置**"标签页中,可以使用 **保留源语言** 下拉框,控制“哪些 OCR 合并结果允许进入后续处理”。
267+
在左侧"**设置**" -> "**翻译**"页中,可以使用 **保留源语言** 下拉框,控制“哪些 OCR 合并结果允许进入后续处理”。
265268

266269
- **作用阶段**:文本框合并完成后,过滤后续的修复、翻译和渲染区域
267270
- **被过滤区域**:保持原图,不擦除、不翻译、不渲染
@@ -275,7 +278,7 @@
275278

276279
### AI 上色 / AI 渲染
277280

278-
"**模式特定**"和"**排版**"标签页中可以选择 API 上色 / API 渲染:
281+
在左侧"**设置**" -> "**模式相关**"和"**排版**"页中可以选择 API 上色 / API 渲染:
279282

280283
- **openai_colorizer**:调用 OpenAI 图像接口整页上色
281284
- **gemini_colorizer**:调用 Gemini 图像接口整页上色
@@ -398,8 +401,8 @@
398401
- 建议使用 GPU 版本(需要 NVIDIA 显卡)
399402

400403
2. **图片分辨率过高**
401-
- 在"**高级设置**"中降低"**检测大小**"(默认 2048)
402-
- 降低"**修复大小**"
404+
- 在"**设置**" -> "**检测**"中降低"**检测大小**"(默认 2048)
405+
- 在"**设置**" -> "**修复**"中降低"**修复大小**"
403406

404407
### Q2:翻译结果不准确怎么办?
405408

@@ -421,11 +424,11 @@
421424

422425
**解决方法**
423426
1. **开启详细日志**
424-
- 在"**基础设置**"中勾选"**详细日志**"
427+
- 在"**设置**" -> "**通用**"中勾选"**详细日志**"
425428
- 查看 `result/` 目录中的调试文件
426429

427430
2. **调整检测参数**
428-
- 在"**高级设置**"中降低"**文本阈值**"(默认 0.5)
431+
- 在"**设置**" -> "**检测**"中降低"**文本阈值**"(默认 0.5)
429432
- 降低"**边界框生成阈值**"(默认 0.5)
430433
- 增大"**Unclip 比例**"(默认 2.5)
431434

@@ -447,7 +450,7 @@
447450
- 安装 [CUDA Toolkit 12.x](https://developer.nvidia.com/cuda-downloads)
448451

449452
3. **改用 CPU 版本**
450-
- 取消勾选"**使用 GPU**"
453+
- 在"**设置**" -> "**通用**"中取消勾选"**使用 GPU**"
451454
- 或下载 CPU 版本的程序
452455

453456
### Q5:如何批量翻译整个文件夹?
@@ -459,7 +462,7 @@
459462
4. 点击"**开始翻译**"
460463
5. 等待所有图片翻译完成
461464

462-
> 💡 **提示**:可以在"**基础设置**"中设置"**批量大小**"来控制同时处理的图片数量
465+
> 💡 **提示**:可以在"**设置**" -> "**通用**"中设置"**批量大小**"来控制同时处理的图片数量
463466
464467
---
465468

doc/WORKFLOWS.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -99,7 +99,7 @@
9999

100100
**步骤**
101101
1. 选择"仅上色"模式
102-
2. 在"高级设置"中配置上色参数:
102+
2. 在"设置" -> "模式相关"中配置上色参数:
103103
- **上色模型**:选择上色器类型
104104
- **上色大小**:设置处理尺寸
105105
- **降噪强度**:控制降噪程度
@@ -123,7 +123,7 @@
123123

124124
**步骤**
125125
1. 选择"仅超分"模式
126-
2. 在"高级设置"中配置超分参数:
126+
2. 在"设置" -> "模式相关"中配置超分参数:
127127
- **超分模型**:选择 `waifu2x``realcugan`(推荐)或 `mangajanai`(效果最好)
128128
- **超分倍数**:选择 2x、3x 或 4x
129129
- **Real-CUGAN 模型**:选择合适的预训练模型(如 `3x-denoise3x`
@@ -155,7 +155,7 @@
155155

156156
**步骤**
157157
1. 选择"仅修复"模式
158-
2. 在"高级设置"中配置修复参数:
158+
2. 在"设置" -> "修复"中配置修复参数:
159159
- **修复模型**:选择 `lama_large`(推荐)或 `lama_mpe`
160160
- **修复大小**:设置处理尺寸
161161
- **修复精度**:选择 `fp32``fp16``bf16`
@@ -304,8 +304,8 @@
304304

305305
**启用方法**
306306
1. 选择支持的翻译器(OpenAI、Gemini、Vertex、高质量翻译 OpenAI、高质量翻译 Gemini、高质量翻译 Vertex)
307-
2. 在"基础设置"中选择或创建自定义提示词文件
308-
3. 勾选"自动提取新术语"选项
307+
2. 在"设置" -> "翻译"中选择或创建自定义提示词文件
308+
3. 在同一页勾选"自动提取新术语"选项
309309
4. 开始翻译
310310

311311
**使用场景**

0 commit comments

Comments
 (0)