repdf 0.1.0__tar.gz → 0.1.2__tar.gz

{repdf-0.1.0 → repdf-0.1.2}/PKG-INFO

@@ -1,13 +1,13 @@
 Metadata-Version: 2.3
 Name: repdf
-Version: 0.1.0
+Version: 0.1.2
 Summary: RePDF (Read the PDF): a desktop PDF reader with printing, search, bookmarks, OCR and page rearrangement.
 Requires-Dist: onnxruntime>=1.31.0,<2
 Requires-Dist: pillow>=11.0,<13
 Requires-Dist: pypdf[crypto]>=5.0,<7
 Requires-Dist: pypdfium2>=4.30,<6
 Requires-Dist: pyside6>=6.8,<7
-Requires-Dist: rapidocr==3.10.0
+Requires-Dist: rapidocr[rtl]==3.10.0
 Requires-Dist: regex>=2024.11.6
 Requires-Python: >=3.11
 Project-URL: Homepage, https://github.com/codemee/repdf
@@ -19,7 +19,7 @@ Description-Content-Type: text/markdown
 
 [繁體中文](README.md) | [English](README.en.md)
 
-RePDF 代表 **Read the PDF**，命令與 Python 套件名稱為 `repdf`。這是一套桌面 PDF 閱讀器，支援多標籤閱讀、列印、書籤與目錄跳頁、文字搜尋、選字複製、OCR 及圖片擷取，也可勾選頁面，依標籤與頁面排列順序重組或拆分輸出。重組與拆分保留原始頁面品質。
+RePDF 代表 **Read the PDF**，命令與 Python 套件名稱為 `repdf`。這是一套桌面 PDF 閱讀器，支援多標籤閱讀、列印、書籤與目錄跳頁、註解清單、文字搜尋、選字複製、OCR 及圖片擷取，也可勾選頁面，依標籤與頁面排列順序重組或拆分輸出。重組與拆分保留原始頁面品質。
 
 ## 重點特色
 
@@ -36,7 +36,7 @@ RePDF 代表 **Read the PDF**，命令與 Python 套件名稱為 `repdf`。這
 - **macOS Apple Silicon（arm64）**：下載 `repdf-<版本>-macos-arm64.dmg`，開啟後將 `RePDF.app` 拖入 Applications，再從 Applications 啟動。
 
 - Release 同時提供 SHA256 校驗檔。
-- 桌面套件已包含 OCR 執行環境與模型，不需要額外安裝。
+- 桌面套件已包含 OCR 執行環境與內建多語言模型；其他語言可在首次選用時下載，之後離線辨識。
 - 目前未設定 Windows 程式碼簽章或 macOS Developer ID 簽章／公證，下載後可能出現系統安全提示。
 
 ### 2. 使用 uv tool 安裝
@@ -68,6 +68,7 @@ repdf
 | <picture><source media="(prefers-color-scheme: dark)" srcset="docs/images/toolbar-ocr-region-dark.png"><img src="docs/images/toolbar-ocr-region.png" width="24" alt="區域 OCR 圖示"></picture> | 區域 OCR | 拖曳矩形框選頁面或圖片，放開滑鼠後辨識並複製文字。 | — |
 | <picture><source media="(prefers-color-scheme: dark)" srcset="docs/images/toolbar-extract-image-dark.png"><img src="docs/images/toolbar-extract-image.png" width="24" alt="擷取圖片圖示"></picture> | 擷取圖片 | 啟用後點選內嵌點陣圖片，再選擇位置另存為 PNG。 | — |
 | <picture><source media="(prefers-color-scheme: dark)" srcset="docs/images/toolbar-bookmarks-dark.png"><img src="docs/images/toolbar-bookmarks.png" width="24" alt="書籤圖示"></picture> | 書籤 | 在左側章節樹展開或收合書籤，點選章節即可跳頁。 | — |
+| <picture><source media="(prefers-color-scheme: dark)" srcset="docs/images/toolbar-annotations-dark.png"><img src="docs/images/toolbar-annotations.png" width="24" alt="註解圖示"></picture> | 註解 | 在左側列出註解，點選即可跳至對應頁面。 | — |
 | <picture><source media="(prefers-color-scheme: dark)" srcset="docs/images/toolbar-search-dark.png"><img src="docs/images/toolbar-search.png" width="24" alt="搜尋文字圖示"></picture> | 搜尋文字 | 在右側窗格搜尋文字，上方選檔案、下方選命中段落，單擊即可跳頁並高亮。 | Windows／Linux：<kbd>Ctrl</kbd>+<kbd>F</kbd>；macOS：<kbd>⌘</kbd>+<kbd>F</kbd> |
 | <picture><source media="(prefers-color-scheme: dark)" srcset="docs/images/toolbar-zoom-dark.png"><img src="docs/images/toolbar-zoom.png" width="160" alt="顯示比例與縮放滑桿"></picture> | 顯示比例 | 滑桿調整 25%–200%；點擊比例回到 100%。鍵盤縮放每次調整 25 個百分點。 | 放大：<kbd>Ctrl</kbd>+<kbd>+</kbd>／<kbd>Ctrl</kbd>+<kbd>=</kbd>；縮小：<kbd>Ctrl</kbd>+<kbd>-</kbd>；100%：<kbd>Ctrl</kbd>+<kbd>0</kbd> |
 | <picture><source media="(prefers-color-scheme: dark)" srcset="docs/images/toolbar-fit-dark.png"><img src="docs/images/toolbar-fit.png" width="24" alt="Fit 圖示"></picture> | Fit | 將目前單頁等比例縮放至預覽區；調整視窗大小時自動適應。拖動滑桿或使用縮放快捷鍵會回到手動比例。 | — |
@@ -153,11 +154,25 @@ repdf
 - 書籤跟隨目前標籤頁切換；沒有內建書籤的文件會顯示提示。
 - 一般預覽與全螢幕都可直接點選 PDF 頁內的目錄連結；滑鼠移到可跳頁區域時會顯示手指游標與目的頁碼。
 - 跳頁保留目前縮放／Fit 模式。頁面已重新排序時，仍會找到目的章節所屬的原始頁面。
-- 視窗縮窄時，書籤與 PDF 以單一窗格切換；點選章節後返回 PDF，再點「書籤」可返回目錄。搜尋與書籤窗格可透過各自的工具按鈕切換。
+- 視窗縮窄時，書籤與 PDF 以單一窗格切換；點選章節後返回 PDF，再點「書籤」可返回目錄。書籤、註解與搜尋窗格可透過各自的工具按鈕切換。
 - 啟用複製文字、區域 OCR 或圖片擷取模式時，頁內連結暫停點選；停用後即可跳頁，拖曳頁面仍可排序。
 - 一般預覽與全螢幕可點選 PDF 內建的 HTTP／HTTPS 超連結，以系統預設瀏覽器開啟；滑鼠停留可查看網址。
 - 此功能使用 PDF 已有的書籤與連結；純文字或掃描圖片形式的目錄、網址不會自動變成連結。電子郵件、外部文件與其他動作不在支援範圍。
 
+### 註解清單
+
+- 點工具列的「註解」對話框圖示，開啟目前標籤頁的左側註解清單。
+- 清單依 PDF 原始頁序分組，每頁顯示註解數量，預設收合；展開後查看個別註解的類型與摘要。切換標籤、書籤或介面語言後會保留展開狀態。滑鼠停留可查看完整內容、作者、主旨及修改時間（若文件有提供）。
+- 點選頁碼群組即可跳到該頁清單中的第一個註解，並標示其範圍；點選個別註解會跳到對應位置，並以半透明底色與外框標示註解範圍。保留目前縮放／Fit 模式，頁面重新排列後仍會找到原始目標頁。
+- 選取含文字的註解時，會自動將註解文字複製到剪貼簿；頁碼群組會複製第一個註解的文字。無文字的註解不會覆蓋剪貼簿內容。
+- 關閉註解窗格或切換至其他側欄時，會取消框選；重新開啟清單不會自動複製文字或恢復框選。
+- 框選會跟隨縮放與全螢幕顯示；點選另一註解或頁碼群組會更新標示，點選書籤或搜尋結果則清除標示。文件未提供有效註解範圍時，仍可跳頁。
+- 支援備註、文字方塊、螢光標示、底線、刪除線、手繪及形狀等註解。文字標示若沒有附註內容，會嘗試顯示標示的原文。
+- 在一般閱讀模式可直接點選頁面上的註解，框選其範圍並同步選取左側清單、展開對應頁面群組；全螢幕也可使用。選字、區域 OCR 與圖片擷取模式保留各自操作。窄視窗點選後維持 PDF 顯示，再按「註解」即可查看清單中的選取項目。
+- 註解跟隨標籤頁切換；沒有註解時顯示提示。書籤、註解與搜尋窗格透過各自的按鈕切換。
+- 視窗較窄時，點選後返回 PDF；再點「註解」可返回清單。
+- 完整註解清單只在開啟窗格時於背景讀取；頁面點選範圍則隨目前需要顯示的頁面讀取，不會在開檔時掃描整份文件；此功能提供檢視與跳頁，不編輯註解或執行附件內容。
+
 ### 搜尋文字
 
 1. 點「搜尋文字」或按 <kbd>Ctrl</kbd>+<kbd>F</kbd>（macOS：<kbd>⌘</kbd>+<kbd>F</kbd>），開啟右側窗格。
@@ -214,7 +229,10 @@ repdf
 - 輸出完整內嵌圖片，不套用頁面上的旋轉或裁切，也不包含周圍文字與向量圖形。
 - 點到空白處會顯示提示；同一位置有多張圖片時，選取最後繪製的圖片。
 - 掃描頁面通常會擷取整張掃描圖，無法從中直接分離照片或圖表。
-- OCR 支援繁體中文、簡體中文、英文、日文及多種拉丁字母語言，不支援韓文；辨識後請校對結果。完整操作與限制見 [OCR 說明](docs/OCR.md)。
+- OCR 預設支援繁體中文、簡體中文、英文、日文及多種拉丁字母語言。點「區域 OCR」旁的箭頭，可選韓文、泰文、俄文／烏克蘭文、阿拉伯文與印地文／尼泊爾文；另提供希臘文、泰米爾文與泰盧固文。
+- 選「自動＋已下載模型」可共用內建與已下載模型，逐行選擇辨識結果，不會自行下載其他模型。
+- 語言選單以分隔線區分自動選項、已下載與未下載三組，不顯示群組標題；已下載的模型名稱後會標記「已下載」。模型下載、遺失或損壞後，分組與標記會自動更新。
+- 額外模型會先顯示下載確認，下載完成才切換語言；取消或失敗保留原設定。語言設定會記住，並套用於區域 OCR 及損壞文字備援。辨識後請校對結果。完整操作與限制見 [OCR 說明](docs/OCR.md)。
 
 ## 語言與配色
 

{repdf-0.1.0 → repdf-0.1.2}/README.md

@@ -2,7 +2,7 @@
 
 [繁體中文](README.md) | [English](README.en.md)
 
-RePDF 代表 **Read the PDF**，命令與 Python 套件名稱為 `repdf`。這是一套桌面 PDF 閱讀器，支援多標籤閱讀、列印、書籤與目錄跳頁、文字搜尋、選字複製、OCR 及圖片擷取，也可勾選頁面，依標籤與頁面排列順序重組或拆分輸出。重組與拆分保留原始頁面品質。
+RePDF 代表 **Read the PDF**，命令與 Python 套件名稱為 `repdf`。這是一套桌面 PDF 閱讀器，支援多標籤閱讀、列印、書籤與目錄跳頁、註解清單、文字搜尋、選字複製、OCR 及圖片擷取，也可勾選頁面，依標籤與頁面排列順序重組或拆分輸出。重組與拆分保留原始頁面品質。
 
 ## 重點特色
 
@@ -19,7 +19,7 @@ RePDF 代表 **Read the PDF**，命令與 Python 套件名稱為 `repdf`。這
 - **macOS Apple Silicon（arm64）**：下載 `repdf-<版本>-macos-arm64.dmg`，開啟後將 `RePDF.app` 拖入 Applications，再從 Applications 啟動。
 
 - Release 同時提供 SHA256 校驗檔。
-- 桌面套件已包含 OCR 執行環境與模型，不需要額外安裝。
+- 桌面套件已包含 OCR 執行環境與內建多語言模型；其他語言可在首次選用時下載，之後離線辨識。
 - 目前未設定 Windows 程式碼簽章或 macOS Developer ID 簽章／公證，下載後可能出現系統安全提示。
 
 ### 2. 使用 uv tool 安裝
@@ -51,6 +51,7 @@ repdf
 | <picture><source media="(prefers-color-scheme: dark)" srcset="docs/images/toolbar-ocr-region-dark.png"><img src="docs/images/toolbar-ocr-region.png" width="24" alt="區域 OCR 圖示"></picture> | 區域 OCR | 拖曳矩形框選頁面或圖片，放開滑鼠後辨識並複製文字。 | — |
 | <picture><source media="(prefers-color-scheme: dark)" srcset="docs/images/toolbar-extract-image-dark.png"><img src="docs/images/toolbar-extract-image.png" width="24" alt="擷取圖片圖示"></picture> | 擷取圖片 | 啟用後點選內嵌點陣圖片，再選擇位置另存為 PNG。 | — |
 | <picture><source media="(prefers-color-scheme: dark)" srcset="docs/images/toolbar-bookmarks-dark.png"><img src="docs/images/toolbar-bookmarks.png" width="24" alt="書籤圖示"></picture> | 書籤 | 在左側章節樹展開或收合書籤，點選章節即可跳頁。 | — |
+| <picture><source media="(prefers-color-scheme: dark)" srcset="docs/images/toolbar-annotations-dark.png"><img src="docs/images/toolbar-annotations.png" width="24" alt="註解圖示"></picture> | 註解 | 在左側列出註解，點選即可跳至對應頁面。 | — |
 | <picture><source media="(prefers-color-scheme: dark)" srcset="docs/images/toolbar-search-dark.png"><img src="docs/images/toolbar-search.png" width="24" alt="搜尋文字圖示"></picture> | 搜尋文字 | 在右側窗格搜尋文字，上方選檔案、下方選命中段落，單擊即可跳頁並高亮。 | Windows／Linux：<kbd>Ctrl</kbd>+<kbd>F</kbd>；macOS：<kbd>⌘</kbd>+<kbd>F</kbd> |
 | <picture><source media="(prefers-color-scheme: dark)" srcset="docs/images/toolbar-zoom-dark.png"><img src="docs/images/toolbar-zoom.png" width="160" alt="顯示比例與縮放滑桿"></picture> | 顯示比例 | 滑桿調整 25%–200%；點擊比例回到 100%。鍵盤縮放每次調整 25 個百分點。 | 放大：<kbd>Ctrl</kbd>+<kbd>+</kbd>／<kbd>Ctrl</kbd>+<kbd>=</kbd>；縮小：<kbd>Ctrl</kbd>+<kbd>-</kbd>；100%：<kbd>Ctrl</kbd>+<kbd>0</kbd> |
 | <picture><source media="(prefers-color-scheme: dark)" srcset="docs/images/toolbar-fit-dark.png"><img src="docs/images/toolbar-fit.png" width="24" alt="Fit 圖示"></picture> | Fit | 將目前單頁等比例縮放至預覽區；調整視窗大小時自動適應。拖動滑桿或使用縮放快捷鍵會回到手動比例。 | — |
@@ -136,11 +137,25 @@ repdf
 - 書籤跟隨目前標籤頁切換；沒有內建書籤的文件會顯示提示。
 - 一般預覽與全螢幕都可直接點選 PDF 頁內的目錄連結；滑鼠移到可跳頁區域時會顯示手指游標與目的頁碼。
 - 跳頁保留目前縮放／Fit 模式。頁面已重新排序時，仍會找到目的章節所屬的原始頁面。
-- 視窗縮窄時，書籤與 PDF 以單一窗格切換；點選章節後返回 PDF，再點「書籤」可返回目錄。搜尋與書籤窗格可透過各自的工具按鈕切換。
+- 視窗縮窄時，書籤與 PDF 以單一窗格切換；點選章節後返回 PDF，再點「書籤」可返回目錄。書籤、註解與搜尋窗格可透過各自的工具按鈕切換。
 - 啟用複製文字、區域 OCR 或圖片擷取模式時，頁內連結暫停點選；停用後即可跳頁，拖曳頁面仍可排序。
 - 一般預覽與全螢幕可點選 PDF 內建的 HTTP／HTTPS 超連結，以系統預設瀏覽器開啟；滑鼠停留可查看網址。
 - 此功能使用 PDF 已有的書籤與連結；純文字或掃描圖片形式的目錄、網址不會自動變成連結。電子郵件、外部文件與其他動作不在支援範圍。
 
+### 註解清單
+
+- 點工具列的「註解」對話框圖示，開啟目前標籤頁的左側註解清單。
+- 清單依 PDF 原始頁序分組，每頁顯示註解數量，預設收合；展開後查看個別註解的類型與摘要。切換標籤、書籤或介面語言後會保留展開狀態。滑鼠停留可查看完整內容、作者、主旨及修改時間（若文件有提供）。
+- 點選頁碼群組即可跳到該頁清單中的第一個註解，並標示其範圍；點選個別註解會跳到對應位置，並以半透明底色與外框標示註解範圍。保留目前縮放／Fit 模式，頁面重新排列後仍會找到原始目標頁。
+- 選取含文字的註解時，會自動將註解文字複製到剪貼簿；頁碼群組會複製第一個註解的文字。無文字的註解不會覆蓋剪貼簿內容。
+- 關閉註解窗格或切換至其他側欄時，會取消框選；重新開啟清單不會自動複製文字或恢復框選。
+- 框選會跟隨縮放與全螢幕顯示；點選另一註解或頁碼群組會更新標示，點選書籤或搜尋結果則清除標示。文件未提供有效註解範圍時，仍可跳頁。
+- 支援備註、文字方塊、螢光標示、底線、刪除線、手繪及形狀等註解。文字標示若沒有附註內容，會嘗試顯示標示的原文。
+- 在一般閱讀模式可直接點選頁面上的註解，框選其範圍並同步選取左側清單、展開對應頁面群組；全螢幕也可使用。選字、區域 OCR 與圖片擷取模式保留各自操作。窄視窗點選後維持 PDF 顯示，再按「註解」即可查看清單中的選取項目。
+- 註解跟隨標籤頁切換；沒有註解時顯示提示。書籤、註解與搜尋窗格透過各自的按鈕切換。
+- 視窗較窄時，點選後返回 PDF；再點「註解」可返回清單。
+- 完整註解清單只在開啟窗格時於背景讀取；頁面點選範圍則隨目前需要顯示的頁面讀取，不會在開檔時掃描整份文件；此功能提供檢視與跳頁，不編輯註解或執行附件內容。
+
 ### 搜尋文字
 
 1. 點「搜尋文字」或按 <kbd>Ctrl</kbd>+<kbd>F</kbd>（macOS：<kbd>⌘</kbd>+<kbd>F</kbd>），開啟右側窗格。
@@ -197,7 +212,10 @@ repdf
 - 輸出完整內嵌圖片，不套用頁面上的旋轉或裁切，也不包含周圍文字與向量圖形。
 - 點到空白處會顯示提示；同一位置有多張圖片時，選取最後繪製的圖片。
 - 掃描頁面通常會擷取整張掃描圖，無法從中直接分離照片或圖表。
-- OCR 支援繁體中文、簡體中文、英文、日文及多種拉丁字母語言，不支援韓文；辨識後請校對結果。完整操作與限制見 [OCR 說明](docs/OCR.md)。
+- OCR 預設支援繁體中文、簡體中文、英文、日文及多種拉丁字母語言。點「區域 OCR」旁的箭頭，可選韓文、泰文、俄文／烏克蘭文、阿拉伯文與印地文／尼泊爾文；另提供希臘文、泰米爾文與泰盧固文。
+- 選「自動＋已下載模型」可共用內建與已下載模型，逐行選擇辨識結果，不會自行下載其他模型。
+- 語言選單以分隔線區分自動選項、已下載與未下載三組，不顯示群組標題；已下載的模型名稱後會標記「已下載」。模型下載、遺失或損壞後，分組與標記會自動更新。
+- 額外模型會先顯示下載確認，下載完成才切換語言；取消或失敗保留原設定。語言設定會記住，並套用於區域 OCR 及損壞文字備援。辨識後請校對結果。完整操作與限制見 [OCR 說明](docs/OCR.md)。
 
 ## 語言與配色
 

{repdf-0.1.0 → repdf-0.1.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "repdf"
-version = "0.1.0"
+version = "0.1.2"
 description = "RePDF (Read the PDF): a desktop PDF reader with printing, search, bookmarks, OCR and page rearrangement."
 readme = "README.md"
 requires-python = ">=3.11"
@@ -10,7 +10,7 @@ dependencies = [
     "pypdf[crypto]>=5.0,<7",
     "pypdfium2>=4.30,<6",
     "pyside6>=6.8,<7",
-    "rapidocr==3.10.0",
+    "rapidocr[rtl]==3.10.0",
     "regex>=2024.11.6",
 ]
 

{repdf-0.1.0 → repdf-0.1.2}/pyproject.toml.orig

@@ -1,6 +1,6 @@
 [project]
 name = "repdf"
-version = "0.1.0"
+version = "0.1.2"
 description = "RePDF (Read the PDF): a desktop PDF reader with printing, search, bookmarks, OCR and page rearrangement."
 readme = "README.md"
 requires-python = ">=3.11"
@@ -11,7 +11,7 @@ dependencies = [
     "pypdf[crypto]>=5.0,<7",
     "pypdfium2>=4.30,<6",
     "pyside6>=6.8,<7",
-    "rapidocr==3.10.0",
+    "rapidocr[rtl]==3.10.0",
     "regex>=2024.11.6",
 ]
 

{repdf-0.1.0 → repdf-0.1.2}/src/repdf/app.py

@@ -10,7 +10,7 @@ from importlib.resources import files
 from pathlib import Path
 from shiboken6 import isValid
 
-from PySide6.QtCore import QEvent, QSettings, QSize, Qt, QThreadPool, QTimer, Slot
+from PySide6.QtCore import QEvent, QPointF, QSettings, QSize, Qt, QThreadPool, QTimer, Slot
 from PySide6.QtGui import (
     QCloseEvent,
     QAction,
@@ -66,6 +66,7 @@ from repdf.search_panel import SearchController
 from repdf.page_view import PageViewport, PreviewCache
 from repdf.navigation import NavigationController
 from repdf.printing import PrintController
+from repdf.ocr_languages import OcrLanguageController
 
 
 class DocumentView(QWidget):
@@ -89,8 +90,10 @@ class DocumentView(QWidget):
         self.focused_page = None
         self.page_sizes = {}
         self.page_links = {}
+        self.page_annotations = {}
         self.page_labels = {}
         self.bookmarks = None
+        self.annotations = None
         self.ready = False
         self._search_navigation = None
         self.password: str | None = None
@@ -177,6 +180,7 @@ class DocumentView(QWidget):
                                       self.owner._copy_text_selection(self, index, preview, start, end, copy=False))
         self.pages.prepare_card(card)
         card.preview.set_links(self.page_links.get(page_index, []))
+        card.preview.set_annotations(self.page_annotations.get(page_index, []))
         card.preview.link_activated.connect(lambda destination: self.owner.navigation.activate(self, destination))
         self.pages.chrome = max(1, card.sizeHint().height() - card.preview.height())
         return card
@@ -383,6 +387,7 @@ class MainWindow(QMainWindow):
         self._next_generation = 0
         self._render_documents = {}
         self._text_requests = {}
+        self._ocr_generations = {}
         self._image_requests = {}
         self._active_tasks = set()
         self._load_batches = {}
@@ -714,8 +719,11 @@ class MainWindow(QMainWindow):
         self.region_ocr_action.setCheckable(True)
         self.region_ocr_action.setToolTip(tr('區域 OCR：框選頁面或圖片中的區域，放開滑鼠後辨識並複製文字。'))
         self.region_ocr_action.toggled.connect(self._set_region_ocr_mode)
-        self.toolbar.addAction(self.region_ocr_action)
+        self.ocr_languages = OcrLanguageController(self)
+        self.ocr_language_button = self.toolbar.add_action_menu_group(self.region_ocr_action, self.ocr_languages.menu)
         self.toolbar.widgetForAction(self.region_ocr_action).setObjectName('regionOcrTool')
+        self.ocr_language_button.setToolTip(tr('OCR 辨識語言'))
+        self.ocr_language_button.setAccessibleName(tr('OCR 辨識語言'))
         self.extract_image_action = QAction(tr('擷取圖片'), self)
         self.extract_image_action.setCheckable(True)
         self.extract_image_action.setEnabled(False)
@@ -729,6 +737,12 @@ class MainWindow(QMainWindow):
         self.bookmark_action.triggered.connect(lambda: self.navigation.toggle())
         self.toolbar.addAction(self.bookmark_action)
         self.toolbar.widgetForAction(self.bookmark_action).setObjectName('bookmarksTool')
+        self.annotation_action = QAction(tr('註解'), self)
+        self.annotation_action.setCheckable(True)
+        self.annotation_action.setToolTip(tr('註解：開啟註解清單，點選即可跳至對應頁面'))
+        self.annotation_action.triggered.connect(lambda: self.navigation.toggle('annotations'))
+        self.toolbar.addAction(self.annotation_action)
+        self.toolbar.widgetForAction(self.annotation_action).setObjectName('annotationsTool')
         self.search_action = QAction(tr('搜尋文字'), self)
         self.search_action.setShortcuts(QKeySequence.keyBindings(QKeySequence.StandardKey.Find))
         self.search_action.setToolTip(tr('搜尋文字（{p0}）：在右側窗格搜尋目前、勾選或所有標籤頁',
@@ -808,6 +822,8 @@ class MainWindow(QMainWindow):
                     button.setFixedSize(34, 34)
 
     def _refresh_toolbar_icons(self) -> None:
+        if hasattr(self, 'ocr_language_button'):
+            self.ocr_language_button.setIcon(toolbar_icon('chevron_down'))
         for action, kind in ((self.open_action, "open"), (self.export_action, "export"),
                              (self.split_action, "split"), (self.copy_text_action, "copy_text"),
                              (self.region_ocr_action, "ocr_region"),
@@ -815,6 +831,7 @@ class MainWindow(QMainWindow):
                              (self.search_action, "search"),
                              (self.print_action, "print"),
                              (self.bookmark_action, "bookmarks"),
+                             (self.annotation_action, "annotations"),
                              (self.fit_action, "fit"),
                              (self.fullscreen_action, "fullscreen"),
                              (self.spread_action, "fullscreen_spread"),
@@ -868,6 +885,7 @@ class MainWindow(QMainWindow):
         self._update_preference_actions()
         self.search_controller.retranslate()
         self.navigation.retranslate()
+        self.ocr_languages.refresh()
 
     def changeEvent(self, event: QEvent) -> None:
         super().changeEvent(event)
@@ -930,6 +948,7 @@ class MainWindow(QMainWindow):
             for label in self._fullscreen_preview.labels.values():
                 label.set_text_mode(enabled, region=region, image=image)
         self._text_requests.clear()
+        self._ocr_generations.clear()
         self._image_requests.clear()
 
     def _copy_text_selection(self, doc, page_index, label, start, end, *, copy=True) -> None:
@@ -950,12 +969,14 @@ class MainWindow(QMainWindow):
             if document_id == doc.document_id:
                 self._text_requests.pop(previous)
         self._text_requests[generation] = (doc.document_id, label, copy)
+        self._ocr_generations[doc.document_id] = generation
         self.render_service.request_text(
             doc.source_path, page_index,
             (start.x() / label.width(), start.y() / label.height()),
             (end.x() / label.width(), end.y() / label.height()),
             generation, -1_000_000 - doc.document_id,
             allow_ocr=copy, region_ocr=region, password=doc.password,
+            ocr_profile=self.ocr_languages.profile,
         )
         if copy:
             self.statusBar().showMessage(tr('正在辨識選取區域…') if region else tr('正在擷取文字…'))
@@ -1305,6 +1326,7 @@ class MainWindow(QMainWindow):
             if document_id == doc.document_id:
                 self._render_documents.pop(generation)
         self.documents.pop(doc.document_id, None)
+        self._ocr_generations.pop(doc.document_id, None)
         self.search_controller.remove_document(doc.document_id)
         self.navigation.remove_document(doc)
         self.tabs.removeTab(index)
@@ -1340,6 +1362,19 @@ class MainWindow(QMainWindow):
         if generation in self._text_requests:
             document_id, label, copy = self._text_requests[generation]
             if document_id in self.documents and not self._closing:
+                retry = payload.get('ocr_retry')
+                if payload.get('ocr_model_missing') and copy and retry:
+                    def retry_selection(document_id=document_id, label=label, retry=retry, generation=generation):
+                        doc = self.documents.get(document_id)
+                        if (doc is None or not isValid(label) or self._closing or not label.text_mode
+                                or self._ocr_generations.get(document_id) != generation
+                                or self.ocr_languages.profile != retry['ocr_profile']
+                                or label.region_mode != (retry['type'] == 'ocr_region')):
+                            return
+                        self._copy_text_selection(doc, retry['page'], label,
+                            QPointF(retry['start'][0] * label.width(), retry['start'][1] * label.height()),
+                            QPointF(retry['end'][0] * label.width(), retry['end'][1] * label.height()))
+                    self.ocr_languages.ensure(retry['ocr_profile'], retry_selection)
                 if payload.get('type') == 'ocr' and copy:
                     self.statusBar().showMessage(tr('選取文字疑似損壞，正在進行 OCR…'))
                 elif payload.get('type') == 'text':
@@ -1478,6 +1513,8 @@ class MainWindow(QMainWindow):
 
     def closeEvent(self, event: QCloseEvent) -> None:
         self._closing = True
+        self.navigation.shutdown()
+        self.ocr_languages.close()
         self.print_controller.close()
         self.search_controller.stop()
         self._password_queue.clear()

{repdf-0.1.0 → repdf-0.1.2}/src/repdf/icons.py

@@ -20,7 +20,18 @@ def toolbar_icon(kind: str) -> QIcon:
         painter.setPen(QPen(QApplication.palette().color(group, role),
                             1.0, Qt.PenStyle.SolidLine, Qt.PenCapStyle.RoundCap,
                             Qt.PenJoinStyle.RoundJoin))
-        if kind == "more":
+        if kind == 'annotations':
+            painter.drawPolyline(QPolygonF([QPointF(4, 3), QPointF(21, 3), QPointF(21, 17),
+                                            QPointF(11, 17), QPointF(6, 21), QPointF(6, 17),
+                                            QPointF(4, 17), QPointF(4, 3)]))
+            painter.drawLine(8, 8, 17, 8)
+            painter.drawLine(8, 12, 15, 12)
+        elif kind == 'chevron_down':
+            pen = painter.pen()
+            pen.setWidthF(2)
+            painter.setPen(pen)
+            painter.drawPolyline(QPolygonF([QPointF(6, 9), QPointF(12, 15), QPointF(18, 9)]))
+        elif kind == "more":
             painter.setBrush(painter.pen().color())
             for x in (5, 12, 19):
                 painter.drawEllipse(QRectF(x - 1, 11, 2, 2))