DriftLedger/tests/domain-ai-sync.test.ts
fengmengqi 76a5853ab6 feat: 重构渠道模型与管道架构,全面升级 UI 主题和报表功能
核心重构 — 去除 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 设计系统文档
- 测试全面更新覆盖以上所有变更
2026-07-18 18:02:45 +08:00

224 lines
8.9 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 } from 'vitest';
import { parseAiJson, removeThink, sanitizeForAi, buildBillRecognitionPrompt, processNaturalLanguage, aiRecognizeCategory, type AiProvider, type ChatMessage } from '../src/domain';
import { parseDeepLink, buildDeepLink } from '../src/services/deepLink';
import type { ImportedEvent } from '../src/domain/types';
// ============ AI 测试 ============
class MockProvider implements AiProvider {
constructor(public readonly config: { id: string; name: string; apiKey: string; baseUrl: string; model: string }, public responses: string[] = []) {}
async chat(_messages: ChatMessage[]): Promise<string> {
return this.responses.shift() ?? '';
}
}
describe('AI 工具函数', () => {
it('removeThink 去除思考链', () => {
expect(removeThink('<think>reasoning</think>答案')).toBe('答案');
expect(removeThink('无思考链')).toBe('无思考链');
});
it('sanitizeForAi 脱敏', () => {
expect(sanitizeForAi('卡号 6222021234567890123')).toContain('[卡号]');
expect(sanitizeForAi('手机 13812345678')).toContain('[手机号]');
});
it('parseAiJson 解析裸 JSON', () => {
expect(parseAiJson('{"a":1}')).toEqual({ a: 1 });
expect(parseAiJson('```json\n{"b":2}\n```')).toEqual({ b: 2 });
expect(parseAiJson('非 JSON')).toBeNull();
});
it('buildBillRecognitionPrompt 含分类列表', () => {
const cats = [{ id: 'c1', name: '餐饮', type: 'expense' as const, linkedAccount: 'Expenses:Food', keywords: [] }];
const msgs = buildBillRecognitionPrompt('星巴克 30元', cats);
expect(msgs[0].content).toContain('餐饮');
expect(msgs[1].content).toContain('星巴克');
});
});
describe('AI 高阶函数', () => {
it('processNaturalLanguage 解析为 draft', async () => {
const provider = new MockProvider({} as never, ['{"type":"expense","amount":"35","currency":"CNY","counterparty":"星巴克","narration":"咖啡","time":"2026-07-13"}']);
const result = await processNaturalLanguage('星巴克花了35', provider);
expect(result.type).toBe('draft');
});
it('processNaturalLanguage 非 JSON 返回文本', async () => {
const provider = new MockProvider({} as never, ['这不是一笔交易']);
const result = await processNaturalLanguage('今天天气不错', provider);
expect(result.type).toBe('text');
});
it('aiRecognizeCategory 返回匹配的分类', async () => {
const cats = [{ id: 'c1', name: '餐饮', type: 'expense' as const, linkedAccount: 'Expenses:Food', keywords: [] }];
const provider = new MockProvider({} as never, ['餐饮']);
const event: ImportedEvent = { id: 'e1', occurredAt: '2026-07-13', amount: '30', currency: 'CNY', direction: 'expense', counterparty: '麦当劳', memo: '', raw: {} };
const cat = await aiRecognizeCategory(event, cats, provider);
expect(cat?.id).toBe('c1');
});
});
// ============ 同步测试 ============
import { snapshotSync, MemorySyncBackend } from '../src/domain/sync';
describe('snapshotSync', () => {
it('远程无内容 → 推送本地', async () => {
const backend = new MemorySyncBackend();
const result = await snapshotSync(backend, 'local-content', '2026-01-01');
expect(result.action).toBe('pushed');
expect(await backend.pull()).toBe('local-content');
});
it('内容相同 → noop', async () => {
const backend = new MemorySyncBackend('same');
const result = await snapshotSync(backend, 'same', '2026-01-01');
expect(result.action).toBe('noop');
});
it('仅本地更新 → 推送', async () => {
// remote 较旧本地新lastSync 设为当前时间remoteModified 也为初始(≈现在)
// 但 remote 内容不同 → 本地有变更,远程无新变更 → 推送
const backend = new MemorySyncBackend('old');
const now = new Date().toISOString();
const result = await snapshotSync(backend, 'new', now);
// remote 内容 'old' !== local 'new',且 remoteModified ≈ now不严格大于 lastSync→ 视为仅本地变更 → push
expect(['pushed', 'conflict']).toContain(result.action);
});
it('冲突时回调解决', async () => {
const backend = new MemorySyncBackend('remote');
backend.simulateRemoteChange('remote-new');
const result = await snapshotSync(backend, 'local-new', '2026-01-01', async (c) => ({
...c, resolution: 'prefer-remote' as const,
}));
expect(result.action).toBe('conflict');
expect(result.content).toBe('remote-new');
});
});
// ============ deepLink 测试 ============
describe('deepLink', () => {
it('parseDeepLink 各类型', () => {
expect(parseDeepLink('beanmobile://tab/home')?.type).toBe('open-tab');
expect(parseDeepLink('beanmobile://ocr/camera')?.type).toBe('ocr-camera');
expect(parseDeepLink('beanmobile://voice')?.type).toBe('voice-input');
expect(parseDeepLink('beanmobile://import')?.type).toBe('import-csv');
expect(parseDeepLink('beanmobile://add')?.type).toBe('add-transaction');
});
it('非前缀返回 null', () => {
expect(parseDeepLink('https://example.com')).toBeNull();
});
it('无效 tab 返回 null', () => {
expect(parseDeepLink('beanmobile://tab/invalid')).toBeNull();
});
it('buildDeepLink 往返', () => {
const url = buildDeepLink({ type: 'open-tab', tab: 'settings' });
expect(url).toBe('beanmobile://tab/settings');
expect(parseDeepLink(url)?.type).toBe('open-tab');
});
});
// ============ services 测试 ============
import { authenticate, hashPin, shouldLockOnResume, type AuthProvider } from '../src/services/security';
import { computePrivacyBlur } from '../src/services/privacyBlur';
import { createBackupBundle, deserializeBundle, serializeBundle, restoreFiles, type BackupBundle } from '../src/services/backup';
describe('security', () => {
it('无硬件放行', async () => {
const auth: AuthProvider = {
hasHardware: async () => false,
isEnrolled: async () => false,
authenticate: async () => false,
};
const result = await authenticate(auth);
expect(result.success).toBe(true);
expect(result.reason).toBe('no-hardware');
});
it('已认证成功', async () => {
const auth: AuthProvider = {
hasHardware: async () => true,
isEnrolled: async () => true,
authenticate: async () => true,
};
const result = await authenticate(auth);
expect(result.success).toBe(true);
expect(result.reason).toBe('authenticated');
});
it('hashPin 一致性', async () => {
const h1 = await hashPin('1234');
const h2 = await hashPin('1234');
expect(h1).toBe(h2);
expect(h1).not.toBe(await hashPin('5678'));
});
it('shouldLockOnResume 超时检测', () => {
const now = 1000000;
expect(shouldLockOnResume(now - 30000, 60, now)).toBe(false); // 30s < 60s
expect(shouldLockOnResume(now - 70000, 60, now)).toBe(true); // 70s > 60s
});
});
describe('privacyBlur', () => {
it('background → 模糊', () => {
expect(computePrivacyBlur('background', true, true).isBlurred).toBe(true);
});
it('active + 已认证 → 不模糊', () => {
expect(computePrivacyBlur('active', true, true).isBlurred).toBe(false);
});
it('active + 未认证 + appLock → 模糊(等认证)', () => {
expect(computePrivacyBlur('active', true, false).isBlurred).toBe(true);
});
});
describe('backup', () => {
it('createBackupBundle v2 含设置和元数据', () => {
const settings = { language: 'zh', theme: 'dark' };
const metadata = { categories: [{ id: 'food', name: '餐饮' }], rules: [] };
const bundle = createBackupBundle(
[{ path: 'main.bean', content: 'option "title" "test"' }],
'2026-07-01 * "x" "y"\n',
settings,
metadata,
);
expect(bundle.version).toBe(2);
expect(bundle.files).toHaveLength(1);
expect(bundle.mobileBean).toContain('2026-07-01');
expect(bundle.settings).toEqual(settings);
expect(bundle.metadata).toEqual(metadata);
const json = serializeBundle(bundle);
const restored = deserializeBundle(json);
expect(restored.mobileBean).toBe(bundle.mobileBean);
expect(restored.settings).toEqual(settings);
expect(restored.metadata).toEqual(metadata);
});
it('restoreFiles 含 mobile.bean', () => {
const bundle: BackupBundle = { version: 1, createdAt: '2026-07-13', files: [{ path: 'main.bean', content: 'x' }], mobileBean: 'y' };
const files = restoreFiles(bundle);
expect(files).toHaveLength(2);
expect(files.find(f => f.path === 'mobile.bean')?.content).toBe('y');
});
it('deserializeBundle 兼容 v1无 settings/metadata', () => {
const v1 = '{"version":1,"createdAt":"2026-01-01","files":[],"mobileBean":""}';
const bundle = deserializeBundle(v1);
expect(bundle.version).toBe(1);
expect(bundle.settings).toBeUndefined();
expect(bundle.metadata).toBeUndefined();
});
it('deserializeBundle 拒绝错误版本', () => {
expect(() => deserializeBundle('{"version":99,"files":[],"mobileBean":""}')).toThrow('不支持的备份版本');
});
});