核心用法
fiscal 是一个基于 Actual Budget 的 CLI 工具，AI 通过它充当用户的个人会计师。用户无需学习预算软件或信封预算法，只需用自然语言描述财务状况，AI 自动翻译为 CLI 命令执行。核心流程包括：初始化预算 → 创建账户 → 设置分类 → 导入交易 → 自动化分类规则 → 周期性状态报告。
关键功能
- 多格式导入：支持 CSV、QIF、OFX、QFX、CAMT 银行文件
- 智能分类：基于规则自动归类，提供 triage 建议加速人工审核
- 信封预算：只预算实际持有的钱，超支自动从下期扣除，结余自动滚存
- 零配置门槛：AI 隐藏所有 UUID、原始分值（cents）和 CLI 输出，以自然语言呈现
显著优点
1. 认知卸载彻底：用户无需理解 "envelope budgeting"、"carryover" 或 "To Budget" 等概念，AI 完成所有术语翻译
2. 自动化闭环：从银行文件导入到规则生成形成自增强系统，越用越省事
3. 灵活部署：支持纯本地模式（仅 dataDir）或同步模式（连接 Actual Budget 服务器）
4. 主动财务洞察：AI 被设计为定期主动报告超支风险、未分类交易和预算缺口
潜在局限与风险
- 依赖 Node.js 20+ 环境：需预装运行时和构建步骤，非技术用户需 AI 全程代操作
- ID 中心架构：所有写操作依赖 UUID，AI 必须通过 list → act 模式代理，增加交互轮次
- 无内置银行直连：依赖用户手动导出文件，实时性受限
- AI 决策边界模糊：部分操作建议（如预算调整金额）需用户确认，但文档未明确强制确认机制
适合人群
- 希望使用 Actual Budget 但不愿学习软件操作的个人用户
- 有定期银行导出习惯、寻求自动化分类与预算追踪的财务管理者
- 需要 AI 主动监控和多维度对比（如月度趋势）的"被动型"预算用户
常规风险
| 风险类型 | 说明 |
|---------|------|
| 数据完整性 | 导入预览（--dry-run）机制存在，但用户可能跳过直接执行 |
| 超支滚存误读 | 信封预算的自动扣减逻辑可能与用户直觉不符，需 AI 充分解释 |
| 规则过度泛化 | 自动生成的分类规则可能错误归类相似描述的交易 |
| 凭证管理 | serverURL/password 支持多层级配置，AI 需明确告知用户存储位置 |
| 金额精度 | 内部以 cents 存储，AI 必须严格 /100 转换，存在显示错误风险 |