核心用法
feishu-accounting 是一套基于飞书多维表格的完整个人记账解决方案，采用「配置向导 + 日常记账」两阶段设计。首次使用时，AI 通过交互式向导引导用户完成飞书自建应用创建、权限开通、多维表格搭建及凭证获取，全程自动化 CLI 工具链（feishu-cli）执行底层操作，无需用户手动配置。日常记账阶段，用户可通过自然语言（"花了35元午饭"）、图片识别或结构化命令快速记录，系统自动将支出数据写入「明细表+汇总表」双表，收入仅写入汇总表，确保仪表盘图表数据完整。
显著优点
1. 零代码配置：10 步自动化向导覆盖从应用创建到表结构搭建的全流程，大幅降低飞书开放平台的使用门槛
2. 双表智能同步：支出自动分流至明细表（13 类消费维度）与汇总表，收入直达汇总表，既满足精细追踪又保障统计效率
3. 多端协同：本地 JSON 存储 + 飞书云端同步 + Android 仪表盘 App，形成完整数据闭环
4. 扩展分类体系：13 个支出细分类目（餐饮/购物/交通/娱乐/通讯/生活/医疗/住房/教育/服饰/数码/运动/宠物），覆盖主流消费场景
5. 图片记账：内置 Vision 模型解析账单图片，自动提取金额并分类
潜在局限
- 平台绑定深度：强依赖飞书生态，迁移成本较高；若飞书 API 策略调整需同步更新
- 权限管理复杂：需开通 8 项独立权限并发布线上版本，新手易遗漏「确认发布」步骤导致授权失败
- Android 独占：配套仪表盘 App 仅提供 APK 发布版，iOS 用户需自行构建或依赖飞书原生表格查看
- 同步规则不对称：收入不写明细表的设计虽优化了查询性能，但牺牲了收入明细的追溯能力
- CLI 工具链依赖：feishu-cli 为第三方开源工具，长期维护稳定性需关注上游更新
适合人群
- 已使用飞书作为协作工具的个人用户
- 希望实现「随手记 + 可视化分析」的轻度记账需求者
- 具备基础 CLI/环境变量操作能力的技术爱好者
- 需要多终端数据同步（手机 + PC + 飞书）的跨场景用户
常规风险
| 风险类型 | 具体表现 | 缓解建议 |
|---------|---------|---------|
| **凭证泄露** | App Secret / Base Token 以明文形式存储在本地 `.env` 文件 | 启用文件权限限制（chmod 600），避免提交至版本控制 |
| **数据一致性** | 飞书 API 限流或网络异常导致本地与云端数据不同步 | 定期执行 `--list` 核对，异常时启用 `--no-feishu` 纯本地模式 |
| **权限失效** | 飞书应用未发布或权限回收导致 API 401/403 | 向导中强制强调「申请发版」步骤，提供故障排查回退流程 |
| **分类误判** | AI 关键词匹配或图片识别错误分类 | 支持 `--category` 强制指定，查询阶段可人工修正飞书表格 |
| **第三方依赖** | feishu-cli 版本迭代或飞书 API 变更导致命令失效 | 锁定 CLI 版本（v1.25.0），关注 Release Notes 及时升级 |