如何将Python Qt5脚本的托盘图标移至扩展托盘菜单而非任务栏面板

要实现KDE5中「始终隐藏」的托盘图标效果（图标保留在扩展托盘抽屉而非任务栏面板），不能直接用QSystemTrayIcon.hide()——这个方法会完全移除托盘条目，导致系统托盘设置里的可见性选项灰色不可用。正确的做法是利用KDE遵循的**StatusNotifierItem(SNI)**规范，通过DBus接口设置图标可见性，让系统默认将其放入扩展托盘。

实现步骤 #

1. 正常创建并显示托盘图标，确保SNI条目被系统注册
2. 通过QDBus调用SNI接口，设置图标可见性为「Hidden」状态

代码示例 #

import sys
import os
from PyQt5.QtWidgets import QApplication, QSystemTrayIcon, QIcon
from PyQt5.QtDBus import QDBusConnection, QDBusInterface

if __name__ == "__main__":
    app = QApplication(sys.argv)
    
    # 创建托盘图标并显示（必须先show，否则SNI条目不会生成）
    tray_icon = QSystemTrayIcon()
    tray_icon.setIcon(QIcon("your_icon.png"))  # 替换为你的图标路径
    tray_icon.show()
    
    # 获取当前进程PID，构造SNI的DBus路径
    pid = os.getpid()
    sni_service = f"org.kde.StatusNotifierItem-{pid}"
    sni_path = f"/org/kde/statusnotifieritem_{pid}_0"
    sni_interface = QDBusInterface(sni_service, sni_path, "org.kde.StatusNotifierItem", QDBusConnection.sessionBus())
    
    # 设置可见性为Hidden（SNI规范中枚举值2对应Hidden）
    if sni_interface.isValid():
        sni_interface.call("SetVisibility", 2)
    
    sys.exit(app.exec_())

原理说明 #

• KDE用SNI替代了传统的SystemTray，QSystemTrayIcon在KDE环境下会自动适配为SNI条目
• SNI规范定义了SetVisibility方法，传入值2会标记图标为「Hidden」状态，KDE会将其放入扩展托盘抽屉
• 先调用show()确保SNI条目被系统注册，否则DBus接口无法找到对应的对象

内容的提问来源于stack exchange，提问作者Mikoyan