refactor: unify monitor history port access

tests/test_architecture_dependencies.py

@@ -599,6 +599,21 @@ def test_agent_consumers_use_explicit_data_port_getters():
     assert violations == []
 
 
+def test_monitor_dispatcher_uses_explicit_history_port_getter():
+    """监控分发器不得把兼容 TransferHistoryPort 伪装成数据库 Oper。"""
+    path = APP_ROOT / "monitor" / "dispatcher.py"
+    tree = ast.parse(path.read_text(encoding="utf-8-sig"), filename=str(path))
+    violations = [
+        f"{path.relative_to(PROJECT_ROOT).as_posix()}:{node.lineno}"
+        for node in ast.walk(tree)
+        if isinstance(node, ast.ImportFrom)
+        and node.module == "app.application.history"
+        and any(alias.name == "TransferHistoryPort" for alias in node.names)
+    ]
+
+    assert violations == []
+
+
 def test_plugin_components_do_not_reexport_legacy_abi_names():
     """新插件组件只提供 canonical 能力，不得复制旧 Helper、Manager 或 Oper 导出。"""
     violations: list[str] = []

tests/test_monitor_dispatcher_history.py

@@ -54,7 +54,7 @@ def _patch_history(monkeypatch, record=None, success_record=None) -> MagicMock:
     oper = MagicMock()
     oper.get_by_src.return_value = record
     oper.get_success_by_src.return_value = success_record
-    monkeypatch.setattr("app.monitor.dispatcher.TransferHistoryOper", MagicMock(return_value=oper))
+    monkeypatch.setattr("app.monitor.dispatcher.get_transfer_history_port", MagicMock(return_value=oper))
     return oper
 
 
@@ -229,7 +229,7 @@ def test_history_query_error_registers_pending(monkeypatch):
     dispatcher = _build_dispatcher()
     oper = MagicMock()
     oper.get_by_src.side_effect = RuntimeError("数据库不可用")
-    monkeypatch.setattr("app.monitor.dispatcher.TransferHistoryOper", MagicMock(return_value=oper))
+    monkeypatch.setattr("app.monitor.dispatcher.get_transfer_history_port", MagicMock(return_value=oper))
     chain = _patch_chain(monkeypatch)
 
     assert dispatcher.handle_file(storage="local", event_path=Path("/downloads/a.mkv"), file_size=100) is False

tests/test_monitor_watchfiles.py

@@ -262,7 +262,7 @@ def test_handle_file_skips_transfer_when_history_exists(monkeypatch):
     transfer_chain = MagicMock()
     logger_info = MagicMock()
     logger_debug = MagicMock()
-    monkeypatch.setattr("app.monitor.dispatcher.TransferHistoryOper", FakeTransferHistoryOper)
+    monkeypatch.setattr("app.monitor.dispatcher.get_transfer_history_port", FakeTransferHistoryOper)
     monkeypatch.setattr("app.monitor.dispatcher.TransferChain", transfer_chain)
     monkeypatch.setattr("app.monitor.dispatcher.logger.info", logger_info)
     monkeypatch.setattr("app.monitor.dispatcher.logger.debug", logger_debug)
@@ -300,7 +300,7 @@ def test_handle_file_invokes_transfer_when_history_missing(monkeypatch):
 
     transfer_chain_instance = MagicMock()
     transfer_chain = MagicMock(return_value=transfer_chain_instance)
-    monkeypatch.setattr("app.monitor.dispatcher.TransferHistoryOper", FakeTransferHistoryOper)
+    monkeypatch.setattr("app.monitor.dispatcher.get_transfer_history_port", FakeTransferHistoryOper)
     monkeypatch.setattr("app.monitor.dispatcher.TransferChain", transfer_chain)
 
     handled = dispatcher.handle_file(