income-ledger · 副业收益总账本

多平台副业者的本地收益记账工具：闲鱼 / 头条 / 汽水音乐 / 公众号 / 小红书 / 抖音 等平台的收入支出统一记账，月底一键出汇总与图表。

特性

• 本地 SQLite：数据全在你自己电脑，不联网、不上传
• 记一笔 / CSV 批量导入：从平台后台导流水整理成 CSV 一次导入
• 月结统计：按平台 / 按类别汇总 + 净利润 + 环比上月
• 单文件 HTML 图表：平台占比环形图 + 月度趋势折线图，双击即开、可发微信

快速使用

# 1. 建账（只需一次）
python scripts/ledger_init.py -d data/ledger.db

# 2. 记一笔
python scripts/ledger_record.py -d data/ledger.db -t 2026-09-01 -p 闲鱼 -c 卖货 -a 50 -n "卖出小米手环9"

# 3. 批量导入 CSV（日期,平台,类别,金额,备注）
python scripts/ledger_record.py -d data/ledger.db -f records.csv

# 4. 月结
python scripts/ledger_summary.py -d data/ledger.db -m 2026-09

# 5. 图表
python scripts/ledger_chart.py -d data/ledger.db -m 2026-09 -o 收益报表.html

目录

income-ledger/
├── SKILL.md                 # 技能说明
├── README.md
├── scripts/
│   ├── ledger_init.py       # 初始化账本
│   ├── ledger_record.py     # 记账（单笔/批量/查询/删除）
│   ├── ledger_summary.py    # 月度总结
│   └── ledger_chart.py      # 收益图表（HTML）
├── references/
│   └── categories.md        # 平台/类别规范
└── examples/
    └── 完整示例流程.md

环境要求

Python 3.8+（仅标准库，无需安装任何第三方包）。