菜单
Use when a morari timer 计时器类应用的 session 因忘记停止（手機鎖屏、忘記點停止）而记录了错误的结束时间，需要在数据库层手动修正 session 时长、debt（连续用眼债务）与 daily 统计、phase 状态时。适用于带「连续使用上限 + 债务」机制的计时系统（如 agent_manager 项目）。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
Use when styling Mermaid flowchart diagrams for GitHub, Obsidian, or MkDocs
Use when setting up logging for a new Python/FastAPI project, adding structured logging to an existing project, creating a logging module, or configuring JSON log output. Triggers include new projects needing observability, questions about log format standards, request tracing with request_id, or adding log context propagation.
Use when creating or modifying FastAPI endpoints, adding error handling, defining response schemas, or reviewing API response consistency. Triggers include new routers, HTTPException usage, JSONResponse construction, Pydantic response models, or any question about API error/success format in a FastAPI project.
Use when importing product serial numbers, license keys, card codes, activation codes, or inventory keys into EasyStore/easystore-backend with price, quantity, cost, supplier, card type, or batch-confirmation requirements.
基于 SOC 职业分类
| name | morari-timer-session-debt-correction |
| description | Use when a morari timer 计时器类应用的 session 因忘记停止（手機鎖屏、忘記點停止）而记录了错误的结束时间，需要在数据库层手动修正 session 时长、debt（连续用眼债务）与 daily 统计、phase 状态时。适用于带「连续使用上限 + 债务」机制的计时系统（如 agent_manager 项目）。 |
Session 因未正常停止，ended_at 远晚于实际结束时间（例如使用者说「工作其实 1:50 就结束了，但系统显示 7:09」）。需要修正该 session，并连带修正由它衍生出的统计与状态。
症状：duration_sec 异常长、debt_sec 异常大、timer_state.phase = 'daily_done'（但实际今日用眼远未超标）。
这类系统通常不是单纯把 session 时长加总，而是用「连续用眼时间」对照阈值滚动计算债务：
screen 类型（如工作）：
previous_overage = max(0, continuous_screen_sec_前 - threshold)
continuous_screen_sec += elapsed
new_overage = max(0, continuous_screen_sec - threshold)
added_debt = max(0, new_overage - previous_overage)
accumulated_debt_sec += added_debt；该 session 的 debt_sec = added_debt
系统类非screen类型（如休息，is_system=true）：
surplus = max(0, elapsed - interval_minutes*60)
accumulated_debt_sec = max(0, accumulated_debt_sec - surplus)（休息会还债）
continuous_screen_sec 重置为 0
其他非screen类型（如睡觉）：只累加 daily_non_screen_sec，不影响 debt，也会重置 continuous_screen_sec
phase 变成 daily_done 的条件是 daily_screen_sec + elapsed >= daily_limit_minutes*60。一旦某个 session 时长被错误地拉长（计时器没停），会连环导致：该 session 的 debt 暴增 → accumulated_debt_sec 暴增 → daily_screen_sec 暴增 → phase 被误判为 daily_done。
duration_sec 与「使用者说的实际结束时间」对不上的就是它。ended_at、重算 duration_sec。counts_screen_time 分组重新 SUM，不要用算术减法去猜（容易漏算时区边界）。timer_state.phase：若新的 daily_screen_sec 远低于上限，改回 idle（不要保留 daily_done）。同时更新 updated_at 为修正后的实际结束时间。BEGIN...COMMIT）内执行，执行后立即 SELECT 验证。AT TIME ZONE '<当地时区>' 转换后再判断「今天」的范围，否则跨日时段会算错。