refactor(dep): 平台依赖改为 vendor 发布包,去掉 git 依赖

- Cargo.toml 的 sspf 由 git tag 改为 path 指向 vendor/sspf-v0.5.0/crates/sspf。
- 新增 scripts/fetch-platform.sh:解包平台发布包到 vendor/(含离线校验)。
- [workspace] exclude vendor/,避免包内 crate 被误并入职本仓 workspace。
- .gitignore 忽略 vendor/;SKILL/README/CLAUDE/HANDOFF/runbook 同步说明新模型。
This commit is contained in:
admin committed 2026-11-05 09:28:48 +08:00
1 parent c0336d1099
commit dc54e8bd1d
9 files changed
+110 -43

No files matched your search

+4
View File
@@ -2,6 +2,10 @@
target/
**/target/
# 🔴 平台发布包(2026-11-05 依赖模型变更):由 scripts/fetch-platform.sh 解包进来,
# 不进版本库。升版本重跑 fetch 即可,Cargo.toml 的行指向新目录。
vendor/
# 运行期数据(pglite 数据目录)
src/backend/data/
src/backend/data.bak-*/
+7 -5
View File
@@ -8,8 +8,10 @@
**ssw-jnpf-lite-rust** = **JNPF 兼容契约的 Rust 业务样板**(单二进制、零外部服务)。
🔴 **平台不在本仓**(2026-11-04 架构变更):登录 / 权限 / 面 A·B / 低代码 / MCP / 177 张
`base_*` 表在**已发布的 `sspf` 包**里(`Cargo.toml` 的 `git` + `tag = "v0.5.0"`)。
🔴 **平台不在本仓**(2026-11-04 → 2026-11-05 架构变更):登录 / 权限 / 面 A·B / 低代码 / MCP / 177 张
`base_*` 表在**已发布的 `sspf` 包**里——平台仓每版本 `bash scripts/release.sh` 打出自包含发布包,
本仓 `bash scripts/fetch-platform.sh vX.Y.Z` 解包到 `vendor/sspf-vX.Y.Z/`,`Cargo.toml` 用 `path` 指进去
(**不再直接依赖 git 仓**)。
本仓只有 **业务包 `packs/` + 面 A 适配器 `modules/` + 薄装配 `main.rs` + 前端产物 + 两把尺子**。
以前这里有一份 4000 行的平台实现(`src/backend/src/platform/` + `routes.rs`),已整体删除 ——
**不要把它抄回来**:`python3 scripts/check-scaffold.py` 的 SC1 会立刻红。
@@ -84,8 +86,8 @@ ssw-jnpf-lite-rust/ # 【仓根 = 技能根】三处软链 ~/.agents ·
├── MIGRATION.md # 迁移指南(Rust ⇄ NestJS ⇄ 官方 JNPF Java)
├── JNPF_SOURCE_AUDIT.md # 官方源码逐行核对报告
├── JNPF_COMPAT_SURFACE.md # 面 B 规格书 + 落地顺序 S1–S6
├── Cargo.toml # 【workspace 根】members = ["src/backend", "packs/*"]
│ # 🔴 唯一的平台依赖:sspf = { git = "...", tag = "v0.5.0" }
├── Cargo.toml # 【workspace 根】members = ["src/backend", "packs/*"],exclude = ["vendor"]
│ # 🔴 唯一的平台依赖:sspf = { path = "vendor/sspf-v0.5.0/crates/sspf", version = "0.5" }
├── CLAUDE.md / HANDOFF.md # 本文件 / 交接文档
├── run.sh # install / build / dev / backend / frontend / stop / logs
├── packs/ # 【业务真源】整目录可搬;每个包只依赖 sspf 门面
@@ -154,7 +156,7 @@ ssw-jnpf-lite-rust/ # 【仓根 = 技能根】三处软链 ~/.agents ·
11. 🔴 **面 B 未登录返 `code=602`**,不是 `600`。官方前端 `request.ts` 只对 `601`/`602` 清 token ⇒
返 `600` 会让官方前端卡死不跳登录页。面 A 仍是 `600`(**冻结**)。
12. 🔴 **平台 / 业务分离(靠仓库边界,不靠目录纪律)。**
- **平台** = 已发布的 `sspf` 包(`Cargo.toml` 的 git tag)—— **不在本仓**。
- **平台** = 已发布的 `sspf` 包(本仓 `vendor/sspf-vX.Y.Z/`,由平台仓出包、本仓 `fetch-platform.sh` 解包)—— **不在本仓**。
它自带登录 / 权限 / `base_*` / 面 B / CRUD 引擎 / 177 张表。
- **业务** = `packs/<app>/`(真源:表 DDL + 列 + 菜单 + 面 B 路由)+
`src/backend/src/modules/<app>.rs`(面 A 适配器,只 `pub use` 转发 spec)。
Generated
-18
View File
@@ -1069,7 +1069,6 @@ dependencies = [
[[package]]
name = "sspf"
version = "0.5.0"
source = "git+http://127.0.0.1:13300/ssw/ssw-platform.git?tag=v0.5.0#509c6b1d1fe76809c805c7e5c46a7d29a58420a6"
dependencies = [
"axum",
"libc",
@@ -1086,7 +1085,6 @@ dependencies = [
[[package]]
name = "sspf-compat-core"
version = "0.1.0"
source = "git+http://127.0.0.1:13300/ssw/ssw-platform.git?tag=v0.5.0#509c6b1d1fe76809c805c7e5c46a7d29a58420a6"
dependencies = [
"axum",
"serde",
@@ -1098,7 +1096,6 @@ dependencies = [
[[package]]
name = "sspf-compat-ext"
version = "0.1.0"
source = "git+http://127.0.0.1:13300/ssw/ssw-platform.git?tag=v0.5.0#509c6b1d1fe76809c805c7e5c46a7d29a58420a6"
dependencies = [
"axum",
"chrono",
@@ -1114,7 +1111,6 @@ dependencies = [
[[package]]
name = "sspf-compat-msg"
version = "0.1.0"
source = "git+http://127.0.0.1:13300/ssw/ssw-platform.git?tag=v0.5.0#509c6b1d1fe76809c805c7e5c46a7d29a58420a6"
dependencies = [
"axum",
"chrono",
@@ -1128,7 +1124,6 @@ dependencies = [
[[package]]
name = "sspf-compat-onlinedev"
version = "0.1.0"
source = "git+http://127.0.0.1:13300/ssw/ssw-platform.git?tag=v0.5.0#509c6b1d1fe76809c805c7e5c46a7d29a58420a6"
dependencies = [
"axum",
"serde",
@@ -1141,7 +1136,6 @@ dependencies = [
[[package]]
name = "sspf-compat-permission"
version = "0.1.0"
source = "git+http://127.0.0.1:13300/ssw/ssw-platform.git?tag=v0.5.0#509c6b1d1fe76809c805c7e5c46a7d29a58420a6"
dependencies = [
"axum",
"chrono",
@@ -1157,7 +1151,6 @@ dependencies = [
[[package]]
name = "sspf-compat-system"
version = "0.1.0"
source = "git+http://127.0.0.1:13300/ssw/ssw-platform.git?tag=v0.5.0#509c6b1d1fe76809c805c7e5c46a7d29a58420a6"
dependencies = [
"axum",
"chrono",
@@ -1172,7 +1165,6 @@ dependencies = [
[[package]]
name = "sspf-compat-workflow"
version = "0.1.0"
source = "git+http://127.0.0.1:13300/ssw/ssw-platform.git?tag=v0.5.0#509c6b1d1fe76809c805c7e5c46a7d29a58420a6"
dependencies = [
"aes",
"axum",
@@ -1189,7 +1181,6 @@ dependencies = [
[[package]]
name = "sspf-contract"
version = "0.1.0"
source = "git+http://127.0.0.1:13300/ssw/ssw-platform.git?tag=v0.5.0#509c6b1d1fe76809c805c7e5c46a7d29a58420a6"
dependencies = [
"http",
"serde",
@@ -1200,7 +1191,6 @@ dependencies = [
[[package]]
name = "sspf-core"
version = "0.1.0"
source = "git+http://127.0.0.1:13300/ssw/ssw-platform.git?tag=v0.5.0#509c6b1d1fe76809c805c7e5c46a7d29a58420a6"
dependencies = [
"aes",
"axum",
@@ -1221,7 +1211,6 @@ dependencies = [
[[package]]
name = "sspf-lowcode"
version = "0.1.0"
source = "git+http://127.0.0.1:13300/ssw/ssw-platform.git?tag=v0.5.0#509c6b1d1fe76809c805c7e5c46a7d29a58420a6"
dependencies = [
"serde",
"serde_json",
@@ -1231,7 +1220,6 @@ dependencies = [
[[package]]
name = "sspf-lowcode-exec"
version = "0.1.0"
source = "git+http://127.0.0.1:13300/ssw/ssw-platform.git?tag=v0.5.0#509c6b1d1fe76809c805c7e5c46a7d29a58420a6"
dependencies = [
"chrono",
"pglite-rs",
@@ -1245,7 +1233,6 @@ dependencies = [
[[package]]
name = "sspf-mcp"
version = "0.1.0"
source = "git+http://127.0.0.1:13300/ssw/ssw-platform.git?tag=v0.5.0#509c6b1d1fe76809c805c7e5c46a7d29a58420a6"
dependencies = [
"serde",
"serde_json",
@@ -1256,7 +1243,6 @@ dependencies = [
[[package]]
name = "sspf-mcp-adapter"
version = "0.1.0"
source = "git+http://127.0.0.1:13300/ssw/ssw-platform.git?tag=v0.5.0#509c6b1d1fe76809c805c7e5c46a7d29a58420a6"
dependencies = [
"axum",
"pglite-rs",
@@ -1303,7 +1289,6 @@ dependencies = [
[[package]]
name = "sspf-plugin"
version = "0.1.0"
source = "git+http://127.0.0.1:13300/ssw/ssw-platform.git?tag=v0.5.0#509c6b1d1fe76809c805c7e5c46a7d29a58420a6"
dependencies = [
"serde",
"serde_json",
@@ -1314,7 +1299,6 @@ dependencies = [
[[package]]
name = "sspf-sdk"
version = "0.1.0"
source = "git+http://127.0.0.1:13300/ssw/ssw-platform.git?tag=v0.5.0#509c6b1d1fe76809c805c7e5c46a7d29a58420a6"
dependencies = [
"sspf-contract",
]
@@ -1322,7 +1306,6 @@ dependencies = [
[[package]]
name = "sspf-store"
version = "0.1.0"
source = "git+http://127.0.0.1:13300/ssw/ssw-platform.git?tag=v0.5.0#509c6b1d1fe76809c805c7e5c46a7d29a58420a6"
dependencies = [
"chrono",
"pglite-rs",
@@ -1347,7 +1330,6 @@ dependencies = [
[[package]]
name = "ssw-platform"
version = "0.1.0"
source = "git+http://127.0.0.1:13300/ssw/ssw-platform.git?tag=v0.5.0#509c6b1d1fe76809c805c7e5c46a7d29a58420a6"
dependencies = [
"aes",
"axum",
+11 -2
View File
@@ -14,6 +14,11 @@
[workspace]
members = ["src/backend", "packs/*"]
# 🔴 **exclude vendor/**:平台发布包解包在这里(`vendor/sspf-vX.Y.Z/`),它自带
# 自己的 workspace 根(含 `[workspace.dependencies]`)。若不 exclude,cargo 会把
# 包内 crate 误并入职本仓 workspace,导致 `libc` 等 `workspace = true` 继承解析失败。
# exclude 后,包内 crate 用包自己的 workspace 根解析,path 依赖照常工作。
exclude = ["vendor"]
resolver = "2"
[workspace.package]
@@ -24,8 +29,12 @@ rust-version = "1.85"
[workspace.dependencies]
# 🔴 **平台包**:业务仓 / 技能仓唯一该依赖的东西。
# 升版本 = 改这个 tag(平台仓 `git tag` 已发布的那一个)。
sspf = { git = "http://127.0.0.1:13300/ssw/ssw-platform.git", tag = "v0.5.0" }
# 依赖模型(2026-11-05 变更):不再直接依赖 git 仓,改为平台仓每版本打出的
# **自包含发布包**(见平台仓 `docs/SSPF-PLATFORM-PACKAGE.md` §6)。
# 包由 `bash scripts/fetch-platform.sh vX.Y.Z` 解包到 `vendor/sspf-vX.Y.Z/`,
# 本行用 path 指进去;版本按目录名钉死。
# 升版本 = 改这一行(路径 + version 一起改),不许在任何成员里写第二份。
sspf = { path = "vendor/sspf-v0.5.0/crates/sspf", version = "0.5" }
# 🔴 业务侧还需要的东西(平台不替我们决定 web 框架的版本)
axum = "0.8"
+2 -2
View File
@@ -17,7 +17,7 @@
`bootstrap.rs`、`db/schema.sql`、`tests/`(7 个集成测试,测的是被删的那份实现)。
备份在 `/tmp/skill-backup/backend-2216/`。
2. **平台改为依赖已发布包**:根 `Cargo.toml` 的
`[workspace.dependencies] sspf = { git = ".../ssw-platform.git", tag = "v0.4.0" }`,
`[workspace.dependencies] sspf = { path = "vendor/sspf-v0.5.0/crates/sspf", version = "0.5" }`(由 `scripts/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 路由),
@@ -44,7 +44,7 @@
| 项 | 结果 |
|---|---|
| `cargo check --workspace` / `cargo build --release` | ✅ 通过(首次拉 git 依赖,之后走 `~/.cargo/git` 缓存) |
| `cargo check --workspace` / `cargo build --release` | ✅ 通过(平台来自 `vendor/sspf-v0.5.0/` 的 path 依赖,无需 Gitea;`cargo build --offline` 亦可) |
| `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 |
+10 -6
View File
@@ -1,12 +1,16 @@
# ssw-jnpf-lite-rust · Rust 全栈 MVP
**平台来自已发布的 `sspf` 包**(`Cargo.toml` 里 `git` + `tag = "v0.5.0"`),本仓只有
**平台来自 `sspf` 发布包**(`vendor/sspf-v0.5.0/` 由平台仓 `scripts/release.sh` 产出、本仓
`scripts/fetch-platform.sh` 解包,不再直接依赖 git 仓),本仓只有
**业务样板(`packs/`)+ 面 A 适配器 + 薄装配 + 前端产物 + 两把运行时尺子**。
数据库仍是**进程内原生 PostgreSQL**(由平台包提供),除 Node 外无需装任何东西。
> 🔴 **2026-11-04 架构变更**:以前本仓自带一份平台实现(`src/backend/src/platform/` + `routes.rs`,约 4000 行),
> 那是「示例仓里躺着一份会分叉的平台」。现在平台只在 `sspf` 一处演进,本仓锁 tag;
> 升级平台 = 改 `Cargo.toml` 里那一行,业务代码不动。
> 🔴 **2026-11-04 → 2026-11-05 架构变更**:以前本仓自带一份平台实现(`src/backend/src/platform/` + `routes.rs`,约 4000 行),
> 那是「示例仓里躺着一份会分叉的平台」。2026-11-04 平台搬进 `sspf` 一处演进,本仓**锁 git tag**;
> 2026-11-05 进一步改为**每版本出包**(平台仓 `scripts/release.sh` 打 `dist/sspf-vX.Y.Z.tar.gz`,本仓
> `scripts/fetch-platform.sh` 解包到 `vendor/sspf-vX.Y.Z/`),`Cargo.toml` 用 `path` 指进去——
> **不再需要 Gitea 访问、不再 clone 整个 monorepo、不再每次重编 20+ crate**。
> 升级平台 = 改 `Cargo.toml` 里那一行 `path`(路径 + version 一起改),业务代码不动。
> 判据:`python3 scripts/check-scaffold.py`(本仓出现 `platform/` / `routes.rs` / `crates/` 立刻红)。
来自 `ssw-jnpf-lite-react`(NestJS + React)的 **Rust 全栈 counterpart**——两者是**并列可选**的独立技能,
@@ -68,7 +72,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 的 git tag)就在这儿
├── Cargo.toml # 🔴 workspace 根:**唯一的平台依赖**(sspf 的 path 指向 vendor/sspf-vX.Y.Z)就在这儿
├── .env.example # PORT / BIND_ADDR / PGLITE_DIR
├── scripts/
│ ├── verify.sh # 一键验收(静态 + 全量测试 + 两把运行时尺子)
@@ -143,7 +147,7 @@ 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` 的 git tag 就在里面,
> 🔴 **`Cargo.toml`(workspace 根)别漏**:`sspf` 的 `path` 依赖(指向 `vendor/sspf-vX.Y.Z/crates/sspf`)就在里面,
> 缺了它 `src/backend` 的 `workspace = true` 继承无处可依 ⇒ 编译不起来。
## 验收门
+13 -9
View File
@@ -1,6 +1,6 @@
---
name: ssw-jnpf-lite-rust
description: Rust 全栈 MVP 脚手架(**平台来自已发布的 sspf 包,锁 git tag**;本仓只有业务样板 + 薄装配 + 前端产物 + 尺子),契约与数据模型从第一天起对齐 JNPF 标准版(cipher / ActionResult / f_ 列 / varchar(50) UUID / base_* 权限表 / 进程内原生 PostgreSQL),前后端同一进程同时提供「面 A(ssw 契约 30 条)」与「面 B(官方 JNPF 形状 5 条 + 2 条共用按 Vue-Version 头分流)」两套契约。适用于「AI 开发 MVP 阶段要 Rust 全栈快速迭代、稳定后迁 JNPF 标准栈」的场景,含用户/角色/机构/菜单/授权五套管理页与四源合并菜单守卫。加业务模块见同目录 HOWTO_MODULE.md。
description: Rust 全栈 MVP 脚手架(**平台来自 sspf 发布包,vendor/ 解包,不再依赖 git 仓**;本仓只有业务样板 + 薄装配 + 前端产物 + 尺子),契约与数据模型从第一天起对齐 JNPF 标准版(cipher / ActionResult / f_ 列 / varchar(50) UUID / base_* 权限表 / 进程内原生 PostgreSQL),前后端同一进程同时提供「面 A(ssw 契约 30 条)」与「面 B(官方 JNPF 形状 5 条 + 2 条共用按 Vue-Version 头分流)」两套契约。适用于「AI 开发 MVP 阶段要 Rust 全栈快速迭代、稳定后迁 JNPF 标准栈」的场景,含用户/角色/机构/菜单/授权五套管理页与四源合并菜单守卫。加业务模块见同目录 HOWTO_MODULE.md。
type: skill
---
@@ -8,15 +8,19 @@ type: skill
**技能 = 业务样板 + 薄装配 + 前端产物 + 两把尺子**;**平台不在本仓**。
平台(登录 / 权限 / 面 A·B / 低代码 / MCP / 177 张 `base_*` 表 / 进程内原生 PostgreSQL)
来自**已发布的 `sspf` 包**(`Cargo.toml` 里的 `git` + `tag = "v0.5.0"`)。
来自**已发布的 `sspf` 包**(平台仓每版本打出的**自包含发布包**,不是直接依赖 git 仓)。
> 🔴 **这条是 2026-11-04 的架构变更**:以前本技能自带一份平台实现(`src/backend/src/platform/`),
> 结果是「示例仓里躺着一份会分叉的平台」。现在平台只在 `sspf` 一处演进,本仓锁 **tag**;
> 升级平台 = 改 `Cargo.toml` 里那一行 tag,业务代码不动。
> 🔴 **这条是 2026-11-04 → 2026-11-05 的架构变更**:
> - 2026-11-04:平台从「本仓自带一份实现」搬进 `sspf` 一处演进,本仓**锁 git tag** 依赖。
> - 2026-11-05:进一步改为**每版本出包**——平台仓 `bash scripts/release.sh` 产出
> `dist/sspf-vX.Y.Z.tar.gz`(预编译 `sspf-admin` 二进制 + 平台 crate 源码 + `Cargo.lock`),
> 本仓用 `bash scripts/fetch-platform.sh vX.Y.Z` 解包到 `vendor/sspf-vX.Y.Z/`,
> `Cargo.toml` 用 `path` 指进去。**不再需要访问 git 服务、不再 clone 整个 monorepo、不再每次重编 20+ crate**。
> - 升级平台 = 改 `Cargo.toml` 那一行 `path`(路径 + version 一起改),业务代码不动。
> 判据:`python3 scripts/check-scaffold.py`(本仓出现 `platform/` / `routes.rs` / `crates/` 立刻红)。
>
> **依赖前提**:能访问 `http://127.0.0.1:13300/ssw/ssw-platform.git`(本机 Gitea)。
> 首次 `cargo build` 会拉一次 git 依赖,之后走 `~/.cargo/git` 缓存。
> 🔴 **依赖前提变了**:不再需要 Gitea 访问;只要 `vendor/sspf-vX.Y.Z/` 已解包(`scripts/fetch-platform.sh` 自动完成),
> `cargo build --offline` 也能编(包自带 `Cargo.lock`)。
来自 `ssw-jnpf-lite-react`(NestJS + React)的 **Rust 全栈 counterpart**——两者是**并列可选**的独立技能,
不是依赖关系:要 MVP 期就用 Node 栈选 `ssw-jnpf-lite-react`,要 MVP 期用 Rust 栈选本技能。
@@ -87,7 +91,7 @@ cd "$PROJ" && cp .env.example .env && ./run.sh install && ./run.sh dev
```
Cargo.toml workspace 根:【唯一的平台依赖就在这儿】
sspf = { git = "http://127.0.0.1:13300/ssw/ssw-platform.git", tag = "v0.5.0" }
sspf = { path = "vendor/sspf-v0.5.0/crates/sspf", version = "0.5" } # 由 scripts/fetch-platform.sh 解包进来;升版本改这一行
src/backend/ 示例应用(薄壳,~500 行)
src/main.rs 解析 --enc/--help + 把「配置 + 包 + 面 A 路由 + 前端」交给
sspf::Platform::new().config().packs().router().static_dir().serve()
@@ -163,7 +167,7 @@ template-boot-jnpf/ JNPF 标准栈最小可运行骨架(Java)—— 迁官
| | `scripts/check-scaffold.py` | `cargo test --workspace` | `scripts/perm-smoke.sh` | `scripts/perm-smoke-jnpf.sh` |
|---|---|---|---|---|
| 类别 | 静态判据 | 单元 / 集成测试 | **运行时尺子·面 A** | **运行时尺子·面 B** |
| 测什么 | **本仓只准有业务**(SC1–SC6:没有 platform/、没有 `base_*` 建表、应用只依赖门面、包只依赖门面、`sspf` 锁 git tag、生成物不漂移) | 包自检(列/DDL/路由形状)+ 应用装配 + spec 唯一性 + sync 一致性 | 面 A 契约 32 条 | 官方 JNPF 形状 18 条 |
| 测什么 | **本仓只准有业务**(SC1–SC6:没有 platform/、没有 `base_*` 建表、应用只依赖门面、包只依赖门面、`sspf` 锁 vendor 包版本、生成物不漂移) | 包自检(列/DDL/路由形状)+ 应用装配 + spec 唯一性 + sync 一致性 | 面 A 契约 32 条 | 官方 JNPF 形状 18 条 |
| 起后端 | 否 | 否 | 是(**默认自起隔离实例**) | 是(**默认自起隔离实例**) |
| 断言数 | **6**(+ 反自证 **6/6**) | 按 workspace | **32** | **18** |
+1 -1
View File
@@ -210,7 +210,7 @@ python3 scripts/check-scaffold.py --self-test # 期望:反自证 6/6
| **SC2** | 业务侧没有 `base_*` 建表语句(`docs/` 里的参考 DDL 不算 —— 它不参与运行) |
| **SC3** | 应用 crate 只依赖门面 `sspf`(+ axum/tokio + 业务包),不直接依赖 `sspf-*` 内部 crate |
| **SC4** | 每个业务包只依赖 `sspf`,且 `Cargo.toml` / `pack.toml` / `schema/001_init.sql` / `src/lib.rs` 齐全 |
| **SC5** | `sspf` 只从 workspace 的 **git tag** 来;成员不许另写 `git` / `path` / `version` |
| **SC5** | `sspf` 只从 workspace 根的 **vendor 包 path** 来(`vendor/sspf-vX.Y.Z/crates/sspf`);成员不许另写 `git` / `path` / `version` |
| **SC6** | 生成物与 `packs/*` 不漂移(复用 `pack-sync.py --check`) |
🔴 **反自证**:`--self-test` 给 6 条判据各造一个**真实违规**(抄回 `platform/`、写
+62
View File
@@ -0,0 +1,62 @@
#!/usr/bin/env bash
#
# fetch-platform.sh —— 把平台「自包含发布包」解包到 vendor/,让本仓用 path 依赖吃 sspf
#
# 背景(2026-11-05 依赖模型变更):平台仓每个版本产出一个自包含包
# `dist/sspf-vX.Y.Z.tar.gz`(预编译 sspf-admin 二进制 + 平台 crate 源码 + Cargo.lock),
# 本仓**不再直接依赖 git 仓**,而是把它解包到 vendor/ 后用 path 依赖指进去。
#
# 用法:
# 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 -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})"
echo " Cargo.toml 里应写:"
echo " sspf = { path = \"vendor/${PKG}/crates/sspf\", version = \"${VERSION%.*}\" }"
echo " 并确认 .gitignore 含 vendor/"