Plaid 集成：将你的银行同步到 Beancount
为你介绍 Beancount.io 的 Plaid 集成功能
手动录入交易不仅繁琐，更是通往财务清晰化道路上的阻碍。
多年来，保持准确的财务记录意味着必须在两个糟糕的选项中做出选择：要么花几个小时手动录入银行流水中的交易，要么彻底放弃追踪。即使是 CSV 导入也需要下载文件、修正格式并处理重复项。
今天，我们正在消除这种摩擦。
这就是 Plaid 集成——连接你的银行账户与 Beancount 账本的加密桥梁，由 AI 驱动以智能建议分类。
你的银行数据，现已互联。
Plaid 集成不仅仅是另一个导入工具。它是与超过 12,000 家金融机构的直接、安全连接——使用与 Venmo、Robinhood 和 Coinbase 相同的受信技术。
无论是你的支票账户、信用卡还是投资账户，你现在都可以在几秒钟内将其连接到 Beancount 。你的银行凭据绝不会被存储——身份验证直接通过 Plaid 的银行级安全系统进行。
- 银行账户： 支票、储蓄、货币市场账户。
- 信用卡： 所有主流发行商。
- 投资： 经纪账户、退休账户。
工作原理
我们设计的 Plaid 集成既安全又透明。没有神奇的黑箱，一切都在你的完全控制之下。
1. 连接。
在你的 Beancount 控制面板中，点击“连接银行账户”。搜索你的金融机构，通过 Plaid 的安全界面登录，并授予只读权限。你的凭据永远不会接触我们的服务器。
2. 映射账户。
告知 Beancount 哪些 Beancount 账户对应你的银行账户。例如：
- 美国银行支票账户 →
Assets:BofA:Checking - 大通信用卡 →
Liabilities:Chase:CreditCard
这种一次性设置仅需几分钟，并能帮助 AI 理解你的财务结构。
3. 同步交易。
在任何已连接的机构上点击“同步交易” 。几秒钟内，所有新交易将从你的银行获取并安全存储。我们的定时任务也会每天在后台同步交易。
4. 使用 AI 核对。
这是你的 AI 助手 大显身手的地方。对于每笔交易，AI 会分析商户名称、金额和你的历史模式，以建议正确的类别。
- 去超市采购？ AI 建议
Expenses:Food:Groceries。 - 在加油站？ AI 建议
Expenses:Transportation:Gas。
AI 会学习你特定的会计科目表，并随着你的每一次更正变得更加智能。
5. 批准并导入。
核对 AI 建议。编辑任何需要调整的内容。满意后，点击“提交至账本”，所有交易都将添加到你的 Beancount 文件中。无需手动输入，没有格式烦恼，更不会出错。
你的财务记录现在已更新至最新状态，分类妥当，并可供分析。
为什么这会改变游戏规则
速度是竞争优势 过去需要数小时的工作现在只需几分钟。我们的一位 Beta 用户在不到 5 分钟的时间内同步了一个月的交易（150 多个分录）。你可以将这些时间花在分析财务上， 而不是输入数据。
学习你模式的 AI
传统的导入器只是解析 CSV 列。Plaid 集成将交易数据与 AI 智能相结合。它能理解 "STARBUCKS #2942" 代表咖啡，而无需你编写正则表达式规则。它还会学习你的特定偏好——如果你将星巴克归类为 Expenses:Coffee 而不是 Expenses:Dining，AI 会记住这一点。
完全的编辑控制权 AI 提供建议，由你做出决定。每笔交易在提交到账本之前都会经过你的审核。你对自己的财务记录保持完全控制。
银行级安全 你的凭据从未被存储或共享。身份验证通过 Plaid 的加密系统直接与你的银行进行——这是数百万用户通过 Venmo、Robinhood 和 Coinbase 所信任的同款技术。
你的数据始终属于你 与闭源会计应用不同，你的交易数据保留在由你控制的纯文本 Beancount 文件中。没有供应商锁定，没有私有格式。随时导出或删除你的数据。
Plaid 集成适用于谁？
- 自由职业者： 停止手动为每一笔客户付款和业务支出分类。连接你的业务账户，让 AI 处理繁重的工作。
- 迁移者： 正在从 Mint、YNAB 或其他会计应用迁移？连接你的银行，在几分钟内导入数月的交易，而不是数天。
- 高级用户： 将来自支票、信用卡和投资的数据汇总到单一的事实来源中，告别 CSV 导出带来的疲劳。
技术架构
在底层，Plaid 集成使用 Plaid API 进行安全的银行连接，并使用 AI 分类服务 智能建议交易类别。它不依赖于脆弱的 CSV 解析（当银行更新其导出格式时会失效），而是直接从源头——你的银行——读取数据。
交易存储在带有加密访问令牌的 PostgreSQL 中。同步服务通过计划任务 (node-cron) 每天运行，你也可以随时从控制面板手动触发同步。
开始使用
Plaid 集成现已面向所有 Beancount 用户上线。
- 登录你的控制面板。
- 打开你的账本并从侧边栏导航至 Plaid。
- 点击连接银行账户。
- 将你的账户映射到 Beancount 账本账户。
- 同步交易并查看 AI 建议。
- 提交到账本。
体验在完全掌控下的自动化记账自由。
常见问题
问：支持哪些银行？ 答：通过 Plaid 支持超过 12,000 家金融机构，包括所有美国主要银行（Chase、Bank of America、Wells Fargo）、信用卡、投资账户（Vanguard、Fidelity、Robinhood）、信用社以及数字银行（Chime、SoFi）。请查看 plaid.com/institutions 以获取完整列表。
问：我的财务数据安全吗？ 答：绝对安全。你的银行凭据永远不会被存储。身份验证直接通过 Plaid 的银行级加密系统进行。我们仅存储加密的访问令牌，并且只有只读权限——我们无法转账或修改你的账户。你可以随时从 Plaid 设置页面或 my.plaid.com 断开连接。
问：AI 会自动对交易进行分类吗？ 答：不会。AI 会根据商户名称、金额和你的历史模式建议分类。在交易提交到你的账本之前，由你审核并批准每一条建议。你保持完全的控制权——AI 只是让分类过程变得更快。
问：AI 的准确性如何？ 答：非常准确。AI 从强大的基准准确率开始，并随着学习你特定的分类偏好而提高到 95% 以上。只需在审核期间纠正任何错误，AI 就会记住以供下次使用。
问：交易多久同步一次？ 答：你可以随时点击任何已连接机构上的“同步交易”手动进行同步。此外，我们的定时任务每天都会在后台自动同步所有已连接的账户。交易会排队等待，直到你准备好审核并导入它们。
问：我可以导入历史交易吗？ 答：可以！首次连接账户时，Plaid 会获取近期的历史交易（通常长达 90 天，有时根据机构的不同会更长）。系统会通过交易 ID 和元数据匹配自动防止重复。
问：如果我的银行连接失败了怎么办？ 答：如果你的连接需要续期（常见于修改密码或安全更新后），你会看到一个状态指示器。只需点击“重新连 接”并通过 Plaid 再次登录即可——耗时不到 2 分钟。系统会保留你的账户映射和设置。
Beancount.io 是为你财务打造的现代化操作系统。Plaid 集成只是我们致力于为纯文本会计（Plain-text Accounting）带来安全、智能自动化的开始。
