Files
ssw-platform/scripts/verify.sh
T
admin ce30c5b2f6 feat(pack): 框架固定包 + 加模块一条命令(批次 12 + 12.5)
把「内核怎么知道有这个包」从手写改成生成,漏接直接报错而不是静默 404。

- crates/sspf-plugin:load_static() 收掉装配样板,bootstrap 的 load_packs 缩成一行

- 包统一出口:pub struct Pack + pub const DDLS(生成器不必理解各包常量命名)

- 业务 DDL 跟包走(packs/*/schema/*.sql 经 include_str! 编进二进制)

- packs_gen.rs / modules/mod.rs 5 段 / Cargo.toml / contract.md 三段改由 pack-sync.py 生成

- scripts/new-pack.sh:一条命令产出 5 个后端文件 + 接线 + 可选前端三件套

- scripts/verify.sh 静态闸门一键跑;.workbuddy 记忆与 HANDOFF 见下一提交
2026-11-01 23:04:53 +08:00

212 lines
7.9 KiB
Bash
Executable File
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
# ssw-platform **一条命令验证** —— 「快速打包 / 快速验证」的用户可见入口
#
# 🔴 **为什么存在**(HANDOFF §3 批次 12 交付物 ④ 的原文要求):
# 本仓有 6 把静态闸门 + 45 个测试二进制 + 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
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