Files
ssw-platform/scripts/verify.sh
T
admin ecb77b230f 平台包零业务:示例移到技能仓、解绑 example-packs、闸门全部改防回流
- 物理移出 packs/{asset,books,demo,shop}、modules/ 四个面 A 适配器、纯技能副本、
  纯业务测试 crud_it.rs 与 new-pack 脚手架(v0.3.0 tag 完整保留旧形态)。
- 删 example-packs feature / example_packs() / sspf-pack-* 依赖 / packs/* member;
  packs_gen.rs 与 modules/mod.rs 生成段降级为恒空的注入点,装配链一条不删;
  pack-sync.py 把「零包」钉成合法目标态。
- 尺子不再「跳过」:CP1 防回流清单、check-module 三条、AR2/PACK1 正向断言、
  AR17 升级为零业务依赖判据(含注入式反自证)、契约反自证换平台锚点、FACE 零包重算。
- 面 A 冒烟 43→21 条(17 条平台权限闭环 + 4 条业务端点 404);pack_smoke_it 改
  运行时防回流探针;auth/db/batch7/permission/seed/routes 单测换平台内置夹具。
- 契约 [MENU_TREE] 收成 5 条系统菜单、[RULER] 改 21/3;README/CLAUDE/HANDOFF/
  CHANGELOG/contract §5.1/schema.sql/db.rs 注释同步。

验收:cargo test --workspace --no-fail-fast 649 passed / 0 failed / 6 ignored;
verify.sh --smoke 14/14;check-arch 24/24 + 反自证 14/14;
cargo tree -p sspf 无 sspf-pack-*。前端 src/frontend 按要求保留。
2026-11-04 21:54:22 +08:00

219 lines
8.5 KiB
Bash
Executable File
Raw Permalink 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
# 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` 只跑单测 ⇒ 集成测试一条都不跑 ⇒ 「平台是不是真的零业务」这一档
# 完全看不见(静态闸门只看文本,服务没起来/路由回流都测不到)。
# `pack_smoke_it` 在零业务清理后改成:清单恒空 + 平台端点仍活 + 4 个示例端点 404。
# 代价实测 +1.5s(含起 pglite + 起 HTTP 服务)⇒ 放进中环完全值得。
run_step "运行时防回流探针(零业务:清单空 / 平台活 / 业务端点 404)" \
cargo test --offline -p sspf-tests --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