fengmengqi bf04400852 feat: OCR 模型按需下载 + 三层独立开关 + 日志持久化 + 原生浮层主题同步 + 文档重构

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

2026-07-23 19:03:38 +08:00

2.4 KiB

Raw Permalink Blame History

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/design/	UI 重设计规格与分阶段实施计划
design-system/	设计系统 Token 定义
AGENTS.md	AI 编程助手贡献指南
plan.md	设计决策与实施路线图（权威文档）

账本约定

在桌面主账本中添加一次：

include "main.bean"

应用不改写主账本或其他桌面维护文件；确认的交易只追加到 main.bean。