用途:解决月度平均值无法反映发薪日与账单日错位的问题,为每个现金账户逐日预测期末余额,识别可能跌破安全线的日期及账户低谷。
主要能力:基于今日实际余额、周期记录中下一预期日期落在预测窗口内的所有流入流出,以及由近6个月非周期性支出推算的“自由支出尾部”,生成每日余额。输出包含预测区间、每日余额与流水、账户级低谷、首次跌破日期、跌破天数、1.5σ置信区间、告警与方法说明。
使用方式:调用方需提供 accounts({id,type,current_balance_cents,safety_floor_cents})、recurring(status为 active 的记录)、每个现金账户近180天分类交易、today(ISO 日期)、horizon_days(默认60),可选 category_overrides 用于已知的一次性支出。流程为初始化每日台账、推算周期流水、计算自由支出尾部、按日摊分、应用 overrides、滚动计算余额、标记低于安全线并识别低谷、计算置信区间。
适用场景:个人或家庭现金账户的短期流动性规划,按账户查看租金、房贷等固定支出与发薪日的匹配情况。
限制:仅预测现金账户,不预测券商、401k、HSA 等非现金持仓;房贷额外本金还款须通过 category_override 显式提供,不自动推算;自由支出均值为估算而非预测,计划应以区间下界为准;周期记录与自由支出集合互斥以避免重复计算;预测会随新交易快速过期,应频繁重跑。方法中如采用星期几、发薪日附近或季节性调整,需在 methodology 字段中记录。