/** * 鸿蒙侧的**可执行判据** —— 跑的是客户端真正会跑的那份逻辑。 * * 为什么要有这个文件: * * 移交信里交代的头号纪律是「判据必须点用户真正会点的那一层」—— WebUI 侧就是因为 * 只验了结构与样式、**一次都没点过**,漏掉了"点日历/联系人不翻页"的 bug 一路到线上。 * 而鸿蒙侧现在**没有设备**(`hdc list targets` 为空、模拟器在本机沙箱下起不来), * 于是"点一下"这件事在鸿蒙上暂时无法自动验。 * * 应对办法不是编个假判据,而是把**会点的那一层的内核**抽出来: * `client/harmony/entry/src/main/ets/model/MailGrouping.ts` 是纯逻辑、无 UI 依赖, * 本文件用 node 的 `--experimental-strip-types` **直接执行它**,断言的是行为 * (折叠后组头是不是最新一封、单封是不是不成组、预算剩 1 个来回是什么档)。 * 页面那一层再用源码判据钉住"确实调了这些函数"—— 两层合起来, * 「逻辑对」+「页面接上了」都有判据;剩下的"手感/观感"如实标注未验。 * * 与 WebUI 的对应物:`src/lib/mailGroups.ts`(折叠 / isFlatGroup)、 * `src/components/WorkCard.tsx` 的 `BudgetChip`(预算档位)、`ContactPanel.tsx`(视图切换)。 */ import { test } from 'node:test'; import assert from 'node:assert/strict'; import { readFileSync } from 'node:fs'; import { dirname, join } from 'node:path'; import { fileURLToPath, pathToFileURL } from 'node:url'; const HERE = dirname(fileURLToPath(import.meta.url)); const ROOT = join(HERE, '..', '..', '..'); const HARMONY_ETS = join(ROOT, 'client/harmony/entry/src/main/ets'); const MODULE_TS = join(HARMONY_ETS, 'model/MailGrouping.ts'); /** 被测对象:鸿蒙客户端真正引用的那份逻辑(不是复制品) */ const H = await import(pathToFileURL(MODULE_TS).href); const page = readFileSync(join(HARMONY_ETS, 'pages/MainPage.ets'), 'utf8'); const webGroups = readFileSync(join(ROOT, 'client/electron/src/lib/mailGroups.ts'), 'utf8'); const webCard = readFileSync(join(ROOT, 'client/electron/src/components/WorkCard.tsx'), 'utf8'); /** 造一封邮件(只带折叠/渲染用得到的字段,字段名与 Models.ets 的 MailSummary 一致) */ const mail = (over) => Object.assign( { mail_id: 'm-' + Math.random().toString(36).slice(2, 8), session_id: 's1', session_alias: '', from_name: 'pi', subject: '主题', body_preview: '预览', created_at: '2026-09-14T10:00:00Z', status: 'read', permission_mode: '', source_account_id: 'acct-1', source_account_name: '工作邮箱' }, over ); // ───────────────────────── 收件箱折叠 ───────────────────────── test('折叠:同一个会话的信合成一组,组头取**最新一封**', () => { const older = mail({ mail_id: 'm-a', session_id: 's1', created_at: '2026-09-14T09:00:00Z', subject: '旧主题', session_alias: '旧别名' }); const newer = mail({ mail_id: 'm-b', session_id: 's1', created_at: '2026-09-14T11:00:00Z', subject: '新主题', session_alias: 'fix-x', status: 'unread' }); const groups = H.groupMailsBySession([older, newer]); assert.equal(groups.length, 1, '同一个 session_id 应该只有一组'); assert.equal(groups[0].alias, 'fix-x', '组头别名应取最新一封'); assert.equal(groups[0].subject, '新主题', '组头主题应取最新一封(会话主题会随任务推进被改写)'); assert.equal(groups[0].latest.mail_id, 'm-b'); assert.equal(groups[0].unreadCount, 1, '组内未读数'); assert.deepEqual(groups[0].mails.map(m => m.mail_id), ['m-b', 'm-a'], '组内按时间倒序'); }); test('★ 判据自检:把组头当成"第一封"而不是"最新一封"必须判红', () => { // 故意按"旧 → 新"传入:实现里少了 sort 的话,mails[0] 就是旧的,组头会写错 const older = mail({ mail_id: 'm-a', session_id: 's1', created_at: '2026-09-14T09:00:00Z', subject: '旧主题' }); const newer = mail({ mail_id: 'm-b', session_id: 's1', created_at: '2026-09-14T11:00:00Z', subject: '新主题' }); const groups = H.groupMailsBySession([older, newer]); assert.notEqual(groups[0].subject, '旧主题', '组头取到了旧的那封 —— 折叠没有排序'); }); test('单封的组不算「组」(与 WebUI isFlatGroup 同一结论)', () => { const one = H.groupMailsBySession([mail({ session_id: 's1' })]); const two = H.groupMailsBySession([mail({ session_id: 's1' }), mail({ session_id: 's1', created_at: '2026-09-14T11:00:00Z' })]); assert.equal(H.isFlatGroup(one[0]), true); assert.equal(H.isFlatGroup(two[0]), false); // WebUI 侧同一条规则仍在(哪边改了口径,这条会红) assert.match(webGroups, /export function isFlatGroup\(g: MailGroup\): boolean \{\s*return g\.mails\.length === 1;/, 'WebUI 的 isFlatGroup 口径变了'); }); test('组间按最新一封倒序;时间相同时用 mail_id 倒序兜底', () => { const a = mail({ mail_id: 'm-1', session_id: 'sa', created_at: '2026-09-14T09:00:00Z' }); const b = mail({ mail_id: 'm-2', session_id: 'sb', created_at: '2026-09-14T12:00:00Z' }); const groups = H.groupMailsBySession([a, b]); assert.deepEqual(groups.map(g => g.session_id), ['sb', 'sa']); // 同一时刻:mail_id 倒序(与后端 ORDER BY created_at DESC, mail_id DESC 一致) const t = '2026-09-14T10:00:00Z'; const x = mail({ mail_id: 'm-aaa', session_id: 'sx', created_at: t }); const y = mail({ mail_id: 'm-zzz', session_id: 'sy', created_at: t }); assert.deepEqual(H.groupMailsBySession([x, y]).map(g => g.session_id), ['sy', 'sx']); }); test('时间解析失败不抛错、也不把顺序交给入参(NaN 参与比较恒为 false 的坑)', () => { const bad = mail({ mail_id: 'm-bad', session_id: 'sbad', created_at: '不是时间' }); const good = mail({ mail_id: 'm-ok', session_id: 'sok', created_at: '2026-09-14T10:00:00Z' }); const forward = H.groupMailsBySession([bad, good]).map(g => g.session_id); const backward = H.groupMailsBySession([good, bad]).map(g => g.session_id); assert.deepEqual(forward, backward, '入参顺序换了,结果就变 —— 排序依赖了 NaN 比较'); assert.deepEqual(forward, ['sok', 'sbad']); }); test('鸿蒙特有:多账号收件箱里,同一 session_id 出现在两个账号是两件事', () => { const fromA = mail({ mail_id: 'm-a', session_id: 'shared', source_account_id: 'acct-1' }); const fromB = mail({ mail_id: 'm-b', session_id: 'shared', source_account_id: 'acct-2', created_at: '2026-09-14T11:00:00Z' }); const groups = H.groupMailsBySession([fromA, fromB]); assert.equal(groups.length, 2, '两个账号的同名会话被折叠成了一组 —— 键里少了账号'); }); test('session_id 缺失的信各自成组(一条脏数据不该让整栏空白)', () => { const a = mail({ mail_id: 'm-1', session_id: '' }); const b = mail({ mail_id: 'm-2', session_id: '' }); const groups = H.groupMailsBySession([a, b]); assert.equal(groups.length, 2); assert.equal(H.isFlatGroup(groups[0]), true); }); // ───────────────────────── 未读数与"这一页可能不全" ───────────────────────── test('未读数用服务端 total 相加(它是 CountUnread,权威),负数/0 忽略', () => { assert.equal(H.sumUnreadTotals([3, 4]), 7); assert.equal(H.sumUnreadTotals([0, -1, 2]), 2); assert.equal(H.sumUnreadTotals([]), 0); assert.match(page, /sumUnreadTotals\(/, '页面要用服务端未读数,而不是数这一页'); }); test('只有"取满了这一页"才提示可能还有更多(服务端 total 是未读数,不是总封数)', () => { assert.equal(H.partialLoadNotice(12, 50), '', '没取满就别吓人'); assert.equal(H.partialLoadNotice(50, 50), '已加载 50 封(本页上限 50,可能还有更多)'); assert.equal(H.partialLoadNotice(0, 0), '', 'limit 不合法时不提示'); assert.match(page, /partialLoadNotice\(/, '页面要用这条提示'); }); test('★ 界面不再把"服务端未读数"当成"总封数"显示', () => { // 原先底部写的是「共 N 封」,而那个 N 是 /me/mail/inbox 的 total(= CountUnread), // 于是同一屏上会出现「共 7 封」和「未读 7」这种自相矛盾的两行字。 assert.ok( !/共 ' \+ this\.total \+ ' 封/.test(page), '页面里还有「共 N 封」—— 服务端 total 是未读数,不是总封数' ); assert.match(page, /已加载 ' \+ this\.loaded \+ ' 封/, '应如实说"已加载了多少封"'); }); // ───────────────────────── 预算(与 WebUI BudgetChip 同判据) ───────────────────────── test('往返预算档位与 WebUI 的 BudgetChip 完全一致', () => { // WebUI 的判据(WorkCard.tsx):max<=0 不显示;剩 0 = 用尽;剩 ≤1 = 将尽;其余普通 assert.match(webCard, /if \(!max \|\| max <= 0\) return null;/, 'WebUI 的"不限不显示"口径变了'); assert.match(webCard, /remaining === 0/, 'WebUI 的"用尽"判据变了'); assert.match(webCard, /remaining <= 1/, 'WebUI 的"将尽"判据变了'); // 鸿蒙侧同一批输入必须给出同样的档位 assert.equal(H.budgetState(0, 0), 'none', '上限 0 = 不限,不显示'); assert.equal(H.budgetState(5, 5), 'spent', '剩 0 = 用尽'); assert.equal(H.budgetState(5, 4), 'warn', '剩 1 = 将尽(快跑满的任务要人介入)'); assert.equal(H.budgetState(5, 3), 'ok'); assert.equal(H.budgetState(5, 9), 'spent', '用超了也是用尽,不能算成还剩负数'); assert.equal(H.budgetLabel(5, 4), '1/5'); assert.equal(H.budgetLabel(0, 0), '', '不限时徽标文字是空串(页面据此不渲染)'); assert.match(page, /budgetLabel\(c\.max_rounds, c\.used_rounds\)/, '卡片上要显示预算'); assert.match(page, /budgetState\(c\.max_rounds, c\.used_rounds\)/, '卡片上要用同一档位判据'); }); // ───────────────────────── 联系人页两种视图(为撤掉平级「会话」tab 做准备) ───────────────────────── test('联系人页的列表/卡片切换:点一次换一次,标题用 WebUI 那套词', () => { assert.equal(H.nextContactView('list'), 'card'); assert.equal(H.nextContactView('card'), 'list'); assert.equal(H.contactViewTitle('card'), '工作列表', '卡片视图的标题应与 WebUI 一致'); assert.equal(H.contactViewTitle('list'), '联系人'); assert.match(page, /this\.contactView = nextContactView\(this\.contactView\)/, '切换按钮要走这条判据'); assert.match(page, /contactViewTitle\(this\.contactView\)/, '标题要走这条判据'); }); test('卡片上"最新一封是谁发的":人 vs Agent(决定人要不要接手)', () => { assert.equal(H.lastFromIsHuman('pi', 'jianf'), true); assert.equal(H.lastFromIsHuman('pi', 'pi'), false); assert.match(page, /lastFromIsHuman\(c\.agent_name, c\.last_from\)/, '卡片要用这条判据选图标'); // WebUI 侧同一判据仍在 assert.match(webCard, /const fromHuman = c\.last_from !== c\.agent_name;/, 'WebUI 的 fromHuman 口径变了'); }); // ───────────────────────── 两层的接合:页面确实调了被测逻辑 ───────────────────────── test('页面把折叠逻辑真正接上了(不是"逻辑写好了没人用")', () => { assert.match(page, /import \{[\s\S]*groupMailsBySession[\s\S]*\} from '\.\.\/model\/MailGrouping'/, '页面要 import 折叠逻辑'); assert.match(page, /this\.groups = groupMailsBySession\(mergedMails\)/, '加载后要折叠'); assert.match(page, /if \(isFlatGroup\(g\)\)/, '单封的组要平铺渲染(这条就是"点开会多一次点击"的那个分支)'); assert.match(page, /this\.isExpanded\(g\.key\)/, '多封的组要按展开状态渲染'); assert.match(page, /toggleExpanded\(g\.key\)/, '组头要能点开(用户真正会点的那一层)'); assert.match(page, /this\.WorkCard\(c\)/, '卡片视图要真的渲染出来'); });