/** * 联系人页(工作列表 / 联系人)的判据 —— 与 WebUI `ContactPanel` 对齐。 * * ── 这一整个文件的来历 ── * * 用户 2026-09-18:「你自己看看这些页面和webui有哪怕一丁点的相似之处吗?」 * 把两个客户端**同一个宽度**并排看之后,缺的东西很具体:联系人卡片上 WebUI 有 * 「写信 / 归档」,鸿蒙一个都没有。 * * 补的时候撞出三个**只有跑起来才会现形**的问题,所以这个文件判的正是那三样 * (不是"按钮在不在",而是"按下去会发生什么"): * * ① `MailApi.archiveContact` 打的是 `DELETE /me/contacts/{name}/{path}` —— * **服务端根本没有这条路由**,而且全仓没有调用方 ⇒ 它是个从没跑过的死函数。 * 按钮接上去的那一刻就是 404。服务端真实形状是 `POST /contacts/archive` * (body `{session_id}` 或 `{address}`)。 * * ② `LoginPage.tryRestore` 验完 token 就结束了 —— 设了 `loggedIn = true` * (界面出现「登录成功:jianf」)却**从不跳转**。而这条恰恰是老用户最常走的 * 那条(重启时 token 还在,`doLogin` 根本不会被调用)。 * * ③ 卡片把 `last_activity` **原样印出来** ⇒ 屏上是 * `2026-09-18T02:50:35.49065Z`,而 WebUI 是 `09/18 10:50`。 * * ⚠️ 这个文件读的是**文本**。它不能替代设备验证:按钮真的画出来、点下去真的 * 发出那个请求、确认框真的换掉那一张卡片 —— 那三条我是在三折叠模拟器上 * 用 `dumpLayout` + `uitest uiInput click` 实测过的(见提交信息)。 */ import test from 'node:test'; import assert from 'node:assert/strict'; import { dirname, join } from 'node:path'; import { fileURLToPath } from 'node:url'; import { code, prose } from './lib/read.mjs'; const ROOT = join(dirname(fileURLToPath(import.meta.url)), '..', '..', '..'); const ETS = join(ROOT, 'client', 'harmony', 'entry', 'src', 'main', 'ets'); /* * ★ 2026-09-19:本文件原先**自造**了一个 `code()`(自己写去注释正则)。 * `criteria-hygiene` 判据拦的正是这个 —— 判据目录有一条"裸用 readFileSync"的 * 禁令,理由不是洁癖:`code`/`prose` 的选择决定"判的是代码还是注释", * 各文件自造一份,就等于每个文件对同一件事有各自的说法。 * 改用 `test/lib/read.mjs` 的共享入口。 */ /* * ★★ 2026-09-23 修:`ContactsTab` 已从 `MainPage.ets` 抽出 * (`pages/ContactsTab.ets`)。下面三个判据原来只在 `MAIN` 上找, * 抽出后落在 `ContactsTab` 的代码全部失踪 ⇒ 静默变绿(判了空串)。 * 改成把两边并起来 —— 与 `harmony-logic`/`harmony-nav` 的 `PAGE_SOURCES` * 同一个做法(显式名单,不扫整个目录,避免作用域过宽)。 */ const MAIN = join(ETS, 'pages', 'MainPage.ets'); const CT = join(ETS, 'pages', 'ContactsTab.ets'); const ctAndMain = (src) => src; // 占位,下面直接用 code(MAIN)+code(CT) const API = join(ETS, 'api', 'MailApi.ets'); const LOGIN = join(ETS, 'pages', 'LoginPage.ets'); const GROUP = join(ETS, 'model', 'MailGrouping.ts'); test('★ 归档打的是服务端**真有的**那条路由(POST /contacts/archive,不是不存在的 DELETE /me/contacts/…)', () => { /* * 这条判的是 ① 。原来那个实现不只是"过时"——它指向的路径 * 在 `server/cmd/server/main.go` 里**一条都没有**,所以按下去必然 404, * 而按钮一旦出现在界面上,用户看到的就是"点了没反应/报错"。 * * 判据形状:既钉住**用了** `POST /contacts/archive`,也钉住 * **没有**再用那条不存在的 DELETE 路径。只钉前者的话,加回一个 * 平行实现(两个都发)也能全绿 —— 那不是"修好了"。 */ const src = code(API); assert.match(src, /this\.client\.post<[^>]*>\(\s*'\/contacts\/archive'/, 'archiveContact 必须 POST /contacts/archive(服务端 handler.ArchiveContact 的真实路由)'); assert.doesNotMatch(src, /\/me\/contacts\//, '不要再打 /me/contacts/… —— 服务端没有这条路由(这次修的就是它)'); /* * body 必须带 session_id:服务端 archiveRequest 接受 session_id 或 address, * 但 address 会随别名变化,只有 session_id 是会话的身份。 * WebUI 也用 session_id(contactStore.archive → api.archiveContact({session_id}))。 */ assert.match(src, /session_id/, '归档请求体要带 session_id(address 会随别名变化,不是身份)'); }); test('★ 「写信 / 归档」两个动作在**两种视图**里都有(WebUI 两视图同语义)', () => { /* * WebUI `ContactPanel` 的卡片视图(`WorkCard`)与列表视图(`ContactRow`) * 都带这两个动作,且**共用同一个确认框**(原话:归档是破坏性操作, * 换个视图就换套确认 UI 只会让人对「自己点了点什么」更没底)。 * 鸿蒙两视图都要有 —— 只加一边的话,切到另一边就像"这个功能没了"。 */ const src = code(MAIN) + '\n' + code(CT); const writes = [...src.matchAll(/this\.CardAction\('写信'[\s\S]{0,80}?composeTo\(c\)/g)].length; const archives = [...src.matchAll(/this\.CardAction\('归档'[\s\S]{0,80}?requestArchive\(c\)/g)].length; assert.equal(writes, 2, `「写信」要在卡片视图与列表视图各一处,实际 ${writes} 处`); assert.equal(archives, 2, `「归档」要在卡片视图与列表视图各一处,实际 ${archives} 处`); // 两个动作各自的去向也要对:写信 → composeTo(预填该地址),归档 → requestArchive(先确认) assert.match(src, /composeTo\(c: Contact\)[\s\S]{0,400}?to: c\.address/, 'composeTo 要把该联系人的三维地址预填进 ComposeParams(WebUI: startCompose({to: c.address}))'); assert.match(src, /requestArchive\(c: Contact\)[\s\S]{0,200}?pendingArchiveId = c\.session_id/, 'requestArchive 只打开确认框、不发请求 —— 破坏性操作先确认'); }); test('★ 归档要**先确认**,且两种视图共用同一个确认框(不是各画一个)', () => { /* * 「共用」这条必须是机器可判的:如果两个视图各画一个确认框, * 文案就会各自漂移,而漂移之后没人会同时看两边。 * 判据:确认框的 builder 只有一个定义,两个视图都调它。 */ const src = code(MAIN) + '\n' + code(CT); const defs = [...src.matchAll(/@Builder\s+ArchiveConfirmCard\(/g)].length; assert.equal(defs, 1, `ArchiveConfirmCard 只应有 1 个定义,实际 ${defs} 个`); const calls = [...src.matchAll(/this\.ArchiveConfirmCard\(c\)/g)].length; assert.equal(calls, 2, `两个视图都要调同一个确认框,实际 ${calls} 处调用`); // 文案与 WebUI `ArchiveConfirm` 逐字一致(用户是在两个客户端之间来回看的) assert.match(src, /'归档 ' \+ c\.address \+ '?'/, '确认框主句要与 WebUI 逐字一致:归档
?'); assert.match(src, /'对应 Agent 的 session 将被归档,此列表与邮箱界面同时移除'/, '确认框副句要与 WebUI 逐字一致'); // 确认态下点卡片不许打开会话(那块区域已经是确认框了) assert.match(src, /if \(this\.pendingArchiveId !== c\.session_id\) \{[\s\S]{0,80}?this\.openSession\(c\);/, '确认态下卡片的点击不能再打开会话'); }); test('★ 时间戳要按 WebUI 的口径格式化(不是把 ISO 串原样印出来)', () => { /* * 这条判的是 ③ 。原样印 `last_activity` 得到的是 * `2026-09-18T02:50:35.49065Z` —— 秒级微秒的 UTC 串。 * WebUI 用 `toLocaleString('zh-CN', {month:'2-digit',day:'2-digit',hour:'2-digit',minute:'2-digit'})` * ⇒ `09/18 10:50`(**本地**时区)。 * * 两件事都要判:卡片/列表**用了**格式化函数,且那个函数走 `Date` 取本地字段 * —— 不许 `.slice()` 切字符串(那是拿 UTC 的月/日当本地时刻用, * UTC+8 的 09-15 00:30 会显示成 09-14 16:30,而格子/表头全都正常)。 */ const main = code(MAIN) + '\n' + code(CT); assert.doesNotMatch(main, /\+ c\.last_activity\b/, 'last_activity 不许原样拼接显示(会印出 ISO 串),要走 shortTimeOf'); assert.match(main, /shortTimeOf\(c\.last_activity\)/, '要用 shortTimeOf 格式化'); const g = code(GROUP); assert.match(g, /export function shortTimeOf\(/, 'MailGrouping 要导出 shortTimeOf'); const fn = g.slice(g.indexOf('export function shortTimeOf(')); assert.match(fn, /new Date\(ms\)/, '必须走 Date 解析'); assert.match(fn, /getMonth\(\)/, '月份要取**本地**字段(getMonth),不是 UTC'); assert.match(fn, /getDate\(\)/, '日期要取本地字段(getDate)'); assert.doesNotMatch(fn.slice(0, 900), /slice\(/, '不许用 slice 切 ISO 字符串当日期'); // 自检:探测器要真能分辨"格式化过"与"原样印" assert.match('shortTimeOf(c.last_activity)', /shortTimeOf\(c\.last_activity\)/); assert.doesNotMatch("' 封 · ' + c.last_activity", /shortTimeOf\(c\.last_activity\)/); }); test('★ 用已存 token 恢复登录也必须**真的进主界面**(不能只显示「登录成功」)', () => { /* * 这条判的是 ② ,也是这一轮里最恶劣的一个 —— 因为它**看起来是成功的**: * 界面上出现「登录成功:jianf」,然后永远停在登录页。 * 实测证据:模拟器日志只有 `→ GET /auth/me` 然后什么都没有。 * * 判据形状(不是"文件里有 pushUrl"这种能靠别处蒙混过去的写法): * 把 `tryRestore` 的**函数体**切出来,要求它自己含跳转主界面那句。 * 只判全文件出现次数的话,另外两条路径里那两句就够让它变绿。 */ const src = code(LOGIN); const start = src.indexOf('async tryRestore('); assert.ok(start > 0, 'LoginPage 要有 tryRestore'); // 从函数头到下一个同缩进的成员定义为止 const rest = src.slice(start); const end = rest.indexOf('\n }\n'); const body = rest.slice(0, end > 0 ? end : 2000); /* * ★ 2026-09-19 放宽:`pushUrl` → `(pushUrl|replaceUrl)`。 * * 本条判的是**"有没有跳转"**,不是"用哪个原语"。原先写死 `pushUrl`, * 于是在修 LoginPage 的返回栈 bug 时(三处 `pushUrl` → `replaceUrl`, * 见 `harmony-nav` 那条"登录/退出必须用同一个原语")它误报了。 * 原语该用哪个由 harmony-nav 那条专门判;这里只管"跳了没有"。 */ assert.match(body, /(?:pushUrl|replaceUrl)\(\s*\{\s*url:\s*'pages\/MainPage'/, 'tryRestore 成功后必须跳转主界面 —— 它原来只设 loggedIn=true 就结束了'); /* * 还要登记账号 + 建 SSE:少了它们,"恢复登录"进主界面是个瘸的状态 * (设置页看不到账号;而 aboutToAppear 的快速路径正是靠账号命中的, * 所以下次启动又会重走 tryRestore ⇒ 永远进不去)。 */ assert.match(body, /addAccount\(/, 'tryRestore 要把账号写进多账号管理器(否则下次启动还会重走这里)'); assert.match(body, /connectForAccount\(/, 'tryRestore 要建 SSE(否则主界面收不到实时事件)'); // 自检:这条判据必须能抓到"只设 loggedIn 不跳转"那个原形状 const broken = "async tryRestore(t) {\n this.loggedIn = true;\n }\n"; const bStart = broken.indexOf('async tryRestore('); const bRest = broken.slice(bStart); const bEnd = bRest.indexOf('\n }\n'); assert.doesNotMatch(bRest.slice(0, bEnd > 0 ? bEnd : 2000), /(?:pushUrl|replaceUrl)\(\s*\{\s*url:\s*'pages\/MainPage'/, '自检:原形状(只有 loggedIn=true)必须判红'); });