From f8d2cf4cf58d77d1704d4dc51d477c8277507621 Mon Sep 17 00:00:00 2001 From: admin Date: Thu, 5 Nov 2026 12:50:46 +0800 Subject: [PATCH] =?UTF-8?q?feat(dep):=20=E6=8A=80=E8=83=BD=E6=94=B9?= =?UTF-8?q?=E7=BA=AF=20rlib=20=E6=B6=88=E8=B4=B9=20=E2=80=94=E2=80=94=20fe?= =?UTF-8?q?tch=20=E5=8F=AA=E8=A7=A3=20lib/=EF=BC=8C=E4=B8=8D=E5=86=8D?= =?UTF-8?q?=E8=A7=A3=E5=8C=85=E5=B9=B3=E5=8F=B0=E6=BA=90=E7=A0=81?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - fetch-platform.sh: 解包加 --exclude=crates/src/frontend/Cargo.toml/Cargo.lock, 只留 lib/ + rust-toolchain.toml + bin/ + docs/README(vendor 少解 ~62M 源码) - 校验改为认 vendor/.../lib/libsspf-*.rlib,不再读 crates/sspf/Cargo.toml - 所有「dev 回退 path 到 vendor 源码」改为「极端回退用 git tag 依赖」 - 文档同步 SKILL/README/HANDOFF 验证: cargo clean 后 dev 5.14s / release 9.34s,只编本仓 5 crate; vendor 无任何平台源码;二进制 --help 正常(基于 sspf v0.5.0)。 --- HANDOFF.md | 6 +++--- README.md | 7 ++++--- SKILL.md | 2 +- scripts/fetch-platform.sh | 37 ++++++++++++++++++++++++------------- 4 files changed, 32 insertions(+), 20 deletions(-) diff --git a/HANDOFF.md b/HANDOFF.md index 950a8ad..7ff1fd0 100644 --- a/HANDOFF.md +++ b/HANDOFF.md @@ -11,7 +11,7 @@ > + axum/tokio 等**(首次 `cargo build` 数分钟)。目标是「其他用户首次构建也别重编平台」, > 最终落地**方案 C**:平台包内含**预编译 rlib 完整闭包** `lib/`,本仓用 `--extern` 直接链接。 -**现在的依赖模型(务必按这个理解,旧文档里「path 依赖」的写法属于 dev 回退)** +**现在的依赖模型(务必按这个理解;旧文档里「path 依赖」的写法已废弃——本仓只依赖 rlib)** - **本仓 `Cargo.toml` 不声明任何外部 crate 依赖**(`[workspace.dependencies]` 为空)。 平台 `sspf`、`axum`、`tokio`、`serde`、`serde_json`、`http`、`bytes` 全部来自平台包 `lib/`。 @@ -56,7 +56,7 @@ `bootstrap.rs`、`db/schema.sql`、`tests/`(7 个集成测试,测的是被删的那份实现)。 备份在 `/tmp/skill-backup/backend-2216/`。 2. **平台改为依赖已发布包**:根 `Cargo.toml` 的 - `[workspace.dependencies] sspf = { path = "vendor/sspf-v0.5.0/crates/sspf", version = "0.5" }`(由 `scripts/fetch-platform.sh` 解包进来), + `[workspace.dependencies] sspf = { path = "vendor/sspf-v0.5.0/crates/sspf", version = "0.5" }`(**历史写法**:现已是方案 C 的 rlib 消费,`fetch-platform.sh` 不再解包平台源码), 成员一律 `sspf = { workspace = true }`。解析结果: `sspf v0.4.0 (...?tag=v0.4.0#ff34ca50)`,**0 个 `sspf-pack-*` 被平台带进来**。 3. **示例业务包迁入**:`packs/{demo,shop,books,asset}/`(表 DDL + 列 + 菜单 + 面 B 路由), @@ -83,7 +83,7 @@ | 项 | 结果 | |---|---| -| `cargo check --workspace` / `cargo build --release` | ✅ 通过(平台来自 `vendor/sspf-v0.5.0/` 的 path 依赖,无需 Gitea;`cargo build --offline` 亦可) | +| `cargo build` / `cargo build --release` | ✅ 通过(平台来自 `vendor/sspf-v0.5.0/lib/` 的**预编译 rlib**,零重编;无需 Gitea) | | `cargo test --workspace` | ✅ 全绿(4 个包各自 14/14/3/3 条包自检 + 应用单测) | | `python3 scripts/check-scaffold.py` | ✅ PASS=6 FAIL=0 | | `python3 scripts/check-scaffold.py --self-test` | ✅ 反自证 6/6 | diff --git a/README.md b/README.md index c7b2514..b47b4e3 100644 --- a/README.md +++ b/README.md @@ -75,7 +75,7 @@ ssw-jnpf-lite-rust/ ← 仓根 = 技能根(三处软链指向这里 ├── JNPF_COMPAT_SURFACE.md # 面 B 规格书:官方形状端点 + 落地顺序 S1–S6 ├── CLAUDE.md / HANDOFF.md # 项目级 agent 指引 / 交接文档 ├── run.sh # install / build / dev / backend / frontend / stop / logs -├── Cargo.toml # 🔴 workspace 根:**唯一的平台依赖**(sspf 的 path 指向 vendor/sspf-vX.Y.Z)就在这儿 +├── Cargo.toml # workspace 根:方案 C **不声明外部依赖**;rlib 由 .cargo/config.toml 的 --extern 喂入 ├── .env.example # PORT / BIND_ADDR / PGLITE_DIR ├── scripts/ │ ├── verify.sh # 一键验收(静态 + 全量测试 + 两把运行时尺子) @@ -150,8 +150,9 @@ cd "$PROJ" && cp .env.example .env && ./run.sh install && ./run.sh dev > ⚠️ **只复制脚手架本体**——`*.md` / `references/` / `template-boot-jnpf/` / `docs/` 是技能资产, > 留在技能目录只读引用。全量 `cp -R` 会让项目目录混满技能噪音,日后技能升级也灌不进项目。 > 🔴 **`packs/` 必须一起复制**:业务真源在包里 ⇒ 少了它应用能起但**面 A 全 404**。 -> 🔴 **`Cargo.toml`(workspace 根)别漏**:`sspf` 的 `path` 依赖(指向 `vendor/sspf-vX.Y.Z/crates/sspf`)就在里面, -> 缺了它 `src/backend` 的 `workspace = true` 继承无处可依 ⇒ 编译不起来。 +> 🔴 **`Cargo.toml`(workspace 根)别漏**:`members` / `workspace.package` 继承都在里面; +> 外部依赖(sspf/axum/…)由 `.cargo/config.toml` 的 `--extern` 从平台包 `lib/` 喂入, +> 缺了 config 编译不起来(先跑 `scripts/fetch-platform.sh` 生成)。 ## 验收门 diff --git a/SKILL.md b/SKILL.md index 4a32297..562e199 100644 --- a/SKILL.md +++ b/SKILL.md @@ -23,7 +23,7 @@ type: skill > - 🔴 两个硬约束(踩过):① 消费方必须用平台那份 axum(自己编会 E0308 类型不匹配); > ② 本仓 release profile 必须 `lto = false`(预编译 rlib 无 bitcode,开 LTO 会失败)。 > - 升级平台 = `bash scripts/fetch-platform.sh <新版本>`(重解包 + 重生成 config + 锁工具链)。 -> - dev 回退(要改平台源码):删 `.cargo/config.toml`,把 `sspf`/`axum` 等改回 path/registry 依赖。 +> - 极端回退(要改平台源码):删 `.cargo/config.toml`,改用 git 依赖(`sspf = { git = …, tag = "vX.Y.Z" }`)+ axum/tokio 回归 registry 依赖。 > > 判据:`python3 scripts/check-scaffold.py`(本仓出现 `platform/` / `routes.rs` / `crates/` 立刻红)。 > diff --git a/scripts/fetch-platform.sh b/scripts/fetch-platform.sh index 84c68bc..740d0ba 100755 --- a/scripts/fetch-platform.sh +++ b/scripts/fetch-platform.sh @@ -3,16 +3,19 @@ # 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 仓**。 +# `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 复制到本仓根。 # -# dev 回退(path 依赖,多一次编译但能改平台):删掉 .cargo/config.toml,并在 Cargo.toml 写 -# sspf = { path = "vendor/sspf-vX.Y.Z/crates/sspf", version = "0.5" } +# 🔴 本脚本**只解包 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/ @@ -62,16 +65,24 @@ 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 +# 🔴 只解包 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" -# ── 校验 ──────────────────────────────────────────────────────── -if [[ ! -f "vendor/${PKG}/crates/sspf/Cargo.toml" ]]; then - echo "!! 解包结果异常:vendor/${PKG}/crates/sspf/Cargo.toml 不存在" >&2 +# ── 校验(认 rlib,不认源码)────────────────────────────────── +if ! ls vendor/${PKG}/lib/libsspf-*.rlib >/dev/null 2>&1; then + echo "!! 解包结果异常:vendor/${PKG}/lib/libsspf-*.rlib 不存在(包内缺预编译 rlib?)" >&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})" +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 一致 @@ -111,7 +122,7 @@ if [[ -n "${SSPF_RLIB}" ]]; then # 把平台预编译 rlib 直接喂给 rustc,消费方【不编译】平台 17 个 crate 闭包, # 也不编 axum/tokio/serde/serde_json(全部取自平台 lib/,保证与 sspf 同一 crate 实例)。 # ⚠️ 前提:rustc 版本 == vendor/${PKG}/rust-toolchain.toml(ABI 锁,否则链接失败)。 -# 回退(path 依赖,多一次编译):删掉本文件 + Cargo.toml 改回 sspf = { path = "vendor/${PKG}/crates/sspf" } +# 极端回退(要改平台源码):删本文件 + 改用 git 依赖 sspf = { git = "http://127.0.0.1:13300/ssw/ssw-platform.git", tag = "v${VERSION}" } [build] rustflags = [ ${EXTERN_LINES} "-L", "dependency=${SKILL_ROOT}/vendor/${PKG}/lib", @@ -120,8 +131,8 @@ EOF echo "==> 已生成 .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 + echo "!! ⚠️ 包内 lib/ 缺 libsspf-*.rlib(旧包?)。请用新版 release.sh 重新出包:" >&2 + echo " 或极端回退:删 .cargo/config.toml + 改用 git 依赖(tag = v${VERSION})" >&2 fi echo ""