36 篇博文 含有标签「Beancount」

在今天的博客文章中，我们将深入剖析一个专为企业设计的 Beancount 账本，帮助您理解这种纯文本复式记账系统的复杂细节。

我们先从代码开始：

1970-01-01 open Assets:Bank:Mercury
1970-01-01 open Assets:Crypto

1970-01-01 open Equity:Bank:Chase

1970-01-01 open Income:Stripe
1970-01-01 open Income:Crypto:ETH

1970-01-01 open Expenses:COGS
1970-01-01 open Expenses:COGS:Contabo
1970-01-01 open Expenses:COGS:AmazonWebServices

1970-01-01 open Expenses:BusinessExpenses
1970-01-01 open Expenses:BusinessExpenses:ChatGPT

2023-05-14 * "CONTABO.COM" "Mercury Checking ••1234"
  Expenses:COGS:Contabo                               17.49 USD
  Assets:Bank:Mercury                                -17.49 USD

2023-05-11 * "Amazon Web Services" "Mercury Checking ••1234"
  Expenses:COGS:AmazonWebServices                  14490.33 USD
  Assets:Bank:Mercury                             -14490.33 USD

2023-03-01 * "STRIPE" "Mercury Checking ••1234"
  Income:Stripe                                   -21230.75 USD
  Assets:Bank:Mercury                              21230.75 USD

2023-05-18 * "customer_182734" "0x5190E84918FD67706A9DFDb337d5744dF4EE5f3f"
  Assets:Crypto                                         -19 ETH {1,856.20 USD}
  Income:Crypto:ETH                                      19 ETH @@ 35267.8 USD

理解代码​

1. 开立账户：代码首先在 1970-01-01 开立了一系列账户。其中包括资产账户（Assets:Bank:Mercury 和 Assets:Crypto）、权益账户（Equity:Bank:Chase）、收入账户（Income:Stripe 和 Income:Crypto:ETH）以及费用账户（Expenses:COGS、Expenses:COGS:AmazonWebServices、Expenses:BusinessExpenses 和 Expenses:BusinessExpenses:ChatGPT）。

2. 交易记录：接着，代码记录了 2023-03-01 至 2023-05-18 期间的一系列交易。

   • 2023-05-14 的交易表示从 Mercury Checking ••1234 向 CONTABO.COM 支付了 17.49 美元。这笔交易被记录为一项费用（Expenses:COGS:Contabo），并相应地从 Assets:Bank:Mercury 账户中扣除。

   • 同样，2023-05-11 的交易表示从同一银行账户向 Amazon Web Services 支付了 14490.33 美元。这笔交易记录在 Expenses:COGS:AmazonWebServices 下。

   • 2023-03-01 的交易显示来自 STRIPE 的收入存入 Mercury Checking ••1234，总计 21230.75 美元。这笔交易被记录为收入（Income:Stripe），并增加到银行账户（Assets:Bank:Mercury）中。

   • 2023-05-18 的最后一笔交易代表一笔涉及客户 19 ETH 的加密货币交易。这笔交易记录在 Assets:Crypto 和 Income:Crypto:ETH 下。{1,856.20 USD} 显示了交易时 ETH 的价格，而 @@ 35267.8 USD 则指明了这笔 19 ETH 交易的总价值。

在所有交易中，都遵循了复式记账原则，确保 资产 = 负债 + 权益 的等式始终成立。

总结​

这个 Beancount 账本提供了一个直接而强大的财务交易追踪系统。正如最后一笔交易所示，Beancount 足够灵活，可以核算加密货币等非传统资产，这证明了它在我们日益数字化的金融环境中的实用性。

我们希望这次剖析能帮助您更好地理解 Beancount 的结构和功能，无论您是经验丰富的会计师还是尝试管理个人财务的初学者。敬请关注我们的下一篇博客文章，届时我们将深入探讨 Beancount 的高级操作。

我们很高兴地宣布，自2023年5月1日起，我们将重新推出面向新客户的免费计划。这一决定是在我们对平台进行重大改进并优化资源之后做出的，旨在更好地服务所有客户，无论是免费用户还是付费用户。

免费计划一直是我们愿景的重要组成部分，即为所有人提供可访问且用户友好的服务。我们相信，过去几个月所做的改进将使我们能够为用户提供更好的体验，同时保持对专业版计划客户的服务质量。

2023年5月1日之后注册的新客户将可以使用免费计划。

**您的支持和忠诚是本次免费计划得以重新推出的重要财务保障。**正是通过您的贡献，我们才得以投资于我们的基础设施和支持系统，确保我们能够继续提供您所期望的高质量服务，同时为新用户扩展我们平台的访问权限。您对我们愿景的承诺帮助我们成长和发展，我们衷心感谢您持续的合作。我们正在共同建设一个蓬勃发展的社区，并赋能各行各业的用户实现他们的目标。

如果您有任何疑问或疑虑，请随时与我们联系。我们随时乐意听取您的反馈并解决您可能遇到的任何问题。感谢您一直以来的支持，我们期待为您提供最优质的服务。

账户名称示例​

Assets:US:BofA:Checking

账户类型​

Assets          +
Liabilities     -
Income          -
Expenses        +
Equity          -

商品/货币​

CNY, EUR, CAD, AUD
GOOG, AAPL, RBF1005
HOME_MAYST, AIRMILES
HOURS

指令​

通用语法

YYYY-MM-DD <Directive> <Parameters...>

开立与关闭账户​

2001-05-29 open Expenses:Restaurant
2001-05-29 open Assets:Checking     USD,EUR  ; 货币限制

2015-04-23 close Assets:Checking

声明商品/货币 (可选)​

1998-07-22 commodity AAPL
  name: "苹果电脑公司"

价格​

2015-04-30 price AAPL   125.15 CNY
2015-05-30 price AAPL   130.28 CNY

备注​

2013-03-20 note Assets:Checking "致电询问回扣事宜"

文档​

2013-03-20 document Assets:Checking "path/to/statement.pdf"

交易​

2015-05-30 * "关于此交易的描述"
  Liabilities:CreditCard   -101.23 CNY
  Expenses:Restaurant       101.23 CNY

2015-05-30 ! "有线电视公司" "电话账单" #tag ˆlink
  id: "TW378743437"               ; 元数据
  Expenses:Home:Phone  87.45 CNY
  Assets:Checking                 ; 您可以省略其中一个金额

分录​

  ...    123.45 USD                             简单
  ...        10 GOOG {502.12 USD}               带单位成本
  ...        10 GOOG {{5021.20 USD}}            带总成本
  ...        10 GOOG {502.12 # 9.95 USD}        带两种成本
  ...   1000.00 USD   @ 1.10 CAD                带单位价格
  ...        10 GOOG {502.12 USD} @ 1.10 CAD    带成本与价格
  ...        10 GOOG {502.12 USD, 2014-05-12}   带日期
  ! ...   123.45 USD ...                        带标记

余额断言与填充​

; 仅断言指定货币的金额：
2015-06-01 balance Liabilities:CreditCard  -634.30 CNY

; 自动插入交易以满足以下断言：
2015-06-01pad Assets:Checking Equity:Opening-Balances

事件​

2015-06-01 event "location" "美国纽约"
2015-06-30 event "address" "梅街123号"

选项​

option "title" "我的个人账本"

其他​

pushtag #trip-to-peru
...
poptag  #trip-to-peru
; 注释以分号开头

探索 Beancount 纯文本记账的魔力

引言​

欢迎来到一个记账不再是艰巨任务的世界。今天，我们向您介绍 Beancount，一个强大、灵活且直观的纯文本记账工具。Beancount 通过提供透明、直接的资金管理方法，让您能够掌控自己的财务。

在这份全面的指南中，我们将深入探讨 Beancount 的基础知识，解释其核心概念，并引导您了解其简单而强大的功能。阅读完这篇博客，您将对 Beancount 有扎实的理解，并准备好开始使用它来整理和分析您的财务生活。

什么是 Beancount？​

Beancount 是由 Martin Blais 创建的一个开源纯文本记账系统。受 John Wiegley 的 Ledger 系统启发，Beancount 旨在提供一种强大可靠的方法，使用纯文本文件管理个人和小型企业的财务。通过 Beancount，您可以轻松追踪您的收入、支出、投资等等。

为什么选择 Beancount？​

纯文本记账相比传统的基于电子表格或软件的记账系统具有多项优势：

• 透明度：Beancount 文件是人类可读的，这使得理解和审计您的财务数据变得容易。
• 灵活性：Beancount 可以轻松定制以满足您的特定需求，您可以使用您喜欢的文本编辑器和版本控制系统来管理您的财务数据。
• 便携性：您的财务数据可以在任何设备上访问，并且易于在系统之间传输或与他人共享。
• 面向未来：纯文本文件具有通用兼容性，确保您的财务数据即使随着技术发展也能保持可访问性。

Beancount 的核心概念​

要有效使用 Beancount，理解其核心概念至关重要：

• 交易：财务事件，例如收入、支出或账户之间的转账，都记录为交易。
• 账户：交易涉及一个或多个账户，例如资产、负债、收入或支出。
• 复式记账：Beancount 强制执行复式记账，确保每笔交易都有平衡的借方和贷方。
• 指令：Beancount 使用一组指令来定义交易、账户开立和其他财务事件。

Beancount 入门​

要开始使用 Beancount，请遵循以下简单步骤：

• 安装 Beancount：根据您操作系统的安装说明，在您的系统上安装 Beancount。
• 创建您的 Beancount 文件：创建一个新的纯文本文件，扩展名为 .beancount（例如，my_finances.beancount）。
• 定义您的账户：使用 "open" 指令定义您将在交易中使用的账户。
• 记录交易：使用 "txn" 指令记录您的财务交易。

或者直接在 https://beancount.io 注册。以下是一些纯文本记账示例 -

示例 1：基本交易

2023-04-01 open Assets:Checking
2023-04-01 open Expenses:Groceries

2023-04-10 txn "Grocery Store" "Buying groceries"
  Assets:Checking         -50.00 USD
  Expenses:Groceries       50.00 USD

在此示例中，我们开立了两个账户：Assets:Checking（资产:活期账户）和 Expenses:Groceries（支出:食品杂货）。2023 年 4 月 10 日，我们记录了一笔价值 50 美元的购买食品杂货的交易。该交易使 Assets:Checking 的余额减少 50 美元（借方），并使 Expenses:Groceries 的余额增加 50 美元（贷方）。

示例 2：收入和支出交易

2023-04-01 open Assets:Checking
2023-04-01 open Income:Salary
2023-04-01 open Expenses:Rent

2023-04-05 txn "Employer" "Salary payment"
  Assets:Checking       2000.00 USD
  Income:Salary        -2000.00 USD

2023-04-06 txn "Landlord" "Monthly rent payment"
  Assets:Checking       -1000.00 USD
  Expenses:Rent          1000.00 USD

在此示例中，我们开立了三个账户：Assets:Checking（资产:活期账户）、Income:Salary（收入:工资）和 Expenses:Rent（支出:租金）。2023 年 4 月 5 日，我们记录了一笔 2000 美元的工资支付交易。该交易使 Assets:Checking 的余额增加 2000 美元（贷方），并使 Income:Salary 的余额减少 2000 美元（借方）。2023 年 4 月 6 日，我们记录了一笔 1000 美元的月租支付交易。该交易使 Assets:Checking 的余额减少 1000 美元（借方），并使 Expenses:Rent 的余额增加 1000 美元（贷方）。

示例 3：账户间转账

2023-04-01 open Assets:Checking
2023-04-01 open Assets:Savings

2023-04-15 txn "Bank" "Transfer from Checking to Savings"
  Assets:Checking       -500.00 USD
  Assets:Savings         500.00 USD

在此示例中，我们开立了两个账户：Assets:Checking（资产:活期账户）和 Assets:Savings（资产:储蓄账户）。2023 年 4 月 15 日，我们记录了一笔从活期账户向储蓄账户转账 500 美元的交易。该交易使 Assets:Checking 的余额减少 500 美元（借方），并使 Assets:Savings 的余额增加 500 美元（贷方）。

这些示例说明了 Beancount 复式记账系统的基本概念。通过正确记录交易，用户可以维护其财务活动的准确记录，并生成报告以深入了解其财务状况。

生成报告和分析数据​

Beancount 附带了一套强大的工具，用于生成财务报告，包括资产负债表、利润表等。您还可以使用 Fava（一个基于 Web 的 Beancount 用户界面）来可视化和交互您的财务数据。https://beancount.io 是基于 MIT 许可证的 Fava 构建的。

结论​

拥抱 Beancount 纯文本记账的强大和简洁。通过理解其核心概念并遵循本指南中概述的步骤，您将能够轻松精确地管理您的个人或小型企业财务。随着您对 Beancount 越来越熟悉，您可以探索高级功能和自定义设置，以根据您的独特需求调整系统。

无论您是想追踪支出、规划未来，还是深入了解您的财务习惯，Beancount 都提供了实现目标所需的灵活性和透明度。凭借其用户友好的方法，Beancount 有潜力彻底改变您管理财务的方式，并赋能您掌控自己的财务未来。

现在您已经对 Beancount 有了坚实的基础，是时候开始您的纯文本记账之旅了。告别繁琐的电子表格和复杂的软件，欢迎来到 Beancount 的世界。祝您记账愉快！

Beancount，这个深受开发者和财务爱好者喜爱的复式记账系统，以其简洁性而强大。但是，对于那些希望在 Beancount 的网页界面 Fava 中获得更多控制和更快导航的用户来说，自定义侧边栏链接和 SQL 查询可以将您的工作流提升到新的水平。

在本指南中，我们将向您展示如何：

• 在 Fava 的侧边栏添加快速访问链接
• 使用 SQL 查询进行高级筛选和分析
• 为月度审查或异常检测自定义您的工作流

为什么要自定义 Fava？​

Fava 已经是查看您的 Beancount 账本的精美界面，但随着您的日记账不断增长，对更好快捷方式和更智能查询的需求也随之增加。

这解决了以下痛点：​

• 重复导航时间范围
• 跨嵌套账户筛选交易
• 更快地发现负余额或异常

✨ 自定义侧边栏链接​

让我们从使用简单的侧边栏快捷方式改进您的日常工作流开始。这些链接会出现在 Fava 的左侧边栏，可以直接带您进入筛选视图，例如本月交易或上月收入。

将以下行添加到您的 Beancount 文件中：

2021-01-01 custom "fava-sidebar-link" "Current Month" "/jump?time=month"
2021-01-01 custom "fava-sidebar-link" "Last Month" "/jump?time=month-1"
2021-01-01 custom "fava-sidebar-link" "Clear All" "/jump?account=&time=&filter="

它们的作用：​

• 本月： 打开筛选到当前月份的交易视图。
• 上月： 立即跳转到上个月——非常适合月末审查。
• 清除所有： 重置筛选器，再次显示所有条目。

这些快捷方式消除了手动输入时间，让您的 Fava 体验更加流畅和个性化。

🔍 自定义 SQL 查询​

为了获得更深入的洞察，Fava 的 SQL 界面功能强大得令人难以置信。这是一个查询，用于查找符合特定模式的账户中的所有负余额——非常适合标记异常或有问题的交易。

SELECT account, units(sum(position)), sum(position)
WHERE number(units(position)) < 0
  AND account ~ '.*:BCM:.*'
  AND date >= DATE(2021,12,9)
  AND date < DATE(2022,1,9)

解析：​

• account ~ '.*:BCM:.*'：筛选名称中包含 :BCM: 的账户。
• number(units(position)) < 0：标记负余额（例如，预算超支）。
• 日期筛选器将结果范围缩小到特定的 1 个月窗口。

用例：​

• 发现重复支出或错误过账等错误
• 审计特定供应商或类别
• 快速提取可操作的预算洞察

🛠 专业提示：结合链接 + 查询​

虽然 Fava 不允许直接链接到自定义查询，但您可以通过以下方式养成每月审查的习惯：

• 使用“本月”链接开始您的审查
• 在另一个窗格中打开您保存的查询选项卡
• 同时审查两者——先筛选，然后深入挖掘

这种组合有助于您在异常恶化之前发现它们并确保您的账本保持整洁。

总结​

Beancount 的设计理念是极简，但像这些小小的增强功能却能带来巨大的效率提升。无论您是在审查预算、调试异常余额，还是仅仅为了节省点击次数，自定义链接和 SQL 查询都能为您提供更大的能力和更少的阻碍。

额外提示： 如果您正在使用 Fava 的自定义报告，您甚至可以构建完全符合您个人财务习惯的仪表板。

准备好掌控一切了吗？

从小处着手：添加“本月”链接。然后构建您自己的查询。未来的您会感谢您的。

想要更多此类技巧？订阅我们的新闻通讯或在 Beancount.io 探索更多 Beancount 秘籍。

Beancount 有一个插件可以预测未来的周期性交易。如何在 beancount.io 中应用它？将以下内容放入您的账本文件中。

; import the plugin
plugin "fava.plugins.forecast"

; add a monthly HOA fee
2022-05-30 # "HOA fee [MONTHLY]"
  Expenses:Hoa                                      1024.00 USD
  Assets:Checking                                  -1024.00 USD

然后，您将在净利润图表中看到预测结果。

上面的标签 [MONTHLY] 意味着它将永久循环。如果您有更多条件需要应用，请尝试 [MONTHLY UNTIL 2022-06-01]、[MONTHLY REPEAT 5 TIMES]、[YEARLY REPEAT 5 TIMES] 或 [WEEKLY SKIP 1 TIME REPEAT 5 TIMES]。

传统的 Beancount 用户通常使用命令行工具或在私有网络中自建服务器，他们必须通过电脑或移动设备上的通用文本编辑器进行操作。Beancount.io 通过提供开源的 Android 和 iOS 移动应用以及安全的云服务来减少这些麻烦，让您的账本现在只需轻点几下即可通过指纹访问。

Beancount 是一种计算机语言，可以在文本文件中实现复式记账。一旦您在文件中定义了财务交易，它就会生成各种报告。这种语言的设计者 Martin Blais 认为，命令行记账具有许多优点——它快速、便携、开放且可定制。

我们强烈认同这一观点，并分享 Beancount 语言所带来的赋能感。我们希望做得更多——将这项技术介绍给更多人。这意味着我们必须提高可用性，使其更容易被更广泛的用户群体所使用。

并非每个人都是命令行爱好者，这就是我们构建 Beancount.io 的原因——一个面向所有人的个人财务管理器。它的工作方式如下：

对于繁重的工作，Beancount 用户仍然可以使用他们的电脑，通过浏览器访问 https://beancount.io 或与 Dropbox 同步来编辑或查看账本。这既保留了命令行工具的灵活性，又没有失去云端解决方案的跨设备访问能力。

对于日常轻量级操作，例如即时添加条目，Beancount 用户可以使用移动应用连接到安全云。

负责此产品的后端工程师 Mike Thrift 说：

我过去每天都会设置提醒，让自己打开笔记本电脑并将记录输入到我的 Beancount 文件中。现在，有了 Beancount.io，我可以在需要时更轻松地修改我的账本，即使我在户外商店购物时也能做到。

Facebook 软件工程师 Zhi Li 告诉我们：

我已经将我所有的 Beancount 文件迁移到 Beancount.io，现在它非常适合我的日常使用。我购买了自动数据备份等专业版功能，但我认为你们还可以做更多事情来改进服务。

您现在可以在 https://beancount.io/sign-up/ 注册，或下载 iOS 或 Android 应用。我们简化了注册流程，尽可能少地收集您的信息来启动服务。然后您将获得一个预设的空账本，您可以立即添加条目。

常见问题​

Beancount.io 会将我的账本数据出售给任何第三方吗？​

• 不会。我们致力于确保您的数据安全和隐私，我们绝不会出售您的账本数据。

我的数据安全吗？​

• 是的。我们使用 AES256 保护您的电子邮件和账本，使用 BCrypt 保护您的密码，并使用 SSL 保护您的网络请求。

我的账本数据是端到端加密的吗？​

• 不是。由于技术限制，在生产服务器中索引账本文件时，我们仍然必须将您的数据解密到内存中。因此，我们限制我们任何团队成员的直接访问。不幸的是，由于成本高昂，我们无法在 Intel 的 SGX 或任何安全保险库中实现这一点。

这是一项未来几年我可以信赖的可靠服务吗？​

• 是的。我们最初于 2019 年 7 月 4 日推出了 Beancount.io，并且我们已经安全可靠地运营该服务两年多了。因此，我们没有理由不继续在未来提供服务。

我可以请求新功能并赞助项目吗？​

• 是的。请随时通过 https://t.me/beancount 联系我们以获取任何反馈，并通过在 https://beancount.io/pricing 成为专业版用户来支持我们。

自二月份以来，我们的许多客户一直在询问如何向一个账本添加多个文件。他们需要文件结构来归档或分类交易。因此，经过几个月的工作，我们很高兴地宣布此功能已免费发布。

以下是使用方法：

文件 > 创建新文件​

前往左侧导航栏中的文件编辑器选项卡。然后，点击“文件”下拉菜单并选择“创建新文件”。

命名新文件​

为您的文件指定一个有效的文件名并保存。所有文件名必须以“.bean”结尾。

包含文件​

这是一个关键步骤，您必须在 main.bean 中包含新创建的文件。

例如，如果您添加了 stock.bean，则在 main.bean 中指定 include "stock.bean"。

刷新并导航到文件​

刷新页面，您将看到文件出现在“文件”下拉菜单中。

重命名或删除文件​

导航到文件后，您可以在“编辑”下拉菜单中重命名或删除它。

遇到问题？​

请在 https://t.me/beancount 提问。

我们已将 MIT 许可的开源软件 Fava 升级至 1.19 版本。以下是自上次更新以来的变更内容：

• v1.19 (2021-05-18)
  • 从 conversion 和 interval 选项迁移至 default-page 选项
  • 添加选项 invert-income-liabilities-equity
  • 升级至 CodeMirror 6
  • 新增保加利亚语翻译
  • 其他小改进和错误修复
• v1.18 (2021-01-16)
  • 一些小改进和各种错误修复。

感到兴奋吗？立即体验：https://beancount.io/ledger/

有疑问？我们会在 https://t.me/beancount 等你 :)

摊销是将支付款项分摊到多个时间段的会计处理方式。在 Beancount.io 中，您可以使用 fava.plugins.amortize_over 插件来实现这一点。

如果没有摊销，如果您想为您的汽车投保 6 个月，费用为 600 美元。您必须将其记录为特定日期的一次性费用。

2017-06-01 open Assets:Bank:Checking
2017-06-01 open Assets:Prepaid-Expenses
2017-06-01 open Expenses:Insurance:Auto


2017-06-01 * "Pay car insurance"
    Assets:Bank:Checking       -600.00 USD
    Assets:Prepaid-Expenses

然而，通过摊销，您可以将费用分摊到六个月，只需在文件顶部添加 plugin "fava.plugins.amortize_over"，并在交易中使用 amortize_months: 6。

plugin "fava.plugins.amortize_over"

2020-06-01 open Assets:Bank:Checking
2020-06-01 open Assets:Prepaid-Expenses
2020-06-01 open Expenses:Insurance:Auto

2020-06-01 * "Amortize car insurance over six months"
    amortize_months: 6
    Assets:Prepaid-Expenses       -600.00 USD
    Expenses:Insurance:Auto

然后，在日记账中，您将看到该交易被拆分为 6 笔分录。

2020-11-01 * Amortize car insurance over six months (6/6) am
2020-10-01 * Amortize car insurance over six months (5/6) am
2020-09-01 * Amortize car insurance over six months (4/6) am
2020-08-01 * Amortize car insurance over six months (3/6) am
2020-07-01 * Amortize car insurance over six months (2/6) am
2020-06-01 * Amortize car insurance over six months (1/6) am