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
69 lines
2.3 KiB
Markdown
69 lines
2.3 KiB
Markdown
# 开发指南
|
||
|
||
## 环境要求
|
||
|
||
- Node.js 18+
|
||
- JDK 21 + Android SDK 35 + NDK 27.1.12297006（仅 Android 构建需要）
|
||
- 详见 [android-build-guide.md](android-build-guide.md)
|
||
|
||
## 常用命令
|
||
|
||
```bash
|
||
npm install --legacy-peer-deps # 安装依赖（必须带 --legacy-peer-deps）
|
||
npm run start # 启动 Metro 开发服务器
|
||
npm run android # expo run:android（设备/模拟器）
|
||
npm test # Vitest 全量测试
|
||
npm run typecheck # tsc --noEmit 类型检查
|
||
|
||
# 单文件测试
|
||
npx vitest run tests/ledger.test.ts
|
||
|
||
# 按名称运行测试
|
||
npx vitest run -t "拒绝不平衡交易"
|
||
|
||
# 重新生成原生项目
|
||
npx expo prebuild --platform android
|
||
```
|
||
|
||
## 编码规范
|
||
|
||
### TypeScript
|
||
|
||
- **strict 模式**已开启，路径别名 `@/*` → `src/*`
|
||
- 非平凡改动后必须运行 `npm run typecheck`
|
||
|
||
### 金额计算
|
||
|
||
- 使用字符串十进制运算（`src/domain/decimal.ts`），**禁止**用 JS 浮点数处理金额
|
||
- 关键 API：`addDecimals`、`subtractDecimals`、`multiplyDecimal`、`divideDecimals`、`negateDecimal`
|
||
|
||
### 领域层纯净性
|
||
|
||
- `src/domain/` 禁止导入 React / React Native / Expo 任何模块
|
||
- 外部依赖通过接口注入：`MobileBeanBackend`、`OcrEngine`、`AiVisionProvider`
|
||
- 新模块必须在 `src/domain/index.ts` 重导出
|
||
|
||
### 原生代码
|
||
|
||
- 原生 Kotlin/XML 只能放在 `plugins/<name>/` 下，不可直接编辑 `android/`
|
||
- 每个 Config Plugin 函数**必须 `return config`**
|
||
- `expo prebuild` 后检查 `onnxruntime-android:1.20.0` 版本
|
||
|
||
### 注释与文档
|
||
|
||
- 代码注释和 `plan.md` 使用**中文**
|
||
- ID/校验和使用 FNV-1a 哈希（`hash()` in `ledger.ts`），不用加密哈希
|
||
|
||
## 测试
|
||
|
||
- 框架：**Vitest**（无配置文件，默认拾取 `tests/**/*.test.ts`）
|
||
- 测试对象：主要覆盖 `src/domain/` 层，使用 mock 后端（`MemoryBackend`、`MockOcrEngine`）
|
||
- 命名：`<模块或功能>.test.ts`，如 `decimal.test.ts`、`billPipeline.test.ts`
|
||
- 新增 domain 逻辑时必须同步添加测试
|
||
|
||
## 提交规范
|
||
|
||
- 提交消息格式：`feat: <中文摘要>`，多行 body 按模块分区列举变更
|
||
- 示例：`feat: 品牌重命名为浮记(DriftLedger)，全面升级精度安全与架构`
|
||
- PR 需描述变更内容与原因，UI 变更附截图，关联相关 issue
|