技能介绍

解决了什么问题

WorkBuddy 客户端没有提供查询历史积分消耗的公开接口。你想知道「这个月到底花了多少积分」，只能靠肉眼对比两次打开客户端时看到的余额数字，既无法还原逐次消耗，也很难定位是哪个会话烧掉了积分。这个技能的思路是换一个数据源：不调用任何 API，直接读 WorkBuddy 自己的本地数据库，从服务端的消耗记录里把积分流水拼出来。

核心工作方式

整套逻辑建立在「基准点 + 增量扣减」上，分三步：

建立基准点：首次使用时，你手动输入当前看到的余额（例如 1291.39），保存到本地文件 balance.json 作为起点。
累计增量消耗：每次查询时，技能读取 ~/.workbuddy/workbuddy.db 中 session_usage 表的 credit_json 字段，累加基准点之后所有会话的积分消耗。
估算当前余额：当前余额 ≈ 基准余额 − 累计消耗，同时输出一份消耗报告。

校准是这套机制的关键。因为基准余额是历史值，估算结果天然带漂移。看到客户端实际余额后执行 --update 刷新基准点即可纠正误差。该字段 credit_json 始终写入数据库，因此数据源稳定可用。

适用边界与注意点

估算值，不是精确余额。消耗记录可靠，但基准点依赖你输入的时机；如果期间有过签到奖励、月度额度发放等未记录进 session_usage 的变动，估算会偏小。
数据是本地快照。数据库是本机文件，换机器或清理 ~/.workbuddy 目录后历史记录会丢失，需要重新建立基准点。
适合自动化盘点，不适合实时对账。把它接到定时任务（例如每天 9:00 拉取一次消耗报告）做趋势观察很合适；要核对到分的账单，仍需回到客户端。
参考换算：1 积分约等于 31874 Tokens，签到每天 100 积分、第 7 天 1000 积分，注册赠送 5000 积分（90 天有效），每月 1 号自动发放月度免费额度——这些数值可用于判断估算偏差是否来自非会话类变动。