refactor(kernel): 拆出 contract/store/sdk 三层 crate,剥离原厂标识
- 新增 sspf-contract(契约类型,不含 axum)、sspf-store(db/config,不认识 HTTP)、
sspf-sdk(业务包唯一依赖)与 packs/asset 样板包(可独立编译)
- 内核 platform/{envelope,entity,menu,ids,db,config}.rs 改为 re-export,引用路径零变化
- jnpf.rs → face_b.rs,9 处标识符改名;契约字面量(jnpf-origin / jnpfKey)刻意保留
- 新增 check-arch / check-naming / mem-budget 三道闸门;rust-toolchain 锁 1.95.0
- 影响:行为零变化(240 测试 / 九闸全绿 / 空载 7 MB),Profile 从 guard 迁到 config 断开假依赖
This commit is contained in:
1 parent
a25bd5ef96
commit
b11ec26106
43 files changed
+4264
-1801
No files matched your search
Executable
+277
@@ -0,0 +1,277 @@
|
||||
#!/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}
|
||||
# —— MCP 层要能同时接「进程内内核」和「远端 Java 后端」⇒ 不许依赖内核内部
|
||||
# MEM1 非注释代码里不许出现 `SELECT *`
|
||||
# —— 终端产品内存预算 ≤ 120MB(PLAN.md 判断 ⑥)⇒ 全表读进 Vec 直接爆
|
||||
# MEM2 `crates/**` 与 `src/backend/src/platform/**` 里不许出现无界 `HashMap` 缓存
|
||||
# (近似检查:`static` + `Mutex<HashMap` 必须有 `MAX` 常量同文件出现)
|
||||
#
|
||||
# 🔴 AR1–AR5 是 PLAN.md §3.2 的分层纪律;MEM1–MEM2 是判断 ⑥ 的四条内存红线的静态部分。
|
||||
|
||||
set -u
|
||||
|
||||
ROOT="$(cd "$(dirname "$0")/.." && pwd)"
|
||||
CRATES="$ROOT/crates"
|
||||
KERNEL="$ROOT/src/backend"
|
||||
|
||||
PASS=0
|
||||
FAIL=0
|
||||
SKIP=0
|
||||
|
||||
ok() { PASS=$((PASS + 1)); printf '✅ %s\n' "$1"; }
|
||||
bad() { FAIL=$((FAIL + 1)); printf '❌ %s\n' "$1"; }
|
||||
skip() { SKIP=$((SKIP + 1)); printf '⏭ %s\n' "$1"; }
|
||||
|
||||
usage() {
|
||||
echo "用法: bash scripts/check-arch.sh [--self-test]"
|
||||
echo " 静态检查 crate 依赖纪律(AR1–AR5)与内存红线(MEM1–MEM2)"
|
||||
echo "退出码: 0 全过 / 1 有 ❌ / 2 用法错"
|
||||
}
|
||||
|
||||
# 取出 Cargo.toml 里 [dependencies] 段的包名(一行一个,已去空白)
|
||||
deps_of() {
|
||||
awk '
|
||||
/^\[dependencies\]/ { f = 1; next }
|
||||
/^\[/ { f = 0 }
|
||||
f && /^[A-Za-z0-9_-]+[[:space:]]*=/ { sub(/[[:space:]]*=.*/, ""); print }
|
||||
' "$1"
|
||||
}
|
||||
|
||||
# 判断集合 A 是否 ⊆ 集合 B(两者都是空格分隔串)
|
||||
subset_of() {
|
||||
local need="$1" allowed=" $2 "
|
||||
local x
|
||||
for x in $need; do
|
||||
case "$allowed" in
|
||||
*" $x "*) : ;;
|
||||
*) return 1 ;;
|
||||
esac
|
||||
done
|
||||
return 0
|
||||
}
|
||||
|
||||
# ---------------------------------------------------------------- AR1
|
||||
check_ar1() {
|
||||
local f="$CRATES/sspf-sdk/Cargo.toml"
|
||||
[ -f "$f" ] || { skip "AR1 sspf-sdk 不存在(尚未拆分)"; return; }
|
||||
local deps; deps="$(deps_of "$f" | tr '\n' ' ')"
|
||||
if subset_of "$deps" "sspf-contract"; then
|
||||
ok "AR1 sspf-sdk 依赖干净([$deps])"
|
||||
else
|
||||
bad "AR1 sspf-sdk 依赖越界:[$deps] —— 只允许 sspf-contract"
|
||||
fi
|
||||
}
|
||||
|
||||
# ---------------------------------------------------------------- AR2
|
||||
check_ar2() {
|
||||
local found=0 n=0
|
||||
for f in "$ROOT"/packs/*/Cargo.toml; do
|
||||
[ -f "$f" ] || continue
|
||||
n=$((n + 1))
|
||||
local deps; deps="$(deps_of "$f" | tr '\n' ' ')"
|
||||
if subset_of "$deps" "sspf-sdk serde"; then
|
||||
ok "AR2 $(basename "$(dirname "$f")") 依赖干净([$deps])"
|
||||
else
|
||||
bad "AR2 $(basename "$(dirname "$f")") 依赖越界:[$deps] —— 只允许 sspf-sdk / serde"
|
||||
found=1
|
||||
fi
|
||||
done
|
||||
[ "$n" -eq 0 ] && skip "AR2 尚无 packs/*(P3 才落地)"
|
||||
return $found
|
||||
}
|
||||
|
||||
# ---------------------------------------------------------------- AR3
|
||||
check_ar3() {
|
||||
local dir="$CRATES/sspf-contract/src"
|
||||
[ -d "$dir" ] || { skip "AR3 sspf-contract 不存在"; return; }
|
||||
local hits
|
||||
hits="$(grep -rnE '^[[:space:]]*(pub )?use (axum|tokio|pglite|sqlx)' "$dir" 2>/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"; then
|
||||
ok "AR5 sspf-mcp 依赖干净([$deps])"
|
||||
else
|
||||
bad "AR5 sspf-mcp 依赖越界:[$deps] —— 只允许 sspf-contract/serde/serde_json"
|
||||
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<HashMap` 的静态缓存,同文件必须有 MAX_ / CAPACITY 常量。
|
||||
check_mem2() {
|
||||
local hits
|
||||
hits="$(python3 - "$ROOT" <<'PY'
|
||||
import os, re, sys
|
||||
root = sys.argv[1]
|
||||
cache = re.compile(r'Mutex\s*<\s*(std::collections::)?HashMap')
|
||||
cap = re.compile(r'\b(MAX|CAPACITY|LIMIT)_[A-Z0-9_]+\b')
|
||||
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') or fn.endswith('_it.rs'):
|
||||
continue
|
||||
p = os.path.join(dirpath, fn)
|
||||
try:
|
||||
text = open(p, encoding='utf-8').read()
|
||||
except OSError:
|
||||
continue
|
||||
if cache.search(text) and not cap.search(text):
|
||||
for i, line in enumerate(text.splitlines(), 1):
|
||||
if cache.search(line):
|
||||
bad.append(f'{p}:{i}: {line.strip()}')
|
||||
break
|
||||
for b in bad:
|
||||
print(b)
|
||||
PY
|
||||
)"
|
||||
if [ -z "$hits" ]; then
|
||||
ok "MEM2 缓存均有上限常量(无界缓存 = 慢性内存泄漏)"
|
||||
else
|
||||
bad "MEM2 发现疑似无界缓存(同文件没有 MAX_/CAPACITY_ 常量):"
|
||||
printf '%s\n' "$hits" | sed 's/^/ /'
|
||||
fi
|
||||
}
|
||||
|
||||
# ---------------------------------------------------------------- 反自证
|
||||
# 🔴 永远返回「干净」的尺子 = 没有尺子。造一个明知违规的临时 pack,必须被抓到。
|
||||
self_test() {
|
||||
echo "── 反自证:造一个依赖越界的假 pack,AR2 必须报 ❌ ──"
|
||||
local tmp="$ROOT/packs/__arch_selftest__"
|
||||
mkdir -p "$tmp"
|
||||
cat > "$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_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
|
||||
@@ -450,7 +450,9 @@ def analyze(contract_path, src_dir):
|
||||
|
||||
# ---- CC7 钉子测试清单 ↔ 代码注册路由(双向覆盖)----
|
||||
pins = []
|
||||
for name in ("REGISTERED", "JNPF_REGISTERED"):
|
||||
# 面 A 的清单叫 REGISTERED;面 B 的清单在 P0 改名后叫 FACE_B_REGISTERED
|
||||
# (原 JNPF_REGISTERED,按「前端不依赖的内部标识必须改」剥离)。
|
||||
for name in ("REGISTERED", "FACE_B_REGISTERED"):
|
||||
arr = parse_str_array(plat_orig, plat_masked,
|
||||
r"const\s+" + name + r"\s*:\s*\[&str;\s*\d+\]\s*=")
|
||||
if arr is not None:
|
||||
|
||||
@@ -21,7 +21,7 @@
|
||||
# CC4 代码 → 契约:代码里没有契约未登记的端点
|
||||
# CC5 **归属层**一致(platform / 业务模块代号)
|
||||
# CC6 **守卫**一致(面A 菜单 key / 面B 点权限编码 / 登录 / 无)——静态推导
|
||||
# CC7 钉子测试的**字面量清单**(REGISTERED / JNPF_REGISTERED)与平台层路由双向覆盖
|
||||
# CC7 钉子测试的**字面量清单**(REGISTERED / FACE_B_REGISTERED)与平台层路由双向覆盖
|
||||
# CC8 业务路由**三处**一致(各模块 ROUTES 常量 / router() 注册 / ALL_ROUTES)
|
||||
# CC9 契约面计数**自洽**([FACE] 登记的条数 == [ENDPOINT] 里各 face 的实际条数)
|
||||
# CC10 **官方端点台账** ↔ 代码真实路由(双向)+ 打印「官方端点覆盖 N/M」
|
||||
|
||||
Executable
+208
@@ -0,0 +1,208 @@
|
||||
#!/usr/bin/env bash
|
||||
# sspf 命名闸门 —— 原厂标识符剥离(PLAN.md §7.1)
|
||||
#
|
||||
# 判据只有一条:**前端 / 移动端 / 存量库是否依赖它**。
|
||||
# - 结构性字符串(路径 / 键名 / 头名 / 码值 / 枚举 / 表单 JSON 的 jnpfKey)⇒ **一字不改**
|
||||
# - 内部标识(crate / 模块 / 类型 / 函数 / 变量 / 文件名)⇒ **必须改**
|
||||
# - 展示性文案(msg)⇒ 可改,语义不变
|
||||
#
|
||||
# 🔴 本尺子只查**内部标识**,绝不碰字符串字面量 ——
|
||||
# 字符串里可能是契约(`/api/permission/Users`、表名、`jnpfKey`),改了前端就挂。
|
||||
#
|
||||
# 用法:
|
||||
# bash scripts/check-naming.sh # 全查(RED 阻断 + YELLOW 报数)
|
||||
# bash scripts/check-naming.sh --strict # 注释里的提及也算红(技术债清零时用)
|
||||
# bash scripts/check-naming.sh --self-test # 反自证:造违规必须被抓到
|
||||
#
|
||||
# 退出码:0 全过 / 1 有 ❌ / 2 用法错
|
||||
#
|
||||
# ── 判据 ──
|
||||
# NM1 源文件/目录名含原厂名 ⇒ 🔴 阻断
|
||||
# NM2 Rust 标识符含原厂名 ⇒ 🔴 阻断
|
||||
# (fn / struct / enum / trait / mod / const / static / type 之后的名字)
|
||||
# NM3 Cargo.toml 的 package name 含原厂名 ⇒ 🔴 阻断
|
||||
# NM4 代码注释里的提及 ⇒ 🟡 报数(技术债,逐步清零)
|
||||
# `--strict` 时升级为 🔴
|
||||
#
|
||||
# 🔴 为什么注释不一刀切:`JNPF_SOURCE_AUDIT.md` 这类文档整篇都是基线平台源码分析,
|
||||
# 注释里写「官方 `VisualAiServiceImpl.form()`」是**出处**,不是品牌露出。
|
||||
# 一刀切会逼人删掉溯源信息,反而降低可维护性。⇒ 量化 + 逐步替换成「基线平台」。
|
||||
|
||||
set -u
|
||||
|
||||
ROOT="$(cd "$(dirname "$0")/.." && pwd)"
|
||||
STRICT=0
|
||||
SELF_TEST=0
|
||||
|
||||
for a in "$@"; do
|
||||
case "$a" in
|
||||
--strict) STRICT=1 ;;
|
||||
--self-test) SELF_TEST=1 ;;
|
||||
--help) sed -n '2,30p' "$0"; exit 0 ;;
|
||||
*) echo "未知参数: $a"; exit 2 ;;
|
||||
esac
|
||||
done
|
||||
|
||||
PASS=0
|
||||
FAIL=0
|
||||
WARN=0
|
||||
|
||||
ok() { PASS=$((PASS + 1)); printf '✅ %s\n' "$1"; }
|
||||
bad() { FAIL=$((FAIL + 1)); printf '❌ %s\n' "$1"; }
|
||||
warn() { WARN=$((WARN + 1)); printf '🟡 %s\n' "$1"; }
|
||||
|
||||
# 只扫这些根(不要扫 target / node_modules / .workbuddy)
|
||||
SCAN_ROOTS=("$ROOT/src" "$ROOT/crates" "$ROOT/packs")
|
||||
|
||||
# 原厂名模式(大小写全部覆盖;中文「引迈」单独一份)
|
||||
PAT_EN='([Jj][Nn][Pp][Ff])'
|
||||
PAT_ZH='引迈'
|
||||
|
||||
list_rs() {
|
||||
local d
|
||||
for d in "${SCAN_ROOTS[@]}"; do
|
||||
[ -d "$d" ] || continue
|
||||
find "$d" -name '*.rs' -not -path '*/target/*' 2>/dev/null
|
||||
done
|
||||
}
|
||||
|
||||
# ---------------------------------------------------------------- NM1 文件名
|
||||
check_nm1() {
|
||||
local hits
|
||||
hits="$(for d in "${SCAN_ROOTS[@]}"; do
|
||||
[ -d "$d" ] || continue
|
||||
find "$d" \( -iname "*jnpf*" -o -name "*引迈*" \) -not -path '*/target/*' 2>/dev/null
|
||||
done)"
|
||||
if [ -z "$hits" ]; then
|
||||
ok "NM1 源文件名无原厂名"
|
||||
else
|
||||
bad "NM1 源文件名含原厂名(改文件名 + 同步 mod 声明与引用):"
|
||||
printf '%s\n' "$hits" | sed 's/^/ /'
|
||||
fi
|
||||
}
|
||||
|
||||
# ---------------------------------------------------------------- NM2 标识符
|
||||
# 只匹配**声明位置**的名字,不碰字符串字面量与注释。
|
||||
check_nm2() {
|
||||
local hits
|
||||
hits="$(python3 - "$ROOT" <<'PY'
|
||||
import os, re, sys
|
||||
root = sys.argv[1]
|
||||
# 声明关键字后面的标识符
|
||||
decl = re.compile(r'\b(fn|struct|enum|trait|mod|const|static|type)\s+([A-Za-z_][A-Za-z0-9_]*)')
|
||||
bad_name = re.compile(r'(jnpf|引迈)', re.I)
|
||||
out = []
|
||||
for base in ('src', 'crates', 'packs'):
|
||||
for dirpath, dirnames, files in os.walk(os.path.join(root, base)):
|
||||
dirnames[:] = [d for d in dirnames if d not in ('target', 'node_modules', 'data')]
|
||||
for fn in files:
|
||||
if not fn.endswith('.rs'):
|
||||
continue
|
||||
p = os.path.join(dirpath, fn)
|
||||
try:
|
||||
lines = open(p, encoding='utf-8').read().splitlines()
|
||||
except OSError:
|
||||
continue
|
||||
for i, line in enumerate(lines, 1):
|
||||
code = line.split('//', 1)[0]
|
||||
for m in decl.finditer(code):
|
||||
name = m.group(2)
|
||||
if bad_name.search(name):
|
||||
out.append(f'{os.path.relpath(p, root)}:{i}: {m.group(1)} {name}')
|
||||
for x in out:
|
||||
print(x)
|
||||
PY
|
||||
)"
|
||||
if [ -z "$hits" ]; then
|
||||
ok "NM2 代码标识符无原厂名"
|
||||
else
|
||||
bad "NM2 标识符含原厂名(前端读不到 ⇒ 必须改):"
|
||||
printf '%s\n' "$hits" | sed 's/^/ /'
|
||||
fi
|
||||
}
|
||||
|
||||
# ---------------------------------------------------------------- NM3 crate 名
|
||||
check_nm3() {
|
||||
local hits
|
||||
hits="$(grep -rlEi '^name[[:space:]]*=[[:space:]]*".*(jnpf|引迈)' \
|
||||
"$ROOT"/Cargo.toml "$ROOT"/src/*/Cargo.toml "$ROOT"/crates/*/Cargo.toml "$ROOT"/packs/*/Cargo.toml 2>/dev/null)"
|
||||
if [ -z "$hits" ]; then
|
||||
ok "NM3 crate / package 名无原厂名"
|
||||
else
|
||||
bad "NM3 crate 名含原厂名:"
|
||||
printf '%s\n' "$hits" | sed 's/^/ /'
|
||||
fi
|
||||
}
|
||||
|
||||
# ---------------------------------------------------------------- NM4 注释提及
|
||||
check_nm4() {
|
||||
local n
|
||||
n="$(python3 - "$ROOT" <<'PY'
|
||||
import os, re, sys
|
||||
root = sys.argv[1]
|
||||
bad = re.compile(r'(jnpf|引迈)', re.I)
|
||||
count = 0
|
||||
for base in ('src', 'crates', 'packs'):
|
||||
for dirpath, dirnames, files in os.walk(os.path.join(root, base)):
|
||||
dirnames[:] = [d for d in dirnames if d not in ('target', 'node_modules', 'data')]
|
||||
for fn in files:
|
||||
if not fn.endswith('.rs'):
|
||||
continue
|
||||
p = os.path.join(dirpath, fn)
|
||||
try:
|
||||
text = open(p, encoding='utf-8').read()
|
||||
except OSError:
|
||||
continue
|
||||
for line in text.splitlines():
|
||||
idx = line.find('//')
|
||||
if idx >= 0 and bad.search(line[idx:]):
|
||||
count += 1
|
||||
print(count)
|
||||
PY
|
||||
)"
|
||||
if [ "$n" -eq 0 ]; then
|
||||
ok "NM4 注释里无原厂名"
|
||||
elif [ "$STRICT" -eq 1 ]; then
|
||||
bad "NM4 注释里有 ${n} 处原厂名(--strict 模式):逐步替换为「基线平台 / baseline」"
|
||||
else
|
||||
warn "NM4 注释里有 ${n} 处提及(技术债,不阻断;--strict 可升级为红)"
|
||||
fi
|
||||
}
|
||||
|
||||
# ---------------------------------------------------------------- 反自证
|
||||
self_test() {
|
||||
echo "── 反自证:造一个含原厂标识符的文件,NM2 必须报 ❌ ──"
|
||||
local tmp="$ROOT/crates/__naming_selftest__"
|
||||
mkdir -p "$tmp/src"
|
||||
printf 'pub fn jnpf_probe() {}\n' > "$tmp/src/lib.rs"
|
||||
local before=$FAIL
|
||||
check_nm2 >/dev/null 2>&1
|
||||
local caught=0
|
||||
[ "$FAIL" -gt "$before" ] && caught=1
|
||||
rm -rf "$tmp"
|
||||
FAIL=$before
|
||||
if [ "$caught" -eq 1 ]; then
|
||||
echo "✅ 反自证通过:NM2 抓到了 jnpf_probe"
|
||||
return 0
|
||||
fi
|
||||
echo "❌ 反自证失败:NM2 没抓到明显违规 ⇒ 尺子是假的"
|
||||
return 1
|
||||
}
|
||||
|
||||
# ---------------------------------------------------------------- main
|
||||
echo "── 命名闸门(内部标识剥离;结构性字符串不在检查范围)──"
|
||||
check_nm1
|
||||
check_nm2
|
||||
check_nm3
|
||||
check_nm4
|
||||
|
||||
echo
|
||||
printf '结果: %d 通过 / %d 失败 / %d 提示\n' "$PASS" "$FAIL" "$WARN"
|
||||
|
||||
if [ "$SELF_TEST" -eq 1 ]; then
|
||||
echo
|
||||
self_test || exit 1
|
||||
fi
|
||||
|
||||
[ "$FAIL" -eq 0 ] || exit 1
|
||||
exit 0
|
||||
Executable
+127
@@ -0,0 +1,127 @@
|
||||
#!/usr/bin/env bash
|
||||
# mem-budget.sh —— 内存预算实测闸门(PLAN.md 判断 ⑥)
|
||||
#
|
||||
# 终端产品形态下,内存超标 = 不可交付。这条必须**实测**,不能靠感觉。
|
||||
#
|
||||
# 用法:
|
||||
# bash scripts/mem-budget.sh # 用 release 产物,空载测量
|
||||
# bash scripts/mem-budget.sh --bin <path> # 指定二进制
|
||||
# bash scripts/mem-budget.sh --budget 40 # 自定义空载预算(MB)
|
||||
#
|
||||
# 退出码:0 达标 / 1 超标 / 2 用法或环境错
|
||||
#
|
||||
# ── 量什么 ──
|
||||
# **空载 RSS**(刚起来、健康检查通过、没有业务请求)。
|
||||
# 典型/峰值预算要压测才能量,见 PLAN.md §2 判断 ⑥ 的表。
|
||||
#
|
||||
# ⚠️ 测量口径按平台选:
|
||||
# macOS ⇒ `vmmap` 的 **Physical footprint**(准确,扣掉共享页与保留虚拟地址)
|
||||
# Linux ⇒ `ps -o rss=`(近似,但趋势够用)
|
||||
# 本机沙箱禁止 `ps` / `top`,所以必须走 vmmap 分支。
|
||||
|
||||
set -u
|
||||
|
||||
ROOT="$(cd "$(dirname "$0")/.." && pwd)"
|
||||
BIN="$ROOT/target/release/ssw-platform"
|
||||
BUDGET_MB=40
|
||||
PORT=30997
|
||||
STARTUP_WAIT=25
|
||||
|
||||
while [ $# -gt 0 ]; do
|
||||
case "$1" in
|
||||
--bin) BIN="$2"; shift 2 ;;
|
||||
--budget) BUDGET_MB="$2"; shift 2 ;;
|
||||
--port) PORT="$2"; shift 2 ;;
|
||||
--help) sed -n '2,20p' "$0"; exit 0 ;;
|
||||
*) echo "未知参数: $1"; exit 2 ;;
|
||||
esac
|
||||
done
|
||||
|
||||
[ -x "$BIN" ] || { echo "❌ 二进制不存在或不可执行: $BIN"; echo " 先跑: cargo build --release"; exit 2; }
|
||||
|
||||
TMPDB="$(mktemp -d /tmp/sspf-memtest.XXXXXX)"
|
||||
LOG="$TMPDB/backend.log"
|
||||
|
||||
cleanup() {
|
||||
if [ -n "${PID:-}" ] && kill -0 "$PID" 2>/dev/null; then
|
||||
kill "$PID" 2>/dev/null || true
|
||||
sleep 0.5
|
||||
kill -9 "$PID" 2>/dev/null || true
|
||||
fi
|
||||
rm -rf "$TMPDB"
|
||||
}
|
||||
trap cleanup EXIT INT TERM
|
||||
|
||||
echo "── 内存预算实测(空载 RSS,预算 ${BUDGET_MB} MB)──"
|
||||
echo " 二进制: $BIN"
|
||||
|
||||
env PORT="$PORT" PGLITE_DIR="$TMPDB/db" "$BIN" >"$LOG" 2>&1 &
|
||||
PID=$!
|
||||
|
||||
# 等健康检查(最多 STARTUP_WAIT 秒)
|
||||
ok=0
|
||||
for _ in $(seq 1 $((STARTUP_WAIT * 2))); do
|
||||
if ! kill -0 "$PID" 2>/dev/null; then
|
||||
echo "❌ 后端启动即退出,日志尾部:"
|
||||
tail -20 "$LOG" | sed 's/^/ /'
|
||||
exit 2
|
||||
fi
|
||||
if curl -s --noproxy '*' --max-time 1 "http://127.0.0.1:$PORT/api/health" 2>/dev/null | grep -q '"ok"'; then
|
||||
ok=1
|
||||
break
|
||||
fi
|
||||
sleep 0.5
|
||||
done
|
||||
|
||||
if [ "$ok" -ne 1 ]; then
|
||||
echo "❌ ${STARTUP_WAIT}s 内健康检查未通过,日志尾部:"
|
||||
tail -20 "$LOG" | sed 's/^/ /'
|
||||
exit 2
|
||||
fi
|
||||
|
||||
# 让初始化(建表 + 种子)彻底落定,再量一次稳态
|
||||
sleep 2
|
||||
|
||||
# 取「独占物理内存」(MB)。优先 vmmap,退回 ps。
|
||||
# 🔴 本机沙箱里 `ps` / `top` 会被拦(Operation not permitted),vmmap 可用。
|
||||
measure_rss_mb() {
|
||||
local pid="$1" raw val unit
|
||||
if command -v vmmap >/dev/null 2>&1; then
|
||||
raw="$(vmmap "$pid" 2>/dev/null | awk '/^Physical footprint:/{print $3; exit}')"
|
||||
if [ -n "$raw" ]; then
|
||||
unit="$(printf '%s' "$raw" | tr -d '0-9.')"
|
||||
val="$(printf '%s' "$raw" | tr -d 'KMG')"
|
||||
case "$unit" in
|
||||
K) awk -v v="$val" 'BEGIN{printf "%d", v/1024}' ;;
|
||||
M) awk -v v="$val" 'BEGIN{printf "%d", v}' ;;
|
||||
G) awk -v v="$val" 'BEGIN{printf "%d", v*1024}' ;;
|
||||
*) : ;;
|
||||
esac
|
||||
return 0
|
||||
fi
|
||||
fi
|
||||
raw="$(ps -o rss= -p "$pid" 2>/dev/null | tr -d ' ')"
|
||||
if [ -n "$raw" ]; then
|
||||
awk -v v="$raw" 'BEGIN{printf "%d", v/1024}'
|
||||
return 0
|
||||
fi
|
||||
return 1
|
||||
}
|
||||
|
||||
RSS_MB="$(measure_rss_mb "$PID")"
|
||||
[ -n "${RSS_MB:-}" ] || { echo "❌ 取不到内存(vmmap 与 ps 都不可用)"; exit 2; }
|
||||
|
||||
echo " 空载物理内存: ${RSS_MB} MB"
|
||||
|
||||
if [ "$RSS_MB" -le "$BUDGET_MB" ]; then
|
||||
printf '✅ MEM-BUDGET 达标:%d MB <= %d MB\n' "$RSS_MB" "$BUDGET_MB"
|
||||
exit 0
|
||||
fi
|
||||
|
||||
printf '❌ MEM-BUDGET 超标:%d MB > %d MB(差 %d MB)\n' \
|
||||
"$RSS_MB" "$BUDGET_MB" "$((RSS_MB - BUDGET_MB))"
|
||||
echo " 排查顺序:"
|
||||
echo " 1) 是否 pglite 预分配过大(shared_buffers 一类)"
|
||||
echo " 2) 启动时是否把整表读进内存(MEM1 红线)"
|
||||
echo " 3) 是否有无界缓存(MEM2 红线)"
|
||||
exit 1
|
||||
Reference in new issue
Block a user