api-worker/helloagents/modules/settings.md

settings 模块

职责

• 维护系统级配置（如日志保留天数）
• 为使用日志与面板提供统一配置读取
• 维护定时签到执行时间

接口定义

• GET /api/settings 读取设置
• PUT /api/settings 更新设置

行为规范

• 配置写入后即时生效
• 未配置时使用环境变量默认值
• 定时签到时间使用 HH:mm 格式（默认 00:10，中国时间）
• 更新签到时间后会触发 CheckinScheduler 重新调度
• 若更新后当前时间已超过新签到时间，当日可再次触发自动签到

依赖关系

• settings 表