课堂点名计时器

# @name: 我的插件
# @icon: 🔧
# @desc: 这是插件的功能描述，会在主界面中展示。

def on_load(app):
    """插件首次加载时调用（应用启动时）。"""
    print("插件已加载")

def on_enable(app):
    """用户点击"启用"按钮时调用。"""
    print("插件已启用")

def on_disable(app):
    """用户点击"停用"按钮时调用。"""
    print("插件已停用")

app._main_win        # MainWindow 主窗口实例
app._ball            # FloatingBall 浮球实例
app._anno_bar        # AnnotationToolbar 批注工具栏
app._anno_canvas     # AnnotationCanvas 批注画布（懒加载，可能为 None）
app._whiteboard      # WhiteboardCanvas 白板画布（懒加载，可能为 None）
app._time_island     # TimeIslandWidget 时间岛（懒加载）
app._island_panel    # TimeIslandDetailPanel 时间岛详情面板（懒加载）
app._async_win       # AsyncPickWindow 异步抽签窗口
app._pick_flash      # PickFlashOverlay 抽签闪光效果
app._fast_mode       # bool 快速模式
app._animation_enabled # bool 自动化全局开关
app._plugin_mgr      # PluginManager 插件管理器

from utils import config as cfg     # 配置读写
from utils import logger as log      # 日志输出
from utils.config import get_resource_dir  # 获取资源目录

from utils import config as cfg

cfg.get('key', default)          # 读取配置
cfg.set('key', value)            # 写入配置（自动持久化）
cfg.load()                       # 返回完整配置字典
cfg.save({'key': 'val'})         # 批量写入
cfg.load_roster('name')          # 加载名单
cfg.save_roster('name', list)    # 保存名单

from utils import logger as log

log.info('消息')
log.warning('警告')
log.error('错误')
log.debug('调试')

# @name: 计时提醒
# @icon: ⏰
# @desc: 每隔指定分钟数弹出一个托盘提醒，帮助教师把控课堂节奏。

from PyQt5.QtCore import QTimer
from PyQt5.QtWidgets import QSystemTrayIcon

_INTERVAL = 5 * 60 * 1000  # 5分钟

_timer = None

def on_load(app):
    """初始化但不启动。"""
    pass

def on_enable(app):
    """启动定时器。"""
    global _timer
    _timer = QTimer()
    _timer.setInterval(_INTERVAL)
    _timer.timeout.connect(lambda: _notify(app))
    _timer.start()
    from utils import logger as log
    log.info('计时提醒插件已启动')

def on_disable(app):
    """停止定时器并清理。"""
    global _timer
    if _timer:
        _timer.stop()
        _timer = None

def _notify(app):
    """发送托盘通知。"""
    tray = None
    for w in app._app.topLevelWidgets():
        if hasattr(w, '_tray'):
            tray = w._tray
            break
    if tray:
        tray.showMessage('计时提醒', '已经过了预设时间，请注意课堂节奏。',
                         QSystemTrayIcon.Information, 3000)

hiddenimports 中添加 'plugins.你的文件名'
datas 中已包含 ('plugins', 'plugins')，无需额外修改