核心用法
feishu-accounting 是一套分阶段落地的飞书记账系统：
第一阶段（Setup）：通过 feishu-accounting-setup 完成环境初始化——安装 CLI 工具、引导创建飞书自建应用、开通多维表格权限、创建「明细表+汇总表」双表结构，最终输出 5 个核心凭证（App ID、App Secret、Base Token、双表 ID）。
第二阶段（Usage）：日常使用 record_bill.py 脚本记账，支持：
- 命令行快速记账（
--amount/--type/--category/--note） - 图片智能识别（vision 模型自动解析账单）
- 账单查询与月度汇总（
--list、--summary） - 双向同步：支出写入明细表+汇总表，收入仅写汇总表
配套提供 Android 仪表盘 App，可视化展示收支图表与分类统计。
显著优点
- 零后端成本：完全依托飞书多维表格，无需自建服务器
- 双保险存储：本地
bills/目录 + 飞书云端同步，数据不怕丢 - 移动端可视化：原生 App 仪表盘，支持图表化消费分析
- 13 级精细分类：餐饮、购物、交通、娱乐、通讯、生活、医疗、住房、教育、服饰、数码、运动、宠物
- 图片记账：一句话或一张图即可完成记账，交互门槛低
潜在局限
- 配置门槛高：需手动完成飞书开放平台应用创建、权限申请、表结构搭建，全程约 15-20 分钟
- 飞书生态依赖：核心数据存储于飞书，迁移成本较高
- Token 管理风险：Base Token 等凭证泄露可能导致数据被篡改
- 功能边界：无多人协作权限控制、无预算预警、无自动银行流水对接
适合人群
- 飞书重度用户，希望账单与办公平台一体化
- 技术爱好者，能接受 CLI 与手动配置流程
- 个人或小家庭，需要轻量级、可视化记账工具
- 对数据主权敏感，希望本地+云端双备份的用户
常规风险
| 风险点 | 说明 |
|--------|------|
| 凭证泄露 | FEISHU_BASE_TOKEN 等环境变量若暴露，他人可读写你的账本 |
| 表结构变更 | 手动修改飞书字段顺序或类型，可能导致 `record_bill.py` 写入数据错位 |
| 飞书 API 限制 | 分页、频次限制可能影响大批量数据同步 |
| 旧数据兼容 | 修改文本字段格式需同步更新 App 解析逻辑，否则仪表盘显示异常 |