FlashCount ⚡

开源、本地优先的 iOS 记账 App。 数据保存在设备上；不依赖账户、云端同步、广告或追踪。

仍在持续开发中。欢迎提交问题、建议和改进。

功能

功能	说明
⚡ 快速记账	支出、收入、分类、备注和模板，金额可用「+」累加拆账，保存后可撤销；支持 Siri、Back Tap 与快捷指令入口。
📒 单账本	将收支、预算、资产、分期和提醒集中到一个个人生活账本。
🔄 周期账单	自动处理房租、订阅等周期规则，并提示补记与即将发生的项目。
📊 预算与报表	追踪日常及分类预算，按日、周、月、年和发薪周期查看收支和趋势，数字可下钻到对应交易。
💰 资产全景	资金池、储蓄目标、实物资产与分期负债各自成账；现金流预测将已知账单与历史日常支出分开，展示未来余额的常见区间而非一条假装精确的线。净资产只按资金池口径统计（实物估值与储蓄目标不计入）。
🛡️ 本地隐私	所有账本数据留在设备本地；不含广告、分析 SDK 或网络请求。

系统要求

• iOS 17.0 或更高版本
• Xcode 26 或更高版本（从源码构建；CI 持续验证的即为最新稳定版 Xcode。代码保留了针对旧 SDK 的编译回退，但不再逐版验证）
• Swift 5.9

安装与运行

从 Release 安装

最新版本在 GitHub Releases 发布。若 Release 附有 FlashCount-AltStore.ipa，请使用 AltStore 安装；该包是未签名主 App，由 AltStore 在安装时重新签名。

从源码构建

git clone https://github.com/Yessi-cmd/flashcount.git
cd flashcount

# 安装并使用 XcodeGen 生成工程
brew install xcodegen
./scripts/generate-project.sh

# 用 Xcode 打开，选择模拟器或你的签名团队后运行
open FlashCount.xcodeproj

开发

# 生成工程（脚本会补上本机私有的 project.local.yml；直接跑 xcodegen generate
# 在没有该文件的机器上会失败，XcodeGen 的 include 不支持可选）
./scripts/generate-project.sh

# 在已安装的 iOS Simulator 上运行测试
xcodebuild test \
  -project FlashCount.xcodeproj \
  -scheme FlashCount \
  -destination 'platform=iOS Simulator,name=iPhone 17 Pro' \
  CODE_SIGNING_ALLOWED=NO

GitHub Actions 会在 main 的推送与 Pull Request 上重新生成工程并运行测试。提交前请阅读贡献指南和安全政策。

隐私

• 账本数据、备份和偏好设置均在本地保存。
• 应用不要求注册账户，也不发送使用分析数据。
• 备份、CSV 导入导出和提醒由设备本地处理。

完整的发布包规则见打包规范。

参与贡献

请先阅读贡献指南和行为准则，再通过 Issue 或 Pull Request 参与。安全漏洞请不要公开提交 Issue，详见安全政策。

License

本项目采用 MIT License。