1

server-rs/crates/api-server/src/assets.rs

@@ -27,6 +27,13 @@ use crate::{
     state::AppState,
 };
 
+// 历史素材类型需要与 SpacetimeDB 侧白名单保持同一口径，避免新增素材类型时 HTTP 门面漏同步。
+const SUPPORTED_ASSET_HISTORY_KINDS: [&str; 3] = [
+    "character_visual",
+    "scene_image",
+    "puzzle_cover_image",
+];
+
 pub async fn create_direct_upload_ticket(
     State(state): State<AppState>,
     Extension(request_context): Extension<RequestContext>,
@@ -118,11 +125,11 @@ pub async fn get_asset_history(
     Query(query): Query<AssetHistoryQuery>,
 ) -> Result<Json<Value>, AppError> {
     let asset_kind = query.kind.trim().to_string();
-    if asset_kind != "character_visual" && asset_kind != "scene_image" {
+    if !is_supported_asset_history_kind(asset_kind.as_str()) {
         return Err(
             AppError::from_status(StatusCode::BAD_REQUEST).with_details(json!({
                 "field": "kind",
-                "message": "历史素材类型只支持 character_visual 或 scene_image",
+                "message": supported_asset_history_kind_message(),
             })),
         );
     }
@@ -288,6 +295,17 @@ fn format_asset_owner_label(owner_user_id: Option<&str>) -> String {
     format!("账号 {owner_user_id}")
 }
 
+fn is_supported_asset_history_kind(asset_kind: &str) -> bool {
+    SUPPORTED_ASSET_HISTORY_KINDS.contains(&asset_kind)
+}
+
+fn supported_asset_history_kind_message() -> String {
+    format!(
+        "历史素材类型只支持 {}",
+        SUPPORTED_ASSET_HISTORY_KINDS.join("、")
+    )
+}
+
 async fn build_confirm_asset_object_upsert_input(
     oss_client: &platform_oss::OssClient,
     payload: ConfirmAssetObjectRequest,
@@ -457,6 +475,22 @@ mod tests {
 
     type HmacSha1 = Hmac<Sha1>;
 
+    #[test]
+    fn asset_history_kind_support_includes_puzzle_cover_image() {
+        assert!(super::is_supported_asset_history_kind("character_visual"));
+        assert!(super::is_supported_asset_history_kind("scene_image"));
+        assert!(super::is_supported_asset_history_kind("puzzle_cover_image"));
+        assert!(!super::is_supported_asset_history_kind("puzzle_preview_image"));
+    }
+
+    #[test]
+    fn asset_history_kind_message_lists_all_supported_kinds() {
+        assert_eq!(
+            super::supported_asset_history_kind_message(),
+            "历史素材类型只支持 character_visual、scene_image、puzzle_cover_image"
+        );
+    }
+
     #[tokio::test]
     async fn direct_upload_ticket_returns_service_unavailable_when_oss_missing() {
         let app = build_router(AppState::new(AppConfig::default()).expect("state should build"));