本文档详细介绍程序的所有设置选项和参数。
界面分为三个标签页,每个标签页包含不同的设置选项:
-
翻译器 (translator):选择翻译引擎
- 在线翻译器:Google Gemini、OpenAI、DeepL、百度翻译等
- 高质量翻译器:高质量翻译 OpenAI、高质量翻译 Gemini(推荐)
-
目标语言 (target_lang):翻译的目标语言
- 简体中文、繁体中文、英语、日语、韩语等
-
不跳过目标语言文本 (no_text_lang_skip):不跳过已是目标语言的文本(强制翻译)
-
自定义提示词 (high_quality_prompt_path):自定义提示词文件路径
- 适用于:OpenAI、Gemini、高质量翻译 OpenAI、高质量翻译 Gemini 四个翻译器
- 默认:
dict/prompt_example.yaml - 可以在
dict目录下创建新的.yaml或.json文件 - YAML/JSON 格式只需符合标准规范即可加载,优先加载 YAML
- 程序会在每次打开下拉菜单时自动扫描
dict目录 - 添加新提示词文件后,直接点击下拉菜单即可看到新文件,无需重启
-
自动提取新术语 (extract_glossary):自动从翻译结果中提取新术语
- 适用于:OpenAI、Gemini、高质量翻译 OpenAI、高质量翻译 Gemini 四个翻译器
- 勾选后,AI 会自动识别并提取人名、地名、组织名等专有名词
- 提取的术语会自动添加到自定义提示词的术语表中
- 后续翻译时会参考这些术语,保持翻译一致性
- 特别适合长篇漫画的连续翻译,确保角色名等专有名词前后一致
-
使用自定义 API 参数 (use_custom_api_params):启用自定义 API 参数
- 适用于:OpenAI、OpenAI HQ、Gemini、Gemini HQ 四个翻译器
- 勾选后,程序会从
examples/custom_api_params.json读取自定义参数并传递给 API - 点击"打开文件"按钮可自动创建并打开配置文件
- 配置文件为标准 JSON 格式,支持实时生效(每次翻译都会重新加载)
- 使用场景:
- 控制 Ollama 等本地模型的特殊参数(如关闭思考模式)
- 调整 API 的温度、最大 token 数等参数
- 传递模型特定的配置选项
- 配置示例:
{ "temperature": 0.7, "max_tokens": 2000 } - DeepSeek 关闭思考模式示例:
{ "thinking": {"type": "disabled"} } - Gemini 关闭思考模式示例:
{ "thinking_budget": 0 }
-
最大请求速率 (max_requests_per_minute):每分钟最大请求数(0 = 不限制)
-
详细日志 (verbose):输出详细的调试信息(问题排查建议开启)
- 默认:关闭(
false) - 开启后:
- 日志窗口会显示更多
DEBUG级别过程日志(检测、OCR、渲染等中间步骤) - 每次任务会在
result/时间戳-图片名-目标语言-翻译器/生成调试中间文件 - UI 会写入
result/log_时间戳.txt运行日志文件(文件日志始终保留完整信息)
- 日志窗口会显示更多
- 关闭后:
- 界面以
INFO级别为主,日志更简洁,适合日常使用
- 界面以
- 建议:
- 日常翻译关闭,遇到漏检/识别错误/排版异常时临时开启
- 排查完成后清理旧日志,避免
result/目录持续膨胀
- 默认:关闭(
-
使用 GPU (use_gpu):启用 GPU 加速
-
禁用 ONNX GPU 加速 (disable_onnx_gpu):禁用 ONNX Runtime 的 GPU 加速,强制使用
CPUExecutionProvider- 默认:关闭(
false) - 适用场景:GPU 模式下 ONNX Runtime 出现兼容性、驱动或 provider 初始化问题时
- 说明:该选项只影响 ONNX Runtime 路径,不会关闭整个程序的 GPU 开关
- 建议:遇到 ONNX 模型在 GPU 上报错、闪退或启动失败时优先尝试开启
- 默认:关闭(
-
重试次数 (attempts):错误重试次数(-1 = 无限重试)
-
忽略错误 (ignore_errors):忽略错误继续处理
-
上下文页数 (context_size):翻译上下文页面数(用于多页联合翻译)
-
输出格式 (format):输出图片格式
- PNG、JPEG、WEBP、不指定(保持原格式)
-
覆盖已存在文件 (overwrite):覆盖已存在的翻译文件
-
跳过无文本图像 (skip_no_text):跳过没有检测到文本的图片
-
图片可编辑 (save_text):保存翻译结果到 JSON 文件(用于后续编辑)
-
导入翻译 (load_text):从 JSON 文件加载翻译结果
-
导出原文 (template):导出原文到文本文件(用于手动翻译)
-
图像保存质量 (save_quality):JPEG 保存质量(0-100)
-
批量大小 (batch_size):批量处理大小
- 默认:1
- 对于高质量翻译器(OpenAI HQ/Gemini HQ),此参数控制一次发送的图片数量
- 越大翻译速度越快,但消耗的 tokens 越多
- 建议范围:1-10
-
批量并发处理 (batch_concurrent):启用批量并发处理
-
导出可编辑 PSD (export_editable_psd):导出分图层的 PSD 文件
- 需要安装 Photoshop
- 导出包含:原图层、修复图层、可编辑文本层
- 原图层优先使用
manga_translator_work/editor_base/中的上色/超分底图 - 修复图层优先使用当前会话修复图,回退
manga_translator_work/inpainted/ - 导出路径:
原图目录/manga_translator_work/psd/
-
PSD 默认字体 (psd_font):在 Photoshop 中显示的文本图层字体
- 支持字体显示名称或 PostScript 名称
- 留空时使用 Photoshop 默认字体
-
仅生成 PSD 脚本 (psd_script_only):只生成
.jsx脚本,不自动运行 Photoshop- 不会直接生成 PSD 文件
- 脚本保存路径:
原图目录/manga_translator_work/psd/ - 适合手动检查脚本或自行执行导出
-
翻译完成后卸载模型 (unload_models_after_translation):翻译完成后卸载所有模型以释放内存
- 默认:关闭
- 作用:更彻底地释放显存和内存,适合显存不足的场景
- 缺点:下次翻译需要重新加载模型
-
生成并导出 (generate_and_export):生成并导出翻译结果
-
仅上色 (colorize_only):仅执行上色操作,不翻译
-
仅超分 (upscale_only):仅执行超分辨率操作,不翻译
-
输出到原图目录 (save_to_source_dir):将翻译结果输出到原图片所在目录
- 启用后,输出路径为
原图目录/manga_translator_work/result/ - 方便管理和查找翻译后的图片
- 适合批量处理时保持文件组织结构
- 启用后,输出路径为
-
替换翻译 (replace_translation):从已翻译图片提取翻译数据并应用到生肉图片
- 自动匹配生肉图和翻译图的文本区域
- 支持多对一匹配(多个生肉框对应一个翻译框)
- 自动保存优化后的蒙版,Qt 编辑器加载时跳过蒙版优化
- 支持导出可编辑 PSD 文件
- 不支持并行处理(自动使用顺序处理)
- 使用方法:
- 准备生肉图和对应的翻译图(文件名需对应)
- 将翻译图放在
原图目录/manga_translator_work/translated_images/目录下 - 勾选"替换翻译"选项
- 添加生肉图片
- 程序自动从翻译图提取 OCR 结果并应用
-
文本检测器 (detector):文本检测算法
- default:默认检测器(DBNet + ResNet34)
- ctd:Comic 文本检测器
- craft:CRAFT 检测器
-
检测大小 (detection_size):检测时的图像缩放尺寸(默认 2048,越大越准确但越慢)
-
文本阈值 (text_threshold):文本检测置信度阈值(0-1,越高越严格)
-
边界框生成阈值 (box_threshold):文本框生成的置信度阈值(值越低检测到的文本框越多)
-
Unclip比例 (unclip_ratio):Unclip 比例(控制文本框扩展程度)
-
最小检测框面积占比 (min_box_area_ratio):最小检测框面积占比,相对于图片总像素(默认 0.0009 = 0.09%)
- 过滤掉面积过小的检测框
- 值越大,过滤越严格,小文本框会被移除
- 值越小,保留更多小文本框
- 建议范围:0.0005-0.002(0.05%-0.2%)
-
启用YOLO辅助检测 (use_yolo_obb):使用 YOLO 有向边界框辅助检测(提高检测准确率)
-
YOLO置信度阈值 (yolo_obb_conf):YOLO 辅助检测的置信度阈值(值越高越严格)
-
YOLO交叉比(IoU) (yolo_obb_iou):YOLO IOU 阈值(控制框重叠度判断)
-
YOLO辅助检测重叠率删除阈值 (yolo_obb_overlap_threshold):YOLO 框重叠阈值(去除重叠的检测框)
-
修复模型 (inpainter):图像修复算法
- lama_large:大型 LaMa 修复模型(推荐,效果最好)
- lama_mpe:LaMa MPE 修复模型(速度快)
- default:AOT 修复器(默认)
-
修复大小 (inpainting_size):修复处理时的图像尺寸(越大效果越好但越慢)
-
修复精度 (inpainting_precision):精度设置
- fp32:单精度(最准确,最慢)
- fp16:半精度(平衡)
- bf16:BFloat16(推荐)
-
强制使用PyTorch修复 (force_use_torch_inpainting):强制使用 PyTorch 进行图像修复
- 默认情况下,CPU 模式会优先使用 ONNX 引擎(速度更快)
- 勾选此选项后,强制使用 PyTorch 引擎进行修复
- 适用场景:ONNX 引擎出现问题或需要更高精度时
- GPU 模式下此选项无效(始终使用 PyTorch)
-
渲染器 (renderer):渲染引擎
- default:默认渲染器
- manga2eng_pillow:Manga2Eng Pillow 渲染器
-
排版模式 (layout_mode):文本排版模式
- smart_scaling:智能缩放(自动调整字体大小)
- strict:严格边界(缩小字体以适应文本框)
- balloon_fill:智能气泡(推荐,自动检测气泡并填充)
-
对齐方式 (alignment):文本对齐方式
- auto:自动对齐
- left:左对齐
- center:居中对齐(水平和垂直方向均居中)
- right:右对齐
-
文本方向 (direction):文字方向
- auto:自动检测
- horizontal:水平排列
- vertical:垂直排列
-
字体路径 (font_path):字体文件路径(选择自定义字体)
- 可以在
fonts目录下添加新的字体文件(.ttf、.otf、.ttc格式) - 程序会在每次打开下拉菜单时自动扫描
fonts目录 - 添加新字体后,直接点击下拉菜单即可看到新字体,无需重启
- 可以在
-
禁用字体边框 (disable_font_border):禁用字体边框(去除描边效果)
-
描边宽度比例 (stroke_width):字体描边(边框)宽度,相对于字体大小的比例
- 默认:0.07(7%)
- 范围:0.0-1.0
- 设为 0 可完全禁用描边效果(等同于勾选"禁用字体边框")
- 建议范围:0.05-0.15(5%-15%)
- 越大描边越粗,越小描边越细
-
AI断句 (disable_auto_wrap):禁用自动换行(启用 AI 断句时会自动禁用自动换行)
- 勾选此选项将禁用自动换行功能
- 常与 AI 断句功能配合使用
-
字体大小偏移量 (font_size_offset):字体大小偏移量(调整字体大小,正数增大,负数减小)
-
最小字体大小 (font_size_minimum):最小字体大小(限制字体最小尺寸)
-
最大字体大小 (max_font_size):最大字体大小(限制字体最大尺寸)
-
大写 (uppercase):转换为大写字母
-
小写 (lowercase):转换为小写字母
-
禁用连字符 (no_hyphenation):禁用连字符换行
-
字体颜色 (font_color):字体颜色(十六进制颜色代码,如 #FFFFFF)
-
行间距 (line_spacing):行间距倍率(调节行与行之间的空隙),默认 1.0,范围 0.1-5.0
-
字间距 (letter_spacing):字间距倍率(调节字符推进距离),默认 1.0,范围 0.1-5.0
1.0与旧版默认渲染行为一致- 同时作用于排版、文本框尺寸计算和最终渲染
- 支持全局设置,也支持在编辑器中按区域单独覆盖
-
字体大小 (font_size):固定字体大小(覆盖自动计算)
-
自动旋转符号 (auto_rotate_symbols):自动旋转符号(如 !?等)
-
竖排内横排 (auto_rotate_symbols):竖排文本中的横排处理(自动识别竖排文本中的横排符号并正确显示)
-
RTL(从右到左) (rtl):启用从右到左排版
-
字体缩放比例 (font_scale_ratio):字体缩放比例(整体缩放字体)
-
垂直居中 (center_text_in_bubble):文本块在气泡框内垂直居中显示
-
AI断句自动扩大文字 (optimize_line_breaks):启用 AI 断句优化(自动调整字体大小以减少断行)
- 需要配合 OpenAI/Gemini 翻译器使用
- AI 会自动优化文本断行,提升文本可读性
-
AI断句检查 (check_br_and_retry):检查 AI 断句结果并重试(确保断句质量)
- 自动检查断句结果,如不符合要求则重试
-
AI断句自动扩大文字下不扩大文本框 (strict_smart_scaling):严格智能缩放模式(AI 断句时不扩大文本框,只缩小字体)
- 保持文本框原始大小,通过缩小字体来适应
-
启用模板匹配对齐 (enable_template_alignment):启用直接粘贴模式(仅替换翻译模式)
- 默认:关闭
- 功能:根据坐标匹配,直接从翻译图裁剪区域并粘贴到生肉图
- 使用场景:想保留翻译图的原始字体、样式、符号、音效等
- 注意:仅在"替换翻译"模式下生效
-
粘贴模式连通距离比例 (paste_connect_distance_ratio):连接附近蒙版区域的距离比例(相对于图像长边),默认 0.03(3%)
-
粘贴模式蒙版膨胀大小 (paste_mask_dilation_pixels):粘贴前扩大蒙版区域的像素数,默认 10 像素,设为 0 禁用膨胀
-
超分模型 (upscaler):超分辨率模型
- waifu2x:Waifu2x 超分模型(默认)
- realcugan:Real-CUGAN 超分模型(推荐,效果更好)
- mangajanai:MangaJaNai 超分模型(⭐ 效果最好,但最吃配置)
- 自动检测彩色/黑白图片,选择对应模型
- 彩色图片使用 IllustrationJaNai 模型
- 黑白图片使用 MangaJaNai 模型(根据分辨率自动选择最佳模型)
- 其他超分模型
-
超分倍数 (upscale_ratio):超分辨率放大倍数
- 不使用:不进行超分(默认)
- 2、3、4:放大 2/3/4 倍
-
Real-CUGAN 模型 (realcugan_model):Real-CUGAN 模型选择(仅在超分模型选择 realcugan 时生效)
- 2倍系列:2x-保守、2x-保守-Pro、2x-无降噪、2x-降噪1x/2x/3x、2x-降噪3x-Pro
- 3倍系列:3x-保守、3x-保守-Pro、3x-无降噪、3x-无降噪-Pro、3x-降噪3x、3x-降噪3x-Pro
- 4倍系列:4x-保守、4x-无降噪、4x-降噪3x
- Pro 版本:效果更好,但速度稍慢
- 降噪强度:数字越大降噪越强,适合有噪点的图片
-
分块大小 (tile_size):分块处理大小(0 = 不分割)
- 默认:0(不分割)
- 建议范围:200-800
- 作用:将大图分割成小块处理,降低显存占用
- 越小越省显存,但速度越慢
-
还原超分 (revert_upscaling):翻译后恢复原始分辨率(避免图片变大)
-
上色模型 (colorizer):上色器类型
- none:不上色(默认)
- 其他上色模型
-
上色大小 (colorization_size):上色处理尺寸(越大效果越好但越慢)
-
降噪强度 (denoise_sigma):去噪强度(控制降噪程度)
-
OCR模型 (ocr):OCR 识别模型
- 48px:默认模型(推荐,平衡速度和准确率)
- 48px_ctc:CTC 变体模型(可作为备选对比,不代表一定更精确)
- mocr:Manga OCR 专用模型(专门针对漫画优化)
- paddleocr:PaddleOCR 引擎(支持多语言)
- paddleocr_korean:韩漫推荐
- paddleocr_vl:PaddleOCR-VL-For-Manga 模型(效果最好,最吃配置)
- 推荐:日漫推荐
48px或mocr,韩漫推荐paddleocr_korean,英肉推荐原始paddleocr
-
启用混合OCR (use_hybrid_ocr):启用混合 OCR(同时使用两个模型,提高准确率)
- 日漫推荐组合:
48px + mocr
- 日漫推荐组合:
-
备用OCR (secondary_ocr):第二个 OCR 模型(混合 OCR 时使用)
- 日漫推荐:主 OCR 为
48px时,备用 OCR 设为mocr
- 日漫推荐:主 OCR 为
-
最小文本长度 (min_text_length):最小文本长度(过滤掉长度小于此值的文本)
-
忽略非气泡文本 (ignore_bubble):智能过滤非对话框区域的文本
- 功能:自动识别并跳过非气泡区域的文字(如标题、音效、背景文字等)
- 支持的 OCR 模型:所有模型(48px、48px_ctc、32px、manga_ocr、paddleocr)
- 参数范围:0-1(0 表示禁用)
- 阈值效果:
- 0:禁用,保留所有文本
- 0.01-0.3:宽松过滤,只过滤明显的非气泡区域
- 0.3-0.7:中等过滤,平衡准确率
- 0.7-1.0:严格过滤,可能误过滤正常气泡
- 工作原理:
- 计算文本框边缘 2 像素区域的黑白像素比例
- 正常白色气泡:边缘几乎全白 → 保留翻译
- 正常黑色气泡:边缘几乎全黑 → 保留翻译
- 非气泡区域:边缘黑白混杂 → 跳过
- 彩色文字:检测到彩色 → 跳过
- 使用场景:
- 漫画中有大量音效、标题等不需要翻译的文字
- 想要只翻译对话框内的文字
- 减少不必要的翻译,提高效率
- 日志输出:过滤时会显示
[FILTERED] Region X ignored - Non-bubble area detected
-
膨胀不超过气泡蒙版 (limit_mask_dilation_to_bubble_mask):限制蒙版膨胀范围不超出气泡区域
- 默认:
false - 启用后:在蒙版优化后处理阶段,使用模型气泡区域约束最终修复蒙版,避免修复范围溢出到气泡外
- 适用场景:防止气泡边框在修复时被误擦除,减少对白框外背景被误修复
- 默认:
-
文本区域最低概率 (prob):OCR 识别概率阈值(低于此值的文本会被过滤)
-
合并-距离容忍度 (merge_gamma):合并时的距离容忍度(控制文本区域合并的距离阈值)
-
合并-离群容忍度 (merge_sigma):合并时的离群容忍度(控制离群文本的合并程度)
-
合并-边缘比率阈值 (merge_edge_ratio_threshold):边缘比率阈值(控制边缘文本的合并条件)
-
模型辅助合并 (merge_special_require_full_wrap):控制是否启用模型标签辅助预合并流程
- 开启(默认):先执行模型辅助预合并(
changfangtiao独立组、balloon/qipao/other组),且无标签框必须被目标标签框完全包裹才参与预合并;预合并后的框不再参与后续原始合并 - 关闭:不执行模型辅助预合并,全部文本框直接走原始合并算法
- 开启(默认):先执行模型辅助预合并(
-
卷积核大小 (kernel_size):文本擦除卷积核大小(默认 3,控制文本擦除的范围)
-
遮罩扩张偏移 (mask_dilation_offset):蒙版膨胀偏移量(默认 70,控制文本擦除区域的扩展程度)
程序支持通过过滤列表跳过特定文本区域(如水印、广告等)。
- 文件位置:
examples/filter_list.json - 格式:JSON 对象,包含
contains和exact两个数组 - 工作原理:OCR 识别的原文包含过滤词时,该文本区域会被完全跳过(不翻译、不擦除、不渲染)
- 自动创建:程序启动时会自动创建该文件(如果不存在),旧版
filter_list.txt会自动迁移
示例:
{
"contains": [
"pixiv",
"twitter",
"@username",
"广告",
"宣传"
],
"exact": []
}- 打包版本:相对于
_internal目录 - 开发版本:相对于项目根目录
自定义提示词路径(dict 目录):
- 系统提示词(程序内置,自动调用,支持
.yaml/.yml/.json,优先 YAML):dict/system_prompt_hq.yaml- 高质量翻译的系统提示词dict/system_prompt_line_break.yaml- AI断句的系统提示词dict/glossary_extraction_prompt.yaml- 术语提取的系统提示词dict/system_prompt_hq_format.yaml- 高质量翻译输出格式的系统提示词
- 用户自定义提示词(在界面中选择):
dict/prompt_example.yaml- 提示词示例- 可以在此目录添加自己的
.yaml或.json提示词文件
- 适用于:OpenAI、Gemini、高质量翻译 OpenAI、高质量翻译 Gemini 四个翻译器
- 可以自定义翻译风格、术语表、上下文说明等
如何添加自定义提示词:
💡 说明:此提示词适用于以下 4 个翻译器:OpenAI、Gemini、高质量翻译 OpenAI、高质量翻译 Gemini。
⚠️ 重要:使用脚本版安装的用户,不要直接修改prompt_example.yaml,更新时会被覆盖!请新建文件。
- 点击"自定义提示词"旁边的"打开目录"按钮,打开
dict目录 - 在该目录下新建一个
.yaml或.json文件(如my_prompt.yaml) - 打开
prompt_example.yaml,复制里面的内容到新文件中 - 编辑新文件,填入你的作品角色名、术语表等信息
- 回到界面,在"自定义提示词"下拉菜单选择新创建的提示词文件
提示词示例(YAML 格式,也支持 JSON):
# 自定义系统提示词(留空则仅使用内置的基础提示词,此处内容会叠加在基础提示词之前)
# 可以使用 {{{target_lang}}} 占位符,会被替换为目标语言名称
system_prompt: |
你是一名精通多国语言的专业漫画翻译家。你的任务是将漫画中的文本翻译成自然、流畅的目标语言。
规则:
1. 保持原文的语气、风格和情感。
2. 严格参考以下术语表进行翻译。
3. 如果没有特定译法,请采用最通用的翻译。
# 术语表(确保角色名、地名等翻译一致)
glossary:
Person:
- original: "ましろ"
translation: "真白"
Location: []
Org: []
Item: []
Skill: []
Creature: []字段说明:
system_prompt:系统提示词,定义翻译风格和规则glossary:术语表,包含各类专有名词Person:人名Location:地名Org:组织名Item:物品名Skill:技能名Creature:生物名
- 每个术语包含
original(原文)和translation(译文)两个字段
💡 懒人方法:如果觉得手写麻烦,可以把以下内容发给 AI 帮你生成:
- 作品原名和翻译后的名字
- 角色的原文名和翻译后的名字
prompt_example.yaml的内容作为参考格式
导出原文模版路径:
- 默认:
examples/translation_template.json - 用于自定义导出原文的格式
- 定义一组文本框的结构,程序会自动重复应用
过滤列表路径:
- 默认:
examples/filter_list.json - 旧版兼容:
examples/filter_list.txt(启动时会自动迁移到 JSON) - 用于跳过水印、广告等不需要翻译的文本
自定义 API 参数路径:
- 默认:
examples/custom_api_params.json - 用于 OpenAI / Gemini / OpenAI HQ / Gemini HQ 的额外 API 参数
字体路径:
- 默认:
fonts目录 - 可以指定具体字体文件路径(如
fonts/my_font.ttf) - 支持
.ttf和.otf格式
如何添加自定义字体:
- 将字体文件(
.ttf或.otf)复制到fonts目录 - 字体文件名建议使用英文(如
myfont.ttf) - 重启程序
- 在"渲染器设置"中的"字体路径"下拉菜单选择新字体
- 或直接在"字体路径"输入框填写字体文件路径(如
fonts/myfont.ttf)
输出文件夹:
- 默认:与输入文件相同目录
- 可以在界面中自定义输出路径