bf04400852
OCR 模型按需下载（P8 瘦身）： - 移除 plugins/ppocr/assets/ 内置模型（det 9.8MB + rec 21MB + dict），APK 减包 ~31MB - 新增 modelDownloader.ts：优先从 HuggingFace/CDN 下载，兜底从 APK assets 拷贝 - OcrModule.kt 新增 setModelDir，支持从 filesystem 加载模型，回退 assets 兼容旧用户 - settingsStore 持久化 ocrModelVersion / ocrModelDir - 自动化页集成模型状态检查与一键下载 UI OCR 三层独立控制： - OcrProcessorConfig 从单一 aiVisionEnabled 拆分为 layer1/2/3 三个独立开关 - 设置页可按层启停（L1 正则规则 / L2 本地 OCR / L3 AI Vision） - OCR 处理增加耗时与字符数日志 日志系统升级： - logger.ts 新增 LogFileBackend 抽象，支持磁盘持久化（按日期 app-YYYY-MM-DD.log） - 新增 logBackend.ts（ExpoLogFileBackend）+ 日志中心页 settings/logs.tsx - 日志中心：实时缓冲 + 历史文件、4 级过滤、Tag/关键词搜索、JSON 展开、分享导出、7 天过期清理 - _layout.tsx 启动时初始化文件后端 + 日志脱敏（验证码/卡号） 原生浮层 UI 主题同步（P6）： - 新增 floatingUiConfig.ts：JS 侧从 theme tokens + i18n 构建 FloatingUiConfig 推送原生 - 新增 FloatingUiConfigStore.kt：SharedPreferences 存储，三浮层组件读取 - FloatingBillView 重设计：颜色/文案走配置、新增币种 chip、金额校验改 BigDecimal - FloatingHelper / FloatingTip 同步适配 - _layout.tsx 新增 FloatingUiConfigSyncer，主题/语言切换自动推送 UI 与组件增强： - FormModal 新增 select/dropdown 控件、行内布局（row/flex）、联动回调 onValuesChange - 新增 Touchable 通用触摸组件、AccountCreateModal 快速建账弹窗 - 信用卡页展示账单周期/到期还款日/本期应还/剩余可用额度，关联账户改下拉选择 - AI 设置页重做：OpenAI/Gemini/DeepSeek 预设 + 默认 URL/模型 - 引导页新增 Android 权限检查步骤（无障碍/通知/短信/存储/悬浮窗） 去重优化： - 对手方匹配改为模糊包含（includes），双方均无对手方时判定低置信度重复 - DedupResult 新增 matchedItem 返回匹配对比项 文档重构： - README.md 重写为入口索引（品牌更新 + 模块概览 + 文档导航表） - 新增 AGENTS.md（AI 助手贡献指南）、docs/architecture.md（Mermaid 数据流/分层/OCR 级联图） - 新增 docs/development.md（环境/命令/编码规范/测试/提交规范）、plugins/README.md - UI 重设计文档（design spec + p1-p8）移入 docs/design/ 其他： - i18n 新增权限/信用卡详情/日志中心/AI 设置等翻译键 - ppocr Config Plugin 修复 import 注入去重；size-optimization 增强 - 新增测试：logger.test.ts、floating-ui-config.test.ts
117 lines
3.0 KiB
Markdown
117 lines
3.0 KiB
Markdown
# 系统架构
|
||
|
||
## 核心不变量
|
||
|
||
`.bean` 文件是唯一事实来源；SQLite 仅为可丢弃的读缓存。
|
||
|
||
## 数据流
|
||
|
||
```mermaid
|
||
flowchart LR
|
||
subgraph DataSource[数据源]
|
||
A[".bean 文件"]
|
||
B["OCR / 无障碍 / 通知 / 短信"]
|
||
C[“手动录入 / CSV 导入"]
|
||
end
|
||
|
||
subgraph Pipeline[处理层]
|
||
D["BillPipeline 串行互斥锁"]
|
||
E[“转账识别"]
|
||
F[“去重"]
|
||
G[“规则分类"]
|
||
end
|
||
|
||
subgraph Storage[存储层]
|
||
H["main.bean 追加写入"]
|
||
I["SQLite 缓存"]
|
||
J["Zustand Store 内存索引"]
|
||
end
|
||
|
||
subgraph UI[展示层]
|
||
K["Expo Router 页面"]
|
||
L[“报表 / 图表"]
|
||
end
|
||
|
||
A -->|parseLedger| J
|
||
B -->|原始事件| D
|
||
C -->|TransactionDraft| D
|
||
D --> E --> F --> G
|
||
G -->|确认写入| H
|
||
H -->|reparse| J
|
||
J --> K
|
||
J --> L
|
||
I -.->|搜索查询| J
|
||
```
|
||
|
||
## 模块分层
|
||
|
||
```mermaid
|
||
graph TB
|
||
subgraph UILayer["UI 层: src/app + src/components"]
|
||
R[“Expo Router 页面"]
|
||
CO[“可复用组件"]
|
||
end
|
||
|
||
subgraph StateLayer["状态层: src/store"]
|
||
S[“Zustand Stores"]
|
||
end
|
||
|
||
subgraph DomainLayer["领域层: src/domain — 纯 TS 零 RN 依赖"]
|
||
LE["ledger.ts 解析器"]
|
||
P["billPipeline.ts"]
|
||
D2["dedup / transfer / rules"]
|
||
O["ocrProcessor.ts"]
|
||
end
|
||
|
||
subgraph Infra[“基础设施"]
|
||
FS["expo-file-system"]
|
||
DB["expo-sqlite"]
|
||
NAT["plugins/ 原生模块"]
|
||
end
|
||
|
||
R --> S
|
||
CO --> S
|
||
S --> LE
|
||
S --> P
|
||
P --> D2
|
||
P --> O
|
||
LE --> FS
|
||
D2 --> DB
|
||
O --> NAT
|
||
```
|
||
|
||
## BillPipeline 处理顺序
|
||
|
||
所有导入渠道（手动、CSV、OCR、无障碍、通知、短信、截图）统一经过 `BillPipeline`，严格按序执行：
|
||
|
||
1. **转账识别** — 配对收入+支出 → 单笔转账（必须先于去重）
|
||
2. **批内去重** — 时间窗口 + 金额 + 交易对手
|
||
3. **历史去重** — 按日期索引比对已提交交易
|
||
4. **规则分类** — 规则匹配 → 关键词 → `Uncategorized` 兆底
|
||
|
||
## 原生模块
|
||
|
||
原生功能以 Expo Config Plugin 形式封装在 `plugins/<name>/`，详见 [plugins/README.md](../plugins/README.md)。
|
||
|
||
原生服务**不直接写入**数据库或文件，而是通过 `NativeEventEmitter` 将原始事件推送到 JS 层管道。
|
||
|
||
## OCR 三层级联
|
||
|
||
```mermaid
|
||
flowchart LR
|
||
A[“图像输入"] --> B["Layer 1: 正则规则"]
|
||
B -->|未命中| C["Layer 2: 本地 OCR PP-OCRv6"]
|
||
C -->|未命中| D["Layer 3: AI Vision 付费"]
|
||
```
|
||
|
||
## 双轨映射
|
||
|
||
Beancount 无原生“分类/预算”概念，应用在本地 SQLite 维护 UI 元数据，写入时映射回 Beancount 语义：
|
||
|
||
| 概念 | 本地表 | 映射到 `.bean` |
|
||
|------|--------|----------------|
|
||
| 分类 | `categories` | `linkedAccount` → posting 账户 |
|
||
| 标签 | `tags` | narration 中的 `#tag` |
|
||
| 预算 | `budgets` | 仅本地，不影响余额 |
|
||
| 信用卡 | `credit_cards` | 账户在 `.bean`，UI 字段本地 |
|