跳到主要内容

36 篇博文 含有标签「Beancount」

查看所有标签

簿记与会计：有何区别，Beancount 如何融入其中？

· 阅读需 5 分钟
Mike Thrift
Mike Thrift
Marketing Manager

无论您是经营企业还是管理个人财务，簿记和会计这两个术语常常混淆不清。但了解它们之间的区别——尤其是在使用 Beancount 这样的纯文本工具时——可以帮助您建立更好的系统并做出更明智的财务决策。

在本指南中，我们将探讨簿记和会计各自的角色，以及 Beancount 如何同时支持这两种功能（是的，确实如此）。

2025-06-27-accouting-vs-bookkeeping

📘 簿记：日常记录的艺术​

簿记是财务管理的基础层。它关乎记录实际发生的事情——没有假设，没有预测。

簿记包括：

  • 记录收入和支出
  • 跟踪资产和负债
  • 为交易添加标签以便后续使用
  • 维护总账

在 Beancount 中，它看起来像：

2025-06-27 * "Stripe Payout"
  Assets:Bank:Checking     1,200.00 USD
  Income:Sales

每笔交易都是一个构建块。您尚未进行分析——您只是逐行记录事实。

如果您刚开始使用，Beancount 通过其明确的结构和可读的语法鼓励良好的簿记习惯。您将被（以一种好的方式！）强制跟踪每一分钱并解释每一笔交易。

📊 会计：将数据转化为洞察​

会计在您的簿记记录基础上，回答更深层次的问题：

  • 我们盈利吗？
  • 我们还有多少现金储备？
  • 我们应该预付该软件费用还是按月摊销？
  • 我们如何最大限度地减少税收？

在会计中，您：

  • 核对账户并调整分录
  • 生成利润/亏损表等报告
  • 折旧资产
  • 规划税收和未来支出

借助 Beancount，您可以使用 beancount.io 等工具分析您的记录：

  • 浏览资产负债表、损益表和现金流量图
  • 按类别可视化收入
  • 使用元数据（例如，tag:business-trip）注释决策

想跟踪年度 Zoom 订阅吗？

2025-01-15 * "Zoom Annual Plan"
  Expenses:Software     149.90 USD
  Assets:Bank:Checking
  tag:business-tools

您以后可以按月摊销或在预算会议期间进行分析。

👩‍💼 簿记员与会计师：各司其职？​

  • 簿记员：注重精确。记录、分类和整理。
  • 会计师：增加解读。提供建议、规划和模拟结果。

Beancount 使您能够身兼二职，或者将其中一层清晰地移交给专业人士。

例如：

  • 作为创始人，您可以使用 Beancount 自己进行簿记。
  • 在报税季，您可以导出报告或原始数据，供您的会计师最终处理。

🛠️ 簿记和会计软件：Beancount 归属何处？​

大多数主流工具（例如 QuickBooks、Xero）模糊了簿记和会计之间的界限。Beancount 采取了不同的方法：

  • 您通过纯文本管理一切，如果愿意，可以存储在版本控制中。
  • 没有隐藏交易或幕后操作。
  • 鼓励您理解自己的账目。

Beancount 非常适合那些重视透明度、数据完整性以及通过开源工具实现自动化的人。

🧠 为什么这种区别很重要​

了解簿记和会计之间的区别有助于您：

  • 保持合规并随时准备审计
  • 了解时间投入的方向（日常跟踪与每月洞察）
  • 与财务专业人士清晰沟通
  • 在不陷入复杂性的情况下扩展您的财务系统

🪄 最终思考：您的账本，您的规则​

无论您是独立创作者还是小型企业主，Beancount 都能让您精确管理账目——并最终像首席财务官一样做出战略决策。

请记住：

  • 簿记 = 发生了什么
  • 会计 = 它意味着什么

借助 Beancount，您正在清晰而自信地构建这两个层面。

如果您需要可打印版本或后续教程，请告诉我。

Beancount 会计分录：操作指南、定义与示例

· 阅读需 6 分钟
Mike Thrift
Mike Thrift
Marketing Manager

您的企业进行的每一笔财务交易都需要被记录——在纯文本记账的世界里，这始于会计分录。如果您正在使用 Beancount，理解会计分录是建立准确、可审计和清晰的财务记录的关键。

本指南将带您了解：

2025-06-27-journal-entries

  • 什么是会计分录
  • 为什么会计分录很重要
  • 如何使用 Beancount 语法编写它们
  • 如何有效使用它们
  • 真实世界交易的示例（客户付款、采购、贷款等）

🧾 Beancount 中的会计分录是什么？​

在 Beancount 中，会计分录是以人类可读的纯文本格式编写的带日期交易。每个分录都遵循复式记账原则——您记录资金的来源（贷方）和去向（借方），确保您的账簿始终保持平衡。

示例：

2024-06-01 * "Client payment for invoice #123"
  Assets:Bank:Checking     600.00 USD
  Income:Sales
  • * 表示已清算交易。
  • 描述显示了分录的上下文。
  • Assets:Bank:Checking 被借记。
  • Income:Sales 被贷记（金额隐含）。

每个分录都存在于 .beancount 文件中——这只是一个您可以进行版本控制、备份，甚至在 Vim 或 VSCode 中编辑的文本文件。

📒 为什么会计分录很重要​

会计分录是您账本的原子单位。

它们：

  • 录入到您的总账和账户余额中
  • 驱动所有报告：利润表、资产负债表、现金流量表
  • 让您逐行追溯每一笔资金的来源

使用正确的工具，您将看到这些交易在用户界面中呈现——分类、可搜索和可筛选。但这一切都始于简单的纯文本分录。

📚 复式记账在 Beancount 中如何运作​

Beancount 强制执行复式记账。每笔交易都必须平衡：借方总额 = 贷方总额。

快速规则：

  • 借记资产和费用（您获得现金或产生费用）
  • 贷记收入和负债（您赚取资金或承担债务）

示例 – 办公用品采购：

2024-06-02 * "Bought printer ink"
  Expenses:OfficeSupplies   100.00 USD
  Assets:Bank:Checking

🧠 可视化分录​

保存后，在 https://beancount.io/ledger/0/income_statement/ 的左侧导航栏中，您将看到...

  • 日记账视图：查看带有搜索、标签和筛选功能的交易
  • 账户筛选下拉菜单：查看运行余额和每个账户的分录
  • 利润表：您的 Income:* 和 Expenses:* 账户的总和
  • 资产负债表：您的资产减去负债

Fava 帮助将您的原始 Beancount 分录转化为可操作的报告——无需任何数据库设置。

💡 常见会计分录示例​

✅ 您收到客户付款​

2024-06-05 * "Payment for invoice #456"
  Assets:Bank:Checking     1,200.00 USD
  Income:Consulting

可选：如果您使用应收账款：

2024-05-20 * "Invoice #456 sent"
  Assets:AccountsReceivable   1,200.00 USD
  Income:Consulting

2024-06-05 * "Payment for invoice #456"
  Assets:Bank:Checking        1,200.00 USD
  Assets:AccountsReceivable  -1,200.00 USD

🖨️ 您购买办公用品​

2024-06-07 * "Staples run"
  Expenses:OfficeSupplies     85.00 USD
  Assets:Bank:Checking

🏦 您支付贷款​

假设您支付了 1,000 美元，其中 200 美元是利息，800 美元是本金：

2024-06-10 * "Loan repayment"
  Liabilities:Loan           -800.00 USD
  Expenses:LoanInterest       200.00 USD
  Assets:Bank:Checking      -1,000.00 USD

🔒 年末结账分录​

为了“结账”，您通常会将所有 Income（收入）和 Expenses（费用）账户转入 Equity（所有者权益）。

2024-12-31 close Income:*
2024-12-31 close Expenses:*

或者，手动操作：

2024-12-31 * "Close books"
  Equity:RetainedEarnings     45,000.00 USD
  Income:Consulting          -45,000.00 USD

🛠️ 调整分录​

如果您正在进行权责发生制会计，您会希望添加调整分录——用于预付费用、应计收入等。

示例：每月 100 美元的软件订阅费，按年支付

2024-01-01 * "Annual software payment"
  Assets:Prepaid             1,200.00 USD
  Assets:Bank:Checking      -1,200.00 USD

2024-01-31 * "Monthly amortization"
  Expenses:Software           100.00 USD
  Assets:Prepaid             -100.00 USD

使用脚本或现有的 Beancount 工具进行自动化。

🧰 Beancount：轻量、可审计、强大​

Beancount 不仅仅是一个会计工具——它是一种理念：透明、纯文本的财务真相。 它是一个现代化的账本系统，具有以下特点：

  • 易于版本控制（Git！）
  • 完全可移植（无专有数据库）
  • 非常适合开发者、自由职业者和小型企业

准备好开始了吗？​

使用以下内容开始您的 Beancount 文件：

option "title" "My Business Ledger"
option "operating_currency" "USD"

2024-01-01 open Assets:Bank:Checking USD
2024-01-01 open Income:Sales USD
2024-01-01 open Expenses:OfficeSupplies USD
2024-01-01 open Equity:OpeningBalances USD

2024-01-01 * "Initial balance"
  Assets:Bank:Checking     10,000.00 USD
  Equity:OpeningBalances

然后使用您偏好的可视化工具加载文件，见证奇迹。

想要更轻松地开始？尝试模板、导入器或像 bean-extract 这样的社区工具。

有了 Beancount，您的账本最终将属于您自己——简单、可脚本化、且经得起审计。

如果您需要可下载的 PDF 版本或针对小型企业的示例变体，请告诉我。

Beancount 助力小型企业主

· 阅读需 6 分钟
Mike Thrift
Mike Thrift
Marketing Manager

您真正能理解并掌握的记账基础知识​

管理自己的账目不一定意味着电子表格、压力或昂贵的软件。Beancount 为您提供了一种极简、可审计且强大的记账方式，只需使用纯文本和复式记账系统即可。

2025-06-25-beancount-for-small-businesses

本指南是您使用 Beancount 整理小型企业账目的完整入门，其中包含真实示例和分步指导。

🧾 什么是 Beancount？​

Beancount 是一个开源的纯文本会计系统，围绕着复式记账构建。您将交易写入 .beancount 文件，并使用 bean-doctor、bean-report 或 Fava 等工具来分析和可视化您的账目。

这是一个基本交易示例：

2025-06-01 * "Client Payment: Invoice #123"
  Assets:Bank:Business:Checking      1,200.00 USD
  Income:Consulting                 -1,200.00 USD

它可读、可脚本化、可版本控制——非常适合追求透明度和控制权的业务所有者。

📌 为什么记账很重要（以及为什么选择 Beancount）​

  • 您报税需要它
  • 您需要它来获得清晰度
  • 您需要它来获得资金
  • 您需要它来及早发现错误

而使用 Beancount，您只需一个文本编辑器和一些工具即可完成所有这些工作。

🪜 使用 Beancount 开始自己记账的 8 个步骤​

1. 分离企业与个人财务​

开设一个单独的企业支票账户和信用卡。在 Beancount 中反映出来：

2025-06-01 open Assets:Bank:Business:Checking USD
2025-06-01 open Liabilities:CreditCard:Business USD

这能让您的账目保持清晰，并在法律上保护您（特别是如果您是有限责任公司或公司）。

2. 使用复式记账​

每个财务事件都会影响两个账户。Beancount 通过设计强制实现这种平衡：

2025-06-05 * "Web hosting payment"
  Expenses:Hosting                  15.00 USD
  Assets:Bank:Business:Checking    -15.00 USD

这保证了您账本的数学完整性。

3. 选择现金制或权责发生制​

  • 现金制： 仅在收到/支付现金时记录收入/支出。
  • 权责发生制： 跟踪应付/应收账款等义务。

现金制示例：

2025-06-10 * "Client payment received"
  Assets:Bank:Business:Checking     800.00 USD
  Income:Sales                     -800.00 USD

权责发生制示例（发票已开，然后收到付款）：

2025-06-01 * "Invoice #2001 issued"
  Assets:AccountsReceivable         800.00 USD
  Income:Sales                     -800.00 USD

2025-06-15 * "Payment received for Invoice #2001"
  Assets:Bank:Business:Checking     800.00 USD
  Assets:AccountsReceivable        -800.00 USD

4. 设置您的会计科目表​

清晰定义您的类别。一个极简示例：

2025-01-01 open Income:Sales USD
2025-01-01 open Expenses:Software USD
2025-01-01 open Expenses:Meals USD
2025-01-01 open Equity:Owner USD

根据您的业务定制这些科目。保持一致性和描述性。

5. 分类交易（带元数据）​

使用元数据来跟踪上下文。这有助于抵扣、审计和清晰度。

2025-06-18 * "Team lunch after Q2 milestone"
  Expenses:Meals                    90.00 USD
  Assets:Bank:Business:Checking    -90.00 USD
  ; business_purpose: Q2 celebration
  ; attendees: Alice, Bob, Tian

添加标签或收据链接：

  ; receipt: ./receipts/2025-06-18-lunch.jpg

6. 存储支持文件​

使用 Dropbox、Google Drive 或 receipts/ 文件夹。然后像这样在 Beancount 中链接它们：

2025-06-02 * "Domain Renewal - GoDaddy"
  Expenses:Hosting                  20.00 USD
  Assets:Bank:Business:Checking    -20.00 USD
  ; receipt: ./receipts/domain-godaddy.pdf

审计师和税务专业人士会喜欢您这样做。

7. 为抵扣做准备​

清晰标记可抵扣费用：

2025-06-03 * "Adobe Creative Cloud Subscription"
  Expenses:Software                60.00 USD
  Assets:Bank:Business:Checking   -60.00 USD
  ; deductible: true
  ; usage: 100% business

使用自定义元数据或标签（如 #deductible）来跟踪潜在的冲销。

8. 养成习惯​

创建工作流程。例如：

# Weekly bookkeeping routine
git pull origin main
bean-extract transactions.csv >> ledger.beancount
bean-doctor ledger.beancount
bean-check ledger.beancount
fava ledger.beancount

或者只需承诺一个“Beancount 星期五”，每周对账所有内容。

💼 自己动手还是寻求帮助？​

您可以使用 Beancount 自己完成所有工作。但即使是高级用户也应该：

  • 在设置期间咨询注册会计师 (CPA)
  • 如果需要，在报税时聘请会计师
  • 使用 Fava 生成月度报告

您将获得会计系统的所有强大功能，而无需供应商锁定或订阅费用。

🛠️ Beancount 用户推荐工具​

  • Fava – Beancount 文件的精美网页仪表板
  • bean-doctor – 对您的账本进行健康检查
  • bean-query – 运行类似 SQL 的报告
  • beancount-import / beanie – 自动银行导入
  • 版本控制 – 使用 Git 跟踪账本更改

✅ 最终示例：完整交易流程​

2025-06-20 * "Consulting payment from Acme Inc."
  Assets:Bank:Business:Checking        3,000.00 USD
  Income:Consulting                  -3,000.00 USD
  ; invoice: 2025-06-acme
  ; project: "Backend API redesign"

2025-06-21 * "Notion Pro Plan"
  Expenses:Software                     10.00 USD
  Assets:Bank:Business:Checking        -10.00 USD
  ; purpose: project documentation
  ; receipt: ./receipts/notion-june.pdf

🎯 总结​

Beancount 非常适合希望以下的小型企业主：

  • 保持低成本
  • 完全掌控自己的财务
  • 避免传统软件的臃肿
  • 拥抱透明度和纯文本的简洁性

您想要一个可下载的 .bean 业务入门模板吗？请告诉我您的业务类型，我将为您量身定制一个。

绿色账本：使用 Beancount 追踪 ESG

· 阅读需 11 分钟
Mike Thrift
Mike Thrift
Marketing Manager

在当今世界，环境、社会和公司治理 (ESG) 指标不再仅仅是流行语；它们是衡量公司健康状况和未来生存能力的重要指标。但如何将这些关键的可持续发展洞察与传统的财务会计整合起来呢？答案是 Beancount，一个开源的、纯文本复式记账系统，它提供了一个出人意料的强大且灵活的解决方案来弥合这一差距。

想象一下，将您零散的可持续发展报告转化为一个流线型、自动化的系统，该系统可以追踪从碳排放到供应商多样性的一切，所有这些都在您现有的财务工作流程中进行。Beancount 通过将 ESG 数据视为与财务交易“一等公民”来使这成为可能。

2025-06-22-esg-tracking

建模ESG数据：Beancount之道​

Beancount固有的灵活性是其在ESG方面的强大优势。您无需使用孤立的电子表格，而是可以通过以下几种关键技术，将可持续发展指标直接嵌入到您的财务结构中：

  • 专用账户和商品： 将您的环境足迹视为另一种货币。您可以创建诸如 Metrics:Emissions:CO2e 的账户来追踪碳排放。这些排放甚至可以被视为一种商品（例如，二氧化碳当量单位，tCO2e），允许您在交易中记录具体数量。例如，一次航班购买除了记录货币成本外，还可以贷记 Emissions:CO2e 账户 +0.3 tCO2e。
  • 自定义元数据标签： Beancount的键值元数据非常适合添加上下文信息。您可以使用 CO2e: 0.3 t 或 Scope: 3 等标签标记交易，以表示其碳影响或温室气体议定书（GHG Protocol）范围。这将财务支出与其环境后果直接关联起来，提供更丰富、更全面的图景。
  • 结构化分类标签： 遵循**温室气体议定书（GHGP）**等标准至关重要。您可以使用一致的标签或账户命名约定，例如 Metrics:Emissions:Scope1、Metrics:Emissions:Scope2 和 Metrics:Emissions:Scope3，以便轻松分类和报告直接排放、能源相关排放和价值链排放。

这种适应性强的方法意味着，随着ESG标准的演变，您可以调整您的账本结构，而无需进行彻底的改造。

Beancount 与专业 ESG 工具：战略选择​

尽管 Persefoni 或 SAP Green Ledger 等专用 ESG 平台提供高度自动化、量身定制的解决方案，但 Beancount 仍是一个引人注目的替代方案，尤其适合那些追求透明度和控制权的用户。

特性Beancount（纯文本）专业 SaaS（例如：Persefoni, Plan A）企业 ERP 集成（例如：SAP Green Ledger）
数据建模用户自定义账户和元数据；灵活但需要手动构建。预定义模式；活动输入引导和自动排放转换。排放量直接映射到 ERP 交易和主数据。
排放因子用户提供或通过自定义脚本集成；需要手动更新。内置、定期更新的排放因子库；自动计算。与企业数据和标准因子集成，确保审计级别的准确性。
数据集成通过自定义 Python 脚本/API 实现开放架构；需要开发以实现自动化导入。许多预构建连接器可连接外部数据源（公用事业、ERP、差旅系统）。与 ERP 内部的核心业务流程和数据流进行原生集成。
报告与审计自定义查询和 Fava 报告；高度可定制但需要用户设计。版本控制（Git）提供透明的审计追踪。丰富的仪表板，符合标准（GHG、TCFD、CDP）的预构建报告。平台内审计日志和期间锁定。ERP 内部集成报告；专为“合理保证”可审计数据而设计。
成本与可访问性免费开源；需要 Beancount/脚本知识。商业 SaaS，有订阅费用；技术开销较少。企业级软件，可能涉及高昂的许可和实施成本；需要特定的 ERP 专业知识。

Beancount 是一个 DIY 强手： 它为您提供无与伦比的灵活性和透明度，非常适合个人或技术娴熟的小型组织。您完全拥有自己的数据，避免供应商锁定。

专业工具提供一站式解决方案： 它们擅长自动化数据收集、内置排放因子数据库和现成的合规报告，通常成本更高且灵活性较低。

混合方法也同样可行：使用 Beancount 进行详细的内部追踪和核对，然后将汇总数据导出到外部平台，用于高层利益相关者报告。

实际应用：Beancount 在 ESG 实践中的作用​

Beancount 的多功能性使其适用于以下几个关键的 ESG 用例：

  • 追踪范围 3 排放： 范围 3 排放（来自您的价值链）是最具挑战性的追踪对象，但可以通过将供应商排放数据与采购交易关联起来进行整合。Beancount 为这些复杂数据提供清晰的审计追踪，从而实现更好的分析并精确定位数据源。
  • 可持续性审计与鉴证： 像财务数据一样，ESG 数据需要可验证。Beancount 允许您将每条 ESG 条目关联到原始凭证（例如，水电费账单、第三方验证声明），从而提供细致的审计追踪，以实现透明度和鉴证。
  • 欧盟 CSRD/ESRS 合规报告： 对于面临 CSRD 等严格监管的公司，Beancount 可以作为量化披露的中央存储库。虽然它不会自动将报告格式化为 XBRL，但它提供了生成符合合规要求数据所需的粒度化、可审计数据。
  • 碳足迹分析与管理会计： 将碳视为管理会计的另一个维度。通过将排放量分配到利润中心或产品代码，您可以计算诸如“每美元收入的排放量”等指标，并识别碳热点，从而推动更明智的可持续发展决策。

您的 Beancount ESG 账本最佳实践​

为了最大限度地发挥 Beancount 在 ESG 方面的作用，请考虑以下最佳实践：

  1. 为 ESG 设计清晰的会计科目表： 像管理您的财务账户一样，深思熟虑地构建您的 ESG 账户（例如，Metrics:Emissions:Scope1:Fuel）。
  2. 一致地使用元数据： 利用标签（例如，Scope: 3，FactorSource: EPA2024）以确保上下文的一致性并便于查询。
  3. 平衡粒度与可管理性： 关注重要指标，避免账本被不必要的细节淹没。
  4. 谨慎自动化： 使用 Python 脚本进行数据导入和验证，但要确保强大的错误检查和清晰的自动化流程文档。
  5. 利用版本控制： 使用 Git 跟踪账本的每一次更改，提供 ESG 数据的透明且可审计的历史记录。
  6. 连接文档和证据： 将源文件（例如，水电费账单的 PDF 文件）链接到账本条目，以便在审计期间轻松验证。
  7. 利用 Fava 获取洞察： 配置 Fava 以显示自定义的 ESG 图表和报告，使您的可持续发展数据具有可操作性，并对非技术利益相关者可访问。
  8. 及时了解标准： ESG 报告是动态的；随着新法规和框架的出现，请准备好调整您的 Beancount 结构。

绿色未来，纯文本​

尽管 Beancount 目前缺乏原生的 ESG 智能或即插即用报告功能，但其开源特性为增强功能提供了巨大的机会。社区驱动的碳核算插件、标准化的 ESG 账本模板以及与排放因子 API 的更好集成，都将显著提升其能力。

随着企业界越来越接受“绿色账本”，Beancount 已准备就绪，成为一个灵活、透明且可审计的解决方案。通过以与财务数据相同的严谨性整合 ESG 数据，Beancount 赋能组织不仅满足合规要求，而且推动有意义的可持续发展举措。

您准备好将您的 ESG 数据带入纯文本革命了吗？

Beancount.io 加密货币会计完整指南

· 阅读需 19 分钟
Mike Thrift
Mike Thrift
Marketing Manager

您是否正深陷于跨多个交易所的加密货币交易中，为 DeFi 的复杂性所困扰，或因报税季而感到恐慌？ 您并非孤身一人。加密货币领域已从简单的比特币购买，发展成为一个由 DeFi 协议、质押奖励、流动性挖矿和跨链活动组成的复杂生态系统，这些都对传统会计方法构成了挑战。

残酷的现实是：每笔加密货币交易都可能需要纳税，美国国税局（IRS）正在密切关注。无论您是普通的比特币持有者，还是管理着数十个协议头寸的 DeFi 高级用户，维护准确的财务记录并非可有可无——它对于合规性和财务清晰度至关重要。

问题何在？ 传统的会计软件对加密货币的复杂性原生支持有限。虽然 QuickBooks 等工具可以通过附加插件处理加密货币，Excel 也可以通过脚本导入区块链数据，但大多数解决方案都需要大量定制才能实现全面的加密货币会计。

解决方案？ Beancount.io 的纯文本会计系统，它基于强大的开源 Beancount 语言构建。重要提示：Beancount 是由 Martin Blais 创建的开源复式记账语言，而 Beancount.io 是一项商业托管服务，为 Beancount 提供用户友好的界面和云基础设施。本指南将涵盖 Beancount 的底层原理，以及如何通过 Beancount.io 平台有效利用它们。

加密货币会计完整指南

加密货币会计噩梦 (以及为何情况正在恶化)​

您的加密资产组合散落在各处​

让我们坦诚面对您的现状。您可能拥有：

  • 3-5个不同的交易所 (Coinbase 用于便捷购买，币安用于山寨币，Kraken 用于某种特定代币...)
  • 多个钱包 (MetaMask 用于 DeFi，Ledger 用于长期持有，以及您遗忘的旧钱包...)
  • 跨越10多个协议的 DeFi 头寸 (Uniswap、Compound、Aave，以及任何吸引您注意的新型收益农场)
  • 质押奖励 从各种验证器中陆续流入
  • 随机空投 像加密圣诞礼物一样出现在您的钱包中

每个平台都有不同的“语言”。 Coinbase 提供的 CSV 文件与币安的导出文件截然不同。Uniswap 甚至没有导出功能。更不用说追踪您在 Layer 2 网络上的 DeFi 头寸了。

挑战传统会计的交易类型​

您的加密货币活动包含了一些传统会计系统最初并非为处理而设计的交易类型：

  • 无常损失：来自提供流动性（试试向 QuickBooks 解释一下）
  • 闪电贷：在单笔交易中借入并偿还数百万
  • 流动性挖矿：通过提供流动性赚取 5 种不同的代币
  • 跨链桥：使资产在一个网络上消失并在另一个网络上出现
  • 质押衍生品：例如 stETH，其价值累积方式不同于底层资产
  • DAO 治理代币：您因为使用了协议而收到的代币

税务合规雷区​

以下是让加密货币投资者夜不能寐的问题：

  • 每一笔交易都应纳税（是的，即使是 ETH 到 USDC 的兑换）
  • 成本基础追踪在数百笔微交易面前变得不可能
  • 质押奖励属于收入，在您收到它们的那一刻（按公允市场价值计算）
  • DeFi 奖励属于收入，即使您尚未出售它们
  • 美国国税局要求提供 8949 表格，列出每一笔交易
  • 如果出错，罚款严厉

传统会计软件需要大量定制才能应对这种复杂性。 尽管存在解决方案，但它们通常需要额外的插件、脚本或手动流程来处理加密货币活动的全部范围。

隆重推出 Beancount.io：您一直在等待的加密货币会计解决方案​

如果我告诉您，有一个会计系统正是为应对这种混乱而设计的呢？ Beancount.io 不仅仅是另一个会计工具——它是一场纯文本会计革命，能够轻松处理加密货币的复杂性，仿佛天生为此而生。

为何 Beancount.io 在加密货币会计领域独占鳌头​

🔍 完全透明: 每笔计算都清晰可见。没有黑箱操作，没有“请相信我们”的算法。您能清楚地看到成本基础是如何计算的，收益是如何计算的，以及每一聪的去向。

📊 无限灵活性: 创建您所需的任何账户结构。追踪 DeFi 头寸、质押衍生品、跨链资产，或是您通过 DAO 投票获得的奇特代币。只要您能想到，就能追踪到。

🎯 精确成本基础: 基于批次的追踪，支持特定识别。精确选择您出售的比特币批次，以获得最佳税务结果。先进先出 (FIFO)、后进先出 (LIFO)，或自由选择您的批次——一切由您决定。

🔗 未来无忧: 纯文本格式意味着您的数据永远属于您。没有供应商锁定，没有专有格式，没有“抱歉，我们即将关闭”的邮件。

⚡ 可脚本化能力: 自动化导入，生成自定义报告，并与任何工具集成。因为您的加密货币投资组合是独一无二的，所以您的记账方式也应该如此。

设置你的加密货币指挥中心​

构建您的账户架构​

将其视为设计您的加密资产帝国的蓝图。我们正在创建一个能够处理从首次比特币购买到复杂的多协议 DeFi 策略的结构：

注意：示例中使用 1970-01-01 作为占位符开户日期。实际使用时，请替换为您的真实账户开户日期，特别是当您使用按日期筛选交易的自动化导入工具时。

; 交易所账户
1970-01-01 open Assets:Crypto:Coinbase:USD
1970-01-01 open Assets:Crypto:Coinbase:BTC
1970-01-01 open Assets:Crypto:Coinbase:ETH
1970-01-01 open Assets:Crypto:Binance:USD
1970-01-01 open Assets:Crypto:Binance:BTC
1970-01-01 open Assets:Crypto:Binance:ETH
1970-01-01 open Assets:Crypto:Binance:ADA

; 钱包账户
1970-01-01 open Assets:Crypto:Wallet:MetaMask:ETH
1970-01-01 open Assets:Crypto:Wallet:MetaMask:USDC
1970-01-01 open Assets:Crypto:Wallet:MetaMask:UNI
1970-01-01 open Assets:Crypto:Wallet:Ledger:BTC
1970-01-01 open Assets:Crypto:Wallet:Ledger:ETH

; DeFi 协议账户
1970-01-01 open Assets:DeFi:Compound:cUSDC
1970-01-01 open Assets:DeFi:Uniswap:ETH-USDC-LP
1970-01-01 open Assets:Staking:Ethereum:ETH
1970-01-01 open Assets:Crypto:Mining:BTC

; 收入账户
1970-01-01 open Income:Crypto:Staking:ETH
1970-01-01 open Income:Crypto:Mining:BTC
1970-01-01 open Income:Crypto:Airdrops
1970-01-01 open Income:Crypto:DeFi:Yield
1970-01-01 open Income:CapitalGains:Crypto
1970-01-01 open Income:Crypto:Trading:Margin

; 支出账户
1970-01-01 open Expenses:Crypto:Fees:Trading
1970-01-01 open Expenses:Crypto:Fees:Network
1970-01-01 open Expenses:Crypto:Fees:Withdrawal

; 进阶场景附加账户
1970-01-01 open Assets:Crypto:Binance:BTC-Margin
1970-01-01 open Liabilities:Crypto:Binance:Borrowed
1970-01-01 open Liabilities:Crypto:Binance:BTC
1970-01-01 open Assets:Checking
1970-01-01 open Expenses:Crypto:Mining:Electricity

商品定义​

将您的加密货币定义为商品，并附带适当的元数据：

1970-01-01 commodity BTC
  name: "Bitcoin"
  asset-class: "cryptocurrency"
  price-source: "coinbase"

1970-01-01 commodity ETH
  name: "Ethereum"
  asset-class: "cryptocurrency"
  price-source: "coinbase"

1970-01-01 commodity ADA
  name: "Cardano"
  asset-class: "cryptocurrency"
  price-source: "binance"

1970-01-01 commodity USDC
  name: "USD Coin"
  asset-class: "stablecoin"
  price-source: "coinbase"

1970-01-01 commodity UNI
  name: "Uniswap"
  asset-class: "cryptocurrency"
  price-source: "coinbase"

1970-01-01 commodity UNI-V2-ETH-USDC
  name: "Uniswap V2 ETH-USDC LP Token"
  asset-class: "liquidity-pool"

精通加密货币交易：从简单到复杂​

准备好了解 Beancount.io 的实际应用了吗？ 让我们一起探讨那些其他会计系统难以处理，但 Beancount.io 却能优雅处理的真实场景。

1. 您的首次比特币购买 (敲门砖)​

每一段加密货币之旅都始于某个地方。以下是如何记录您购买第一枚比特币这一改变人生的时刻：

2024-01-15 * "Buy 0.5 BTC on Coinbase"
  Assets:Crypto:Coinbase:BTC     0.5 BTC {30000.00 USD}
  Assets:Crypto:Coinbase:USD  -15025.00 USD
  Expenses:Crypto:Fees:Trading    25.00 USD

2. 像专业人士一样获利了结（或止损）​

关键时刻：出售您的加密货币。大多数会计系统在此处会束手无策，但 Beancount.io 凭借其精确的成本基础追踪功能而大放异彩：

2024-03-20 * "Sell 0.3 BTC on Coinbase"
  Assets:Crypto:Coinbase:BTC    -0.3 BTC {30000.00 USD}
  Assets:Crypto:Coinbase:USD   10470.00 USD
  Expenses:Crypto:Fees:Trading    30.00 USD
  Income:CapitalGains:Crypto   1440.00 USD  ; 10470 - (0.3 × 30000) - 30 = 1440

3. 质押奖励：睡后收入​

极致的被动收入。 但请记住，美国国税局要求质押奖励在收到时，根据收到时的公允市场价值申报为应税收入（根据美国国税局2024年数字资产指南）。尽管存在正在进行的诉讼（Jarrett 诉美国案），但当前的官方立场要求立即申报。以下是正确追踪它们的方法：

2024-02-01 * "ETH 质押奖励"
  Assets:Staking:Ethereum:ETH      0.05 ETH {2500.00 USD}
  Income:Crypto:Staking:ETH      125.00 USD

4. DeFi 收益耕作：刺激之处 🌶️​

欢迎来到高级 DeFi 会计。 DeFi 收益耕作涉及复杂的多种代币交易，需要精密的追踪。以下是如何正确核算 Uniswap 流动性头寸：

; 初始流动性提供
2024-01-10 * "添加流动性到 ETH-USDC 资金池"
  Assets:Crypto:Wallet:MetaMask:ETH    -10 ETH {2500.00 USD}
  Assets:Crypto:Wallet:MetaMask:USDC -25000 USDC {1.00 USD}
  Assets:DeFi:Uniswap:ETH-USDC-LP     100 UNI-V2-ETH-USDC {500.00 USD}

; 领取奖励
2024-02-10 * "领取 Uniswap LP 奖励"
  Assets:Crypto:Wallet:MetaMask:UNI    50 UNI {8.00 USD}
  Income:Crypto:DeFi:Yield           400.00 USD

5. 跨交易所转账​

将比特币从 Coinbase 转移到 Ledger 钱包：

2024-01-20 * "Transfer BTC from Coinbase to Ledger"
  Assets:Crypto:Coinbase:BTC      -1.0 BTC {30000.00 USD}
  Assets:Crypto:Wallet:Ledger:BTC  0.9995 BTC {30000.00 USD}
  Expenses:Crypto:Fees:Withdrawal  0.0005 BTC {30000.00 USD}

高级加密货币场景​

杠杆交易​

记录杠杆仓位：

; 开立杠杆做多仓位 (借入比特币)
2024-02-15 * "开立2倍杠杆比特币仓位"
  Assets:Crypto:Binance:BTC-Margin      1.0 BTC {35000.00 USD}
  Liabilities:Crypto:Binance:BTC       -1.0 BTC {35000.00 USD}
  Expenses:Crypto:Fees:Trading            50.00 USD
  Assets:Crypto:Binance:USD              -50.00 USD

; 获利平仓
2024-02-20 * "平仓杠杆比特币仓位"
  Assets:Crypto:Binance:BTC-Margin   -1.0 BTC {35000.00 USD}
  Assets:Crypto:Binance:USD          37950.00 USD
  Liabilities:Crypto:Binance:BTC      1.0 BTC {35000.00 USD}
  Income:Crypto:Trading:Margin       -2900.00 USD
  Expenses:Crypto:Fees:Trading          50.00 USD

空投与分叉​

记录免费代币派发：

2024-03-01 * "收到 UNI 空投"
  Assets:Crypto:Wallet:MetaMask:UNI   400 UNI {8.00 USD}
  Income:Crypto:Airdrops             3200.00 USD

挖矿业务​

适用于加密货币矿工：

2024-01-01 * "比特币挖矿奖励"
  Assets:Crypto:Mining:BTC    0.1 BTC {45000.00 USD}
  Income:Crypto:Mining:BTC   4500.00 USD

; 挖矿费用
2024-01-31 * "挖矿电费"
  Expenses:Crypto:Mining:Electricity  800.00 USD
  Assets:Checking                    -800.00 USD

税务申报与合规​

成本基础追踪​

Beancount.io 使用批次成本法自动追踪成本基础：

; 多次以不同价格购买
2024-01-01 * "Buy BTC batch 1"
  Assets:Crypto:Coinbase:BTC  1.0 BTC {40000.00 USD}
  Assets:Crypto:Coinbase:USD -40000.00 USD

2024-02-01 * "Buy BTC batch 2"
  Assets:Crypto:Coinbase:BTC  1.0 BTC {45000.00 USD}
  Assets:Crypto:Coinbase:USD -45000.00 USD

; 出售特定批次（先进先出法、后进先出法或特定识别法）
2024-03-01 * "Sell BTC using FIFO"
  Assets:Crypto:Coinbase:BTC    -0.5 BTC {40000.00 USD}
  Assets:Crypto:Coinbase:USD   22470.00 USD
  Expenses:Crypto:Fees:Trading    30.00 USD
  Income:CapitalGains:Crypto    2440.00 USD  ; 22470 - 20000 - 30 = 2440

生成税务报告​

使用 Beancount 的查询系统和插件生成税务报告：

  • Form 8949：资本利得和损失（通过 bean-query 或第三方插件）
  • Schedule D：资本利得汇总（需要额外脚本）
  • Form 1040：质押、挖矿、空投收入（通过自定义报告）
  • 详细交易日志：用于审计目的

注意：税务报告生成需要额外的插件、脚本或与专业税务软件集成。Beancount 提供数据基础，但特定的税务表格通常需要自定义开发或第三方工具。

加密货币会计的最佳实践​

1. 定期对账​

  • 每周导入交易数据
  • 每月核对钱包余额
  • 与区块链浏览器交叉核对

2. 妥善记录​

  • 保存所有交易凭证
  • 记录每笔交易的用途
  • 记录交易时的市场价格

3. 区分业务与个人​

; 个人加密货币投资
Assets:Personal:Crypto:Coinbase:BTC

; 业务加密货币操作
Assets:Business:Crypto:Treasury:BTC

4. 追踪所有收入来源​

  • 质押奖励 (应税收入)
  • 挖矿奖励 (应税收入)
  • 空投 (按公允市场价值征税)
  • DeFi 收益 (应税收入)

5. 费用管理​

分开记录所有费用，以便正确抵税：

Expenses:Crypto:Fees:Trading     ; 交易所交易费
Expenses:Crypto:Fees:Network     ; 区块链网络费
Expenses:Crypto:Fees:Withdrawal  ; 提币费

集成热门加密货币工具​

交易所 API 集成​

Beancount.io 可以与主流交易所集成：

  • Coinbase Pro API：自动交易导入
  • 币安 API：实时余额更新
  • Kraken API：历史数据同步

区块链分析​

连接区块链浏览器：

  • Etherscan: 以太坊交易验证
  • Blockchain.info: 比特币交易追踪
  • BscScan: 币安智能链监控

投资组合追踪​

同步投资组合管理工具：

  • CoinTracker：税务报告生成
  • Koinly：多交易所数据聚合
  • Blockfolio：移动投资组合追踪

重要免责声明​

税务和法律声明：本指南提供有关使用 Beancount 进行加密货币会计的通用信息，不构成专业的税务、法律或财务建议。加密货币交易的税务处理因管辖区和个人情况而异。诸如跨链桥、无常损失和闪电贷等复杂场景，在当前法规下可能存在不明确的税务影响。有关交易是否构成应税处置的具体指导，请参阅美国国税局常见问题解答 Q-15 至 Q-18 (2024)，或咨询当地税务法规。在做出税务相关决策之前，请务必咨询您所在管辖区内熟悉加密货币税务的合格税务专业人士或注册会计师。

软件说明：本指南中的示例使用标准 Beancount 语法。尽管 Beancount.io 提供了一个用户友好的 Beancount 界面，但其基本会计原则适用于任何 Beancount 实现。

总结​

加密货币会计不必令人望而生畏。借助 Beancount 强大的纯文本会计系统（可通过 Beancount.io 平台访问），您可以：

  • 保持完全透明：每笔交易都可见且可审计
  • 确保税务合规：准确的成本基础追踪和收入报告
  • 随您的投资组合扩展：从简单交易到复杂的 DeFi 策略均可处理
  • 无缝集成：连接交易所、钱包和税务工具
  • 记录面向未来：纯文本格式确保长期可访问性

无论您是普通的比特币持有者，还是专业的 DeFi 收益农场主，Beancount 都能为您掌握加密货币会计提供所需的基础和灵活性。从基本交易开始，随着您的加密之旅发展，逐步纳入更复杂的场景。

本指南中的示例提供了坚实的基础，但请记住，加密货币会计是一个不断发展的领域。及时了解监管变化，咨询税务专业人士，并根据需要调整您的会计实践。

准备好掌控您的加密货币财务了吗？注册 Beancount.io，体验基于强大 Beancount 基础构建的透明、可脚本化加密会计的强大功能。

加密货币税务合规指南：使用 Beancount.io 掌握 IRS 要求

· 阅读需 13 分钟
Mike Thrift
Mike Thrift
Marketing Manager

加密货币税务已从一个小众问题演变为数百万投资者的一项关键合规要求。随着美国国税局加强执法并要求详细报告，准确的记账不再仅仅是良好实践——它是避免罚款和优化您的税务责任的关键。

本综合指南将向您展示如何使用 Beancount.io 强大的纯文本记账系统实现完整的加密货币税务合规，确保您满足所有美国国税局要求，同时最大限度地提高税务效率。

加密货币税务合规指南

理解加密货币纳税要求​

美国国税局对加密货币的征税规定​

美国国税局将加密货币视为财产而非货币，这会产生特定的税务影响：

  • 每笔交易都可能产生应税事件：交易、出售、消费或兑换加密货币
  • 必须追踪成本基础：针对持有的每单位加密货币
  • 持有期决定税率：短期资本利得与长期资本利得
  • 需要确认收入：针对挖矿、质押、空投和 DeFi 奖励
  • 强制要求详细记录：用于审计的交易层面文件

关键加密货币税务表格​

Form 1040 - 个人所得税申报表​

  • 第1行: 申报加密货币收入（质押、挖矿、空投）
  • 附表1: 额外收入来源
  • 数字资产问题: 如果您有加密货币交易，必须回答“是”

表 8949 - 资本资产的销售及其他处置​

  • 第一部分：短期资本利得/损失 (持有期 ≤ 1 年)
  • 第二部分：长期资本利得/损失 (持有期 > 1 年)
  • 详细交易报告：取得日期、出售日期、销售收入、成本基础

附表 D - 资本利得与损失​

  • 表格 8949 概要: 汇总的资本利得/损失
  • 净资本利得/损失: 应纳税额的最终计算

设置税务合规的加密货币会计​

用于税务申报的账户结构​

设计您的账户层级以符合税务要求：

; Assets - Organized by holding period and source
1970-01-01 open Assets:Crypto:ShortTerm:Coinbase:BTC
1970-01-01 open Assets:Crypto:LongTerm:Coinbase:BTC
1970-01-01 open Assets:Crypto:Trading:Binance:ETH
1970-01-01 open Assets:Crypto:Investment:Ledger:BTC

; Income - Separated by tax treatment
1970-01-01 open Income:Crypto:Staking:Ordinary        ; Taxed as ordinary income
1970-01-01 open Income:Crypto:Mining:Ordinary         ; Taxed as ordinary income
1970-01-01 open Income:Crypto:Airdrops:Ordinary       ; Taxed as ordinary income
1970-01-01 open Income:CapitalGains:ShortTerm         ; Short-term capital gains
1970-01-01 open Income:CapitalGains:LongTerm          ; Long-term capital gains

; Expenses - Tax deductible categories
1970-01-01 open Expenses:Crypto:Fees:Deductible       ; Trading fees
1970-01-01 open Expenses:Crypto:Mining:Equipment      ; Mining equipment
1970-01-01 open Expenses:Crypto:Mining:Electricity    ; Mining electricity
1970-01-01 open Expenses:CapitalLoss:ShortTerm        ; Short-term capital losses
1970-01-01 open Expenses:CapitalLoss:LongTerm         ; Long-term capital losses

用于税务合规的元数据​

使用元数据追踪税务相关信息：

2024-01-15 * "Buy BTC for long-term investment" ^investment-btc #long-term
  purchase-date: "2024-01-15"
  intended-holding: "long-term"
  tax-lot-id: "BTC-001"
  Assets:Crypto:LongTerm:Coinbase:BTC  1.0 BTC {45000.00 USD}
  Assets:Crypto:Coinbase:USD         -45000.00 USD
  Expenses:Crypto:Fees:Deductible        50.00 USD
  Assets:Crypto:Coinbase:USD            -50.00 USD

记录应税加密货币事项​

1. 加密货币销售​

短期资本利得 (≤ 1 年)​

2024-06-15 * "出售 BTC - 短期资本利得" ^btc-sale-001
  date-acquired: "2024-01-15"
  holding-period: "151 天"
  form-8949-code: "A"
  Assets:Crypto:ShortTerm:Coinbase:BTC  -0.5 BTC {45000.00 USD}
  Assets:Crypto:Coinbase:USD           24000.00 USD
  Expenses:Crypto:Fees:Deductible         30.00 USD
  Assets:Crypto:Coinbase:USD             -30.00 USD
  Income:CapitalGains:ShortTerm         1470.00 USD  ; 24000 - 22500 - 30

长期资本利得 (> 1 年)​

2025-02-01 * "Sell BTC - Long-term capital gain" ^btc-sale-002
  date-acquired: "2024-01-15"
  holding-period: "382 days"
  form-8949-code: "D"
  Assets:Crypto:LongTerm:Coinbase:BTC   -0.5 BTC {45000.00 USD}
  Assets:Crypto:Coinbase:USD           28000.00 USD
  Expenses:Crypto:Fees:Deductible         35.00 USD
  Assets:Crypto:Coinbase:USD             -35.00 USD
  Income:CapitalGains:LongTerm          5465.00 USD  ; 28000 - 22500 - 35

2. 币币交易​

每笔币币交易都需要纳税：

2024-03-20 * "Trade BTC for ETH - Taxable exchange"
  ; 处置比特币 (应税事件)
  Assets:Crypto:Trading:Binance:BTC     -1.0 BTC {46000.00 USD}
  Income:CapitalGains:ShortTerm        2000.00 USD  ; 48000 - 46000
  
  ; 购入以太坊 (新的成本基础)
  Assets:Crypto:Trading:Binance:ETH      20 ETH {2400.00 USD}
  
  ; 交易费用
  Expenses:Crypto:Fees:Deductible        40.00 USD
  Assets:Crypto:Trading:Binance:USD     -40.00 USD

3. 质押奖励 (普通收入)​

2024-01-31 * "ETH 质押奖励 - 一月"
  reward-type: "质押"
  fair-market-value: "每 ETH 2500.00 美元"
  taxable-income: "200.00 美元"
  Assets:Staking:Ethereum:ETH           0.08 ETH {2500.00 USD}
  Income:Crypto:Staking:Ordinary       200.00 USD

4. 挖矿收入​

2024-01-15 * "比特币挖矿奖励"
  矿池: "Slush Pool"
  区块高度: "825000"
  公允市场价值: "45000.00 USD per BTC"
  资产:加密货币:挖矿:BTC              0.01 BTC {45000.00 USD}
  收入:加密货币:挖矿:普通        450.00 USD
  
  ; 挖矿费用 (可抵扣)
  费用:加密货币:挖矿:电费    120.00 USD
  资产:活期账户                      -120.00 USD

5. 空投和硬分叉​

2024-03-01 * "UNI 代币空投"
  airdrop-source: "Uniswap 协议"
  fair-market-value: "每 UNI 8.00 美元"
  taxable-amount: "3200.00 美元"
  Assets:Crypto:Wallet:MetaMask:UNI    400 UNI {8.00 USD}
  Income:Crypto:Airdrops:Ordinary     3200.00 USD

6. DeFi 活动​

收益耕作奖励​

2024-02-28 * "Compound 协议收益"
  protocol: "Compound"
  reward-token: "COMP"
  fair-market-value: "每 COMP 85.00 美元"
  Assets:加密货币:钱包:MetaMask:COMP    12 COMP {85.00 USD}
  Income:加密货币:DeFi:普通         1020.00 USD

流动性池费用​

2024-02-15 * "Uniswap LP 费用已认领"
  protocol: "Uniswap V3"
  pool: "ETH-USDC"
  Assets:Crypto:Wallet:MetaMask:ETH     0.2 ETH {2600.00 USD}
  Assets:Crypto:Wallet:MetaMask:USDC    300 USDC
  Income:Crypto:DeFi:Ordinary          820.00 USD

税务优化策略​

1. 税损收割​

系统性地实现亏损以抵消收益：

; 识别亏损头寸
2024-12-15 * "税损收割 - 亏损出售 ADA"
  purchase-date: "2024-06-01"
  purchase-price: "0.60 USD per ADA"
  sale-price: "0.45 USD per ADA"
  Assets:Crypto:Trading:Binance:ADA    -1000 ADA {0.60 USD}
  Assets:Crypto:Trading:Binance:USD     445.00 USD
  Expenses:Crypto:Fees:Deductible         5.00 USD
  Assets:Crypto:Trading:Binance:USD      -5.00 USD
  Expenses:CapitalLoss:ShortTerm       150.00 USD  ; 已实现亏损

2. 洗售考量​

尽管洗售规则不正式适用于加密货币，但仍需避免潜在问题：

; 在重新购买前等待 31 天
2025-01-16 * "在洗售期后重新购买 ADA"
  wash-sale-safe: "已过 31 天以上"
  Assets:Crypto:Trading:Binance:ADA    1000 ADA {0.45 USD}
  Assets:Crypto:Trading:Binance:USD    -450.00 USD
  Expenses:Crypto:Fees:Deductible         5.00 USD
  Assets:Crypto:Trading:Binance:USD      -5.00 USD

3. 特定识别法​

选择出售哪些批次以获得最佳税务结果：

; 用于亏损收割的高成本基础批次
2024-11-30 * "Sell high-cost ETH lot for tax loss"
  lot-selection: "specific-identification"
  cost-basis: "3500.00 USD per ETH"
  sale-price: "2400.00 USD per ETH"
  Assets:Crypto:Trading:Coinbase:ETH    -5 ETH {3500.00 USD}
  Assets:Crypto:Trading:Coinbase:USD  11950.00 USD
  Expenses:Crypto:Fees:Deductible        50.00 USD
  Assets:Crypto:Trading:Coinbase:USD    -50.00 USD
  Expenses:CapitalLoss:ShortTerm      5500.00 USD  ; 重大亏损

4. 长期与短期规划​

策略性地安排销售时机，以获得有利的税务处理：

; 持有以获得长期处理
2024-12-20 * "比特币接近长期持有状态"
  purchase-date: "2024-01-01"
  days-held: "354"
  long-term-date: "2025-01-02"
  note: "再持有11天以获得长期处理"

自动化税务报告​

Form 8949 生成​

使用 Beancount.io 查询生成 Form 8949 数据：

-- 短期资本利得/损失
SELECT 
  date,
  narration,
  -position as 售出数量,
  cost(position) as 成本基础,
  value(position) as 所得,
  value(position) + cost(position) as 盈亏
WHERE account ~ "Income:CapitalGains:ShortTerm" 
   OR account ~ "Expenses:CapitalLoss:ShortTerm"
ORDER BY date;

附表D 汇总​

-- Capital gains summary
SELECT 
  'Short-term' as type,
  sum(position) as total_gain_loss
WHERE account ~ "Income:CapitalGains:ShortTerm" 
   OR account ~ "Expenses:CapitalLoss:ShortTerm"

UNION ALL

SELECT 
  'Long-term' as type,
  sum(position) as total_gain_loss
WHERE account ~ "Income:CapitalGains:LongTerm" 
   OR account ~ "Expenses:CapitalLoss:LongTerm";

经常性收入报告​

-- 加密货币经常性收入
SELECT
  account,
  sum(position) as total_income
WHERE account ~ "Income:Crypto.*:Ordinary"
GROUP BY account
ORDER BY total_income DESC;

记录保存与文档​

必要文档​

维护每笔交易的完整记录：

2024-01-15 * "比特币购买 - 完整记录" ^btc-001
  exchange: "Coinbase Pro"
  transaction-id: "abc123def456"
  confirmation-hash: "0x789..."
  ip-address: "192.168.1.100"
  timestamp: "2024-01-15T14:30:00Z"
  market-price-source: "CoinGecko"
  Assets:Crypto:LongTerm:Coinbase:BTC  1.0 BTC {45000.00 USD}
  Assets:Crypto:Coinbase:USD         -45000.00 USD

审计追踪维护​

创建详细的审计追踪：

; 关联相关交易
2024-01-15 * "BTC 购买" ^btc-purchase-001
2024-01-20 * "BTC 转入钱包" ^btc-purchase-001
2024-06-15 * "BTC 出售" ^btc-purchase-001

价格验证​

记录价格来源以获取公允市场价值：

2024-01-15 price BTC 45000.00 USD
  source: "CoinGecko"
  timestamp: "2024-01-15T14:30:00Z"
  verification: "多交易所平均值"

常见税务合规错误​

1. 漏记交易​

  • 问题: 未申报所有应税事项
  • 解决方案: 在 Beancount.io 中进行全面的交易追踪

2. 错误成本基础​

  • 问题: 使用错误的成本基础计算方法
  • 解决方案: 基于批次的跟踪与个别认定法

3. 收入漏报​

  • 问题： 未申报质押、挖矿或空投收入
  • 解决方案： 为所有来源设立独立的收入账户

4. 文档不足​

  • 问题: 记录不足，不利于审计抗辩
  • 解决方案: 详细的元数据和交易链接

5. 时序问题​

  • 问题：持有期计算错误
  • 解决方案：自动化日期追踪和提醒

与税务软件集成​

导出至常用报税工具​

生成可与主流报税软件兼容的报告：

# 导出为 TurboTax 格式
def export_turbotax_format():
    return {
        'form_8949_short_term': query_short_term_gains(),
        'form_8949_long_term': query_long_term_gains(),
        'schedule_1_income': query_ordinary_income(),
        'deductible_expenses': query_deductible_expenses()
    }

专业报税准备​

为注册会计师提供综合报告：

-- 为注册会计师提供完整的报税包
SELECT 
  '资本利得汇总' as report_type,
  account,
  sum(position) as amount
WHERE account ~ "Income:CapitalGains" 
   OR account ~ "Expenses:CapitalLoss"
GROUP BY account

UNION ALL

SELECT 
  '普通收入汇总' as report_type,
  account,
  sum(position) as amount
WHERE account ~ "Income:Crypto.*:Ordinary"
GROUP BY account;

年末税务规划​

十二月税务策略​

实施年末税务优化：

; 十二月税务规划清单
2024-12-01 * "年末税务规划审查"
  unrealized-gains: "计算未实现头寸"
  loss-harvesting: "识别亏损收割机会"
  income-timing: "考虑将收入递延到明年"
  expense-timing: "加速可抵扣费用"

季度预估税​

记录季度税务义务：

2024-01-15 * "Q1 Estimated Tax Payment"
  Expenses:Taxes:Estimated:Federal     5000.00 USD
  Expenses:Taxes:Estimated:State       1200.00 USD
  Assets:Checking                     -6200.00 USD

结论​

加密货币税务合规不必令人望而生畏。借助 Beancount.io 全面的纯文本记账系统，您可以：

  • 确保全面合规：满足所有美国国税局 (IRS) 报告要求
  • 优化纳税义务：实施复杂的税务策略
  • 维护审计就绪记录：提供全面的文档和审计追踪
  • 自动化报告：自动生成税务表格和报告
  • 随复杂性扩展：处理从简单交易到复杂 DeFi 策略

加密税务合规的关键优势：

  • 透明计算：准确了解税款如何计算
  • 灵活报告：生成所需的任何报告格式
  • 专业整合：与注册会计师 (CPA) 和税务软件无缝协作
  • 经久不衰的记录：纯文本格式确保长期可访问性

立即开始实施规范的加密税务合规。对准确记账的投入将在报税季为您节省时间、金钱并减轻压力，同时确保您完全符合美国国税局 (IRS) 的要求。

准备好掌握加密货币税务合规了吗？立即开始使用 Beancount.io 并掌控您的加密税务义务。

轻松掌握 DeFi 会计：使用纯文本记账追踪流动性挖矿、流动性池和质押奖励

· 阅读需 11 分钟
Mike Thrift
Mike Thrift
Marketing Manager

去中心化金融 (DeFi) 彻底改变了我们与金融服务互动的方式，为收益生成、流动性提供和去中心化交易带来了前所未有的机会。然而，伴随这些机会而来的是准确追踪复杂交易以实现税务合规和投资组合管理的挑战。

传统会计方法难以应对 DeFi 的独特特性：自动化做市商、流动性挖矿、无常损失和多代币奖励。这份综合指南将向您展示如何使用 Beancount.io 强大的纯文本记账系统来掌握 DeFi 会计。

DeFi 会计变得简单

理解 DeFi 会计挑战​

DeFi 交易的复杂性​

DeFi 协议带来了传统金融中不存在的会计挑战：

  • 多代币交易：涉及多种加密货币的单一操作
  • 自动复投：奖励自动再投资
  • 无常损失：流动性池中因价格背离导致的价值变化
  • Gas 费用优化：跨不同网络的复杂费用结构
  • 协议治理：投票权和治理代币分配
  • 跨协议交互：跨多个 DeFi 平台的交易

DeFi 活动的税务影响​

美国国税局将 DeFi 活动视为应税事件：

  • 流动性提供：存入资产时可能触发应税事件
  • 收益耕作奖励：按公允市场价值作为普通收入征税
  • 无常损失：从资金池中提取时可能产生税务影响
  • 治理代币：空投和奖励应税为收入
  • 质押奖励：收到时应税为收入

Beancount.io 中 DeFi 账户的设置​

全面的账户结构​

创建一个详细的账户层级，以记录所有 DeFi 活动：

; Wallet Accounts
1970-01-01 open Assets:Crypto:Wallet:MetaMask:ETH
1970-01-01 open Assets:Crypto:Wallet:MetaMask:USDC
1970-01-01 open Assets:Crypto:Wallet:MetaMask:DAI
1970-01-01 open Assets:Crypto:Wallet:MetaMask:WBTC

; Uniswap V3 Liquidity Pools
1970-01-01 open Assets:DeFi:Uniswap:ETH-USDC-LP
1970-01-01 open Assets:DeFi:Uniswap:DAI-USDC-LP
1970-01-01 open Assets:DeFi:Uniswap:WBTC-ETH-LP

; Compound Protocol
1970-01-01 open Assets:DeFi:Compound:cUSDC
1970-01-01 open Assets:DeFi:Compound:cETH
1970-01-01 open Assets:DeFi:Compound:cDAI

; Aave Protocol
1970-01-01 open Assets:DeFi:Aave:aUSDC
1970-01-01 open Assets:DeFi:Aave:aETH
1970-01-01 open Assets:DeFi:Aave:DebtETH

; Staking Protocols
1970-01-01 open Assets:Staking:Ethereum:ETH
1970-01-01 open Assets:Staking:Lido:stETH
1970-01-01 open Assets:Staking:RocketPool:rETH

; Income Accounts
1970-01-01 open Income:DeFi:Yield:Uniswap
1970-01-01 open Income:DeFi:Yield:Compound
1970-01-01 open Income:DeFi:Yield:Aave
1970-01-01 open Income:DeFi:Staking:Ethereum
1970-01-01 open Income:DeFi:Governance:Tokens
1970-01-01 open Income:DeFi:Airdrops

; Expense Accounts
1970-01-01 open Expenses:DeFi:Gas:Ethereum
1970-01-01 open Expenses:DeFi:Gas:Polygon
1970-01-01 open Expenses:DeFi:Gas:Arbitrum
1970-01-01 open Expenses:DeFi:ImpermanentLoss

DeFi 专用商品​

定义代币和 LP 代币，并附带适当的元数据：

1970-01-01 commodity UNI-V3-ETH-USDC
  name: "Uniswap V3 ETH-USDC LP Token"
  asset-class: "liquidity-pool"
  protocol: "uniswap-v3"

1970-01-01 commodity cUSDC
  name: "Compound USDC"
  asset-class: "lending-token"
  protocol: "compound"

1970-01-01 commodity stETH
  name: "Lido Staked Ethereum"
  asset-class: "staking-derivative"
  protocol: "lido"

追踪常见的DeFi活动​

1. Uniswap 流动性提供​

向资金池添加流动性​

2024-01-15 * "向 ETH-USDC Uniswap V3 资金池添加流动性"
  Assets:Crypto:Wallet:MetaMask:ETH     -5.0 ETH {2500.00 USD}
  Assets:Crypto:Wallet:MetaMask:USDC  -12500 USDC
  Assets:DeFi:Uniswap:ETH-USDC-LP        100 UNI-V3-ETH-USDC {250.00 USD}
  Expenses:DeFi:Gas:Ethereum            0.01 ETH {2500.00 USD}
  Assets:Crypto:Wallet:MetaMask:ETH    -0.01 ETH {2500.00 USD}

申领 LP 费用​

2024-02-15 * "申领 Uniswap LP 费用"
  资产:加密货币:钱包:MetaMask:ETH     0.2 ETH {2600.00 USD}
  资产:加密货币:钱包:MetaMask:USDC    300 USDC
  收入:DeFi:收益:Uniswap            820.00 USD
  费用:DeFi:Gas:以太坊           0.005 ETH {2600.00 USD}
  资产:加密货币:钱包:MetaMask:ETH   -0.005 ETH {2600.00 USD}

移除流动性伴随无常损失​

2024-03-15 * "从 ETH-USDC 资金池中移除流动性"
  Assets:DeFi:Uniswap:ETH-USDC-LP       -100 UNI-V3-ETH-USDC {250.00 USD}
  Assets:加密货币:钱包:MetaMask:ETH      4.8 ETH {2800.00 USD}
  Assets:加密货币:钱包:MetaMask:USDC   12800 USDC
  Expenses:DeFi:无常损失         240.00 USD  ; 无常损失计算
  Expenses:DeFi:Gas:以太坊           0.008 ETH {2800.00 USD}
  Assets:加密货币:钱包:MetaMask:ETH   -0.008 ETH {2800.00 USD}

2. Compound 协议借贷​

向 Compound 提供资产​

2024-01-20 * "向 Compound 供应 USDC"
  Assets:Crypto:Wallet:MetaMask:USDC  -10000 USDC
  Assets:DeFi:Compound:cUSDC            500 cUSDC {20.00 美元}
  Expenses:DeFi:Gas:Ethereum           0.008 ETH {2500.00 美元}
  Assets:Crypto:Wallet:MetaMask:ETH   -0.008 ETH {2500.00 美元}

赚取复利​

2024-02-20 * "复利累积"
  Assets:DeFi:Compound:cUSDC             5.2 cUSDC {20.50 USD}
  Income:DeFi:Yield:Compound           106.60 USD

申领 COMP 奖励​

2024-02-20 * "申领 COMP 治理代币"
  Assets:Crypto:Wallet:MetaMask:COMP     12 COMP {85.00 USD}
  Income:DeFi:Governance:Tokens        1020.00 USD
  Expenses:DeFi:Gas:Ethereum           0.006 ETH {2600.00 USD}
  Assets:Crypto:Wallet:MetaMask:ETH   -0.006 ETH {2600.00 USD}

3. Aave 协议运营​

存款与借款​

; 存入 ETH 作为抵押品
2024-01-25 * "Deposit ETH to Aave"
  Assets:Crypto:Wallet:MetaMask:ETH    -10 ETH {2500.00 USD}
  Assets:DeFi:Aave:aETH                 10 aETH {2500.00 USD}
  Expenses:DeFi:Gas:Ethereum          0.01 ETH {2500.00 USD}
  Assets:Crypto:Wallet:MetaMask:ETH  -0.01 ETH {2500.00 USD}

; 借入 USDC，以 ETH 为抵押
2024-01-25 * "Borrow USDC from Aave"
  Assets:Crypto:Wallet:MetaMask:USDC  15000 USDC
  Liabilities:DeFi:Aave:DebtUSDC     -15000 USDC
  Expenses:DeFi:Gas:Ethereum          0.008 ETH {2500.00 USD}
  Assets:Crypto:Wallet:MetaMask:ETH  -0.008 ETH {2500.00 USD}

偿还附息贷款​

2024-03-25 * "向 Aave 偿还 USDC 贷款"
  Liabilities:DeFi:Aave:DebtUSDC      15000 USDC
  Expenses:DeFi:Interest:Aave           450 USDC  ;  应计利息
  Assets:Crypto:Wallet:MetaMask:USDC -15450 USDC
  Expenses:DeFi:Gas:Ethereum          0.008 ETH {2700.00 USD}
  Assets:Crypto:Wallet:MetaMask:ETH  -0.008 ETH {2700.00 USD}

4. 以太坊质押​

直接以太坊质押​

2024-01-10 * "在以太坊 2.0 上质押 ETH"
  Assets:Crypto:Wallet:MetaMask:ETH    -32 ETH {2500.00 USD}
  Assets:Staking:Ethereum:ETH           32 ETH {2500.00 USD}
  Expenses:DeFi:Gas:Ethereum          0.01 ETH {2500.00 USD}
  Assets:Crypto:Wallet:MetaMask:ETH  -0.01 ETH {2500.00 USD}

质押收益​

2024-02-10 * "ETH 质押收益"
  资产:质押:以太坊:ETH          0.15 ETH {2600.00 USD}
  收入:DeFi:质押:以太坊        390.00 USD

通过 Lido 进行流动性质押​

2024-01-12 * "通过 Lido 质押 ETH"
  Assets:Crypto:Wallet:MetaMask:ETH    -10 ETH {2500.00 USD}
  Assets:Staking:Lido:stETH             10 stETH {2500.00 USD}
  Expenses:DeFi:Gas:Ethereum          0.008 ETH {2500.00 USD}
  Assets:Crypto:Wallet:MetaMask:ETH  -0.008 ETH {2500.00 USD}

高级 DeFi 场景​

收益耕作策略​

多协议收益耕作​

; 步骤 1: 将 USDC 存入 Compound
2024-01-30 * "将 USDC 存入 Compound 进行收益耕作"
  Assets:Crypto:Wallet:MetaMask:USDC  -20000 USDC
  Assets:DeFi:Compound:cUSDC            1000 cUSDC {20.00 USD}

; 步骤 2: 抵押 cUSDC 借入 DAI
2024-01-30 * "从 Compound 借入 DAI"
  Assets:Crypto:Wallet:MetaMask:DAI    15000 DAI
  Liabilities:DeFi:Compound:DebtDAI   -15000 DAI

; 步骤 3: 向 Uniswap 提供 DAI-USDC 流动性
2024-01-30 * "添加 DAI-USDC 流动性进行收益耕作"
  Assets:Crypto:Wallet:MetaMask:DAI   -15000 DAI
  Assets:Crypto:Wallet:MetaMask:USDC   -5000 USDC  ; 额外的 USDC
  Assets:DeFi:Uniswap:DAI-USDC-LP        200 UNI-V3-DAI-USDC {100.00 USD}

跨链 DeFi 操作​

资产桥接​

2024-02-05 * "Bridge ETH to Polygon"
  Assets:Crypto:Wallet:MetaMask:ETH    -5 ETH {2600.00 USD}
  Assets:Crypto:Wallet:Polygon:ETH      5 ETH {2600.00 USD}
  Expenses:DeFi:Bridge:Fees           0.01 ETH {2600.00 USD}
  Assets:Crypto:Wallet:MetaMask:ETH  -0.01 ETH {2600.00 USD}

闪电贷与套利​

2024-02-10 * "闪电贷套利机会"
  ; 闪电贷
  资产:Crypto:Temp:FlashLoan       100000 USDC
  负债:DeFi:Aave:FlashLoan   -100000 USDC
  
  ; 套利交易
  资产:Crypto:Temp:FlashLoan      -100000 USDC
  资产:Crypto:Temp:Arbitrage       101500 USDC
  
  ; 偿还闪电贷
  负债:DeFi:Aave:FlashLoan    100000 USDC
  资产:Crypto:Temp:Arbitrage      -100090 USDC  ; 包括费用
  
  ; 利润
  资产:Crypto:Wallet:MetaMask:USDC   1410 USDC
  收入:DeFi:套利:利润        1410.00 USD

DeFi 税务报告考量​

收入确认​

所有 DeFi 奖励均应作为普通收入纳税：

; 分别追踪所有收入来源
Income:DeFi:Yield:Uniswap           ; LP 费用
Income:DeFi:Yield:Compound          ; 利息收入
Income:DeFi:Staking:Ethereum        ; 质押奖励
Income:DeFi:Governance:Tokens       ; 治理代币空投
Income:DeFi:Airdrops               ; 协议空投

费用抵扣​

追踪可抵扣费用：

Expenses:DeFi:Gas:Ethereum          ; 燃料费
Expenses:DeFi:Gas:Polygon           ; 二层网络费用
Expenses:DeFi:Interest:Aave         ; 借贷成本
Expenses:DeFi:ImpermanentLoss       ; 来自 LP 头寸的无常损失

资本利得追踪​

使用基于批次的会计核算，准确计算资本利得：

; 同一代币的不同成本基础
Assets:DeFi:Compound:cUSDC   100 cUSDC {20.00 USD}  ; 批次 1
Assets:DeFi:Compound:cUSDC   100 cUSDC {21.00 USD}  ; 批次 2

DeFi 会计最佳实践​

1. 实时交易记录​

  • 交易执行后立即记录交易
  • 使用交易哈希进行验证
  • 监控内存池中的待处理交易

2. 燃气费优化追踪​

; 追踪燃气费优化策略
Expenses:DeFi:Gas:Ethereum:Standard    ; 标准燃气费价格
Expenses:DeFi:Gas:Ethereum:Fast        ; 快速燃气费价格
Expenses:DeFi:Gas:Ethereum:Instant     ; 即时燃气费价格

3. 协议风险管理​

; 跟踪协议特定风险
Expenses:DeFi:Risk:SmartContract      ; 智能合约故障
Expenses:DeFi:Risk:Liquidation        ; 清算事件
Expenses:DeFi:Risk:Slippage          ; 滑点成本

4. 自动化对账​

  • 设置自动化价格数据源
  • 使用协议 API 进行余额验证
  • 实现自动化交易导入

5. 文档标准​

  • 维护详细的交易备注
  • 文档化策略原理
  • 保留协议交互记录

DeFi 工具集成​

投资组合追踪​

  • DeBank：DeFi 投资组合概览
  • Zapper：多协议仪表盘
  • Zerion：DeFi 钱包和追踪器

税务报告​

  • Koinly: DeFi 税务计算
  • CoinTracker: 多协议支持
  • TokenTax: 专业的 DeFi 报告

分析平台​

  • DeFi Pulse: 协议分析
  • DeFiLlama: TVL 和收益追踪
  • APY.vision: 无常损失追踪

结论​

DeFi 会计的复杂性不应阻碍您参与去中心化金融革命。借助 Beancount.io 强大的纯文本会计系统，您可以：

  • 追踪复杂交易：无缝处理多协议交互
  • 确保税务合规：妥善进行收入确认和费用追踪
  • 监控投资组合表现：实时洞察 DeFi 头寸
  • 管理风险：追踪无常损失和协议风险
  • 扩展操作：从简单的质押到复杂的收益耕作策略

成功进行 DeFi 会计的关键在于一致性、准确性和适当的分类。从基本协议开始，并随着您对会计模式的熟悉程度，逐渐扩展到更复杂的策略。

准备好精通 DeFi 会计了吗？开启您的 Beancount.io 之旅，立即掌控您的去中心化金融投资组合。

Beancount v3：有哪些新变化？

· 阅读需 5 分钟
Mike Thrift
Mike Thrift
Marketing Manager

Beancount 版本 3 于 2024 年年中发布，标志着这款流行的纯文本会计工具在架构上的重大演进。尽管它保持了用户账本文件的向后兼容性，但其底层结构和配套工具都经历了实质性变化。以下是 Beancount v3 的新特性一览。

更模块化、更精简的架构​

Beancount v3：有哪些新变化？

Beancount v3 最显著的变化是转向了更模块化的生态系统。以前与核心捆绑在一起的几个关键功能已被拆分到独立的、独立的项目中。这使得 Beancount 的核心更加精简，并允许对各个组件进行更集中的开发。

现在作为独立包的关键组件包括：

  • beanquery：用于账本文件的强大类 SQL 查询工具现在已成为一个独立的包。
  • beangulp：这是数据导入框架的新家，取代了之前的 beancount.ingest 模块。
  • beanprice：一个专门用于获取商品和股票价格的工具。

这种分离意味着用户除了安装 beancount 本身之外，还需要安装这些独立的包，以保留他们在版本 2 中习惯的全部功能。

命令行工具和工作流程的变化​

为了反映新的模块化架构，命令行工具发生了一些显著变化：

  • bean-report 已移除：此工具已被移除。现在鼓励用户使用 bean-query（来自 beanquery 包）来满足其报告需求。
  • 新的导入器工作流程：bean-extract 和 bean-identify 命令已从核心中移除。beangulp 的新方法是基于脚本的。用户现在将创建自己的 Python 脚本来处理从银行对账单等外部来源导入数据。

语法和功能增强​

虽然核心会计原则保持不变，但 Beancount v3 在其语法中引入了一些受欢迎的灵活性：

  • 更灵活的货币代码：以前对货币名称长度和字符的限制已放宽。现在支持单字符货币符号。
  • 扩展的交易标志：用户现在可以使用 A 到 Z 的任何大写字母作为交易的标志，从而实现更精细的分类。

重要的是，这些更改是向后兼容的，因此您现有的 Beancount v2 账本文件无需任何修改即可使用。

C++ 重写与性能​

Beancount 的长期目标之一是使用 C++ 重写其性能关键组件。虽然这项工作仍在进行中，但 Beancount v3 的初始版本不包含基于 C++ 的核心。这意味着目前 v3 的性能与 v2 相当。C++ 代码仍保留在单独的开发分支中，以供将来集成。

从 v2 迁移到 v3​

对于大多数用户而言，从 Beancount v2 迁移到 v3 相对简单：

  1. 账本文件：您的 .beancount 文件无需任何更改。
  2. 安装：您需要使用 pip 安装新的独立包，例如 beanquery 和 beangulp。
  3. 导入器脚本：如果您有自定义导入器，则需要更新它们以使用新的 beangulp API。这主要涉及更改导入器继承的基类并调整一些方法签名。
  4. Fava：Beancount 流行的网页界面 Fava 已更新以兼容 v3。请确保您拥有最新版本的 Fava 以获得无缝体验。

本质上，Beancount v3 是一个基础版本，它简化了项目的架构，使其在长期内更具模块化，更易于维护和扩展。虽然它需要对用户工作流程进行一些调整，尤其是在数据导入方面，但它为这款强大的会计工具的未来发展奠定了基础。

使用 Beancount 和 AI 自动化小企业费用管理

· 阅读需 6 分钟
Mike Thrift
Mike Thrift
Marketing Manager

小企业主平均每月花费 11 小时手动分类费用——每年近三个完整工作周用于数据录入。2023 年 QuickBooks 的一项调查显示，68% 的企业主将费用追踪列为他们最令人沮丧的记账任务，但只有 15% 的人采用了自动化解决方案。

纯文本记账，由 Beancount 等工具驱动，为财务管理提供了一种全新的方法。通过将透明、可编程的架构与现代 AI 功能相结合，企业可以实现高度准确的费用分类，同时保持对其数据的完全控制。

2025-05-28-how-to-automate-small-business-expense-categorization-with-plain-text-accounting-a-step-by-step-guide-for-beancount-users

本指南将引导您构建一个根据您业务独特模式量身定制的费用自动化系统。您将了解传统软件的不足之处，如何利用 Beancount 的纯文本基础，以及实施自适应机器学习模型的实用步骤。

手动费用管理的隐性成本​

手动费用分类不仅耗费时间，还会损害业务潜力。考虑一下机会成本：那些用于将收据与类别匹配的时间，本可以用来推动业务增长、加强客户关系或完善您的产品。

《今日会计》最近的一项调查发现，小企业主每周花费 10 小时用于记账任务。除了时间消耗，手动流程还会带来风险。以一家数字营销机构为例，他们发现手动分类导致差旅费用虚增了 20%，从而扭曲了他们的财务规划和决策。

根据美国小企业管理局的数据，糟糕的财务管理仍然是小企业失败的主要原因。错误分类的费用可能会掩盖盈利问题，忽视成本节约机会，并导致报税季的麻烦。

Beancount 的架构：简约与强大的结合​

Beancount 的纯文本基础将财务数据转化为代码，使每笔交易都可追踪并为 AI 做好准备。与被困在专有数据库中的传统软件不同，Beancount 的方法通过 Git 等工具实现版本控制，为每次更改创建审计追踪。

这种开放式架构允许与编程语言和 AI 工具无缝集成。一家数字营销机构报告称，通过根据其特定业务规则自动分类交易的自定义脚本，每月节省了 12 小时。

纯文本格式确保数据保持可访问性和可移植性——没有供应商锁定意味着企业可以随着技术发展而适应。这种灵活性，结合强大的自动化能力，为复杂的财务管理奠定了基础，同时不牺牲简洁性。

创建您的自动化流程​

使用 Beancount 构建费用自动化系统始于组织您的财务数据。让我们通过实际示例来了解具体的实现过程。

1. 设置您的 Beancount 结构​

首先，建立您的账户结构和类别：

2025-01-01 open Assets:Business:Checking
2025-01-01 open Expenses:Office:Supplies
2025-01-01 open Expenses:Software:Subscriptions
2025-01-01 open Expenses:Marketing:Advertising
2025-01-01 open Liabilities:CreditCard

2. 创建自动化规则​

这是一个演示自动分类的 Python 脚本：

import pandas as pd
from datetime import datetime

def categorize_transaction(description, amount):
    rules = {
        'ADOBE': 'Expenses:Software:Subscriptions',
        'OFFICE DEPOT': 'Expenses:Office:Supplies',
        'FACEBOOK ADS': 'Expenses:Marketing:Advertising'
    }

    for vendor, category in rules.items():
        if vendor.lower() in description.lower():
            return category
    return 'Expenses:Uncategorized'

def generate_beancount_entry(row):
    date = row['date'].strftime('%Y-%m-%d')
    desc = row['description']
    amount = abs(float(row['amount']))
    category = categorize_transaction(desc, amount)

    return f'''
{date} * "{desc}"
    {category}                               {amount:.2f} USD
    Liabilities:CreditCard                  -{amount:.2f} USD
'''

3. 处理交易​

以下是自动化条目在您的 Beancount 文件中的显示方式：

2025-05-01 * "ADOBE CREATIVE CLOUD"
    Expenses:Software:Subscriptions            52.99 USD
    Liabilities:CreditCard                   -52.99 USD

2025-05-02 * "OFFICE DEPOT #1234 - PRINTER PAPER"
    Expenses:Office:Supplies                  45.67 USD
    Liabilities:CreditCard                   -45.67 USD

2025-05-03 * "FACEBOOK ADS #FB12345"
    Expenses:Marketing:Advertising           250.00 USD
    Liabilities:CreditCard                  -250.00 USD

测试至关重要——从一部分交易开始，以验证分类的准确性。通过任务调度器定期执行可以每月节省 10 小时以上，让您能够专注于战略重点。

通过高级技术实现高准确性​

让我们探讨如何将机器学习与模式匹配相结合，以实现精确分类。

使用正则表达式进行模式匹配​

import re

patterns = {
    r'(?i)aws.*cloud': 'Expenses:Cloud:AWS',
    r'(?i)(zoom|slack|notion).*subscription': 'Expenses:Software:Subscriptions',
    r'(?i)(uber|lyft|taxi)': 'Expenses:Travel:Transport',
    r'(?i)(marriott|hilton|airbnb)': 'Expenses:Travel:Accommodation'
}

def regex_categorize(description):
    for pattern, category in patterns.items():
        if re.search(pattern, description):
            return category
    return None

机器学习集成​

from sklearn.feature_extraction.text import TfidfVectorizer
from sklearn.naive_bayes import MultinomialNB
import re
from typing import List, Tuple

class ExpenseClassifier:
    def __init__(self):
        self.vectorizer = TfidfVectorizer()
        self.classifier = MultinomialNB()

    def parse_beancount_entries(self, beancount_text: str) -> List[Tuple[str, str]]:
        """Parse Beancount entries into (description, category) pairs."""
        entries = []
        for line in beancount_text.split('\n'):
            # Look for transaction descriptions
            if '* "' in line:
                desc = re.search('"(.+)"', line)
                if desc:
                    description = desc.group(1)
                    # Get the next line which should contain the expense category
                    next_line = next(filter(None, beancount_text.split('\n')[beancount_text.split('\n').index(line)+1:]))
                    if 'Expenses:' in next_line:
                        category = next_line.split()[0].strip

AI 驱动的纯文本记账：彻底改变对账时间

· 阅读需 9 分钟
Mike Thrift
Mike Thrift
Marketing Manager

根据麦肯锡 2023 年的研究，现代财务团队通常将 65% 的时间用于手动对账和数据验证。在 Beancount.io，我们看到团队通过 AI 辅助工作流，将每周审查时间从 5 小时缩短至 1 小时，同时保持严格的准确性标准。

纯文本记账已经提供了透明度和版本控制。通过集成先进的 AI 功能，我们正在消除传统对账流程中繁琐的交易匹配、查找差异和手动分类等负担。

2025-05-24-AI 驱动的纯文本记账对账如何将手动审查时间减少 80%

让我们探讨组织如何通过 AI 驱动的对账实现显著的时间节省，并审视其技术基础、实际实施案例以及向自动化工作流过渡的实用指南。

手动对账的隐性成本​

手动对账类似于解决一个散落碎片的谜题。每笔交易都需要关注，差异需要调查，整个过程耗费宝贵时间。金融运营与领导力研究所报告称，60% 的会计专业人士每周有一半以上的时间用于手动对账。

这不仅造成时间损失，还带来一系列挑战。团队因重复性任务而面临精神疲劳，压力下错误风险增加。即使是微小的错误也可能在财务报告中蔓延。此外，过时的流程阻碍了协作，因为团队难以在不同部门间保持一致的记录。

以一家中型科技公司为例，其月结因手动对账而拖延数周。他们的财务团队不断在不同平台间验证交易，几乎没有带宽进行战略性工作。在采用自动化后，我们看到对账时间减少了约 70%，从而能够将更多精力投入到增长举措上。

AI + 纯文本如何改变银行对账单匹配​

AI 算法分析纯文本记账系统中的交易模式，自动建议银行对账单和会计记录之间的匹配。自然语言处理使 AI 能够解释非结构化银行对账单数据——例如，识别“AMZN Mktp US”为亚马逊市场购买。

以下是 AI 如何在 Beancount 中协助银行对账单匹配的实际案例：

# 原始银行对账单条目：
# "AMZN Mktp US*IF8QX0QS3" -29.99 USD

# AI 建议的 Beancount 交易：
2025-05-20 * "Amazon" "办公用品 - 键盘腕托"
  Expenses:Office:Supplies            29.99 USD
  Assets:Bank:Checking              -29.99 USD
  
# 原始银行对账单条目：
# "UBER *TRIP HELP.UBER.COM" -24.50 USD

# AI 建议的 Beancount 交易：
2025-05-21 * "Uber" "客户会议交通费"
  Expenses:Transportation:Taxi       24.50 USD
  Assets:Bank:Checking             -24.50 USD

AI 系统：

  1. 识别常见商家模式（例如，“AMZN Mktp US*” → “Amazon”）
  2. 根据交易历史建议合适的账户类别
  3. 从交易数据中提取有意义的描述
  4. 保持正确的复式记账格式
  5. 自动标记业务相关费用

对于更复杂的场景，例如分摊付款或循环交易，AI 在模式识别方面表现出色：

# 原始银行对账单条目：
# "POPEYES #1234" -80.00 USD
# "ALICE SMITH" +20.00 USD
# "BOB JONES" +20.00 USD
# "CHARLIE BROWN" +20.00 USD

# AI 建议的 Beancount 交易与分摊付款：
2025-05-22 * "Popeyes" "团队午餐 - 与 Alice、Bob 和 Charlie 分摊"
  Expenses:Food                      20.00 USD
  Assets:Receivables:Alice          20.00 USD
  Assets:Receivables:Bob            20.00 USD
  Assets:Receivables:Charlie        20.00 USD
  Liabilities:CreditCard           -80.00 USD

# AI 自动对账还款：
2025-05-23 * "Alice Smith" "团队午餐还款"
  Assets:Bank:Checking              20.00 USD
  Assets:Receivables:Alice         -20.00 USD

2025-05-23 * "Bob Jones" "团队午餐还款"
  Assets:Bank:Checking              20.00 USD
  Assets:Receivables:Bob           -20.00 USD

2025-05-23 * "Charlie Brown" "团队午餐还款"
  Assets:Bank:Checking              20.00 USD
  Assets:Receivables:Charlie       -20.00 USD

FinTech Insights 报告称，70% 的财务专业人士在使用 AI 驱动的工具后，错误显著减少。纯文本格式通过实现便捷的版本控制和审计，同时与 AI 处理高度兼容，从而提高了这种效率。

Beancount.io 团队的实际成果​

一家中型会计师事务所此前手动对账每个客户账户需要五个小时。在实施 AI 驱动的纯文本记账后，他们在一小时内完成了同样的工作。他们的财务总监指出：“该系统能够发现我们可能遗漏的差异，同时让我们能够专注于分析。”

一家快速增长的科技初创公司面临不断增长的交易量，这可能使其财务团队不堪重负。在采用 AI 对账后，处理时间减少了约 75%，从而可以将资源重新分配到战略规划。

根据我们的第一手经验，AI 驱动的会计解决方案由于其强大的自动化检测和纠正功能，显著减少了错误。

自动化对账实施指南​

首先，选择与 Beancount.io 无缝集成的 AI 工具，例如 OpenAI 的 GPT 模型或 Google 的 BERT。通过标准化交易格式和类别来准备您的数据——根据我们的经验，适当的数据标准化能极大地提高 AI 性能。

开发自动化脚本，利用 Beancount 的灵活性来识别差异并交叉引用数据。专门针对异常检测训练 AI 模型，以捕捉人类审查员可能遗漏的细微模式，例如可能指示系统性问题的重复逾期付款。

与您的团队建立定期的绩效评估和反馈循环。这种迭代方法有助于 AI 系统从经验中学习，同时建立对自动化流程的信任。

超越时间节省：提升准确性和审计就绪度​

AI 对账通过自动化交叉验证最大限度地减少人为错误。德勤的研究表明，使用 AI 进行财务流程的公司，会计差异减少了 70%。该系统维护详细的审计追踪，使审计师更容易验证交易。

一家饱受频繁对账错误困扰的科技公司，在实施 AI 工具后，审计成本有所下降。该系统持续学习的能力意味着随着处理更多交易，准确性会随时间提高。

结论​

AI 驱动的对账从根本上改变了财务运营，既提高了效率，又增强了准确性。使用 Beancount.io 的组织表明，自动化工作流在减少对账时间的同时，也增强了数据完整性。

随着财务复杂性的增加，手动对账变得越来越不可持续。拥抱 AI 驱动的纯文本记账的组织将在速度、准确性和战略能力方面获得优势。

考虑从 Beancount.io 的单个账户开始，体验现代化工具如何提升您的财务工作流。

关于 Beancount.io

Beancount.io 是一个强大的开源复式记账系统，受到金融专业人士、开发者和个人理财爱好者的信赖。它专为清晰、可扩展和精确而设计，帮助用户通过纯文本记账、强大验证和无缝集成来管理复杂的财务数据。自推出以来，它让用户完全掌控自己的财务，自动化报告，并维护透明、可审计的记录——使其成为那些重视简洁而不妥协的人们的最爱。

Beancount.io 标志