{"id":33422210,"url":"https://github.com/tnt-likely/beecount","last_synced_at":"2026-04-03T15:04:43.127Z","repository":{"id":314141104,"uuid":"1051440251","full_name":"TNT-Likely/BeeCount","owner":"TNT-Likely","description":"🐝 开源记账App，支持iCloud/自建服务器同步(Supabase/WebDAV/S3)，AI智能记账 | Open-source finance tracker with iCloud \u0026 self-hosted sync (Supabase/WebDAV/S3), AI-powered bookkeeping, cross-platform, privacy-first","archived":false,"fork":false,"pushed_at":"2026-03-23T12:55:33.000Z","size":74300,"stargazers_count":1298,"open_issues_count":57,"forks_count":175,"subscribers_count":7,"default_branch":"main","last_synced_at":"2026-03-24T08:38:17.799Z","etag":null,"topics":["account","accounting","accounting-app","chinese","expense-tracker","finance-app","flutter","money-management","offline-first","personal-finance","privacy-first","self-hosted","supabase","webdav"],"latest_commit_sha":null,"homepage":"","language":"Dart","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/TNT-Likely.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"docs/contributing/CONTRIBUTING_EN.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"github":"TNT-Likely","open_collective":"beecount","custom":["https://paypal.me/sunxiaoyes","https://afdian.com/a/sunxiaoyes"]}},"created_at":"2025-09-06T02:15:06.000Z","updated_at":"2026-03-24T03:50:04.000Z","dependencies_parsed_at":"2026-01-04T01:02:53.889Z","dependency_job_id":null,"html_url":"https://github.com/TNT-Likely/BeeCount","commit_stats":null,"previous_names":["tnt-likely/beecount"],"tags_count":118,"template":false,"template_full_name":null,"purl":"pkg:github/TNT-Likely/BeeCount","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TNT-Likely%2FBeeCount","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TNT-Likely%2FBeeCount/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TNT-Likely%2FBeeCount/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TNT-Likely%2FBeeCount/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/TNT-Likely","download_url":"https://codeload.github.com/TNT-Likely/BeeCount/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TNT-Likely%2FBeeCount/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31359104,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-03T14:24:47.623Z","status":"ssl_error","status_checked_at":"2026-04-03T14:24:32.380Z","response_time":107,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["account","accounting","accounting-app","chinese","expense-tracker","finance-app","flutter","money-management","offline-first","personal-finance","privacy-first","self-hosted","supabase","webdav"],"created_at":"2025-11-24T02:03:06.329Z","updated_at":"2026-04-03T15:04:43.023Z","avatar_url":"https://github.com/TNT-Likely.png","language":"Dart","funding_links":["https://github.com/sponsors/TNT-Likely","https://opencollective.com/beecount","https://paypal.me/sunxiaoyes","https://afdian.com/a/sunxiaoyes"],"categories":[],"sub_categories":[],"readme":"# 蜜蜂记账（BeeCount）\n\n\u003cdiv align=\"center\"\u003e\n\n![GitHub stars](https://img.shields.io/github/stars/TNT-Likely/BeeCount?style=social)\n![License](https://img.shields.io/badge/license-商业源代码许可-orange.svg)\n![Platform](https://img.shields.io/badge/platform-Android%20%7C%20iOS-lightgrey.svg)\n![Flutter](https://img.shields.io/badge/Flutter-3.27%2B-02569B?logo=flutter)\n![Maintenance](https://img.shields.io/badge/Maintained%3F-yes-green.svg)\n\n**你的数据，你做主的开源记账应用**\n\n**核心优势：支持 iCloud/自建 Supabase/WebDAV/S3 协议服务器，数据完全掌控在你手中**\n\n\u003cbr/\u003e\n\n\u003ca href=\"https://apps.apple.com/app/id6754611670\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/App_Store-Download-000000?style=for-the-badge\u0026logo=app-store\u0026logoColor=white\" alt=\"Download on App Store\" height=\"50\"/\u003e\n\u003c/a\u003e\n\u003ca href=\"https://play.google.com/store/apps/details?id=com.tntlikely.beecount\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Google_Play-Download-414141?style=for-the-badge\u0026logo=google-play\u0026logoColor=white\" alt=\"Get it on Google Play\" height=\"50\"/\u003e\n\u003c/a\u003e\n\u003ca href=\"https://testflight.apple.com/join/Eaw2rWxa\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/TestFlight-Beta-0D96F6?style=for-the-badge\u0026logo=app-store\u0026logoColor=white\" alt=\"Join TestFlight\" height=\"50\"/\u003e\n\u003c/a\u003e\n\u003ca href=\"https://github.com/TNT-Likely/BeeCount/releases/latest\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Android-APK-3DDC84?style=for-the-badge\u0026logo=android\u0026logoColor=white\" alt=\"Download Android APK\" height=\"50\"/\u003e\n\u003c/a\u003e\n\n\u003cbr/\u003e\n\u003cbr/\u003e\n\n[🌐 官网](https://beecount-website.pages.dev) | [📖 使用文档](https://beecount-website.pages.dev/docs/intro) | [💝 捐赠支持](#-捐赠) | [💬 Telegram](https://t.me/beecount) | [🌐 English](README_EN.md)\n\n\u003c/div\u003e\n\n---\n\n\u003e ## 📱 平台支持\n\u003e\n\u003e 🤖 **Android** - [Google Play](https://play.google.com/store/apps/details?id=com.tntlikely.beecount) | [下载 APK](https://github.com/TNT-Likely/BeeCount/releases/latest) | 支持 Android 5.0+\n\u003e\n\u003e 🍎 **iOS** - [App Store](https://apps.apple.com/app/id6754611670) | [TestFlight 公测版](https://testflight.apple.com/join/Eaw2rWxa) | 支持 iOS 15.5+\n\u003e\n\u003e 💡 在 App Store 或 Google Play 搜索 **\"蜜蜂记账 - 简洁记账本\"** 即可下载\n\u003e\n\u003e ~~📱 **HarmonyOS** - 已停止更新，不再上架~~ | [鸿蒙版本仓库](https://github.com/TNT-Likely/beecount-openharmony)\n\n---\n\n## 💡 为什么选择蜜蜂记账？\n\n\u003ctable\u003e\n\u003ctr\u003e\n\u003ctd width=\"50%\"\u003e\n\n### 🔒 传统记账应用的问题\n\n- ❌ 数据存储在第三方服务器\n- ❌ 隐私无法保证，可能被分析利用\n- ❌ 服务商倒闭数据可能丢失\n- ❌ 高级功能需要付费订阅\n- ❌ 强制广告和理财产品推荐\n- ❌ 闭源软件，无法审计代码\n\n\u003c/td\u003e\n\u003ctd width=\"50%\"\u003e\n\n### ✅ 蜜蜂记账的优势\n\n- ✅ **自建服务器**，数据完全自主\n- ✅ **开源透明**，代码可审计\n- ✅ **离线优先**，无网也能用\n- ✅ **个人免费**，无广告无付费墙（包括自动记账等核心功能）\n- ✅ **隐私保护**，开发者无法访问你的数据\n- ✅ **源代码公开**，代码可审计\n\n\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/table\u003e\n\n一款轻量、开源、隐私可控的**个人财务管理**和**支出追踪** App，支持 iOS/Android 双平台。内置完整的账本管理、**收支记录**、**OCR 图片识别**、**拍照记账**、**语音记账**、**截图自动记账**、**账户转账**、**二级分类**、分类统计、**图表分析**、数据导入导出功能，并支持 iCloud（iOS）/自建 Supabase/WebDAV/S3 协议（Cloudflare R2/AWS S3/MinIO 等）云服务器同步。支持**多语言**（简繁中文/英文）和**暗黑模式**，适合注重隐私的个人和家庭进行日常**费用记录**和**收支管理**。\n\n## 📱 核心功能展示\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"demo/videos/zh/01-add-transaction.gif\" alt=\"快速记账\" width=\"200\" /\u003e\n  \u003cimg src=\"demo/videos/zh/02-ocr-recognition.gif\" alt=\"🤖 AI OCR 智能识别\" width=\"200\" /\u003e\n  \u003cimg src=\"demo/videos/zh/03-import-ledger.gif\" alt=\"数据导入\" width=\"200\" /\u003e\n  \u003cimg src=\"demo/videos/zh/04-data-analysis.gif\" alt=\"📊 数据分析\" width=\"200\" /\u003e\n\u003c/div\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e📸 查看更多截图\u003c/summary\u003e\n\n### 数据管理功能\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"demo/preview/zh/02-search.png\" alt=\"智能搜索\" width=\"200\" /\u003e\n  \u003cimg src=\"demo/preview/zh/03-edit-transaction.png\" alt=\"编辑交易\" width=\"200\" /\u003e\n  \u003cimg src=\"demo/preview/zh/05-ledger-management.png\" alt=\"账本管理\" width=\"200\" /\u003e\n  \u003cimg src=\"demo/preview/zh/07-category-detail.png\" alt=\"分类详情\" width=\"200\" /\u003e\n\u003c/div\u003e\n\n### 个性化与管理\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"demo/preview/zh/06-profile.png\" alt=\"个人中心\" width=\"200\" /\u003e\n  \u003cimg src=\"demo/preview/zh/08-category-migration.png\" alt=\"分类迁移\" width=\"200\" /\u003e\n  \u003cimg src=\"demo/preview/zh/09-category-management.png\" alt=\"分类管理\" width=\"200\" /\u003e\n  \u003cimg src=\"demo/preview/zh/10-personalization.png\" alt=\"个性装扮\" width=\"200\" /\u003e\n\u003c/div\u003e\n\n### 数据导入导出\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"demo/preview/zh/12-import-confirm.png\" alt=\"导入确认\" width=\"200\" /\u003e\n\u003c/div\u003e\n\n### 🌙 暗黑模式\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"demo/preview/dark/01-home.png\" alt=\"首页-暗黑\" width=\"200\" /\u003e\n  \u003cimg src=\"demo/preview/dark/02-chart-analysis.png\" alt=\"图表分析-暗黑\" width=\"200\" /\u003e\n  \u003cimg src=\"demo/preview/dark/03-discover.png\" alt=\"发现-暗黑\" width=\"200\" /\u003e\n  \u003cimg src=\"demo/preview/dark/04-profile.png\" alt=\"我的-暗黑\" width=\"200\" /\u003e\n\u003c/div\u003e\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"demo/preview/dark/05-ai-chat.png\" alt=\"AI对话-暗黑\" width=\"200\" /\u003e\n\u003c/div\u003e\n\n\u003c/details\u003e\n\n## 🌟 核心特性\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003e查看核心特性\u003c/b\u003e\u003c/summary\u003e\n\n### ☁️ 自建云服务 - 核心差异化优势\n\n\u003e **这是蜜蜂记账最大的特色：数据完全由你掌控！**\n\n| 云同步方案 | 适用场景 | 特点 |\n|---------|---------|------|\n| **iCloud** | iOS 用户 | 🆕 零配置、原生集成、Apple 生态无缝同步 |\n| **Supabase** | 无 NAS 的用户 | 免费额度充足、配置简单、云端托管 |\n| **WebDAV** | 有 NAS 的用户 | 数据完全本地化、支持群晖/绿联云/Nextcloud |\n| **S3 协议** | 追求灵活性的用户 | 🆕 支持 Cloudflare R2/AWS S3/MinIO，免费额度大 |\n\n**为什么选择自建？**\n\n- 🔐 **隐私第一**：开发者无法访问你的数据\n- 💰 **成本可控**：Supabase/Cloudflare R2 免费额度够用，WebDAV 一次性投入\n- 🛡️ **数据安全**：不担心服务商倒闭或数据泄露\n- 🔓 **开源审计**：所有云同步代码开源，可审计\n\n[📖 查看云服务配置教程](#️-云备份配置可选)\n\n### 🔒 数据安全与隐私\n\n- **离线优先**：基于本地 SQLite，无网也能用\n- **开源透明**：源代码公开，代码可审计\n- **可选同步**：不配置云服务也能完整使用\n- **零追踪**：无统计、无广告、无数据收集\n\n### 📊 完整记账功能\n\n#### 🤖 AI 智能记账\n\n- **🤖 AI 小助手**（New!）\n  - **智能对话记账**：自然语言交互，智能理解记账意图\n  - **上下文记忆**：记住对话历史，支持连续对话\n  - **账单信息提取**：智能识别金额、商家、分类等信息\n  - **一键确认记账**：AI 提取信息后，确认即可完成记账\n  - 基于智谱 GLM-4 大模型，支持复杂语义理解\n\n- **📸 OCR 图片识别 / 拍照记账**\n  - 支持拍照或从相册选择支付截图\n  - AI 自动识别金额、商家、分类等账单信息\n  - 双引擎支持：本地 TFLite 模型 + GLM 云端模型\n  - 准确识别支付宝、微信支付、云闪付等主流支付方式\n\n- **🎤 语音记账**\n  - 按住说话，松手即完成记账\n  - GLM 语音模型智能理解自然语言\n  - 支持口语化表达，如：\"今天买菜花了50块\"\n  - 自动识别金额、分类、备注等信息\n\n- **⚡ 截图自动记账**\n  - **Android**：无障碍服务自动监听截图，支付后自动记账\n  - **iOS**：快捷指令集成，支持双击背部触发\n  - 智能识别支付宝、微信支付信息\n  - 自动创建账单，实时更新账本数据\n\n#### 📝 基础记账功能\n\n- **手动记账**：收入/支出分类、金额、日期、备注\n- **多账本管理**：生活、工作、投资分开管理\n- **独立账户管理**：支持现金、银行卡、信用卡等多种账户类型，每个账户独立记录余额\n- **账户转账功能**：支持账户间转账记录，自动更新双方账户余额\n- **二级分类系统**：支持父子分类层级，更细致的账单归类（可选择一级或二级分类模式）\n- **标签管理**（New!）：为交易添加自定义标签，支持多标签、颜色标记，灵活归类和筛选\n- **预算管理**（New!）：设置月度总预算和分类预算，实时追踪支出进度，超支提醒\n- **周期记账**（New!）：支持每日/每周/每月/每年自动记账，适合固定收支（房租、工资等）\n- **图表分析**：月度报表、分类排行、趋势分析\n- **数据导入导出**：CSV 格式，兼容主流应用；支持配置导入导出（YAML 格式）\n- **桌面小组件**：iOS/Android 桌面小组件，快速查看收支情况\n\n### 🎨 个性化与国际化\n\n- **暗黑模式**：完整的深色主题支持，护眼且 OLED 友好\n  - 纯黑背景 + 主题色点缀，极简高级感\n  - 所有页面、弹窗、键盘均已适配\n  - 跟随系统自动切换或手动设置\n- **主题装扮**：多种主题色彩，打造专属风格\n- **3 种语言**：简体中文、繁体中文、English\n  - 完整界面翻译 + 智能分类映射\n  - 本地化日期/数字格式\n  - CSV 导入自动识别多语言分类\n\n\u003e 💡 需要添加新语言？欢迎在 [Issues](https://github.com/TNT-Likely/BeeCount/issues) 中提出！\n\n\u003c/details\u003e\n\n## ☁️ 云备份配置（可选）\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003e📖 点击查看详细配置教程\u003c/b\u003e\u003c/summary\u003e\n\n### 为什么选择自建云服务？\n\n- **数据主权**：数据完全存储在你自己控制的服务器或云平台中\n- **隐私保护**：开发者无法访问你的任何数据\n- **成本可控**：大多数方案都提供免费额度或一次性购买\n- **稳定可靠**：不依赖第三方托管服务，自主掌控\n- **灵活选择**：根据自己的需求选择最合适的方案\n\n---\n\n### 方案一：iCloud（推荐 iOS 用户）🆕\n\n**适用场景**：iOS 用户，追求零配置、无缝同步体验\n\n**优势**：\n\n- ✅ **零配置**：无需任何设置，开箱即用\n- ✅ **原生集成**：使用 Apple ID 自动同步\n- ✅ **隐私保护**：数据存储在你的 iCloud Drive 中\n- ✅ **多设备同步**：iPhone、iPad 数据自动同步\n\n**使用方式**：\n\n1. 确保 iOS 设备已登录 iCloud 并开启 iCloud Drive\n2. 打开蜜蜂记账 → 个人中心 → 云服务\n3. 选择 **iCloud**，即可开始同步\n\n\u003e 💡 **提示**：iCloud 同步仅支持 iOS 设备。如果你需要跨平台同步（iOS + Android），请使用 Supabase 或 WebDAV。\n\n---\n\n### 方案二：Supabase（推荐新手）\n\n**适用场景**：适合没有 NAS 设备，想要快速开始的用户\n\n**配置步骤**：\n\n1. **创建 Supabase 项目**\n   - 访问 [supabase.com](https://supabase.com) 注册账号\n   - 创建新项目，选择合适的区域\n   - 在项目设置中获取 URL 和 anon key\n\n2. **配置 Storage**\n   - 在 Supabase 控制台创建名为 `beecount-backups` 的 Storage Bucket\n   - 设置为 Private（不勾选 Public bucket）\n   - **配置 RLS 访问策略**：需要创建 4 条策略，确保用户只能访问自己的数据\n     - 进入 bucket 的 Policies 标签页\n     - 分别创建以下 4 条策略（每条策略配置相同）：\n       - **SELECT**：允许用户读取自己的备份文件\n       - **INSERT**：允许用户创建新的备份文件\n       - **UPDATE**：允许用户更新自己的备份文件\n       - **DELETE**：允许用户删除自己的备份文件\n     - 每条策略的配置：\n       - **Policy name**: 可自定义（如 `Allow user access to own backups`）\n       - **Target roles**: 选择 `authenticated`\n       - **Policy definition**: 输入以下表达式\n\n         ```sql\n         ((bucket_id = 'beecount-backups'::text) AND ((storage.foldername(name))[1] = 'users'::text) AND ((storage.foldername(name))[2] = (auth.uid())::text))\n         ```\n\n       - 此策略确保用户只能访问 `beecount-backups/users/\u003c自己的用户ID\u003e/` 路径下的文件\n\n3. **应用内配置**\n   - 打开蜜蜂记账 → 个人中心 → 云服务\n   - 点击\"添加自定义云服务\"\n   - 选择服务类型：**Supabase**\n   - 填入你的 Supabase URL 和 anon key\n   - 保存并启用配置\n   - 点击\"登录\"，注册/登录账号后即可开始同步\n\n### 方案三：WebDAV 服务器（推荐有 NAS 的用户）\n\n**适用场景**：已有 NAS 设备或私有云存储的用户\n\n**支持的服务**：\n\n- ✅ 绿联云 NAS\n- ✅ 群晖 Synology NAS\n- ✅ Nextcloud\n- ✅ 坚果云 WebDAV\n- ✅ ownCloud\n- ✅ 其他支持 WebDAV 协议的服务器\n\n**配置步骤**：\n\n1. **启用 WebDAV 服务**\n   - 在 NAS 或云存储平台启用 WebDAV 功能\n   - 记录 WebDAV 服务器地址（如 `http://nas.local:5005`）\n   - 创建或使用现有的用户账号\n\n2. **准备存储目录**（可选）\n   - 在 WebDAV 根目录下创建 `BeeCount` 文件夹\n   - 或使用任意路径（配置时指定即可）\n\n3. **应用内配置**\n   - 打开蜜蜂记账 → 个人中心 → 云服务\n   - 点击\"添加自定义云服务\"\n   - 选择服务类型：**WebDAV**\n   - 填写配置信息：\n     - **WebDAV 服务器 URL**：如 `http://nas.local:5005`\n     - **用户名**：你的 WebDAV 用户名\n     - **密码**：你的 WebDAV 密码\n     - **远程路径**：存储路径（如 `/home/BeeCount` 或 `/BeeCount`）\n   - 点击\"测试连接\"验证配置\n   - 保存并启用配置\n   - WebDAV 无需额外登录，配置后即可直接同步\n\n**常见 WebDAV 配置示例**：\n\n```\n绿联云 NAS：\n- URL: http://你的NAS地址:5005\n- 远程路径: /home/BeeCount\n\n群晖 NAS：\n- URL: http://你的NAS地址:5005 或 https://你的域名\n- 远程路径: /BeeCount\n\n坚果云：\n- URL: https://dav.jianguoyun.com/dav/\n- 远程路径: /BeeCount\n```\n\n---\n\n### 方案四：S3 协议存储（推荐追求灵活性的用户）🆕\n\n**适用场景**：需要灵活选择云服务商，或想利用免费额度的用户\n\n**支持的服务**：\n\n- ✅ **Cloudflare R2**（推荐，10GB 免费存储）\n- ✅ **AWS S3**（全球最流行的对象存储）\n- ✅ **MinIO**（开源自建方案）\n- ✅ **阿里云 OSS**（兼容 S3 协议）\n- ✅ **腾讯云 COS**（兼容 S3 协议）\n- ✅ 其他兼容 S3 协议的对象存储服务\n\n**优势**：\n\n- ✅ **免费额度大**：Cloudflare R2 提供 10GB 免费存储\n- ✅ **灵活选择**：支持多家云服务商，随时切换\n- ✅ **标准协议**：S3 协议是业界标准，兼容性强\n- ✅ **性能优异**：CDN 加速，全球访问快速\n\n**配置步骤（以 Cloudflare R2 为例）**：\n\n1. **创建 R2 存储桶**\n   - 登录 [Cloudflare Dashboard](https://dash.cloudflare.com/)\n   - 进入 **R2** 服务\n   - 创建新存储桶（Bucket），如命名为 `beecount-backups`\n   - 记录存储桶名称\n\n2. **获取 API 凭证**\n   - 在 R2 页面点击 **Manage R2 API Tokens**\n   - 创建新的 API Token\n   - 权限选择 **Object Read \u0026 Write**\n   - 记录以下信息：\n     - **Access Key ID**（访问密钥）\n     - **Secret Access Key**（私密密钥）\n     - **Endpoint**（如 `\u003c账户ID\u003e.r2.cloudflarestorage.com`）\n\n3. **应用内配置**\n   - 打开蜜蜂记账 → 个人中心 → 云服务\n   - 点击\"添加自定义云服务\"\n   - 选择服务类型：**S3 协议存储**\n   - 填写配置信息：\n     - **端点地址**：Cloudflare R2 endpoint（不含 `https://`）\n     - **区域**：`auto`（R2 自动选择区域）\n     - **Access Key**：你的 Access Key ID\n     - **Secret Key**：你的 Secret Access Key\n     - **存储桶名称**：创建的存储桶名称（如 `beecount-backups`）\n     - **使用 HTTPS**：开启（推荐）\n     - **端口**：留空（使用默认端口）\n   - 点击\"测试连接\"验证配置\n   - 保存并启用配置\n   - S3 无需额外登录，配置后即可直接同步\n\n**其他 S3 服务配置示例**：\n\n```\nCloudflare R2：\n- 端点地址: \u003c账户ID\u003e.r2.cloudflarestorage.com\n- 区域: auto\n- 使用 HTTPS: 是\n\nAWS S3：\n- 端点地址: s3.amazonaws.com\n- 区域: us-east-1（根据你的存储桶区域填写）\n- 使用 HTTPS: 是\n\nMinIO（自建）：\n- 端点地址: minio.example.com\n- 区域: us-east-1 或 auto\n- 使用 HTTPS: 根据配置选择\n- 端口: 9000（或自定义端口）\n\n阿里云 OSS（S3 兼容模式）：\n- 端点地址: oss-cn-hangzhou.aliyuncs.com\n- 区域: oss-cn-hangzhou\n- 使用 HTTPS: 是\n```\n\n\u003e 💡 **提示**：\n\u003e\n\u003e - 端点地址请**不要**包含 `http://` 或 `https://` 前缀\n\u003e - Cloudflare R2 免费额度：10GB 存储 + 每月 1000 万次 A 类操作\n\u003e - S3 协议支持跨平台同步（iOS + Android）\n\n---\n\n### 后续计划\n\n我们将持续扩展云服务支持，计划添加：\n\n- 📦 Google Drive\n- 📦 Dropbox\n- 📦 OneDrive\n- 📦 更多...\n\n如果你希望优先支持某个云服务，欢迎在 [Issues](https://github.com/TNT-Likely/BeeCount/issues) 中提出需求！\n\n\u003c/details\u003e\n\n---\n\n## 🛠️ 开发指南\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003e查看开发指南\u003c/b\u003e\u003c/summary\u003e\n\n### 技术栈\n\n- **Flutter 3.27+**：跨平台 UI 框架\n- **Riverpod**：状态管理解决方案\n- **Drift (SQLite)**：本地数据库 ORM\n- **Supabase**：云端备份和同步服务\n\n### 快速开始\n\n```bash\n# 安装依赖\nflutter pub get\n\n# 代码生成\ndart run build_runner build --delete-conflicting-outputs\n\n# 运行应用\nflutter run --flavor dev\n\n# 构建发布版本\nflutter build apk --flavor prod --release\n```\n\n\u003c/details\u003e\n\n---\n\n## 🤝 贡献指南\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003e查看贡献方式\u003c/b\u003e\u003c/summary\u003e\n\n我们欢迎所有形式的贡献！\n\n- 🐛 [报告 Bug](https://github.com/TNT-Likely/BeeCount/issues/new)\n- 💡 [提出功能建议](https://github.com/TNT-Likely/BeeCount/discussions/new?category=ideas)\n- 💻 [贡献代码](docs/contributing/CONTRIBUTING_ZH.md#代码贡献流程)\n- 🌍 [贡献翻译](docs/contributing/CONTRIBUTING_ZH.md#翻译贡献)\n- 📝 [完善文档](docs/contributing/CONTRIBUTING_ZH.md#文档贡献)\n- 🎨 [设计师招募](docs/contributing/CONTRIBUTING_ZH.md#designer-recruitment)\n\n**快速开始**：\n\n1. Fork 本项目\n2. 创建特性分支 (`git checkout -b feature/AmazingFeature`)\n3. 提交更改 (`git commit -m 'feat: 添加某个功能'`)\n4. 推送到分支 (`git push origin feature/AmazingFeature`)\n5. 创建 Pull Request\n\n详细规范请参考[完整贡献指南](docs/contributing/CONTRIBUTING_ZH.md)。\n\n\u003c/details\u003e\n\n---\n\n## 💬 常见问题\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003e查看常见问题解答\u003c/b\u003e\u003c/summary\u003e\n\n\u003cbr/\u003e\n\n**Q: 不配置云服务能正常使用吗？**\nA: 完全可以！应用默认使用本地存储，所有功能都能正常使用。你仍可随时导出 CSV 进行备份。\n\n**Q: 应该选择 iCloud、Supabase、WebDAV 还是 S3？**\nA:\n\n- 如果你是 iOS 用户且只在 Apple 设备间同步，推荐使用 **iCloud**（零配置、原生集成）\n- 如果你需要跨平台同步（iOS + Android），推荐使用 **Supabase** 或 **S3**（免费、稳定、易配置）\n- 如果你有 NAS 设备或私有云，推荐使用 **WebDAV**（数据完全本地化）\n- 如果你想要灵活选择云服务商，推荐使用 **S3**（支持 Cloudflare R2/AWS S3/MinIO 等）\n\n**Q: 如何在多设备间同步数据？**\nA:\n\n- **iCloud**：iOS 设备登录同一 Apple ID，数据自动同步\n- **Supabase**：所有设备配置相同的 URL 和 anon key，登录同一账号\n- **WebDAV**：所有设备配置相同的 WebDAV 服务器地址和凭据\n- **S3**：所有设备配置相同的 S3 端点、Access Key 和存储桶名称\n\n**Q: 如何确保数据安全？**\nA:\n\n- 使用自己的 Supabase 项目、WebDAV 服务器或 S3 存储桶\n- 定期导出 CSV 备份到本地\n- WebDAV 和 S3 建议使用 HTTPS 加密传输\n- S3 的 Access Key 和 Secret Key 请妥善保管\n\n**Q: WebDAV 配置后为什么无法上传？**\nA:\n\n- 检查 WebDAV 服务是否启用且端口正确\n- 确认用户名和密码正确\n- 某些 NAS 的 WebDAV 需要在特定路径下才能写入（如绿联云需要 `/home/` 路径）\n- 点击\"测试连接\"按钮查看详细错误信息\n\n**Q: S3 配置后为什么连接失败？**\nA:\n\n- 确认端点地址**不包含** `http://` 或 `https://` 前缀\n- 检查 Access Key 和 Secret Key 是否正确\n- 确认存储桶名称拼写正确\n- 检查存储桶区域是否匹配（AWS S3 需要准确区域，Cloudflare R2 使用 `auto`）\n- 点击\"测试连接\"按钮查看详细错误信息\n\n\u003e 💡 更多问题请访问 [Issues](https://github.com/TNT-Likely/BeeCount/issues) 或 [Discussions](https://github.com/TNT-Likely/BeeCount/discussions)\n\n\u003c/details\u003e\n\n---\n\n## 💝 捐赠\n\n### 为什么需要您的支持？\n\n蜜蜂记账是**完全免费开源**的项目，没有任何广告和付费功能。为了保持项目的持续运营，我们需要您的支持。\n\n您的捐赠将直接用于：\n\n- 📱 **续费 Apple 开发者账号** - 保持 iOS TestFlight 公测可用（$99/年）\n- 🔧 **维护项目持续开发** - 支持持续开发和维护\n\n### 捐赠方式\n\n#### 🌍 国际用户\n\n- **PayPal**: \u003chttps://paypal.me/sunxiaoyes\u003e\n\n#### 🇨🇳 中国用户\n\n\u003cdetails\u003e\n\u003csummary\u003e点击查看支付宝/微信二维码\u003c/summary\u003e\n\n| 支付宝 | 微信支付 |\n|:---:|:---:|\n| ![支付宝](docs/donate/alipay.png) | ![微信支付](docs/donate/wechat.png) |\n\n\u003c/details\u003e\n\n#### 🪙 加密货币\n\n- **USDT (TRC20)**: `TKBV69B2AoU67p3vDhnJUbMJtZ1DxuUF5C`\n- **币安**:\n\n\u003cdetails\u003e\n\u003csummary\u003e点击查看二维码\u003c/summary\u003e\n\n![币安](docs/donate/binance.png)\n\n\u003c/details\u003e\n\n### 📊 资金使用透明度\n\n**已完成**：\n\n- ✅ Apple 开发者账号注册（¥688/年）\n- ✅ iOS TestFlight 公测上线\n- ✅ 轻量云服务器（¥79/年）- 用于办理ICP备案\n- ✅ Google Play 开发者账号注册（¥177，一次性）\n\n**持续成本**：\n\n- 📱 Apple 开发者账号续费：¥688/年\n- ☁️ 轻量云服务器：¥79/年\n\n**总计年度成本**：¥767/年（+ 已投入一次性成本 ¥177）\n\n所有捐赠资金的使用情况都会在这里公开透明地说明。\n\n### 🌟 感谢支持者\n\n感谢以下朋友的慷慨支持（按时间排序）：\n\n\u003e 💡 已捐赠？[点击这里提交您的信息](https://github.com/TNT-Likely/BeeCount/issues/new?template=donation_info.yml)，展示在支持者列表中！\n\n| | | | | | | | | | | |\n|:---:|:---:|:---:|:---:|:---:|:---:|:---:|:---:|:---:|:---:|:---:|\n| \u003cimg src=\"assets/avatars/qiao.svg\" width=\"50\"/\u003e | \u003cimg src=\"assets/avatars/rui.svg\" width=\"50\"/\u003e | \u003ca href=\"https://github.com/fishdivinity\"\u003e\u003cimg src=\"assets/avatars/fishdivinity.png\" width=\"50\"/\u003e\u003c/a\u003e | \u003cimg src=\"assets/avatars/shao.svg\" width=\"50\"/\u003e | \u003cimg src=\"assets/avatars/ge.svg\" width=\"50\"/\u003e | \u003cimg src=\"assets/avatars/te.svg\" width=\"50\"/\u003e | \u003cimg src=\"assets/avatars/wen.svg\" width=\"50\"/\u003e | \u003cimg src=\"assets/avatars/anon.svg\" width=\"50\"/\u003e | \u003ca href=\"https://github.com/birdnofoots\"\u003e\u003cimg src=\"https://github.com/birdnofoots.png\" width=\"50\"/\u003e\u003c/a\u003e | \u003ca href=\"https://github.com/charieswang72-pro\"\u003e\u003cimg src=\"https://github.com/charieswang72-pro.png\" width=\"50\"/\u003e\u003c/a\u003e | \u003ca href=\"https://github.com/542474846\"\u003e\u003cimg src=\"https://github.com/542474846.png\" width=\"50\"/\u003e\u003c/a\u003e |\n| *桥 ¥12 | *睿 ¥720 | [fishdivinity](https://github.com/fishdivinity) ¥100 | *邵 ¥15 | *哥 ¥6 | *特 ¥15 | *文 ¥50 | 匿名者 ¥50 | [birdnofoots](https://github.com/birdnofoots) ¥10 | [Charies](https://github.com/charieswang72-pro) ¥10 | [542474846](https://github.com/542474846) ¥66 |\n\n---\n\n## 📄 开源协议\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003e查看许可证详情\u003c/b\u003e\u003c/summary\u003e\n\n本项目采用 **商业源代码许可证（Business Source License）**：\n\n- ✅ **个人使用** - 完全免费\n- ✅ **学习研究** - 完全免费\n- ✅ **开源贡献** - 欢迎参与\n- ❌ **商业使用** - 需要付费授权\n\n### 什么是商业使用？\n\n以下情况需要获得商业许可：\n\n- 将本软件作为商业产品或服务提供给客户\n- 在盈利性组织中使用本软件\n- 基于本软件开发商业产品\n- 提供基于本软件的付费云服务\n\n如需商业使用，请通过 [GitHub Issues](https://github.com/TNT-Likely/BeeCount/issues) 联系。\n\n详见 [LICENSE](LICENSE) 文件。\n\n\u003c/details\u003e\n\n---\n\n## 📦 相关仓库\n\n| 仓库 | 说明 |\n|------|------|\n| [BeeCount-Website](https://github.com/TNT-Likely/BeeCount-Website) | 官网/文档仓库 |\n| [beecount-openharmony](https://github.com/TNT-Likely/beecount-openharmony) | 鸿蒙版本仓库（已停止更新） |\n| [BeeShot](https://github.com/TNT-Likely/BeeShot) | App Store 截图生成器 |\n\n---\n\n## 🙏 致谢\n\n感谢 [果核剥壳 - 互联网的净土](https://www.ghxi.com/)、[星之墨辰](https://mp.weixin.qq.com/s/HieVbKzpdUvnoaCa_9xjkA) 对本项目的宣传\n\n感谢所有为蜜蜂记账项目贡献代码、提出建议和反馈问题的朋友们！\n\n如有问题或建议，欢迎在 [Issues](https://github.com/TNT-Likely/BeeCount/issues) 中提出，或在 [Discussions](https://github.com/TNT-Likely/BeeCount/discussions) 中参与讨论。\n\n**蜜蜂记账 🐝 - 让记账变得简单而安全**\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftnt-likely%2Fbeecount","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftnt-likely%2Fbeecount","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftnt-likely%2Fbeecount/lists"}