月末准备

快速开始

连接 QuickBooks 和至少一个支付处理商（PayPal、Square 或 Stripe）， 然后说"让我们结账吧"。Claude 引导您逐步完成清单上的每个步骤， 在每个关口暂停等待您的输入，然后再继续。

如果缺少连接器，Claude 会退而要求 CSV 导出——绝不会 默默跳过某个步骤。

工作流程

按顺序完成以下步骤。每个步骤都有完成状态；在当前步骤解决之前不要前进。

第1步 — 确定目标月份

询问用户要结账的月份。如果用户未指定，默认为上一个自然月。在拉取任何数据之前先确认。

第2步 — 拉取 QuickBooks P&L 和交易登记簿

获取：

立即标记：

显示数量（"14笔交易需要分类"）并列出给用户，让用户在继续前进行分类。除非用户明确说"暂时跳过"，否则不要带着未分类的项目继续。

关于字段映射和 API 说明，请参见 reference/quickbooks-reconcile.md。

第3步 — 拉取支付处理商结算

从已连接的 PayPal、Square 或 Stripe 获取同一自然月的结算报告。

将每笔结算存款与 QuickBooks 银行入账行进行匹配：

关于结算报告字段映射（PayPal、Square、Stripe），请参见 reference/paypal-settlements.md。

第4步 — 检测可疑重复交易

扫描交易登记簿查找可能的重复扣款或存款。当全部三个条件匹配时标记为可疑重复：

将标记的对显示给用户。由用户决定每对是否合法（例如，重复的每周订阅）或是需要作废的真正重复。

关于常见误报模式及区分方法，请参见 reference/gotchas.md。

第5步 — 收据检查（Desktop 连接器）

如果 Desktop 连接器可用，扫描目标月份的收据文件夹（询问用户路径；默认 ~/Documents/Receipts）。

对于 QuickBooks 中金额超过 $25 且未附单据的每笔费用交易：

列出缺失的收据。用户可以补充文件或标记为"无需收据"（例如，没有收据的定期自动付款）。

如果 Desktop 连接器不可用，请用户确认哪些费用有收据——不要默默跳过此步骤。

第6步 — 所有者签字关口

在继续之前呈现摘要：

未分类交易：          X 中的 X 已解决
结算差异：            X 已标记，X 已解决
可疑重复：            X 已标记，X 已清除
缺失收据：            X 待处理

询问："准备好撰写 P&L 摘要并导出结账包了吗？"

未经明确确认，不得进入第7-8步。

第7步 — 撰写 P&L 说明

撰写一份通俗易懂的月度摘要——所有者可以与配偶或会计师分享的那种，而非 CFO 备忘录。目标字数150–250字。

结构：

  1. 标题行 — 一句话："3月净利润为$X，较2月上涨/下降Y%。"
  2. 收入 — 驱动数字的因素；如果数据显示集中度，命名产品、服务或客户。
  3. 毛利润率 — 是保持、上升还是压缩，以及主要原因。
  4. 关键费用 — 任何环比波动超过10%或超出正常范围的项目；每项一句话。
  5. 底线 — 净利润 vs 上月；询问是否有目标进行比较。
  6. 关注清单 — 1–3项下月需要监控的事项。

避免专业术语；解释任何不直白的英语。

已完成的示例请参见 reference/examples/pl-narrative.md。

第8步 — 导出结账包

生成两个文件：

close-packet-[YYYY-MM].xlsx — 三个工作表：

close-packet-[YYYY-MM]-summary.pdf — 一页：

保存到桌面（或用户指定的路径）。确认文件位置。

列规格和 PDF 布局详情，请参见 reference/close-packet-format.md。

审批关口

优雅降级

缺失连接器 后备方案
QuickBooks 要求提供 QB 导出 CSV（P&L + 交易明细）
支付处理商 要求提供处理商网站的结算 CSV
Desktop（收据） 要求用户确认每笔标记费用的收据状态

参考文件