在 Windows 桌面开发中我们经常需要处理来自不同应用或服务的通知。系统托盘通知一闪而过容易被忽略而传统的弹窗又过于生硬容易打断工作流。有没有一种方式能让通知像一封来自朋友的邮件一样安静地出现在桌面角落不打扰但又能被清晰地感知到《环世界》这款游戏的信件系统就提供了绝佳的灵感新信件会以一个小图标的形式出现在屏幕边缘点击后展开阅读处理完毕后可以关闭或存档。受此启发我们可以动手实现一个开源的桌面告警小工具。它不依赖任何复杂的消息队列或云服务核心就是一个常驻系统托盘的小程序能够接收来自本地脚本、命令行或其他进程的告警信息并以一种优雅、非侵入的方式展示在桌面上。这对于监控本地任务执行结果、接收自动化脚本的状态汇报或者作为个人工作流中的轻量级通知中心都非常实用。本文将带你从零开始使用 Python 和 Tkinter 库实现这样一个模仿《环世界》信件系统的桌面告警工具。我们将涵盖从项目结构设计、核心窗口实现、系统托盘集成到如何接收外部消息、管理通知队列等完整流程。最终你将获得一个可运行、可配置、甚至可以通过命令行直接发送“信件”的小工具。1. 理解《环世界》信件系统的设计精髓在动手编码之前我们需要先拆解《环世界》信件系统的几个关键特性这些将直接指导我们的技术实现。1.1 非模态与无干扰展示游戏中的信件通知不会强制弹出并抢占焦点非模态窗口。它通常出现在屏幕边缘如右下角以一个较小的、半透明的图标或标题栏形式存在。用户可以选择立即点击查看也可以暂时忽略让它停留在那里。这种设计保证了游戏进程不会被意外打断同时信息又始终可见。在我们的工具中这意味着告警窗口不能是“application-modal”或“system-modal”的并且应该有一个最小化的展示状态。1.2 分级与持久化信件有不同的类型如贸易提议、任务、报告可能对应不同的优先级。在我们的告警工具中可以引入“信息”、“警告”、“错误”等级别并用不同的颜色或图标区分。此外游戏中的信件可以被关闭或存档。对应到我们的工具告警信息不应该在显示一次后就消失而应提供“标记为已读”、“关闭”或“历史记录”的功能方便后续回溯。1.3 外部触发机制游戏中的信件由内部事件如访客到达、任务完成触发。我们的工具需要提供一个机制允许外部程序如一个完成数据备份的批处理脚本或一个监控服务器状态的Python脚本能够轻易地向它发送告警。这将通过进程间通信IPC来实现例如使用本地网络套接字、命名管道或简单的文件监听。2. 环境准备与项目结构我们将使用 Python 作为开发语言主要因为它跨平台且拥有丰富的 GUI 和系统集成库。虽然最终目标是 Windows 桌面工具但使用 Tkinter 使得代码在 macOS 和 Linux 上也能基本运行系统托盘部分可能需要调整。2.1 开发环境要求请确保你的系统已安装以下环境Python 3.7 或更高版本这是 Tkinter 稳定运行的基础。pipPython 包管理工具通常随 Python 安装。一个代码编辑器或 IDE如 VS Code、PyCharm 等。你可以通过命令行验证安装python --version pip --version2.2 核心依赖库我们主要依赖 Python 标准库但为了更好的系统托盘支持和窗口控制我们会使用一个第三方库。tkinterPython 的标准 GUI 工具包用于创建窗口和控件。无需单独安装。Pillow (PIL)用于处理图标等图像文件。系统托盘需要特定格式的图标。pystray一个用于创建系统托盘图标的库。它抽象了不同操作系统Windows, macOS, Linux的底层细节。使用 pip 安装必要的第三方库pip install Pillow pystray2.3 项目目录结构在开始编码前创建一个清晰的项目目录。这有助于代码管理和后续的功能扩展。desktop-alert-tool/ ├── main.py # 程序主入口启动系统托盘和主循环 ├── alert_window.py # 告警窗口的核心类定义 ├── tray_icon.py # 系统托盘图标及其菜单管理 ├── ipc_server.py # 进程间通信服务器用于接收外部消息 ├── config.py # 配置文件或默认参数 ├── assets/ # 资源文件夹 │ ├── icon.ico # 主程序图标用于窗口和托盘 │ ├── info.png # 信息级别图标 │ ├── warning.png # 警告级别图标 │ └── error.png # 错误级别图标 ├── requirements.txt # 项目依赖列表 └── README.md # 项目说明文档在requirements.txt中写入Pillow9.0.0 pystray0.19.03. 构建核心告警窗口告警窗口是我们工具的门面需要实现展开、收起、显示内容、处理交互等功能。3.1 创建基础窗口类我们在alert_window.py中创建AlertWindow类。它继承自tkinter.Toplevel这样我们可以创建多个独立的告警窗口实例。import tkinter as tk from tkinter import ttk from PIL import Image, ImageTk import os class AlertWindow(tk.Toplevel): def __init__(self, masterNone, title新告警, message, levelinfo, **kwargs): super().__init__(master, **kwargs) self.master master self.title title self.message message self.level level.lower() # info, warning, error # 窗口基本设置无标题栏、置顶、初始位于屏幕右下角 self.overrideredirect(True) # 隐藏窗口边框和标题栏 self.attributes(-topmost, True) # 窗口置顶 self.configure(bg#2b2b2b) # 深色背景 # 设置窗口的默认大小和位置 self.width 300 self.height_collapsed 40 # 收起时的高度只显示标题栏 self.height_expanded 150 # 展开时的高度 self.current_height self.height_collapsed self.is_expanded False # 获取屏幕尺寸并计算初始位置右下角 screen_width self.winfo_screenwidth() screen_height self.winfo_screenheight() self.x_pos screen_width - self.width - 20 # 距离右边20像素 self.y_pos screen_height - self.height_collapsed - 60 # 距离底部60像素给任务栏留空间 self.geometry(f{self.width}x{self.height_collapsed}{self.x_pos}{self.y_pos}) self._create_widgets() self._load_icons() self._apply_style() # 绑定鼠标事件 self.bind_events() def _load_icons(self): 加载不同级别的图标 icon_dir assets self.icons {} try: for level in [info, warning, error]: icon_path os.path.join(icon_dir, f{level}.png) if os.path.exists(icon_path): img Image.open(icon_path) img img.resize((20, 20), Image.Resampling.LANCZOS) self.icons[level] ImageTk.PhotoImage(img) else: # 如果图标文件不存在创建一个纯色替代图标 self.icons[level] None except Exception as e: print(f加载图标失败: {e}) self.icons {info: None, warning: None, error: None} def _create_widgets(self): 创建窗口内的所有控件 # 标题栏框架 self.title_bar tk.Frame(self, bgself._get_color(bg_title), height30) self.title_bar.pack(sidetk.TOP, filltk.X) self.title_bar.pack_propagate(False) # 固定高度 # 标题栏内容图标、标题、按钮 # 图标 self.icon_label tk.Label(self.title_bar, bgself._get_color(bg_title)) self.icon_label.pack(sidetk.LEFT, padx(8, 5), pady5) # 标题文本 self.title_label tk.Label(self.title_bar, textself.title, font(微软雅黑, 10, bold), fgself._get_color(fg_title), bgself._get_color(bg_title)) self.title_label.pack(sidetk.LEFT, filltk.X, expandTrue, pady5) # 关闭按钮 self.close_btn tk.Label(self.title_bar, text×, font(Arial, 14), fgself._get_color(fg_close), bgself._get_color(bg_title), cursorhand2) self.close_btn.pack(sidetk.RIGHT, padx(5, 10), pady5) # 消息内容区域初始时隐藏 self.message_frame tk.Frame(self, bgself._get_color(bg_main)) # 先创建但不立即pack self.message_text tk.Text(self.message_frame, wraptk.WORD, height5, width35, bgself._get_color(bg_main), fgself._get_color(fg_main), font(微软雅黑, 9), relieftk.FLAT, highlightthickness0) self.message_text.pack(sidetk.LEFT, filltk.BOTH, expandTrue, padx10, pady10) self.message_text.insert(1.0, self.message) self.message_text.config(statetk.DISABLED) # 设置为只读 # 添加一个滚动条 scrollbar ttk.Scrollbar(self.message_frame, orienttk.VERTICAL, commandself.message_text.yview) scrollbar.pack(sidetk.RIGHT, filltk.Y) self.message_text[yscrollcommand] scrollbar.set def _apply_style(self): 根据告警级别应用颜色和图标 color_scheme { info: {bg_title: #3a7ca5, fg_title: #ffffff, bg_main: #2b2b2b, fg_main: #cccccc, fg_close: #dddddd}, warning: {bg_title: #d4a017, fg_title: #000000, bg_main: #2b2b2b, fg_main: #cccccc, fg_close: #222222}, error: {bg_title: #c23b22, fg_title: #ffffff, bg_main: #2b2b2b, fg_main: #cccccc, fg_close: #dddddd}, } self.colors color_scheme.get(self.level, color_scheme[info]) # 应用颜色到标题栏 self.title_bar.configure(bgself.colors[bg_title]) self.title_label.configure(bgself.colors[bg_title], fgself.colors[fg_title]) self.icon_label.configure(bgself.colors[bg_title]) self.close_btn.configure(bgself.colors[bg_title], fgself.colors[fg_close]) # 应用图标 if self.icons.get(self.level): self.icon_label.configure(imageself.icons[self.level]) # 应用颜色到消息框 self.message_frame.configure(bgself.colors[bg_main]) self.message_text.configure(bgself.colors[bg_main], fgself.colors[fg_main]) def _get_color(self, key): 安全获取颜色值 return self.colors.get(key, #2b2b2b)3.2 实现窗口的展开、收起与交互窗口需要响应点击事件来展开或收起并且要能拖动和关闭。# 接在 AlertWindow 类的 __init__ 方法之后添加到 alert_window.py 中 def bind_events(self): 绑定鼠标事件 # 标题栏点击展开/收起 self.title_bar.bind(Button-1, self._on_title_click) self.title_label.bind(Button-1, self._on_title_click) self.icon_label.bind(Button-1, self._on_title_click) # 标题栏拖动 self.title_bar.bind(B1-Motion, self._on_drag) self.title_bar.bind(ButtonPress-1, self._on_drag_start) # 关闭按钮事件 self.close_btn.bind(Button-1, self._on_close) self.close_btn.bind(Enter, lambda e: self.close_btn.config(fg#ffffff)) self.close_btn.bind(Leave, lambda e: self.close_btn.config(fgself.colors[fg_close])) # 窗口失去焦点时如果不是展开状态可以自动收起可选 self.bind(FocusOut, self._on_focus_out) def _on_title_click(self, event): 点击标题栏切换展开/收起状态 if not self.is_expanded: self.expand() else: self.collapse() def _on_drag_start(self, event): 开始拖动记录初始位置 self.drag_start_x event.x_root self.drag_start_y event.y_root self.orig_x self.x_pos self.orig_y self.y_pos def _on_drag(self, event): 处理拖动事件 delta_x event.x_root - self.drag_start_x delta_y event.y_root - self.drag_start_y new_x self.orig_x delta_x new_y self.orig_y delta_y # 防止窗口被拖出屏幕 screen_width self.winfo_screenwidth() screen_height self.winfo_screenheight() new_x max(0, min(new_x, screen_width - self.width)) new_y max(0, min(new_y, screen_height - self.current_height)) self.x_pos, self.y_pos new_x, new_y self.geometry(f{new_x}{new_y}) def _on_close(self, event): 关闭窗口 self.destroy() def _on_focus_out(self, event): 窗口失去焦点时自动收起可选功能 # 可根据需要开启或关闭此功能 # if self.is_expanded: # self.collapse() def expand(self): 展开窗口显示详细内容 if not self.is_expanded: self.message_frame.pack(sidetk.TOP, filltk.BOTH, expandTrue) self.current_height self.height_expanded self.geometry(f{self.width}x{self.current_height}{self.x_pos}{self.y_pos}) self.is_expanded True # 展开后让窗口获得焦点方便查看 self.focus_force() def collapse(self): 收起窗口只显示标题栏 if self.is_expanded: self.message_frame.pack_forget() self.current_height self.height_collapsed self.geometry(f{self.width}x{self.current_height}{self.x_pos}{self.y_pos}) self.is_expanded False3.3 窗口队列与位置管理当有多个告警同时到达时我们需要管理它们的显示位置避免重叠。# 在 alert_window.py 文件开头或单独的管理模块中 class AlertManager: 管理多个告警窗口的队列和位置 def __init__(self, master_root): self.master master_root self.active_alerts [] # 存储当前活跃的窗口对象 self.alert_spacing 10 # 窗口之间的垂直间距 self.max_alerts_on_screen 5 # 屏幕最多同时显示的告警数 def show_alert(self, title, message, levelinfo): 创建并显示一个新的告警窗口 # 如果告警太多移除最早的一个 if len(self.active_alerts) self.max_alerts_on_screen: old_alert self.active_alerts.pop(0) old_alert.destroy() # 创建新告警 new_alert AlertWindow(self.master, titletitle, messagemessage, levellevel) # 计算新窗口的位置从下往上堆叠 screen_height self.master.winfo_screenheight() base_y screen_height - new_alert.height_collapsed - 60 # 初始底部位置 for i, alert in enumerate(reversed(self.active_alerts)): # 每个已有窗口上移一个位置加上间距 new_y base_y - (i 1) * (alert.height_collapsed self.alert_spacing) # 确保不会移出屏幕顶部 if new_y 20: new_y 20 alert.y_pos new_y alert.geometry(f{alert.x_pos}{new_y}) # 将新窗口添加到列表末尾 self.active_alerts.append(new_alert) # 绑定销毁事件以便从管理列表中移除 def on_destroy(event, alert_objnew_alert): if alert_obj in self.active_alerts: self.active_alerts.remove(alert_obj) # 当一个窗口被关闭后重新计算剩余窗口的位置 self._reposition_alerts() new_alert.bind(Destroy, on_destroy) return new_alert def _reposition_alerts(self): 重新排列所有活跃告警窗口的位置 screen_height self.master.winfo_screenheight() base_y screen_height - 60 # 参考底部位置 for i, alert in enumerate(reversed(self.active_alerts)): new_y base_y - i * (alert.height_collapsed self.alert_spacing) if new_y 20: new_y 20 alert.y_pos new_y alert.geometry(f{alert.x_pos}{new_y})4. 集成系统托盘与后台服务一个桌面工具应该能常驻后台并通过系统托盘图标进行控制。4.1 创建系统托盘图标我们在tray_icon.py中创建系统托盘图标及其菜单。import pystray from PIL import Image, ImageDraw import threading import tkinter as tk def create_tray_icon(root_window, alert_manager): 创建系统托盘图标和菜单 # 创建一个简单的图标可以用图片替代 def create_image(): # 绘制一个简单的圆形图标 image Image.new(RGB, (64, 64), color#3a7ca5) draw ImageDraw.Draw(image) draw.ellipse((16, 16, 48, 48), fillwhite, outlinewhite) draw.text((22, 22), i, fill#3a7ca5, fontNone) # 简单写个 i 表示 info return image # 定义菜单项的动作 def show_test_alert(icon, item): # 在主线程中执行Tkinter操作 root_window.after(0, lambda: alert_manager.show_alert( 测试告警, 这是一个来自系统托盘菜单的测试消息。\n你可以在这里放置很长的消息内容窗口会自动换行并显示滚动条。, info )) def show_about(icon, item): # 可以弹出一个关于对话框 import tkinter.messagebox as msgbox root_window.after(0, lambda: msgbox.showinfo(关于, 桌面告警小工具 v1.0\n模仿环世界信件系统。)) def quit_application(icon, item): icon.stop() root_window.after(0, root_window.destroy) # 创建菜单 menu ( pystray.MenuItem(显示测试告警, show_test_alert), pystray.MenuItem(关于, show_about), pystray.Menu.SEPARATOR, pystray.MenuItem(退出, quit_application), ) # 创建托盘图标 icon pystray.Icon( desktop_alert_tool, iconcreate_image(), menumenu, title桌面告警工具 ) return icon4.2 启动主程序与事件循环在main.py中我们将所有部分串联起来启动 Tkinter 主窗口隐藏和系统托盘图标。import tkinter as tk from threading import Thread import sys import os sys.path.append(os.path.dirname(os.path.abspath(__file__))) from alert_window import AlertManager from tray_icon import create_tray_icon # 后续会添加 from ipc_server import start_ipc_server def main(): # 创建 Tkinter 根窗口但不显示 root tk.Tk() root.withdraw() # 隐藏主窗口 root.title(Desktop Alert Tool) # 初始化告警管理器 alert_manager AlertManager(root) # 创建并启动系统托盘图标在新线程中运行 tray_icon create_tray_icon(root, alert_manager) def run_tray(): tray_icon.run() tray_thread Thread(targetrun_tray, daemonTrue) tray_thread.start() # 启动 IPC 服务器监听外部消息后续实现 # ipc_thread Thread(targetstart_ipc_server, args(alert_manager,), daemonTrue) # ipc_thread.start() # 启动 Tkinter 主循环 try: root.mainloop() except KeyboardInterrupt: print(程序被中断正在退出...) finally: tray_icon.stop() sys.exit(0) if __name__ __main__: main()现在运行python main.py你应该能在系统托盘看到一个图标。右键点击图标选择“显示测试告警”一个模仿《环世界》风格的告警窗口就会从屏幕右下角弹出。点击标题栏可以展开/收起拖动标题栏可以移动位置点击关闭按钮可以移除告警。5. 实现进程间通信接收外部消息一个只能从内部菜单触发的告警工具意义有限。我们需要让它能接收来自其他进程的命令这才是其实用性的关键。5.1 设计简单的 IPC 协议为了简单和跨平台我们使用本地 TCP 套接字作为通信方式。我们定义一种简单的基于文本的协议例如 JSON 格式。外部程序发送的告警消息可以是一个 JSON 字符串{ title: 备份任务完成, message: 数据库备份已于 2023-10-27 15:30:02 成功完成。\n文件大小1.2GB\n存储路径D:\\Backups\\, level: info }5.2 实现 IPC 服务器在ipc_server.py中我们创建一个简单的 TCP 服务器监听本地端口例如 9999接收并解析 JSON 消息然后调用AlertManager来显示告警。import socket import json import threading import traceback from queue import Queue import tkinter as tk class IPCServer: def __init__(self, host127.0.0.1, port9999, alert_managerNone): self.host host self.port port self.alert_manager alert_manager self.server_socket None self.running False self.message_queue Queue() # 用于线程间传递消息到Tkinter主线程 def start(self): 启动IPC服务器线程 self.running True server_thread threading.Thread(targetself._run_server, daemonTrue) server_thread.start() print(fIPC服务器已启动监听 {self.host}:{self.port}) def _run_server(self): 服务器主循环 self.server_socket socket.socket(socket.AF_INET, socket.SOCK_STREAM) self.server_socket.setsockopt(socket.SOL_SOCKET, socket.SO_REUSEADDR, 1) try: self.server_socket.bind((self.host, self.port)) self.server_socket.listen(5) # 允许最多5个连接排队 self.server_socket.settimeout(1.0) # 设置超时以便定期检查 running 标志 while self.running: try: client_socket, addr self.server_socket.accept() # 为每个客户端连接创建一个新线程处理 client_thread threading.Thread(targetself._handle_client, args(client_socket, addr)) client_thread.daemon True client_thread.start() except socket.timeout: # 超时循环继续检查 running 标志 continue except OSError as e: if self.running: print(f服务器接受连接时出错: {e}) break except Exception as e: print(f启动服务器失败: {e}) traceback.print_exc() finally: if self.server_socket: self.server_socket.close() def _handle_client(self, client_socket, addr): 处理单个客户端连接 print(f新的连接来自: {addr}) try: data client_socket.recv(4096).decode(utf-8) if not data: return print(f收到原始数据: {data}) # 尝试解析JSON try: alert_data json.loads(data.strip()) title alert_data.get(title, 新通知) message alert_data.get(message, ) level alert_data.get(level, info).lower() # 验证level if level not in [info, warning, error]: level info # 将消息放入队列由主线程处理Tkinter GUI更新 self.message_queue.put((title, message, level)) # 发送成功响应 response json.dumps({status: success, message: Alert received.}) client_socket.sendall(response.encode(utf-8)) except json.JSONDecodeError as e: print(fJSON解析错误: {e}) response json.dumps({status: error, message: Invalid JSON format.}) client_socket.sendall(response.encode(utf-8)) except Exception as e: print(f处理消息时出错: {e}) response json.dumps({status: error, message: Internal server error.}) client_socket.sendall(response.encode(utf-8)) except Exception as e: print(f与客户端 {addr} 通信时出错: {e}) finally: client_socket.close() def stop(self): 停止服务器 self.running False if self.server_socket: try: # 创建一个临时连接来打破 accept() 阻塞 temp_socket socket.socket(socket.AF_INET, socket.SOCK_STREAM) temp_socket.connect((self.host, self.port)) temp_socket.close() except: pass print(IPC服务器已停止) def start_ipc_server(alert_manager): 启动IPC服务器的便捷函数 server IPCServer(alert_manageralert_manager) server.start() return server5.3 在主程序中集成 IPC 并处理消息队列我们需要修改main.py启动 IPC 服务器并定期检查消息队列将接收到的告警显示出来。# 更新后的 main.py 部分 import tkinter as tk from threading import Thread import sys import os sys.path.append(os.path.dirname(os.path.abspath(__file__))) from alert_window import AlertManager from tray_icon import create_tray_icon from ipc_server import start_ipc_server, IPCServer def main(): root tk.Tk() root.withdraw() root.title(Desktop Alert Tool) alert_manager AlertManager(root) # 创建并启动系统托盘图标 tray_icon create_tray_icon(root, alert_manager) def run_tray(): tray_icon.run() tray_thread Thread(targetrun_tray, daemonTrue) tray_thread.start() # 启动 IPC 服务器 ipc_server start_ipc_server(alert_manager) # 定期检查 IPC 消息队列的函数 def check_ipc_queue(): try: while not ipc_server.message_queue.empty(): title, message, level ipc_server.message_queue.get_nowait() # 在主线程中创建告警窗口 alert_manager.show_alert(title, message, level) except Exception as e: print(f处理消息队列时出错: {e}) # 每100毫秒检查一次 root.after(100, check_ipc_queue) # 启动队列检查 root.after(100, check_ipc_queue) try: root.mainloop() except KeyboardInterrupt: print(程序被中断正在退出...) finally: tray_icon.stop() ipc_server.stop() sys.exit(0) if __name__ __main__: main()5.4 从外部发送告警现在任何能连接 TCP 端口并发送 JSON 的程序都可以触发告警了。这里提供一个 Python 客户端示例send_alert.py# send_alert.py import socket import json import sys def send_alert(title, message, levelinfo, host127.0.0.1, port9999): 发送告警到桌面告警工具 data { title: title, message: message, level: level } json_data json.dumps(data) try: with socket.socket(socket.AF_INET, socket.SOCK_STREAM) as sock: sock.settimeout(5) sock.connect((host, port)) sock.sendall(json_data.encode(utf-8)) # 接收响应 response sock.recv(1024).decode(utf-8) print(f服务器响应: {response}) except ConnectionRefusedError: print(错误无法连接到桌面告警工具。请确保工具正在运行。) except socket.timeout: print(错误连接超时。) except Exception as e: print(f发送告警时出错: {e}) if __name__ __main__: # 示例从命令行参数读取或使用默认值 if len(sys.argv) 3: title sys.argv[1] message sys.argv[2] level sys.argv[3] if len(sys.argv) 3 else info else: title 命令行测试 message 这是一条通过命令行发送的测试消息。\n你可以集成到任何脚本中。 level info send_alert(title, message, level)使用方法python send_alert.py 任务完成 每日数据同步已成功执行。 info你也可以在批处理脚本.bat或 PowerShell 脚本中调用这个 Python 客户端或者用其他任何语言如 Java, C#, Go, Bash 借助 netcat实现相同的 TCP 通信逻辑。6. 常见问题排查与优化在实际使用中你可能会遇到一些问题。下面是一些常见问题的排查路径和解决方案。6.1 程序启动与运行问题问题现象可能原因检查方式处理建议运行python main.py后无任何反应托盘图标未出现。1. Python 环境或依赖未正确安装。2.pystray在某些系统上需要额外依赖。3. 脚本路径或导入错误。1. 在命令行运行查看是否有错误输出。2. 检查pip list确认pystray和Pillow已安装。3. 尝试运行一个简单的pystray示例。1. 确保使用pip install -r requirements.txt安装依赖。2. 在 Windows 上pystray通常能直接运行。在 Linux 上可能需要安装python3-xlib等包。3. 在main.py开头添加print(“启动...”)调试。托盘图标出现但点击“显示测试告警”无反应。1. Tkinter 主循环未正确启动或阻塞。2.AlertManager或AlertWindow初始化失败。3. 图像资源路径错误。1. 检查命令行是否有异常输出。2. 确认assets/目录下存在图标文件。3. 在show_test_alert函数内添加print语句。1. 确保root.mainloop()被调用且没有在它之前运行耗时操作。2. 将图标加载代码加上try-except打印错误。3. 使用绝对路径或os.path.join确保资源文件可找到。告警窗口出现但位置不对或互相重叠。1. 屏幕尺寸获取不准确。2.AlertManager的位置计算逻辑有误。3. 多显示器环境。1. 打印screen_width和screen_height的值。2. 检查base_y和new_y的计算过程。1. 使用root.winfo_screenwidth()和root.winfo_screenheight()获取主显示器尺寸。2. 在多显示器环境下Tkinter 可能只识别主显示器。可以考虑使用win32api(Windows) 获取更精确的屏幕信息。通过send_alert.py发送消息但桌面工具无反应。1. 桌面工具未启动。2. IPC 服务器端口被占用或未启动。3. 防火墙阻止了本地连接。4. JSON 格式错误。1. 确认main.py正在运行。2. 使用 netstat -anofindstr :9999(Windows) 查看端口状态。br3. 查看桌面工具的命令行输出是否有错误。br4. 检查send_alert.py 发送的 JSON 字符串。6.2 功能与交互优化建议持久化与历史记录当前告警关闭后就消失了。可以增加一个“历史”菜单项点击后弹出一个新窗口显示所有接收过的告警记录。这需要将告警信息标题、内容、时间、级别保存到本地文件如 SQLite 数据库或 JSON 文件中。配置化将窗口颜色、默认位置、IPC 端口、最大告警数量等参数提取到配置文件如config.ini或settings.json中方便用户自定义。声音提示为不同级别的告警添加不同的系统提示音。自动清理为告警窗口增加“自动关闭”计时器例如信息类告警显示 10 秒后自动关闭。更丰富的消息格式支持在message字段中使用简单的 Markdown 或 HTML 来提供粗体、链接等格式Tkinter 的Text控件支持部分标签。协议增强在 IPC 协议中增加duration显示时长、actions可点击按钮等字段使外部调用更灵活。打包为可执行文件使用PyInstaller或cx_Freeze将项目打包成单个.exe文件方便在无 Python 环境的 Windows 电脑上运行。6.3 生产环境考量如果计划在更严肃的环境中使用如监控服务器关键任务需要考虑以下几点可靠性IPC 服务器需要更健壮的错误处理和连接管理避免因单个错误消息崩溃。安全性目前的 IPC 服务器监听127.0.0.1相对安全。如果考虑接收网络消息必须添加身份验证和消息加密。资源管理需要监控内存使用防止告警窗口过多导致内存泄漏。确保窗口被销毁时相关资源被正确释放。日志增加详细的运行日志记录告警的接收、显示、错误等信息便于排查问题。开机自启将工具配置为 Windows 服务或添加到启动文件夹实现开机自动运行。7. 总结与扩展方向我们完成了一个模仿《环世界》信件系统的桌面告警小工具的核心功能。它具备非模态展示、分级显示、系统托盘常驻以及通过 TCP 套接字接收外部消息的能力。这个工具的价值在于其轻量、非侵入和可集成性你可以将它作为各种自动化脚本的“消息终点站”。下一步可以尝试的扩展跨平台适配pystray本身支持跨平台但图标和菜单行为可能略有差异。可以针对 macOS 和 Linux 的托盘规范进行微调。窗口拖动和焦点行为在不同系统上也可能需要调整。与现有监控系统集成编写适配器让工具可以接收来自 Prometheus Alertmanager、Zabbix、Nagios 等监控系统的 Webhook 告警。实现“勿扰模式”在系统托盘菜单中添加一个“勿扰模式”开关开启后暂时不弹出新告警但记录在历史中。高级过滤规则允许用户通过配置文件定义规则例如只显示包含特定关键词或来自特定发送者的“错误”级别告警。这个项目的代码是开源的你可以根据实际需求进行修改和增强。最重要的不是复刻一个完全一样的系统而是理解其“优雅通知”的设计哲学并将其应用到解决实际问题的工具中。
在 Windows 桌面开发中我们经常需要处理来自不同应用或服务的通知。系统托盘通知一闪而过容易被忽略而传统的弹窗又过于生硬容易打断工作流。有没有一种方式能让通知像一封来自朋友的邮件一样安静地出现在桌面角落不打扰但又能被清晰地感知到《环世界》这款游戏的信件系统就提供了绝佳的灵感新信件会以一个小图标的形式出现在屏幕边缘点击后展开阅读处理完毕后可以关闭或存档。受此启发我们可以动手实现一个开源的桌面告警小工具。它不依赖任何复杂的消息队列或云服务核心就是一个常驻系统托盘的小程序能够接收来自本地脚本、命令行或其他进程的告警信息并以一种优雅、非侵入的方式展示在桌面上。这对于监控本地任务执行结果、接收自动化脚本的状态汇报或者作为个人工作流中的轻量级通知中心都非常实用。本文将带你从零开始使用 Python 和 Tkinter 库实现这样一个模仿《环世界》信件系统的桌面告警工具。我们将涵盖从项目结构设计、核心窗口实现、系统托盘集成到如何接收外部消息、管理通知队列等完整流程。最终你将获得一个可运行、可配置、甚至可以通过命令行直接发送“信件”的小工具。1. 理解《环世界》信件系统的设计精髓在动手编码之前我们需要先拆解《环世界》信件系统的几个关键特性这些将直接指导我们的技术实现。1.1 非模态与无干扰展示游戏中的信件通知不会强制弹出并抢占焦点非模态窗口。它通常出现在屏幕边缘如右下角以一个较小的、半透明的图标或标题栏形式存在。用户可以选择立即点击查看也可以暂时忽略让它停留在那里。这种设计保证了游戏进程不会被意外打断同时信息又始终可见。在我们的工具中这意味着告警窗口不能是“application-modal”或“system-modal”的并且应该有一个最小化的展示状态。1.2 分级与持久化信件有不同的类型如贸易提议、任务、报告可能对应不同的优先级。在我们的告警工具中可以引入“信息”、“警告”、“错误”等级别并用不同的颜色或图标区分。此外游戏中的信件可以被关闭或存档。对应到我们的工具告警信息不应该在显示一次后就消失而应提供“标记为已读”、“关闭”或“历史记录”的功能方便后续回溯。1.3 外部触发机制游戏中的信件由内部事件如访客到达、任务完成触发。我们的工具需要提供一个机制允许外部程序如一个完成数据备份的批处理脚本或一个监控服务器状态的Python脚本能够轻易地向它发送告警。这将通过进程间通信IPC来实现例如使用本地网络套接字、命名管道或简单的文件监听。2. 环境准备与项目结构我们将使用 Python 作为开发语言主要因为它跨平台且拥有丰富的 GUI 和系统集成库。虽然最终目标是 Windows 桌面工具但使用 Tkinter 使得代码在 macOS 和 Linux 上也能基本运行系统托盘部分可能需要调整。2.1 开发环境要求请确保你的系统已安装以下环境Python 3.7 或更高版本这是 Tkinter 稳定运行的基础。pipPython 包管理工具通常随 Python 安装。一个代码编辑器或 IDE如 VS Code、PyCharm 等。你可以通过命令行验证安装python --version pip --version2.2 核心依赖库我们主要依赖 Python 标准库但为了更好的系统托盘支持和窗口控制我们会使用一个第三方库。tkinterPython 的标准 GUI 工具包用于创建窗口和控件。无需单独安装。Pillow (PIL)用于处理图标等图像文件。系统托盘需要特定格式的图标。pystray一个用于创建系统托盘图标的库。它抽象了不同操作系统Windows, macOS, Linux的底层细节。使用 pip 安装必要的第三方库pip install Pillow pystray2.3 项目目录结构在开始编码前创建一个清晰的项目目录。这有助于代码管理和后续的功能扩展。desktop-alert-tool/ ├── main.py # 程序主入口启动系统托盘和主循环 ├── alert_window.py # 告警窗口的核心类定义 ├── tray_icon.py # 系统托盘图标及其菜单管理 ├── ipc_server.py # 进程间通信服务器用于接收外部消息 ├── config.py # 配置文件或默认参数 ├── assets/ # 资源文件夹 │ ├── icon.ico # 主程序图标用于窗口和托盘 │ ├── info.png # 信息级别图标 │ ├── warning.png # 警告级别图标 │ └── error.png # 错误级别图标 ├── requirements.txt # 项目依赖列表 └── README.md # 项目说明文档在requirements.txt中写入Pillow9.0.0 pystray0.19.03. 构建核心告警窗口告警窗口是我们工具的门面需要实现展开、收起、显示内容、处理交互等功能。3.1 创建基础窗口类我们在alert_window.py中创建AlertWindow类。它继承自tkinter.Toplevel这样我们可以创建多个独立的告警窗口实例。import tkinter as tk from tkinter import ttk from PIL import Image, ImageTk import os class AlertWindow(tk.Toplevel): def __init__(self, masterNone, title新告警, message, levelinfo, **kwargs): super().__init__(master, **kwargs) self.master master self.title title self.message message self.level level.lower() # info, warning, error # 窗口基本设置无标题栏、置顶、初始位于屏幕右下角 self.overrideredirect(True) # 隐藏窗口边框和标题栏 self.attributes(-topmost, True) # 窗口置顶 self.configure(bg#2b2b2b) # 深色背景 # 设置窗口的默认大小和位置 self.width 300 self.height_collapsed 40 # 收起时的高度只显示标题栏 self.height_expanded 150 # 展开时的高度 self.current_height self.height_collapsed self.is_expanded False # 获取屏幕尺寸并计算初始位置右下角 screen_width self.winfo_screenwidth() screen_height self.winfo_screenheight() self.x_pos screen_width - self.width - 20 # 距离右边20像素 self.y_pos screen_height - self.height_collapsed - 60 # 距离底部60像素给任务栏留空间 self.geometry(f{self.width}x{self.height_collapsed}{self.x_pos}{self.y_pos}) self._create_widgets() self._load_icons() self._apply_style() # 绑定鼠标事件 self.bind_events() def _load_icons(self): 加载不同级别的图标 icon_dir assets self.icons {} try: for level in [info, warning, error]: icon_path os.path.join(icon_dir, f{level}.png) if os.path.exists(icon_path): img Image.open(icon_path) img img.resize((20, 20), Image.Resampling.LANCZOS) self.icons[level] ImageTk.PhotoImage(img) else: # 如果图标文件不存在创建一个纯色替代图标 self.icons[level] None except Exception as e: print(f加载图标失败: {e}) self.icons {info: None, warning: None, error: None} def _create_widgets(self): 创建窗口内的所有控件 # 标题栏框架 self.title_bar tk.Frame(self, bgself._get_color(bg_title), height30) self.title_bar.pack(sidetk.TOP, filltk.X) self.title_bar.pack_propagate(False) # 固定高度 # 标题栏内容图标、标题、按钮 # 图标 self.icon_label tk.Label(self.title_bar, bgself._get_color(bg_title)) self.icon_label.pack(sidetk.LEFT, padx(8, 5), pady5) # 标题文本 self.title_label tk.Label(self.title_bar, textself.title, font(微软雅黑, 10, bold), fgself._get_color(fg_title), bgself._get_color(bg_title)) self.title_label.pack(sidetk.LEFT, filltk.X, expandTrue, pady5) # 关闭按钮 self.close_btn tk.Label(self.title_bar, text×, font(Arial, 14), fgself._get_color(fg_close), bgself._get_color(bg_title), cursorhand2) self.close_btn.pack(sidetk.RIGHT, padx(5, 10), pady5) # 消息内容区域初始时隐藏 self.message_frame tk.Frame(self, bgself._get_color(bg_main)) # 先创建但不立即pack self.message_text tk.Text(self.message_frame, wraptk.WORD, height5, width35, bgself._get_color(bg_main), fgself._get_color(fg_main), font(微软雅黑, 9), relieftk.FLAT, highlightthickness0) self.message_text.pack(sidetk.LEFT, filltk.BOTH, expandTrue, padx10, pady10) self.message_text.insert(1.0, self.message) self.message_text.config(statetk.DISABLED) # 设置为只读 # 添加一个滚动条 scrollbar ttk.Scrollbar(self.message_frame, orienttk.VERTICAL, commandself.message_text.yview) scrollbar.pack(sidetk.RIGHT, filltk.Y) self.message_text[yscrollcommand] scrollbar.set def _apply_style(self): 根据告警级别应用颜色和图标 color_scheme { info: {bg_title: #3a7ca5, fg_title: #ffffff, bg_main: #2b2b2b, fg_main: #cccccc, fg_close: #dddddd}, warning: {bg_title: #d4a017, fg_title: #000000, bg_main: #2b2b2b, fg_main: #cccccc, fg_close: #222222}, error: {bg_title: #c23b22, fg_title: #ffffff, bg_main: #2b2b2b, fg_main: #cccccc, fg_close: #dddddd}, } self.colors color_scheme.get(self.level, color_scheme[info]) # 应用颜色到标题栏 self.title_bar.configure(bgself.colors[bg_title]) self.title_label.configure(bgself.colors[bg_title], fgself.colors[fg_title]) self.icon_label.configure(bgself.colors[bg_title]) self.close_btn.configure(bgself.colors[bg_title], fgself.colors[fg_close]) # 应用图标 if self.icons.get(self.level): self.icon_label.configure(imageself.icons[self.level]) # 应用颜色到消息框 self.message_frame.configure(bgself.colors[bg_main]) self.message_text.configure(bgself.colors[bg_main], fgself.colors[fg_main]) def _get_color(self, key): 安全获取颜色值 return self.colors.get(key, #2b2b2b)3.2 实现窗口的展开、收起与交互窗口需要响应点击事件来展开或收起并且要能拖动和关闭。# 接在 AlertWindow 类的 __init__ 方法之后添加到 alert_window.py 中 def bind_events(self): 绑定鼠标事件 # 标题栏点击展开/收起 self.title_bar.bind(Button-1, self._on_title_click) self.title_label.bind(Button-1, self._on_title_click) self.icon_label.bind(Button-1, self._on_title_click) # 标题栏拖动 self.title_bar.bind(B1-Motion, self._on_drag) self.title_bar.bind(ButtonPress-1, self._on_drag_start) # 关闭按钮事件 self.close_btn.bind(Button-1, self._on_close) self.close_btn.bind(Enter, lambda e: self.close_btn.config(fg#ffffff)) self.close_btn.bind(Leave, lambda e: self.close_btn.config(fgself.colors[fg_close])) # 窗口失去焦点时如果不是展开状态可以自动收起可选 self.bind(FocusOut, self._on_focus_out) def _on_title_click(self, event): 点击标题栏切换展开/收起状态 if not self.is_expanded: self.expand() else: self.collapse() def _on_drag_start(self, event): 开始拖动记录初始位置 self.drag_start_x event.x_root self.drag_start_y event.y_root self.orig_x self.x_pos self.orig_y self.y_pos def _on_drag(self, event): 处理拖动事件 delta_x event.x_root - self.drag_start_x delta_y event.y_root - self.drag_start_y new_x self.orig_x delta_x new_y self.orig_y delta_y # 防止窗口被拖出屏幕 screen_width self.winfo_screenwidth() screen_height self.winfo_screenheight() new_x max(0, min(new_x, screen_width - self.width)) new_y max(0, min(new_y, screen_height - self.current_height)) self.x_pos, self.y_pos new_x, new_y self.geometry(f{new_x}{new_y}) def _on_close(self, event): 关闭窗口 self.destroy() def _on_focus_out(self, event): 窗口失去焦点时自动收起可选功能 # 可根据需要开启或关闭此功能 # if self.is_expanded: # self.collapse() def expand(self): 展开窗口显示详细内容 if not self.is_expanded: self.message_frame.pack(sidetk.TOP, filltk.BOTH, expandTrue) self.current_height self.height_expanded self.geometry(f{self.width}x{self.current_height}{self.x_pos}{self.y_pos}) self.is_expanded True # 展开后让窗口获得焦点方便查看 self.focus_force() def collapse(self): 收起窗口只显示标题栏 if self.is_expanded: self.message_frame.pack_forget() self.current_height self.height_collapsed self.geometry(f{self.width}x{self.current_height}{self.x_pos}{self.y_pos}) self.is_expanded False3.3 窗口队列与位置管理当有多个告警同时到达时我们需要管理它们的显示位置避免重叠。# 在 alert_window.py 文件开头或单独的管理模块中 class AlertManager: 管理多个告警窗口的队列和位置 def __init__(self, master_root): self.master master_root self.active_alerts [] # 存储当前活跃的窗口对象 self.alert_spacing 10 # 窗口之间的垂直间距 self.max_alerts_on_screen 5 # 屏幕最多同时显示的告警数 def show_alert(self, title, message, levelinfo): 创建并显示一个新的告警窗口 # 如果告警太多移除最早的一个 if len(self.active_alerts) self.max_alerts_on_screen: old_alert self.active_alerts.pop(0) old_alert.destroy() # 创建新告警 new_alert AlertWindow(self.master, titletitle, messagemessage, levellevel) # 计算新窗口的位置从下往上堆叠 screen_height self.master.winfo_screenheight() base_y screen_height - new_alert.height_collapsed - 60 # 初始底部位置 for i, alert in enumerate(reversed(self.active_alerts)): # 每个已有窗口上移一个位置加上间距 new_y base_y - (i 1) * (alert.height_collapsed self.alert_spacing) # 确保不会移出屏幕顶部 if new_y 20: new_y 20 alert.y_pos new_y alert.geometry(f{alert.x_pos}{new_y}) # 将新窗口添加到列表末尾 self.active_alerts.append(new_alert) # 绑定销毁事件以便从管理列表中移除 def on_destroy(event, alert_objnew_alert): if alert_obj in self.active_alerts: self.active_alerts.remove(alert_obj) # 当一个窗口被关闭后重新计算剩余窗口的位置 self._reposition_alerts() new_alert.bind(Destroy, on_destroy) return new_alert def _reposition_alerts(self): 重新排列所有活跃告警窗口的位置 screen_height self.master.winfo_screenheight() base_y screen_height - 60 # 参考底部位置 for i, alert in enumerate(reversed(self.active_alerts)): new_y base_y - i * (alert.height_collapsed self.alert_spacing) if new_y 20: new_y 20 alert.y_pos new_y alert.geometry(f{alert.x_pos}{new_y})4. 集成系统托盘与后台服务一个桌面工具应该能常驻后台并通过系统托盘图标进行控制。4.1 创建系统托盘图标我们在tray_icon.py中创建系统托盘图标及其菜单。import pystray from PIL import Image, ImageDraw import threading import tkinter as tk def create_tray_icon(root_window, alert_manager): 创建系统托盘图标和菜单 # 创建一个简单的图标可以用图片替代 def create_image(): # 绘制一个简单的圆形图标 image Image.new(RGB, (64, 64), color#3a7ca5) draw ImageDraw.Draw(image) draw.ellipse((16, 16, 48, 48), fillwhite, outlinewhite) draw.text((22, 22), i, fill#3a7ca5, fontNone) # 简单写个 i 表示 info return image # 定义菜单项的动作 def show_test_alert(icon, item): # 在主线程中执行Tkinter操作 root_window.after(0, lambda: alert_manager.show_alert( 测试告警, 这是一个来自系统托盘菜单的测试消息。\n你可以在这里放置很长的消息内容窗口会自动换行并显示滚动条。, info )) def show_about(icon, item): # 可以弹出一个关于对话框 import tkinter.messagebox as msgbox root_window.after(0, lambda: msgbox.showinfo(关于, 桌面告警小工具 v1.0\n模仿环世界信件系统。)) def quit_application(icon, item): icon.stop() root_window.after(0, root_window.destroy) # 创建菜单 menu ( pystray.MenuItem(显示测试告警, show_test_alert), pystray.MenuItem(关于, show_about), pystray.Menu.SEPARATOR, pystray.MenuItem(退出, quit_application), ) # 创建托盘图标 icon pystray.Icon( desktop_alert_tool, iconcreate_image(), menumenu, title桌面告警工具 ) return icon4.2 启动主程序与事件循环在main.py中我们将所有部分串联起来启动 Tkinter 主窗口隐藏和系统托盘图标。import tkinter as tk from threading import Thread import sys import os sys.path.append(os.path.dirname(os.path.abspath(__file__))) from alert_window import AlertManager from tray_icon import create_tray_icon # 后续会添加 from ipc_server import start_ipc_server def main(): # 创建 Tkinter 根窗口但不显示 root tk.Tk() root.withdraw() # 隐藏主窗口 root.title(Desktop Alert Tool) # 初始化告警管理器 alert_manager AlertManager(root) # 创建并启动系统托盘图标在新线程中运行 tray_icon create_tray_icon(root, alert_manager) def run_tray(): tray_icon.run() tray_thread Thread(targetrun_tray, daemonTrue) tray_thread.start() # 启动 IPC 服务器监听外部消息后续实现 # ipc_thread Thread(targetstart_ipc_server, args(alert_manager,), daemonTrue) # ipc_thread.start() # 启动 Tkinter 主循环 try: root.mainloop() except KeyboardInterrupt: print(程序被中断正在退出...) finally: tray_icon.stop() sys.exit(0) if __name__ __main__: main()现在运行python main.py你应该能在系统托盘看到一个图标。右键点击图标选择“显示测试告警”一个模仿《环世界》风格的告警窗口就会从屏幕右下角弹出。点击标题栏可以展开/收起拖动标题栏可以移动位置点击关闭按钮可以移除告警。5. 实现进程间通信接收外部消息一个只能从内部菜单触发的告警工具意义有限。我们需要让它能接收来自其他进程的命令这才是其实用性的关键。5.1 设计简单的 IPC 协议为了简单和跨平台我们使用本地 TCP 套接字作为通信方式。我们定义一种简单的基于文本的协议例如 JSON 格式。外部程序发送的告警消息可以是一个 JSON 字符串{ title: 备份任务完成, message: 数据库备份已于 2023-10-27 15:30:02 成功完成。\n文件大小1.2GB\n存储路径D:\\Backups\\, level: info }5.2 实现 IPC 服务器在ipc_server.py中我们创建一个简单的 TCP 服务器监听本地端口例如 9999接收并解析 JSON 消息然后调用AlertManager来显示告警。import socket import json import threading import traceback from queue import Queue import tkinter as tk class IPCServer: def __init__(self, host127.0.0.1, port9999, alert_managerNone): self.host host self.port port self.alert_manager alert_manager self.server_socket None self.running False self.message_queue Queue() # 用于线程间传递消息到Tkinter主线程 def start(self): 启动IPC服务器线程 self.running True server_thread threading.Thread(targetself._run_server, daemonTrue) server_thread.start() print(fIPC服务器已启动监听 {self.host}:{self.port}) def _run_server(self): 服务器主循环 self.server_socket socket.socket(socket.AF_INET, socket.SOCK_STREAM) self.server_socket.setsockopt(socket.SOL_SOCKET, socket.SO_REUSEADDR, 1) try: self.server_socket.bind((self.host, self.port)) self.server_socket.listen(5) # 允许最多5个连接排队 self.server_socket.settimeout(1.0) # 设置超时以便定期检查 running 标志 while self.running: try: client_socket, addr self.server_socket.accept() # 为每个客户端连接创建一个新线程处理 client_thread threading.Thread(targetself._handle_client, args(client_socket, addr)) client_thread.daemon True client_thread.start() except socket.timeout: # 超时循环继续检查 running 标志 continue except OSError as e: if self.running: print(f服务器接受连接时出错: {e}) break except Exception as e: print(f启动服务器失败: {e}) traceback.print_exc() finally: if self.server_socket: self.server_socket.close() def _handle_client(self, client_socket, addr): 处理单个客户端连接 print(f新的连接来自: {addr}) try: data client_socket.recv(4096).decode(utf-8) if not data: return print(f收到原始数据: {data}) # 尝试解析JSON try: alert_data json.loads(data.strip()) title alert_data.get(title, 新通知) message alert_data.get(message, ) level alert_data.get(level, info).lower() # 验证level if level not in [info, warning, error]: level info # 将消息放入队列由主线程处理Tkinter GUI更新 self.message_queue.put((title, message, level)) # 发送成功响应 response json.dumps({status: success, message: Alert received.}) client_socket.sendall(response.encode(utf-8)) except json.JSONDecodeError as e: print(fJSON解析错误: {e}) response json.dumps({status: error, message: Invalid JSON format.}) client_socket.sendall(response.encode(utf-8)) except Exception as e: print(f处理消息时出错: {e}) response json.dumps({status: error, message: Internal server error.}) client_socket.sendall(response.encode(utf-8)) except Exception as e: print(f与客户端 {addr} 通信时出错: {e}) finally: client_socket.close() def stop(self): 停止服务器 self.running False if self.server_socket: try: # 创建一个临时连接来打破 accept() 阻塞 temp_socket socket.socket(socket.AF_INET, socket.SOCK_STREAM) temp_socket.connect((self.host, self.port)) temp_socket.close() except: pass print(IPC服务器已停止) def start_ipc_server(alert_manager): 启动IPC服务器的便捷函数 server IPCServer(alert_manageralert_manager) server.start() return server5.3 在主程序中集成 IPC 并处理消息队列我们需要修改main.py启动 IPC 服务器并定期检查消息队列将接收到的告警显示出来。# 更新后的 main.py 部分 import tkinter as tk from threading import Thread import sys import os sys.path.append(os.path.dirname(os.path.abspath(__file__))) from alert_window import AlertManager from tray_icon import create_tray_icon from ipc_server import start_ipc_server, IPCServer def main(): root tk.Tk() root.withdraw() root.title(Desktop Alert Tool) alert_manager AlertManager(root) # 创建并启动系统托盘图标 tray_icon create_tray_icon(root, alert_manager) def run_tray(): tray_icon.run() tray_thread Thread(targetrun_tray, daemonTrue) tray_thread.start() # 启动 IPC 服务器 ipc_server start_ipc_server(alert_manager) # 定期检查 IPC 消息队列的函数 def check_ipc_queue(): try: while not ipc_server.message_queue.empty(): title, message, level ipc_server.message_queue.get_nowait() # 在主线程中创建告警窗口 alert_manager.show_alert(title, message, level) except Exception as e: print(f处理消息队列时出错: {e}) # 每100毫秒检查一次 root.after(100, check_ipc_queue) # 启动队列检查 root.after(100, check_ipc_queue) try: root.mainloop() except KeyboardInterrupt: print(程序被中断正在退出...) finally: tray_icon.stop() ipc_server.stop() sys.exit(0) if __name__ __main__: main()5.4 从外部发送告警现在任何能连接 TCP 端口并发送 JSON 的程序都可以触发告警了。这里提供一个 Python 客户端示例send_alert.py# send_alert.py import socket import json import sys def send_alert(title, message, levelinfo, host127.0.0.1, port9999): 发送告警到桌面告警工具 data { title: title, message: message, level: level } json_data json.dumps(data) try: with socket.socket(socket.AF_INET, socket.SOCK_STREAM) as sock: sock.settimeout(5) sock.connect((host, port)) sock.sendall(json_data.encode(utf-8)) # 接收响应 response sock.recv(1024).decode(utf-8) print(f服务器响应: {response}) except ConnectionRefusedError: print(错误无法连接到桌面告警工具。请确保工具正在运行。) except socket.timeout: print(错误连接超时。) except Exception as e: print(f发送告警时出错: {e}) if __name__ __main__: # 示例从命令行参数读取或使用默认值 if len(sys.argv) 3: title sys.argv[1] message sys.argv[2] level sys.argv[3] if len(sys.argv) 3 else info else: title 命令行测试 message 这是一条通过命令行发送的测试消息。\n你可以集成到任何脚本中。 level info send_alert(title, message, level)使用方法python send_alert.py 任务完成 每日数据同步已成功执行。 info你也可以在批处理脚本.bat或 PowerShell 脚本中调用这个 Python 客户端或者用其他任何语言如 Java, C#, Go, Bash 借助 netcat实现相同的 TCP 通信逻辑。6. 常见问题排查与优化在实际使用中你可能会遇到一些问题。下面是一些常见问题的排查路径和解决方案。6.1 程序启动与运行问题问题现象可能原因检查方式处理建议运行python main.py后无任何反应托盘图标未出现。1. Python 环境或依赖未正确安装。2.pystray在某些系统上需要额外依赖。3. 脚本路径或导入错误。1. 在命令行运行查看是否有错误输出。2. 检查pip list确认pystray和Pillow已安装。3. 尝试运行一个简单的pystray示例。1. 确保使用pip install -r requirements.txt安装依赖。2. 在 Windows 上pystray通常能直接运行。在 Linux 上可能需要安装python3-xlib等包。3. 在main.py开头添加print(“启动...”)调试。托盘图标出现但点击“显示测试告警”无反应。1. Tkinter 主循环未正确启动或阻塞。2.AlertManager或AlertWindow初始化失败。3. 图像资源路径错误。1. 检查命令行是否有异常输出。2. 确认assets/目录下存在图标文件。3. 在show_test_alert函数内添加print语句。1. 确保root.mainloop()被调用且没有在它之前运行耗时操作。2. 将图标加载代码加上try-except打印错误。3. 使用绝对路径或os.path.join确保资源文件可找到。告警窗口出现但位置不对或互相重叠。1. 屏幕尺寸获取不准确。2.AlertManager的位置计算逻辑有误。3. 多显示器环境。1. 打印screen_width和screen_height的值。2. 检查base_y和new_y的计算过程。1. 使用root.winfo_screenwidth()和root.winfo_screenheight()获取主显示器尺寸。2. 在多显示器环境下Tkinter 可能只识别主显示器。可以考虑使用win32api(Windows) 获取更精确的屏幕信息。通过send_alert.py发送消息但桌面工具无反应。1. 桌面工具未启动。2. IPC 服务器端口被占用或未启动。3. 防火墙阻止了本地连接。4. JSON 格式错误。1. 确认main.py正在运行。2. 使用 netstat -anofindstr :9999(Windows) 查看端口状态。br3. 查看桌面工具的命令行输出是否有错误。br4. 检查send_alert.py 发送的 JSON 字符串。6.2 功能与交互优化建议持久化与历史记录当前告警关闭后就消失了。可以增加一个“历史”菜单项点击后弹出一个新窗口显示所有接收过的告警记录。这需要将告警信息标题、内容、时间、级别保存到本地文件如 SQLite 数据库或 JSON 文件中。配置化将窗口颜色、默认位置、IPC 端口、最大告警数量等参数提取到配置文件如config.ini或settings.json中方便用户自定义。声音提示为不同级别的告警添加不同的系统提示音。自动清理为告警窗口增加“自动关闭”计时器例如信息类告警显示 10 秒后自动关闭。更丰富的消息格式支持在message字段中使用简单的 Markdown 或 HTML 来提供粗体、链接等格式Tkinter 的Text控件支持部分标签。协议增强在 IPC 协议中增加duration显示时长、actions可点击按钮等字段使外部调用更灵活。打包为可执行文件使用PyInstaller或cx_Freeze将项目打包成单个.exe文件方便在无 Python 环境的 Windows 电脑上运行。6.3 生产环境考量如果计划在更严肃的环境中使用如监控服务器关键任务需要考虑以下几点可靠性IPC 服务器需要更健壮的错误处理和连接管理避免因单个错误消息崩溃。安全性目前的 IPC 服务器监听127.0.0.1相对安全。如果考虑接收网络消息必须添加身份验证和消息加密。资源管理需要监控内存使用防止告警窗口过多导致内存泄漏。确保窗口被销毁时相关资源被正确释放。日志增加详细的运行日志记录告警的接收、显示、错误等信息便于排查问题。开机自启将工具配置为 Windows 服务或添加到启动文件夹实现开机自动运行。7. 总结与扩展方向我们完成了一个模仿《环世界》信件系统的桌面告警小工具的核心功能。它具备非模态展示、分级显示、系统托盘常驻以及通过 TCP 套接字接收外部消息的能力。这个工具的价值在于其轻量、非侵入和可集成性你可以将它作为各种自动化脚本的“消息终点站”。下一步可以尝试的扩展跨平台适配pystray本身支持跨平台但图标和菜单行为可能略有差异。可以针对 macOS 和 Linux 的托盘规范进行微调。窗口拖动和焦点行为在不同系统上也可能需要调整。与现有监控系统集成编写适配器让工具可以接收来自 Prometheus Alertmanager、Zabbix、Nagios 等监控系统的 Webhook 告警。实现“勿扰模式”在系统托盘菜单中添加一个“勿扰模式”开关开启后暂时不弹出新告警但记录在历史中。高级过滤规则允许用户通过配置文件定义规则例如只显示包含特定关键词或来自特定发送者的“错误”级别告警。这个项目的代码是开源的你可以根据实际需求进行修改和增强。最重要的不是复刻一个完全一样的系统而是理解其“优雅通知”的设计哲学并将其应用到解决实际问题的工具中。
平方复杂度无法被常规优化消除｜TaoToken 统一 Key 通道实测)
