Fix SpacetimeDB wasm dependency boundary

server-rs/crates/api-server/Cargo.toml

@@ -36,7 +36,7 @@ platform-oss = { workspace = true }
 platform-speech = { workspace = true }
 serde = { workspace = true }
 serde_json = { workspace = true }
-shared-contracts = { workspace = true }
+shared-contracts = { workspace = true, features = ["oss-contracts"] }
 shared-kernel = { workspace = true }
 shared-logging = { workspace = true }
 spacetime-client = { workspace = true }

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

@@ -4,7 +4,12 @@ edition.workspace = true
 version.workspace = true
 license.workspace = true
 
+[features]
+# 默认给 api-server 等原生后端保留资产上传契约；SpacetimeDB WASM 路径通过 workspace 依赖关闭默认 feature。
+default = ["oss-contracts"]
+oss-contracts = ["dep:platform-oss"]
+
 [dependencies]
-platform-oss = { workspace = true }
+platform-oss = { workspace = true, optional = true }
 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,13 +1,14 @@
 pub mod admin;
 pub mod ai;
 pub mod api;
+#[cfg(feature = "oss-contracts")]
 pub mod assets;
 pub mod auth;
 pub mod big_fish;
 pub mod big_fish_works;
 pub mod creation_agent_document_input;
-pub mod creative_agent;
 pub mod creation_entry_config;
+pub mod creative_agent;
 pub mod hyper3d;
 pub mod llm;
 pub mod match3d_agent;