// 外壳:导航、待审批徽标、404、标签页标题与 favicon、后台提醒、⌘K 命令面板、 // ? 快捷键说明、主题快速切换、连接遥测、离线横幅、启动页。 // // 这些都是每一屏都在的东西,坏了没有哪一页的检查会替它说话:徽标指向一个找不到 // 待办的列表、打错地址看到白板、后端没起时启动页永远「正在连接」、命令面板的 // aria 断了读屏用户就用不了——之前每一样都真发生过。 // // 待审批用 page.route 伪造(两条,最早的一条等了 8 天),离线用 page.route 直接 // 掐断 /api。所有非 GET 请求(主题切换会 PUT 设置)都在探针里应答,不写库。 // 跑之前前端得起着(./scripts/dev.sh),默认连 5273。对别的实例(比如一份沙箱拷贝)跑时 // 带上地址:AGENTLAB_WEB=http://localhost:<前端端口> node scripts/check-shell.mjs import { chromium } from '../frontend/node_modules/playwright-core/index.mjs' const WEB = process.env.AGENTLAB_WEB ?? 'http://localhost:5273' // 不用 playwright install:它既下不动也会动到已有缓存。系统 Chrome 就够了。 const CHROME = process.env.CHROME_PATH ?? '/Applications/Google Chrome.app/Contents/MacOS/Google Chrome' let failed = 0 const check = (name, cond, detail = '') => { console.log(` ${cond ? '✓' : '✗'} ${name}${detail ? ` — ${detail}` : ''}`) if (!cond) failed++ } const ago = (ms) => new Date(Date.now() - ms).toISOString() const PENDING = [ { id: 'shell-ap-old', run_id: 'shell-run-old', node_id: 'review', mode: 'approve', title: '这条公告可以发吗?', payload: {}, status: 'pending', response: {}, created_at: ago(8 * 86400_000 + 3600_000), workflow_name: '公告审核', node_label: '人工审批', run_status: 'interrupted', run_class: 'exploratory', }, { id: 'shell-ap-new', run_id: 'shell-run-new', node_id: 'review', mode: 'input', title: '补一下预算上限', payload: {}, status: 'pending', response: {}, created_at: ago(12 * 60_000), workflow_name: '采购比价', node_label: '人工审批', run_status: 'interrupted', run_class: 'exploratory', }, ] // 相对亮度与对比度(WCAG):徽标在两套主题下都要 ≥ 4.5 const lum = (rgb) => { const [r, g, b] = rgb.match(/\d+(\.\d+)?/g).slice(0, 3).map(Number).map((v) => { const c = v / 255 return c <= 0.03928 ? c / 12.92 : ((c + 0.055) / 1.055) ** 2.4 }) return 0.2126 * r + 0.7152 * g + 0.0722 * b } const contrast = (a, b) => { const [x, y] = [lum(a), lum(b)].sort((p, q) => q - p) return (x + 0.05) / (y + 0.05) } const browser = await chromium.launch({ executablePath: CHROME }) /** 一个带探针的新页面。state 可以在跑的过程中改:换待审批、断网 */ async function open({ theme = 'dark', state }) { const ctx = await browser.newContext({ viewport: { width: 1280, height: 860 }, colorScheme: theme }) opened.add(ctx) const page = await ctx.newPage() page.errors = [] page.on('pageerror', (e) => page.errors.push(e.message)) await page.addInitScript((t) => { localStorage.setItem('agentlab.theme', t) // 系统通知换成记录器:只记谁在什么时候要了权限、发了什么 window.__notes = [] window.__permissionAsks = 0 class FakeNotification { static permission = 'default' static async requestPermission() { window.__permissionAsks++ FakeNotification.permission = 'granted' return 'granted' } constructor(title, opts) { window.__notes.push({ title, ...opts }) } close() {} } window.Notification = FakeNotification }, theme) // 只认路径以 /api/ 开头的:'**/api/**' 也会匹配到 vite 的模块 /src/api/client.ts, // 断网时把它一起掐了,页面就直接白了 await page.route((url) => url.pathname.startsWith('/api/'), (route) => { const r = route.request() const url = new URL(r.url()) if (state.offline) return route.abort('connectionrefused') // 后端连得上但不回:/health 照常,其余请求一直挂着 if (state.hang && url.pathname !== '/api/health') return // 只卡一张表:别的照常回 if (state.hangPath === url.pathname) return if (r.method() !== 'GET') { state.writes.push({ method: r.method(), path: url.pathname, body: r.postData() }) return route.fulfill({ json: {} }) } // 主题以本地为准,别让沙箱库里存的偏好把这次检查的主题改掉 if (url.pathname === '/api/settings') return route.fulfill({ json: { ui: { theme } } }) if (url.pathname === '/api/approvals') return route.fulfill({ json: state.approvals }) if (url.pathname === '/api/runs' && state.runs) return route.fulfill({ json: state.runs }) if (state.broken === url.pathname) return route.fulfill({ status: 500, json: { detail: '数据库锁住了,稍后重试' } }) return route.continue() }) return { ctx, page } } const nav = (page) => page.locator('nav[aria-label="主导航"]') const waitNav = (page) => nav(page).waitFor({ timeout: 15000 }) const isMac = process.platform === 'darwin' // 只跑其中几段:CHECK_ONLY=离开前确认,启动页 node scripts/check-shell.mjs(按段名包含匹配) const ONLY = process.env.CHECK_ONLY?.split(',').map((s) => s.trim()).filter(Boolean) const want = (name) => !ONLY?.length || ONLY.some((k) => name.includes(k)) /** * 一节一节地跑:要跑就打出段标题(title 为空的是上一段的续篇,不另起标题)。某一节里 * 等待超时、元素找不到,只记成这一节失败,收掉它开的页面,接着跑下一节 */ const opened = new Set() async function section(name, title, fn) { if (!want(name)) return if (title) console.log(title) try { await fn() } catch (e) { const label = title ? title.replace(/^\n?=== | ===$/g, '') : name check(`${label} 中途出错`, false, String(e?.message ?? e).split('\n')[0]) } finally { for (const c of opened) await c.close().catch(() => {}) opened.clear() } } const MOD = isMac ? 'Meta' : 'Control' // --------------------------------------------------------------------------- await section('导航', '=== 导航 ===', async () => { const state = { approvals: PENDING, offline: false, writes: [] } const { ctx, page } = await open({ state }) await page.goto(`${WEB}/chat`) await waitNav(page) const box = await nav(page).boundingBox() check('导航宽 64px(w-16)', Math.round(box.width) === 64, `${box.width}`) const labels = await nav(page).locator('li > a[aria-keyshortcuts] > span:not([aria-hidden])').allInnerTexts() check('导航项:问数据、编排、记录、数据、工具、知识、设置', labels.join(',') === '问数据,编排,记录,数据,工具,知识,设置', labels.join(',')) const fontSize = await nav(page).locator('li > a[aria-keyshortcuts] > span:not([aria-hidden])').first() .evaluate((el) => getComputedStyle(el).fontSize) check('导航标签 11px', fontSize === '11px', fontSize) const active = nav(page).locator('a[aria-current="page"]') check('当前页有 aria-current,且只有一个', (await active.count()) === 1 && (await active.innerText()).startsWith('问数据')) const accent = await page.evaluate(() => getComputedStyle(document.documentElement).getPropertyValue('--accent').trim()) const [iconColor, barColor] = await active.evaluate((el) => [ getComputedStyle(el.querySelector('svg')).color, getComputedStyle(el.querySelector('span[aria-hidden]')).backgroundColor, ]) const hex = (rgb) => '#' + rgb.match(/\d+/g).slice(0, 3).map((v) => Number(v).toString(16).padStart(2, '0')).join('') check('选中项:图标是强调色', hex(iconColor) === accent.toLowerCase(), `${hex(iconColor)} vs ${accent}`) check('选中项:左缘有强调色竖条', hex(barColor) === accent.toLowerCase(), hex(barColor)) await page.getByRole('link', { name: 'AgentLab 首页' }).waitFor({ timeout: 3000 }).then(() => check('品牌标是回首页的链接', true), () => check('品牌标是回首页的链接', false)) await nav(page).locator('a[href="/data"]').hover() const tip = nav(page).locator('a[href="/data"] > span[aria-hidden]').last() await page.waitForTimeout(600) check('悬停出提示:页面名 + 快捷键', (await tip.isVisible()) && /数据/.test(await tip.innerText()) && /(⌥4|Alt\+4)/.test(await tip.innerText()), (await tip.innerText()).replace(/\n/g, ' ')) await page.locator('main').click({ position: { x: 600, y: 300 } }).catch(() => {}) await page.keyboard.press('Alt+Digit3') check('⌥3 切到记录页', await page.waitForURL(/\/runs(\?|$)/, { timeout: 5000 }).then(() => true, () => false), page.url()) await page.goto(`${WEB}/settings/datasources`) check('旧地址 /settings/datasources 重定向到 /data', await page.waitForURL(/\/data(\/|$)/, { timeout: 8000 }).then(() => true, () => false), page.url()) check('数据页点亮「数据」', (await nav(page).locator('a[aria-current="page"]').innerText()).startsWith('数据')) // 矮窗口:导航按高度收紧,最底下的遥测点和署名不能被切掉 const bottomFits = () => page.evaluate(() => { const n = document.querySelector('nav[aria-label="主导航"]') const t = document.querySelector('[data-telemetry]').getBoundingClientRect() return { ok: n.scrollHeight <= innerHeight && t.bottom <= innerHeight, tel: Math.round(t.bottom), vh: innerHeight } }) for (const h of [600, 480]) { await page.setViewportSize({ width: 1280, height: h }) await page.waitForTimeout(150) const fit = await bottomFits() check(`窗口高 ${h}px:遥测点整个露在视口里,导航不溢出`, fit.ok, JSON.stringify(fit)) } await page.setViewportSize({ width: 1280, height: 860 }) await page.waitForTimeout(150) const itemH = await nav(page).locator('a[href="/runs"]').evaluate((el) => el.getBoundingClientRect().height) check('窗口够高时导航项仍是 48px', itemH === 48, `${itemH}`) // 底部三样:署名、主题、遥测 await page.goto(`${WEB}/chat`) await waitNav(page) const actor = nav(page).locator('a[href="/settings/prefs"]') check('底部有署名入口,点开去设置', (await actor.count()) === 1, await actor.getAttribute('aria-label')) const telemetry = nav(page).locator('[data-telemetry]') await page.waitForFunction(() => document.querySelector('[data-telemetry]')?.getAttribute('data-telemetry') === 'ok', null, { timeout: 10000 }).catch(() => {}) check('底部遥测点显示在线和延迟', /\d+ms/.test(await telemetry.innerText()), await telemetry.innerText()) await telemetry.click() const panel = page.getByRole('dialog', { name: '后端连接' }) check('点开遥测点:地址、延迟、加载清单', (await panel.isVisible()) && /\/api/.test(await panel.innerText()) && /模型接入/.test(await panel.innerText())) await page.keyboard.press('Escape') check('Esc 关掉遥测浮层', await panel.waitFor({ state: 'detached', timeout: 3000 }).then(() => true, () => false)) const before = await page.evaluate(() => document.documentElement.getAttribute('data-theme')) await nav(page).getByRole('button', { name: /切换到.+主题/ }).click() const after = await page.evaluate(() => document.documentElement.getAttribute('data-theme')) check('主题快速切换:深色 → 浅色', before === 'dark' && after === 'light', `${before} → ${after}`) await page.waitForTimeout(300) const put = state.writes.find((w) => w.method === 'PUT' && w.path === '/api/settings') check('主题存进设置(PUT ui.theme,被探针拦下)', !!put && JSON.parse(put.body).values.ui.theme === 'light', put?.body ?? '没有请求') check('没有未捕获的运行时错误', page.errors.length === 0, page.errors[0] ?? '') await ctx.close() }) // --------------------------------------------------------------------------- await section('待审批徽标', '\n=== 待审批徽标 ===', async () => { for (const theme of ['dark', 'light']) { const state = { approvals: PENDING, offline: false, writes: [] } const { ctx, page } = await open({ theme, state }) await page.goto(`${WEB}/chat`) await waitNav(page) const badge = page.locator('[data-approval-badge]') await badge.waitFor({ timeout: 8000 }) const b = await badge.boundingBox() const icon = await nav(page).locator('a[href="/runs"] svg').boundingBox() const [fg, bg, nums] = await badge.evaluate((el) => { const s = getComputedStyle(el) return [s.color, s.backgroundColor, s.fontVariantNumeric] }) if (theme === 'dark') { check('徽标是链接,指向 /runs?tab=approvals', (await badge.getAttribute('href')) === '/runs?tab=approvals') check('导航项「记录」本身仍然进 /runs', (await nav(page).locator('a[aria-keyshortcuts]').nth(2).getAttribute('href')) === '/runs') const label = await badge.getAttribute('aria-label') check('徽标读屏文字:条数 + 最久等了多久', /2 项待审批/.test(label) && /最久已等 8 天/.test(label), label) check('徽标至少 16×16', b.width >= 16 && b.height >= 16, `${b.width}×${b.height}`) check('徽标数字等宽', /tabular-nums/.test(nums), nums) check('徽标挂在图标右上角外侧,不压图标主体', b.x + b.width / 2 > icon.x + icon.width && b.y < icon.y, `badge(${b.x},${b.y}) icon(${icon.x},${icon.y},${icon.width})`) } const ratio = contrast(fg, bg) check(`徽标对比度 ≥ 4.5(${theme === 'dark' ? '深色' : '浅色'})`, ratio >= 4.5, ratio.toFixed(2)) if (theme === 'dark') { await badge.hover() await page.waitForTimeout(400) const tip = badge.locator('span[aria-hidden]') check('悬停徽标有提示', (await tip.isVisible()) && /最久已等/.test(await tip.innerText())) await badge.click() check('点徽标进待审批页签', await page.waitForURL(/\/runs\?tab=approvals/, { timeout: 5000 }).then(() => true, () => false), page.url()) } await ctx.close() } }) // --------------------------------------------------------------------------- await section('404', '\n=== 404 ===', async () => { const state = { approvals: [], offline: false, writes: [] } const { ctx, page } = await open({ state }) await page.goto(`${WEB}/does-not-exist/at-all`) await waitNav(page) check('未知地址给出说明而不是白板', await page.getByText('这个地址不存在').waitFor({ timeout: 8000 }).then(() => true, () => false)) check('写出了打错的那个地址', (await page.locator('main').innerText()).includes('/does-not-exist/at-all')) check('标题是「页面不存在 — AgentLab」', (await page.title()) === '页面不存在 — AgentLab', await page.title()) check('给了 ⌘K 入口', await page.getByRole('button', { name: /搜索去处/ }).isVisible()) await page.getByRole('button', { name: /搜索去处/ }).click() check('404 上点搜索打开命令面板', await page.getByRole('dialog', { name: '命令面板' }).isVisible()) await page.keyboard.press('Escape') await page.getByRole('link', { name: '回到问数据' }).click() check('「回到问数据」回首页', await page.waitForURL(/\/chat/, { timeout: 5000 }).then(() => true, () => false), page.url()) await ctx.close() }) // --------------------------------------------------------------------------- await section('标签页标题', '\n=== 标签页标题、favicon、后台提醒 ===', async () => { const state = { approvals: [], offline: false, writes: [] } const { ctx, page } = await open({ state }) await page.goto(`${WEB}/runs`) await waitNav(page) await page.waitForFunction(() => document.title.includes('记录'), null, { timeout: 5000 }).catch(() => {}) check('每页有自己的标题', (await page.title()) === '记录 — AgentLab', await page.title()) const favicon = () => page.evaluate(() => { const l = document.querySelector('link[rel~="icon"]') return { href: l.getAttribute('href'), status: l.getAttribute('data-status') } }) check('没事时 favicon 是原图', (await favicon()).href === '/favicon.svg') state.approvals = PENDING const titled = await page.waitForFunction(() => document.title.startsWith('(2) 待审批 · '), null, { timeout: 12000 }) .then(() => true, () => false) check('来了待审批:标题加「(2) 待审批 · 」前缀', titled, await page.title()) const fav = await favicon() check('来了待审批:favicon 换成带琥珀点的 PNG', fav.status === 'waiting' && fav.href.startsWith('data:image/png'), fav.status) state.approvals = [] await page.waitForFunction(() => !document.title.includes('待审批'), null, { timeout: 12000 }).catch(() => {}) await page.goto(`${WEB}/studio`) await waitNav(page) const hasStudio = await page.waitForFunction(() => window.__studio?.getState().nodes.length > 0, null, { timeout: 12000 }) .then(() => true, () => false) check('画布装好了(dev 构建的 window.__studio)', hasStudio) if (hasStudio) { const name = await page.evaluate(() => window.__studio.getState().workflow?.name) // 工作流名是沙箱库里的真实名字,日志常被贴进报告:标题打出来之前换成占位 const masked = (t) => (name ? String(t).split(name).join('‹工作流名›') : String(t)) check('编排页标题带工作流名', (await page.title()).startsWith(`编排 · ${name}`), masked(await page.title())) // 权限只在用户点开关时才要 check('进页面不自动要通知权限', (await page.evaluate(() => window.__permissionAsks)) === 0) await nav(page).getByRole('button', { name: '后台提醒' }).click() await page.waitForTimeout(200) check('点开关才要权限,开关变为按下', (await page.evaluate(() => window.__permissionAsks)) === 1 && (await nav(page).getByRole('button', { name: '后台提醒' }).getAttribute('aria-pressed')) === 'true') await page.evaluate(() => { const s = window.__studio.getState() window.__studio.setState({ run: { id: 'shell-check-run', workflow_id: s.workflow?.id ?? null, workflow_name: s.workflow?.name ?? '', status: 'running', input: {}, output: {}, error: null, usage: {} }, runPhase: 'running', }) }) await page.waitForFunction(() => document.title.includes('● 运行中'), null, { timeout: 3000 }).catch(() => {}) // 只认外壳自己的前缀;前面若还挂着别的(比如以后画布自己加的计时),不算错 check('有运行在跑:标题加「● 运行中 n/N」', /(^|\s)● 运行中 \d+\/\d+ · 编排/.test(await page.title()), masked(await page.title())) check('有运行在跑:favicon 蓝点', (await favicon()).status === 'running') check('有运行在跑:品牌标起点节点亮起', /有运行在跑/.test(await nav(page).locator('a[href="/"]').getAttribute('aria-label'))) // 切到后台,运行失败 await page.evaluate(() => { Object.defineProperty(document, 'hidden', { configurable: true, get: () => true }) document.dispatchEvent(new Event('visibilitychange')) }) await page.waitForTimeout(1100) await page.evaluate(() => window.__studio.setState({ runPhase: 'failed' })) await page.waitForTimeout(200) check('后台时失败:标题换成「✕ 运行失败」', /(^|\s)✕ 运行失败 · /.test(await page.title()), masked(await page.title())) check('后台时失败:favicon 红点', (await favicon()).status === 'failed') const notes = await page.evaluate(() => window.__notes) check('后台时失败:发了一条系统通知', notes.length === 1 && /运行失败/.test(notes[0].title), masked(JSON.stringify(notes))) await page.evaluate(() => { delete document.hidden document.dispatchEvent(new Event('visibilitychange')) }) await page.waitForTimeout(200) check('切回来:失败前缀撤掉', !(await page.title()).includes('运行失败'), masked(await page.title())) check('切回来:favicon 还原', (await favicon()).href === '/favicon.svg') // 前台时结束不打扰 await page.evaluate(() => window.__studio.setState({ runPhase: 'running' })) await page.waitForTimeout(1100) await page.evaluate(() => window.__studio.setState({ runPhase: 'succeeded' })) await page.waitForTimeout(200) check('前台时跑完不发通知', (await page.evaluate(() => window.__notes.length)) === 1) await page.evaluate(() => window.__studio.getState().clearRun()) } check('没有未捕获的运行时错误', page.errors.length === 0, page.errors[0] ?? '') await ctx.close() }) // --------------------------------------------------------------------------- await section('⌘K 命令面板', '\n=== ⌘K 命令面板 ===', async () => { const state = { approvals: PENDING, offline: false, writes: [] } const { ctx, page } = await open({ state }) await page.goto(`${WEB}/runs`) await waitNav(page) await page.waitForTimeout(500) await page.keyboard.press(`${MOD}+KeyK`) const dialog = page.getByRole('dialog', { name: '命令面板' }) check(`${isMac ? '⌘K' : 'Ctrl+K'} 打开命令面板`, await dialog.waitFor({ timeout: 3000 }).then(() => true, () => false)) const input = dialog.getByRole('combobox') check('打开时焦点在搜索框', await input.evaluate((el) => el === document.activeElement)) const aria = await input.evaluate((el) => ({ controls: el.getAttribute('aria-controls'), active: el.getAttribute('aria-activedescendant'), expanded: el.getAttribute('aria-expanded'), })) const listbox = await page.evaluate((id) => document.getElementById(id)?.getAttribute('role'), aria.controls) const selected = await page.evaluate((id) => document.getElementById(id)?.getAttribute('aria-selected'), aria.active) check('combobox → listbox 接好了,activedescendant 指向选中项', listbox === 'listbox' && selected === 'true' && aria.expanded === 'true', JSON.stringify(aria)) check('分组有名字(role=group + aria-labelledby)', (await dialog.locator('[role="group"][aria-labelledby]').count()) >= 3) check('待审批排在最前', (await dialog.locator('[role="group"]').first().innerText()).startsWith('待审批')) await page.keyboard.press('ArrowDown') const moved = await input.getAttribute('aria-activedescendant') check('↓ 移动选中项', moved !== aria.active) await input.fill('设置') const first = dialog.locator('[role="option"][aria-selected="true"]') check('搜「设置」第一项就是设置页', (await first.innerText()).startsWith('设置'), (await first.innerText()).split('\n')[0]) await page.keyboard.press('Enter') check('回车跳过去、面板关掉', await page.waitForURL(/\/settings/, { timeout: 5000 }).then(() => true, () => false) && !(await dialog.isVisible()), page.url()) const workflows = await (await fetch(`${WEB}/api/workflows`)).json().catch(() => []) const wf = workflows.find((w) => !w.is_template && w.name) if (wf) { await page.keyboard.press(`${MOD}+KeyK`) await dialog.getByRole('combobox').fill(wf.name) await page.waitForTimeout(100) const hit = dialog.locator(`[data-command="wf:${wf.id}"]`) // 搜的是沙箱里真实的工作流名:不打出来 check('能搜到工作流', (await hit.count()) === 1, (await hit.count()) === 1 ? '' : `命中 ${await hit.count()} 项(名字不打出来)`) await hit.click() check('点工作流进它的画布', await page.waitForURL(new RegExp(`/studio/${wf.id}`), { timeout: 5000 }).then(() => true, () => false), page.url()) } // 页面刚挂载时的自动聚焦(比如画布助手的输入框)会把焦点从开着的面板里抢走, // 之后打的字、按的 Esc 就都落到了面板底下 await page.keyboard.press(`${MOD}+KeyK`) await dialog.waitFor({ timeout: 3000 }) const stolen = await page.evaluate(() => { const el = document.querySelector('main textarea') ?? document.querySelector('main input, main button, nav a') el?.focus() return el?.tagName ?? null }) check('面板开着时焦点被页面抢走,会回到搜索框', await dialog.getByRole('combobox').evaluate((el) => el === document.activeElement), `${stolen} → ${await page.evaluate(() => document.activeElement?.tagName)}`) await page.keyboard.press('Escape') check('……Esc 照样关掉面板', await dialog.waitFor({ state: 'detached', timeout: 3000 }).then(() => true, () => false)) // 上面没过时面板还开着:⌘K 再按一下把它收掉,后面几项照常跑 if (await dialog.count()) await page.keyboard.press(`${MOD}+KeyK`) await page.keyboard.press(`${MOD}+KeyK`) await dialog.getByRole('combobox').fill('zzqq没有这个东西') check('没结果时说清楚', (await dialog.innerText()).includes('没有匹配')) await page.keyboard.press('Escape') check('Esc 关掉面板', await dialog.waitFor({ state: 'detached', timeout: 3000 }).then(() => true, () => false)) // DialogHost 跟着 ToastHost 挂在根上:没挂的话 promptDialog 会退回原生 prompt let nativePrompt = false page.once('dialog', (d) => { nativePrompt = true; void d.dismiss() }) await page.keyboard.press(`${MOD}+KeyK`) await dialog.getByRole('combobox').fill('新建工作流') await page.keyboard.press('Enter') const ask = page.getByRole('dialog', { name: '新建工作流' }) check('「新建工作流」弹的是站内输入框,不是原生 prompt', await ask.waitFor({ timeout: 3000 }).then(() => true, () => false) && !nativePrompt) await page.keyboard.press('Escape') await page.waitForTimeout(200) // 画布自己会发校验、变量分析的 POST,只看有没有建工作流 check('取消就什么都不建', !state.writes.some((w) => w.method === 'POST' && w.path === '/api/workflows') && (await ask.count()) === 0) await page.keyboard.press(`${MOD}+KeyK`) await dialog.getByRole('combobox').fill('快捷键') await page.keyboard.press('Enter') check('面板里的「查看快捷键」打开说明', await page.getByRole('dialog', { name: /键盘快捷键/ }).waitFor({ timeout: 3000 }).then(() => true, () => false)) await page.keyboard.press('Escape') check('没有未捕获的运行时错误', page.errors.length === 0, page.errors[0] ?? '') await ctx.close() }) // --------------------------------------------------------------------------- await section('未保存的工作流', '\n=== 未保存的工作流:命令面板、后台提醒不露「临时图」===', async () => { // 画布没保存就跑、问数据当场搭的运行,老后端记的名字是「临时图」。记录页早就换成了 // 「未保存的工作流」,命令面板的最近运行、待审批提示和后台通知以前还原样露着(3C 返工 D3) const unsavedApproval = { ...PENDING[1], id: 'shell-ap-unsaved', run_id: 'shell-run-unsaved', title: '这批订单可以放行吗?', workflow_id: null, workflow_name: '临时图', created_at: ago(3 * 60_000), } const unsavedRun = { id: 'shell-run-unsaved', workflow_id: null, workflow_name: '临时图', status: 'succeeded', run_class: 'exploratory', version: null, input: {}, output: {}, error: null, usage: {}, created_at: ago(5 * 60_000), } const state = { approvals: [], runs: [unsavedRun], offline: false, writes: [] } const { ctx, page } = await open({ state }) await page.goto(`${WEB}/runs`) await waitNav(page) await page.waitForTimeout(500) await nav(page).getByRole('button', { name: '后台提醒' }).click() await page.evaluate(() => { Object.defineProperty(document, 'hidden', { configurable: true, get: () => true }) document.dispatchEvent(new Event('visibilitychange')) }) state.approvals = [unsavedApproval] const noted = await page.waitForFunction(() => window.__notes.some((n) => n.tag === 'approval:shell-ap-unsaved'), null, { timeout: 12000 }) .then(() => true, () => false) const note = (await page.evaluate(() => window.__notes.find((n) => n.tag === 'approval:shell-ap-unsaved'))) ?? {} check('后台来了待审批:通知里写「未保存的工作流」,不写「临时图」', noted && String(note.body).includes('未保存的工作流') && !String(note.body).includes('临时图'), String(note.body ?? '没发通知')) await page.evaluate(() => { delete document.hidden document.dispatchEvent(new Event('visibilitychange')) }) await page.keyboard.press(`${MOD}+KeyK`) const dialog = page.getByRole('dialog', { name: '命令面板' }) await dialog.waitFor({ timeout: 3000 }).catch(() => {}) const approvalRow = dialog.locator('[data-command="approval:shell-ap-unsaved"]') const runRow = dialog.locator('[data-command="run:shell-run-unsaved"]') await runRow.waitFor({ timeout: 5000 }).catch(() => {}) const approvalText = await approvalRow.innerText().catch(() => '没有这一项') const runText = await runRow.innerText().catch(() => '没有这一项') check('命令面板的待审批:提示里写「未保存的工作流」', approvalText.includes('未保存的工作流') && !approvalText.includes('临时图'), approvalText.replace(/\s+/g, ' ')) check('命令面板的最近运行:名字是「未保存的工作流」', runText.includes('未保存的工作流') && !runText.includes('临时图'), runText.replace(/\s+/g, ' ')) await page.keyboard.press('Escape') check('没有未捕获的运行时错误', page.errors.length === 0, page.errors[0] ?? '') await ctx.close() }) // --------------------------------------------------------------------------- await section('快捷键说明', '\n=== ? 快捷键说明 ===', async () => { const state = { approvals: [], offline: false, writes: [] } const { ctx, page } = await open({ state }) await page.goto(`${WEB}/studio`) await waitNav(page) await page.waitForTimeout(800) // 编排页一进来焦点在助手输入框里,那时的 ? 是打字;先把焦点放回页面 await page.evaluate(() => document.activeElement?.blur()) await page.keyboard.press('?') const help = page.getByRole('dialog', { name: /键盘快捷键/ }) check('? 打开快捷键说明', await help.waitFor({ timeout: 3000 }).then(() => true, () => false)) if (await help.isVisible()) { const text = await help.innerText() check('有「全局」和「编排页」两组', text.includes('全局') && text.includes('编排页')) check('编排页那组标着「当前页」', (await help.locator('section', { hasText: '编排页' }).innerText()).includes('当前页')) check(`按平台显示(${isMac ? '⌘K' : 'Ctrl+K'})`, text.includes(isMac ? '⌘K' : 'Ctrl+K')) check('只弹一层', (await page.locator('[role="dialog"][aria-modal="true"]').count()) === 1) await page.keyboard.press('Escape') check('Esc 关掉', await help.waitFor({ state: 'detached', timeout: 3000 }).then(() => true, () => false)) } await ctx.close() }) // --------------------------------------------------------------------------- await section('离开前确认', '\n=== 离开前确认 ===', async () => { // 页面有没保存的改动时登记一道守卫(lib/leave)。以前设置页只在捕获阶段拦 的 // 点击:⌘K、⌥ 数字直接调 navigate(),浏览器后退也不走 ,改到一半的表单就这么丢了。 // 这里用 dev 构建挂出的 window.__leave 登记一道测试守卫:每问一次记一笔,答案由脚本给 const state = { approvals: PENDING, offline: false, writes: [] } const { ctx, page } = await open({ state }) await page.goto(`${WEB}/runs`) await waitNav(page) const hooked = await page.waitForFunction(() => !!window.__leave, null, { timeout: 5000 }).then(() => true, () => false) check('dev 构建挂出了 window.__leave', hooked) if (hooked) { // 测试守卫要像页面守卫:选「离开」就等于页面卸载,守卫跟着撤;落地之后再登记。 // 以前它一直登记着、跨页不撤,⌥1 进 /chat 后 ChatPage 把地址 replace 成 /chat/, // 这次重定向也被它拦下、又问了几回,计数用 >= 判断,后面几步在点之前就「成立」了 await page.evaluate(() => { window.__asks = [] window.__answer = null window.__guard = () => { window.__unguard?.() const off = window.__leave.register({ confirm: (next) => new Promise((resolve) => { window.__asks.push(next ? next.pathname + next.search : null) window.__answer = (ok) => { if (ok) { off(); window.__unguard = null } resolve(ok) } }), }) window.__unguard = off } window.__guard() }) const asks = () => page.evaluate(() => window.__asks.length) const lastAsk = () => page.evaluate(() => window.__asks.at(-1)) // 恰好问了 n 次:等到第 n 次,再多等一拍——StrictMode 下重复问一次也要抓得到 const asked = async (n) => { const reached = await page.waitForFunction((n) => window.__asks.length >= n, n, { timeout: 3000 }).then(() => true, () => false) await page.waitForTimeout(200) return reached && (await asks()) === n } const answer = (ok) => page.evaluate((ok) => { const r = window.__answer; window.__answer = null; r?.(ok) }, ok) const where = () => { const u = new URL(page.url()); return u.pathname + u.search } const settle = () => page.waitForTimeout(250) // 落地后页面可能还会自己 replace 一次(/chat → /chat/):地址停住 500ms 才算稳 const landed = async () => { let last = where() for (let i = 0; i < 20; i++) { await page.waitForTimeout(250) const now = where() if (now === last && i >= 1) return now last = now } return last } const regard = () => page.evaluate(() => window.__guard()) const dialog = page.getByRole('dialog', { name: '命令面板' }) await page.keyboard.press(`${MOD}+KeyK`) await dialog.getByRole('combobox').fill('设置') await page.keyboard.press('Enter') check('⌘K 跳页先问守卫(恰好一次),问的时候地址不动', await asked(1) && where().startsWith('/runs'), `${await asks()} 次 · ${where()}`) check('守卫拿得到要去哪', (await lastAsk()) === '/settings', await lastAsk()) await answer(false) await settle() check('选「留下」:还在原地,面板也关了', where().startsWith('/runs') && (await dialog.count()) === 0, where()) await page.evaluate(() => document.activeElement?.blur()) await page.keyboard.press('Alt+Digit1') check('⌥1 切页先问守卫(恰好一次),去向是问数据', await asked(2) && where().startsWith('/runs') && (await lastAsk()) === '/chat', `${await asks()} 次 · ${await lastAsk()}`) await answer(true) check('选「离开」:去到问数据', await page.waitForURL(/\/chat/, { timeout: 5000 }).then(() => true, () => false), where()) const chatAt = await landed() check('……守卫跟着撤了,页面自己的重定向不再被问', (await asks()) === 2, `${await asks()} 次 · ${chatAt}`) await regard() await nav(page).locator('a[href="/data"]').click() check('点左侧导航先问守卫(恰好一次),去向是 /data', await asked(3) && (await lastAsk()) === '/data', `${await asks()} 次 · ${await lastAsk()}`) await answer(false) await settle() check('选「留下」:地址不变', where() === chatAt, `${where()},应为 ${chatAt}`) await page.evaluate(() => history.back()) check('浏览器后退也先问守卫(恰好一次),去向是上一页', await asked(4) && (await lastAsk()) === '/runs', `${await asks()} 次 · ${await lastAsk()}`) await answer(false) await page.waitForTimeout(400) check('选「留下」:地址退回原处', where() === chatAt, `${where()},应为 ${chatAt}`) await page.evaluate(() => history.back()) check('再后退又问一次(恰好一次)', await asked(5) && (await lastAsk()) === '/runs', `${await asks()} 次 · ${await lastAsk()}`) await answer(true) check('后退时选「离开」:真的退回去了', await page.waitForURL(/\/runs/, { timeout: 5000 }).then(() => true, () => false), where()) await landed() await regard() const before = await asks() await page.locator('[data-approval-badge]').click() await page.waitForURL(/tab=approvals/, { timeout: 5000 }).catch(() => {}) await settle() check('同一页里只换 ?tab 不问', (await asks()) === before && /\/runs\?tab=approvals/.test(where()), `${await asks() - before} 次 · ${where()}`) // 先建东西再跳的命令:得先问,不然人点了「留下」,会话已经建出来了 state.writes.length = 0 await page.keyboard.press(`${MOD}+KeyK`) await dialog.getByRole('combobox').fill('新对话') await page.keyboard.press('Enter') check('⌘K「新对话」先问守卫(恰好一次),去向还没定', await asked(before + 1) && (await lastAsk()) === null, `${await asks() - before} 次 · ${await lastAsk()}`) check('……问的时候还没建会话', !state.writes.some((w) => w.method === 'POST' && w.path === '/api/conversations'), state.writes.map((w) => `${w.method} ${w.path}`).join(', ')) await answer(false) await settle() check('选「留下」:不建会话、不跳', !state.writes.some((w) => w.method === 'POST' && w.path === '/api/conversations') && where().startsWith('/runs'), where()) await page.keyboard.press(`${MOD}+KeyK`) await dialog.getByRole('combobox').fill('新建工作流') await page.keyboard.press('Enter') check('⌘K「新建工作流」先问守卫(恰好一次),再问名字', await asked(before + 2) && (await page.getByRole('dialog', { name: '新建工作流' }).count()) === 0) await answer(false) await settle() check('选「留下」:不弹起名框', (await page.getByRole('dialog', { name: '新建工作流' }).count()) === 0 && where().startsWith('/runs')) check('每一问都有了答复,没有悬着的确认', await page.evaluate(() => window.__answer === null)) // 关页、刷新:守卫在时浏览器会问(它只给通用文案),撤了就不问 const unloadAsks = [] page.on('dialog', (d) => { unloadAsks.push(d.type()); void d.dismiss() }) await page.close({ runBeforeUnload: true }) await page.waitForTimeout(500) check('有守卫时关页,浏览器先问', unloadAsks.includes('beforeunload') && !page.isClosed(), unloadAsks.join(',') || '没问') await page.evaluate(() => window.__unguard()) const n = await asks() await page.evaluate(() => document.activeElement?.blur()) await page.keyboard.press('Alt+Digit1') check('撤掉守卫后照常切页,不再问', await page.waitForURL(/\/chat/, { timeout: 5000 }).then(() => true, () => false) && (await asks()) === n, where()) unloadAsks.length = 0 await page.close({ runBeforeUnload: true }) // 页面这回真关了,只能在外面等 await new Promise((r) => setTimeout(r, 500)) check('撤掉守卫后关页不再问', unloadAsks.length === 0 && page.isClosed(), unloadAsks.join(',')) } check('没有未捕获的运行时错误', page.errors.length === 0, page.errors[0] ?? '') await ctx.close() }) await section('离开前确认 · 面板开着时后退', '\n=== 离开前确认 · 面板开着时后退 ===', async () => { // 命令面板(z 更高、锁焦点)开着时浏览器后退:守卫的确认框被压在面板下面看不见, // 焦点又被面板拉回搜索框,Tab、Enter 都落在面板上。用设置页真实的守卫走一遍 const state = { approvals: PENDING, offline: false, writes: [] } const { ctx, page } = await open({ state }) await page.goto(`${WEB}/runs`) await waitNav(page) await nav(page).locator('a[href="/settings"]').click() await page.getByRole('tab', { name: '偏好设置' }).click() const actor = page.locator('#pref-actor') await actor.waitFor({ timeout: 8000 }) await actor.fill(`${await actor.inputValue()}x`) await page.getByText(/有 1 项(设置)?(还)?没保存|1 项未保存/).first().waitFor({ timeout: 3000 }).catch(() => {}) await page.keyboard.press(`${MOD}+KeyK`) const palette = page.getByRole('dialog', { name: '命令面板' }) await palette.waitFor({ timeout: 3000 }) await page.evaluate(() => history.back()) const confirm = page.getByRole('dialog', { name: /有 1 项设置还没保存/ }) const shown = await confirm.waitFor({ timeout: 3000 }).then(() => true, () => false) await page.waitForTimeout(250) check('后退时面板先收起', (await palette.count()) === 0) // isVisible 不管遮挡:取确认框正中那一点最上层的元素,得是它自己 const onTop = shown && await confirm.evaluate((el) => { const b = el.getBoundingClientRect() return el.contains(document.elementFromPoint(b.left + b.width / 2, b.top + b.height / 2)) }) check('离开确认框弹出来、在最上层看得见', onTop) const inside = () => page.evaluate(() => !!document.activeElement?.closest('[role="dialog"][aria-modal="true"]:not([data-command-palette])')) check('焦点在确认框里', await inside(), await page.evaluate(() => document.activeElement?.outerHTML.slice(0, 80))) await page.keyboard.press('Tab') check('Tab 之后焦点还在确认框里', await inside()) await confirm.getByRole('button', { name: '留下来保存' }).click() await page.waitForTimeout(300) check('选「留下」:还在偏好设置,改动还在', new URL(page.url()).pathname === '/settings/prefs' && (await actor.inputValue()).endsWith('x'), page.url()) check('没有未捕获的运行时错误', page.errors.length === 0, page.errors[0] ?? '') await ctx.close() }) // --------------------------------------------------------------------------- await section('离线横幅', '\n=== 离线横幅 ===', async () => { const state = { approvals: [], offline: false, writes: [] } const { ctx, page } = await open({ state }) await page.goto(`${WEB}/chat`) await waitNav(page) await page.waitForTimeout(500) state.offline = true // 导航遥测点的悬停提示里也有这四个字(隐藏着),只认主区里的横幅 const banner = page.locator('main').getByText('后端未连接') check('断网后出横幅', await banner.waitFor({ timeout: 15000 }).then(() => true, () => false)) check('横幅是主区第一个孩子(toast 才会跟着下移)', // role=alert 只包不变的那几句(整块重念会把倒计时也念一遍),外层认 data-offline-banner await page.evaluate(() => document.querySelector('main')?.firstElementChild?.hasAttribute('data-offline-banner') === true)) const alertText = await page.evaluate(() => document.querySelector('[data-offline-banner] [role="alert"]')?.textContent ?? null) check('横幅的播报区只有不变的那几句:倒计时不在里面', alertText != null && alertText.includes('后端未连接') && !/秒后/.test(alertText) && /秒后自动重试/.test(await page.locator('[data-offline-banner]').innerText()), alertText ?? '没有 role=alert') check('遥测点变成离线', /离线/.test(await nav(page).locator('[data-telemetry]').innerText())) state.offline = false await page.getByRole('button', { name: '立即重试' }).first().click() check('恢复后横幅消失', await banner.waitFor({ state: 'detached', timeout: 8000 }).then(() => true, () => false)) await ctx.close() }) /** * 启动页的播报区:只能有标题那一处,计时器、倒计时这些一秒一跳的字不能在里面, * 外面也不能罩着 aria-busy(它会把播报压住) */ const bootLiveRegions = (page) => page.evaluate(() => { const root = document.querySelector('[data-boot]') const live = [...root.querySelectorAll('[role="status"], [role="alert"], [aria-live]')] const texts = live.map((el) => el.textContent) return { ok: live.length === 1 && !/\d/.test(texts[0]) && !root.closest('[aria-busy="true"]') && !root.querySelector('[aria-busy="true"]'), texts, } }) // --------------------------------------------------------------------------- await section('启动页', '\n=== 启动页 ===', async () => { for (const theme of ['dark', 'light']) { const state = { approvals: [], offline: true, writes: [] } const { ctx, page } = await open({ theme, state }) await page.goto(`${WEB}/chat`) const down = await page.getByText('连不上后端服务').first().waitFor({ timeout: 10000 }).then(() => true, () => false) if (theme === 'dark') { check('后端没起:启动页说清原因,不再一直「正在连接」', down) check('给了重试和先进去两条路', await page.getByRole('button', { name: '立即重试' }).isVisible() && await page.getByRole('button', { name: '先进去看看' }).isVisible()) check('清单逐项写出失败', (await page.locator('[data-check][data-state="error"]').count()) >= 6) const live = await bootLiveRegions(page) check('读屏只播标题那一句:倒计时不在播报区里', live.ok, JSON.stringify(live)) state.offline = false await page.getByRole('button', { name: '立即重试' }).click() check('后端起来后点重试就进去', await waitNav(page).then(() => true, () => false)) } else { const bootBg = await page.evaluate(() => getComputedStyle(document.querySelector('[data-boot]')).backgroundColor) check('浅色主题下启动页也是浅色', bootBg === 'rgb(246, 247, 249)', bootBg) await page.getByRole('button', { name: '先进去看看' }).click() check('「先进去看看」进离线模式,横幅挂着', await page.locator('main').getByText('后端未连接').waitFor({ timeout: 5000 }).then(() => true, () => false)) } await ctx.close() } }) await section('启动页', '', async () => { // 后端连着、只有一张表报错:照常进,但要说出来,不然那张表对应的下拉就是空的,看着像"没有" const state = { approvals: [], offline: false, writes: [], broken: '/api/skills' } const { ctx, page } = await open({ state }) await page.goto(`${WEB}/chat`) await waitNav(page) const warn = page.getByText(/有 1 项没加载成功(Skill 500)/) const warned = await warn.waitFor({ timeout: 5000 }).then(() => true, () => false) check('部分请求报错:照常进页面,并说出哪一项没加载', warned) const tone = await nav(page).locator('[data-telemetry]').getAttribute('data-tone') check('遥测点记为「降级」(琥珀),不是一片绿', tone === '降级', tone) // 那张表一直是空的,提示就一直在:4 秒一闪就没,人还是会对着空列表去新建 await page.waitForTimeout(4500) check('提示常驻,直到那张表取回来', await warn.isVisible()) state.broken = null await page.locator('[role="status"] > div', { hasText: '没加载成功' }).getByRole('button', { name: '重试' }).click({ timeout: 5000 }).catch(() => {}) check('重试取回来:提示撤掉', await warn.waitFor({ state: 'detached', timeout: 5000 }).then(() => true, () => false)) await ctx.close() }) await section('启动页', '', async () => { // 后端连得上、请求却卡着不回:「先进去看看」之后不能是一片绿加一屏「还没有工作流」 const state = { approvals: [], offline: false, writes: [], hang: true } const { ctx, page } = await open({ state }) await page.goto(`${WEB}/studio`) const enter = page.getByRole('button', { name: '先进去看看' }) const slow = await enter.waitFor({ timeout: 12000 }).then(() => true, () => false) check('请求卡住:启动页到点改说「比平时慢」', slow && (await page.locator('[data-boot] [role="status"]').innerText()).includes('比平时慢')) const live = await bootLiveRegions(page) check('读屏只播标题那一句:计时器不在播报区里', live.ok, JSON.stringify(live)) check('先说清楚进去的代价', (await page.locator('[data-boot]').innerText()).includes('不代表没有数据')) await enter.click() await waitNav(page) const telemetry = nav(page).locator('[data-telemetry]') // 这一路唯一的 /health 探活和「先进去看看」同时出现,按钮点得快时它还在路上 await page.waitForFunction(() => document.querySelector('[data-telemetry]')?.getAttribute('data-telemetry') !== 'checking', null, { timeout: 5000 }) .catch(() => {}) const tone = await telemetry.getAttribute('data-tone') check('进去以后遥测点不是「在线」,而是「加载中」', tone === '加载中', `${tone} / ${await telemetry.innerText()}`) const warn = page.getByText(/没取回来.*先别新建/) check('常驻提示点名还没回来的几项,劝先别新建', await warn.waitFor({ timeout: 3000 }).then(() => true, () => false) && /工作流/.test(await warn.innerText()), await warn.innerText().catch(() => '')) await page.waitForTimeout(4500) check('提示是常驻的,不会自己消失', await warn.isVisible()) await telemetry.click() const panel = page.getByRole('dialog', { name: '后端连接' }) check('遥测浮层里写出哪几项还没回来', /还没回来/.test(await panel.innerText())) await page.keyboard.press('Escape') state.hang = false await page.locator('[role="status"] > div', { hasText: '先别新建' }).getByRole('button', { name: '重试' }).click() const settled = await page.waitForFunction(() => document.querySelector('[data-telemetry]')?.getAttribute('data-tone') === '在线', null, { timeout: 8000 }) .then(() => true, () => false) check('重试后全部回来:遥测点回到「在线」', settled, await telemetry.getAttribute('data-tone')) check('提示随之撤掉', await warn.waitFor({ state: 'detached', timeout: 3000 }).then(() => true, () => false)) check('没有未捕获的运行时错误', page.errors.length === 0, page.errors[0] ?? '') await ctx.close() }) await section('启动页', '', async () => { // 只有一张表卡住(后端连着):每个请求最多等 15 秒,到点记成出错。遥测点从「加载中」 // 转成「降级」,提示也得跟着改口说「没加载成功」,而不是悄悄撤掉——那张表还是空的 const state = { approvals: [], offline: false, writes: [], hangPath: '/api/tools' } const { ctx, page } = await open({ state }) await page.goto(`${WEB}/chat`) // 第一次全量加载要等那一项超时才算落定,启动页到点自己放人进来 const entered = await nav(page).waitFor({ timeout: 25000 }).then(() => true, () => false) check('卡住的那一项超时后,启动页自己放人进来', entered) const warn = page.getByText(/有 1 项没加载成功(工具 超时).*先别新建/) check('超时的那一项:进门就说它没加载成功,劝先别新建', await warn.waitFor({ timeout: 5000 }).then(() => true, () => false), await warn.innerText().catch(() => '没有这条提示')) const telemetry = nav(page).locator('[data-telemetry]') check('遥测点记为「降级」', (await telemetry.getAttribute('data-tone')) === '降级', await telemetry.getAttribute('data-tone')) await telemetry.click() const row = page.getByRole('dialog', { name: '后端连接' }).locator('[data-check="tools"]') const rowText = (await row.innerText()).replace(/\s+/g, ' ') check('加载清单里那一项写「超时」,不写「连不上」', /超时/.test(rowText), rowText) await page.keyboard.press('Escape') await page.waitForTimeout(4500) check('提示常驻,不会自己消失', await warn.isVisible()) state.hangPath = null await page.locator('[role="status"] > div', { hasText: '没加载成功' }).getByRole('button', { name: '重试' }).click({ timeout: 5000 }).catch(() => {}) check('重试取回来:提示撤掉', await warn.waitFor({ state: 'detached', timeout: 5000 }).then(() => true, () => false)) check('遥测点回到「在线」', await page.waitForFunction(() => document.querySelector('[data-telemetry]')?.getAttribute('data-tone') === '在线', null, { timeout: 8000 }) .then(() => true, () => false), await telemetry.getAttribute('data-tone')) check('没有未捕获的运行时错误', page.errors.length === 0, page.errors[0] ?? '') await ctx.close() }) await section('启动页', '', async () => { // 取回来过的表,后来的刷新卡住了:手上的列表是真的(失败不清空),遥测点说「加载中」 // 就够了,不能再弹「列表可能不全,先别新建」吓人 const state = { approvals: [], offline: false, writes: [] } const { ctx, page } = await open({ state }) await page.goto(`${WEB}/chat`) await waitNav(page) const telemetry = nav(page).locator('[data-telemetry]') await page.waitForFunction(() => document.querySelector('[data-telemetry]')?.getAttribute('data-tone') === '在线', null, { timeout: 10000 }).catch(() => {}) state.hangPath = '/api/tools' await telemetry.click() const panel = page.getByRole('dialog', { name: '后端连接' }) await panel.getByRole('button', { name: '重新检测' }).click() // 按钮进忙碌态是下一帧的事。以前按钮一 disabled,焦点就被甩到 body 上,Esc 再也到不了 // 浮层——点完立刻按 Esc 抢在前头才过得去,机器一忙就卡住。等两帧再按,测的就是忙着的时候 await page.evaluate(() => new Promise((r) => requestAnimationFrame(() => requestAnimationFrame(r)))) await page.keyboard.press('Escape') const closed = await panel.waitFor({ state: 'detached', timeout: 1500 }).then(() => true, () => false) check('重新检测之后 Esc 仍能关掉浮层,焦点没被甩到 body 上', closed, closed ? '' : `焦点在 ${await page.evaluate(() => document.activeElement?.tagName)}`) // 没关掉就替它关上,后面几项照常量,别让一处失败连带出 30 秒的超时 if (!closed) await telemetry.click() await page.waitForTimeout(3800) check('刷新卡住:遥测点说「加载中」', (await telemetry.getAttribute('data-tone')) === '加载中', await telemetry.getAttribute('data-tone')) check('……但不弹「先别新建」:那张表之前取回来过', (await page.getByText(/先别新建/).count()) === 0) await telemetry.click() await panel.waitFor({ timeout: 3000 }) const panelText = await panel.innerText() check('遥测浮层照样写出哪一项还没回来,但不劝别新建', /工具还没回来/.test(panelText) && !/先别急着新建/.test(panelText), panelText.replace(/\n/g, ' ')) await page.keyboard.press('Escape') check('没有未捕获的运行时错误', page.errors.length === 0, page.errors[0] ?? '') await ctx.close() }) await section('启动页', '', async () => { // 断线时在导航上换了主题:重连后补存进设置,不能被服务端的旧值翻回去 const state = { approvals: [], offline: true, writes: [] } const { ctx, page } = await open({ state }) await page.goto(`${WEB}/chat`) await page.getByRole('button', { name: '先进去看看' }).click({ timeout: 12000 }) await waitNav(page) await nav(page).getByRole('button', { name: /切换到.+主题/ }).click() const theme = () => page.evaluate(() => document.documentElement.getAttribute('data-theme')) check('离线时也能换主题(深色 → 浅色)', (await theme()) === 'light') check('提示说清楚:先在本机生效,连上后自动存', await page.getByText(/连上后端后自动存进设置/).waitFor({ timeout: 3000 }).then(() => true, () => false)) state.offline = false await page.locator('main').getByRole('button', { name: '立即重试' }).first().click() await page.locator('main').getByText('后端未连接').waitFor({ state: 'detached', timeout: 8000 }).catch(() => {}) await page.waitForTimeout(2500) check('重连后主题没被服务端的旧值翻回去', (await theme()) === 'light', await theme()) const put = state.writes.filter((w) => w.method === 'PUT' && w.path === '/api/settings').at(-1) check('重连后补存进设置(PUT ui.theme = light)', !!put && JSON.parse(put.body).values.ui.theme === 'light', put?.body ?? '没有请求') check('没有未捕获的运行时错误', page.errors.length === 0, page.errors[0] ?? '') await ctx.close() }) await browser.close() console.log(failed ? `\n✗ ${failed} 项未通过` : '\n✓ 外壳检查全部通过') process.exit(failed ? 1 : 0)