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
This commit is contained in:
2026-10-03 23:48:32 +08:00
parent 1896d1032b
commit ef41d98838
43 changed files with 8835 additions and 0 deletions
+312
View File
@@ -0,0 +1,312 @@
#!/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)