6767dd538a
### 架构重构：三层分层目录化 - domain 拆分为 8 个子目录（core/pipeline/rules/finance/stats/taxonomy/transaction/platform） - components 拆分为 6 个子目录（form/ui/layout/account/category/stats/transaction） - services 拆分为 5 个子目录（automation/data/ocr/security），accessibilityParser 从 automationPipeline 提取 - 新增 ruleConfig.ts — 规则配置唯一数据源（关键词/方向/OCR 模式），与业务逻辑解耦 ### 微信账单抓取：节点混淆绕过（核心突破） - BillingAccessibilityService 重命名为 SelectToSpeakService，完整伪装为系统服务 - 同时伪装包名+类名为 com.google.android.accessibility.selecttospeak，规避微信 8.0.52+ 白名单校验 - Config Plugin 重写：8 个 kt 文件整体复制+package 正则替换+Manifest/import 联动 - 支付宝/微信无障碍文本解析器全面增强（方向推断/账单分类提取/付款方式提取/容错） - 补充文档 accessibility-wechat-guide.md（伪装原理、踩坑全记录） ### 新 UI 组件体系 - Toast：全局轻量 toast（Context Provider + 入场动画 + 操作按钮 + 自动消失） - ErrorBoundary：React class 错误边界（降级 UI + 重试） - EmptyState / ConfirmDialog / SegmentedControl / Skeleton / TimePicker - BottomSheet 重写：SafeAreaProvider 修复、手势下滑关闭、键盘响应式避让 - FormModal 重构：拆出 FormFields 子组件（TextField/SelectField/DropdownField） - 新增 PeriodSwitcher、RangeStatsCard 独立组件 ### 新 Hooks & 工具 - useBottomInset — 统一底部安全区留白 - useKeyboardAvoiding — 键盘高度响应式 hook（替代 translateY 方案） - sanitize.ts — 日志脱敏工具提取 ### 账本增删改增强 - 写锁增加代际计数器（lockGeneration），reset 后旧链 pending 任务自动跳过 set - 新增 restoreTransaction — 撤销删除（重新追加 raw 文本到 mobile.bean） - 删除交易时清除去重缓存（buildTxKeyFromRaw 重建去重键），支持「删了重记」 - editTransaction/deleteTransaction 改用 dr-id 精确定位交易块（避免同名交易定位错误） - appendTransactionsBatch 改从存储直接读取，避免 zustand state 不一致 ### OCR 原生模块增强 - 异步 initEngine 增加 CountDownLatch 等待（最多 15s），解决竞态导致的「引擎未就绪」 - setModelDir 增加去重判断 + file:// 前缀剥离，避免冗余 reload - 推理链路增加分阶段耗时日志（det 推理/det 后处理/rec 识别） - 图片缩放策略重命名（scaleDownForOcr → capLongEdge） ### OCR 模型按需下载 - 移除了启动时自动下载 ~30MB OCR 模型的逻辑 - 改为首次使用 OCR 时才触发下载 ### 设置页重设计 - ScrollView → SectionList 分组卡片布局（iOS 风格分组圆角行+右侧箭头） - 移除 Card 组件包装，直接使用独立分组头+底部关于卡片 ### 首页优化 - ScrollView → FlatList（ListHeaderComponent 承载净资产卡片+待办条） - 日期/金额格式化增加 locale 感知（zh/en） ### 通知管道增强 - NotificationChannel MD5 去重改为批量淘汰（80% 阈值），替代逐个删除 - 增加 debug 日志输出（过滤原因/包名） ### ESLint - 新增 eslint.config.mjs（typescript-eslint + react-hooks + react-native 规则集） - package.json 新增 lint/lint:fix 脚本，引入 5 个 devDependencies ### 文档 - accessibility-wechat-guide.md — 微信无障碍伪装完整方案 - modal-keyboard-guide.md — 弹窗键盘避让方案 - ocr-pipeline-guide.md — OCR 三层层级管线 - OCR及文本模型测试 / 账单元识别及账户分类设计 / 账户分类模型测试 |
||
|---|---|---|
| assets/icon | ||
| design-system/beancount-mobile | ||
| docs | ||
| plugins | ||
| src | ||
| tests | ||
| .gitignore | ||
| AGENTS.md | ||
| app.json | ||
| eslint.config.mjs | ||
| package-lock.json | ||
| package.json | ||
| plan.md | ||
| README.md | ||
| tsconfig.json | ||
DriftLedger (浮记)
面向 Beancount 用户的离线移动记账客户端。桌面账本只读，移动端仅追加写入 main.bean；支持 OCR、无障碍服务、通知监听、短信等多渠道自动记账。
技术栈：React Native + Expo (CNG) · TypeScript (strict) · Zustand · expo-sqlite · PP-OCRv6 (ONNX Runtime)
快速开始
npm install --legacy-peer-deps # 安装依赖（必须带 --legacy-peer-deps）
npm run start # 启动 Metro 开发服务器
npm run android # 构建并运行 Android
npm test # 运行 Vitest 全量测试
npm run typecheck # TypeScript 类型检查
本应用为侧载开源项目，不上架应用商店。Android 构建详见 docs/android-build-guide.md。
模块概览
| 目录 | 职责 |
|---|---|
src/domain/ |
纯业务逻辑：.bean 解析器、账单管道、去重、规则引擎、OCR 处理器 |
src/app/ |
Expo Router 文件路由（(tabs)/ 底部导航） |
src/components/ |
React Native UI 组件与图表 |
src/store/ |
Zustand 状态管理（ledger / import / settings / metadata / automation） |
src/services/ |
平台服务（同步、备份、安全、OCR 桥接） |
src/storage/ |
SQLite 读缓存 + 版本化迁移 |
src/theme/ |
Token 主题系统（浅色 / OLED 暗色） |
src/i18n/ |
中英文国际化 |
plugins/ |
Expo Config Plugins 原生模块（OCR、无障碍、通知、短信、截图） |
tests/ |
Vitest 单元测试（mock 后端，覆盖 domain 层） |
文档导航
| 文档 | 内容 |
|---|---|
| docs/architecture.md | 系统架构与数据流 |
| docs/development.md | 开发指南（环境、命令、规范、测试） |
| docs/android-build-guide.md | Android 打包与体积优化 |
| docs/accessibility-wechat-guide.md | 无障碍服务与微信文本抓取（绕过 8.0.52+ 节点混淆） |
| docs/ocr-pipeline-guide.md | OCR 推理管线与诊断方法论 |
| docs/design/ | UI 重设计规格与分阶段实施计划 |
| design-system/ | 设计系统 Token 定义 |
| AGENTS.md | AI 编程助手贡献指南 |
| plan.md | 设计决策与实施路线图（权威文档） |
账本约定
在桌面主账本中添加一次：
include "main.bean"
应用不改写主账本或其他桌面维护文件；确认的交易只追加到 main.bean。