#!/usr/bin/env bash # 预览器「调接口 + 登录鉴权」端到端验收。 # # ## 它要证明的六件事 # # | 组 | 主题 | # | -- | ---- | # | A | 未登录时**插件页面照样打得开**(预览没有路由守卫),但接口回 401 并自动弹登录框 | # | B | 演示账号能登录;令牌落盘为**裸令牌**(客户端不加 `Bearer ` 前缀)| # | C | **登录后插件真的拿到了数据** —— `ctx.http` 走通,表格渲染出种子的 4 行 | # | D | 令牌过期:启动恢复识别 401 → 清令牌 + 弹登录框(插件一行代码都不用写)| # | E | 退出登录:清空本地凭据,回到未登录态 | # | F | **后端契约**(curl 直连,不经浏览器):401 语义、严格 `Bearer ` 前缀、列表形状、未知接口 | # # ## 三条写断言的经验(都是踩过才写的) # # 1. **判据用「关键标记串」而不是整串相等**。直接断 # `text === "管理员 · 超级管理员"` 会在标签多一个空格时假失败; # 这里一律 `grep -q` 关键子串。 # 2. **「弹出了登录框」不等于「请求真的被拒了」**。登录框可能在别的路径上被打开, # 所以 401 那一组必须同时断言 **HTTP 状态码 + `code` 字段**(F 组用 curl 直验)。 # 3. **F 组刻意不走浏览器**:`fetch` 在页面里会被别的东西影响(拦截、重试、 # service worker),而接口契约要的是「后端到底返回了什么」。 # curl 直接打,结论不可争辩。 # # ## 前置(脚本不会自己起服务) # # cd <插件工程> && node node_modules/vite/bin/vite.js --config vite.preview.config.ts --port 5310 # # 用法:bash scripts/verify-preview.sh [http://127.0.0.1:5310] # # ⚠️ 必须**整段放在后台跑**(run_in_background):前台执行 `agent-browser open` # 会被进程管理 SIGTERM 掉,表现为「无任何输出 + 退出码 1」。 set -u export PATH="/c/Users/Administrator/.workbuddy/binaries/node/versions/22.22.2-3:$PATH" cd "$(dirname "$0")/.." || exit 1 mkdir -p .logs .shots AB="agent-browser" BASE="${1:-http://127.0.0.1:5310}" OUT=".logs/verify-preview.txt" : > "$OUT" # 演示账号(与 preview/mock-api.ts 的 USERS 保持一致) DEMO_ACCOUNT="funjia" DEMO_PASSWORD="funjia123" DEMO_NAME="管理员" DEMO_ROLE="超级管理员" # 种子数据里 device 表的条数(见 preview/mock-api.ts 的 SEED) SEED_DEVICE_ROWS=4 # 令牌存储键:**从页面里读**,不在这里再写一个字面量。 # 两边各写一遍的话,键名改了脚本会「查一个不存在的键」然后静默通过。 KEY_EXPR='window.__preview__.apiContract.TOKEN_KEY' PASS=0 FAIL=0 ok() { PASS=$((PASS + 1)); echo " PASS $1" >> "$OUT"; } ng() { FAIL=$((FAIL + 1)); echo " FAIL $1" >> "$OUT"; [ -n "${2:-}" ] && echo " 实际:$2" >> "$OUT"; } note() { echo " $1" >> "$OUT"; } step() { echo "" >> "$OUT"; echo "===== $1 =====" >> "$OUT"; } run() { timeout -k 5 "${T:-60}" $AB "$@" >> "$OUT" 2>&1; } # 跑一段 JS 并把返回值压成单行(去掉引号与转义),便于 grep probe() { timeout -k 5 60 $AB eval "$1" 2>/dev/null | sed 's/[\\"]//g' | tr -d '\r\n'; } # 登录框是否**可见**。 # # ⚠️ 不能只判 `!!document.querySelector('.el-dialog')` —— Element Plus 关闭对话框时 # 只是把它 `v-show` 起来,DOM **留在页面上**,于是那个判据永远是 true。 # 拿它当「弹框是否弹出」的判据,会让断言在该亮红灯的时候变绿(我第一次就栽在这)。 DIALOG_OPEN="(()=>{const o=document.querySelector('.el-overlay');if(!o)return false;const s=getComputedStyle(o);return s.display!=='none'&&s.visibility!=='hidden'&&s.opacity!=='0';})()" dialog_open() { probe "$DIALOG_OPEN"; } # ⚠️ **点页面里的东西之前必须先 scrollintoview。** # # agent-browser 的 `click` 不自动滚动 —— 元素在视口外时,它按元素的坐标派发鼠标事件, # 于是点击落在**别的元素**上(或者干脆落在页面外),而命令照样报「✓ Done」。 # 表现是「断言莫名其妙全红,但手动在页面上点一下又是好的」,能查很久。 # 顶栏/弹窗里的元素天然在视口内,不需要这一步;页面区(`.pv-stage__body`)里的需要。 click_in_page() { # $1=选择器 run scrollintoview "$1" >/dev/null run click "$1" >/dev/null } expect() { # $1=说明 $2=期望子串 $3=实际值 if printf '%s' "$3" | grep -q "$2"; then ok "$1"; else ng "$1" "$3"; fi } expect_not() { if printf '%s' "$3" | grep -q "$2"; then ng "$1" "$3"; else ok "$1"; fi } # 直接打接口拿一份登录凭据,供「预置登录态」用。 # 拿的是**接口原样的响应**而不是自己拼的:token 与 user 都从响应里抠出来, # 脚本里不再抄一份字段(抄了就会在字段改动时静默失效)。 api_login() { curl -s --noproxy '*' -X POST "$BASE/api/auth/login" \ -H 'Content-Type: application/json' \ -d "{\"account\":\"$DEMO_ACCOUNT\",\"password\":\"$DEMO_PASSWORD\"}" } api_token() { printf '%s' "$1" | sed -n 's/.*"token":"\([^"]*\)".*/\1/p'; } api_user() { printf '%s' "$1" | sed -n 's/.*"user":\({[^}]*}\).*/\1/p'; } # 预置一个已登录的本地状态(绕开表单)。 # ⚠️ **两个键都要写**:宿主的启动恢复要求「令牌 + 用户信息」同时存在, # 只有令牌会被判成「本地数据不一致」直接清掉 —— 这正是本脚本第一次跑时 # E 组失败的原因(表现是「预置了令牌却还是未登录」)。 seed_auth() { # $1=token $2=user(JSON) run eval "localStorage.setItem(window.__preview__.apiContract.TOKEN_KEY, '$1'); localStorage.setItem(window.__preview__.apiContract.USER_KEY, '$2')" >/dev/null } # 确保登录框是开着的,好让任意一组都能单独跑 ensure_login_dialog() { if [ "$(dialog_open)" != "true" ]; then run click ".pv-auth button" >/dev/null sleep 1 fi } echo "############ verify-preview BASE=$BASE $(date +%H:%M:%S) ############" >> "$OUT" # --------------------------------------------------------------------------- step "A. 未登录:页面能打开(预览不拦页面),但接口回 401 并弹登录框" # ⚠️ 必须**先清掉上一次运行留下的登录态**。 # # agent-browser 的浏览器是**持久**的(daemon 里存着 profile),上一轮登录的令牌 # 还在 localStorage 里。不清就直接开跑,第一组断言会以「已登录」的状态开始 —— # 现象是「未登录该被拦的地方一个都没拦」,而所有断言看起来都在正常执行。 run open "$BASE" >/dev/null sleep 2 run eval "localStorage.clear()" >/dev/null run reload >/dev/null sleep 3 note "首屏 => $(probe "JSON.stringify({title:document.title,auth:document.querySelector('.pv-auth')?.innerText,page:!!document.querySelector('.pv-stage__body .hello-page'),dialog:!!document.querySelector('.el-dialog')})")" A_AUTH=$(probe "document.querySelector('.pv-auth')?.innerText ?? ''") A_PAGE=$(probe "document.querySelector('.pv-stage__body .hello-page')?.innerText?.slice(0,40) ?? ''") A_TOKEN=$(probe "localStorage.getItem($KEY_EXPR)") expect "首屏是未登录态" "未登录" "$A_AUTH" # 「页面能打开」必须用**只有真页面才成立**的特征来证,不能只证「不是登录页」 expect "插件页面真的渲染出来了(预览没有路由守卫)" "你好插件" "$A_PAGE" expect_not "未登录时没有令牌落盘" "mock\." "$A_TOKEN" expect "首屏没有自动弹登录框(没令牌就不发请求)" "false" "$(dialog_open)" # 未登录点「拉设备列表」→ 401 → 自动弹登录框 click_in_page ".hello-page__api-ops button.el-button--primary" sleep 2 A_AFTER=$(probe "JSON.stringify({msg:document.querySelector('.el-dialog .el-alert__title')?.innerText ?? '',log:window.__preview__.host.state.logs.slice(-1)[0]?.text ?? ''})") note "未登录调用接口后 => dialog=$(dialog_open) $A_AFTER" expect "未登录调接口后自动弹出登录框" "true" "$(dialog_open)" expect "提示里点明了原因(接口需要登录)" "接口需要登录" "$A_AFTER" expect "宿主日志里留了一条 401" "401" "$A_AFTER" # --------------------------------------------------------------------------- step "B. 登录:演示账号可用,令牌落盘为裸令牌" ensure_login_dialog B_DEMO=$(probe "document.querySelector('.pv-login__demo')?.innerText ?? ''") note "演示账号 chip => $B_DEMO" expect "登录框里列出了演示账号" "$DEMO_ACCOUNT" "$B_DEMO" expect "演示账号带了角色说明" "$DEMO_ROLE" "$B_DEMO" # 点演示账号 chip 填入,再点「登录」 run click ".pv-login__demo" >/dev/null sleep 1 run click ".el-dialog__footer button.el-button--primary" >/dev/null sleep 2 B_STATE=$(probe "JSON.stringify({auth:document.querySelector('.pv-auth')?.innerText ?? '',token:localStorage.getItem($KEY_EXPR) ?? ''})") note "登录后 => $B_STATE" expect "顶栏显示出登录用户" "$DEMO_NAME" "$B_STATE" expect "顶栏显示出角色" "$DEMO_ROLE" "$B_STATE" expect "令牌已落盘" "mock\." "$B_STATE" # 前缀由请求层统一补 —— localStorage 里必须是裸令牌。 # 存成 "Bearer mocks.xxx" 的话请求头会变成 "Bearer Bearer xxx",且只在接真后端时暴露 expect_not "落盘的是裸令牌(不带 Bearer 前缀)" "Bearer" "$B_STATE" expect "登录成功后登录框关闭" "false" "$(dialog_open)" # --------------------------------------------------------------------------- step "C. 登录后插件真的拿到数据(ctx.http 走通)" click_in_page ".hello-page__api-ops button.el-button--primary" sleep 2 C_STATE=$(probe "JSON.stringify({rows:document.querySelectorAll('.hello-page__api-table tbody tr').length,msg:document.querySelector('.hello-page__api-msg .el-alert__title')?.innerText ?? '',user:document.querySelector('.hello-page__api-user')?.innerText ?? ''})") note "插件页 => $C_STATE" expect "表格渲染出了种子数据的行数($SEED_DEVICE_ROWS 行)" "rows:$SEED_DEVICE_ROWS" "$C_STATE" expect "提示里报了取回条数与总数" "共 $SEED_DEVICE_ROWS 条" "$C_STATE" expect "页面拿到的登录用户来自 ctx.getUser()" "$DEMO_NAME" "$C_STATE" # 换一个表再拉一次:证明请求层不是「只对某一个接口特判」 click_in_page ".hello-page__api-ops button:not(.el-button--primary)" sleep 2 C_NOTICE=$(probe "document.querySelector('.hello-page__api-msg .el-alert__title')?.innerText ?? ''") note "公告列表 => $C_NOTICE" expect "同一个请求层能拉别的表" "租赁设备季度巡检安排" "$C_NOTICE" # --------------------------------------------------------------------------- step "D. 令牌过期:启动恢复识别 401 → 清令牌 + 弹登录框" # 造一个**已过期**的令牌:形状合法(mock...),exp 是 1970 年。 # 用户信息也要一起写 —— 只有令牌的话启动恢复会先在「数据不一致」那一步清掉, # 根本走不到「拿令牌去问后端」这一步(那样等于没验到 401)。 seed_auth "mock.1.1.abcdefgh" "$(api_user "$(api_login)")" run reload >/dev/null sleep 3 D_STATE=$(probe "JSON.stringify({auth:document.querySelector('.pv-auth')?.innerText ?? '',token:localStorage.getItem(window.__preview__.apiContract.TOKEN_KEY) ?? 'null',msg:document.querySelector('.el-dialog .el-alert__title')?.innerText ?? ''})") note "带过期令牌刷新后 => dialog=$(dialog_open) $D_STATE" expect "过期令牌在启动恢复时被清掉" "token:null" "$D_STATE" expect "回到未登录态" "未登录" "$D_STATE" expect "自动弹出登录框" "true" "$(dialog_open)" expect "提示说的是「登录已过期」而不是「未登录」" "过期" "$D_STATE" # 这一条区分「会话失效」与「从来没登录过」—— # 两条路都会弹框,但文案必须不一样,否则用户不知道该不该重新登录 expect_not "过期提示与「从未登录」的文案区分开" "接口需要登录" "$D_STATE" # --------------------------------------------------------------------------- step "E. 退出登录:清空本地凭据" LOGIN_JSON=$(api_login) seed_auth "$(api_token "$LOGIN_JSON")" "$(api_user "$LOGIN_JSON")" run reload >/dev/null sleep 3 E_BEFORE=$(probe "document.querySelector('.pv-auth')?.innerText ?? ''") expect "预置令牌后刷新即为已登录" "$DEMO_NAME" "$E_BEFORE" run click ".pv-auth button" >/dev/null sleep 2 E_AFTER=$(probe "JSON.stringify({auth:document.querySelector('.pv-auth')?.innerText ?? '',token:localStorage.getItem(window.__preview__.apiContract.TOKEN_KEY) ?? 'null'})") note "退出后 => $E_AFTER" expect "退出后回到未登录态" "未登录" "$E_AFTER" expect "退出后令牌已清空" "token:null" "$E_AFTER" # --------------------------------------------------------------------------- step "F. 后端契约(curl 直连,不经浏览器)" CT='Content-Type: application/json' curl_of() { curl -s --noproxy '*' -w '\nHTTP:%{http_code}' "$@"; } F_BAD=$(curl_of -X POST "$BASE/api/auth/login" -H "$CT" -d '{"account":"funjia","password":"wrong-password"}') note "错误密码 => $(echo "$F_BAD" | tr -d '\r\n')" # 密码错误是**业务失败**,不是未授权。回 401 会被上层当成「令牌失效」去清会话 expect "密码错误:HTTP 不是 401" "HTTP:200" "$F_BAD" expect "密码错误:业务码是 1" '"code":1' "$F_BAD" expect_not "密码错误:不带 401 业务码" '"code":401' "$F_BAD" F_LOGIN=$(curl_of -X POST "$BASE/api/auth/login" -H "$CT" -d "{\"account\":\"$DEMO_ACCOUNT\",\"password\":\"$DEMO_PASSWORD\"}") expect "正确密码:业务码 0" '"code":0' "$F_LOGIN" expect "正确密码:返回了令牌" '"token":"mock\.' "$F_LOGIN" F_ANON=$(curl_of "$BASE/api/device/list?page=1&pageSize=5") note "匿名请求 => $(echo "$F_ANON" | tr -d '\r\n')" expect "匿名请求:HTTP 401" "HTTP:401" "$F_ANON" expect "匿名请求:业务码 401" '"code":401' "$F_ANON" TOKEN=$(api_token "$(api_login)") # 只带裸令牌、**不加 Bearer 前缀** —— 这一步专门验「严格校验前缀」。 # 宽松的实现在这里会给 200,于是「请求层忘了加前缀」的 bug 一路潜伏到接真后端 F_NOPREFIX=$(curl_of "$BASE/api/device/list?page=1&pageSize=5" -H "Authorization: $TOKEN") note "缺 Bearer 前缀 => $(echo "$F_NOPREFIX" | tr -d '\r\n')" expect "缺 Bearer 前缀:按未授权处理" '"code":401' "$F_NOPREFIX" expect "缺 Bearer 前缀:提示点明是前缀问题" "Bearer" "$F_NOPREFIX" F_OK=$(curl_of "$BASE/api/device/list?page=1&pageSize=5" -H "Authorization: Bearer $TOKEN") note "带 Bearer => $(echo "$F_OK" | tr -d '\r\n')" expect "带 Bearer:业务码 0" '"code":0' "$F_OK" # 列表形状:data 是**数组**、total 是**同级字段**。 # 写成 data:{rows,total} 是最常见的抄错,症状是「接口成功但表格永远空着」 expect "列表形状:data 是数组" '"data":\[' "$F_OK" expect "列表形状:total 与 data 同级" '"total":' "$F_OK" if printf '%s' "$F_OK" | grep -q '"data":{"rows"'; then ng "列表形状:data 不能是 {rows,total}" "$F_OK" else ok "列表形状:data 就是数组(不是 {rows,total})" fi # 未知**接口**(不匹配通用 CRUD 形状):必须明确说是预览后端没实现。 # 用 `/api/meta/overview` 举例是有意的 —— 宿主有这条接口(`src/mock/` 里的聚合数字), # 预览的 mock 没实现它,这正是插件作者最容易撞上的那一类: # 「在宿主里跑得好好的,到预览里就没了」,得一眼看出是预览的缺口而不是自己写错了。 F_404=$(curl_of "$BASE/api/meta/overview" -H "Authorization: Bearer $TOKEN") note "未知接口 => $(echo "$F_404" | tr -d '\r\n')" expect "未知接口:明确说是预览后端没实现" "预览后端没有这个接口" "$F_404" # 未知**集合名**是另一回事:通用 CRUD 会动态建空表(宿主同行为), # 于是返回成功 + 空数组。这条断言的作用是把「与宿主一致」这件事钉住 —— # 哪天有人想把它改成 404,会先在这里看到自己改掉了契约。 F_GHOST=$(curl_of "$BASE/api/ghost-table/list" -H "Authorization: Bearer $TOKEN") note "未知集合名 => $(echo "$F_GHOST" | tr -d '\r\n')" expect "未知集合名:动态建空表并返回成功(与宿主一致)" '"code":0' "$F_GHOST" expect "未知集合名:data 是空数组、total 是 0" '"total":0' "$F_GHOST" F_PUB=$(curl_of "$BASE/api/auth/demo-accounts") expect "演示账号接口免登录可用" '"code":0' "$F_PUB" expect "演示账号接口列出了 funjia" "$DEMO_ACCOUNT" "$F_PUB" # --------------------------------------------------------------------------- step "G. 截图与控制台" run screenshot .shots/preview-auth.png >/dev/null run console >/dev/null note "控制台片段见 .logs/verify-preview.txt 上方的 console 输出" echo "" >> "$OUT" echo "############ 结果:PASS=$PASS FAIL=$FAIL ############" >> "$OUT" echo "PASS=$PASS FAIL=$FAIL" exit $([ "$FAIL" -eq 0 ] && echo 0 || echo 1)