### 架构重构:三层分层目录化 - 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及文本模型测试 / 账单元识别及账户分类设计 / 账户分类模型测试
261 lines
11 KiB
TypeScript
261 lines
11 KiB
TypeScript
import { describe, expect, it, beforeEach, vi } from 'vitest';
|
||
|
||
// ledgerStore/importStore 间接依赖 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 { useImportStore } from '../src/store/importStore';
|
||
import { useSettingsStore } from '../src/store/settingsStore';
|
||
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
|
||
2026-01-01 open Expenses:Uncategorized CNY
|
||
2026-01-01 open Income:Uncategorized CNY
|
||
include "mobile.bean"
|
||
`,
|
||
};
|
||
|
||
const sampleStatement = '交易时间,金额(元),收/支,交易对方,商品说明,交易订单号\n2026-07-01,24.50,支出,咖啡店,冰美式,ORDER-1\n2026-07-02,5000,收入,公司,工资,ORDER-2';
|
||
|
||
// 每个测试前重置 store(zustand 单例需手动重置)
|
||
beforeEach(() => {
|
||
useLedgerStore.getState().reset();
|
||
useImportStore.getState().clear();
|
||
useSettingsStore.getState().hydrate({});
|
||
});
|
||
|
||
describe('ledgerStore', () => {
|
||
it('loadLedger 解析账本并初始化 mobile.bean 存储', async () => {
|
||
await useLedgerStore.getState().loadLedger([sampleLedger], new MemoryBackend());
|
||
const state = useLedgerStore.getState();
|
||
expect(state.ledger).not.toBeNull();
|
||
expect(state.ledger!.accounts.size).toBe(4);
|
||
expect(state.mobileBean).toContain('include "mobile.bean"');
|
||
expect(state.error).toBeNull();
|
||
});
|
||
|
||
it('addTransaction 写入 mobile.bean(并发安全)', async () => {
|
||
await useLedgerStore.getState().loadLedger([sampleLedger], new MemoryBackend());
|
||
const commit = await useLedgerStore.getState().addTransaction({
|
||
date: '2026-07-10', narration: '午餐',
|
||
postings: [{ account: 'Assets:Alipay', amount: '-20', currency: 'CNY' }, { account: 'Expenses:Food', amount: '20', currency: 'CNY' }],
|
||
});
|
||
expect(commit.content).toContain('午餐');
|
||
expect(useLedgerStore.getState().mobileBean).toContain('午餐');
|
||
});
|
||
|
||
// 回归:用户反馈"添加交易后最近交易还是 0"。
|
||
// 根因:addTransaction 只更新了 mobileBean 字符串,未重新解析 ledger.transactions。
|
||
// parseLedger 不解析 include 指令,需把 mobile.bean 作为额外文件传入。
|
||
it('addTransaction 后 ledger.transactions 包含新交易', async () => {
|
||
await useLedgerStore.getState().loadLedger([sampleLedger], new MemoryBackend());
|
||
expect(useLedgerStore.getState().ledger!.transactions).toHaveLength(0);
|
||
|
||
await useLedgerStore.getState().addTransaction({
|
||
date: '2026-07-10', narration: '午餐',
|
||
postings: [{ account: 'Assets:Alipay', amount: '-20', currency: 'CNY' }, { account: 'Expenses:Food', amount: '20', currency: 'CNY' }],
|
||
});
|
||
|
||
const txns = useLedgerStore.getState().ledger!.transactions;
|
||
expect(txns).toHaveLength(1);
|
||
expect(txns[0].narration).toBe('午餐');
|
||
expect(txns[0].postings).toHaveLength(2);
|
||
});
|
||
|
||
it('addTransaction 多笔后 ledger.transactions 全部可见', async () => {
|
||
await useLedgerStore.getState().loadLedger([sampleLedger], new MemoryBackend());
|
||
for (const n of [1, 2, 3]) {
|
||
await useLedgerStore.getState().addTransaction({
|
||
date: '2026-07-10', narration: `t${n}`,
|
||
postings: [{ account: 'Assets:Alipay', amount: `-${n}`, currency: 'CNY' }, { account: 'Expenses:Food', amount: `${n}`, currency: 'CNY' }],
|
||
});
|
||
}
|
||
const txns = useLedgerStore.getState().ledger!.transactions;
|
||
expect(txns).toHaveLength(3);
|
||
expect(txns.map(t => t.narration).sort()).toEqual(['t1', 't2', 't3']);
|
||
});
|
||
|
||
it('replaceMobileBean 后 ledger.transactions 同步更新', async () => {
|
||
await useLedgerStore.getState().loadLedger([sampleLedger], new MemoryBackend());
|
||
await useLedgerStore.getState().replaceMobileBean(
|
||
'2026-07-10 * "导入交易"\n Assets:Alipay -50 CNY\n Expenses:Food\n',
|
||
);
|
||
const txns = useLedgerStore.getState().ledger!.transactions;
|
||
expect(txns).toHaveLength(1);
|
||
expect(txns[0].narration).toBe('导入交易');
|
||
});
|
||
|
||
it('addTransaction 多笔并发不丢失', async () => {
|
||
await useLedgerStore.getState().loadLedger([sampleLedger], new MemoryBackend());
|
||
await Promise.all([1, 2, 3].map(n =>
|
||
useLedgerStore.getState().addTransaction({
|
||
date: '2026-07-10', narration: `t${n}`,
|
||
postings: [{ account: 'Assets:Alipay', amount: `-${n}`, currency: 'CNY' }, { account: 'Expenses:Food', amount: `${n}`, currency: 'CNY' }],
|
||
}),
|
||
));
|
||
const content = useLedgerStore.getState().mobileBean;
|
||
expect(content).toContain('t1');
|
||
expect(content).toContain('t2');
|
||
expect(content).toContain('t3');
|
||
});
|
||
|
||
it('未加载账本时 addTransaction 抛错', async () => {
|
||
await expect(useLedgerStore.getState().addTransaction({
|
||
date: '2026-07-10', narration: 'x',
|
||
postings: [{ account: 'A', amount: '-1', currency: 'CNY' }, { account: 'B', amount: '1', currency: 'CNY' }],
|
||
})).rejects.toThrow('账本未加载');
|
||
});
|
||
|
||
it('不平衡交易 addTransaction 抛错并设置 error', async () => {
|
||
await useLedgerStore.getState().loadLedger([sampleLedger], new MemoryBackend());
|
||
await expect(useLedgerStore.getState().addTransaction({
|
||
date: '2026-07-10', narration: '错误',
|
||
postings: [{ account: 'Assets:Alipay', amount: '-1', currency: 'CNY' }, { account: 'Expenses:Food', amount: '0.9', currency: 'CNY' }],
|
||
})).rejects.toThrow();
|
||
});
|
||
|
||
it('replaceMobileBean 直接替换内容', async () => {
|
||
await useLedgerStore.getState().loadLedger([sampleLedger], new MemoryBackend());
|
||
await useLedgerStore.getState().replaceMobileBean('REPLACED');
|
||
expect(useLedgerStore.getState().mobileBean).toBe('REPLACED');
|
||
});
|
||
|
||
it('refresh 重新解析账本', async () => {
|
||
await useLedgerStore.getState().loadLedger([sampleLedger], new MemoryBackend());
|
||
// refresh 不改变账户数(文件未变)
|
||
await useLedgerStore.getState().refresh();
|
||
expect(useLedgerStore.getState().ledger!.accounts.size).toBe(4);
|
||
});
|
||
|
||
it('reset 回到初始状态', async () => {
|
||
await useLedgerStore.getState().loadLedger([sampleLedger], new MemoryBackend());
|
||
useLedgerStore.getState().reset();
|
||
const state = useLedgerStore.getState();
|
||
expect(state.ledger).toBeNull();
|
||
expect(state.mobileStore).toBeNull();
|
||
expect(state.mobileBean).toBe('');
|
||
});
|
||
});
|
||
|
||
describe('importStore', () => {
|
||
beforeEach(async () => {
|
||
await useLedgerStore.getState().loadLedger([sampleLedger], new MemoryBackend());
|
||
});
|
||
|
||
it('setContext 设置规则/分类', () => {
|
||
useImportStore.getState().setContext({
|
||
rules: [{ id: 'r1', priority: 10, counterpartyContains: '咖啡', sourceAccount: 'Assets:Alipay', categoryAccount: 'Expenses:Food', hits: 0 }],
|
||
});
|
||
expect(useImportStore.getState().rules).toHaveLength(1);
|
||
});
|
||
|
||
it('importCsv 生成事件', () => {
|
||
const events = useImportStore.getState().importCsv(sampleStatement, 'alipay-csv-v1');
|
||
expect(events).toHaveLength(2);
|
||
expect(useImportStore.getState().events).toHaveLength(2);
|
||
});
|
||
|
||
it('process 走 BillPipeline 生成草稿', async () => {
|
||
useImportStore.getState().importCsv(sampleStatement, 'alipay-csv-v1');
|
||
const ledger = useLedgerStore.getState().ledger!;
|
||
const result = await useImportStore.getState().process(ledger, []);
|
||
expect(result.drafts.length).toBeGreaterThan(0);
|
||
expect(useImportStore.getState().pendingDrafts.length).toBeGreaterThan(0);
|
||
});
|
||
|
||
it('confirmDraft 移除已确认草稿并返回它', async () => {
|
||
useImportStore.getState().importCsv(sampleStatement, 'alipay-csv-v1');
|
||
const ledger = useLedgerStore.getState().ledger!;
|
||
await useImportStore.getState().process(ledger, []);
|
||
const before = useImportStore.getState().pendingDrafts.length;
|
||
const confirmed = useImportStore.getState().confirmDraft(0);
|
||
expect(confirmed).not.toBeNull();
|
||
expect(useImportStore.getState().pendingDrafts.length).toBe(before - 1);
|
||
});
|
||
|
||
it('rejectDraft 移除草稿', async () => {
|
||
useImportStore.getState().importCsv(sampleStatement, 'alipay-csv-v1');
|
||
const ledger = useLedgerStore.getState().ledger!;
|
||
await useImportStore.getState().process(ledger, []);
|
||
const before = useImportStore.getState().pendingDrafts.length;
|
||
useImportStore.getState().rejectDraft(0);
|
||
expect(useImportStore.getState().pendingDrafts.length).toBe(before - 1);
|
||
});
|
||
|
||
it('clear 清空本次导入', async () => {
|
||
useImportStore.getState().importCsv(sampleStatement, 'alipay-csv-v1');
|
||
const ledger = useLedgerStore.getState().ledger!;
|
||
await useImportStore.getState().process(ledger, []);
|
||
useImportStore.getState().clear();
|
||
expect(useImportStore.getState().events).toHaveLength(0);
|
||
expect(useImportStore.getState().pendingDrafts).toHaveLength(0);
|
||
});
|
||
});
|
||
|
||
describe('settingsStore', () => {
|
||
it('默认值正确', () => {
|
||
const s = useSettingsStore.getState();
|
||
expect(s.dedupEnabled).toBe(true);
|
||
expect(s.transferRecognitionEnabled).toBe(true);
|
||
expect(s.themeMode).toBe('system');
|
||
expect(s.locale).toBe('zh');
|
||
expect(s.appLockEnabled).toBe(false);
|
||
});
|
||
|
||
it('updateDedupConfig 局部更新', () => {
|
||
useSettingsStore.getState().updateDedupConfig({ timeWindowMinutes: 10 });
|
||
expect(useSettingsStore.getState().dedupConfig.timeWindowMinutes).toBe(10);
|
||
expect(useSettingsStore.getState().dedupConfig.checkAccountLink).toBe(true); // 其他字段保留
|
||
});
|
||
|
||
it('updateTransferConfig 局部更新', () => {
|
||
useSettingsStore.getState().updateTransferConfig({ timeWindowHours: 48 });
|
||
expect(useSettingsStore.getState().transferConfig.timeWindowHours).toBe(48);
|
||
});
|
||
|
||
it('setThemeMode / setLocale / setAppLockEnabled', () => {
|
||
useSettingsStore.getState().setThemeMode('dark');
|
||
useSettingsStore.getState().setLocale('en');
|
||
useSettingsStore.getState().setAppLockEnabled(true);
|
||
const s = useSettingsStore.getState();
|
||
expect(s.themeMode).toBe('dark');
|
||
expect(s.locale).toBe('en');
|
||
expect(s.appLockEnabled).toBe(true);
|
||
});
|
||
|
||
it('persistTo 钩子在状态变更后被调用', () => {
|
||
// 使用 store 的 subscribe 来验证状态变更通知
|
||
const changes: string[] = [];
|
||
const unsub = useSettingsStore.subscribe((state, prevState) => {
|
||
if (state !== prevState) {
|
||
changes.push(state.themeMode);
|
||
}
|
||
});
|
||
useSettingsStore.getState().setThemeMode('dark');
|
||
expect(changes).toHaveLength(1);
|
||
expect(changes[0]).toBe('dark');
|
||
unsub();
|
||
});
|
||
|
||
it('hydrate 从持久化源恢复', () => {
|
||
useSettingsStore.getState().hydrate({ themeMode: 'dark', locale: 'en', appLockEnabled: true });
|
||
const s = useSettingsStore.getState();
|
||
expect(s.themeMode).toBe('dark');
|
||
expect(s.locale).toBe('en');
|
||
expect(s.appLockEnabled).toBe(true);
|
||
// 未提供的字段用默认值
|
||
expect(s.dedupEnabled).toBe(true);
|
||
});
|
||
});
|