一人公司和小团队想把账记规范,又不想把发票和流水交给云端记账平台?BeanDesk 把账本和凭证都留在自己电脑上,再让 AI 助手按规则帮你录账和核对。
本文介绍 BeanDesk 是什么、能做什么,怎样安装、建第一本账、接上 AI 助手,以及它和 Fava、云记账软件的区别。项目信息于 2026 年 10 月 11 日查阅 GitHub 仓库、README 和随仓库发布的使用手册。
BeanDesk 是什么
BeanDesk(中文名“经营账本”)是一款开源的复式记账桌面软件,作者 SuperDaniel-cn,2026 年 10 月 1 日在 GitHub 创建仓库,采用 AGPL-3.0 协议,完全免费。截至查阅时仓库约 12 颗星,最新版本是 10 月 10 日发布的 v0.2.7,更新很频繁。
它的底层是开源记账工具 Beancount 和它的网页界面 Fava:账本是普通的文本文件,BeanDesk 负责把它变成试算平衡表、资产负债表、利润表和现金流量表。软件没有云端账号,也不需要自己搭数据库,账本和发票、回单等原始凭证都存在你选定的本地文件夹里。
作者给它的定位是“本地化的 AI 财税副手”,面向一人有限责任公司、独立创作者和微型团队,帮不懂财税的人把账做规范。

它解决什么痛点
- 复式记账门槛高:借贷、科目、现金流分类,自己学很费劲,记错了到报税时才发现。
- 数据放在云端不放心:在线记账平台要上传发票和银行流水,账目全在别人服务器上。
- Excel 记账出不了正规报表:流水能记,但资产负债表、现金流量表要自己算,还容易对不平。
- 凭证东一张西一张:发票 PDF、银行回单散在下载目录和聊天记录里,回头查账找不到依据。
主要功能
以下内容来自 README 和项目使用手册:
- 试算平衡与经营大盘:一屏看收入、费用、资产和负债,自动校验借贷是否平衡,可按年、季、月切换。
- 标准三张表:即时生成资产负债表、利润表和现金流量表,利润表和现金流量表还能显示上年同期对比。
- 凭证穿透:在日记账里点一笔交易,就能直接预览关联的发票或银行回单。
- BQL 查询:内置常用查询模板,也能写 Beancount 原生查询语句,结果可导出 CSV。
- 本机 MCP 服务:给 Cursor、Claude Desktop 这类本地 AI 客户端提供查账、看报表、语法和规则校验等工具(MCP 是让 AI 客户端调用外部工具的协议)。
- 备份:账本改动后自动做本地 Git 快照;还能用 restic 加密增量备份到另一块硬盘或 S3 兼容存储。
- 日历提醒:导入本机日历文件或订阅 HTTPS 日历,申报和付款节点到期前 7 天弹出提醒。
- 中文科目显示:按“英文前缀-中文名”的写法开科目,报表上就能显示“银行存款 · 基本户”这样的中文名称。

安装
BeanDesk 提供三个平台的安装包,到 GitHub 的 Releases 页面 下载:
- Windows:64 位安装程序(.exe)。
- macOS:Apple Silicon 和 Intel 两种 .dmg。
- Linux:x86_64 和 ARM64 的 .deb 与 .AppImage。
安装包自带记账引擎,不需要另外装 Python 或命令行工具。以 Debian/Ubuntu 为例,下载 .deb 后在终端里执行:
sudo apt install ./BeanDesk_0.2.7_amd64.deb
版本号以下载到的文件为准。
用法:从建第一本账到让 AI 录账
1. 新建账本
- 打开软件,进入“设置 → 账本连接”,选一个空文件夹。为了防止误覆盖,文件夹不为空时软件不允许初始化。
- 点“初始化企业账套”,在弹窗里选会计准则和记账币种(默认简体中文、人民币)。
- 点“连接”,内置引擎会在本机启动服务,默认地址是 127.0.0.1:5000。
初始化后,文件夹里会生成主账本文件、科目和币种配置、按月存放分录的数据目录、凭证目录,以及一套记账规范文档。
如果你已经在用 Beancount,直接选现有账本目录打开即可;想用备份功能,再点“接管为标准账套”,它只补齐缺失的规范文件,不会改动已有分录。
2. 记一笔账
BeanDesk 本身是“看账”的界面,不提供网页里的分录编辑器。记账有两种方式:
- 手动:用文本编辑器打开当月的 .bean 文件,按手册里的格式写分录,把发票按科目放进凭证目录。
- 交给 AI:让能读写本机文件的 AI 助手来写,见下一步。
一笔分录大致长这样(摘自官方手册):
2026-03-15 * "XX科技有限公司" "企业架构咨询服务费"
Income:Service-主营业务收入:Consulting-架构咨询服务 -20000.00 CNY
Assets:Bank-银行存款:Main-基本户 20000.00 CNY
3. 接上 AI 助手
- 在“设置 → 常规设置”里点“复制配置”,得到 MCP 服务的配置。
- 把它加进 Cursor、Claude Desktop 等本地 AI 客户端的 MCP 设置里。
- 之后就可以说“这张发票帮我入账”,AI 会读取账本里的记账规范,把凭证归档到对应目录,写好分录,再调用校验工具检查语法、借贷平衡和科目命名规则。
要注意两点。第一,手册写明只有能写入本地文件夹的 AI 客户端才能记账,只能收图片的网页聊天窗口不行。第二,如果用的是云端大模型,发票内容会随对话发给模型厂商;想让凭证完全不出本机,要用本地模型。
校验通过只说明格式和规则对得上,手册也强调这不构成税务鉴定,拿不准的业务仍要问会计。

4. 设置备份
在“设置 → 数据备份”里打开 Git 自动快照,再设一个加密口令和备份目的地,就能把账本、凭证一起加密备份。口令一定要记好,手册写明遗失后无法解密历史备份。

想在手机上看账:放到 VPS 上
BeanDesk 也能连接远程的 Fava 服务。仓库里的部署文档给了一个做法:在 VPS 上运行 Fava 并只监听本机,再用 Cloudflare Tunnel 加 Access 邮箱验证码对外开门,云服务器的入站规则不放行账本端口。这样出差时用手机浏览器也能查报表。
pip install fava
fava --host 127.0.0.1 --port 5000 main.bean
文档特别提醒,Fava 本身没有登录功能,账本端口绝不能直接暴露到公网。把账本放上服务器,也就不再是“只在自己电脑上”,要自己权衡。
优缺点
优点:
- 数据自己保管:没有中心服务器,账本是可读的文本文件,不怕平台倒闭或涨价。
- 报表规范:三张表、试算平衡、同比一步到位,现金流量表按直接法生成。
- AI 录账有规则约束:AI 按账套里的规范写分录,再经过本地规则校验,比让 AI 随手记更可靠。
- 免费开源:AGPL-3.0,三个平台都有安装包。
缺点:
- 项目很新:10 月初才开源,星数不多,版本迭代快,可能有变动和问题。
- 仍要懂一点记账:科目怎么开、分录怎么写,至少要能看懂 AI 写了什么。
- 没有内置分录编辑:不用 AI 时得手改文本文件,对不熟悉的人不太友好。
- AI 部分要自己配:需要支持 MCP、能写本地文件的客户端,模型费用另算。
适合谁
- 一人公司、个体户、独立开发者,想自己记账,至少能出规范报表给记账公司或自己看。
- 已经在用 Beancount 和 Fava,想要更好看的报表和凭证管理的人。
- 在用 Cursor、Claude Desktop 等 AI 工具,愿意折腾一次配置,让 AI 帮忙录账的人。
不太适合完全不懂记账、只想拍照上传就出结果的用户,也不能替代正式的报税服务。
和同类工具对比
| 对比项 | BeanDesk | Fava | 在线记账平台 | Excel 记账 |
|---|---|---|---|---|
| 数据位置 | 本地文件夹 | 本地或自己的服务器 | 平台服务器 | 本地文件 |
| 价格 | 免费开源 | 免费开源 | 多为订阅收费 | 软件自带 |
| 三张报表 | 中文对公格式 | 有,偏通用格式 | 有 | 要自己做 |
| 凭证关联 | 点开分录直接预览 | 支持 | 支持 | 手工管理 |
| AI 录账 | 通过本机 MCP | 无内置 | 视平台而定 | 无 |
| 上手难度 | 中等 | 偏高 | 低 | 低 |
简单说:只想省事、不在乎数据放在哪,在线记账平台最方便;习惯 Beancount 的人,BeanDesk 可以当成一个更适合中国小企业的报表界面;想用 AI 记账又要数据留在本地,BeanDesk 目前是少有的选择。
服务器推荐
只有想远程看账时才需要服务器,跑一个 Fava 对配置要求很低。以下是官网入门标价(2026 年 10 月 9 日查阅):
- RackNerd:入门 26.99 美元/年,1 核、512 MB 内存、30 GB SSD,只跑 Fava 足够。RackNerd 官网
- CloudCone:28 美元/年起,2 核、1 GB 内存、30 GB SSD,也有按小时计费的套餐,可以先试。CloudCone 官网
- 搬瓦工:入门款 49.99 美元/年(1 GB 内存、20 GB SSD),老牌商家,稳定性好,适合长期存放重要数据。搬瓦工官网
便宜套餐多是限量款,可能随时售罄或调价,下单前以官网实时价格为准。
项目信息
| 项目 | 信息 |
|---|---|
| 名称 | BeanDesk(经营账本) |
| 作者 | SuperDaniel-cn |
| GitHub | SuperDaniel-cn/BeanDesk |
| 开源协议 | AGPL-3.0 |
| 价格 | 免费 |
| 最新版本 | v0.2.7(2026-10-10) |
| 支持平台 | Windows 64 位、macOS(Apple Silicon / Intel)、Linux(x86_64 / ARM64) |
| 技术栈 | Tauri 2、React、TypeScript,底层为 Beancount 与 Fava |
| GitHub 星数 | 约 12(2026-10-11) |


