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:
admin committed 2026-10-31 10:10:34 +08:00
1 parent a25bd5ef96
commit b11ec26106
43 files changed
+4264 -1801

No files matched your search

+277
View File
@@ -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
+3 -1
View File
@@ -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:
+1 -1
View File
@@ -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」
+208
View File
@@ -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
+127
View File
@@ -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