Skip to content

Commit 49b0a62

Browse files
committed
Update documentation: Add Real-CUGAN support and new features
- Update README.md: Correct installation instructions (Miniconda auto-install) - Update SETTINGS.md: Add Real-CUGAN model settings, AI line break options, MTPE, and high-quality batch size - Update FEATURES.md: Add Real-CUGAN upscaler features and specifications - Update WORKFLOWS.md: Add 'Upscale Only' workflow and clarify TXT file import priority - Add Chinese localization for Real-CUGAN model names in Qt UI
1 parent b9f0e15 commit 49b0a62

4 files changed

Lines changed: 109 additions & 27 deletions

File tree

README.md

Lines changed: 12 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -25,30 +25,32 @@
2525

2626
### 📥 安装方式
2727

28-
#### 方式一:使用安装脚本(⭐ 推荐,支持自动更新
28+
#### 方式一:使用安装脚本(⭐ 推荐,自动安装 Miniconda
2929

30-
1. **安装 Python 3.12**
31-
- [点击下载 Python 3.12.10](https://www.python.org/ftp/python/3.12.10/python-3.12.10-amd64.exe)
32-
- ⚠️ 安装时**必须勾选** "Add Python to PATH"
30+
> ⚠️ **无需预装 Python**:脚本会自动下载安装 Miniconda(轻量级Python环境管理)
3331
34-
2. **下载安装脚本**
32+
1. **下载安装脚本**
3533
- [点击下载 步骤1-首次安装.bat](https://github.com/hgmzhn/manga-translator-ui/raw/main/步骤1-首次安装.bat)
3634
- 保存到你想安装程序的目录(如 `D:\manga-translator-ui\`
3735

38-
3. **运行安装**
36+
2. **运行安装**
3937
- 双击 `步骤1-首次安装.bat`
4038
- 脚本会自动:
39+
- ✓ 检测并安装 Miniconda(如需要)
40+
- 提供下载源选择:清华大学镜像(国内推荐)或 Anaconda 官方
41+
- 自动下载安装(约 50MB)
42+
- 安装到项目目录,不占用C盘
43+
- ✓ 安装便携版 Git(如需要)
44+
- ✓ 克隆代码仓库
45+
- ✓ 创建 Conda 虚拟环境(Python 3.12)
4146
- ✓ 检测显卡类型(NVIDIA / AMD / 集显)
4247
- ✓ 自动选择对应的 PyTorch 版本
4348
- NVIDIA: CUDA 12.x 版本(需驱动 >= 525.60.13)
4449
- AMD: ROCm 版本(实验性支持,支持 RX 5000/6000/7000/9000 系列)
4550
- 其他: CPU 版本(通用,速度较慢)
46-
- ✓ 安装便携版 Git(可选)
47-
- ✓ 克隆代码仓库
48-
- ✓ 创建虚拟环境
4951
- ✓ 安装所有依赖
5052

51-
4. **启动程序**
53+
3. **启动程序**
5254
- 双击 `步骤2-启动Qt界面.bat`
5355

5456
#### 方式二:下载打包版本

doc/FEATURES.md

Lines changed: 11 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -140,9 +140,19 @@
140140

141141
| 功能 | 说明 |
142142
|------|------|
143-
| **waifu2x** | Waifu2x 超分模型 |
143+
| **waifu2x** | Waifu2x 超分模型(传统模型) |
144+
| **realcugan** | Real-CUGAN 超分模型(推荐,效果更好,降噪能力强) |
145+
| **超分倍数** | 支持 2x、3x、4x 放大 |
146+
| **Real-CUGAN 模型** | 提供多种预训练模型:保守、无降噪、降噪1x/2x/3x、Pro 版本 |
147+
| **分块处理** | 支持大图分块处理,降低显存占用 |
144148
| **还原超分** | 翻译后恢复原始分辨率(避免图片变大) |
145149

150+
**Real-CUGAN 特点**
151+
- 📸 **高质量放大**:基于深度学习的超分辨率算法
152+
- 🎯 **多档降噪**:支持无降噪、降噪1x/2x/3x、保守模式
153+
- 💻 **显存友好**:分块处理大图,避免显存不足
154+
-**Pro 版本**:提供更高质量的超分效果
155+
146156
### 上色器
147157

148158
| 功能 | 说明 |

doc/SETTINGS.md

Lines changed: 44 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -53,7 +53,8 @@
5353

5454
- **跳过无文本图像**:跳过没有检测到文本的图片
5555

56-
- **使用 MTPE**:使用机器翻译后编辑模式
56+
- **启用后期编辑(MTPE)**:启用机器翻译后编辑模式(MTPE,Machine Translation Post-Editing)
57+
- 自动优化翻译结果,适合需要高质量翻译的场景
5758

5859
- **图片可编辑**:保存翻译结果到 JSON 文件(用于后续编辑)
5960

@@ -67,13 +68,18 @@
6768

6869
- **批量大小**:批量处理大小
6970

71+
- **高质量批次大小**:高质量翻译时的批量大小(一次发送的文本块数量,适用于高质量翻译器)
72+
- 默认:1
73+
- 建议范围:1-10
74+
- 越大翻译速度越快,但消耗的 tokens 越多
75+
7076
- **批量并发处理**:启用批量并发处理
7177

7278
- **生成并导出**:生成并导出翻译结果
7379

7480
- **仅上色**:仅执行上色操作,不翻译
7581

76-
- **高质量翻译批量大小**高质量翻译时的批量大小(一次发送的文本块数量
82+
- **高质量翻译批量大小**(已废弃,请使用"高质量批次大小"
7783

7884
---
7985

@@ -102,13 +108,13 @@
102108

103109
- **Unclip比例**:Unclip 比例(控制文本框扩展程度)
104110

105-
- **使用 YOLO OBB**:使用 YOLO 有向边界框检测
111+
- **启用YOLO辅助检测**:使用 YOLO 有向边界框辅助检测(提高检测准确率)
106112

107-
- **YOLO OBB 置信度**:YOLO OBB 检测置信度阈值
113+
- **YOLO置信度阈值**:YOLO 辅助检测的置信度阈值(值越高越严格)
108114

109-
- **YOLO OBB IOU**:YOLO OBB IOU 阈值
115+
- **YOLO交叉比(IoU)**:YOLO IOU 阈值(控制框重叠度判断)
110116

111-
- **YOLO OBB 重叠阈值**:YOLO OBB 框重叠阈值
117+
- **YOLO辅助检测重叠率删除阈值**:YOLO 框重叠阈值(去除重叠的检测框)
112118

113119
### 修复器设置
114120

@@ -152,7 +158,9 @@
152158

153159
- **禁用字体边框**:禁用字体边框(去除描边效果)
154160

155-
- **禁用自动换行**:禁用自动换行(启用 AI 断句时自动开启)
161+
- **AI断句**:禁用自动换行(启用 AI 断句时会自动禁用自动换行)
162+
- 勾选此选项将禁用自动换行功能
163+
- 常与 AI 断句功能配合使用
156164

157165
- **字体大小偏移量**:字体大小偏移量(调整字体大小,正数增大,负数减小)
158166

@@ -174,22 +182,48 @@
174182

175183
- **自动旋转符号**:自动旋转符号(如 !?等)
176184

185+
- **竖排内横排**:竖排文本中的横排处理(自动识别竖排文本中的横排符号并正确显示)
186+
177187
- **RTL(从右到左)**:启用从右到左排版
178188

179189
- **字体缩放比例**:字体缩放比例(整体缩放字体)
180190

181191
- **AI断句时文本居中**:AI 断句时文本居中(断句模式下居中显示)
182192

183-
- **优化断行**:启用 AI 断句(需要 OpenAI/Gemini 翻译器)
193+
- **AI断句自动扩大文字**:启用 AI 断句优化(自动调整字体大小以减少断行)
194+
- 需要配合 OpenAI/Gemini 翻译器使用
195+
- AI 会自动优化文本断行,减少不必要的换行
184196

185-
- **严格智能缩放**:严格智能缩放模式(更严格地控制字体大小)
197+
- **AI断句检查**:检查 AI 断句结果并重试(确保断句质量)
198+
- 自动检查断句结果,如不符合要求则重试
199+
200+
- **AI断句自动扩大文字下不扩大文本框**:严格智能缩放模式(AI 断句时不扩大文本框,只缩小字体)
201+
- 保持文本框原始大小,通过缩小字体来适应
186202

187203
### 超分辨率设置
188204

189205
- **超分模型**:超分辨率模型
190-
- **waifu2x**:Waifu2x 超分模型
206+
- **waifu2x**:Waifu2x 超分模型(默认)
207+
- **realcugan**:Real-CUGAN 超分模型(推荐,效果更好)
191208
- 其他超分模型
192209

210+
- **超分倍数**:超分辨率放大倍数
211+
- **不使用**:不进行超分(默认)
212+
- **2****3****4**:放大 2/3/4 倍
213+
214+
- **Real-CUGAN 模型**:Real-CUGAN 模型选择(仅在超分模型选择 realcugan 时生效)
215+
- **2倍系列**:2x-保守、2x-保守-Pro、2x-无降噪、2x-降噪1x/2x/3x、2x-降噪3x-Pro
216+
- **3倍系列**:3x-保守、3x-保守-Pro、3x-无降噪、3x-无降噪-Pro、3x-降噪3x、3x-降噪3x-Pro
217+
- **4倍系列**:4x-保守、4x-无降噪、4x-降噪3x
218+
- **Pro 版本**:效果更好,但速度稍慢
219+
- **降噪强度**:数字越大降噪越强,适合有噪点的图片
220+
221+
- **分块大小**:分块处理大小(0 = 不分割)
222+
- 默认:0(不分割)
223+
- 建议范围:200-800
224+
- 作用:将大图分割成小块处理,降低显存占用
225+
- 越小越省显存,但速度越慢
226+
193227
- **还原超分**:翻译后恢复原始分辨率(避免图片变大)
194228

195229
### 上色器设置

doc/WORKFLOWS.md

Lines changed: 42 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,12 @@
11
# 工作流程说明
22

3-
本文档介绍程序的 4 种工作流程和相关功能。
3+
本文档介绍程序的 5 种工作流程和相关功能。
44

55
---
66

77
## 📋 翻译流程模式
88

9-
程序提供了一个"翻译流程模式"下拉菜单,包含 4 种工作流程:
9+
程序提供了一个"翻译流程模式"下拉菜单,包含 5 种工作流程:
1010

1111
---
1212

@@ -57,6 +57,11 @@
5757
2. 将原文翻译成目标语言
5858
3. **直接在 `_original.txt` 文件中修改**(或直接修改 JSON 文件的 `translation` 字段)
5959

60+
**TXT 文件优先级**(在"导入翻译并渲染"模式中):
61+
- **优先使用 `_original.txt`**(原文文件,用于手动翻译后导入)⭐ 最高优先级
62+
- 如果不存在,使用 `_translated.txt`(翻译文件)
63+
- 如果都不存在,直接使用 JSON 文件中的翻译
64+
6065
---
6166

6267
## 4. 导入翻译并渲染
@@ -73,15 +78,46 @@
7378
- **渲染图片**:使用加载的翻译内容渲染图片
7479
- **不进行翻译**,直接渲染
7580

81+
**TXT 文件导入优先级**
82+
- **优先使用 `_original.txt`**(原文文件,用于手动翻译后导入)⭐ 最高优先级
83+
- 如果不存在,使用 `_translated.txt`(翻译文件)
84+
- 如果都不存在,直接使用 JSON 文件中的翻译
85+
7686
**使用场景**
7787
- 修改了 TXT 文件中的翻译内容,需要导入并重新渲染
7888
- 修改了 JSON 文件中的翻译内容,需要重新渲染
7989
- 修改了渲染参数(字体、颜色、排版等),需要重新渲染
8090

81-
**TXT 文件优先级**
82-
- 优先使用 `_original.txt`(原文文件,用于手动翻译后导入)
83-
- 如果不存在,使用 `_translated.txt`(翻译文件)
84-
- 如果都不存在,直接使用 JSON 文件中的翻译
91+
---
92+
93+
## 5. 仅超分(Upscale Only)
94+
95+
**用途**:仅对图片进行超分辨率处理,不进行文本检测和翻译
96+
97+
**步骤**
98+
1. 选择"仅超分"模式
99+
2. 在"高级设置"中配置超分参数:
100+
- **超分模型**:选择 `waifu2x``realcugan`(推荐)
101+
- **超分倍数**:选择 2x、3x 或 4x
102+
- **Real-CUGAN 模型**:选择合适的预训练模型(如 `3x-denoise3x`
103+
- **分块大小**:如果显存不足,设置分块大小(如 400)
104+
3. 点击"开始翻译"
105+
4. 程序会:
106+
- **跳过文本检测**
107+
- **跳过 OCR 识别**
108+
- **跳过翻译**
109+
- **仅执行超分处理**
110+
- 保存放大后的图片
111+
112+
**使用场景**
113+
- 单纯提高图片分辨率,不需要翻译
114+
- 放大低分辨率漫画图片
115+
- 图片降噪处理(使用 Real-CUGAN 降噪模型)
116+
117+
**推荐配置**
118+
- **高质量放大**`realcugan` + `3x-denoise3x``3x-denoise3x-pro`
119+
- **快速放大**`waifu2x` + 2x/3x/4x
120+
- **显存不足**:设置 `tile_size=400`(或更小)
85121

86122
---
87123

0 commit comments

Comments
 (0)