核心功能
飞书多维表格记账系统是一套面向个人用户的完整记账解决方案，采用「本地存储 + 云端同步」双轨架构。系统分为两个阶段运行：Setup 阶段引导用户完成飞书自建应用创建、多维表格搭建、权限配置及凭证获取；Usage 阶段提供日常记账入口，支持语音/文字输入、账单图片识别、多维度查询及月度统计。
记账流程：用户输入消费或收入信息 → AI 自动解析金额、分类、备注 → 调用 record_bill.py 写入本地 bills/ 目录 → 同步至飞书多维表格。支出记录同时写入「明细表」（13 类消费分类）和「汇总表」；收入仅写入「汇总表」，明细表专注支出可视化以支撑 App 仪表盘展示。
技术实现：依赖开源 feishu-cli（v1.26.0）与飞书开放平台 API，需开通多维表格读写、字段 CRUD、记录 CRUD 等权限。凭证通过 .env 文件或环境变量注入，支持 Python 3.9+ 运行环境。配套提供 Android 仪表盘应用，可下载预编译 APK 或从源码构建。
显著优点
1. 数据主权可控：本地 JSON 备份 + 飞书云端双保险，避免单一平台锁死
2. 分类体系完整：13 类支出细分（餐饮/购物/交通/娱乐/通讯/生活/医疗/住房/教育/服饰/数码/运动/宠物/其它），满足精细化记账需求
3. 多端协同：飞书网页端表格编辑 + 手机 App 图表看板，兼顾录入效率与可视化体验
4. 自动化程度高：图片识别记账、月度聚合统计、智能分类匹配，减少人工操作
5. 开源可扩展：GitHub 托管，支持自定义字段、修改同步逻辑、二次开发仪表盘
潜在局限
- 配置门槛较高：需手动创建飞书应用、开通 10+ 项权限、发布线上版本，全流程约 15-20 分钟
- 网络依赖：飞书同步需国内网络环境，Token 有效期需关注
- 权限风险：
base:record:create/delete等权限若泄露可能导致数据篡改 - 移动端限制：仪表盘仅提供 Android 版本，iOS 用户需使用飞书小程序或网页版
适合人群
- 习惯用飞书办公、希望账单与办公工具整合的职场人士
- 对数据隐私敏感、需要本地备份的记账爱好者
- 愿意投入初期配置时间、追求长期自动化收益的用户
- 有 Python 基础、需要自定义记账逻辑的技术用户
常规风险
| 风险类型 | 说明 | 缓解措施 |
|---------|------|---------|
| 凭证泄露 | App ID / App Secret 硬编码或明文存储 | 使用 `.env` 文件，加入 `.gitignore`，定期轮换凭证 |
| 权限过度申请 | 开通大量读写权限，攻击面扩大 | 按最小权限原则申请，定期检查飞书后台权限清单 |
| API 限流 | 高频记账可能触发飞书 API 频次限制 | 本地队列缓冲，异常时降级为纯本地存储 |
| 数据格式不兼容 | 修改字段结构后新旧记录解析失败 | 版本化管理 `record_bill.py`，升级前备份数据 |
| 第三方 CLI 依赖 | `feishu-cli` 停止维护或引入恶意代码 | 锁定版本 v1.26.0，审计源码后使用，准备替代方案 |