Family Asset Manager（家庭资产管理）

Overview

帮助家庭在一个 Excel 账本文件里完成「资产盘点 → 收支记账 → 持仓估值 → 理财诊断」的闭环。账本用 scripts/ledger.py 引擎读写与计算，金融资产可接入实时行情做市值刷新，最终输出带 P0/P1/P2 分级建议的资产报告。

账本为单个 .xlsx 文件，含 7 个 sheet：设置 / 概览 / 资产 / 负债 / 收支流水 / 持仓 / 配置目标。字段与分类约束见 references/asset_schema.md 与 references/categories.md；诊断阈值与方法论见 references/analysis_playbook.md。

When to use

用户说「帮我算算家庭净资产 / 家底」「盘点一下资产」
用户要「记一笔收支 / 统计这个月花了多少 / 按类别看支出」
用户要「看看股票基金现在值多少 / 用实时行情估个值」
用户要「我的资产配置合不合理 / 负债压力大不大 / 给我点理财建议」
用户已有或想新建一个家庭资产 Excel 账本

环境要求

scripts/ledger.py 依赖 openpyxl。运行时若报 ImportError: openpyxl，先安装： pip install openpyxl（优先用隔离的 managed python venv）。其余为纯标准库，无外部服务依赖。

Core Capabilities

1. 资产盘点与净值

首次使用先建账本，之后用户直接在 Excel 里手填「资产 / 负债 / 持仓 / 收支流水」各 sheet（按 references/asset_schema.md 的表头与「配置大类」填写）。多币种资产/负债填「原币种金额 + 币种」，引擎按「设置」页汇率折算 CNY。

新建账本：python scripts/init_ledger.py <路径.xlsx>
计算并刷新概览：python scripts/ledger.py summary <账本.xlsx> --write
只读查看：python scripts/ledger.py summary <账本.xlsx>

输出：总资产 / 总负债 / 净资产 / 资产负债率，以及各配置大类实际占比。

2. 日常收支记账

用户在「收支流水」sheet 手填（日期 / 类型 / 一级分类 / 二级分类 / 金额(CNY) / 账户）。分类口径见 references/categories.md，保持稳定以保证跨期可比。

本月统计：python scripts/ledger.py stats <账本.xlsx> --period month
本年统计：python scripts/ledger.py stats <账本.xlsx> --period year
自定义区间：python scripts/ledger.py stats <账本.xlsx> --period 2026-08 或 2026-07-01..2026-09-30

输出收入/支出按一级分类汇总及合计。

3. 持仓实时估值

「持仓」sheet 的「现价(CNY)」留空时，引擎用成本价兜底以保证净资产可算。

自动获取（推荐）：python scripts/ledger.py fetch <账本.xlsx> 读取持仓的「市场 + 代码」，通过腾讯行情接口（keyless、纯标准库）批量取实时价，按「设置」页汇率自动折算 CNY 后回写现价/市值/盈亏。支持 A股 / ETF / 港股 / 美股；基金(场外)/其他请手填净值或走 value。

手动更新（离线兜底）：把行情写成 JSON {代码: 现价CNY} 后： python scripts/ledger.py value <账本.xlsx> --quotes quotes.json

取数后跑 summary --write 看刷新后的净资产。

自动获取依赖网络；若环境无外网或接口限流，退回到 value 手动更新。港股/美股现价由脚本自动按「设置」页 HKD→CNY / USD→CNY 折算为 CNY。

4. 理财分析与建议

诊断：python scripts/ledger.py diagnose <账本.xlsx>
完整报告：python scripts/ledger.py report <账本.xlsx>（可选 --out report.md 落盘）

诊断覆盖四维度（阈值见 references/analysis_playbook.md）：偿债（资产负债率、房贷收入比）、流动性（应急月数）、配置偏离（实际 vs 目标占比）、集中度（单一持仓/净资产）。建议一律 P0/P1/P2 分级、结论先行、带具体数字与动作，不替代持牌投资顾问。

工作流建议

无账本 → init_ledger.py 建空白模板，引导用户填基础数据。
有账本 → 先 summary，再按用户意图选 stats / value+summary / diagnose / report。
出建议时引用 references/analysis_playbook.md 的阈值，用语保持「结论 + 数字 + 动作」。
周期复盘：每月跑一次 report --out 生成家庭资产月报，对比趋势。

Resources

scripts/ledger.py — 核心引擎（init/summary/stats/value/diagnose/report 子命令）
scripts/init_ledger.py — 建账本薄封装
references/asset_schema.md — 各 sheet 字段、币种折算、净资产公式
references/categories.md — 资产明细与收支标准分类
references/analysis_playbook.md — 诊断阈值与建议规范