蜜蜂记账(BeeCount) English
你的数据,你做主的开源记账应用
支持 BeeCount Cloud 自建云端 / iCloud / Supabase / WebDAV / S3 五种同步方案
🌐 官网 · 📖 文档 · 💝 捐赠 · 🤝 商务合作 · 💬 Telegram · 📦 APK · 🚀 TestFlight
🤖 新:MCP 支持 — 搭配 BeeCount Cloud,用 LLM 直接管账本。
💡 为什么选择蜜蜂记账
一款轻量、开源、隐私可控的个人财务管理和支出追踪 App。
| 传统记账应用 | 蜜蜂记账 |
|---|---|
| ❌ 数据存第三方,无法审计 | ✅ 完全开源,代码可审计 |
| ❌ 隐私可能被分析利用 | ✅ 离线优先 + 自建云端,开发者无法访问 |
| ❌ 服务商倒闭数据丢失 | ✅ 数据主权,5 种同步方案任选 |
| ❌ 高级功能付费墙 | ✅ 完全免费(包括 AI / OCR / 语音记账) |
| ❌ 广告 / 理财推荐 | ✅ 零广告 / 零追踪 / 零数据收集 |
平台支持:🤖 Android 6.0+(GitHub APK)/Android 7.0+(Google Play) · 🍎 iOS 15.5+ · 🌐 Web(BeeCount Cloud 自带,见下文)
📱 HarmonyOS — 已停止更新
🌟 核心功能
🤖 AI 智能记账 — AI 对话 / OCR / 语音 / 截图自动识别
- AI 小助手 — 自然语言对话记账,智能理解意图,基于智谱 GLM-4
- OCR 拍照记账 — 双引擎(本地 TFLite + GLM 云端),识别支付宝/微信/云闪付截图
- 语音记账 — 按住说话,GLM 模型理解口语化表达("今天买菜花了 50 块")
- 截图自动记账 — Android 无障碍服务监听 / iOS 快捷指令双击背部触发
📝 基础记账 — 多账本 / 多账户 / 二级分类 / 预算 / 周期记账 / 标签 / 图表 / 导入导出
- 多账本 — 生活/工作/投资分开管理,每本独立币种
- 多账户 — 现金/银行卡/信用卡等独立账户,转账自动更新双方余额
- 二级分类 — 父子分类层级
- 预算管理 — 月度总预算 + 分类预算 + 超支提醒
- 周期记账 — 每日/每周/每月/每年自动记账,适合固定收支
- 标签系统 — 多标签 + 颜色标记,灵活筛选
- 图表分析 — 月度报表 / 分类排行 / 趋势分析 / 年度报告
- 数据导入导出 — CSV(支付宝/微信账单)+ YAML 配置导出
🎨 体验 — 暗黑模式 / 多语言 / 桌面小组件 / 主题装扮
- 暗黑模式 — 纯黑 + 主题色边框,OLED 友好
- 多语言 — 官方简中 / 繁中 / English,社区贡献韩语,本地化日期/数字格式
- 桌面小组件 — 8 类内容、14 种规格(收支速览/净资产/快速记账/预算/最近交易/仪表盘/消费节奏/记账连续蜂迹),暗黑/多语言/主题色全跟随,全家福预览
- 主题装扮 — 多主题色
📸 截图预览
桌面小组件
8 类内容、14 种规格,不打开 App 也能看账、一点直达记账:
查看桌面小组件全家福(8 类、14 规格)
更多截图（主要功能 / 暗黑模式）
9 大功能主题
暗黑模式
☁️ 云同步方案
蜜蜂记账提供 5 种同步方案,所有方案数据完全由你掌控,详细配置教程见 docs/cloud-setup.md。
| 方案 | 适用场景 | 特点 |
|---|---|---|
| BeeCount Cloud | 多端实时协同 + 自托管 + 多人共账 | Docker 一键、秒同步、自带 Web 端、多用户、共享账本 |
| iCloud | iOS 单平台用户 | 零配置、原生集成 |
| Supabase | 无 NAS 的跨平台用户 | 免费额度充足、配置简单 |
| WebDAV | NAS 用户 | 数据本地化、群晖/绿联云/Nextcloud |
| S3 协议 | 灵活云存储 | Cloudflare R2 / AWS S3 / MinIO,免费额度大 |
🔐 为什么自建? 隐私第一、成本可控、数据安全、开源可审计。所有同步代码开源。
🆕 BeeCount Cloud 自建云
多端实时秒级同步 + Web 管理端 + 多用户独立 + AES-256 加密备份 — 推荐有 NAS / VPS / Docker 环境的用户。
核心能力
- 📱 多设备实时协同 — 手机 A 改一笔,手机 B 和 Web 几秒内看到(WebSocket 推送)
- 🌐 自带 Web 管理端 — 一个 Docker 镜像 = server + web,浏览器直接打开服务器地址即用
- 👥 多用户独立 — 一个服务器多人注册,数据互相隔离
- 🤝 共享账本 — Owner 一键生成邀请码,家人 / 团队加入同一本,Owner / Editor 双角色,实时同步 + 每笔交易标记"谁记的 / 谁编辑的" + 成员收支统计(三端等价)
- 🔐 AES-256 加密备份 — 多远端 fan-out(R2 / S3 / WebDAV / B2),备份用 AES zip 加密,丢失服务也能用标准解压工具自助恢复
部署 + 完整文档
完整 Docker Compose 部署教程、备份系统、PWA、运维细节都在 Cloud 仓库:
👉 BeeCount-Cloud 仓库 — 一键 Docker 部署 + 完整文档
Web 管理端预览
💰 首页：收支、资产构成、分类热力、趋势与排行榜完整展示（浅色模式）
更多 Web 截图
📒 交易列表:关键字 / 分类 / 账户 / 日期 / 标签多维筛选
💳 账户余额、资产构成与负债总览
🧾 完整小票预览、关联流水、缩放与原件下载
🛠️ 开发指南
技术栈 + 快速开始
技术栈
- Flutter 3.27+ · 跨平台 UI 框架
- Riverpod · 状态管理
- Drift (SQLite) · 本地数据库 ORM
- Supabase / 自建 BeeCount Cloud / WebDAV / S3 · 云端同步多方案
快速开始
# 安装依赖 flutter pub get # 代码生成 dart run build_runner build --delete-conflicting-outputs # 运行应用 flutter run --flavor dev # 构建发布 flutter build apk --flavor prod --release
更多开发规范见 docs/contributing/CONTRIBUTING_ZH.md。
🤝 贡献
欢迎所有形式的贡献
快速开始:Fork → 创建 feature 分支 → 提交 → PR。详细规范见 完整贡献指南。
🎨 皮肤
贡献一款顶部皮肤
「主题色 + 皮肤 = 顶部头图」。皮肤分代码皮肤(CustomPainter 画渐变 / 几何,跟随主题色)和图片皮肤(SVG,BoxFit.cover 铺满头部,可整幅染成主题色)两类。
最简单的方式:照着 example_skin.svg 画一张 SVG → 丢进 assets/header_skins/ → 在 lib/styles/header_skins.dart 注册一条 → 加 i18n 名跑 flutter gen-l10n。
完整规范(SVG 要求 + 主题色着色 + 接入步骤)见 assets/header_skins/README.md。
💬 常见问题
查看常见问题解答
Q: 不配置云服务能正常使用吗? A: 完全可以!应用默认本地存储,所有功能都能正常使用。可随时导出 CSV 备份。
Q: 应该选哪个云方案? A:
- iOS 单设备 → iCloud(零配置)
- 跨平台 + 多端实时协同 → BeeCount Cloud(自托管,推荐)
- 跨平台无 NAS → Supabase / S3
- 有 NAS → WebDAV
Q: 如何确保数据安全? A: 使用自己的服务器 / Storage / Bucket,WebDAV 和 S3 建议 HTTPS 加密传输。BeeCount Cloud 备份默认 AES-256 加密。
更多详情见 docs/cloud-setup.md 或 Issues。
💝 捐赠支持
BeeCount 和 BeeCount Cloud 由同一作者维护。如果这些项目对你有帮助，欢迎请作者喝杯咖啡 ☕，支持持续开发。
捐赠方式
支付宝 / 微信二维码
| 支付宝 | 微信支付 |
|---|---|
 |
 |
USDT
币安 Pay（币安 App 内扫码转账）：
链上 USDT（TRC20）——任意 TRON 钱包扫码：
地址：TKBV69B2AoU67p3vDhnJUbMJtZ1DxuUF5C
感谢支持者
 ¥720 |
 ¥150 |
 ¥98 |
 ¥66 |
 ¥50 |
 ¥30 |
 ¥15 |
 ¥15 |
 ¥12 |
 ¥10 |
 ¥10 |
 ¥6 |
 ¥5 |
💡 已捐赠?提交信息 展示在支持者列表中。
🤝 商务合作
欢迎商业授权、部署协助、定制开发与合作咨询。请邮件联系，并简要说明你的需求与使用场景。
📄 开源协议
本项目采用 商业源代码许可证(Business Source License,BSL)。
| 用途 | 许可 |
|---|---|
| ✅ 个人使用 / 学习研究 / 开源贡献 | 完全免费 |
| ❌ 商业使用 | 需要付费授权 |
什么算商业使用
- 将本软件作为商业产品或服务提供给客户
- 在盈利性组织中使用本软件
- 基于本软件开发商业产品
- 提供基于本软件的付费云服务
商业授权价格与购买流程见 COMMERCIAL_LICENSE.md，或邮件联系 sunxiaoyes@outlook.com。详见 LICENSE。
📦 相关仓库
| 仓库 | 说明 |
|---|---|
| BeeCount-Cloud | 自建云同步服务端 + Web 管理端(FastAPI + React) |
| BeeCount-Website | 官网 / 文档仓库 |
| beecount-openharmony | 鸿蒙版本(已停止更新) |
| honeycomb | Claude Code 开发脚手架插件市场(本项目开发用的 skills/agents 集合) |
🙏 致谢
感谢 果核剥壳 - 互联网的净土、星之墨辰 对本项目的宣传。
感谢所有为蜜蜂记账项目贡献代码、提出建议和反馈问题的朋友们!
如有问题或建议,欢迎在 Issues 中提出,或在 Discussions 中参与讨论。
蜜蜂记账 🐝 — 让记账变得简单而安全