#!/usr/bin/env bash # # fetch-platform.sh —— 把平台「自包含发布包」解包到 vendor/,让本仓以【方案 C】消费 sspf # # 背景(2026-11-05 依赖模型变更):平台仓每个版本产出一个自包含包 # `dist/sspf-vX.Y.Z.tar.gz`(预编译 sspf-admin 二进制 + 预编译 rlib 闭包 lib/ + # 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 复制到本仓根。 # # 🔴 本脚本**只解包 rlib 与工具链**(lib/ + rust-toolchain.toml + bin/ + docs/README), # 平台源码(crates/、src/、Cargo.toml/lock、frontend/)**不解包**——本仓依赖的是 rlib,不是源码。 # # 极端回退(要改平台源码,很少用):删掉 .cargo/config.toml,改用 git 依赖(见 docs §6.5): # sspf = { git = "http://127.0.0.1:13300/ssw/ssw-platform.git", tag = "vX.Y.Z" } # # 用法: # 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 # 🔴 只解包 rlib 闭包 + 工具链(+ bin/docs/README),**跳过平台源码**: # 本仓依赖的是预编译 rlib;源码(crates/ ~3M + src/ ~59M + Cargo.toml/lock + frontend/) # 解进来纯属浪费,还会诱导「path 依赖源码」的旧用法。用 tar 的 --exclude 过滤。 tar -xzf "${DIST_DIR}/${TAR}" -C vendor \ --exclude="${PKG}/crates" \ --exclude="${PKG}/src" \ --exclude="${PKG}/frontend" \ --exclude="${PKG}/Cargo.toml" \ --exclude="${PKG}/Cargo.lock" echo "${VERSION}" > "vendor/VERSION" # ── 校验(认 rlib,不认源码)────────────────────────────────── if ! ls vendor/${PKG}/lib/libsspf-*.rlib >/dev/null 2>&1; then echo "!! 解包结果异常:vendor/${PKG}/lib/libsspf-*.rlib 不存在(包内缺预编译 rlib?)" >&2 exit 1 fi LIB_N="$(ls -1 "vendor/${PKG}/lib" | wc -l | tr -d ' ')" echo "==> 已就绪:vendor/${PKG}/lib(${LIB_N} 个预编译产物,sspf 版本 ${VERSION},纯 rlib 消费)" # ── 方案 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(旧包?)。请用新版 release.sh 重新出包:" >&2 echo " 或极端回退:删 .cargo/config.toml + 改用 git 依赖(tag = v${VERSION})" >&2 fi echo "" echo "下一步:" echo " • cargo build (方案 C:直接链接预编译 rlib,零编译平台)" echo " • 升版本:bash scripts/fetch-platform.sh <新版本>"