refactor(application): 优化信号处理器设置逻辑，支持跨平台处理

- 移除了macOS特定的信号处理器设置，统一为所有平台设置SIGINT和SIGTERM信号处理器。
- 在系统托盘中添加占位图标以避免警告信息。
- 在音频测试中增加线程安全的状态更新方法，确保UI在多线程环境下的稳定性。

Author: huangjunsen0406

src/application.py

@@ -1,6 +1,5 @@
 import asyncio
 import json
-import platform
 import signal
 import sys
 import threading
@@ -19,48 +18,48 @@
 
 logger = get_logger(__name__)
 
-# 检查是否为 macOS 系统
-if platform.system() == "Darwin":
 
-    def setup_signal_handler(sig, handler, description):
-        """
-        统一的信号处理器设置函数.
-        """
-        try:
-            signal.signal(sig, handler)
-        except (AttributeError, ValueError) as e:
-            print(f"注意: 无法设置{description}处理器: {e}")
-
-    def handle_sigint(signum, frame):
-        app = Application.get_instance()
-        if not app:
-            sys.exit(0)
-        
-        # 使用app的主循环，更稳定且跨线程安全
-        loop = app._main_loop
-        if loop and not loop.is_closed():
-            # 直接创建task在指定的循环中
-            def create_shutdown_task():
-                try:
-                    if loop.is_running():
-                        asyncio.run_coroutine_threadsafe(app.shutdown(), loop)
-                    else:
-                        loop.create_task(app.shutdown())
-                except Exception as e:
-                    print(f"创建shutdown任务失败: {e}")
-                    sys.exit(0)
-            
-            loop.call_soon_threadsafe(create_shutdown_task)
-        else:
-            # 主循环未就绪或已关闭，直接退出
-            sys.exit(0)
+def setup_signal_handler(sig, handler, description):
+    """
+    统一的信号处理器设置函数（跨平台尽力而为）.
+    """
+    try:
+        signal.signal(sig, handler)
+    except (AttributeError, ValueError) as e:
+        print(f"注意: 无法设置{description}处理器: {e}")
+
+
+def handle_sigint(signum, frame):
+    app = Application.get_instance()
+    if not app:
+        sys.exit(0)
+
+    # 使用app的主循环，更稳定且跨线程安全
+    loop = app._main_loop
+    if loop and not loop.is_closed():
+        # 直接创建task在指定的循环中
+        def create_shutdown_task():
+            try:
+                if loop.is_running():
+                    asyncio.run_coroutine_threadsafe(app.shutdown(), loop)
+                else:
+                    loop.create_task(app.shutdown())
+            except Exception as e:
+                print(f"创建shutdown任务失败: {e}")
+                sys.exit(0)
+
+        loop.call_soon_threadsafe(create_shutdown_task)
+    else:
+        # 主循环未就绪或已关闭，直接退出
+        sys.exit(0)
 
-    # 设置信号处理器
-    setup_signal_handler(signal.SIGTRAP, signal.SIG_IGN, "SIGTRAP")
-    setup_signal_handler(signal.SIGINT, handle_sigint, "SIGINT")
 
-else:
-    logger.debug("非 macOS 系统，跳过信号处理器设置")
+# 设置信号处理器：所有平台尽量设置 SIGINT；支持则设置 SIGTERM；若存在 SIGTRAP 则忽略它
+setup_signal_handler(signal.SIGINT, handle_sigint, "SIGINT")
+if hasattr(signal, "SIGTERM"):
+    setup_signal_handler(signal.SIGTERM, handle_sigint, "SIGTERM")
+if hasattr(signal, "SIGTRAP"):
+    setup_signal_handler(signal.SIGTRAP, signal.SIG_IGN, "SIGTRAP")
 
 setup_opus()
 

src/views/components/system_tray.py

@@ -55,6 +55,21 @@ def _setup_tray(self):
             self.tray_icon = QSystemTrayIcon()
             self.tray_icon.setContextMenu(self.tray_menu)
 
+            # 在显示前设置一个占位图标，避免 QSystemTrayIcon::setVisible: No Icon set 警告
+            try:
+                # 使用一个纯色圆点作为初始占位
+                pixmap = QPixmap(16, 16)
+                pixmap.fill(QColor(0, 0, 0, 0))
+                painter = QPainter(pixmap)
+                painter.setRenderHint(QPainter.Antialiasing)
+                painter.setBrush(QBrush(QColor(0, 180, 0)))
+                painter.setPen(QColor(0, 0, 0, 0))
+                painter.drawEllipse(2, 2, 12, 12)
+                painter.end()
+                self.tray_icon.setIcon(QIcon(pixmap))
+            except Exception:
+                pass
+
             # 连接托盘图标的事件
             self.tray_icon.activated.connect(self._on_tray_activated)
 

src/views/settings/components/audio/audio_widget.py

@@ -4,7 +4,7 @@
 
 import numpy as np
 import sounddevice as sd
-from PyQt5.QtCore import pyqtSignal
+from PyQt5.QtCore import Q_ARG, QMetaObject, Qt, pyqtSignal
 from PyQt5.QtWidgets import (
     QComboBox,
     QLabel,
@@ -316,15 +316,15 @@ def _do_input_test(self, device_id):
             sample_rate = int(input_device['sample_rate'])
             duration = 3  # 录音时长3秒
 
-            self._append_status(f"开始录音测试 (设备: {device_id}, 采样率: {sample_rate}Hz)")
-            self._append_status("请对着麦克风说话，比如数数字: 1、2、3...")
+            self._append_status_threadsafe(f"开始录音测试 (设备: {device_id}, 采样率: {sample_rate}Hz)")
+            self._append_status_threadsafe("请对着麦克风说话，比如数数字: 1、2、3...")
 
             # 倒计时提示
             for i in range(3, 0, -1):
-                self._append_status(f"{i}秒后开始录音...")
+                self._append_status_threadsafe(f"{i}秒后开始录音...")
                 time.sleep(1)
 
-            self._append_status("正在录音，请说话... (3秒)")
+            self._append_status_threadsafe("正在录音，请说话... (3秒)")
 
             # 录音
             recording = sd.rec(
@@ -336,7 +336,7 @@ def _do_input_test(self, device_id):
             )
             sd.wait()
 
-            self._append_status("录音完成，正在分析...")
+            self._append_status_threadsafe("录音完成，正在分析...")
 
             # 分析录音质量
             max_amplitude = np.max(np.abs(recording))
@@ -354,27 +354,27 @@ def _do_input_test(self, device_id):
 
             # 测试结果分析
             if max_amplitude < 0.001:
-                self._append_status("[失败] 未检测到音频信号")
-                self._append_status("请检查: 1) 麦克风连接 2) 系统音量 3) 麦克风权限")
+                self._append_status_threadsafe("[失败] 未检测到音频信号")
+                self._append_status_threadsafe("请检查: 1) 麦克风连接 2) 系统音量 3) 麦克风权限")
             elif max_amplitude > 0.8:
-                self._append_status("[警告] 音频信号过载")
-                self._append_status("建议降低麦克风增益或音量设置")
+                self._append_status_threadsafe("[警告] 音频信号过载")
+                self._append_status_threadsafe("建议降低麦克风增益或音量设置")
             elif activity_ratio < 0.1:
-                self._append_status("[警告] 检测到音频但语音活动较少")
-                self._append_status("请确保对着麦克风说话，或检查麦克风灵敏度")
+                self._append_status_threadsafe("[警告] 检测到音频但语音活动较少")
+                self._append_status_threadsafe("请确保对着麦克风说话，或检查麦克风灵敏度")
             else:
-                self._append_status("[成功] 录音测试通过")
-                self._append_status(f"音质数据: 最大音量={max_amplitude:.1%}, 平均音量={rms:.1%}, 活跃度={activity_ratio:.1%}")
-                self._append_status("麦克风工作正常")
+                self._append_status_threadsafe("[成功] 录音测试通过")
+                self._append_status_threadsafe(f"音质数据: 最大音量={max_amplitude:.1%}, 平均音量={rms:.1%}, 活跃度={activity_ratio:.1%}")
+                self._append_status_threadsafe("麦克风工作正常")
 
         except Exception as e:
             self.logger.error(f"录音测试失败: {e}", exc_info=True)
-            self._append_status(f"[错误] 录音测试失败: {str(e)}")
+            self._append_status_threadsafe(f"[错误] 录音测试失败: {str(e)}")
             if "Permission denied" in str(e) or "access" in str(e).lower():
-                self._append_status("可能是权限问题，请检查系统麦克风权限设置")
+                self._append_status_threadsafe("可能是权限问题，请检查系统麦克风权限设置")
         finally:
-            # 重置UI状态
-            self._reset_input_test_ui()
+            # 重置UI状态（切回主线程）
+            self._reset_input_ui_threadsafe()
 
     def _test_output_device(self):
         """
@@ -418,15 +418,15 @@ def _do_output_test(self, device_id):
             duration = 2.0  # 播放时长
             frequency = 440  # 440Hz A音
 
-            self._append_status(f"开始播放测试 (设备: {device_id}, 采样率: {sample_rate}Hz)")
-            self._append_status("请准备好耳机/扬声器，即将播放测试音...")
+            self._append_status_threadsafe(f"开始播放测试 (设备: {device_id}, 采样率: {sample_rate}Hz)")
+            self._append_status_threadsafe("请准备好耳机/扬声器，即将播放测试音...")
 
             # 倒计时提示
             for i in range(3, 0, -1):
-                self._append_status(f"{i}秒后开始播放...")
+                self._append_status_threadsafe(f"{i}秒后开始播放...")
                 time.sleep(1)
 
-            self._append_status(f"正在播放 {frequency}Hz 测试音 ({duration}秒)...")
+            self._append_status_threadsafe(f"正在播放 {frequency}Hz 测试音 ({duration}秒)...")
 
             # 生成测试音频 (正弦波)
             t = np.linspace(0, duration, int(sample_rate * duration))
@@ -442,16 +442,16 @@ def _do_output_test(self, device_id):
             sd.play(audio, samplerate=sample_rate, device=device_id)
             sd.wait()
 
-            self._append_status("播放完成")
-            self._append_status("测试说明: 如果听到清晰的测试音，说明扬声器/耳机工作正常")
-            self._append_status("如果没听到声音，请检查音量设置或选择其他输出设备")
+            self._append_status_threadsafe("播放完成")
+            self._append_status_threadsafe("测试说明: 如果听到清晰的测试音，说明扬声器/耳机工作正常")
+            self._append_status_threadsafe("如果没听到声音，请检查音量设置或选择其他输出设备")
 
         except Exception as e:
             self.logger.error(f"播放测试失败: {e}", exc_info=True)
-            self._append_status(f"[错误] 播放测试失败: {str(e)}")
+            self._append_status_threadsafe(f"[错误] 播放测试失败: {str(e)}")
         finally:
-            # 重置UI状态
-            self._reset_output_test_ui()
+            # 重置UI状态（切回主线程）
+            self._reset_output_ui_threadsafe()
 
     def _reset_input_test_ui(self):
         """
@@ -461,6 +461,27 @@ def _reset_input_test_ui(self):
         self.ui_controls["test_input_btn"].setEnabled(True)
         self.ui_controls["test_input_btn"].setText("测试录音")
 
+    def _reset_input_ui_threadsafe(self):
+        try:
+            self.testing_input = False
+            btn = self.ui_controls.get("test_input_btn")
+            if not btn:
+                return
+            QMetaObject.invokeMethod(
+                btn,
+                "setEnabled",
+                Qt.QueuedConnection,
+                Q_ARG(bool, True),
+            )
+            QMetaObject.invokeMethod(
+                btn,
+                "setText",
+                Qt.QueuedConnection,
+                Q_ARG(str, "测试录音"),
+            )
+        except Exception as e:
+            self.logger.error(f"线程安全重置输入测试UI失败: {e}")
+
     def _reset_output_test_ui(self):
         """
         重置输出测试UI状态.
@@ -469,6 +490,27 @@ def _reset_output_test_ui(self):
         self.ui_controls["test_output_btn"].setEnabled(True)
         self.ui_controls["test_output_btn"].setText("测试播放")
 
+    def _reset_output_ui_threadsafe(self):
+        try:
+            self.testing_output = False
+            btn = self.ui_controls.get("test_output_btn")
+            if not btn:
+                return
+            QMetaObject.invokeMethod(
+                btn,
+                "setEnabled",
+                Qt.QueuedConnection,
+                Q_ARG(bool, True),
+            )
+            QMetaObject.invokeMethod(
+                btn,
+                "setText",
+                Qt.QueuedConnection,
+                Q_ARG(str, "测试播放"),
+            )
+        except Exception as e:
+            self.logger.error(f"线程安全重置输出测试UI失败: {e}")
+
     def _append_status(self, message):
         """
         添加状态信息.
@@ -485,6 +527,24 @@ def _append_status(self, message):
         except Exception as e:
             self.logger.error(f"添加状态信息失败: {e}", exc_info=True)
 
+    def _append_status_threadsafe(self, message):
+        """
+        后台线程安全地将状态文本追加到 QTextEdit（切回主线程）。
+        """
+        try:
+            if not self.ui_controls["status_text"]:
+                return
+            current_time = time.strftime("%H:%M:%S")
+            formatted_message = f"[{current_time}] {message}"
+            QMetaObject.invokeMethod(
+                self.ui_controls["status_text"],
+                "append",
+                Qt.QueuedConnection,
+                Q_ARG(str, formatted_message),
+            )
+        except Exception as e:
+            self.logger.error(f"线程安全追加状态失败: {e}", exc_info=True)
+
     def _load_config_values(self):
         """
         从配置文件加载值到UI控件.