feat: 领域/组件/服务三层目录重构 + 微信无障碍绕过方案 + 新 UI 组件体系 + 账本增删改增强

### 架构重构：三层分层目录化 - 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及文本模型测试 / 账单元识别及账户分类设计 / 账户分类模型测试
2026-07-28 20:57:37 +08:00
parent bf04400852
commit 6767dd538a
222 changed files with 8970 additions and 2500 deletions
@@ -0,0 +1,129 @@
+/**
+ * ledgerStore reset 与 lockGeneration 守卫测试。
+ * 验证 #1/#2 修复：reset() 递增 lockGeneration，addTransaction 中 gen 守卫生效。
+ */
+import { describe, expect, it, beforeEach, vi } from 'vitest';
+
+// ledgerStore 间接依赖 txKeyStore → expo-file-system，mock 掉避免 react-native flow 语法解析失败
+vi.mock('expo-file-system/legacy', () => ({
+  documentDirectory: '',
+  getInfoAsync: vi.fn().mockResolvedValue({ exists: false }),
+  readAsStringAsync: vi.fn().mockResolvedValue('[]'),
+  writeAsStringAsync: vi.fn().mockResolvedValue(undefined),
+  moveAsync: vi.fn().mockResolvedValue(undefined),
+}));
+
+import { useLedgerStore } from '../src/store/ledgerStore';
+import { MemoryBackend } from '../src/domain/platform/mobileStore';
+import type { LedgerFile } from '../src/domain/core/types';
+
+const sampleLedger: LedgerFile = {
+  path: 'main.bean',
+  content: `option "operating_currency" "CNY"
+2026-01-01 open Assets:Alipay CNY
+2026-01-01 open Expenses:Food CNY
+include "mobile.bean"
+`,
+};
+
+beforeEach(() => {
+  useLedgerStore.getState().reset();
+});
+
+describe('ledgerStore reset 与 lockGeneration', () => {
+  it('reset 后状态清空', () => {
+    const state = useLedgerStore.getState();
+    expect(state.ledger).toBeNull();
+    expect(state.mobileStore).toBeNull();
+    expect(state.mobileBean).toBe('');
+    expect(state.isLoading).toBe(false);
+    expect(state.error).toBeNull();
+  });
+
+  it('reset 后重新 loadLedger 正常工作', async () => {
+    await useLedgerStore.getState().loadLedger([sampleLedger], new MemoryBackend());
+    expect(useLedgerStore.getState().ledger).not.toBeNull();
+
+    useLedgerStore.getState().reset();
+    expect(useLedgerStore.getState().ledger).toBeNull();
+
+    // 重新加载
+    await useLedgerStore.getState().loadLedger([sampleLedger], new MemoryBackend());
+    expect(useLedgerStore.getState().ledger).not.toBeNull();
+    expect(useLedgerStore.getState().ledger?.transactions).toBeDefined();
+  });
+
+  it('reset 后 addTransaction 使用新的 mobileStore', async () => {
+    const backend1 = new MemoryBackend();
+    await useLedgerStore.getState().loadLedger([sampleLedger], backend1);
+    const store1 = useLedgerStore.getState().mobileStore;
+
+    useLedgerStore.getState().reset();
+
+    const backend2 = new MemoryBackend();
+    await useLedgerStore.getState().loadLedger([sampleLedger], backend2);
+    const store2 = useLedgerStore.getState().mobileStore;
+
+    // 两个 store 应该是不同的实例
+    expect(store1).not.toBe(store2);
+  });
+
+  it('并发 addTransaction 串行化执行', async () => {
+    await useLedgerStore.getState().loadLedger([sampleLedger], new MemoryBackend());
+
+    const draft1 = {
+      date: '2026-07-01',
+      payee: '商户A',
+      narration: '交易1',
+      postings: [
+        { account: 'Assets:Alipay', amount: '-100', currency: 'CNY' },
+        { account: 'Expenses:Food', amount: '100', currency: 'CNY' },
+      ],
+    };
+
+    const draft2 = {
+      date: '2026-07-02',
+      payee: '商户B',
+      narration: '交易2',
+      postings: [
+        { account: 'Assets:Alipay', amount: '-200', currency: 'CNY' },
+        { account: 'Expenses:Food', amount: '200', currency: 'CNY' },
+      ],
+    };
+
+    // 并发执行两个 addTransaction
+    const [result1, result2] = await Promise.all([
+      useLedgerStore.getState().addTransaction(draft1),
+      useLedgerStore.getState().addTransaction(draft2),
+    ]);
+
+    // MobileCommit 返回 content/diff，不包含 success 字段
+    expect(result1.content).toBeDefined();
+    expect(result2.content).toBeDefined();
+
+    // 两笔交易都应该入账
+    const bean = useLedgerStore.getState().mobileBean;
+    expect(bean).toContain('商户A');
+    expect(bean).toContain('商户B');
+  });
+
+  it('reset 后 addTransaction 报错（账本未加载）', async () => {
+    await useLedgerStore.getState().loadLedger([sampleLedger], new MemoryBackend());
+
+    const draft = {
+      date: '2026-07-01',
+      payee: '测试商户',
+      narration: '测试交易',
+      postings: [
+        { account: 'Assets:Alipay', amount: '-50', currency: 'CNY' },
+        { account: 'Expenses:Food', amount: '50', currency: 'CNY' },
+      ],
+    };
+
+    // reset 后状态清空
+    useLedgerStore.getState().reset();
+
+    // 此时 addTransaction 应该报错
+    await expect(useLedgerStore.getState().addTransaction(draft)).rejects.toThrow('账本未加载');
+  });
+});