Back to Details

finances-report

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

finances-report

财务报告生成工具

Generate financial analytics from the local ledger.
从本地账本生成财务分析数据。

Terminal Report (default)

终端报告（默认模式）

bash
cd ~/Documents/finances && uv run python scripts/report.py
Sections: Net Worth (with 30d/90d/1y deltas), Asset Allocation, Liabilities (APR + monthly interest), Cash Flow (last 30 days + top categories), Bitcoin detail + sparkline.
Single section:
bash
uv run python scripts/report.py --section networth
uv run python scripts/report.py --section liabilities
uv run python scripts/report.py --section cashflow
bash
cd ~/Documents/finances && uv run python scripts/report.py
报告包含板块：净资产（含30天/90天/1年变化值）、资产配置、负债（含APR及月利息）、过去30天现金流（含热门消费类别）、Bitcoin详情及迷你走势图。
单独查看某个板块：
bash
uv run python scripts/report.py --section networth
uv run python scripts/report.py --section liabilities
uv run python scripts/report.py --section cashflow

HTML Dashboard

HTML仪表盘

bash
cd ~/Documents/finances && uv run python scripts/report.py --html
Opens 
reports/dashboard-YYYY-MM-DD.html
— interactive plotly charts:
  • Net worth over time (USD + BTC dual axis)
  • Asset allocation over time (stacked area)
  • Monthly cash flow (income vs spending bars)
  • Liability balances over time
  • BTC price history
bash
cd ~/Documents/finances && uv run python scripts/report.py --html
生成并打开
reports/dashboard-YYYY-MM-DD.html
文件，包含以下交互式Plotly图表：
  • 净资产随时间变化趋势（USD + BTC双轴）
  • 资产配置随时间变化（堆叠面积图）
  • 月度现金流（收入vs支出柱状图）
  • 负债余额随时间变化
  • BTC价格历史走势

Data Sources

数据源

  • data/snapshots.jsonl
    — net worth history (175+ entries back to 2022)
  • data/transactions/copilot.jsonl
    — 10K+ transactions for cash flow analysis
  • data/prices/*.jsonl
    — BTC/gold/silver price history
  • data/liabilities.jsonl
    — liability history with APRs
  • data/snapshots.jsonl
    — 净资产历史数据（2022年至今，175+条记录）
  • data/transactions/copilot.jsonl
    — 10000+条交易记录，用于现金流分析
  • data/prices/*.jsonl
    — BTC/黄金/白银价格历史数据
  • data/liabilities.jsonl
    — 含APR的负债历史数据