messageflight 0.2.4__py3-none-any.whl

message_flight/i18n.py

@@ -0,0 +1,370 @@
+"""Lightweight UI translation helpers."""
+from __future__ import annotations
+
+import locale
+from typing import Optional
+
+LANGUAGES = ("zh", "en", "ja", "ko", "id", "th", "vi", "ms")
+_LANGUAGE_NAMES = {
+    "zh": "简体中文",
+    "en": "English",
+    "ja": "日本語",
+    "ko": "한국어",
+    "id": "Bahasa Indonesia",
+    "th": "ไทย",
+    "vi": "Tiếng Việt",
+    "ms": "Bahasa Melayu",
+}
+
+_TRANSLATIONS = {
+    "zh": {
+        "tray.show": "显示飞机",
+        "tray.pause": "暂停飞行",
+        "tray.resume": "继续飞行",
+        "tray.demo": "发送演示通知",
+        "tray.dnd": "免打扰",
+        "tray.settings": "设置...",
+        "tray.preset_editor": "飞船编辑器",
+        "tray.notification_status.checking": "通知权限: 检查中...",
+        "tray.notification_status.unavailable": "通知权限: winsdk 未安装",
+        "tray.notification_status": "通知权限: {label} ({status})",
+        "status.unspecified": "未指定",
+        "status.allowed": "已允许",
+        "status.denied": "已拒绝",
+        "status.unknown": "未知",
+        "tray.autostart": "开机自启",
+        "tray.quit": "退出",
+        "settings.title": "MessageFlight 设置",
+        "settings.language": "语言:",
+        "settings.flight_mode": "飞行模式:",
+        "settings.fly_path": "飞行路径:",
+        "settings.color_scheme": "配色:",
+        "settings.tts_engine": "TTS 引擎:",
+        "settings.minimax_key": "MiniMax 订阅 Key:",
+        "settings.minimax_key_placeholder": "Token Plan 订阅 Key",
+        "settings.color.plane_color": "飞机主体",
+        "settings.color.wing_color": "机翼",
+        "settings.color.accent_color": "眼睛/高光",
+        "settings.color.decor_color": "小圆装饰",
+        "settings.color.banner_color": "横幅背景",
+        "settings.color.text_color": "横幅文字",
+        "settings.color.thruster_outer_color": "推进器外焰",
+        "settings.color.thruster_middle_color": "推进器中焰",
+        "settings.color.thruster_inner_color": "推进器内焰",
+        "settings.preset.default": "默认粉",
+        "settings.preset.retro": "复古绿",
+        "settings.preset.cyber": "未来赛博",
+        "preset_editor.title": "飞船编辑器",
+        "preset_editor.preset": "预设:",
+        "preset_editor.choose_color": "选择 {label}",
+    },
+    "en": {
+        "tray.show": "Show plane",
+        "tray.pause": "Pause flight",
+        "tray.resume": "Resume flight",
+        "tray.demo": "Send demo notification",
+        "tray.dnd": "Do Not Disturb",
+        "tray.settings": "Settings...",
+        "tray.preset_editor": "Ship editor",
+        "tray.notification_status.checking": "Notification permission: checking...",
+        "tray.notification_status.unavailable": "Notification permission: winsdk not installed",
+        "tray.notification_status": "Notification permission: {label} ({status})",
+        "status.unspecified": "unspecified",
+        "status.allowed": "allowed",
+        "status.denied": "denied",
+        "status.unknown": "unknown",
+        "tray.autostart": "Start with Windows",
+        "tray.quit": "Quit",
+        "settings.title": "MessageFlight Settings",
+        "settings.language": "Language:",
+        "settings.flight_mode": "Flight mode:",
+        "settings.fly_path": "Flight path:",
+        "settings.color_scheme": "Color scheme:",
+        "settings.tts_engine": "TTS engine:",
+        "settings.minimax_key": "MiniMax subscription key:",
+        "settings.minimax_key_placeholder": "Token Plan subscription key",
+        "settings.color.plane_color": "Plane body",
+        "settings.color.wing_color": "Wing",
+        "settings.color.accent_color": "Eyes / highlight",
+        "settings.color.decor_color": "Decor dots",
+        "settings.color.banner_color": "Banner background",
+        "settings.color.text_color": "Banner text",
+        "settings.color.thruster_outer_color": "Outer thruster flame",
+        "settings.color.thruster_middle_color": "Middle thruster flame",
+        "settings.color.thruster_inner_color": "Inner thruster flame",
+        "settings.preset.default": "Default pink",
+        "settings.preset.retro": "Retro green",
+        "settings.preset.cyber": "Cyber future",
+        "preset_editor.title": "Ship editor",
+        "preset_editor.preset": "Preset:",
+        "preset_editor.choose_color": "Choose {label}",
+    },
+    "ja": {
+        "tray.show": "飛行機を表示",
+        "tray.pause": "飛行を一時停止",
+        "tray.resume": "飛行を再開",
+        "tray.demo": "デモ通知を送信",
+        "tray.dnd": "通知をオフ",
+        "tray.settings": "設定...",
+        "tray.preset_editor": "機体エディター",
+        "tray.notification_status.checking": "通知権限: 確認中...",
+        "tray.notification_status.unavailable": "通知権限: winsdk 未インストール",
+        "tray.notification_status": "通知権限: {label} ({status})",
+        "status.unspecified": "未指定",
+        "status.allowed": "許可済み",
+        "status.denied": "拒否済み",
+        "status.unknown": "不明",
+        "tray.autostart": "Windows 起動時に開始",
+        "tray.quit": "終了",
+        "settings.title": "MessageFlight 設定",
+        "settings.language": "言語:",
+        "settings.flight_mode": "飛行モード:",
+        "settings.fly_path": "飛行ルート:",
+        "settings.color_scheme": "配色:",
+        "settings.tts_engine": "TTS エンジン:",
+        "settings.minimax_key": "MiniMax サブスクリプションキー:",
+        "settings.minimax_key_placeholder": "Token Plan サブスクリプションキー",
+        "settings.color.plane_color": "機体",
+        "settings.color.wing_color": "翼",
+        "settings.color.accent_color": "目 / ハイライト",
+        "settings.color.decor_color": "装飾ドット",
+        "settings.color.banner_color": "バナー背景",
+        "settings.color.text_color": "バナーテキスト",
+        "settings.color.thruster_outer_color": "外側スラスター炎",
+        "settings.color.thruster_middle_color": "中央スラスター炎",
+        "settings.color.thruster_inner_color": "内側スラスター炎",
+        "settings.preset.default": "デフォルトピンク",
+        "settings.preset.retro": "レトログリーン",
+        "settings.preset.cyber": "サイバー未来",
+        "preset_editor.title": "機体エディター",
+        "preset_editor.preset": "プリセット:",
+        "preset_editor.choose_color": "{label} を選択",
+    },
+    "ko": {
+        "tray.show": "비행기 표시",
+        "tray.pause": "비행 일시정지",
+        "tray.resume": "비행 계속",
+        "tray.demo": "데모 알림 보내기",
+        "tray.dnd": "방해 금지",
+        "tray.settings": "설정...",
+        "tray.preset_editor": "비행체 편집기",
+        "tray.notification_status.checking": "알림 권한: 확인 중...",
+        "tray.notification_status.unavailable": "알림 권한: winsdk 미설치",
+        "tray.notification_status": "알림 권한: {label} ({status})",
+        "status.unspecified": "미지정",
+        "status.allowed": "허용됨",
+        "status.denied": "거부됨",
+        "status.unknown": "알 수 없음",
+        "tray.autostart": "Windows 시작 시 실행",
+        "tray.quit": "종료",
+        "settings.title": "MessageFlight 설정",
+        "settings.language": "언어:",
+        "settings.flight_mode": "비행 모드:",
+        "settings.fly_path": "비행 경로:",
+        "settings.color_scheme": "색상:",
+        "settings.tts_engine": "TTS 엔진:",
+        "settings.minimax_key": "MiniMax 구독 키:",
+        "settings.minimax_key_placeholder": "Token Plan 구독 키",
+        "settings.color.plane_color": "기체 본체",
+        "settings.color.wing_color": "날개",
+        "settings.color.accent_color": "눈 / 하이라이트",
+        "settings.color.decor_color": "장식 점",
+        "settings.color.banner_color": "배너 배경",
+        "settings.color.text_color": "배너 텍스트",
+        "settings.color.thruster_outer_color": "외부 추진 화염",
+        "settings.color.thruster_middle_color": "중간 추진 화염",
+        "settings.color.thruster_inner_color": "내부 추진 화염",
+        "settings.preset.default": "기본 핑크",
+        "settings.preset.retro": "레트로 그린",
+        "settings.preset.cyber": "사이버 퓨처",
+        "preset_editor.title": "비행체 편집기",
+        "preset_editor.preset": "프리셋:",
+        "preset_editor.choose_color": "{label} 선택",
+    },
+    "id": {
+        "tray.show": "Tampilkan pesawat",
+        "tray.pause": "Jeda penerbangan",
+        "tray.resume": "Lanjutkan penerbangan",
+        "tray.demo": "Kirim notifikasi demo",
+        "tray.dnd": "Jangan ganggu",
+        "tray.settings": "Pengaturan...",
+        "tray.preset_editor": "Editor wahana",
+        "tray.notification_status.checking": "Izin notifikasi: memeriksa...",
+        "tray.notification_status.unavailable": "Izin notifikasi: winsdk belum terpasang",
+        "tray.notification_status": "Izin notifikasi: {label} ({status})",
+        "status.unspecified": "belum ditentukan",
+        "status.allowed": "diizinkan",
+        "status.denied": "ditolak",
+        "status.unknown": "tidak diketahui",
+        "tray.autostart": "Mulai bersama Windows",
+        "tray.quit": "Keluar",
+        "settings.title": "Pengaturan MessageFlight",
+        "settings.language": "Bahasa:",
+        "settings.flight_mode": "Mode terbang:",
+        "settings.fly_path": "Jalur terbang:",
+        "settings.color_scheme": "Skema warna:",
+        "settings.tts_engine": "Mesin TTS:",
+        "settings.minimax_key": "Kunci langganan MiniMax:",
+        "settings.minimax_key_placeholder": "Kunci langganan Token Plan",
+        "settings.color.plane_color": "Badan pesawat",
+        "settings.color.wing_color": "Sayap",
+        "settings.color.accent_color": "Mata / sorotan",
+        "settings.color.decor_color": "Titik dekorasi",
+        "settings.color.banner_color": "Latar banner",
+        "settings.color.text_color": "Teks banner",
+        "settings.color.thruster_outer_color": "Api pendorong luar",
+        "settings.color.thruster_middle_color": "Api pendorong tengah",
+        "settings.color.thruster_inner_color": "Api pendorong dalam",
+        "settings.preset.default": "Pink bawaan",
+        "settings.preset.retro": "Hijau retro",
+        "settings.preset.cyber": "Masa depan siber",
+        "preset_editor.title": "Editor wahana",
+        "preset_editor.preset": "Preset:",
+        "preset_editor.choose_color": "Pilih {label}",
+    },
+    "th": {
+        "tray.show": "แสดงเครื่องบิน",
+        "tray.pause": "หยุดบินชั่วคราว",
+        "tray.resume": "บินต่อ",
+        "tray.demo": "ส่งการแจ้งเตือนตัวอย่าง",
+        "tray.dnd": "ห้ามรบกวน",
+        "tray.settings": "การตั้งค่า...",
+        "tray.preset_editor": "ตัวแก้ไขยานบิน",
+        "tray.notification_status.checking": "สิทธิ์การแจ้งเตือน: กำลังตรวจสอบ...",
+        "tray.notification_status.unavailable": "สิทธิ์การแจ้งเตือน: ยังไม่ได้ติดตั้ง winsdk",
+        "tray.notification_status": "สิทธิ์การแจ้งเตือน: {label} ({status})",
+        "status.unspecified": "ยังไม่ระบุ",
+        "status.allowed": "อนุญาตแล้ว",
+        "status.denied": "ถูกปฏิเสธ",
+        "status.unknown": "ไม่ทราบ",
+        "tray.autostart": "เริ่มพร้อม Windows",
+        "tray.quit": "ออก",
+        "settings.title": "การตั้งค่า MessageFlight",
+        "settings.language": "ภาษา:",
+        "settings.flight_mode": "โหมดการบิน:",
+        "settings.fly_path": "เส้นทางบิน:",
+        "settings.color_scheme": "ชุดสี:",
+        "settings.tts_engine": "เอนจิน TTS:",
+        "settings.minimax_key": "คีย์สมัครสมาชิก MiniMax:",
+        "settings.minimax_key_placeholder": "คีย์สมัครสมาชิก Token Plan",
+        "settings.color.plane_color": "ลำตัวเครื่องบิน",
+        "settings.color.wing_color": "ปีก",
+        "settings.color.accent_color": "ตา / ไฮไลต์",
+        "settings.color.decor_color": "จุดตกแต่ง",
+        "settings.color.banner_color": "พื้นหลังแบนเนอร์",
+        "settings.color.text_color": "ข้อความแบนเนอร์",
+        "settings.color.thruster_outer_color": "ไฟขับดันชั้นนอก",
+        "settings.color.thruster_middle_color": "ไฟขับดันชั้นกลาง",
+        "settings.color.thruster_inner_color": "ไฟขับดันชั้นใน",
+        "settings.preset.default": "ชมพูเริ่มต้น",
+        "settings.preset.retro": "เขียวเรโทร",
+        "settings.preset.cyber": "ไซเบอร์อนาคต",
+        "preset_editor.title": "ตัวแก้ไขยานบิน",
+        "preset_editor.preset": "พรีเซ็ต:",
+        "preset_editor.choose_color": "เลือก {label}",
+    },
+    "vi": {
+        "tray.show": "Hiển thị máy bay",
+        "tray.pause": "Tạm dừng bay",
+        "tray.resume": "Tiếp tục bay",
+        "tray.demo": "Gửi thông báo demo",
+        "tray.dnd": "Không làm phiền",
+        "tray.settings": "Cài đặt...",
+        "tray.preset_editor": "Trình sửa phương tiện",
+        "tray.notification_status.checking": "Quyền thông báo: đang kiểm tra...",
+        "tray.notification_status.unavailable": "Quyền thông báo: chưa cài winsdk",
+        "tray.notification_status": "Quyền thông báo: {label} ({status})",
+        "status.unspecified": "chưa xác định",
+        "status.allowed": "đã cho phép",
+        "status.denied": "bị từ chối",
+        "status.unknown": "không rõ",
+        "tray.autostart": "Khởi động cùng Windows",
+        "tray.quit": "Thoát",
+        "settings.title": "Cài đặt MessageFlight",
+        "settings.language": "Ngôn ngữ:",
+        "settings.flight_mode": "Chế độ bay:",
+        "settings.fly_path": "Đường bay:",
+        "settings.color_scheme": "Bảng màu:",
+        "settings.tts_engine": "Công cụ TTS:",
+        "settings.minimax_key": "Khóa đăng ký MiniMax:",
+        "settings.minimax_key_placeholder": "Khóa đăng ký Token Plan",
+        "settings.color.plane_color": "Thân máy bay",
+        "settings.color.wing_color": "Cánh",
+        "settings.color.accent_color": "Mắt / điểm nhấn",
+        "settings.color.decor_color": "Chấm trang trí",
+        "settings.color.banner_color": "Nền banner",
+        "settings.color.text_color": "Chữ banner",
+        "settings.color.thruster_outer_color": "Lửa đẩy ngoài",
+        "settings.color.thruster_middle_color": "Lửa đẩy giữa",
+        "settings.color.thruster_inner_color": "Lửa đẩy trong",
+        "settings.preset.default": "Hồng mặc định",
+        "settings.preset.retro": "Xanh retro",
+        "settings.preset.cyber": "Tương lai cyber",
+        "preset_editor.title": "Trình sửa phương tiện",
+        "preset_editor.preset": "Preset:",
+        "preset_editor.choose_color": "Chọn {label}",
+    },
+    "ms": {
+        "tray.show": "Tunjukkan pesawat",
+        "tray.pause": "Jeda penerbangan",
+        "tray.resume": "Sambung penerbangan",
+        "tray.demo": "Hantar notifikasi demo",
+        "tray.dnd": "Jangan ganggu",
+        "tray.settings": "Tetapan...",
+        "tray.preset_editor": "Editor kenderaan",
+        "tray.notification_status.checking": "Kebenaran notifikasi: menyemak...",
+        "tray.notification_status.unavailable": "Kebenaran notifikasi: winsdk belum dipasang",
+        "tray.notification_status": "Kebenaran notifikasi: {label} ({status})",
+        "status.unspecified": "belum ditentukan",
+        "status.allowed": "dibenarkan",
+        "status.denied": "ditolak",
+        "status.unknown": "tidak diketahui",
+        "tray.autostart": "Mula bersama Windows",
+        "tray.quit": "Keluar",
+        "settings.title": "Tetapan MessageFlight",
+        "settings.language": "Bahasa:",
+        "settings.flight_mode": "Mod penerbangan:",
+        "settings.fly_path": "Laluan penerbangan:",
+        "settings.color_scheme": "Skema warna:",
+        "settings.tts_engine": "Enjin TTS:",
+        "settings.minimax_key": "Kunci langganan MiniMax:",
+        "settings.minimax_key_placeholder": "Kunci langganan Token Plan",
+        "settings.color.plane_color": "Badan pesawat",
+        "settings.color.wing_color": "Sayap",
+        "settings.color.accent_color": "Mata / sorotan",
+        "settings.color.decor_color": "Titik hiasan",
+        "settings.color.banner_color": "Latar banner",
+        "settings.color.text_color": "Teks banner",
+        "settings.color.thruster_outer_color": "Api pendorong luar",
+        "settings.color.thruster_middle_color": "Api pendorong tengah",
+        "settings.color.thruster_inner_color": "Api pendorong dalam",
+        "settings.preset.default": "Merah jambu lalai",
+        "settings.preset.retro": "Hijau retro",
+        "settings.preset.cyber": "Masa depan siber",
+        "preset_editor.title": "Editor kenderaan",
+        "preset_editor.preset": "Preset:",
+        "preset_editor.choose_color": "Pilih {label}",
+    },
+}
+
+
+def normalize_language(language: str) -> str:
+    return language if language in LANGUAGES else "zh"
+
+
+def detect_system_language(locale_name: Optional[str] = None) -> str:
+    name = locale_name or locale.getlocale()[0] or ""
+    prefix = name.split("_")[0].split("-")[0].lower()
+    return normalize_language(prefix)
+
+
+def language_name(language: str) -> str:
+    return _LANGUAGE_NAMES[normalize_language(language)]
+
+
+def tr(key: str, language: str = "zh", **kwargs: object) -> str:
+    normalized = normalize_language(language)
+    template = _TRANSLATIONS.get(normalized, _TRANSLATIONS["zh"]).get(key)
+    if template is None:
+        template = _TRANSLATIONS["zh"].get(key, key)
+    return template.format(**kwargs)

message_flight/notification_queue.py

@@ -0,0 +1,72 @@
+"""FIFO notification queue with bounded capacity.
+
+The queue drops the oldest item when capacity is exceeded so that a
+notification flood (e.g. a chat app ping-spamming the listener) cannot
+grow memory unbounded. Callers should treat the queue as the single
+source of truth for "what to show next" so that rapid-fire notifications
+do not interrupt the in-flight animation.
+"""
+from __future__ import annotations
+
+from collections import deque
+from typing import Optional
+
+
+class NotificationQueue:
+    """Bounded FIFO queue for notification display text.
+
+    Args:
+        max_size: Maximum number of items to retain. When ``len()`` would
+            exceed this value after an ``enqueue``, the oldest item is
+            dropped. Defaults to 20.
+    """
+
+    DEFAULT_MAX_SIZE = 20
+
+    def __init__(self, max_size: int = DEFAULT_MAX_SIZE) -> None:
+        if max_size < 1:
+            raise ValueError(f"max_size must be >= 1, got {max_size}")
+        self._max_size = int(max_size)
+        self._items: deque[str] = deque()
+
+    @property
+    def max_size(self) -> int:
+        return self._max_size
+
+    def enqueue(self, text: str) -> Optional[str]:
+        """Append *text* to the tail of the queue.
+
+        Returns the text that was dropped from the head to make room, or
+        ``None`` if the queue was not full. Callers can use the return
+        value to surface a "N messages dropped" hint to the user.
+        """
+        dropped: Optional[str] = None
+        if len(self._items) >= self._max_size:
+            dropped = self._items.popleft()
+        self._items.append(text)
+        return dropped
+
+    def dequeue(self) -> Optional[str]:
+        """Remove and return the head item, or ``None`` if empty."""
+        if not self._items:
+            return None
+        return self._items.popleft()
+
+    def peek(self) -> Optional[str]:
+        """Return the head item without removing it, or ``None`` if empty."""
+        if not self._items:
+            return None
+        return self._items[0]
+
+    def clear(self) -> None:
+        """Remove all items from the queue."""
+        self._items.clear()
+
+    def is_empty(self) -> bool:
+        return len(self._items) == 0
+
+    def __len__(self) -> int:
+        return len(self._items)
+
+    def __bool__(self) -> bool:
+        return bool(self._items)

message_flight/notification_worker.py

@@ -0,0 +1,98 @@
+"""Background thread for listening to the Windows notification center."""
+import asyncio
+from typing import Set
+
+from PyQt6.QtCore import QThread, pyqtSignal
+
+try:
+    from winsdk.windows.ui.notifications import KnownNotificationBindings, NotificationKinds
+    from winsdk.windows.ui.notifications.management import UserNotificationListener
+    WINSOK_AVAILABLE = True
+except ImportError:
+    WINSOK_AVAILABLE = False
+
+
+class NotificationWorker(QThread):
+    """后台线程：轮询 Windows 通知中心，发现新通知时发射信号"""
+    notification_received = pyqtSignal(str, str)  # app_name, message_text
+    access_status_changed = pyqtSignal(int)  # 0=Unspecified, 1=Allowed, 2=Denied
+
+    def __init__(self) -> None:
+        super().__init__()
+        self._running = True
+        self._seen_ids: Set[int] = set()
+        self._initialized = False
+
+    def run(self):
+        if not WINSOK_AVAILABLE:
+            return
+
+        loop = asyncio.new_event_loop()
+        asyncio.set_event_loop(loop)
+        try:
+            while self._running:
+                try:
+                    access, notifications = loop.run_until_complete(self._poll())
+                    self.access_status_changed.emit(access)
+
+                    if access == 1:
+                        if not self._initialized:
+                            # 第一次：把当前所有通知标记为已见过，避免历史通知刷屏
+                            for n in notifications:
+                                self._seen_ids.add(n['id'])
+                            self._initialized = True
+                        else:
+                            for n in notifications:
+                                if n['id'] not in self._seen_ids:
+                                    self._seen_ids.add(n['id'])
+                                    self.notification_received.emit(n['app'], n['text'])
+
+                            # 定期清理旧 ID，防止无限增长
+                            if len(self._seen_ids) > 500:
+                                current_ids = {n['id'] for n in notifications}
+                                self._seen_ids = current_ids | set(
+                                    list(self._seen_ids)[-200:]
+                                )
+                except Exception as e:
+                    print(f"Notification poll error: {e}")
+
+                self.msleep(2000)
+        finally:
+            loop.close()
+
+    async def _poll(self):
+        listener = UserNotificationListener.current
+        access = listener.get_access_status()
+        if access != 1:
+            return access, []
+
+        notifications = await listener.get_notifications_async(NotificationKinds.TOAST)
+        result = []
+        for n in notifications:
+            try:
+                app_name = "Unknown"
+                if hasattr(n, 'app_info') and n.app_info:
+                    app_name = n.app_info.display_info.display_name
+
+                binding = n.notification.visual.get_binding(KnownNotificationBindings.toast_generic)
+                lines = []
+                if binding:
+                    texts = binding.get_text_elements()
+                    it = iter(texts)
+                    while it.has_current:
+                        lines.append(it.current.text)
+                        it.move_next()
+
+                if lines:
+                    result.append({
+                        'id': n.id,
+                        'app': app_name,
+                        'text': ' | '.join(lines)
+                    })
+            except Exception:
+                pass
+        return access, result
+
+    def stop(self):
+        self._running = False
+        self.wait(1500)