跳转到正文

Beancount 客户端

将账本作为只读 SQL 表查询,或通过 rledger 使用 BQL 查询,并在您自己的文本编辑器中编辑账本。

概览

查询语言
SQL
驱动
首次使用时下载
连接方式
文件
Mac 上的 TablePro 打开了一个 Beancount 账本,侧边栏中显示其表,并显示一个 BQL 查询结果。

打开账本

安装 rledger 或 Python Beancount。两者都有时优先使用 rledger,且只有 rledger 支持 BQL 和 diagnostics 中的验证输出。

通过 浏览… (Browse…) 选择账本,或从 Finder 打开 .beancount 文件:路径就是连接的全部内容,也可导入 beancount:///path/to/main.beancount URL。从 Finder 打开的应用不会继承您 shell 的 PATH,因此如果后端在 Terminal 中能运行,在这里却不能,请用 launchctl setenv TABLEPRO_RUSTLEDGER_BINARY 或 TABLEPRO_BEANCOUNT_PYTHON 指定它,然后重新启动应用。

Python 后端会运行 Beancount 附带的插件,并跳过其他 plugin 指令(它们属于第三方代码),直到您为该连接开启 运行账本插件 (Run Ledger Plugins)。跳过的插件会列在 diagnostics 中。

查询账本

交易、分录、账户、余额、价格、指令、元数据和源文件都是表:按 transaction_id 联接分录与交易,按名称联接账户。金额以记账后的形式返回,算术、成本和价格均已解析,分录成本和行内价格有各自的列。

交易、分录和若干指令表带有 source_location,例如 main.beancount:42,因此每行都能追溯到其源文件行。在查询前加上 BQL: 即可将其发送给 rledger;结果支持浏览、行数和分页,但不支持 SQL 参数。

include 指令会被跟随,具体路径和 glob 均可,所有账本文件和引用的文档都会被监控,因此下次查询无需重新连接即可读取已保存的更改。连接始终处于 Safe Mode Read-Only:INSERT、UPDATE、DELETE 和结构更改都会被拒绝。

本页介绍 Beancount 特有的内容。Safe Mode、AI 助手、MCP 服务器以及 TablePro 的其他功能请见功能页面。

其他

  • 移动数据

    将表或查询结果导出为 CSV、JSON、SQL、XLSX、Markdown、HTML 和 XML。TablePro 可作为数据库打开的其他文件包括 SQLite、DuckDB 和 Parquet。

  • 限制

    • TablePro 打开账本时,将其读取到 23 张只读 SQL 表中,不会写回账本。
    • 需要在此 Mac 安装 rledger 或 Python beancount。
  • 有错误的账本还能打开吗?

    通过 rledger 可以。即使验证失败,账本仍会映射为表,每个问题都是 diagnostics 中的一行,包含文件、行号、严重程度和消息。

  • 一个连接能打开多个账本吗?

    一个连接对应一个账本文件,无法切换。如果主文件 include 了其他文件,它们会全部加载,glob 也包括在内。

获取 TablePro

本页功能全部免费。