feat(dep): 技能改纯 rlib 消费 —— fetch 只解 lib/,不再解包平台源码
- 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)。
This commit is contained in:
1 parent
bef326ad2f
commit
f8d2cf4cf5
4 files changed
+32
-20
No files matched your search
+3
-3
@@ -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 |
|
||||
|
||||
@@ -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` 生成)。
|
||||
|
||||
## 验收门
|
||||
|
||||
|
||||
@@ -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/` 立刻红)。
|
||||
>
|
||||
|
||||
+24
-13
@@ -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 ""
|
||||
|
||||
Reference in new issue
Block a user