签到

解决什么问题

日常习惯记录的一个常见问题是：用户想知道今天是否已完成，却缺少一个轻量、集中、可回看的结果。签到面向这个场景，提供一个运行在 http://localhost:8001 的 Web 打卡页，把“是否已打卡”“连续了多久”“本月哪些天完成”收敛到同一个界面，减少在聊天窗口、纸面或临时脚本之间来回切换。

核心能力与工作方式

该技能的核心是围绕一次打卡行为展开的轻量 Web 应用：

• 打卡签到：在页面中央点击圆形按钮完成当日打卡，打卡后按钮转为绿色，/api/checkin 使用 POST 执行记录。
• 状态读取：页面通过 GET /api/status 获取今日是否已打卡，用于渲染按钮状态。
• 统计展示：顶部展示累计打卡天数、当前连续打卡天数、历史最长连续天数，依赖后端汇总打卡事实，而不是前端临时猜测。
• 日历视图：通过 GET /api/calendar 获取日历数据，已打卡日期显示为绿色，支持左右箭头切换月份。
• 历史记录：通过 GET /api/history 获取最近打卡记录，包含日期和时间。

使用流程可以概括为：启动服务后访问 http://localhost:8001，查看今日状态，点击按钮完成打卡，再从顶部统计、月历和历史列表确认结果是否符合预期。若要看某个月的连续性，切换月份即可；若要看最近行为，查看历史记录即可。

适用边界与注意点

它适合需要轻量每日确认的单用户习惯记录，不适合复杂的团队协作排班、多角色权限管理或强规则审计流程。日历和统计依赖既有打卡数据的正确写入；如果数据库、服务未启动或接口异常，页面可能无法反映真实状态。当前文档未描述认证、数据迁移、删除历史记录或跨时区处理，因此接入时需要把这些能力作为外部约束另行确认。