核心重构 — 去除 channel 字段,引入 sourceAccount 模型: - 从 ImportedEvent、Rule、EnhancedRule、OcrRule 等接口中彻底移除 channel 字段 - rules.ts 中 resolveChannelAccount → resolveSourceAccount,规则匹配与账户解析不再依赖渠道概念 - dedup.ts 重写去重逻辑:从基于渠道匹配改为基于交易对手(counterparty)匹配,支持相同金额/交易对手/时间窗口的多级置信度判断 - transferRecognizer.ts 增加资产负债表账户校验,确保转账双方均为 Assets/Liabilities 类账户 - 全局替换影响:types、rules、ocr、adapters、adapters-migrations、所有服务层和测试 新增基础设施: - domain/constants.ts — 统一常量定义(支付包名、截图关键词、去重参数、方向检测函数 detectDirection()),消除 OCR/SMS/截图等模块的重复定义 - domain/channelConfig.ts — 渠道配置系统(支付宝/微信/银行),支持按包名和名称查找 - domain/pipelineSingleton.ts — 共享 BillPipeline 单例,解决 importStore/automationStore 的互斥锁共享问题 - domain/transactionBuilder.ts — 统一交易构建入口 buildAndSaveTransaction(),同时服务手动录入和无障碍监听 OCR 增强: - 新增账单详情页解析(parseDetailPageBill),支持支付宝/微信详情页结构化提取 - checkIsDetailPage() 识别详情页特征词,防止误提取(如"消费1次"被误读为金额) - 金额正则支持千分位逗号分隔,商户名正则改用 lookahead 边界匹配 - 时间解析支持中文格式(年月日)和跨年推断 - OcrProcessor 新增详情页路由,跳过 Layer 1 规则匹配 UI 全面升级: - 主题重设计:accent 色从绿色改为靛蓝(#4F46E5),深色模式适配 OLED 纯黑,引入 Quicksand/Caveat 字体 - 新增 commonStyles.ts 统一 chip/input/modal 等通用样式 - 首页 Bento 网格布局:净资产英雄卡片 + 定期账单/月度统计并排展示 - 报表新增周报标签页,月报整合日历视图(支持点击查看当日交易明细) - TrendLine 图表从 View 条形图重写为 SVG 贝塞尔曲线 - CategoryPicker 从水平滚动改为 4 列网格 + emoji 图标 - Button/Card 增加 press 缩放动画 管道与自动化改进: - automationPipeline.ts 新增 handleIncomingBillEvent() 实时账单处理(悬浮账单卡片 + 前台 Alert 确认) - 新增无障碍文本直解析 parseAndProcessAccessibilityTexts(),微信/支付宝详情页绕过 OCR - rules.ts 新增智能还款检测(花呗/信用卡还款自动路由)和退款视为收入处理 - metadataStore 默认规则精简为 6 条通用规则,移除约 20 条个人化硬编码规则 存储与同步: - storePersistence.ts 原子写入 + 崩溃恢复 + 重试机制 - 备份升级到 v2 格式,包含 settings 和 metadata - 同步路径统一从 mobile.bean 改为 main.bean - _layout.tsx 启动时自动迁移旧 mobile.bean 到 main.bean 其他: - 删除独立日历页面,功能合并到报表月报标签 - i18n 清理:移除渠道相关翻译,新增 50+ 翻译键 - docs/android-build-guide.md 重写为 APK 体积优化指南 - 新增 design-system/beancount-mobile/MASTER.md 设计系统文档 - 测试全面更新覆盖以上所有变更
256 lines
9.3 KiB
TypeScript
256 lines
9.3 KiB
TypeScript
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.5');
|
||
});
|
||
|
||
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.5');
|
||
});
|
||
|
||
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.5');
|
||
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();
|
||
});
|
||
});
|