manga-translator-ui

v3.0.3 更新日志

发布日期：2026-08-28

✨ 新功能

FLUX.2 Klein 修复模型

• 新增 FLUX.2 Klein 4B 修复模型，可在修复模型设置中选择 flux2-klein。
• NVIDIA CUDA 环境仅在可用时尝试启用 xformers；ROCm 不进入 CUDA 专用的 xformers 路径。

气泡蒙版排版

• 新增 render.balloon_fill_mask_layout 开关，仅在智能气泡（balloon_fill）排版模式下生效，默认关闭以保持原有行为。
• 开启后，无显式断行的文本按气泡蒙版最大内接范围重新断句；已有显式断行则完整保留，并以文本框中心为锚点把字号搜索范围扩大到气泡边界。
• 气泡蒙版缺失或未完整包裹 OCR 文本行时使用保守回退；后续文字框与已有文字框重叠时，缩小到最大不重叠字号。

🐛 修复与改进

编辑器蒙版修复期间立即保存

• 编辑器蒙版修复尚未完成时，点击保存直接写入当前内存中的工程快照，不再提示、等待或拒绝保存。
• JSON 保存当前蒙版，修复图保存画布当前正在显示的修复图；修复完成后再次保存即可写入最新修复结果。

编辑器重复蒙版笔画重修

• 修复优化蒙版的画笔覆盖已有蒙版区域时，因二值蒙版无差异而跳过修复的问题；现在无需先擦除，重复涂抹会重新修复画笔触及的完整蒙版连通块，其他不相连区域保持不变。
• 重修笔画已直接纳入现有 delta/artifact 流水线，并通过 InpaintKey 淘汰连续操作中的过期异步结果。

编辑器 OCR 与翻译器配置分离

• 编辑器属性面板的 OCR 和翻译器选择改为独立保存，不再覆盖主页的 ocr.ocr 与 translator.translator 配置。
• 编辑器默认使用 mocr OCR 和 openai 翻译器。

旋转文本框导出位置修复

• 修复旧工程区域未保存 center 时，编辑器导出跳过白框中心换算，导致文字沿区域旋转方向偏移、成图与画布预览位置不一致的问题。
• 导出现在与编辑器画布共用 lines 的中心回退规则；富文本单字旋转（例如竖排波浪号的 rotation: -90）保持不变。

编辑器多行文本空格修复

• 修复在编辑器中修改多行文本时，除第一行外其他行的行首空格会被自动删除的问题（#246）。
• 换行与富文本段落转换现在会保留用户手动输入的行首、行尾空格。

OpenCV 5 面板检测兼容

• 修复 OpenCV 5 将 LSD 线段返回形状从 (N, 1, 4) 改为 (N, 4) 后，面板检测触发 IndexError: invalid index to scalar variable 并回退简单文本排序的问题。
• 面板线段解析现在同时兼容 OpenCV 4 和 OpenCV 5 的返回布局，多分格漫画可继续按面板阅读顺序排列文本。

超分临时目录清理

• 修复 ESRGAN 和 Waifu2x 超分进程失败或图片读写异常时未清理输入、输出临时目录的问题，避免 %TEMP% 持续积累临时文件。

curl_cffi Windows 证书路径修复

• 修复 Windows 下应用目录或虚拟环境路径包含非 ASCII 字符时，curl_cffi 读取 CA 证书路径失败并报 cURL error 77 的问题。
• 创建 curl_cffi 会话时，证书相关文件路径按 Windows 系统代码页传递给 libcurl；继续保留 HTTPS 证书校验。

Windows 中文路径模型下载修复

• 修复应用或模型目录包含中文等非 ASCII 字符，并以无控制台方式启动时，预处理阶段自动下载缺失模型会因 sys.stdout 为 None 而触发 'NoneType' object has no attribute 'isatty' 的问题。
• 下载进度现在仅使用可写的标准流；桌面进程没有控制台时自动禁用进度条，不影响模型写入和后续预处理。

自动更新版本来源修复

• UI 自动检查、维护工具和发布 Action 统一使用 packaging/VERSION 作为唯一应用版本来源。
• 不再读取或写入打包目录根部的 VERSION 文件，避免代码已更新到新版本但 UI 仍显示旧版本、反复提示更新的问题。

ONNX Runtime CUDA 提供者警告修复

• 修复 Windows 下使用 ONNX Runtime 1.28 加载 PaddleOCR ONNX 模型时，显式传入 device_id=0 触发 No registered plugin EP device found 警告的问题。
• CUDAExecutionProvider 现在默认使用设备 0，仅在调用方明确提供时传递额外 CUDA 参数；保留 CUDA 会话失败时自动回退 CPU 的行为。

PaddleOCR-VL 参数文档警告修复

• 修复 Transformers 5.15.0 加载 PaddleOCR-VL 图像处理器时，因 min_pixels 和 max_pixels 未出现在自动生成文档中而输出 [ERROR] 日志的问题。
• 通过应用内运行时兼容补丁补齐缺失文档，不直接修改 .venv 或系统 site-packages 文件；不改变图像缩放和推理参数行为。

自动断句几何匹配修复

• 修复无显式换行文本依赖 OCR region.lines 数量决定目标行列，导致译文无法适配实际文本框形状的问题。
• 自动断句现在枚举行数/列数组合，复用现有横排、竖排和文本尺寸测量算法，选择与传入布局矩形宽高比例最接近且不溢出的候选。
• 保留 OCR 单行区域的原有不换行特殊处理；多行区域不再使用 region.lines 数量作为自动断句目标。
• 中文语义断句仍优先使用 HanLP 语义边界；矩形形状搜索只选择候选行列数，模型不可用时回退普通换行。
• 智能气泡模式先使用气泡蒙版最大内接矩形进行形状匹配，再执行最终蒙版容纳检查。

字体大小滑块同步修复

• 修复属性面板字体大小输入框与滑块在区域切换、模型回写或连续调节时偶发显示错位的问题；两个控件现在通过单一同步入口更新，并在程序化刷新期间统一阻塞信号。
• 字号输入框继续支持 8–1000，滑块保持适合拖动的 8–150 范围；字号超过 150 时保留输入框真实值，滑块停在上限，不会反向截断字号。

多选文本框样式值显示修复

• 修复通过框选或 Ctrl+A 多选文本框时，样式设置中的字体大小、颜色、描边、间距、角度、字体、对齐方式和方向等数值被重置为默认值的问题。
• 多选时现在沿用第一个选中文本框的样式值显示，同时继续清空并禁用文本内容编辑，避免误显示某个区域的文本。

富文本字号起始值改进

• 富文本编辑器新增字号属性时，起始值改为当前选中文本框的实际字号，不再固定使用 24，便于基于现有排版继续调整（#249）。

属性编辑器快捷符号面板

• 在属性编辑器的译文框下方新增 Fluent 快捷符号按钮；面板按参考工具的符号栏提供全角/半角标点、竖排引号、波浪号、心形、圆形、音符、实心方形和全角空格，并在当前光标或选区处插入。
• 删除译文框下方的字符数显示，避免占用属性面板的垂直空间。
• 符号按钮保留原符号外观，并为每个符号提供独立的简体中文、繁体中文、英文、日文、韩文和西班牙文名称；全角空格显示为空白按钮，通过本地化悬浮提示说明用途。

v3.0.2 更新日志

发布日期：2026-08-19

🐛 修复与改进

本地工程文本只读导出

• 新增“仅从本地 JSON 导出文本”参数，同时控制“导出翻译”和“导出原文”，默认关闭。
• 开启后只读取已有工程 JSON 并生成对应文本副文件，不重新检测图片、不执行 OCR、不调用翻译 API，也不回写工程 JSON，避免覆盖用户已修改的译文。
• 找不到工程 JSON 时会明确报错且不回退 OCR；关闭参数时继续使用原有导出流程。
• 设置页和管理员权限编辑器均已加入该参数。

竖排破折号连续渲染修复

• 修复竖排连续破折号使用两个独立破折号字形时，连接处出现空隙或重叠的问题。
• 竖排替换规则现在直接将长破折号 — 转为表格框线字符 │；—— 自然得到 ││，不再进入富文本旋转规则。
• 删除破折号位图补齐、相邻负字距和额外像素重叠等特殊布局处理；短破折号 – 仍转为竖排形式 ︲。

富文本编辑器数值显示修复

• 修复描边、发光、外描边和偏移数值框被上下箭头挤占，导致数值显示不完整的问题。
• 隐藏上述数值框的上下箭头，同时保留鼠标滚轮调整数值。

编辑器状态同步修复

• 修复切换图片、工具或文本框时，原图不透明度、字体大小和画笔大小滑块未按当前上下文刷新状态的问题。
• 切换图片后会保持“显示文字和框线”“仅显示文字”“仅显示框线”“文字和框线均不显示”四种区域显示模式，并可从隐藏文字的模式正常恢复文字显示。

富文本宽高独立拉伸

• 浮动富文本编辑器新增 WH 样式；选中文字后可分别调整宽度（W）和高度（H）倍率，1.00 保持原尺寸，大于 1.00 拉伸，小于 1.00 压缩。
• 新增 transform.scaleX 与 transform.scaleY 富文本字段，并同步支持富文本规则、样式摘要和预设。
• 拉伸直接变换字形矢量轮廓后再光栅化，描边、外描边和发光基于拉伸后的轮廓生成，避免放大已有位图造成文字模糊。

编辑器右键菜单国际化

• 编辑器画布右键菜单已接入 i18n，OCR、翻译、复制、粘贴样式、删除、新建文本框、粘贴区域和刷新视图会随界面语言切换。
• 补齐简体中文、繁体中文、英语、日语、韩语和西班牙语菜单文案，删除项保留选中区域数量。

海外赞助入口优化

• 将 Ko-fi 海外赞助入口提升到二维码上方，使用高对比度强调卡片、说明文案和加大按钮，避免被国内二维码区域弱化。
• 补齐六种界面的海外赞助提示文案。

文本方向快捷键

• 编辑器新增 V 快捷键，可将选中文本框在横排与竖排之间切换；多选时以最后选中的文本框为基准统一应用方向。
• 焦点位于文本输入框时，V 仍输入普通字符，不会误改文本方向。

字体选择菜单交互修复

• 修复字体搜索框、字体列表与输入框宽度不一致，以及部分显示器缩放比例下搜索框错位的问题。
• 修复字体列表只显示部分末项时滚轮无法继续滚动的问题，同时支持鼠标滚轮和触控板像素滚动。
• 修复字体菜单向上弹出时搜索框被裁切、背景穿透和动画位置错误的问题；搜索框现在始终与字体输入框重合。
• 修复浮动编辑器移动或调整布局后字体菜单不跟随的问题，并恢复点击菜单外区域自动关闭。

v3.0.1 更新日志

发布日期：2026-08-15

🐛 修复与改进

Windows AMD ROCm 依赖检测修复

• 修复 Windows AMD ROCm PyTorch 已正常安装时，安装/更新程序仍提示“未检测到可用的 PyTorch”并重新进入依赖方案选择的问题。
• 兼容 PyTorch 检测结果中的 AMD 与 ROCm 两种类型标识，并统一映射到 rocm7.2.1 依赖方案。
• 修复后，安装器可正确识别类似 ROCm 7.2.53211-158bd99533 的运行时版本，避免误选 CPU、CUDA 或重复安装依赖。

文件夹修改时间排序修复

• 修复编辑器打开文件夹并按修改时间排序时，使用格式化日期字符串比较导致顺序错误的问题。
• 修改时间现按文件系统原始时间戳排序，例如 8 月 13 日会正确排在 8 月 2 日之后。

curl-cffi 网络传输升级

• 将 curl-cffi 从 0.15.0 升级并固定到 0.16.0，同步使用新版 curl 8.21 与 curl-impersonate 2.0 的修复和改进。
• OpenAI、Gemini、OCR、AI 渲染、AI 上色与 API 测试统一改用 impersonate="chrome"，自动跟随当前 Chrome 指纹，不再固定旧版 Chrome 110 指纹。
• 移除与 TLS 指纹版本不一致的手写 User-Agent、Sec-CH-UA 等浏览器身份请求头，避免请求头声明与底层 TLS/HTTP2 指纹冲突。
• curl-cffi 会话统一关闭环境变量代理自动读取，系统代理仅由应用内“使用系统代理”开关按请求地址解析，避免开关关闭后仍意外使用 HTTP_PROXY、HTTPS_PROXY 或 ALL_PROXY。

v3.0.0 更新日志

发布日期：2026-08-11

✨ 新功能

关于应用与全链路系统代理

• 主页导航新增“关于应用”页面，统一承载界面语言、主题、自动检查更新、手动检查更新、更新来源/分支和版本更新弹窗；“About Application”导航标题会随当前界面语言即时刷新。
• 新增“使用系统代理”开关。开启后，API 连接测试、模型列表、翻译、OCR、AI 渲染和 AI 上色都会通过 Qt 按每个请求地址查询操作系统代理，并正确处理 HTTP、SOCKS5、代理认证、NoProxy、PAC 与绕过规则；开关立即生效，不再要求开启 TUN 模式，也不会覆盖 Git 自身的代理配置。
• API 测试、模型列表以及翻译/OCR/渲染/上色的友好错误说明已完整接入简体中文、繁体中文、英语、日语、韩语和西班牙语；网络连接或 Host/DNS 解析失败时，会直接提示到“关于应用 → 应用偏好”开启系统代理。

API 通道拖拽排序

• API 管理页面的候选通道卡片新增拖拽手柄和插入位置提示，可直接把整组 Key/Model/Base 拖到新的优先级；松开后使用一次批量环境变量更新持久化连续编号，不再需要删除后重新粘贴。关联 #220。
• “按顺序故障切换”立即按新编号选择候选；“轮询”也以重排后的候选列表为基础，拖拽不会改变策略本身或其他功能页签的 API 配置。

API 管理候选通道恢复

• API 管理页面现在会为被运行期候选池标记为不可用或冷却中的通道显示状态标识，并提供“恢复 API 通道”按钮，可直接重新启用被禁用的 Key/通道。
• 开始翻译前的 API 可用性检查统一走 API 管理页的候选池检测逻辑，不再在 ConfigService 中重复维护一套空 Key / 可用 Key 判断。

按模型独立配置 API 超参数

• API 设置界面支持为不同模型创建和切换独立的参数预设，分别配置通用、翻译、OCR、渲染和上色等模块的自定义超参数；运行时按当前模型匹配预设，未匹配时回退到“通用”预设。关联 #205。

拟声词过滤

• 新增 detector.use_sfx_filter 拟声词过滤选项；启用 YOLO 辅助检测后，会过滤既未被 YOLO other 框包裹、也未与其他 YOLO OBB 框达到重叠阈值的主检测框，减少拟声词和装饰字误检。关联 #204。
• 主检测框缺少 YOLO 支持时会用 MangaLens 气泡掩码判定；判断为气泡内文本时仍会保留，避免正常对白被误过滤。

纯色气泡直接填色与逐块修复

• 修复设置新增两个独立开关（默认关闭），移植自 BallonsTranslator 的 check_need_inpaint 机制。关联 #172。
• 纯色气泡直接填色 inpainter.solid_fill_pure_bubbles：改用 MangaLens 气泡模型替代原 Canny 封闭轮廓检测，复用已有模型气泡重叠阈值和排版连通块匹配逻辑定位文本所在气泡；模型蒙版按短边 2%（至少 1px）内缩后减去外扩约 2px 的 mask_raw，剩余背景接近纯色时直接用中位色填充并跳过修复模型，模型未命中或背景不纯时继续常规修复。
• 气泡蒙版构建统一支持按整图或各连通块短边比例侵蚀；“扩大气泡修复范围”固定使用整图短边 2%，“膨胀不超过气泡蒙版”使用各气泡短边 1%，纯色气泡填充使用各气泡短边 2%。
• 逐块修复 inpainter.per_block_inpainting：将 mask refinement 生成的优化蒙版拆成孤立连通块，每块按自身外接框裁取 2 倍窗口，只携带当前连通块蒙版，图与蒙版同步反射补成正方形后单独修复再贴回；补方后不会进入长图切片流程，可减少整页长条掩码的文字鬼影，但因上下文减少，复杂背景的修复效果可能变差；CPU 下较小裁窗可能提高推理速度，连通块很多时多次模型调用的固定开销可能抵消收益。
• 两个开关可自由组合，全关时保持原有整页修复行为；已接入桌面设置页（修复 Tab）、Web 权限编辑器与中英文设置文档。

错误弹窗辅助排查

• 通用错误提示现在会显示当前日志文件的完整路径，并提示可将日志发给 AI 分析；仍无法判断时，提示带日志提交 GitHub issue 反馈。
• 翻译错误弹窗底部新增“打开日志文件夹”按钮，可直接打开 result/ 日志目录，方便定位并上传 log_*.txt。

自定义文本导出格式

• config/translation_template.json 模板顶部新增 "output_format": "json", 配置，默认将原文和译文分别导出为 _original.json 与 _translated.json。
• output_format 支持 txt、md、yaml、csv 等任意安全扩展名；扩展名只控制输出文件名，所有格式继续共用 <original> / <translated> 模板解析和导入逻辑。
• 导出前会自动移除顶部 output_format 配置行，不会将其写入最终文本内容；关闭“覆盖已存在文件”时，也会按当前配置扩展名检查对应的原文或译文文件。
• 启动时会通过上一版 JSON 默认模板的 MD5 判断是否需要升级：只有内容仍与旧默认模板完全一致时才自动更新，用户自行修改过的模板不会被覆盖。

编辑器保存、导出与快捷键

• 编辑器顶部新增独立的“保存”和“导出图片”按钮：保存仅持久化 JSON、蒙版、画笔/印章覆盖层与当前修复图，不生成最终渲染图片；导出仅生成最终图片，不修改工程数据或保存状态。
• 新增“切图时自动保存”和“切图时自动导出”两个独立开关；两者同时开启时会分别保存工程数据并提交导出快照，互不代替。
• 编辑器菜单新增“不再提醒未保存”开关（默认关闭）；开启后，在自动保存和自动导出均关闭时切换图片会直接放弃当前未保存工程修改，不再弹出确认框。
• 新增 Ctrl+S 保存快捷键；保留 Ctrl+Q 导出快捷键；新增 Ctrl+Shift+R 显示或关闭浮动富文本编辑器，焦点位于浮动编辑窗口内时同样可用。
• “图像编辑”新增 1/2/3 页签快捷键，分别切换“蒙版”/“画笔”/“印章”；Q/W/E 改为固定选择当前页从左到右的三个工具。

编辑器仿制印章与独立印章层

• 编辑器"图像编辑"分组（原"蒙版编辑"）新增"印章"页，与蒙版/画笔页结构一致，包含仿制印章、橡皮擦、画笔大小和清除印章层。
• 仿制印章右键取样、左键拖动盖印；首次落笔锁定取样偏移并跨笔画保持（传递仿制），再次右键才重置。盖印为逐点实时进行，取样源为画布当前可见内容（修复图 + 画笔层 + 印章层），同一笔刚盖出的内容可继续被取样传递；硬边像素对齐。
• 印章内容写入独立于画笔层的印章图层，撤销/重做、橡皮擦与清除互不影响；画笔页与印章页各提供图层显示/隐藏开关（仅影响画布显示，不影响导出）。
• 画笔层与印章层改为以 base64 PNG 形式存入工程 JSON（同 mask_raw 方式），不再单独写 paint_overlay 目录 PNG；加载时优先读取 JSON 内图层，兼容读取旧版单文件 PNG。
• 导出时两层由后端在渲染前按"画笔 → 印章"顺序合成到修复图上（不烤进落盘的修复图文件）；后端非编辑器场景回写 JSON 时会保留已有图层键。

编辑器中心点缩放

• 编辑器“菜单”新增“中心点缩放”开关（默认关闭）。开启后，拖动文本框任意边或角时会以当前文本框中心为锚点实时对称缩放；旋转文本框同样适用，开关状态会持久化保存。

删除文本框并恢复原图

• 编辑器“菜单”新增“删除文本框并恢复原图”开关。开启后删除文本框会同步移除其原始/精修蒙版，使被抹除区域恢复原图；蒙版与文本框删除一起支持撤销/重做。功能参考 BallonsTranslator（BT）实现。

中文语义断句

• 新增中文语义断句开关，使用本地 HanLP 粗分与成分句法模型保护中文短语块，并在智能气泡模式下记录结构化 JSON 调试信息，便于对比候选断句和气泡 mask。

完整富文本支持

• 新增 richtext.v1 结构化富文本协议，使用 TextRun、RubyRun 和 TcyRun 描述普通文本、Ruby 注音与纵中横内容；普通字符串会自动归一为默认单文本段文档，兼容原有纯文本数据和渲染流程。
• 横排与竖排统一接入结构化富文本的测量、布局和渲染路径，支持粗体、斜体角度、下划线、文字颜色、字号、倍率、字体 family、描边、外描边、发光和着重号等样式。
• 下划线为行/列级装饰：横排沿行方向铺