用途:把 Bill.com 的新发票与 Plaid 银行入账匹配后,同步到 Google Sheets 的 2026 美国营收表,用于确认入账与查看未入账清单。触发词包括“美国营收”“US revenue”“确认入账”“sync revenue”“未入账”。
主要能力:Bill.com 登录(重试 2 次)后新增发票行;Plaid 查询 Chase/韩美入账,按 Stripe/YouTube/内容分类并匹配到表;用 already_matched 集合防止重复匹配;检测到新入账时向 Slack 频道发送通知;Bill.com 与 Plaid 独立执行,一方失败不影响另一方。
使用方式:核心脚本为 scripts/daily/sync_us_revenue.py,用 uv run 执行,先跑 --dry-run 查看新增发票数、入账匹配数、未入账列表,经用户确认后再去掉 --dry-run 实际写入。支持 --year 指定年份(默认今年)。环境变量从项目根目录 .env 自动加载,包括 BILL_COM_、PLAID_、SLACK_BOT_TOKEN。自动执行由 launchd plist 配置,每小时一次,日志写入 scripts/daily/sync_us_revenue.log。
适用场景:需要定期核对美国营收发票与银行入账、生成未入账清单并通知团队的本地工作流。
限制与注意:scripts/daily/ 被 .gitignore 排除,仅本地使用;不加 --dry-run 会直接修改 Google Sheets;同金额多笔匹配依赖顺序,可能误匹配,需手动核对;macOS 休眠后可能连续 DNS 失败导致无通知;Bill.com 凭据过期或 Plaid 令牌失效需按资料中的排查方式处理。资料未提供安装步骤、收费与平台支持范围。