Files
print-tag-system/plugin/scripts/verify-preview.sh
T
funjia ef41d98838 feat: 新增 plugin/ 插件化形态(funjia.print-tag)+ 可选 SN 条码/二维码
把本工程的标签排版能力改造成 FunjiaUI 远端插件,放进 plugin/ 子目录,
与原独立 Web 版并存(两者功能一致,模板/版面/打印行为逐项对齐)。

- 入口从 createApp().mount() 改为 activate(ctx) + ctx.addRoute,注册 1 菜单 / 1 路由 / 2 命令
- 11 个模板的渲染收敛成 SpecTag,差异集中到 templates/registry.ts(字段/选项/默认值原样保留)
- 店铺名 / 电话从写死改为可配置,记忆在插件私有存储
- 内置二维码图片改为打包 data URL —— 远端插件没有自己的 public/
- 去掉 @headlessui/vue(换原生 select)与 Tailwind,样式类名统一 pt- 前缀避免污染宿主
- 可选接入宿主 api::sn-code:按 SN 生成真 Code 128 条码与可扫二维码;
  关闭时(默认)完全保持原静态二维码行为。领码优先贴到已排版的格子,不够才新建
- 新增 commands: print-tag:issue-sn / print-tag:render-svg(后者纯本地出图,供其它插件复用)
- code128.ts 实现真 Code 128 Set B(含校验位);二维码走 qrcode-generator(真 QR)
- 自带本地预览器(preview/mock-api.ts 补了 /api/sn-codes mock)与 deploy / verify 脚本
- verify.mjs 修掉一处误报:源码边界判据改为「解析后是否逃出工程根」,
  而不是「说明符是否以 .. 开头」(后者会把 src/components/X.vue → ../codes 误判为越界)

已发布到插件仓库:funjia.print-tag@1.0.0
2026-10-03 23:48:32 +08:00

313 lines
17 KiB
Bash
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
#!/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.<uid>.<exp>.<nonce>),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)