#!/usr/bin/env bash # ssw-platform **一条命令验证** —— 「快速打包 / 快速验证」的用户可见入口 # # 🔴 **为什么存在**(HANDOFF §3 批次 12 交付物 ④ 的原文要求): # 本仓有 6 把静态闸门 + 37 个测试二进制 + 6 把运行时尺子。 # 改一行代码要跑哪些、按什么顺序跑、哪一道慢了 ⇒ **没人知道** ⇒ # 结果是「全都跑一遍」(6 分钟)或者「一道都不跑」(然后提交坏代码)。 # ⇒ 本脚本把「该跑的」定成一个**固定顺序**,并在末尾打印**总耗时 + Top 3 最慢**。 # # 🔴 **判据:耗时必须可见**。看不见耗时 ⇒ 慢下来也没人管 ⇒ # 「快速验证」退化回「不敢验证」。 # # 用法: # bash scripts/verify.sh # 全量:pack-sync → build → 静态闸门 → 全量测试 # bash scripts/verify.sh --fast # 内环:pack-sync → build → 静态闸门(不跑测试,~15s) # bash scripts/verify.sh --lib # 中环:上面 + lib 单测 + **包冒烟**(起库) # bash scripts/verify.sh --smoke # 全量 + 运行时尺子(要起后端,最慢) # bash scripts/verify.sh --help # # 退出码:0 全过 / 1 有 ❌ / 2 用法错或前置错误 set -u ROOT="$(cd "$(dirname "$0")/.." && pwd)" SCRIPTS="$ROOT/scripts" MODE="full" # fast | lib | full | smoke VERBOSE=0 usage() { sed -n '2,25p' "$0" | sed 's/^# \{0,1\}//' } while [ "$#" -gt 0 ]; do case "$1" in -h|--help) usage; exit 0 ;; --fast) MODE="fast"; shift ;; --lib) MODE="lib"; shift ;; --smoke) MODE="smoke"; shift ;; -v|--verbose) VERBOSE=1; shift ;; *) echo "❌ 未知参数: $1"; usage; exit 2 ;; esac done PY_BIN="${PY_BIN-$(command -v python3 2>/dev/null || true)}" if [ -z "${PY_BIN}" ]; then echo "❌ 找不到 python3(静态闸门需要它)" exit 2 fi # ---------------------------------------------------------------- 环境告警 # # 🔴 **被「转发壳」接管的命令会让计时整体失真**(实测,别忽略这条): # 某些执行环境(沙箱 CLI / AI 助手内置 bash)会把 `grep` `sed` `cat` `wc` # 替换成一个转发壳(PATH 里指向 `…/shim/brokered-bin/<命令>`)。壳每次启动 # ≈0.19s,而本仓的闸门正是「几百次 grep」的形态 ⇒ 实测把 check-module # 从 **1.5s 放大到 13.7s(9 倍)**,check-contract 从 3.3s 放大到 8.1s。 # ⇒ 这种环境下打出来的耗时**不能**用来判断闸门本身快不快, # 要真实数字请到普通终端里重跑(本脚本在那边会打印真实值)。 _grep_at="$(command -v grep 2>/dev/null || true)" case "${_grep_at}" in */shim/* | */brokered-bin/*) echo "⚠️ 本环境的 grep 被转发壳接管:${_grep_at}" echo " 转发壳每次启动 ≈0.19s ⇒ 下面每步的耗时都会被**放大数倍**," echo " 不要用它判断闸门本身快不快;请到普通终端重跑取真实数字。" ;; esac # ---------------------------------------------------------------- 计时 # # 🔴 **时间源必须零启动开销**。原来每步取 2 个时间戳、再算 1 次差值,三次都起 # `python3`(每次 ≈120ms)⇒ 8 步共 24 次 ≈ **2.9s**。这 2.9s 不属于任何一步, # 却计进「总耗时」⇒ 结论会变成「闸门慢」,而真因是**计时器自己慢**。 # ⇒ 改成 `date +%s%N`(≈6ms)+ 纯 bash 整数运算(零进程)。 # 取不到纳秒(少数 BSD date)才回落到 python3 —— 慢,但结果仍然正确。 _now_probe="$(date +%s%N 2>/dev/null || true)" case "${_now_probe}" in '' | *[!0-9]*) now() { "${PY_BIN}" -c 'import time; print(int(time.time() * 1e9))'; } ;; *) now() { date +%s%N; } ;; esac # 纳秒差 ⇒ "12.3"(秒,一位小数) ns_to_secs() { local ms=$(( $1 / 1000000 )) printf '%d.%d' $(( ms / 1000 )) $(( (ms % 1000) / 100 )) } STEPS_NAME=() STEPS_SECS=() STEPS_RC=() T0="$(now)" FAILED=0 # run_step <名字> <命令...> run_step() { local name="$1"; shift local t_start t_end t_secs rc out printf '\n▶ %s\n' "${name}" t_start="$(now)" if [ "${VERBOSE}" -eq 1 ]; then "$@" rc=$? else # 只留尾部 25 行:闸门失败时的关键信息都在尾部(总结 / 失败清单) out="$("$@" 2>&1)" rc=$? if [ "${rc}" -ne 0 ]; then printf '%s\n' "${out}" | tail -25 elif [ "${VERBOSE}" -eq 1 ]; then printf '%s\n' "${out}" else printf '%s\n' "${out}" | tail -3 fi fi t_end="$(now)" t_secs="$(ns_to_secs $(( t_end - t_start )))" STEPS_NAME+=("${name}") STEPS_SECS+=("${t_secs}") STEPS_RC+=("${rc}") if [ "${rc}" -eq 0 ]; then printf ' ✅ %s(%ss)\n' "${name}" "${t_secs}" else printf ' ❌ %s(%ss,退出码 %d)\n' "${name}" "${t_secs}" "${rc}" FAILED=$((FAILED + 1)) fi return 0 } # ---------------------------------------------------------------- 步骤 # ① 契约生成段漂移(加包 / 改包后**必须**同步契约表) # # 🔴 放在**第一位**:如果契约表与包不一致,后面 check-contract 会报一堆 # 「契约 ↔ 代码漂移」,而真因只是「忘了跑 pack-sync」⇒ 先修这个省 8 秒排查。 run_step "契约生成段同步(pack-sync --check)" \ "${PY_BIN}" "${SCRIPTS}/pack-sync.py" --check # ② 编译(后面所有步骤都依赖它) run_step "编译(cargo build --offline)" \ cargo build --offline # ③ 静态闸门(6 把,纯静态、不起服务) run_step "静态闸门 check-arch" bash "${SCRIPTS}/check-arch.sh" run_step "静态闸门 check-boundary" bash "${SCRIPTS}/check-boundary.sh" run_step "静态闸门 check-naming" bash "${SCRIPTS}/check-naming.sh" run_step "静态闸门 check-module" bash "${SCRIPTS}/check-module.sh" run_step "静态闸门 check-contract" bash "${SCRIPTS}/check-contract.sh" run_step "静态闸门 check-citations" bash "${SCRIPTS}/check-citations.sh" # ④ 测试 if [ "${MODE}" = "lib" ] || [ "${MODE}" = "full" ] || [ "${MODE}" = "smoke" ]; then if [ "${MODE}" = "lib" ]; then run_step "单测(cargo test --lib)" \ cargo test --offline --workspace --lib # 🔴 **包冒烟必须单独一步**(`full` / `smoke` 里已由 `--workspace` 覆盖 ⇒ 不重复): # `--lib` 只跑单测 ⇒ 集成测试一条都不跑 ⇒ 下面这类**纯运行时**故障在这一档 # 完全看不见:包的表没建出来 / 面 B 路由没 merge / `module_key` 指向不存在的菜单。 # 它们全都**不会让静态闸门红**,只表现为「前端页面空着」。 # 代价实测 +1.3s(含起 pglite + 起 HTTP 服务)⇒ 放进中环完全值得。 run_step "包冒烟(每个包的 List 真应答,面 A + 面 B)" \ cargo test --offline -p ssw-platform --test pack_smoke_it else run_step "全量测试(cargo test --workspace)" \ cargo test --offline --workspace fi fi # ⑤ 运行时尺子(要起后端,最慢;只有 --smoke 才跑) if [ "${MODE}" = "smoke" ]; then for s in perm-smoke perm-smoke-jnpf lowcode-smoke baseline-smoke mcp-smoke; do if [ -f "${SCRIPTS}/${s}.sh" ]; then run_step "运行时尺子 ${s}" bash "${SCRIPTS}/${s}.sh" else printf '\n▶ 运行时尺子 %s\n ⏭ 不存在,跳过\n' "${s}" fi done fi # ---------------------------------------------------------------- 汇总 T1="$(now)" TOTAL="$(ns_to_secs $(( T1 - T0 )))" echo echo "──────────────────────────────────────────" printf '总耗时 %ss(模式 %s,%d 个步骤)\n' "${TOTAL}" "${MODE}" "${#STEPS_NAME[@]}" # 🔴 **Top 3 最慢** —— 「快验证」的成本结构必须可见, # 否则没人知道该优化哪一道(本次就是靠它发现 check-contract 占 55s)。 if [ "${#STEPS_NAME[@]}" -gt 0 ]; then echo echo "最慢的 3 步:" # 用制表符把「名字 / 耗时」喂给 python 排序(bash 没有浮点排序) for i in "${!STEPS_NAME[@]}"; do printf '%s\t%s\n' "${STEPS_SECS[$i]}" "${STEPS_NAME[$i]}" done | "${PY_BIN}" -c ' import sys rows = [] for line in sys.stdin: line = line.rstrip("\n") if not line: continue secs, name = line.split("\t", 1) rows.append((float(secs), name)) for rank, (secs, name) in enumerate(sorted(rows, reverse=True)[:3], 1): print(" %d. %-46s %ss" % (rank, name, secs)) ' fi echo if [ "${FAILED}" -eq 0 ]; then echo "全 ✅ (${TOTAL}s)" exit 0 fi echo "有 ${FAILED} 步失败,见上面的 ❌" exit 1