用途:把家庭财务数据仓库生成一份单文件、自包含的静态 HTML 仪表盘,数据与图表代码全部内联,任何浏览器直接打开即可,无需服务器;设计为按周重新生成并归档到 reports/dashboards/YYYY-MM-DD-weekly.html。
输入契约:调用方提供 data_root(household-finance 的 data/ 目录)、output_path、generated_for(weekly 或 monthly)、as_of(快照日期),可选 prior_snapshot_path 用于周环比。数据遵循 household-finance schema,读取 accounts.json、balances.json、transactions.json(按窗口过滤)、recurring.json、goals.json、investments.json、mortgage.json、reports/alerts/ 最近文件及最近一期 reports/monthly/*.json。
六个面板:1)净值随时间变化,折线图并标注按揭发放、大额缴款等事件;2)近 12 个月月度现金流,收支双向柱状图叠加 6 个月滚动储蓄率;3)经常性支出与订阅,按年化成本降序的前 15 项横向条形图;4)目标进度,已完成与剩余堆叠条形并按线性节奏标注在轨/落后/超前;5)资产配置,当前与目标的环形图对比及最大偏离;6)警觉信息流,最近 10 条按严重程度标注的文本列表,含证据与建议动作。
工作流程:读取并校验数据、计算快照、生成六份面板数据、按认知设计原则布局、生成 3–5 行叙事头部、渲染 HTML 骨架与内联数据及 D3 代码、做认知谬误自检(不截断坐标轴、无 3D、饼图最多 6 片且显示总量、时间序列含零基线或显式标注)、写出文件并在页脚标注数据缺口。
限制与护栏:文件目标小于 1 MB,超出则对时间序列降采样;不发起外部数据请求;嵌入账号掩码(****1234),不含完整账号、SSN;相同输入与生成日期应产出字节一致 HTML(除时间戳);图表带标题与摘要式 aria 标签并提供表格替代;768px 以下折叠为单列。文件内示例骨架含内联数据块与 D3 v7 引用(可改为内联以完全离线)。具体安装命令、定价、平台支持等资料暂未提供。