diff --git a/paperforge/commands/deep.py b/paperforge/commands/deep.py
index 44473ce6..ba1ca42c 100644
--- a/paperforge/commands/deep.py
+++ b/paperforge/commands/deep.py
@@ -1,8 +1,11 @@
 """Deep-reading queue command."""
 
 import argparse
+import logging
 from pathlib import Path
 
+logger = logging.getLogger(__name__)
+
 
 def _get_run_deep_reading():
     """Get run_deep_reading, preferring cli patches if available."""
diff --git a/paperforge/commands/ocr.py b/paperforge/commands/ocr.py
index c7dcbf68..9dcb932e 100644
--- a/paperforge/commands/ocr.py
+++ b/paperforge/commands/ocr.py
@@ -1,8 +1,11 @@
 """OCR command — unifies OCR run and diagnose."""
 
 import argparse
+import logging
 from pathlib import Path
 
+logger = logging.getLogger(__name__)
+
 
 def _diagnose(vault: Path, live: bool = False) -> int:
     """Run OCR diagnostics and print results."""
diff --git a/paperforge/commands/repair.py b/paperforge/commands/repair.py
index fd7d12b7..23e9b736 100644
--- a/paperforge/commands/repair.py
+++ b/paperforge/commands/repair.py
@@ -1,8 +1,11 @@
 """Repair command."""
 
 import argparse
+import logging
 from pathlib import Path
 
+logger = logging.getLogger(__name__)
+
 
 def _get_run_repair():
     """Get run_repair, preferring cli patches if available."""
diff --git a/paperforge/commands/status.py b/paperforge/commands/status.py
index 5b944310..8609107a 100644
--- a/paperforge/commands/status.py
+++ b/paperforge/commands/status.py
@@ -5,8 +5,11 @@ and path_error counts (displayed by run_status in literature_pipeline).
 """
 
 import argparse
+import logging
 from pathlib import Path
 
+logger = logging.getLogger(__name__)
+
 
 def _get_run_status():
     """Get run_status, preferring cli patches if available."""
diff --git a/paperforge/commands/sync.py b/paperforge/commands/sync.py
index 3d1f1d8d..5f72fe96 100644
--- a/paperforge/commands/sync.py
+++ b/paperforge/commands/sync.py
@@ -1,8 +1,11 @@
 """Sync command — unifies selection-sync and index-refresh."""
 
 import argparse
+import logging
 from pathlib import Path
 
+logger = logging.getLogger(__name__)
+
 
 def _get_run_selection_sync():
     """Get run_selection_sync, preferring cli patches if available."""
diff --git a/paperforge/worker/base_views.py b/paperforge/worker/base_views.py
index 9e7fcd85..a9bef92b 100644
--- a/paperforge/worker/base_views.py
+++ b/paperforge/worker/base_views.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+import logging
 import argparse
 import csv
 import hashlib
@@ -20,6 +21,8 @@ import requests
 import fitz
 from PIL import Image
 
+logger = logging.getLogger(__name__)
+
 STANDARD_VIEW_NAMES = frozenset([
     "控制面板", "推荐分析", "待 OCR", "OCR 完成",
     "待深度阅读", "深度阅读完成", "正式卡片", "全记录"
diff --git a/paperforge/worker/deep_reading.py b/paperforge/worker/deep_reading.py
index 1f9e3bc5..5edcf645 100644
--- a/paperforge/worker/deep_reading.py
+++ b/paperforge/worker/deep_reading.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+import logging
 import argparse
 import csv
 import hashlib
@@ -24,6 +25,8 @@ from paperforge.worker.sync import has_deep_reading_content, load_export_rows
 from paperforge.worker.base_views import ensure_base_views
 from paperforge.worker.ocr import validate_ocr_meta
 
+logger = logging.getLogger(__name__)
+
 STANDARD_VIEW_NAMES = frozenset([
     "控制面板", "推荐分析", "待 OCR", "OCR 完成",
     "待深度阅读", "深度阅读完成", "正式卡片", "全记录"
diff --git a/paperforge/worker/ocr.py b/paperforge/worker/ocr.py
index d130104d..4928edc2 100644
--- a/paperforge/worker/ocr.py
+++ b/paperforge/worker/ocr.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+import logging
 import argparse
 import csv
 import hashlib
@@ -26,6 +27,8 @@ from paperforge.worker.sync import (
     load_export_rows,
 )
 
+logger = logging.getLogger(__name__)
+
 STANDARD_VIEW_NAMES = frozenset([
     "控制面板", "推荐分析", "待 OCR", "OCR 完成",
     "待深度阅读", "深度阅读完成", "正式卡片", "全记录"
diff --git a/paperforge/worker/repair.py b/paperforge/worker/repair.py
index f7a64708..eed93452 100644
--- a/paperforge/worker/repair.py
+++ b/paperforge/worker/repair.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+import logging
 import argparse
 import csv
 import hashlib
@@ -28,6 +29,8 @@ from paperforge.worker.sync import (
 from paperforge.worker.deep_reading import _resolve_formal_note_path
 from paperforge.worker.ocr import validate_ocr_meta
 
+logger = logging.getLogger(__name__)
+
 STANDARD_VIEW_NAMES = frozenset([
     "控制面板", "推荐分析", "待 OCR", "OCR 完成",
     "待深度阅读", "深度阅读完成", "正式卡片", "全记录"
diff --git a/paperforge/worker/status.py b/paperforge/worker/status.py
index 755cf49d..0a5481d8 100644
--- a/paperforge/worker/status.py
+++ b/paperforge/worker/status.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+import logging
 import argparse
 import csv
 import hashlib
@@ -22,6 +23,8 @@ from PIL import Image
 
 from paperforge.worker.base_views import ensure_base_views
 
+logger = logging.getLogger(__name__)
+
 STANDARD_VIEW_NAMES = frozenset([
     "控制面板", "推荐分析", "待 OCR", "OCR 完成",
     "待深度阅读", "深度阅读完成", "正式卡片", "全记录"
diff --git a/paperforge/worker/sync.py b/paperforge/worker/sync.py
index 575d8ba9..e9dfb1cb 100644
--- a/paperforge/worker/sync.py
+++ b/paperforge/worker/sync.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+import logging
 import argparse
 import csv
 import hashlib
@@ -20,6 +21,8 @@ import requests
 import fitz
 from PIL import Image
 
+logger = logging.getLogger(__name__)
+
 STANDARD_VIEW_NAMES = frozenset([
     "控制面板", "推荐分析", "待 OCR", "OCR 完成",
     "待深度阅读", "深度阅读完成", "正式卡片", "全记录"
diff --git a/paperforge/worker/update.py b/paperforge/worker/update.py
index 1126107d..797cb1f8 100644
--- a/paperforge/worker/update.py
+++ b/paperforge/worker/update.py
@@ -1,4 +1,5 @@
 from __future__ import annotations
+import logging
 import argparse
 import csv
 import hashlib
@@ -20,6 +21,8 @@ import requests
 import fitz
 from PIL import Image
 
+logger = logging.getLogger(__name__)
+
 STANDARD_VIEW_NAMES = frozenset([
     "控制面板", "推荐分析", "待 OCR", "OCR 完成",
     "待深度阅读", "深度阅读完成", "正式卡片", "全记录"