Awesome Beancount

Beancount 生态系统的精选指南。Beancount 是一款功能强大的开源会计系统，它使用简单的文本格式，通过严谨的双录入复式记账法来管理你的财务。本页面将社区精选列表和生态系统概览整合为一个全面的资源。

为什么要进行纯文本会计？​

纯文本会计 (PTA) 是一种使用简单的文本文件和强大的命令行工具来管理财务的方法。这种方法让你拥有数据的完整所有权，确保数据的持久性，并为自动化和分析提供了无与伦比的灵活性。

• 官方 PTA 枢纽： Plain Text Accounting
• 入门简介： Accounting for the simple minds with plain text accounting
• 从 Web 应用到命令行： Command line accounting: From mint.com to Ledger

Beancount 生态系统​

Beancount 生态系统是围绕核心引擎构建的工具、插件和资源的集合。每个组件在创建完整的财务管理工作流中都发挥着特定作用。

1. 核心引擎与官方资源​

这些是 Beancount 的基础要素，由创建者和官方贡献者维护。

2. 用户界面​

这些工具提供了用于探索和编辑财务数据的可视化界面。

3. 交易导入​

导入是指将来自金融机构的数据（如银行 CSV 或 PDF）转换为 Beancount 条目的过程。

社区导入器（按国家/地区）​

由社区维护的针对特定银行和服务的庞大脚本集合。

• 中国
  • Alipay / 支付宝：deb-sig/double-entry-generator, wzyboy/importer
  • 招商银行 (CMB)：借记卡，信用卡
  • WeChat Pay / 微信支付：deb-sig/double-entry-generator
• 法国
  • Caisse d'Epargne: beancount-ce
  • Boursorama, Amex: Beancount-myTools
• 德国
  • Commerzbank: beancount-commerzbank
  • Deutsche Kredit Bank (DKB): beancount-dkb
  • ING: beancount-ing
  • N26: beancount-n26
  • Volksbank & GLS-Bank: beancount-importer-volksbank
• 印度
  • SBI, BOI, Paytm, HSBC, ICICI: beancount-importers-india
• 荷兰
  • ABN AMRO: beancount-abnamro
• 瑞士
  • 常规：tariochbctools (BCGE, Neon, Raiffeisen, ZKB, Fidelity)
  • Finpension: drnuke-bean
  • PostFinance: tariochbctools, drnuke-bean
• 英国
  • Monzo, Revolut, Wise: Evernight/beancount-importers
  • Revolut, Wise: tariochbctools
• 美国
  • Amex, Chase, Citi, Schwab: mterwill/gist
  • Capital One: mtlynch/beancount-capitalone
  • Chase: mtlynch/beancount-chase-bank, ArthurFDLR/beancount-chase
  • Clipper: beancount-clipper
  • Mercury: mtlynch/beancount-mercury
• 区块链
  • tariochbctools

4. 编辑器支持与工具​

将 Beancount 集成到你的开发环境中，以简化编辑和维护工作的工具。

• IDE 支持： 提供语法高亮、自动补全和实时余额检查的插件。
  • VSCode
  • Emacs
  • Vim
  • Zed
  • Sublime Text
  • Atom
  • Beancount Language Server（适用于任何兼容 LSP 的编辑器）
• 自动化与实用工具：
  • bean-add：从命令行交互式地添加交易。
  • beancount-black：一个规范的 Beancount 文件代码格式化工具。
  • beancount-categorizer：使用正则表达式规则自动对交易进行分类。
  • beanahead：管理并预测未来的交易。
• 数据迁移工具： 将数据从其他会计系统转换的实用工具。
  • 来自 GnuCash：henriquebastos/gc-to-bc, dtrai2/gc-to-bc
  • 来自 Ledger/hledger：travisdahlke/gist, zacchiro/ledger2beancount
  • 来自 YNAB：hoostus/beancount-ynab

5. 插件（账本扩展）​

在处理过程中运行的账本内 Python 模块，用于执行自定义规则、自动化交易或添加新功能。

• 预算管理：
  • fava-envelope：一个用于信封式预算的 Fava 扩展。
• 自动化与检查：
  • autobean.share：费用拆分与债务管理。
  • autobean.sorted：确保交易按时间顺序排序。
  • beancount-checkclosed：自动检查已关闭账户的余额是否为零。
• 数据操作：
  • autobean.narration：自动生成交易摘要。
  • beancount-lazy-plugins.filter_map：对过滤后的交易组执行操作。

6. 价格源​

获取商品、股票和货币的历史及当前价格，用于跟踪投资价值的脚本。

• beancount-exchangerates: 通过 frankfurter.dev 等 API 获取法定货币汇率。
• pricehist: 一个多源价格获取工具。
• beancount-cryptoassets: 用于获取加密货币价格。
• tariochbctools: 包含盈透证券 (Interactive Brokers) 的价格源。

学习与社区​

书籍与深度指南​

• 使用 Python 追踪个人财务 (Tracking Personal Finances using Python): 一本提供使用 Beancount 构建个人财务系统全面指南的书籍。 (网站)
• 中文博客系列 (BYVoid): 第一部分：为什么？, 第二部分：借与贷

精选博客文章​

• 英文
  • 使用 Beancount 数豆子——以及更多
  • 使用 Python 管理个人财务
  • 干货版 Beancount 介绍
• 法文
  • Beancount 或属于黑客的会计学
• 中文
  • Beancount —— 命令行复式簿记

社区​

• 邮件列表: Google Groups (主要讨论论坛)
• 实时聊天 (IRC): web.libera.chat 上的 #beancount 频道
• Telegram (中文): t.me/beancount_zh

商业服务与应用​

为希望在不自行管理基础设施的情况下使用 Beancount 强大功能的用户提供。