TNT-Likely / BeeCount

# 蜜蜂记账(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** · 云端同步多方案
### 快速开始
 [code] 
更多开发规范见 docs/contributing/CONTRIBUTING_ZH.md。
---
## 🤝 贡献
 欢迎所有形式的贡献 
- 🐛