#!/usr/bin/env bash # # fetch-platform.sh —— 把平台「自包含发布包」解包到 vendor/,让本仓以【方案 C】消费 sspf # # 背景(2026-11-05 依赖模型变更):平台仓每个版本产出一个自包含包 # `dist/sspf-vX.Y.Z.tar.gz`(预编译 sspf-admin 二进制 + 预编译 rlib 闭包 lib/ + 平台 crate # 源码 + Cargo.lock + rust-toolchain.toml)。本仓**不再直接依赖 git 仓**。 # # 方案 C(默认,零重编平台):消费方【不】把 sspf 声明为 cargo 依赖,而是用 # .cargo/config.toml 的 rustflags = ["--extern sspf=.../libsspf-hash.rlib", "-L dependency=.../lib"] # 把平台预编译 rlib 直接喂给 rustc。前提:消费方 rustc 版本 == 包内 rust-toolchain.toml # (ABI 锁 rustc 1.95.0),否则链接失败。本脚本会自动把包的 rust-toolchain.toml 复制到本仓根。 # # dev 回退(path 依赖,多一次编译但能改平台):删掉 .cargo/config.toml,并在 Cargo.toml 写 # sspf = { path = "vendor/sspf-vX.Y.Z/crates/sspf", version = "0.5" } # # 用法: # bash scripts/fetch-platform.sh 0.5.0 # 解包 sspf-v0.5.0 → vendor/sspf-v0.5.0/ # bash scripts/fetch-platform.sh # 默认从 Cargo.toml 推断 sspf 版本 # # 包来源(按优先级): # 1. 环境变量 SSPF_DIST_DIR 指向目录里的 sspf-vX.Y.Z.tar.gz # 2. 默认:$HOME/Desktop/workspace/ssw-platform/dist/ # (未来可扩展为从内网 Gitea release 下载;此处先走本地 dist,单机开发够用) # set -euo pipefail cd "$(dirname "$0")/.." SKILL_ROOT="$(pwd)" # ── 版本号 ────────────────────────────────────────────────────── if [[ $# -ge 1 ]]; then VERSION="$1" else VERSION="$(grep -oE 'sspf-v[0-9]+\.[0-9]+\.[0-9]+' Cargo.toml 2>/dev/null | grep -oE '[0-9]+\.[0-9]+\.[0-9]+' | head -1)" if [[ -z "${VERSION}" ]]; then VERSION="$(grep -oE 'tag = "v[0-9.]+"' Cargo.toml 2>/dev/null | grep -oE '[0-9]+\.[0-9]+\.[0-9]+' | head -1)" fi if [[ -z "${VERSION}" ]]; then echo "!! 无法从 Cargo.toml 推断版本,请显式传版本:bash scripts/fetch-platform.sh 0.5.0" >&2 exit 1 fi fi # 🔴 目录/包名带 v 前缀,与 git tag(vX.Y.Z)对齐;crate 自身 version 是无 v 的 X.Y.Z PKG="sspf-v${VERSION}" TAR="${PKG}.tar.gz" # ── 定位包 ────────────────────────────────────────────────────── DIST_DIR="${SSPF_DIST_DIR:-$HOME/Desktop/workspace/ssw-platform/dist}" if [[ ! -f "${DIST_DIR}/${TAR}" ]]; then echo "!! 找不到包: ${DIST_DIR}/${TAR}" >&2 echo " 用环境变量 SSPF_DIST_DIR 指定平台仓 dist 目录,或先在平台仓跑过 bash scripts/release.sh" >&2 exit 1 fi # ── 解包 ──────────────────────────────────────────────────────── echo "==> 解包 ${DIST_DIR}/${TAR} → ${SKILL_ROOT}/vendor/${PKG}/" mkdir -p vendor # 🔴 先移走旧包目录:tar 只覆盖同名文件,不会删掉上一个包里【不同 hash】的 rlib; # 残留与新的混在 lib/ 里会让 `--extern sspf=$(ls libsspf-*.rlib|head -1)` 选到旧 hash # → 链接报 `could not parse bitcode` / 版本错乱。用 mv(不是 rm -rf)避开 safe-delete 钩子。 if [[ -e "vendor/${PKG}" ]]; then OLD="/tmp/old_${PKG}_$(date +%s)" mv "vendor/${PKG}" "${OLD}" && echo "==> 旧包已移走: ${OLD}" fi tar -xzf "${DIST_DIR}/${TAR}" -C vendor echo "${VERSION}" > "vendor/VERSION" # ── 校验 ──────────────────────────────────────────────────────── if [[ ! -f "vendor/${PKG}/crates/sspf/Cargo.toml" ]]; then echo "!! 解包结果异常:vendor/${PKG}/crates/sspf/Cargo.toml 不存在" >&2 exit 1 fi PKGVER="$(grep -m1 '^version' "vendor/${PKG}/crates/sspf/Cargo.toml" | sed -E 's/.*"([^"]+)".*/\1/')" echo "==> 已就绪:vendor/${PKG}/crates/sspf(包内 sspf 版本 ${PKGVER})" # ── 方案 C:预编译 rlib 消费方式 ──────────────────────────────── # 1) 锁工具链:把包的 rust-toolchain.toml 复制到消费方根,确保编译器版本与 rlib ABI 一致 if [[ -f "vendor/${PKG}/rust-toolchain.toml" ]]; then cp "vendor/${PKG}/rust-toolchain.toml" "./rust-toolchain.toml" PKG_CHANNEL="$(grep -m1 '^channel' "vendor/${PKG}/rust-toolchain.toml" | sed -E 's/.*"([^"]+)".*/\1/')" echo "==> 已锁工具链:./rust-toolchain.toml → rustc ${PKG_CHANNEL}" # 校验当前 rustc 是否会按 cwd 选到它(rustup 行为);不一致仅告警,不阻断 ACTIVE="$(rustc --version 2>/dev/null | sed -E 's/rustc ([0-9.]+).*/\1/')" if [[ -n "${ACTIVE}" && "${ACTIVE}" != "${PKG_CHANNEL}" ]]; then echo " ⚠️ 当前 rustc=${ACTIVE} ≠ 包要求 ${PKG_CHANNEL};cargo 会按 ./rust-toolchain.toml 自动切到 ${PKG_CHANNEL}(需 rustup 已装该版本)" >&2 fi else echo "!! ⚠️ 包内缺 rust-toolchain.toml,无法锁工具链;rlib ABI 匹配无保证" >&2 fi # 2) 生成 .cargo/config.toml —— 把平台预编译 rlib 直接喂给 rustc(消费方零编译平台闭包) # 🔴 关键:不仅 sspf,连 axum/tokio/serde/serde_json/http/bytes 也一并从 lib/ 喂(--extern)。 # 原因:sspf 的公共 API 签名里带 `axum::Json` / `http::HeaderMap` / `bytes::Bytes` 等类型。 # 若消费方自己再编一份 axum,就是「同名 crate 的两个实例」(version 相同、hash 不同), # 跨 sspf 边界传参必报 E0308 mismatched types(实测已踩)。只有让消费方也用 lib/ 里 # 这份预编译的 axum/tokio/...,类型才同源、能对上。 # ⇒ 消费方 Cargo.toml **不要**再声明这些依赖(否则 cargo 又编一份,冲突)。 # 消费方只编译**自己仓库内的 crate**(packs/backend);外部依赖全来自平台包 lib/。 SSPF_RLIB="$(ls vendor/${PKG}/lib/libsspf-*.rlib 2>/dev/null | head -1)" if [[ -n "${SSPF_RLIB}" ]]; then # 逐个从 lib/ 找 rlib,生成 --extern 行(缺哪个就跳过) EXTERN_LINES="" for c in sspf axum tokio serde serde_json http bytes; do rl="$(ls "vendor/${PKG}/lib/lib${c}-"*.rlib 2>/dev/null | head -1)" [[ -z "${rl}" ]] && continue EXTERN_LINES="${EXTERN_LINES} \"--extern\", \"${c}=${SKILL_ROOT}/${rl}\","$'\n' done mkdir -p .cargo cat > .cargo/config.toml < 已生成 .cargo/config.toml(--extern sspf/axum/tokio/serde/serde_json/http/bytes + -L dependency)" echo " 消费方 Cargo.toml 无需声明这些依赖;代码照用 use sspf:: / use axum::" else echo "!! ⚠️ 包内 lib/ 缺 libsspf-*.rlib(旧包?)。改用 dev 回退:" >&2 echo " 在 Cargo.toml 写 sspf = { path = \"vendor/${PKG}/crates/sspf\", version = \"${VERSION%.*}\" }" >&2 fi echo "" echo "下一步:" echo " • cargo build (方案 C:直接链接预编译 rlib,零编译平台)" echo " • 升版本:bash scripts/fetch-platform.sh <新版本>"