#!/usr/bin/env bash # sspf 架构边界自检 —— crate 依赖纪律 + 内存红线 # # 目的:把 PLAN.md 判断 ②/⑥ 的架构约束变成**可执行的尺子**。 # 靠人读 Cargo.toml 守不住 —— 加依赖的人不会想到「这会让所有业务包背锅」。 # # 🔴 **纯静态**:不编译、不启动。只需要 bash + python3(macOS 自带)。 # # 用法: # bash scripts/check-arch.sh # 全查 # bash scripts/check-arch.sh --self-test # 反自证:造已知违规,必须被抓到 # # 退出码:0 全过 / 1 有 ❌ / 2 用法错 # # ── 判据 ── # AR1 `crates/sspf-sdk` 依赖只能有 `sspf-contract` # —— 业务包只依赖 sdk ⇒ sdk 多一个依赖 = 所有业务包都要背 # AR2 `packs/*/Cargo.toml` 依赖 ⊆ {sspf-sdk, serde} # —— 业务包必须能整目录搬走 ⇒ 不许挂在 axum / tokio / pglite 上 # AR3 `crates/sspf-contract` 源码不许 `use axum|tokio|pglite|sqlx` # —— 契约层一旦有 IO,业务包就再也不是「轻依赖」 # AR4 `crates/sspf-contract` 依赖 ⊆ {serde, serde_json, uuid, http} # AR5 `crates/sspf-mcp`(若已存在)依赖 ⊆ {sspf-contract, serde, serde_json, tokio, async-trait} # —— MCP 层要能同时接「进程内内核」和「远端 Java 后端」⇒ **不许依赖内核内部** # —— tokio / async-trait 是协议实现(stdio 异步读写)所需,不是业务依赖 # AR6 `crates/sspf-adapter-baseline` 依赖 ⊆ {sspf-mcp, sspf-contract, serde, serde_json, # tokio, http, hyper, hyper-util, http-body-util, bytes} # —— 适配器只认工具契约层;依赖内核 store 就等于把第二种后端钉死在本进程旁 # AR7 `crates/sspf-lowcode` 依赖 ⊆ {sspf-contract, serde, serde_json} # —— 低代码引擎是纯计算;依赖 DB/HTTP 会让它只能在内核里跑,且测试必须起库 # MEM1 非注释代码里不许出现 `SELECT *` # —— 终端产品内存预算 ≤ 120MB(PLAN.md 判断 ⑥)⇒ 全表读进 Vec 直接爆 # MEM2 `crates/**` 与 `src/backend/src/platform/**` 里不许出现无界 `HashMap` 缓存 # (近似检查:`static` + `Mutex/dev/null || true)" if [ -z "$hits" ]; then ok "AR3 sspf-contract 无 IO 依赖(无 axum/tokio/pglite/sqlx 的 use)" else bad "AR3 sspf-contract 出现 IO 依赖:" printf '%s\n' "$hits" | sed 's/^/ /' fi } # ---------------------------------------------------------------- AR4 check_ar4() { local f="$CRATES/sspf-contract/Cargo.toml" [ -f "$f" ] || { skip "AR4 sspf-contract 不存在"; return; } local deps; deps="$(deps_of "$f" | tr '\n' ' ')" if subset_of "$deps" "serde serde_json uuid http"; then ok "AR4 sspf-contract 依赖在白名单内([$deps])" else bad "AR4 sspf-contract 依赖越界:[$deps] —— 白名单 serde/serde_json/uuid/http" fi } # ---------------------------------------------------------------- AR5 check_ar5() { local f="$CRATES/sspf-mcp/Cargo.toml" [ -f "$f" ] || { skip "AR5 sspf-mcp 不存在(P1 才落地)"; return; } local deps; deps="$(deps_of "$f" | tr '\n' ' ')" if subset_of "$deps" "sspf-contract serde serde_json tokio async-trait"; then ok "AR5 sspf-mcp 依赖干净([$deps])" else bad "AR5 sspf-mcp 依赖越界:[$deps] —— 只允许 sspf-contract/serde/serde_json/tokio/async-trait" fi } # ---------------------------------------------------------------- AR6 check_ar6() { local f="$CRATES/sspf-adapter-baseline/Cargo.toml" [ -f "$f" ] || { skip "AR6 sspf-adapter-baseline 不存在"; return; } local deps; deps="$(deps_of "$f" | tr '\n' ' ')" # 🔴 适配器只许依赖「工具契约层 + HTTP 客户端」。 # 一旦依赖 sspf-store / axum,第二种后端就只能跑在同一个内核旁边 —— 双轨失效。 if subset_of "$deps" "sspf-mcp sspf-contract serde serde_json tokio http hyper hyper-util http-body-util bytes"; then ok "AR6 sspf-adapter-baseline 依赖干净([$deps])" else bad "AR6 sspf-adapter-baseline 依赖越界:[$deps] —— 只许工具契约层 + HTTP 客户端,不许依赖内核 store" fi } # ---------------------------------------------------------------- AR7 check_ar7() { local f="$CRATES/sspf-lowcode/Cargo.toml" [ -f "$f" ] || { skip "AR7 sspf-lowcode 不存在"; return; } local deps; deps="$(deps_of "$f" | tr '\n' ' ')" # 🔴 低代码引擎必须是**纯计算**:解析 / 校验 / SQL 生成。 # 一旦依赖 pglite / axum,它就只能在内核里跑 —— CLI、MCP、离线校验工具都用不了, # 而且测试必须起数据库(现在 38 个测试 0 依赖、毫秒级)。 if subset_of "$deps" "sspf-contract serde serde_json"; then ok "AR7 sspf-lowcode 依赖干净([$deps])" else bad "AR7 sspf-lowcode 依赖越界:[$deps] —— 只许契约层 + 序列化,不许 DB / HTTP" fi } # ---------------------------------------------------------------- MEM1 # 只看**代码行**:去掉 `//` 之后的注释、`//!` / `///` 文档注释、以及字符串里的反引号示例。 check_mem1() { local hits hits="$(python3 - "$ROOT" <<'PY' import os, re, sys root = sys.argv[1] pat = re.compile(r'SELECT\s+\*', re.I) bad = [] for base in ('src/backend/src', 'crates'): for dirpath, dirnames, files in os.walk(os.path.join(root, base)): dirnames[:] = [d for d in dirnames if d not in ('target', 'tests', 'data')] for fn in files: if not fn.endswith('.rs'): continue p = os.path.join(dirpath, fn) # 文件名以 _it.rs 结尾的是集成测试,不查 if fn.endswith('_it.rs'): continue try: lines = open(p, encoding='utf-8').read().splitlines() except OSError: continue in_test = False for i, line in enumerate(lines, 1): s = line.strip() if s.startswith('#[cfg(test)]'): in_test = True if in_test: continue code = line.split('//', 1)[0] if pat.search(code): bad.append(f'{p}:{i}: {s}') for b in bad: print(b) PY )" if [ -z "$hits" ]; then ok "MEM1 无非注释的 SELECT *(全表读进 Vec 会直接超内存预算)" else bad "MEM1 发现 SELECT *(终端产品内存预算 ≤120MB,禁止整表载入):" printf '%s\n' "$hits" | sed 's/^/ /' fi } # ---------------------------------------------------------------- MEM2 # 近似检查:出现 `Mutex "$tmp/Cargo.toml" <<'TOML' [package] name = "arch-selftest" version = "0.0.0" edition = "2021" [dependencies] sspf-sdk = { path = "../../crates/sspf-sdk" } axum = "0.8" TOML local before=$FAIL check_ar2 >/dev/null 2>&1 local caught=0 [ "$FAIL" -gt "$before" ] && caught=1 rm -rf "$tmp" # 恢复计数(自证不算进正式统计) FAIL=$before if [ "$caught" -eq 1 ]; then echo "✅ 反自证通过:AR2 抓到了 axum 依赖" return 0 fi echo "❌ 反自证失败:AR2 没抓到明显违规 ⇒ 这把尺子是假的" return 1 } # ---------------------------------------------------------------- main [ "${1:-}" = "--help" ] && { usage; exit 0; } echo "── 架构边界闸门(crate 依赖纪律 + 内存红线)──" check_ar1 check_ar2 check_ar3 check_ar4 check_ar5 check_ar6 check_ar7 check_mem1 check_mem2 echo printf '结果: %d 通过 / %d 失败 / %d 跳过\n' "$PASS" "$FAIL" "$SKIP" if [ "${1:-}" = "--self-test" ]; then echo self_test || exit 1 fi [ "$FAIL" -eq 0 ] || exit 1 exit 0