1

server-rs/crates/shared-contracts/Cargo.toml

@@ -4,6 +4,11 @@ edition.workspace = true
 version.workspace = true
 license.workspace = true
 
+[features]
+# 默认给 api-server 等原生后端暴露资产上传 DTO；SpacetimeDB WASM 路径通过 workspace 依赖关闭默认 feature。
+default = ["oss-contracts"]
+oss-contracts = []
+
 [dependencies]
 serde = { workspace = true }
 serde_json = { workspace = true }

server-rs/crates/shared-contracts/README.md

@@ -94,3 +94,4 @@
 1. `shared-contracts` 只放协议类型与兼容结构，不承接业务规则、供应商适配或状态写入逻辑。
 2. 各模块 crate 对外暴露的协议优先复用这里的共享定义，避免重复散落。
 3. 前端兼容契约一旦进入本 crate，就必须与任务清单和基线文档同步维护。
+4. `assets` 模块依赖 `platform-oss` 的稳定返回类型，默认通过 `oss-contracts` feature 给 `api-server` 使用；SpacetimeDB WASM 构建链路必须通过 workspace 依赖关闭默认 feature，避免把 `platform-oss` / `reqwest` / `wasm-bindgen` 带进 `spacetime-module`。

server-rs/crates/shared-contracts/src/lib.rs

@@ -1,6 +1,7 @@
 pub mod admin;
 pub mod ai;
 pub mod api;
+#[cfg(feature = "oss-contracts")]
 pub mod assets;
 pub mod auth;
 pub mod big_fish;