#!/usr/bin/env bash # # release.sh —— 给「技能 / 业务」消费方打「自包含发布包」 # # 为什么要有它(2026-11-05 定的依赖模型变更): # 消费方(技能仓 `~/.agents/skills/ssw-jnpf-lite-rust`、未来的业务仓 `tdc-rs`) # **不再**直接依赖本 git 仓、不再每次构建都 clone 整个 monorepo 并重新编译 20+ 个 # 本地 crate。改由本脚本每个版本产出一个**自包含包** `dist/sspf-vX.Y.Z.tar.gz`, # 消费方把它解包到 `vendor/`,用 `path` 依赖指进去即可。 # # 包的构成(自包含): # sspf-vX.Y.Z/ # ├── bin/sspf-admin # 🔴 预编译二进制(字面,平台侧已 release 编译) # ├── lib/ # 🔴 预编译产物【完整闭包】:sspf 内部 crate + 全部 # │ # 16 个 registry 依赖 + 全部传递依赖,**逐字节等同于 # │ # 构建产物 deps/ 目录**(.rlib + .rmeta + proc-macro # │ # .dylib + 原生 .a)。ABI 锁 rustc 1.95.0,且已关 # │ # lto/embed-bitcode(rlib 无 LLVM bitcode,本机任意 # │ # 版本 ld 都能直链)。消费方靠 .cargo/config rustflags # │ # 直接吃,零重编(方案 C)。 # ├── crates/ # 平台 crate 源码(dev 回退:想改平台时用 path 依赖吃这层) # ├── src/backend/ # 🔴 内核 lib(ssw-platform)—— sspf 的 path 依赖 # ├── frontend/ # 平台前端源码(不含 node_modules/dist,可选随包) # ├── web/ # 静态通用前端(可选,`--no-web` 剥离;独立资产包另发) # ├── Cargo.toml # 🔴 workspace 根(继承 version/edition 靠它) # ├── Cargo.lock # 🔴 锁定整个闭包,消费方 --offline 才解析得开 # ├── rust-toolchain.toml # 🔴 工具链版本(= 1.95.0,消费方必须同版本才吃得进 rlib) # ├── docs/SSPF-PLATFORM-PACKAGE.md # 消费方式说明 # └── README.md # 本包的自述 # # ⚠️ Rust 库硬约束 + 方案 C 的绕过方式(务必理解): # 带类型的库 crate 没法被「纯预编译 rlib」当**普通 cargo 依赖**吃——Cargo 原生不支持把 # 预编译 rlib 当依赖,且 `use sspf::*` 需要接口元数据。但**方案 C** 绕过它:消费方**不把 # sspf 声明为 cargo 依赖**,而是用 `.cargo/config.toml` 的 # `rustflags = ["--extern","sspf=.../libsspf-hash.rlib","-L","dependency=.../lib"]` # 把预编译 rlib 直接喂给 rustc。前提(硬):消费方编译器版本 == 编译这些 rlib 的版本 # (全仓锁 rustc 1.95.0,包内 rust-toolchain.toml 即此值),否则 ABI 不匹配 → 链接失败。 # 源码树仍随包(crates/ + src/backend)作为 dev 回退:消费方想改平台或版本不对时,改回 # path 依赖即可(多一次编译,但能跑)。 # # 方案 C 的「消费方不用重声明 sspf 的 registry 依赖」根因: # `lib/` 里放的是 sspf 的**完整传递闭包**——sspf 内部 crate 与它的全部 16 个 registry # 依赖、乃至它们的传递依赖,都由**同一次** platform 构建产出,rlib 之间 hash 完全一致。 # 所以消费方只要 `-L dependency=lib`,rustc 就能把 sspf 及其全部依赖一次性解析出来, # 消费方【无需】在 Cargo.toml 里把 aes/chrono/uuid/... 这些 sspf 内部依赖重新声明一遍 # (这正是方案 C 相比「消费方补声明整棵依赖树」更省事、且不依赖脆弱的版本/feature 钉死之处)。 # 消费方只需保留**自己代码直用**的依赖(如 axum/tokio/serde/serde_json),这些它本来就要编。 # # 用法: # bash scripts/release.sh # 以 crates/sspf 的 version 为版本号出包 # bash scripts/release.sh 0.5.1 # 显式指定版本(覆盖 crates/sspf 的 version) # bash scripts/release.sh 0.5.1 --publish # 出包并**推到 Gitea Release**(tag v0.5.1) # bash scripts/release.sh --no-web # 不把静态前端塞进平台包(改用独立资产包) # bash scripts/release.sh --target armv7-unknown-linux-gnueabihf --no-web # # 交叉出包(包名带 target,同版本多平台共存) # # 🔴 **交叉编译出包**:`--target` 时二进制/rlib 从 `target//release` 取; # 链接器与原生引擎由调用方通过 Cargo 约定提供,例如 # CARGO_TARGET_ARMV7_UNKNOWN_LINUX_GNUEABIHF_LINKER=/path/to/zig-armv7-cc # PGLITE_LIB_DIR=/path/to/armv7-engine (含 libpglite.a + pglite-runtime.tar) # 不配 --target 时行为逐字不变(仍出本机包)。本机消费方编译自检在交叉包上跳过 # (rlib 与目标架构绑定,宿主机 rustc 链接不了),改为二进制架构校验。 # # 🔴 **JNPF 通用资产包单独分发**(2026-11-06): # 静态前端 + 示例数据库**只跟 JNPF 版本有关**,跟 sspf 版本 / OS / CPU / rust 工具链 / # 部署环境无关 ⇒ 由 `scripts/pack-jnpf-assets.sh` 单独出 `dist/jnpf-7.0-assets.tar.gz`, # 一份包被所有平台的所有 sspf 版本复用。平台包**默认仍携带** `web/`(向后兼容), # 但内容以资产包为唯一真源;`--no-web` 可完全剥离 ⇒ 平台包只留二进制 + rlib。 # # 产物:dist/sspf-vX.Y.Z-.tar.gz(如 sspf-v0.5.1-x86_64-apple-darwin.tar.gz) # dist/jnpf-7.0-assets.tar.gz(独立资产包,另由 pack-jnpf-assets.sh 产出) # 发布:Gitea Release tag=vX.Y.Z,asset=<同上>;消费方 fetch-platform.sh 按 tag+target 拉取 # # 环境变量(发布用): # GITEA_URL 默认 http://127.0.0.1:13300 # GITEA_REPO 默认 ssw/ssw-platform # GITEA_USER / GITEA_PASS 不给则从 git credential(本机 keychain)取 # set -euo pipefail # 切到仓库根(无论从哪里调用) cd "$(dirname "$0")/.." export REPO_ROOT="$(pwd)" # ── 1. 解析参数 + 决定版本号 ─────────────────────────────────── PUBLISH=0 WITH_WEB=1 TARGET_ARG="" POSITIONAL=() while [[ $# -gt 0 ]]; do case "$1" in --publish) PUBLISH=1; shift ;; --no-web) WITH_WEB=0; shift ;; --target) TARGET_ARG="${2:?--target 需要 triple 参数}"; shift 2 ;; --target=*) TARGET_ARG="${1#--target=}"; shift ;; -h|--help) sed -n '1,82p' "$0"; exit 0 ;; *) POSITIONAL+=("$1"); shift ;; esac done if [[ ${#POSITIONAL[@]} -ge 1 ]]; then VERSION="${POSITIONAL[0]}" else VERSION="$(python3 - <<'PY' import re,os p=os.path.join("crates","sspf","Cargo.toml") t=open(p).read() m=re.search(r'^version\s*=\s*"([^"]+)"', t, re.M) print(m.group(1)) PY )" fi # 🔴 目录/包名带 v 前缀,与 git tag(vX.Y.Z)对齐;crate 自身 version 是无 v 的 X.Y.Z PKG="sspf-v${VERSION}" DIST_DIR="dist" # 🔴 目录名**先不带 target**:后面判定是否交叉编译后再决定是否加后缀 # (交叉包与本机包必须各占一个目录,否则同版本轮流出包会互相顶掉)。 export PKG_DIR="${DIST_DIR}/${PKG}" # 🔴 目标平台(rlib 与 平台/架构 绑定,同一版本不同平台必须是不同的包) HOST_TARGET="$(rustc -vV 2>/dev/null | sed -n 's/^host: //p')" HOST_TARGET="${HOST_TARGET:-unknown}" if [[ -n "${TARGET_ARG}" ]]; then TARGET="${TARGET_ARG}" CROSS=1 TARGET_FLAG="--target ${TARGET}" BUILD_DIR="target/${TARGET}" # 🔴 交叉出包的三项必需环境变量(详见 docs/armv7-build.md): # 1. LINKER —— zig cc 包装器(改写 -Wl,/abs/path → 裸路径;注入 armhf sysroot) # 2. ZIG_SYSROOT —— armhf 交叉 libc + zlib(zig 自带 libc 但不带 zlib) # 3. CARGO_PROFILE_RELEASE_STRIP=none # 仓库默认的 strip="symbols" 会让 rustc 重建 native 静态库时破坏全局符号 # (ProcessStartupPacket / pgl_shmem_reset …)⇒ 链接期 undefined symbol。 export CARGO_TARGET_ARMV7_UNKNOWN_LINUX_GNUEABIHF_LINKER="${CARGO_TARGET_ARMV7_UNKNOWN_LINUX_GNUEABIHF_LINKER:-$(cd "$(dirname "$0")" && pwd)/zig-cc-armv7.sh}" # 🔴 zlib-only sysroot(上游完整 sysroot 的 libc 是 glibc 2.36 ⇒ 产物又绑 GLIBC_2.34+) export ZIG_SYSROOT="${ZIG_SYSROOT:-$(cd "$(dirname "$0")/.." && pwd)/../ssw-tds-test/build/sysroot-armhf}" export CARGO_PROFILE_RELEASE_STRIP="${CARGO_PROFILE_RELEASE_STRIP:-none}" # PGLITE_LIB_DIR 指向自建引擎(上游没有 armv7 预编译包) # 🔴 默认必须是 **glibc26** 那份(GLIBC 2.18 兼容);旧的 pglite-engine-armv7 # 是 Debian GCC 编译的,pqcomm.o/noblock_srv.o 引用真实 fcntl64 ⇒ 链接失败。 export PGLITE_LIB_DIR="${PGLITE_LIB_DIR:-$(cd "$(dirname "$0")/.." && pwd)/dist/pglite-engine-armv7-glibc26}" # 🔴 compat shim 链接期注入目录(explicit_bzero / getrandom,glibc 2.25 才有) export ZIG_COMPAT_DIR="${ZIG_COMPAT_DIR:-${PGLITE_LIB_DIR}/compat}" # 🔴🔴🔴 **交叉出包必须绕过 sccache**(2026-11-13 实测定位,本脚本最大的坑): # # rustc 会把 `-L native=<引擎目录>` 里的 `libpglite.a` **bundle 进 # libpglite_sys.rlib**(rlib 里有个 `libpglite.a` 成员,ELF 包裹的 ar 归档)。 # 而 **rustc 的编译指纹不包含 native 静态库的内容哈希** ⇒ # 换引擎(PGLITE_LIB_DIR 改了)后,rustc 认为「没什么变了」⇒ **sccache 直接 # 命中旧缓存**,返回**内嵌旧引擎**的 rlib。 # # 后果极具迷惑性: # · 引擎目录里的 libpglite.a 是**新的**(手工 `zig cc --whole-archive` 直接链没问题) # · build script 的 output 也指向新引擎(`cargo:rustc-link-search=native=<新>`) # · 但链接器拿到的 bundle 归档里 `pqcomm.o`/`noblock_srv.o` 是**旧引擎**的 # (Debian GCC 编译,引用真实 `fcntl64`)⇒ `ld.lld: undefined symbol: fcntl64` # · `cargo clean -p pglite-rs-sys` **清不掉** sccache 缓存 ⇒ 怎么 clean 都一样 # # ⇒ 交叉构建一律 `RUSTC_WRAPPER=""`(绕开 sccache)。 # 代价是这轮没有缓存加速(armv7 全量约 2 分钟),但换来确定性。 export RUSTC_WRAPPER="${RUSTC_WRAPPER-}" # 🔴 交叉包的**解包目录带 target 后缀**:与本机包并存,互不覆盖。 export PKG_DIR="${DIST_DIR}/${PKG}-${TARGET}" else TARGET="${HOST_TARGET}" CROSS=0 TARGET_FLAG="" BUILD_DIR="target" fi # 本仓 git URL(README 里的「极端回退」写法用;去掉 .git 后缀) GIT_URL="$(git remote get-url origin 2>/dev/null | sed 's/\.git$//')" GIT_URL="${GIT_URL:-http://127.0.0.1:13300/ssw/ssw-platform}" echo "==> 出包版本: ${VERSION}" echo "==> 目标目录: ${PKG_DIR}" echo "==> 目标平台: ${TARGET} $([[ "${CROSS}" == "1" ]] && echo '(交叉编译)' || echo '(本机)')" # ── 1.5 清理「指向其它引擎」的 build script 实例与 rlib(2026-11-13 定位)── # # 🔴🔴🔴 这是本脚本最容易踩、也最难查的坑,成因链条: # # 1. `pglite-rs-sys` 的 build.rs 靠环境变量 `PGLITE_LIB_DIR` 决定链哪份引擎, # 并输出 `cargo:rustc-link-search=native=<引擎目录>`。 # 2. **改 `PGLITE_LIB_DIR` 会改变 build script 的 fingerprint** ⇒ cargo 认为 # 这是**另一个 build script 实例** ⇒ 生成**新的 hash 目录**, # **但旧实例的产物不会自动删除**。 # 3. `deps/` 里于是同时躺着两个 `libpglite_sys-.rlib`: # 一个内嵌新引擎(clang/zig 编译,引用宏重定向过的 `pgl_fcntl`), # 一个内嵌旧引擎(Debian GCC 编译,引用真实 `fcntl64`)。 # 4. 链接器**挑中了旧的那个** ⇒ `ld.lld: undefined symbol: fcntl64`。 # # ⚠️ 症状极具迷惑性:库本身是好的(手工 `zig cc --whole-archive` 直接链没问题), # 只有经 rustc/cargo 链才炸 ⇒ 一度误判为「rustc 重打包归档不确定」。 # # ⇒ 对策:**构建前把指向其它引擎目录的 build script 实例连同其 rlib 一起清掉**, # 让 deps/ 里只剩唯一一份、且是本次引擎的。 purge_stale_engine_artifacts() { local td="$1" want="$2" label="$3" [[ -d "${td}" ]] || return 0 # ① build script 实例:output 里写的 lib_dir 与期望不一致 ⇒ 删 local outdir for outdir in $(find "${td}" -type f -path '*/build/pglite-rs-sys-*/output' 2>/dev/null); do if ! grep -q "lib_dir=${want}$" "${outdir}" 2>/dev/null; then local d d="$(dirname "${outdir}")" rm -rf "${d}" 2>/dev/null || true echo " 🔴 删旧 build script 实例: ${d#$td/}" fi done # ② 对应的 rlib/rmeta:build script 实例 hash 变了,rlib hash 也会变 # ⇒ 旧 hash 的 libpglite_sys*.rlib / .rmeta 一并删(否则链接器可能挑中旧的) local f for f in $(find "${td}" -type f \( -name 'libpglite_sys-*.rlib' -o -name 'libpglite_sys-*.rmeta' \) 2>/dev/null); do if [[ -n "${want}" ]] && [[ ! -f "${f}" ]]; then continue; fi # 只在「有旧 build script 实例被删」时才清 rlib,避免误删本次的 rm -f "${f}" 2>/dev/null || true echo " 🔴 删旧 rlib: ${f#$td/}" done return 0 } if [[ "${CROSS}" == "1" ]]; then echo "==> [1.5] 清理指向其它引擎的构建产物(主 target + 隔离目录)" purge_stale_engine_artifacts "${REPO_ROOT}/target" "${PGLITE_LIB_DIR}" "main" fi # ── 2. 编译预编译二进制 sspf-admin(平台侧 release 构建)────────── echo "==> cargo build --release ${TARGET_FLAG} -p sspf-admin" # 🔴 TARGET_FLAG 故意不加引号:空值时不传参;交叉时展开成 `--target ` # (bash 3.2 的 set -u 下空数组展开会报 unbound,故用字符串而非数组)。 cargo build --release ${TARGET_FLAG} -p sspf-admin BIN="${BUILD_DIR}/release/sspf-admin" if [[ ! -x "${BIN}" ]]; then echo "!! 找不到预编译二进制: ${BIN}" >&2 exit 1 fi # ── 2.5 编译 sspf 闭包的 rlib(方案 C:预编译库,消费方零重编)── # 用 release profile(无 debuginfo,体积小;sspf-admin 已编过 release,基本零成本)。 # rlib 的 ABI 取决于编译器版本,全仓锁 rustc 1.95.0(见 rust-toolchain.toml), # 消费方必须同版本才能链接;dev/release 消费方都可链接这些 release rlib(ABI 兼容)。 # # 🔴 必须用**隔离 target 目录**构建:否则 sspf-admin(步骤 2)与 sspf 默认 feature 集会产出 # 多套不同 hash 的 rlib,混在一起后 sspf 内部引用的 dep hash 在 lib/ 里对不上 → 消费方 E0463。 # 隔离目录保证每个 crate 唯一 hash、闭包内部引用完全一致。 # # 🔴🔴 关键:关掉 lto / embed-bitcode!平台 [profile.release] 默认开了 `lto = "thin"`, # 这会让 rlib 内嵌 LLVM22 的 bitcode;消费方链接时本机 ld(libLTO 21)解析不了 → # `could not parse bitcode object file` 链接失败。预编译分发的 rlib 必须只含原生目标码 # (embed-bitcode=false + lto=false),任何 LLVM 版本的链接器都能直链。实测已验证。 # 🔴 交叉包用独立隔离目录:否则 `cargo clean` 会把本机架构的 rlib 缓存一起清掉, # 同一版号多平台轮流出包时每次都要重编。 if [[ "${CROSS}" == "1" ]]; then export RLIB_TARGET="target/rlibbuild-${TARGET}" export RLIB_DEPS="${RLIB_TARGET}/${TARGET}/release/deps" # 🔴🔴🔴 **proc-macro crate 必须单独收集**(2026-11-13 实测定位): # proc-macro(serde_derive / tokio_macros / futures_macro / thiserror_impl) # 是**编译期在宿主上执行**的 ⇒ cargo 交叉时把它们编成**宿主架构** # (macOS x86_64 的 .dylib),产物落在 `/release/deps/`(**无 triple 层**), # 而不是 `//release/deps/`。 # ⇒ 只拷 RLIB_DEPS(triple 层)会**漏掉全部 proc-macro dylib** # ⇒ 消费方拿不到 derive 宏 ⇒ `E0463 can't find crate for serde/axum` + # `cannot find attribute 'serde' in this scope`。 # ⇒ 这两个目录必须**一起**进 lib/。 export RLIB_HOST_DEPS="${RLIB_TARGET}/release/deps" else export RLIB_TARGET="target/rlibbuild" export RLIB_DEPS="${RLIB_TARGET}/release/deps" export RLIB_HOST_DEPS="" fi echo "==> cargo build --release ${TARGET_FLAG} -p sspf (隔离目录 ${RLIB_TARGET} 采集预编译 rlib 闭包)" # 🔴🔴 构建前必须**清空隔离目录**!cargo 不会删除上一个 profile/feature 产生的旧 hash rlib, # 它们会残留在 deps/ 里;step 3.2.5 全量拷贝后 lib/ 会同时存在多个 hash 的 sspf/dep rlib, # 消费方 `--extern sspf=$(ls libsspf-*.rlib|head -1)` 可能选到**旧 hash 那个**(含 bitcode/旧 feature) # → 链接报 `could not parse bitcode` 或解析到错误版本。cargo clean 是唯一可靠的清理方式 # (它的删除在 cargo 内部完成,不触发 shell 的 safe-delete 批量删除钩子)。 echo "==> 清理隔离目录 ${RLIB_TARGET}(保证闭包单一 hash、无上一轮残留)" cargo clean --target-dir "${RLIB_TARGET}" 2>/dev/null || true # 🔴 隔离目录同样会残留「指向旧引擎」的 build script 实例 ⇒ 闭包内嵌旧引擎 # ⇒ 消费方链接炸 fcntl64(详见 [1.5] 段的成因链条)。 purge_stale_engine_artifacts "${REPO_ROOT}/${RLIB_TARGET}" "${PGLITE_LIB_DIR}" "rlibbuild" echo " 🔴 已清指向其它引擎的 build script 实例(避免闭包内嵌旧引擎)" echo " 🔴 关 lto/embed-bitcode:避免 rlib 内嵌 LLVM22 bitcode,消费方 ld(libLTO21) 链接失败" CARGO_TARGET_DIR="${RLIB_TARGET}" cargo build --release ${TARGET_FLAG} -p sspf \ --config 'profile.release.lto=false' \ --config 'profile.release.embed-bitcode=false' # 🔴 交叉编译时 cargo 会把产物放进 `//release/deps`(本机构建则无 triple 层), # RLIB_DEPS 已在上面按 CROSS 分支算好并导出给 python 收集器。 # ── 3. 组装目录 ──────────────────────────────────────────────── # 🔴 不直接删旧目录:dist 是构建产物,用「移到 /tmp」代替 `rm -rf`, # 既清场又避免触发 safe-delete 批量删除确认钩子(>50 文件的整目录删除会被拦)。 python3 - <<'PY' import os, shutil, time d=os.environ["PKG_DIR"] if os.path.isdir(d): dest="/tmp/old_"+os.path.basename(d)+"_"+str(int(time.time())) try: shutil.move(d, dest) print(f"==> 旧目录已移走: {dest}") except Exception: shutil.rmtree(d, ignore_errors=True) PY mkdir -p "${PKG_DIR}/bin" "${PKG_DIR}/crates" "${PKG_DIR}/src" "${PKG_DIR}/lib" "${PKG_DIR}/docs" "${PKG_DIR}/frontend" # 3.1 预编译二进制 cp "${BIN}" "${PKG_DIR}/bin/sspf-admin" BIN_SIZE="$(du -h "${PKG_DIR}/bin/sspf-admin" | cut -f1)" echo "==> bin/sspf-admin (${BIN_SIZE})" # 3.1.5 静态通用前端(JNPF 7.0 官方 web 前端产物)—— **可选随包**。 # # 🔴 真源已改为「JNPF 通用资产包」`dist/jnpf-7.0-assets/`(由 pack-jnpf-assets.sh 产出): # 静态前端 + 示例数据库只跟 JNPF 版本有关 ⇒ 独立出 `dist/jnpf-7.0-assets.tar.gz`, # 所有 sspf 版本 / 所有目标平台复用同一份,不必随每个平台包重复分发。 # 平台包默认仍拷一份 `web/`(向后兼容「跟版本包一起分发」),`--no-web` 可剥离。 # # ⇒ 消费方二选一: # ① 平台包自带:`SSW_STATIC_DIR=./web ./bin/sspf-admin` # ② 独立资产包:`SSW_ASSETS_DIR=./jnpf-7.0-assets ./bin/sspf-admin`(连示例数据库一起外置) WEB_N=0 WEB_SIZE="-" WEB_SRC="(未随包)" if [[ "${WITH_WEB}" == "1" ]]; then ASSETS_WEB="${REPO_ROOT}/dist/jnpf-7.0-assets/web" WEB_DIR="${REPO_ROOT}/dist/web" if [[ -f "${REPO_ROOT}/dist/jnpf-7.0-assets/manifest.json" && -f "${ASSETS_WEB}/index.html" ]]; then WEB_DIR="${ASSETS_WEB}" WEB_SRC="JNPF 通用资产包" else WEB_SRC="dist/web(旧产物,建议先跑 pack-jnpf-assets.sh)" fi if [[ -f "${WEB_DIR}/index.html" ]]; then mkdir -p "${PKG_DIR}/web" rsync -a --exclude '.DS_Store' "${WEB_DIR}/" "${PKG_DIR}/web/" WEB_N="$(find "${PKG_DIR}/web" -type f | wc -l | tr -d ' ')" WEB_SIZE="$(du -sh "${PKG_DIR}/web" | cut -f1)" echo "==> web/(静态通用前端,${WEB_N} 个文件 / ${WEB_SIZE};来源:${WEB_SRC})" else echo "!! 找不到静态前端产物 —— 跳过 web/(不阻塞出包)" >&2 echo " 先跑: bash scripts/pack-jnpf-assets.sh (构建并打包 JNPF 通用资产)" >&2 fi else echo "==> --no-web:平台包不含静态前端;改用独立资产包 dist/jnpf-7.0-assets.tar.gz" fi # 3.2 计算 sspf 的 path 依赖闭包(纯文件系统 BFS,离线安全;不含 sspf-admin 自身源码) # 输出每行:源目录包内相对目标 CLOSURE="$(python3 - <<'PY' import os, re root=os.getcwd() start=os.path.join(root,"crates","sspf") seen=set() def resolve(cdir): ct=os.path.join(cdir,"Cargo.toml") if not os.path.isfile(ct): return seen.add(os.path.normpath(cdir)) txt=open(ct).read() for m in re.finditer(r'path\s*=\s*"([^"]+)"', txt): nd=os.path.normpath(os.path.join(cdir, m.group(1))) if os.path.isdir(nd) and nd not in seen: resolve(nd) resolve(start) for d in sorted(seen): rel=os.path.relpath(d, root) if rel=="src/backend": print(f"{rel}\tsrc/backend") else: print(f"{rel}\t{rel}") # crates/xxx -> crates/xxx PY )" RSYNC_EXCLUDES=( --exclude target --exclude .git --exclude __pycache__ --exclude '*.pyc' --exclude node_modules --exclude .vite --exclude dist ) CRATE_N=0 while IFS=$'\t' read -r src dst; do [[ -z "${src}" ]] && continue rsync -a "${RSYNC_EXCLUDES[@]}" "${src}/" "${PKG_DIR}/${dst}/" if [[ "${dst}" == crates/* ]]; then CRATE_N=$((CRATE_N+1)); fi done <<< "${CLOSURE}" echo "==> 复制 ${CRATE_N} 个 crate + src/backend(闭包)" # 3.2.5 收集 sspf 闭包的【完整】预编译产物到 lib/(方案 C 关键) # 🔴🔴 必须把隔离构建目录 ${RLIB_DEPS} 里的**全部文件**原样拷进 lib/,不能只拷 # `lib*.rlib`!deps/ 里除了 .rlib,还有: # · .rmeta —— 各 crate 的类型元数据(rustc 解析依赖时必须) # · *.dylib (mac)/.so —— proc-macro crate(serde_derive/tokio_macros/...)的 # 动态库,sspf 编译期展开宏必须靠它们;缺了就报 # E0463 "can't find crate for sspf" # · *.a —— pglite 等原生静态库(链接期 -l 需要) # 只 glob lib*.rlib 会漏掉 .dylib/.rmeta → 消费方解析失败。完整拷贝后 lib/ 与 # 原生 deps/ 逐字节等价,已实测:`-L dependency=lib` 能正常解析 sspf 全闭包。 # 这些产物由同一次 platform 构建产出,rlib 彼此 hash 完全一致,且已关掉 # embed-bitcode(见 step 2.5),本机任意 LLVM 版本的 ld 都能直链。 export PKG_LIB="${PKG_DIR}/lib" python3 - <<'PY' import os, shutil deps=os.environ["RLIB_DEPS"] host_deps=os.environ.get("RLIB_HOST_DEPS","") pkg_lib=os.environ["PKG_LIB"] os.makedirs(pkg_lib, exist_ok=True) n=0 for name in sorted(os.listdir(deps)): src=os.path.join(deps, name) if os.path.isfile(src): shutil.copy2(src, os.path.join(pkg_lib, name)); n+=1 # 🔴🔴🔴 交叉包还要补 **宿主 proc-macro dylib**(2026-11-13 实测定位): # proc-macro crate 编译期在**宿主**执行 ⇒ 交叉时产物是宿主架构的 .dylib, # 落在 `/release/deps/`(无 triple 层),不在 RLIB_DEPS 里。 # 漏掉它们 ⇒ 消费方 E0463 "can't find crate for serde/axum"(derive 宏找不到)。 # 只收 .dylib/.so(宿主专属),不收宿主 rlib(那是 host 版代码,与 target 无关)。 host_n=0 if host_deps and os.path.isdir(host_deps): for name in sorted(os.listdir(host_deps)): if not (name.endswith(".dylib") or name.endswith(".so")): continue src=os.path.join(host_deps, name) dst=os.path.join(pkg_lib, name) if os.path.isfile(src) and not os.path.exists(dst): shutil.copy2(src, dst); host_n+=1 print(f"==> 收集 {n} 个预编译产物到 lib/(完整闭包:rlib+rmeta+proc-macro .dylib+原生 .a;无 bitcode,可直链)") if host_n: print(f"==> 额外收集 {host_n} 个**宿主 proc-macro dylib**(交叉编译必需,编译期在宿主执行)") PY # 注:隔离 target/${RLIB_TARGET} 留作构建缓存,下次出包复用(不删,避免触发删除钩子 / 重编)。 LIB_N="$(ls -1 "${PKG_LIB}" | wc -l | tr -d ' ')" # 3.3 workspace 根 + lock + toolchain(消费方 --offline 解析继承字段靠它们) cp Cargo.toml Cargo.lock rust-toolchain.toml "${PKG_DIR}/" echo "==> Cargo.toml / Cargo.lock / rust-toolchain.toml" # 3.4 消费方式说明 cp docs/SSPF-PLATFORM-PACKAGE.md "${PKG_DIR}/docs/" # 3.5 平台前端源码(不含 node_modules/dist,可选随包;C 用户明确「前端可以留着」) if [[ -d src/frontend ]]; then rsync -a "${RSYNC_EXCLUDES[@]}" src/frontend/ "${PKG_DIR}/frontend/" echo "==> frontend/(源码,已排除 node_modules/dist)" fi # 3.6 生成包内 README cat > "${PKG_DIR}/README.md" </src/backend/data/lite.pg\`) - 🔴 **示例数据默认导入**(对齐官方「用示例数据初始化」)⇒ 空库启动即有官方演示数据; 想要纯净库设 \`SSW_DEMO_DATA=false\` - 🔴 **外置优先**:\`SSW_DEMO_SEED_FILE=\` / \`SSW_ASSETS_DIR=<资产包>\` 可换任意 JNPF 版本的示例数据,**不需要重编二进制**;都没配 ⇒ 用编译期内嵌那份 ## 消费方怎么用(方案 C:预编译 rlib,零重编平台) > ⚠️ 前提:① 消费方 rustc 版本 == 包内 \`rust-toolchain.toml\` 的版本($(grep -m1 '^channel' rust-toolchain.toml | sed 's/.*= *"//;s/"//')),不符则链接失败; > ② 本包是 **${TARGET}** 平台产物(rlib 与目标平台/架构绑定),其他平台需取对应平台的包。 1. 把本包解包到消费方仓库的 \`vendor/sspf-v${VERSION}/\`。 **只需 \`lib/\` + \`rust-toolchain.toml\`**;平台源码 \`crates/\`、\`src/\` 仅 dev 回退用,可不解包。 2. **复制工具链锁**:\`cp vendor/sspf-v${VERSION}/rust-toolchain.toml ./rust-toolchain.toml\`(消费方根)。 3. **生成 \`.cargo/config.toml\`**(含本机绝对路径,**勿提交**)—— 必须把 **sspf 与 sspf 公共 API 涉及的外部 crate 一起** 喂进去: \`\`\`toml [build] rustflags = [ "--extern", "sspf=vendor/sspf-v${VERSION}/lib/libsspf-.rlib", "--extern", "axum=vendor/sspf-v${VERSION}/lib/libaxum-.rlib", "--extern", "tokio=vendor/sspf-v${VERSION}/lib/libtokio-.rlib", "--extern", "serde=vendor/sspf-v${VERSION}/lib/libserde-.rlib", "--extern", "serde_json=vendor/sspf-v${VERSION}/lib/libserde_json-.rlib", "--extern", "http=vendor/sspf-v${VERSION}/lib/libhttp-.rlib", "--extern", "bytes=vendor/sspf-v${VERSION}/lib/libbytes-.rlib", "-L", "dependency=vendor/sspf-v${VERSION}/lib", ] \`\`\` (\`\` 每版本会变;技能仓 \`fetch-platform.sh\` 会自动生成,无需手写。) 4. 消费方 \`Cargo.toml\` **不要声明** \`sspf\` / \`axum\` / \`tokio\` / \`serde\` / \`serde_json\` —— 它们全部来自 \`lib/\`。 **若自己再编一份 axum,就是「同名 crate 两个实例」(同 version、不同 hash),跨 sspf API 边界传参必报 \`E0308 mismatched types\`(multiple different versions of crate 'axum')**。sspf 的全部 16 个 registry 依赖 + 传递依赖都已在 \`lib/\` 预编译好,无需声明、无需重编。 5. **release profile 必须 \`lto = false\`**:预编译 rlib 是 bitcode-free 的,开 LTO 会 \`failed to get bitcode from object file for LTO\`。平台 rlib 已 opt-level=2,损失很小。 6. \`cargo build\` —— 平台闭包与 axum/tokio 全部**不编译**,直接链接 \`lib/\` 预编译 rlib。 ### 极端回退(要改平台源码):改用 git 依赖 在 \`Cargo.toml\` 写 \`sspf = { git = "${GIT_URL}", tag = "v${VERSION}" }\`,把 axum/tokio 等改回 registry 依赖, 删掉 \`.cargo/config.toml\` 即可(多一次编译,但能改平台源码)。详见平台仓 \`docs/SSPF-PLATFORM-PACKAGE.md\` §6。 ## 工具链 全仓锁 \`rustc $(grep -m1 '^channel' rust-toolchain.toml | sed 's/.*= *"//;s/"//')\`(L3 dylib 的 ABI 前提)。 消费方必须自带同名 \`rust-toolchain.toml\`,平台侧无法代劳。 EOF echo "==> README.md" # ── 4. 打 tar.gz ─────────────────────────────────────────────── TAR="${DIST_DIR}/${PKG}-${TARGET}.tar.gz" # 🔴 tar 内层目录名与 PKG_DIR 保持一致(交叉包 = sspf-vX.Y.Z-) tar -czf "${TAR}" -C "${DIST_DIR}" "$(basename "${PKG_DIR}")" TAR_SIZE="$(du -h "${TAR}" | cut -f1)" echo "==> 已打包: ${TAR} (${TAR_SIZE}) [target=${TARGET}]" # ── 4.5 发布辅助(--publish):推到 Gitea Release ─────────────── # 幂等:release 已存在则复用;同名 asset 已存在则先删后传。 publish_to_gitea() { local base="${GITEA_URL:-http://127.0.0.1:13300}" local repo="${GITEA_REPO:-ssw/ssw-platform}" local tag="v${VERSION}" local asset_name; asset_name="$(basename "${TAR}")" local user="${GITEA_USER:-}" pass="${GITEA_PASS:-}" if [[ -z "${user}" || -z "${pass}" ]]; then local cred cred="$(printf 'protocol=http\nhost=%s\n\n' "${base#http://}" | GIT_TERMINAL_PROMPT=0 git credential fill 2>/dev/null || true)" user="$(printf '%s\n' "${cred}" | sed -n 's/^username=//p')" pass="$(printf '%s\n' "${cred}" | sed -n 's/^password=//p')" fi if [[ -z "${user}" || -z "${pass}" ]]; then echo "!! 发布失败:无 Gitea 凭据(设 GITEA_USER/GITEA_PASS,或配置 git credential)" >&2 return 1 fi local -a AUTH=(-u "${user}:${pass}") # 1) release:有则复用,无则创建(tag 已存在时 Gitea 直接挂到该 tag) local code rel_id code="$(curl -s -o /tmp/sspf_rel.json -w '%{http_code}' --noproxy '*' -m 20 "${AUTH[@]}" \ "${base}/api/v1/repos/${repo}/releases/tags/${tag}" || true)" if [[ "${code}" == "200" ]]; then rel_id="$(python3 -c 'import json;print(json.load(open("/tmp/sspf_rel.json"))["id"])')" echo "==> 复用已有 release ${tag} (id=${rel_id})" else code="$(curl -s -o /tmp/sspf_rel.json -w '%{http_code}' --noproxy '*' -m 30 "${AUTH[@]}" \ -X POST "${base}/api/v1/repos/${repo}/releases" \ -H 'Content-Type: application/json' \ -d "{\"tag_name\":\"${tag}\",\"name\":\"sspf ${tag}\",\"target_commitish\":\"main\",\"body\":\"sspf 平台包 ${tag}(${TARGET};方案 C 预编译 rlib 闭包)\"}" || true)" if [[ "${code}" != "201" ]]; then echo "!! 创建 release ${tag} 失败 (HTTP ${code}): $(head -c 300 /tmp/sspf_rel.json)" >&2 return 1 fi rel_id="$(python3 -c 'import json;print(json.load(open("/tmp/sspf_rel.json"))["id"])')" echo "==> 已创建 release ${tag} (id=${rel_id})" fi # 2) 同名 asset 先删(幂等重传) local old_id old_id="$(curl -s --noproxy '*' -m 20 "${AUTH[@]}" \ "${base}/api/v1/repos/${repo}/releases/${rel_id}/assets" \ | python3 -c " import json,sys try: d=json.load(sys.stdin) except Exception: d=[] for a in d: if a.get('name')=='${asset_name}': print(a['id']); break " 2>/dev/null || true)" if [[ -n "${old_id}" ]]; then curl -s -o /dev/null --noproxy '*' -m 30 "${AUTH[@]}" \ -X DELETE "${base}/api/v1/repos/${repo}/releases/${rel_id}/assets/${old_id}" || true echo "==> 已删除同名旧 asset (id=${old_id})" fi # 3) 上传(Gitea multipart 字段名 attachment) code="$(curl -s -o /tmp/sspf_asset.json -w '%{http_code}' --noproxy '*' -m 900 "${AUTH[@]}" \ -X POST "${base}/api/v1/repos/${repo}/releases/${rel_id}/assets?name=${asset_name}" \ -F "attachment=@${TAR}" || true)" if [[ "${code}" != "201" ]]; then echo "!! 上传 asset 失败 (HTTP ${code}): $(head -c 300 /tmp/sspf_asset.json)" >&2 return 1 fi local dl dl="$(python3 -c 'import json;print(json.load(open("/tmp/sspf_asset.json")).get("browser_download_url",""))')" echo "==> ✅ 已发布 ${tag} / ${asset_name} ($(du -h "${TAR}" | cut -f1))" echo " ${dl}" return 0 } # ── 5. 自检 ────────────────────────────────────────────────── # 🔴 交叉包:宿主机 rustc 链接不了目标架构 rlib ⇒ 跳过两项「消费方编译」自检, # 改为二进制架构校验(真实可运行性另由目标架构容器冒烟验证)。 if [[ "${CROSS}" == "1" ]]; then echo "==> 交叉包自检:校验 bin/sspf-admin 目标架构(跳过宿主机消费方编译)" FILE_OUT="$(file "${PKG_DIR}/bin/sspf-admin")" echo " ${FILE_OUT}" case "${TARGET}" in armv7*|arm-*) grep -qiE 'ARM|EABI' <<< "${FILE_OUT}" || { echo "!! ❌ 产物不是 ARM 架构" >&2; exit 1; } ;; aarch64*) grep -qiE 'ARM64|aarch64|ARM aarch64' <<< "${FILE_OUT}" || { echo "!! ❌ 产物不是 ARM64 架构" >&2; exit 1; } ;; x86_64*) grep -qiE 'x86-64|x86_64' <<< "${FILE_OUT}" || { echo "!! ❌ 产物不是 x86_64 架构" >&2; exit 1; } ;; esac echo "==> ✅ 自检通过:${TARGET} 二进制架构正确(lib/ 为目标架构 rlib,消费方需在同架构机器使用)" else echo "==> 自检验证中(构造最小消费方,--offline 编译)" TMPCON="$(mktemp -d)" cat > "${TMPCON}/Cargo.toml" < "${TMPCON}/src/main.rs" <<'EOF' use sspf::Platform; fn main() { println!("sspf VERSION = {}", sspf::VERSION); let _ = Platform::new(); println!("OK: path-dep closure resolves & compiles"); } EOF if (cd "${TMPCON}" && cargo build --offline 2>&1 | tail -3); then echo "==> ✅ 自检通过:${PKG} 可被最小消费方 --offline 编译" else echo "!! ❌ 自检失败:包内闭包无法离线编译,请检查 Cargo.lock / workspace 根" >&2 # 保留临时目录便于排查(避开 safe-delete 批量删除钩子) echo " 临时目录: ${TMPCON}" exit 1 fi # 保留临时目录(mktemp 由系统回收;rm -rf 大目录会触发 safe-delete 钩子) # ── 5b. 自检 B:预编译 rlib 能否被消费方零编译链接(方案 C)────── echo "==> 自检 B:构造只声明自身直依赖、用 rustflags 喂预编译 rlib 的最小消费方" TMPCON2="$(mktemp -d)" mkdir -p "${TMPCON2}/.cargo" "${TMPCON2}/src" # 只声明消费方自身代码会直用的 sspf 闭包依赖(axum/tokio/serde/serde_json)。 # sspf 与其余 12 个 registry 依赖 + 全部传递依赖都来自包内 lib/ 预编译 rlib, # 消费方【不】声明、也【不】重编它们 —— 这正是方案 C「零重编平台闭包」的体现。 cat > "${TMPCON2}/Cargo.toml" < "${TMPCON2}/.cargo/config.toml" < "${TMPCON2}/src/main.rs" <<'EOF' use sspf::Platform; fn main() { println!("sspf VERSION = {}", sspf::VERSION); let _ = Platform::new(); println!("OK: prebuilt rlib links without recompiling platform closure"); } EOF if (cd "${TMPCON2}" && cargo build 2>&1 | tee /tmp/rlib_check.log | tail -4); then if grep -qE "Compiling sspf|Compiling ssw-platform|Compiling sspf-" /tmp/rlib_check.log; then echo "!! ❌ 自检 B 失败:消费方仍在编译平台 crate(见上方 Compiling 行)" >&2 echo " 临时目录: ${TMPCON2}" exit 1 fi echo "==> ✅ 自检 B 通过:消费方零编译平台闭包,直接链接预编译 rlib" else echo "!! ❌ 自检 B 失败:预编译 rlib 无法链接" >&2 echo " 临时目录: ${TMPCON2}" exit 1 fi # 保留临时目录(mktemp 由系统回收;rm -rf 大目录会触发 safe-delete 钩子) fi # CROSS=0:本机消费方编译自检 # ── 6. 发布(--publish)─────────────────────────────────────── if [[ "${PUBLISH}" == "1" ]]; then echo "==> 发布到 Gitea Release ..." publish_to_gitea || { echo "!! 发布失败(本地包仍在 ${TAR})" >&2; exit 1; } else echo "==> 未发布(加 --publish 推到 Gitea Release;或手动上传 ${TAR})" fi echo "" echo "==================================================" echo "✅ 出包完成: ${PKG}" echo " 目录: ${PKG_DIR}" echo " 目标平台: ${TARGET} $([[ "${CROSS}" == "1" ]] && echo '(交叉编译)' || echo '(本机)')" echo " 压缩包: ${TAR} (${TAR_SIZE})" echo " 预编译二进制: bin/sspf-admin (${BIN_SIZE})" echo " 静态通用前端: web/ (${WEB_N} 个文件 / ${WEB_SIZE}; ${WEB_SRC}) ← SSW_STATIC_DIR=./web" echo " JNPF 通用资产包: dist/jnpf-7.0-assets.tar.gz(独立分发,只绑定 JNPF 版本;所有平台/版本复用)" echo " 预编译 rlib: lib/ (${LIB_N} 个,完整闭包,ABI 锁 rustc $(grep -m1 '^channel' rust-toolchain.toml | sed 's/.*= *"//;s/"//'))" echo " crate 闭包: ${CRATE_N} 个 + src/backend(源码随包,dev 回退用)" echo "=================================================="