🎀 接入配置

签到数据来自飞书群，读取用的是你本人的飞书身份 OAuth，不需要把机器人拉进群，也能读历史消息。 令牌有效期约 2 小时，服务会自动续期 —— 只有授权被撤销时才需要重新点一次。 数据由服务进程直接入库，不走推送接口、也不需要任何 API Key。

授权报错 20029 基本都是回调地址差了一两个字符（127.0.0.1 与 localhost 在飞书白名单里算两个地址、 末尾多一个斜杠、少了 /feishu/callback 都会中招）。把你在开放平台填的地址粘回来逐字比对：

开放平台里的位置：应用详情 → 开发配置 → 安全设置 → 重定向 URL → 添加。 改完记得发布一个新版本，否则白名单还是旧的。

以上三组凭证统一存放在数据目录下的 config.json，改完立即生效，不需要重启。 密钥在接口返回时一律是掩码，页面不回显明文。用量快照另存在 *_usage.json， 那是采样出来的派生数据，删掉会自动重建。