{"id":49323755,"url":"https://github.com/atorber/wangcai","last_synced_at":"2026-04-26T19:00:53.970Z","repository":{"id":353568476,"uuid":"1218606475","full_name":"atorber/wangcai","owner":"atorber","description":"一款数据完全可控的个人记账手机APP","archived":false,"fork":false,"pushed_at":"2026-04-24T13:04:27.000Z","size":1134,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-24T14:28:08.211Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Dart","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/atorber.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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}},"created_at":"2026-04-23T03:24:48.000Z","updated_at":"2026-04-24T13:04:30.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/atorber/wangcai","commit_stats":null,"previous_names":["atorber/wangcai"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/atorber/wangcai","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/atorber%2Fwangcai","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/atorber%2Fwangcai/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/atorber%2Fwangcai/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/atorber%2Fwangcai/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/atorber","download_url":"https://codeload.github.com/atorber/wangcai/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/atorber%2Fwangcai/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32308878,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-26T17:23:19.671Z","status":"ssl_error","status_checked_at":"2026-04-26T17:23:19.195Z","response_time":129,"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":[],"created_at":"2026-04-26T19:00:53.331Z","updated_at":"2026-04-26T19:00:53.963Z","avatar_url":"https://github.com/atorber.png","language":"Dart","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 旺财 (WangCai)\n\n**旺财** 取“兴旺发财”之意，是一款以**本地优先、数据自主可控**为核心理念的个人记账应用。项目基于 Flutter 构建，目标是让用户在不依赖平台会员体系的前提下，也能完整、长期、安全地管理自己的财务数据。\n\n## 项目缘起：为什么会有旺财\n\n这个项目并非从“做一个新 App”出发，而是来自一个长期存在的真实痛点：\n\n- 长期使用的记账软件在**非会员**情况下大量核心功能受限，连最基础的导出与统计能力都无法正常使用，严重影响日常记账体验和数据可用性。\n- 个人财务数据本质上属于高敏感信息。随着对数据安全认知的提升，我们越来越意识到：频繁接到诈骗、贷款推销电话等现象，背后可能与平台侧的数据泄露或滥用风险有关。\n\n基于上述问题，旺财选择了明确方向：  \n**把财务数据控制权交还给用户自己**。\n\n- 账本数据默认保留在本地设备，降低对第三方平台的被动依赖；\n- 可通过 WebDAV 协议备份到自有网盘/服务器，实现可追溯、可迁移、可长期保存的数据资产；\n- 功能设计以“可用、可导出、可统计”为基础能力，而不是被会员体系绑定的特权。\n\n得益于当下 AI 编程工具的成熟，个人开发者可以更高效地打造真正贴合自身需求的记账产品。旺财也是这一实践：  \n**我们可以自由定义自己的记账软件，而不是被动适应平台规则。**\n\n## 使用说明 (User Guide)\n\n以下是“旺财”App 的核心使用指南，帮助您快速上手：\n\n### 1. 记一笔 (添加账单)\n*   **入口**: 在应用底部的导航栏中，点击中间醒目的 **“添加” (+号)** 按钮。\n*   **操作**:\n    *   在弹出的面板顶部选择类型：`支出`、`收入`、`转账`、`借出` 或 `借入`。\n    *   输入金额。\n    *   在下方的分类网格中选择对应的消费类别（如：餐饮、交通、购物等）。\n    *   可选：修改日期和添加备注（例如：“和朋友聚餐”）。\n    *   点击底部的 **“保存”**。\n\n### 2. 查看资产与账户\n*   **入口**: 底部导航栏点击 **“首页”**。\n*   **操作**:\n    *   **资产概览**: 页面顶部会显示您的【总资产】、【净资产】和【总负债】。\n    *   **我的账户**: 向下滚动可以查看所有已绑定的账户列表（包含储蓄卡、信用卡、支付宝、微信等）。点击卡片可以查看详细余额或信用卡本期应还金额。\n    *   **添加新账户**: 点击列表底部的 **“添加账户”** 按钮，输入初始余额、账户名称并选择类型即可新增账户。\n\n### 3. 查看财务统计\n*   **入口**: 底部导航栏点击 **“统计”**。\n*   **操作**:\n    *   **时间维度**: 顶部可切换【周】、【月】、【年】视图，对应统计范围会自动更新。\n    *   **本期概览**: 顶部卡片展示本期的收入、支出与结余，并注明时间区间。\n    *   **支出分布**: 环形图根据真实账单按分类聚合，展示各分类占比与金额。\n    *   **支出趋势**: 柱状图按日 / 按月还原本期每一格的支出，当前格高亮；右上角显示与上一周期的同比变化。\n    *   **财务洞察**: 基于真实账单自动计算，例如“相比上一周期节省 / 多花 ¥X”以及当前最多的支出分类。\n\n### 4. 设置与数据安全 (WebDAV 备份)\n*   **入口**: 底部导航栏点击 **“设置”**。\n*   **操作**:\n    *   **个性化**: 调整应用主题（深色/浅色模式），管理分类等。\n    *   **安全**: 开启面容ID/指纹保护。\n    *   **数据云备份（WebDAV）**:\n        1. 在设置中点击 **“WebDAV 云备份”**。\n        2. 按照向导填写 **WebDAV 服务地址**、**用户名** 与 **密码 / App Password**。\n        3. 配置远端备份文件路径（例如：`/wangcai/records.json`）。\n        4. 配置完成后可在状态页执行“立即备份”或“恢复覆盖本地”，您的记账数据将备份至自有 WebDAV 存储中。\n\n---\n\n## 功能特性\n\n旺财当前已实现以下核心功能：\n\n1.  **资产概览 (`AssetOverviewScreen`)**: 全面掌握您的财务状况。\n2.  **便捷记账 (`AddTransactionScreen`)**: 随时随地记录收支，便捷的模态弹出设计。\n3.  **财务统计 (`FinancialStatsScreen`)**: 基于真实账单数据，支持周 / 月 / 年维度的支出分布、趋势和同比洞察。\n4.  **账户管理 (`AddAccountScreen`)**: 轻松添加和管理各类财务账户。\n5.  **个性化设置 (`SettingsScreen`)**: 定制应用体验及安全选项。\n6.  **数据云备份 (WebDAV Backup)**: 完整的 WebDAV 备份与恢复设置流程。\n\n## 技术栈\n\n*   **跨平台框架:** Flutter\n*   **字体设计:** `google_fonts` (采用现代化无衬线字体 Inter)\n*   **数据可视化:** `fl_chart` (用于生成精美的统计图表)\n*   **图标库:** `material_symbols_icons`\n*   **状态管理:** `provider` (为后续业务逻辑处理和数据状态管理提供基础)\n\n## 快速开始 (供开发者体验)\n\n如果您希望在本地运行并体验“旺财”应用：\n\n1.  **准备工作:** 确保您的计算机上已安装并配置好 Flutter SDK 开发环境。\n2.  **克隆仓库:**\n    ```bash\n    git clone \u003crepository-url\u003e\n    cd wangcai\n    ```\n3.  **获取依赖:**\n    ```bash\n    flutter pub get\n    ```\n4.  **运行应用:**\n    ```bash\n    flutter run\n    ```\n\n## 下载与发布版本\n\n如果您希望直接下载已打包版本（如 APK / AAB），请前往 GitHub Release 页面：\n\n- [WangCai Releases](https://github.com/atorber/wangcai/releases)\n- 当前版本：[`v0.1.0`](https://github.com/atorber/wangcai/releases/tag/v0.1.0)\n\n发布建议使用 GitHub Actions 的 `Create Release (Auto Bump Patch)` 工作流。  \n该流程会读取 `pubspec.yaml` 中的版本号作为基准；若同名版本已发布，则自动将补丁位（最后一位）递增后再创建 Release（例如 `v0.1.0` 已存在时自动发布 `v0.1.1`）。\n\n## 项目阶段总结\n\n截至当前阶段，旺财已完成从“可用原型”到“可日常使用”的核心能力建设，主要体现在：\n\n- **记账闭环已打通**：覆盖支出、收入、转账、借出、借入等主要交易类型，满足日常高频记录场景。\n- **资产视图已成体系**：可从账户与总览两个维度查看资产、负债与净值变化，支持用户快速了解当下财务状态。\n- **统计分析具备基础决策价值**：基于真实账单构建了周 / 月 / 年维度的分类占比、趋势观察与同比洞察，能够支撑基础的消费管理与自我优化。\n- **数据主权路线已落地**：本地优先 + WebDAV 自有存储备份方案已具备完整配置流程，强化数据可控与可迁移能力。\n- **产品风格与品牌正在统一**：界面结构、交互风格与图标视觉持续收敛，逐步形成“旺财”独立产品识别度。\n\n整体来看，旺财已具备持续迭代的产品基础；下一阶段重点将从“功能可用”转向“稳定性、自动化与长期体验”。\n\n## 下一步迭代路线\n\n### P0（优先推进：稳定性与数据安全）\n\n1. **数据可靠性增强**\n   - 增加关键写入路径的异常恢复与失败重试策略。\n   - 完善同步冲突处理机制（本地与远端版本差异、覆盖策略、回滚策略）。\n2. **备份可验证性**\n   - 增加“最近一次成功备份时间”“备份结果校验”等可视反馈。\n   - 提供一键导出/导入演练流程，验证迁移可用性。\n3. **基础质量保障**\n   - 以“核心流程回归”为主建立最小测试集合（记账、账户、统计、同步），确保迭代不回退核心能力。\n\n### P1（体验升级：效率与可读性）\n\n1. **记账效率优化**\n   - 增加常用分类/账户智能置顶、最近输入记忆、快捷金额模板。\n   - 优化添加流程中的键盘与焦点交互，减少多步操作成本。\n2. **统计与洞察增强**\n   - 增加预算执行、环比/同比、异常波动提醒等实用洞察。\n   - 统一图表交互与说明文案，提高可解释性。\n3. **信息架构打磨**\n   - 统一列表页、详情页、设置页的视觉与交互规范，持续提升一致性与学习成本友好度。\n\n### P2（能力扩展：长期可持续）\n\n1. **多账本与场景化**\n   - 支持个人/家庭/项目等账本隔离与切换。\n2. **规则自动化**\n   - 支持自动分类规则、周期性账单、固定收支模板。\n3. **生态与开放能力**\n   - 探索与更多云端存储或自托管后端的兼容方案，提升可扩展性与长期自治能力。\n\n---\n\n欢迎通过 Issue 或 PR 参与共建。  \n如果你也认同“财务数据应由自己掌控”，旺财会持续沿着“本地优先、可迁移、可验证”的路线长期迭代。\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fatorber%2Fwangcai","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fatorber%2Fwangcai","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fatorber%2Fwangcai/lists"}