/** * 界面必须带一个可核对的构建戳(2026-09-14)。 * * # 为什么 * * 用户连续三轮说「webui 还没改」,而我每次都能证明部署是活的:入口页 `no-cache`、 * 资源哈希 immutable、线上 bundle 与本地构建逐字节一致……但**隔着屏幕谁也说不清 * 对方的浏览器跑的是哪一份**。这行字把这件事变成可核对的:它在界面设置里显示 * `git短哈希·月日-时分`,刷新后数字变了就是拿到了新构建。 * * 判据落在三处接线:vite 注入 → 组件渲染 → 产物里真的有。 */ import { test } from 'node:test'; import assert from 'node:assert/strict'; import { execFileSync } from 'node:child_process'; import { readFileSync, readdirSync } from 'node:fs'; import { dirname, join } from 'node:path'; import { fileURLToPath } from 'node:url'; const HERE = dirname(fileURLToPath(import.meta.url)); const ROOT = join(HERE, '..', '..', '..'); const read = p => readFileSync(join(HERE, p), 'utf8'); const STAMP = /[0-9a-f]{7,}·\d{4}-\d{4}/; test('vite 注入 __BUILD_STAMP__', () => { const cfg = read('../vite.config.ts'); assert.match(cfg, /__BUILD_STAMP__/); assert.match(cfg, /git rev-parse --short HEAD/, '戳里要有 git 短哈希'); }); test('界面渲染这个戳', () => { const cmp = read('../src/components/BackgroundPicker.tsx'); assert.match(cmp, /__BUILD_STAMP__/, '组件必须渲染它,而不是只定义'); assert.match(cmp, /界面构建/, '文案里要能认出来'); }); test('★ 构建产物里真的带着戳', () => { const dir = join(HERE, '../dist/assets'); const js = readdirSync(dir).filter(f => f.startsWith('index-') && f.endsWith('.js')); assert.ok(js.length > 0, '先跑 npm run build'); const found = js.some(f => STAMP.test(readFileSync(join(dir, f), 'utf8'))); assert.ok(found, '产物里没有构建戳 —— 界面上就永远看不出自己跑的是哪一份'); }); test('判据自检:这个正则不能匹配随便一段文本', () => { assert.equal(STAMP.test('界面构建 index-abcdef.js'), false); assert.equal(STAMP.test('d2904fc·0914-0910'), true); }); /* * 仓库里不得跟踪缓存/构建产物(`.tmp/` 那次事故的判据化,pi 提议)。 * * 2026-09-14:一次 `git add -A` 把 `.tmp/node-compile-cache/**` 与 `.tmp/studtmp-*` * (554 个文件、2.6MB)提交进了版本库。靠"记得先看 git status"防不住下一次 —— * 而这件事**不报错、不报警**,代价却落在别人身上:复核者读 diff 判断"改了什么", * 554 个缓存文件直接把改动面埋了(同一工作区里还有并发写入者,这尤其致命)。 * 所以按 pi 的建议,改成一条结构性判据。 */ test('★ 版本库里不得跟踪缓存/构建产物(.tmp、node_modules、dist、release、embed 产物)', () => { const tracked = execFileSync('git', ['ls-files'], { encoding: 'utf8', cwd: ROOT }) .split('\n') .filter(Boolean); assert.ok(tracked.length > 100, `git ls-files 只列出 ${tracked.length} 个文件,判据大概跑错目录了`); /* * `server/internal/static/static/` 是 go:embed 的落点:**它的存在**靠一个 * 有意跟踪的 `placeholder.html` 撑着(.gitignore 里也是 `*` + `!placeholder.html`)—— * 那是设计,不是产物。所以这条只放行那一个名字,其余一律算产物。 */ const EMBED_PLACEHOLDER = 'server/internal/static/static/placeholder.html'; const poison = tracked.filter(f => /^(\.tmp\/|.*\/node_modules\/|client\/electron\/dist\/|client\/electron\/release\/|release\/|server\/internal\/static\/static\/)/.test(f) && f !== EMBED_PLACEHOLDER ); assert.deepEqual( poison.slice(0, 10), [], `版本库里跟踪了缓存/构建产物(共 ${poison.length} 个,前 10 个如下)—— 它们会让复核者看不清真实改动面:\n ${poison.slice(0, 10).join('\n ')}` ); // 反向对照:判据要真能认出这类路径(否则正则写错也是一片绿) const looksTracked = p => /^(\.tmp\/|.*\/node_modules\/|client\/electron\/dist\/|client\/electron\/release\/|release\/|server\/internal\/static\/static\/)/.test(p); assert.ok(looksTracked('.tmp/node-compile-cache/v22/0014c7b4'), '自检:认不出 .tmp 下的缓存'); assert.ok(looksTracked('client/electron/release/agentmail-web_0.1.0_amd64.deb'), '自检:认不出安装包产物'); assert.ok(!looksTracked('client/electron/src/index.css'), '自检:把源码当成产物了'); // 那个占位文件必须还在:它是 go:embed 落点存在的唯一理由,删了 Go 侧就编不过 assert.ok(tracked.includes(EMBED_PLACEHOLDER), 'go:embed 的占位文件丢了 —— 没有它 static/ 目录不存在,Go 侧编不过'); });