DriftLedger/tests/automation.test.ts
fengmengqi 7fa345b558 feat: 品牌重命名为浮记(DriftLedger),全面升级精度安全与架构
品牌与配置
- 重命名 Bean Mobile → 浮记(DriftLedger),slug 改为 drift-ledger
- 所有 Config Plugin 从 app.json 动态读取 appId,替换硬编码 com.beancount.mobile
- 预构建时自动从 constants.ts 同步支付包名列表到 Kotlin 端
- size-optimization 插件新增 NDK 版本强制统一(27.1.12297006)
- 添加 app icon(direction_a_feather.png)
Decimal 精度改造
- 全面消除 parseFloat 用于金额计算的场景,改用 string decimal 运算
- 新增 divideDecimals(除法)、toDateString(Date→YYYY-MM-DD)
- negateDecimal 零值特殊处理,避免产生 "-0"
- 年报/月报/预算/信用卡/汇率/图表统计等模块全部迁移
- 去重指纹用 parseDecimal 归一化金额格式
- 转账识别增加 normalizeAmount,支持不同精度格式配对(100 vs 100.00)
架构变更
- mobile.bean → main.bean:移除启动时合并迁移逻辑,直接读写 main.bean
- TransactionDraft.sourceEventId → sourceEventIds(数组,支持转账双方)
- 新增 buildPostings() 纯函数,从 transactionBuilder 提取复式分录构建逻辑
- 新增 csvUtils.ts(引号感知 CSV 行拆分),statements/adapters 共用
- 新增 accessibilityParser.ts:从 automationPipeline 提取微信/支付宝文本解析
- 新增 floatingBillManager.ts:悬浮窗草稿管理(LRU+超时)与排序数据构建
- 新增 txKeyStore.ts:交易级去重键持久化(原子写入+500条LRU)
- ledger.ts 新增 resolveIncludes 选项,支持 include 指令递归解析
- metadataStore CRUD 用 createCrudActions 工厂消除7组实体重复代码
安全与持久化
- PIN 哈希改用带盐 SHA-256,兼容旧版无 salt 数据迁移
- storePersistence 从 persistTo 回调改为 subscribe 自动触发
- 持久化增加深比较跳过无变化写入 + 滞后重试
- 新增 flushPersistence(),App 切后台时立即刷盘
- CrashReporter 新增文件持久化(CrashFs 抽象)
- settingsStore hydrate 期间跳过自动持久化(skipPersist 标志)
去重与管道
- batchDedup 改用日期索引 Map,候选查找从 O(n) 降至 O(1)
- dedupAgainstHistory 按日期分组,仅扫描时间窗口内候选
- OcrProcessor 从布尔标志改为 Promise 队列,不再丢弃并发请求
- 去重缓存改用 Map<hash,timestamp> LRU,阈值超20%时批量淘汰
- 悬浮球全局开关(floatingBallEnabled) + 原生 bridge API
其他改进
- recurring 计算修复月/年溢出(1月31日+1月→2月28日,闰年2月29日)
- 预算进度按 posting 分录金额求和(不再仅过滤负数金额)
- recurring.ts 用 Date.parse 本地时间替代 toISOString 的 UTC 偏移
- 信用卡账单日/还款日限制不超过28,防止月份溢出
- 类别模糊匹配增加最小长度2,避免单字符误匹配
- 还款检测排除 refund 方向,避免退款被误判为还款
- WebDAV 同步增加 HTTP 日期格式解析
- Git 合并策略改为以 remote 为基础追加 local 独有行
性能优化
- commonStyles 全局 useMemo 缓存
- Button/Card 的 pressIn/pressOut 改用 useCallback
- TransactionCard/AccountTreeNode 包裹 React.memo
- PostingEditor 用 refs + 函数式更新避免重建
- CreditCard 页预计算账户余额 Map,避免渲染循环重复遍历
- OCR 处理器单例复用,配置变更时才重建
- getLocalAuth/getAccessibilityBridge 结果缓存
测试
- 新增 decimal/constants/channelConfig/transactionBuilder 单测
- 修复金额格式断言(-24.5→-24.50),匹配字符串精度行为
- billPipeline 新增不同格式金额配对、指纹唯一性测试
2026-07-21 15:16:44 +08:00

256 lines
9.3 KiB
TypeScript
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

import { describe, expect, it, beforeEach } from 'vitest';
import { NativeOcrBridge, SimulatedOcrBridge, type NativeOcrModule } from '../src/services/ocrBridge';
import { ScreenshotChannel, SimulatedScreenshotListener, type ScreenshotEvent } from '../src/services/screenshot';
import { NotificationChannel, SimulatedNotificationListener, parseNotification, DEFAULT_PAYMENT_PACKAGES, type NotificationEvent } from '../src/services/notification';
import { SmsChannel, SimulatedSmsListener, parseSms, isBankSms, type SmsEvent } from '../src/services/sms';
import { OcrProcessor, MockOcrEngine } from '../src/domain/ocrProcessor';
beforeEach(() => {
// 各测试自建实例,无需全局重置
});
// ============ ocrBridge ============
describe('ocrBridge', () => {
it('NativeOcrBridge 用原生模块', async () => {
const native: NativeOcrModule = {
recognizeText: async () => '微信支付 金额 10 商户:x',
recognizeTextBlocks: async () => [],
isReady: async () => true,
};
const bridge = new NativeOcrBridge(native);
expect(await bridge.recognizeText('img')).toBe('微信支付 金额 10 商户:x');
});
it('原生失败时降级到 fallback', async () => {
const native: NativeOcrModule = {
recognizeText: async () => { throw new Error('原生崩溃'); },
recognizeTextBlocks: async () => [],
isReady: async () => false,
};
const fallback = new SimulatedOcrBridge();
fallback.preset('fallback', '降级文本');
const bridge = new NativeOcrBridge(native, fallback);
expect(await bridge.recognizeText('fallback')).toBe('降级文本');
});
it('无原生无 fallback 抛错', async () => {
const bridge = new NativeOcrBridge(null);
await expect(bridge.recognizeText('img')).rejects.toThrow('未加载');
});
it('SimulatedOcrBridge 按 key 返回预设', async () => {
const sim = new SimulatedOcrBridge();
sim.preset('wechat-screenshot', '微信支付 金额 20');
expect(await sim.recognizeText('wechat-screenshot')).toContain('微信支付');
expect(await sim.recognizeText('unknown')).toBe('');
});
});
// ============ screenshot ============
describe('ScreenshotChannel', () => {
it('处理截图 → OCR 识别成功', async () => {
const ocrEngine = new MockOcrEngine();
ocrEngine.defaultResponse = '微信支付 金额 24.50 商户:星巴克 2026-07-13 14:30';
const processor = new OcrProcessor(ocrEngine);
const channel = new ScreenshotChannel(processor);
const event: ScreenshotEvent = {
uri: 'content://media/screenshots/screenshot_123.png',
base64: 'img-data',
timestamp: Date.now(),
};
const result = await channel.handleScreenshot(event);
expect(result.layer).toBe('layer1-rule');
expect(result.event?.amount).toBe('-24.50');
});
it('去重:同一 URI 不重复处理', async () => {
const ocrEngine = new MockOcrEngine();
ocrEngine.defaultResponse = '微信支付 金额 10 商户:x';
const processor = new OcrProcessor(ocrEngine);
const channel = new ScreenshotChannel(processor);
const event: ScreenshotEvent = {
uri: 'content://media/screenshots/dup.png',
base64: 'img',
timestamp: Date.now(),
};
const r1 = await channel.handleScreenshot(event);
const r2 = await channel.handleScreenshot(event);
expect(r1.layer).toBe('layer1-rule');
expect(r2.skipped).toBe('dedup');
});
it('非截图 URI 过滤', async () => {
const processor = new OcrProcessor(new MockOcrEngine());
const channel = new ScreenshotChannel(processor);
const result = await channel.handleScreenshot({
uri: 'content://media/photos/normal.jpg',
base64: 'img',
timestamp: Date.now(),
});
expect(result.skipped).toBe('dedup');
});
it('超过 30 秒的旧截图过滤', async () => {
const processor = new OcrProcessor(new MockOcrEngine());
const channel = new ScreenshotChannel(processor);
const result = await channel.handleScreenshot({
uri: 'content://screenshots/old.png',
base64: 'img',
timestamp: Date.now() - 60_000,
});
expect(result.skipped).toBe('dedup');
});
it('onScreenshot 回调触发', async () => {
const ocrEngine = new MockOcrEngine();
ocrEngine.defaultResponse = '微信支付 金额 10 商户:x';
const processor = new OcrProcessor(ocrEngine);
const channel = new ScreenshotChannel(processor);
let callbackResult: string | null = null;
channel.onScreenshot((result) => { callbackResult = result.event?.amount ?? null; });
await channel.handleScreenshot({ uri: 'content://screenshots/x.png', base64: 'img', timestamp: Date.now() });
expect(callbackResult).toBe('-10');
});
it('SimulatedScreenshotListener start/stop/simulate', async () => {
const listener = new SimulatedScreenshotListener();
const events: ScreenshotEvent[] = [];
await listener.start(e => events.push(e));
expect(listener.isListening()).toBe(true);
listener.simulate({ uri: 'x', timestamp: 0 });
expect(events).toHaveLength(1);
await listener.stop();
expect(listener.isListening()).toBe(false);
});
});
// ============ notification ============
describe('NotificationChannel', () => {
it('parseNotification 微信支付', () => {
const event: NotificationEvent = {
packageName: 'com.tencent.mm', title: '微信支付',
text: '金额 24.50 商户:星巴克', timestamp: Date.now(),
};
const bill = parseNotification(event);
expect(bill).not.toBeNull();
expect(bill?.amount).toBe('-24.50');
});
it('白名单过滤:非支付 App', () => {
const channel = new NotificationChannel();
const result = channel.handleNotification({
packageName: 'com.other.app', title: '通知', text: '内容', timestamp: Date.now(),
});
expect(result.processed).toBe(false);
expect(result.reason).toBe('非白名单包');
});
it('白名单内 + 命中规则', () => {
const channel = new NotificationChannel();
const result = channel.handleNotification({
packageName: 'com.tencent.mm', title: '微信支付', text: '金额 10 商户:x', timestamp: Date.now(),
});
expect(result.processed).toBe(true);
});
it('MD5 去重', () => {
const channel = new NotificationChannel();
const event: NotificationEvent = {
packageName: 'com.tencent.mm', title: '微信支付', text: '金额 10 商户:x', timestamp: Date.now(),
};
const r1 = channel.handleNotification(event);
const r2 = channel.handleNotification(event);
expect(r1.processed).toBe(true);
expect(r2.reason).toBe('MD5 去重');
});
it('onBillDetected 回调', () => {
const channel = new NotificationChannel();
let detected = false;
channel.onBillDetected(() => { detected = true; });
channel.handleNotification({
packageName: 'com.tencent.mm', title: '微信支付', text: '金额 10 商户:x', timestamp: Date.now(),
});
expect(detected).toBe(true);
});
it('DEFAULT_PAYMENT_PACKAGES 含微信支付宝', () => {
expect(DEFAULT_PAYMENT_PACKAGES).toContain('com.tencent.mm');
expect(DEFAULT_PAYMENT_PACKAGES).toContain('com.eg.android.AlipayGphone');
});
});
// ============ sms ============
describe('SmsChannel', () => {
it('parseSms 银行短信', () => {
const event: SmsEvent = {
sender: '95588', body: '工商银行尾号1234于超市消费100.50元余额5000元',
timestamp: Date.now(),
};
const bill = parseSms(event);
expect(bill).not.toBeNull();
expect(bill?.amount).toBe('-100.50');
expect(bill?.direction).toBe('expense');
expect(bill?.memo).toContain('1234');
});
it('parseSms 退款', () => {
const event: SmsEvent = {
sender: '95533', body: '建设银行尾号5678退款30元',
timestamp: Date.now(),
};
const bill = parseSms(event);
expect(bill?.direction).toBe('refund');
});
it('parseSms 无金额返回 null', () => {
const bill = parseSms({ sender: '95588', body: '余额提醒', timestamp: 0 });
expect(bill).toBeNull();
});
it('isBankSms 判断', () => {
expect(isBankSms('您有一笔交易')).toBe(true);
expect(isBankSms('验证码是1234')).toBe(false);
});
it('SmsChannel 非银行短信过滤', () => {
const channel = new SmsChannel();
const result = channel.handleSms({ sender: '10086', body: '话费提醒', timestamp: 0 });
expect(result.processed).toBe(false);
expect(result.reason).toBe('非银行短信');
});
it('SmsChannel 银行短信处理成功', () => {
const channel = new SmsChannel();
const result = channel.handleSms({
sender: '95588', body: '尾号1234消费100元', timestamp: Date.now(),
});
expect(result.processed).toBe(true);
});
it('SmsChannel MD5 去重', () => {
const channel = new SmsChannel();
const event: SmsEvent = { sender: '95588', body: '尾号1234消费100元', timestamp: 0 };
const r1 = channel.handleSms(event);
const r2 = channel.handleSms(event);
expect(r1.processed).toBe(true);
expect(r2.reason).toBe('MD5 去重');
});
it('SimulatedSmsListener simulate', async () => {
const listener = new SimulatedSmsListener();
const events: SmsEvent[] = [];
await listener.start(e => events.push(e));
listener.simulate({ sender: 'x', body: 'y', timestamp: 0 });
expect(events).toHaveLength(1);
await listener.stop();
});
});