要实现一个**电脑端定时喝水提醒小程序（Python）**，需兼顾功能性、可维护性（低耦合、高内聚）、用户体验（简洁界面 + 可靠弹窗）。以下是清晰分步设计与实现方案： --- ### ✅ 一、整体设计原则（低耦合 & 高内聚） - **低耦合**：各模块职责单一，通过接口/配置/事件通信，不直接依赖具体实现（如提醒逻辑不硬编码UI库）。 - **高内聚**：每个模块内部紧密协作完成单一职责（如 `Notifier` 专注“发出提醒”，不处理计时或设置）。 - 推荐采用 **MVC 或模块化分层结构**（非强制MVC，但思想类似）： ``` main.py # 启动入口，协调调度 └── core/ ├── timer.py # 定时器管理（基于 threading.Timer / schedule / APScheduler） ├── notifier.py # 提醒服务（封装系统弹窗 + 声音 + 可选托盘图标） └── config.py # 配置管理（间隔时间、静默时段、是否开机自启等） └── ui/ └── app.py # GUI主界面（PyQt6/PySide6 推荐，轻量且跨平台；tkinter次选） ``` --- ### ✅ 二、分步实现（含关键代码示例） #### ▶ 步骤1：定义配置（`core/config.py`） ```python # core/config.py —— 高内聚：只管读写配置，不涉及业务逻辑 import json from pathlib import Path DEFAULT_CONFIG = { "interval_minutes": 30, "enable_sound": True, "mute_hours": {"start": 22, "end": 7}, "first_run": True } CONFIG_FILE = Path(__file__).parent.parent / "config.json" def load_config() -> dict: if CONFIG_FILE.exists(): return json.loads(CONFIG_FILE.read_text(encoding="utf-8")) return DEFAULT_CONFIG.copy() def save_config(cfg: dict): CONFIG_FILE.write_text(json.dumps(cfg, indent=2, ensure_ascii=False), encoding="utf-8") ``` #### ▶ 步骤2：构建可插拔提醒器（`core/notifier.py`） ```python # core/notifier.py —— 高内聚：只负责“通知”，解耦UI/声音/系统API import platform import subprocess import threading from pathlib import Path class Notifier: def __init__(self): self._sound_path = Path(__file__).parent.parent / "assets" / "ding.wav" def notify(self, title: str = "💧 该喝水啦！", message: str = "记得补充水分，保持活力~"): # 跨平台弹窗 + 声音（不阻塞主线程） threading.Thread(target=self._do_notify, args=(title, message), daemon=True).start() def _do_notify(self, title, message): system = platform.system() if system == "Windows": from win10toast import ToastNotifier toaster = ToastNotifier() toaster.show_toast(title, message, duration=5, icon_path=None) if load_config().get("enable_sound"): self._play_sound() elif system == "Darwin": # macOS subprocess.run([ 'osascript', '-e', f'display notification "{message}" with title "{title}"' ]) if load_config().get("enable_sound"): subprocess.run(["afplay", str(self._sound_path)]) else: # Linux (notify-send) subprocess.run(["notify-send", title, message]) if load_config().get("enable_sound"): subprocess.run(["paplay", str(self._sound_path)]) def _play_sound(self): if self._sound_path.exists(): try: # 使用简单播放（无需pygame等重型依赖） import playsound playsound.playsound(str(self._sound_path), block=False) except ImportError: pass # 忽略无playsound情况 ``` #### ▶ 步骤3：定时调度器（`core/timer.py`） ```python # core/timer.py —— 高内聚：只管“什么时候触发”，不关心“触发什么” import threading import time from datetime import datetime from core.config import load_config class DrinkTimer: def __init__(self, notifier): self.notifier = notifier self._thread = None self._running = False def _is_muted_now(self) -> bool: cfg = load_config() mute = cfg.get("mute_hours", {}) if not mute: return False now = datetime.now().hour start, end = mute["start"], mute["end"] if start < end: return start <= now < end else: # 跨日（如22-7） return now >= start or now < end def _run_loop(self): while self._running: if not self._is_muted_now(): self.notifier.notify() # 等待下一次（避免固定sleep导致漂移，可用APScheduler更精准） time.sleep(load_config().get("interval_minutes", 30) * 60) def start(self): if not self._running: self._running = True self._thread = threading.Thread(target=self._run_loop, daemon=True) self._thread.start() def stop(self): self._running = False ``` #### ▶ 步骤4：GUI界面（`ui/app.py`，使用 PyQt6） ```python # ui/app.py —— 独立UI层，仅负责展示与用户交互 import sys from PyQt6.QtWidgets import (QApplication, QMainWindow, QWidget, QVBoxLayout, QLabel, QPushButton, QSpinBox, QCheckBox, QGroupBox) from PyQt6.QtCore import Qt from core.timer import DrinkTimer from core.notifier import Notifier from core.config import load_config, save_config class DrinkReminderApp(QMainWindow): def __init__(self): super().__init__() self.setWindowTitle("💧 喝水小助手") self.setMinimumWidth(320) self.notifier = Notifier() self.timer = DrinkTimer(self.notifier) # 初始化配置 cfg = load_config() self.interval_spin = QSpinBox() self.interval_spin.setRange(5, 120) self.interval_spin.setValue(cfg.get("interval_minutes", 30)) self.sound_check = QCheckBox("启用提示音") self.sound_check.setChecked(cfg.get("enable_sound", True)) # 构建UI widget = QWidget() layout = QVBoxLayout(widget) layout.addWidget(QLabel("⏰ 提醒间隔（分钟）：")) layout.addWidget(self.interval_spin) layout.addWidget(self.sound_check) btn_group = QGroupBox("控制") btn_layout = QVBoxLayout() self.start_btn = QPushButton("▶ 开始提醒") self.stop_btn = QPushButton("⏹ 暂停提醒") self.stop_btn.setEnabled(False) btn_layout.addWidget(self.start_btn) btn_layout.addWidget(self.stop_btn) btn_group.setLayout(btn_layout) layout.addWidget(btn_group) self.setCentralWidget(widget) # 绑定信号 self.start_btn.clicked.connect(self._on_start) self.stop_btn.clicked.connect(self._on_stop) def _on_start(self): cfg = load_config() cfg["interval_minutes"] = self.interval_spin.value() cfg["enable_sound"] = self.sound_check.isChecked() save_config(cfg) self.timer.start() self.start_btn.setEnabled(False) self.stop_btn.setEnabled(True) def _on_stop(self): self.timer.stop() self.start_btn.setEnabled(True) self.stop_btn.setEnabled(False) if __name__ == "__main__": app = QApplication(sys.argv) window = DrinkReminderApp() window.show() sys.exit(app.exec()) ``` #### ▶ 步骤5：启动入口（`main.py`） ```python # main.py —— 最简胶水层，低耦合体现 from ui.app import DrinkReminderApp from PyQt6.QtWidgets import QApplication import sys if __name__ == "__main__": app = QApplication(sys.argv) window = DrinkReminderApp() window.show() sys.exit(app.exec()) ``` --- ### ✅ 三、进阶建议（提升体验 & 工程性） - ✅ **托盘图标支持**：用 `QSystemTrayIcon` 实现后台常驻 + 右键菜单（开始/暂停/退出/设置）； - ✅ **开机自启**（Windows/macOS/Linux）：封装为脚本 + 注册系统服务/启动项（需用户授权）； - ✅ **日志记录**：用 `logging` 记录提醒时间、异常，便于排查； - ✅ **配置持久化 + GUI同步**：监听配置变更实时更新 timer； - ✅ **单元测试骨架**：对 `DrinkTimer._is_muted_now()`、`Notifier.notify()` mock 测试。 --- ### ✅ 四、依赖安装（requirements.txt） ```text PyQt6>=6.6.0 win10toast ; platform_system=="Windows" playsound>=1.3.0 ``` > 💡 运行命令：`pip install -r requirements.txt && python main.py` ---