ask-ai-bookkeeping

name	ask-ai-bookkeeping
description	用自然语言查询个人账本。当用户问“这个月花了多少”“7 月餐饮多少”“大阪旅行一共花了多少”“还有多少报销没到账”“哪一类花得最多”“查一下某笔流水”或要求按时间、分类、商户、账户、账本筛选时触发。只读取账本并说明统计范围和口径。

Ask AI Bookkeeping

从已确认流水回答账务问题，并把时间范围、筛选条件和统计口径一起交代清楚。

何时触发

• “7 月餐饮花了多少？”
• “大阪旅行一共花了多少，日元和人民币都列出来”
• “还有哪些报销没到账？”
• “本月收入、支出和结余是多少？”
• “支付宝最近 10 笔是什么？”
• “房租加水电占本月收入多少？”

共用入口

高频查询直接运行：

python3 "$AI_BOOKKEEPING_HOME/scripts/bookkeeping.py" \
  --config "/absolute/path/to/config.json" \
  ask "用户问题"

需要固定“本月”的基准时间时传入 --now。

查询流程

1. 识别时间范围。用户没说时间且结果会明显受范围影响时，先追问；“本月”使用配置时区。
2. 识别筛选项：交易类型、分类、商户、付款账户、项目账本、币种、报销状态。
3. 调用 ask。返回结果中必须保留：
   • scope：时间和时区。
   • filters：真正使用的筛选条件。
   • total 与本位币。
   • 原币合计，适用于旅行和外币查询。
   • 命中的流水和笔数。
   • basis：退款、转账、报销的处理口径。
4. 对复合问题，可用 list --month YYYY-MM 读取同一范围的明细后聚合。计算时使用 personal_amount、cash_in、cash_out 和 transaction_type，不要从自然语言金额重新计算。
5. 回答先给一句结论，再给 2 至 5 条组成或异常。金额统一保留两位小数。

常用口径

• “花了多少”：个人消费合计，支出减退款，扣除可报销与他人应付部分。
• “收入多少”：真实收入，排除退款、报销到账、借入和账户转账。
• “现金还剩多少变化”：现金流入减现金流出，转账会在两个账户之间移动。
• “旅行花了多少”：按项目账本筛选，给本位币合计，并按原币分别列示。
• “待报销”：原垫付可报销金额减已确认到账金额。
• “余额”：只在账户期初余额和全部账户流水都完整时回答；条件不够要直说。

边界与防错

• 默认排除待确认和已撤销流水。
• 用户问“为什么”时列出组成明细或分类汇总，不只给一个总数。
• 时间或对象有歧义时只问一个最关键问题。
• 查询结果为空时说明真实筛选条件，不推测用户没记过账。
• 外币缺汇率时列入数据质量问题，不临时猜汇率。
• 报销、退款和转账严格沿用统一口径，避免把现金回流算成收入。
• 这是个人财务记录与分析工具，不给收益承诺、税务结论或投资指令。

回答示例

2026 年 7 月餐饮个人净支出 200.00 元，共 2 笔：消费 300.00 元，退款 100.00 元。
范围：2026-07-01 至 2026-08-01；已排除待确认和已撤销流水。