Release v1.6.3 - 添加 PaddleOCR 支持

新功能：
- ✨ 新增 PaddleOCR (PP-OCRv5) 支持
  - 支持中文/日文/英文识别 (paddleocr)
  - 支持韩文/英文识别 (paddleocr_korean)
  - 使用透视变换和自动旋转处理倾斜文本
  - 自动识别并旋转竖排文本

技术改进：
- 🔧 修复 PyInstaller 打包后的资源路径问题
  - 统一使用 sys._MEIPASS 处理打包环境
  - .env 文件与 exe 同级目录
  - 所有资源文件在 _internal 目录
- 🔧 修复配置文件路径适配（config-example.json, gpt_config-example.yaml）
- 🔧 更新 GitHub Actions 模型下载到 v1.6.0
- 🔧 添加 PaddleOCR-main 到 .gitignore

🤖 Generated with Claude Code
https://claude.com/claude-code

Co-Authored-By: Claude <noreply@anthropic.com>

Author: hgmzhn

.github/workflows/build-and-release.yml

@@ -68,7 +68,7 @@ jobs:
         GH_TOKEN: ${{ github.token }}
       run: |
         echo "Downloading models from release assets..."
-        gh release download v1.4.6 -p "models.7z"
+        gh release download v1.6.0 -p "models.7z"
 
         echo "Decompressing models..."
         7z x "models.7z" -o./extracted_models

.gitignore

@@ -32,6 +32,13 @@ result/
 # Wheel files
 *.whl
 
+# Archive files
+*.7z
+
+# Model files
+models/ocr/*.onnx
+models/ocr/*.txt
+
 # Backup files
 *.bak
 *.backup
@@ -51,6 +58,7 @@ desktop-ui/temp/
 19_translations.json
 desktop-ui/user_data/
 manga-image-translator-main/
+PaddleOCR-main/
 
 # Ignore temporary clone check directory
 temp_clone_check/

README.md

@@ -122,6 +122,7 @@
 - `ocr48px`: 48像素OCR模型
 - `ocr48px_ctc`: CTC OCR模型
 - `mocr`: Manga OCR专用模型
+- `paddleocr`: PaddleOCR (基于PaddlePaddle的OCR引擎)
 
 ## 安装和运行
 

cache_tufup/metadata/root.json

@@ -197,6 +197,7 @@ def open_output_folder(self):
     def open_font_directory(self):
         import subprocess
         import sys
+        # fonts目录在_internal里（打包后）或项目根目录（开发时）
         fonts_dir = os.path.join(self.config_service.root_dir, 'fonts')
         try:
             if not os.path.exists(fonts_dir):
@@ -213,6 +214,7 @@ def open_font_directory(self):
     def open_dict_directory(self):
         import subprocess
         import sys
+        # dict目录在_internal里（打包后）或项目根目录（开发时）
         dict_dir = os.path.join(self.config_service.root_dir, 'dict')
         try:
             if not os.path.exists(dict_dir):
@@ -228,13 +230,14 @@ def open_dict_directory(self):
 
     def get_hq_prompt_options(self) -> List[str]:
         try:
+            # dict目录在_internal里（打包后）或项目根目录（开发时）
             dict_dir = os.path.join(self.config_service.root_dir, 'dict')
             if not os.path.isdir(dict_dir):
                 return []
             prompt_files = sorted([
-                f for f in os.listdir(dict_dir) 
+                f for f in os.listdir(dict_dir)
                 if f.lower().endswith('.json') and f not in [
-                    'system_prompt_hq.json', 
+                    'system_prompt_hq.json',
                     'system_prompt_line_break.json'
                 ]
             ])

desktop_qt_ui/app_logic.py

@@ -7,7 +7,8 @@ class TranslatorSettings(BaseModel):
     translator: str = "openai_hq"
     target_lang: str = "CHS"
     no_text_lang_skip: bool = False
-    gpt_config: Optional[str] = "../examples/gpt_config-example.yaml"
+    # 相对路径，后端会用BASE_PATH拼接（打包后=_internal，开发时=项目根目录）
+    gpt_config: Optional[str] = "examples/gpt_config-example.yaml"
     high_quality_prompt_path: Optional[str] = "dict/prompt_example.json"
 
 class OcrSettings(BaseModel):

desktop_qt_ui/core/config_models.py

@@ -482,48 +482,7 @@ def mousePressEvent(self, event: QGraphicsSceneMouseEvent):
         local_pos = event.pos()
 
         # 限制日志频率：每秒最多打印一次
-        import time
-        current_time = time.time()
-        if not hasattr(self, '_last_mouse_log_time'):
-            self._last_mouse_log_time = 0
-
-        should_log = current_time - self._last_mouse_log_time >= 1.0
-
-        if should_log:
-            print(f"\n[MOUSE DEBUG] Region {self.region_index}")
-            print(f"  scenePos={event.scenePos()}")
-            print(f"  self.pos()={self.pos()}")
-            print(f"  local_pos={local_pos}")
-            print(f"  isSelected={self.isSelected()}")
-            print(f"  zValue={self.zValue()}")
-            print(f"  boundingRect={self.boundingRect()}")
-
-            # 检查Qt在这个位置找到了哪些items
-            if self.scene():
-                items_at_pos = self.scene().items(event.scenePos())
-                print(f"  Qt found {len(items_at_pos)} items at click position:")
-                for idx, item in enumerate(items_at_pos):
-                    is_self = (item == self)
-                    item_type = type(item).__name__
-                    z = item.zValue() if hasattr(item, 'zValue') else 'N/A'
-                    region_idx = item.region_index if hasattr(item, 'region_index') else 'N/A'
-                    print(f"    [{idx}] {item_type} (region={region_idx}, z={z}) {'<-- THIS' if is_self else ''}")
-
-            print(f"  polygons count={len(self.polygons)}")
-            for i, poly in enumerate(self.polygons):
-                if poly.containsPoint(local_pos, Qt.FillRule.WindingFill):
-                    print(f"    polygon {i}: CONTAINS local_pos!")
-
-            # 测试shape()是否包含点击点
-            test_shape = self.shape()
-            shape_contains = test_shape.contains(local_pos)
-            print(f"  shape().contains(local_pos)={shape_contains}")
-            print(f"  shape().boundingRect()={test_shape.boundingRect()}")
-
-            self._last_mouse_log_time = current_time
-
         if event.button() == Qt.MouseButton.LeftButton:
-            print(f"[ITEM] RegionTextItem.mousePressEvent: region={self.region_index}, isSelected={self.isSelected()}")
             if self.isSelected():
                 self.setFlag(QGraphicsItem.GraphicsItemFlag.ItemIsMovable, True)
 
@@ -540,7 +499,6 @@ def mousePressEvent(self, event: QGraphicsSceneMouseEvent):
                 # --- End Snapshot ---
 
                 handle, indices = self._get_handle_at(local_pos)
-                print(f"[HANDLE DEBUG] 检测到 handle='{handle}', indices={indices}, isSelected={self.isSelected()}, show_white_box={self._show_white_box}, white_frame_rect_local={self._white_frame_rect_local}")
                 if handle:
                     self._interaction_mode = handle
                     self._drag_handle_indices = indices
@@ -576,12 +534,10 @@ def mousePressEvent(self, event: QGraphicsSceneMouseEvent):
                 if self.scene() and self.scene().views():
                     view = self.scene().views()[0]
                     if hasattr(view, 'model'):
-                        print(f"[ITEM] Region {self.region_index} not selected, calling model.set_selection directly")
                         view.model.set_selection([self.region_index])
                         event.accept()  # Accept 事件，阻止传播到 GraphicsView
                         return
                 # 如果无法获取 model，fallback 到原来的行为
-                print(f"[ITEM] Region {self.region_index} not selected, letting GraphicsView handle selection")
                 super().mousePressEvent(event)
                 event.ignore()
                 return

desktop_qt_ui/editor/graphics_items.py

@@ -457,7 +457,6 @@ def _perform_single_item_update(self, index):
 
     def _perform_render_update(self):
         """执行实际的渲染更新，由防抖计时器调用。"""
-        print(f"[_perform_render_update] 开始完全更新")
         # Clear old region items safely
         for item in self._region_items:
             try:
@@ -470,11 +469,9 @@ def _perform_render_update(self):
 
         # Add a new item for each REGION
         regions = self.model.get_regions()
-        print(f"[_perform_render_update] regions 数量: {len(regions)}")
         for i, region_data in enumerate(regions):
             if not region_data.get('lines'):
                 continue
-            print(f"[_perform_render_update] 创建 item {i}")
             item = RegionTextItem(
                 region_data,
                 i,
@@ -483,7 +480,6 @@ def _perform_render_update(self):
             item.setZValue(100)
             self.scene.addItem(item)
             self._region_items.append(item)
-        print(f"[_perform_render_update] 完成,共创建 {len(self._region_items)} 个 items")
 
         # After updating items, recalculate all rendering data
         self.recalculate_render_data()
@@ -598,9 +594,6 @@ def _update_text_visuals(self):
                 item.update_text_pixmap(QPixmap(), QPointF(0, 0))
 
             # 无论是否有渲染结果,都设置绿框数据(即使 translation 为空)
-            print(f"[_update_single_region_text_visual] region {i}: 设置绿框, dst_points is None: {self._dst_points_cache[i] is None}")
-            if self._dst_points_cache[i] is not None:
-                print(f"[_update_single_region_text_visual] region {i}: dst_points shape: {self._dst_points_cache[i].shape}")
             item.set_dst_points(self._dst_points_cache[i])
 
     def _recalculate_single_region_render_data(self, index):
@@ -937,7 +930,6 @@ def mousePressEvent(self, event):
                 # 如果有 item 处理了事件，event 会被 accept
                 # 只有真正点击空白时，event 才不会被 accept
                 if not event.isAccepted():
-                    print(f"[VIEW] Click on empty area (event not accepted), clearing selection")
                     self.model.set_selection([])
 
     def mouseMoveEvent(self, event):
@@ -1109,7 +1101,11 @@ def _finish_drawing(self):
         # Convert final mask to numpy and update model
         ptr = mask_image.constBits()
         ptr.setsize(mask_image.sizeInBytes())
-        new_mask_np = np.array(ptr).reshape(mask_image.height(), mask_image.width())
+        # Use bytesPerLine to handle row padding correctly
+        bytes_per_line = mask_image.bytesPerLine()
+        new_mask_np = np.array(ptr).reshape(mask_image.height(), bytes_per_line)
+        # Crop to actual width if there's padding
+        new_mask_np = new_mask_np[:, :mask_image.width()].copy()
 
         # --- Refactored to Command Pattern ---
         from .commands import MaskEditCommand
@@ -1160,7 +1156,6 @@ def _on_brush_size_changed(self, size: int):
 
     def _on_selection_changed(self, selected_indices: list):
         """同步model的selection到Qt item的selected状态"""
-        print(f"[VIEW] _on_selection_changed called: selected_indices={selected_indices}")
 
         # 先清除所有item的selection
         for item in self._region_items:
@@ -1170,9 +1165,7 @@ def _on_selection_changed(self, selected_indices: list):
         # 设置新选中的items
         for idx in selected_indices:
             if 0 <= idx < len(self._region_items):
-                print(f"[VIEW] Setting item {idx} selected=True")
                 self._region_items[idx].setSelected(True)
-                print(f"[VIEW] After setSelected, item.isSelected()={self._region_items[idx].isSelected()}")
 
     def _update_cursor(self):
         """Updates the cursor to match the selected tool and brush size."""

desktop_qt_ui/editor/graphics_view.py

@@ -34,9 +34,8 @@ def update_font_config(font_filename: str):
     if os.path.exists(font_path):
         try:
             set_font(font_path)
-            print(f"[BackendTextRenderer] Font updated: {font_path}")
         except Exception as e:
-            print(f"[BackendTextRenderer] Failed to update font: {e}")
+            pass  # Silently ignore font update errors
 
 def render_text_for_region(text_block: TextBlock, dst_points: np.ndarray, transform, render_params: dict, pure_zoom: float = 1.0, total_regions: int = 1):
     """

desktop_qt_ui/editor/text_renderer_backend.py

@@ -41,7 +41,14 @@ def main():
     app = QApplication(sys.argv)
 
     # 2. 初始化所有服务
-    root_dir = os.path.abspath(os.path.join(os.path.dirname(__file__), '..'))
+    # 设置正确的根目录：打包后指向_internal，开发时指向项目根目录
+    if getattr(sys, 'frozen', False) and hasattr(sys, '_MEIPASS'):
+        # PyInstaller打包环境：所有资源在_internal目录
+        root_dir = sys._MEIPASS
+    else:
+        # 开发环境：资源在项目根目录
+        root_dir = os.path.abspath(os.path.join(os.path.dirname(__file__), '..'))
+
     if not init_services(root_dir):
         logging.fatal("Fatal: Service initialization failed.")
         sys.exit(1)