阿拉丁·个人财务记账与月度复盘工作台
把散落在银行 App、支付宝、微信、备忘录里的账单,离线一键变成看得懂、能复盘、能省钱的个人/家庭财务账本。覆盖从「导入」到「月度复盘报告」的完整闭环,纯本地运行、零 API、零密钥。
何时触发
- "帮我记一下账" / "记一笔" / "这个月花了多少"
- "导入我的支付宝/微信/银行流水,分析一下"
- "做一个月度复盘" / "这个月钱花哪了" / "我的消费结构"
- "算一下我的储蓄率" / "我的预算超了吗" / "帮我做预算"
- "有没有重复扣款 / 自动续费 / 异常大额"
- "出一份财务报表 / 收支明细 CSV / 月度报告"
- 用户给出任意 CSV / TSV / JSON / 文本账单,想结构化分析与复盘
何时不触发
- 用户要做投资交易、选股、基金定投建议——本工作台只做记账与复盘,不荐股不代投
- 用户要对接网银实时拉取流水——本工作台吃本地导出文件,不做在线爬取
- 用户要企业级会计做账/报税——本工作台面向个人与家庭,非财税系统
- 用户只是问理财概念(如"什么是复利")——直接回答即可,不必跑全流程
- 用户要修改已发布技能的业务逻辑但不重新上架——直接改代码,无需本技能
能力边界
能做:
- 多源账单归一:银行/支付宝/微信 CSV、TSV、JSON、手工文本的自动识别与合并
- 智能分类:支出映射到国标居民消费八大类,收入映射工资/兼职/理财/红包等子类
- 月度对账:逐月收入、支出、净结余与趋势
- 预算执行:按类别月度限额对比,超支预警
- 财务健康:储蓄率、50-30-20 结构、应急储备月数、综合 A-D 评分
- 异常检测:重复交易、异常大额、疑似自动续费订阅
- 报告三件套:可视化 HTML 驾驶舱 + 可发送 MD 复盘 + Excel 友好 CSV
不能做:
- 不能联网拉取银行/支付平台实时流水(只吃本地导出文件)
- 不能提供投资建议、荐股、代客理财或税务申报
- 不能保证具体攒钱效果(仅提供数据与建议,决策在用户)
- 不能绕过 SkillHub 的安全审核或伪造评分
- 不能自动还款、自动转账等资金操作(只读分析)
输入输出规范
输入:
- 至少一个账单文件(CSV / TSV / JSON / 文本),路径传给
finance_ingest.py(必需) - 可选
--budget:类别月度限额 JSON(字符串或文件),启用预算监控 - 可选
--emergency-fund:应急储备金(元),用于算储备月数
输出:
ir.json:归一账本(aladin.finance-ir/v1)build.json:结构化分析(aladin.finance-build/v1)report.html/report.md/transactions.csv/category_summary.csv
输出位置: 由 --out / --outdir 指定,默认当前目录。
工作流
Step 1:多源账单归一(finance_ingest.py)
把不同格式账单统一为标准账本:
python scripts/finance_ingest.py 银行流水.csv 支付宝.csv 手工补记.txt --out ir.json
- 编码自适应(UTF-8 / GBK / GB18030),中文不乱码
- 列名自动识别(交易时间/收/支/金额/商品/收付款方式/备注 等)
- 金额清洗(¥ 元 万 亿 逗号、正负号、借/贷、收/支)
- 日期解析(2026-03-01 / 2026年3月1日 / 3月1日 等)
- 完全重复行自动去重
Step 2:分类与财务分析(finance_build.py)
python scripts/finance_build.py ir.json --out build.json \
--budget '{"餐饮":400,"居住":5000}' --emergency-fund 20000
- 支出按国标八大类、收入按子类智能归类
- 月度收支对账、分类占比、预算执行、财务健康、异常检测、A-D 评分
Step 3:生成复盘报告(finance_report.py)
python scripts/finance_report.py build.json --ir ir.json --outdir .
- HTML 驾驶舱(评分环 + KPI + 月度趋势 + 分类占比 + 预算 + 异常 + 建议)
- MD 复盘文(可直接发家人或自己存档)
- CSV 明细(utf-8-sig,Excel 直接打开不乱码)
复用资源
| 文件 | 用途 | 加载时机 |
|------|------|----------|
| references/data-contracts.md | IR 与 build 两层数据契约(字段含义、评分门禁) | Step 1/2 理解数据结构时加载 |
| references/categorization-rules.md | 国标八大类与收入子类规则、预算/健康口径、如何扩展 | Step 2 调整分类或预算时加载 |
| references/usage-examples.md | 3 个完整场景命令 + 最佳实践 + FAQ | 首次使用或用户问"怎么用"时加载 |
重要约束
- 数据不出本机:三脚本纯标准库离线运行,无任何网络请求(→ Trust)
- 不编造评分:评分由真实交易数据计算得出,不杜撰(→ Trust)
- 结果可复现:同输入双跑逐字节一致,便于核对(→ Reliability)
- 分类可解释可扩展:纯关键词规则,用户可自查与增补(→ Adaptability)
- 平台中立:不绑定特定银行/支付 App,任意导出文件均可(→ Adaptability)
- 价值可量化:产出评分/储蓄率/预算差额等可量化指标,复盘建议可执行(→ Effectiveness)
- description 单行:禁用 YAML 多行语法,打包工具兼容(→ Convention)
Scan to join WeChat group