核心用法
autonomous-bookkeeper 是一款面向中小企业的预记账自动化编排技能，通过协调四个上游工具（Gmail、DeepRead OCR、Stripe API、Xero）实现"发票进、凭证出"的端到端自动化。典型工作流程分为五阶段：
阶段一：收件箱检测 — 使用 Gmail 查询带附件的邮件，通过关键词（invoice、rechnung、receipt 等）和发件人规则筛选候选发票邮件。
阶段二：附件提取 — 将 PDF/图片发送至 DeepRead OCR 进行异步结构化提取，获取供应商、发票日期、金额、税项等关键字段。系统设置质量门控，若关键字段存在 hil_flag（高不确定性标记），自动转入人工复核队列。
阶段三：付款验证 — 调用 Stripe API 核对对应支付事件，匹配条件包括金额（可配置容差）、币种、日期窗口（默认 ±3 天）及成功状态。多候选匹配时标记为"模糊匹配"待审。
阶段四：会计写入 — 在 Xero 中创建供应商联系人、应付账单（ACCPAY），并按预设规则分类（如 AWS→Hosting）。仅当支付验证置信度达标时才标记为"已付/已对账"，同时保留发票编号、邮件 ID、支付引用等审计线索。
阶段五：可追溯更新 — 为已处理邮件添加标签，存储处理日志（提取置信度、匹配证据、Xero ID），并使用幂等键防止重复记账。
---
显著优点
- 全流程自动化：覆盖从邮件检测、OCR 识别、支付对账到记账凭证生成的完整链路，减少 80% 以上的手动录入工作量。
- 多源数据编排：创新性地将 Gmail（数据源）、OCR（认知提取）、Stripe（支付验证）、Xero（会计系统）整合为统一工作流，无需企业更换既有系统。
- 质量门控机制：设置 OCR 置信度、字段完整性、支付匹配度、重复检查等多重关卡，确保高风险记录进入人工复核而非自动过账。
- 审计友好设计：完整保留邮件 ID、附件引用、OCR 结果、匹配证据、Xero 记录 ID 等全链路追踪信息。
- 灵活策略配置：支持自定义币种、关键词、供应商分类规则、日期/金额容差、自动过账策略等，适应不同企业内控要求。
潜在缺点与局限性
- 上游依赖复杂：需同时维护 Maton API Key（Gmail/Stripe/Xero 网关）和 DeepRead API Key 两套凭证，任一服务中断将导致流程断裂。
- 异步处理复杂性：DeepRead OCR 采用异步队列（queued→completed/failed），需自行实现 webhook 或轮询机制，增加编排难度。
- 附件上传限制：Xero 技能的附件上传流程未在文档中完整披露，实际行为取决于集成端点支持情况，可能仅能存储链接而非二进制附件。
- 支付匹配非原生：Stripe 与 Xero 的自动对账逻辑由本技能编排实现，非两系统原生的"自动核销"功能，复杂场景（如部分付款、退款）可能匹配失败。
- QuickBooks 不支持：当前仅支持 Xero，未覆盖北美广泛使用的 QuickBooks 生态。
- 人工复核瓶颈：配置保守策略时，大量记录进入人工队列，可能抵消自动化收益。
适合人群
- 使用 Xero 作为会计系统、Stripe 处理收付款的中小企业财务团队
- 每月处理 50-500 张发票、希望减少手工录入的 SaaS 或电商企业
- 具备基础 API 运维能力、能接受异步流程复杂性的技术型财务人员
常规风险
| 风险类型 | 说明 | 缓解建议 |
|---------|------|---------|
| **凭证错误风险** | OCR 误识别导致金额/日期错误自动过账 | 启用 `manual-review` 策略，高金额强制复核 |
| **重复记账风险** | 邮件重复处理或流程重试产生 duplicate entry | 严格执行幂等键检查，人工抽查对账 |
| **支付误判风险** | Stripe 匹配逻辑错误将未付款发票标记为已付 | 设置严格容差（exact match），模糊匹配强制人工介入 |
| **数据泄露风险** | 财务凭证、邮件内容经第三方 API（Maton/DeepRead）传输 | 确认上游服务商 SOC 2/ISO 27001 认证，审计日志留存 |
| **服务中断风险** | Gmail/OCR/Stripe/Xero 任一 API 变更或限流 | 监控各阶段健康状态，失败记录进入重试队列而非丢弃 |
> 重要声明：本技能为"预记账编排逻辑"，非财务控制替代方案。企业仍需保留最终审核责任，定期人工对账。