重置项目

refer/backend/app/services/notify_adapter.py

@@ -1,12 +1,12 @@
-"""系统通知适配器 — 调用操作系统原生通知命令。
+"""系统通知适配器 — 三平台原生通知中心。
 
 职责: 把后端产生的告警事件推送到操作系统通知中心。
-     窗口最小化 / 被遮挡 / 后台运行时都能弹通知。
+     窗口最小化 / 被遮挡 / 后台运行时都能弹通知 (不依赖前端 WebView)。
 
 平台实现:
-  - macOS:   osascript (系统已内置)
-  - Linux:   notify-send (系统已内置)
-  - Windows: 暂不支持原生通知中心 (无额外依赖实现)
+  - Windows: winotify (进现代操作中心, 支持图标)
+  - macOS:   osascript (系统已内置, 无需额外依赖)
+  - Linux:   notify-send (系统已内置) / plyer 兜底
 
 设计: 失败静默降级, 绝不因通知失败阻断告警主流程 (落盘 / SSE 推送)。
      通知去重不在本层做, 复用 MonitorRuleEngine 的 cooldown 逻辑。
@@ -34,7 +34,15 @@ def _detect_backend() -> str | None:
         return _backend_cache if _backend_cache != "none" else None
 
     backend = None
-    if sys.platform == "darwin":
+    if sys.platform == "win32":
+        try:
+            import winotify  # type: ignore[import-not-found]  # noqa: F401
+
+            backend = "winotify"
+        except ImportError:
+            logger.debug("winotify 不可用, Windows 通知降级")
+            backend = None
+    elif sys.platform == "darwin":
         backend = "osascript"
     elif sys.platform.startswith("linux"):
         backend = "notify-send"
@@ -71,6 +79,8 @@ def notify(title: str, message: str, icon: Path | None = None) -> bool:
         return False
 
     try:
+        if backend == "winotify":
+            return _notify_winotify(title, message)
         if backend == "osascript":
             return _notify_osascript(title, message)
         if backend == "notify-send":
@@ -82,6 +92,20 @@ def notify(title: str, message: str, icon: Path | None = None) -> bool:
     return False
 
 
+def _notify_winotify(title: str, message: str) -> bool:
+    """Windows 通知 (winotify) — 进现代操作中心。"""
+    from winotify import Notifier  # type: ignore[import-not-found]
+
+    Notifier().create_notification(
+        title=title,
+        msg=message,
+        # winotify 要求 duration 为 "short" 或 "long"
+        duration="short",
+        # 无可点击动作 (桌面版不实现"点击回到窗口"的复杂交互)
+    ).show()
+    return True
+
+
 def _notify_osascript(title: str, message: str) -> bool:
     """macOS 通知 (osascript) — 调用系统 AppleScript。"""
     # 转义双引号, 避免 AppleScript 注入