- name
- family-finances
- description
- 家庭财务管理系统——资产负债表、现金流量表、投资组合追踪与财务健康报告。当用户提到：管理家庭资产/负债、查看净资产、资产负债表、现金流表、投资组合、财务健康评分、家庭财务报表、月度收支报告时触发。
家庭财务管理系统
管理家庭资产负债表、现金流量表、投资组合，生成中文财务健康报告。
数据存储
- 路径：
~/.openclaw/workspace/data/family-finances/ - 文件：
- balance_sheet.json — 资产负债表 - cashflow.json — 现金流量表（月度） - portfolio.json — 投资组合
- 脚本：
scripts/finances.py
核心功能
1. 资产负债表
| 操作 | 方法 |
|---|---|
| 查看当前报表 | python scripts/finances.py balance |
| 计算净资产 | python scripts/finances.py net-worth |
| 添加/更新资产 | update_asset(name, amount, category, note) |
| 添加/更新负债 | update_liability(name, amount, category, note) |
| 删除科目 | delete_asset(name) / delete_liability(name) |
资产/负债分类：
- 资产：现金存款、股票、基金、债券、保险、房产、车辆、数字资产、应收账款、其他
- 负债：房贷、消费贷、车贷、信用卡负债、亲友借款、其他
添加示例：
python scripts/finances.py add-asset "招商银行存款" 150000 "现金存款" ""
python scripts/finances.py add-asset "自住房产" 5000000 "房产" "北京朝阳"
python scripts/finances.py add-liability "房贷余额" 2800000 "房贷" "公积金贷款"2. 现金流量表
| 操作 | 方法 |
|---|---|
| 查看月度报表 | python scripts/finances.py cashflow YYYY-MM |
| 收入/支出记录 | add_cashflow_item(year_month, "income"/"expense", category, amount, description) |
收入分类：工资收入、奖金、兼职、投资收益、租金、其他收入 支出分类：餐饮、日用、交通、医疗、教育、住房、娱乐、购物、旅游、保险、税费、其他支出
添加示例：
python scripts/finances.py add-cashflow 2026-04 income "工资" 35000 "月薪"
python scripts/finances.py add-cashflow 2026-04 expense "餐饮" 3000 "在家做饭"
python scripts/finances.py add-cashflow 2026-04 expense "房贷" 12000 "公积金贷款"3. 投资组合
| 操作 | 方法 |
|---|---|
| 查看组合汇总 | python scripts/finances.py portfolio |
| 添加/更新持仓 | update_holding(name, amount, category, note) |
| 删除持仓 | delete_holding(name) |
分类：股票、基金、债券、保险、房产、车辆、现金存款、数字资产、其他
4. 综合报告
生成带财务健康评分的完整报告：
python scripts/finances.py report YYYY-MM财务健康评分（满分100）：
- 储蓄率（满分25）：年储蓄率 ≥40% 满分
- 净资产（满分25）：净资产 ≥100万满分
- 资产结构（满分25）：负债率越低分越高
- 投资比率（满分25）：投资资产占比 ≥50%满分
| 评分 | 等级 |
|---|---|
| ≥90 | 优秀 |
| 70-89 | 良好 |
| 50-69 | 一般 |
| <50 | 需改善 |
对话式工作流
当用户请求时，通过对话收集数据，调用脚本读写 JSON：
初始化/录入数据：
- 用户说"录入我的资产"→询问具体科目，逐条添加到资产负债表
- 用户说"录入本月收支"→逐笔记录收入和支出
查询报表：
- 用户说"我的净资产是多少"→运行 net-worth 命令并解读
- 用户说"本月花了多少钱"→运行 cashflow 命令并解读
- 用户说"生成财务报告"→运行 report 命令，生成完整中文报告
格式规则：
- 所有金额单位：人民币（元）
- 报告使用中文，数字加千分位分隔符
- 定期（每月初）提醒用户更新资产快照
首次使用引导
首次触发时，引导用户建立基础数据：
- 先录入主要资产（存款、房产、车辆等）
- 录入负债（房贷、车贷等）
- 录入投资组合（股票、基金、保险等）
- 建议每月固定日期更新一次快照