yee88 0.8.0__tar.gz → 0.9.0__tar.gz

yee88-0.9.0/.git

@@ -0,0 +1 @@
+gitdir: /Users/yee.wang/Code/github/takopi/.git/worktrees/add-topic

yee88-0.9.0/.sisyphus/drafts/cron-system-fix.md

@@ -0,0 +1,55 @@
+# Draft: yee88 Cron 定时任务系统修复
+
+## 初始需求
+修复 Python Telegram Bridge 工具 (yee88) 中的 cron 定时任务系统
+
+## 待修复的问题清单 (优先级从高到低)
+
+### P0 - 错过执行补偿机制缺失 (manager.py)
+- 问题：进程重启后会跳过应该执行的定时任务
+- 示例：每天9:00执行的任务，若8:59崩溃、9:30重启，9:00的任务会被跳过
+- 解决方案：使用 croniter.get_prev() 检测错过的执行并补偿
+
+### P0 - 任务重叠保护缺失 (scheduler.py)
+- 问题：如果任务执行时间超过调度间隔，会导致同一个任务同时运行多次
+- 解决方案：添加 anyio.Lock 和 running_jobs 集合来防止重叠
+
+### P1 - 轮询间隔过大且固定 (scheduler.py)
+- 问题：当前固定60秒轮询，对于每5分钟执行的任务，最大延迟可达60秒
+- 解决方案：实现智能计算下次检查时间，基于最近的任务调度
+
+### P1 - 任务执行无超时保护 (scheduler.py)
+- 问题：如果 callback 永远挂起，会占用任务槽位
+- 解决方案：使用 anyio.move_on_after() 添加3分钟超时
+
+### P1 - 配置热更新不彻底 (loop.py 和 scheduler.py)
+- 问题：虽然使用了 watchfiles 监视主配置，但 cron 还是轮询式加载
+- 解决方案：整合 watchfiles 的事件驱动机制到 cron 系统中
+
+### P2 - 日志增强 (scheduler.py, manager.py)
+- 添加 missed_executions 统计日志
+
+## 文件结构
+- src/yee88/cron/manager.py (186行) - CronManager 类
+- src/yee88/cron/scheduler.py (58行) - CronScheduler 类
+- src/yee88/cron/models.py (17行) - CronJob dataclass
+- src/yee88/telegram/loop.py (~1500行) - run_main_loop()
+- tests/test_cron_manager.py (422行)
+- tests/test_cron_scheduler.py (143行)
+
+## 依赖
+- croniter >= 2.0.0
+- watchfiles
+- anyio
+- tomllib/tomli_w
+
+## 背景代理任务
+- bg_5ea72908: Explore cron system codebase (状态: running - 29s, last tool: read)
+- bg_ae7a8aef: Research cron best practices (状态: running - 27s, last tool: codesearch)
+
+## 下一步
+等待两个背景代理完成，获取：
+1. 现有代码的详细分析（尤其是 get_due_jobs() 和 start() 方法的实现）
+2. 最佳实践研究（croniter.get_prev(), anyio.Lock 等模式）
+
+然后制定详细的工作计划。