1

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

@@ -1,7 +1,7 @@
 use axum::{
     Router,
     body::Body,
-    extract::Extension,
+    extract::{DefaultBodyLimit, Extension},
     http::Request,
     middleware,
     routing::{delete, get, post},
@@ -34,8 +34,9 @@ use crate::{
     auth_sessions::auth_sessions,
     big_fish::{
         create_big_fish_session, delete_big_fish_work, execute_big_fish_action,
-        get_big_fish_session, get_big_fish_works, list_big_fish_gallery, record_big_fish_play,
-        remix_big_fish_gallery_work, stream_big_fish_message, submit_big_fish_message,
+        get_big_fish_session, get_big_fish_works, list_big_fish_gallery,
+        record_big_fish_gallery_like, record_big_fish_play, remix_big_fish_gallery_work,
+        stream_big_fish_message, submit_big_fish_message,
     },
     character_animation_assets::{
         generate_character_animation, get_character_animation_job, get_character_workflow_cache,
@@ -56,9 +57,9 @@ use crate::{
         get_custom_world_gallery_detail_by_code, get_custom_world_library,
         get_custom_world_library_detail, get_custom_world_works, list_custom_world_gallery,
         publish_custom_world_library_profile, put_custom_world_library_profile,
-        record_custom_world_gallery_play, remix_custom_world_gallery_profile,
-        stream_custom_world_agent_message, submit_custom_world_agent_message,
-        unpublish_custom_world_library_profile,
+        record_custom_world_gallery_like, record_custom_world_gallery_play,
+        remix_custom_world_gallery_profile, stream_custom_world_agent_message,
+        submit_custom_world_agent_message, unpublish_custom_world_library_profile,
     },
     custom_world_ai::{
         generate_custom_world_cover_image, generate_custom_world_entity,
@@ -85,9 +86,10 @@ use crate::{
         advance_local_puzzle_next_level, advance_puzzle_next_level, create_puzzle_agent_session,
         delete_puzzle_work, execute_puzzle_agent_action, get_puzzle_agent_session,
         get_puzzle_gallery_detail, get_puzzle_run, get_puzzle_work_detail, get_puzzle_works,
-        list_puzzle_gallery, put_puzzle_work, remix_puzzle_gallery_work, start_puzzle_run,
-        stream_puzzle_agent_message, submit_puzzle_agent_message, submit_puzzle_leaderboard,
-        swap_puzzle_pieces, update_puzzle_run_pause, use_puzzle_runtime_prop,
+        list_puzzle_gallery, put_puzzle_work, record_puzzle_gallery_like,
+        remix_puzzle_gallery_work, start_puzzle_run, stream_puzzle_agent_message,
+        submit_puzzle_agent_message, submit_puzzle_leaderboard, swap_puzzle_pieces,
+        update_puzzle_run_pause, use_puzzle_runtime_prop,
     },
     refresh_session::refresh_session,
     request_context::{attach_request_context, resolve_request_id},
@@ -126,6 +128,8 @@ use crate::{
     wechat_auth::{bind_wechat_phone, handle_wechat_callback, start_wechat_login},
 };
 
+const PUZZLE_REFERENCE_IMAGE_BODY_LIMIT_BYTES: usize = 12 * 1024 * 1024;
+
 // 统一由这里构造 Axum 路由树，后续再逐项挂接中间件与业务路由。
 pub fn build_router(state: AppState) -> Router {
     let slow_request_threshold_ms = state.config.slow_request_threshold_ms;
@@ -544,6 +548,13 @@ pub fn build_router(state: AppState) -> Router {
                 require_bearer_auth,
             )),
         )
+        .route(
+            "/api/runtime/custom-world-gallery/{owner_user_id}/{profile_id}/like",
+            post(record_custom_world_gallery_like).route_layer(middleware::from_fn_with_state(
+                state.clone(),
+                require_bearer_auth,
+            )),
+        )
         .route(
             "/api/runtime/custom-world-gallery/by-code/{code}",
             get(get_custom_world_gallery_detail_by_code),
@@ -663,6 +674,13 @@ pub fn build_router(state: AppState) -> Router {
                 require_bearer_auth,
             )),
         )
+        .route(
+            "/api/runtime/big-fish/gallery/{session_id}/like",
+            post(record_big_fish_gallery_like).route_layer(middleware::from_fn_with_state(
+                state.clone(),
+                require_bearer_auth,
+            )),
+        )
         .route(
             "/api/runtime/big-fish/works/{session_id}",
             delete(delete_big_fish_work).route_layer(middleware::from_fn_with_state(
@@ -686,10 +704,15 @@ pub fn build_router(state: AppState) -> Router {
         )
         .route(
             "/api/runtime/puzzle/agent/sessions",
-            post(create_puzzle_agent_session).route_layer(middleware::from_fn_with_state(
-                state.clone(),
-                require_bearer_auth,
-            )),
+            post(create_puzzle_agent_session)
+                // 中文注释：拼图表单会携带单张参考图 Data URL，需只给该写入入口放宽 body 上限。
+                .layer(DefaultBodyLimit::max(
+                    PUZZLE_REFERENCE_IMAGE_BODY_LIMIT_BYTES,
+                ))
+                .route_layer(middleware::from_fn_with_state(
+                    state.clone(),
+                    require_bearer_auth,
+                )),
         )
         .route(
             "/api/runtime/puzzle/agent/sessions/{session_id}",
@@ -714,10 +737,15 @@ pub fn build_router(state: AppState) -> Router {
         )
         .route(
             "/api/runtime/puzzle/agent/sessions/{session_id}/actions",
-            post(execute_puzzle_agent_action).route_layer(middleware::from_fn_with_state(
-                state.clone(),
-                require_bearer_auth,
-            )),
+            post(execute_puzzle_agent_action)
+                // 中文注释：生成草稿/重新出图会复用 referenceImageSrc，避免默认 2MB JSON limit 拦截。
+                .layer(DefaultBodyLimit::max(
+                    PUZZLE_REFERENCE_IMAGE_BODY_LIMIT_BYTES,
+                ))
+                .route_layer(middleware::from_fn_with_state(
+                    state.clone(),
+                    require_bearer_auth,
+                )),
         )
         .route(
             "/api/runtime/puzzle/works",
@@ -748,6 +776,13 @@ pub fn build_router(state: AppState) -> Router {
                 require_bearer_auth,
             )),
         )
+        .route(
+            "/api/runtime/puzzle/gallery/{profile_id}/like",
+            post(record_puzzle_gallery_like).route_layer(middleware::from_fn_with_state(
+                state.clone(),
+                require_bearer_auth,
+            )),
+        )
         .route(
             "/api/runtime/puzzle/runs",
             post(start_puzzle_run).route_layer(middleware::from_fn_with_state(
@@ -1239,6 +1274,30 @@ mod tests {
             .await
     }
 
+    fn sign_test_user_token(
+        state: &AppState,
+        user: &module_auth::AuthUser,
+        session_id: &str,
+    ) -> String {
+        let claims = AccessTokenClaims::from_input(
+            AccessTokenClaimsInput {
+                user_id: user.id.clone(),
+                session_id: session_id.to_string(),
+                provider: AuthProvider::Password,
+                roles: vec!["user".to_string()],
+                token_version: user.token_version,
+                phone_verified: false,
+                binding_status: BindingStatus::Active,
+                display_name: Some(user.display_name.clone()),
+            },
+            state.auth_jwt_config(),
+            OffsetDateTime::now_utc(),
+        )
+        .expect("claims should build");
+
+        sign_access_token(&claims, state.auth_jwt_config()).expect("token should sign")
+    }
+
     async fn password_login_request(
         app: Router,
         phone_number: &str,
@@ -1496,6 +1555,88 @@ mod tests {
         );
     }
 
+    #[tokio::test]
+    async fn puzzle_agent_actions_accept_reference_image_body_above_default_limit() {
+        let state = AppState::new(AppConfig::default()).expect("state should build");
+        let seed_user = seed_phone_user_with_password(&state, "13800138024", TEST_PASSWORD).await;
+        let token = sign_test_user_token(&state, &seed_user, "sess_puzzle_reference_body");
+        let app = build_router(state);
+        let reference_image_src = format!("data:image/png;base64,{}", "A".repeat(3 * 1024 * 1024));
+        let request_body = serde_json::json!({
+            "action": "unsupported_large_reference_test",
+            "referenceImageSrc": reference_image_src,
+        })
+        .to_string();
+        assert!(request_body.len() > 2 * 1024 * 1024);
+
+        let response = app
+            .oneshot(
+                Request::builder()
+                    .method("POST")
+                    .uri("/api/runtime/puzzle/agent/sessions/puzzle-session-large/actions")
+                    .header("authorization", format!("Bearer {token}"))
+                    .header("content-type", "application/json")
+                    .body(Body::from(request_body))
+                    .expect("request should build"),
+            )
+            .await
+            .expect("request should succeed");
+
+        assert_eq!(response.status(), StatusCode::BAD_REQUEST);
+        let body = response
+            .into_body()
+            .collect()
+            .await
+            .expect("response body should collect")
+            .to_bytes();
+        let body_text = String::from_utf8_lossy(&body);
+        assert!(
+            body_text.contains("unsupported_large_reference_test"),
+            "handler should parse the oversized reference payload before rejecting the action: {body_text}"
+        );
+        assert!(!body_text.contains("length limit exceeded"));
+    }
+
+    #[tokio::test]
+    async fn puzzle_agent_session_creation_accepts_reference_image_body_above_default_limit() {
+        let state = AppState::new(AppConfig::default()).expect("state should build");
+        let seed_user = seed_phone_user_with_password(&state, "13800138025", TEST_PASSWORD).await;
+        let token = sign_test_user_token(&state, &seed_user, "sess_puzzle_form_reference_body");
+        let app = build_router(state);
+        let request_body = format!(
+            "{{\"seedText\":\"大参考图拼图\",\"pictureDescription\":\"一张用于验证 body limit 的参考图。\",\"referenceImageSrc\":\"data:image/png;base64,{}\"",
+            "A".repeat(3 * 1024 * 1024)
+        );
+        assert!(request_body.len() > 2 * 1024 * 1024);
+
+        let response = app
+            .oneshot(
+                Request::builder()
+                    .method("POST")
+                    .uri("/api/runtime/puzzle/agent/sessions")
+                    .header("authorization", format!("Bearer {token}"))
+                    .header("content-type", "application/json")
+                    .body(Body::from(request_body))
+                    .expect("request should build"),
+            )
+            .await
+            .expect("request should succeed");
+
+        assert_eq!(response.status(), StatusCode::BAD_REQUEST);
+        let body = response
+            .into_body()
+            .collect()
+            .await
+            .expect("response body should collect")
+            .to_bytes();
+        let body_text = String::from_utf8_lossy(&body);
+        assert!(
+            body_text.contains("EOF") || body_text.contains("expected"),
+            "handler should parse the oversized form payload before rejecting malformed JSON: {body_text}"
+        );
+        assert!(!body_text.contains("length limit exceeded"));
+    }
+
     #[tokio::test]
     async fn password_entry_rejects_unknown_phone_without_registration() {
         let app = build_router(AppState::new(AppConfig::default()).expect("state should build"));

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

@@ -85,8 +85,13 @@ async fn refund_asset_operation_points(
 }
 
 pub(crate) fn map_asset_operation_wallet_error(error: SpacetimeClientError) -> AppError {
+    let message = error.to_string();
+    tracing::warn!(
+        provider = "profile-wallet",
+        error = %message,
+        "资产操作陶泥币预扣失败"
+    );
     let status = match &error {
-        SpacetimeClientError::Runtime(_) => StatusCode::BAD_REQUEST,
         SpacetimeClientError::Procedure(message) if message.contains("陶泥币余额不足") => {
             StatusCode::CONFLICT
         }
@@ -95,7 +100,7 @@ pub(crate) fn map_asset_operation_wallet_error(error: SpacetimeClientError) -> A
 
     AppError::from_status(status).with_details(json!({
         "provider": "profile-wallet",
-        "message": error.to_string(),
+        "message": message,
     }))
 }
 

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

@@ -33,9 +33,10 @@ use spacetime_client::{
     BigFishAgentMessageRecord, BigFishAnchorItemRecord, BigFishAnchorPackRecord,
     BigFishAssetCoverageRecord, BigFishAssetGenerateRecordInput, BigFishAssetSlotRecord,
     BigFishBackgroundBlueprintRecord, BigFishDraftCompileRecordInput, BigFishGameDraftRecord,
-    BigFishLevelBlueprintRecord, BigFishMessageSubmitRecordInput, BigFishPlayReportRecordInput,
-    BigFishRuntimeParamsRecord, BigFishSessionCreateRecordInput, BigFishSessionRecord,
-    BigFishWorkRemixRecordInput, BigFishWorkSummaryRecord, SpacetimeClientError,
+    BigFishLevelBlueprintRecord, BigFishLikeReportRecordInput, BigFishMessageSubmitRecordInput,
+    BigFishPlayReportRecordInput, BigFishRuntimeParamsRecord, BigFishSessionCreateRecordInput,
+    BigFishSessionRecord, BigFishWorkRemixRecordInput, BigFishWorkSummaryRecord,
+    SpacetimeClientError,
 };
 use tokio::time::sleep;
 
@@ -60,6 +61,7 @@ use crate::{
     http_error::AppError,
     request_context::RequestContext,
     state::AppState,
+    work_author::resolve_work_author_by_user_id,
 };
 
 pub async fn create_big_fish_session(
@@ -144,7 +146,7 @@ pub async fn get_big_fish_works(
         BigFishWorksResponse {
             items: items
                 .into_iter()
-                .map(map_big_fish_work_summary_response)
+                .map(|item| map_big_fish_work_summary_response(&state, item))
                 .collect(),
         },
     ))
@@ -176,7 +178,7 @@ pub async fn list_big_fish_gallery(
         BigFishWorksResponse {
             items: items
                 .into_iter()
-                .map(map_big_fish_work_summary_response)
+                .map(|item| map_big_fish_work_summary_response(&state, item))
                 .collect(),
         },
     ))
@@ -203,7 +205,7 @@ pub async fn delete_big_fish_work(
         BigFishWorksResponse {
             items: items
                 .into_iter()
-                .map(map_big_fish_work_summary_response)
+                .map(|item| map_big_fish_work_summary_response(&state, item))
                 .collect(),
         },
     ))
@@ -245,7 +247,38 @@ pub async fn record_big_fish_play(
         BigFishWorksResponse {
             items: items
                 .into_iter()
-                .map(map_big_fish_work_summary_response)
+                .map(|item| map_big_fish_work_summary_response(&state, item))
+                .collect(),
+        },
+    ))
+}
+
+pub async fn record_big_fish_gallery_like(
+    State(state): State<AppState>,
+    Path(session_id): Path<String>,
+    Extension(request_context): Extension<RequestContext>,
+    Extension(authenticated): Extension<AuthenticatedAccessToken>,
+) -> Result<Json<Value>, Response> {
+    ensure_non_empty(&request_context, &session_id, "sessionId")?;
+
+    let items = state
+        .spacetime_client()
+        .record_big_fish_like(BigFishLikeReportRecordInput {
+            session_id,
+            user_id: authenticated.claims().user_id().to_string(),
+            liked_at_micros: current_utc_micros(),
+        })
+        .await
+        .map_err(|error| {
+            big_fish_error_response(&request_context, map_big_fish_client_error(error))
+        })?;
+
+    Ok(json_success_body(
+        Some(&request_context),
+        BigFishWorksResponse {
+            items: items
+                .into_iter()
+                .map(|item| map_big_fish_work_summary_response(&state, item))
                 .collect(),
         },
     ))
@@ -924,12 +957,15 @@ fn map_big_fish_agent_message_response(
 }
 
 fn map_big_fish_work_summary_response(
+    state: &AppState,
     item: BigFishWorkSummaryRecord,
 ) -> BigFishWorkSummaryResponse {
+    let author = resolve_work_author_by_user_id(state, &item.owner_user_id, None, None);
     BigFishWorkSummaryResponse {
         work_id: item.work_id,
         source_session_id: item.source_session_id,
         owner_user_id: item.owner_user_id,
+        author_display_name: author.display_name,
         title: item.title,
         subtitle: item.subtitle,
         summary: item.summary,

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

@@ -7,6 +7,7 @@ use serde::Deserialize;
 use serde_json::Value as JsonValue;
 
 use crate::creation_agent_llm_turn::parse_json_response_text;
+use crate::llm_model_routing::CREATION_TEMPLATE_LLM_MODEL;
 
 const BIG_FISH_DRAFT_JSON_ONLY_SYSTEM_PROMPT: &str = r#"你是一个负责把“大鱼吃小鱼”玩法锚点编译成首版可实现草稿的中文玩法策划。
 
@@ -108,10 +109,15 @@ async fn request_big_fish_json_stage(
     empty_response_message: &str,
 ) -> Result<JsonValue, BigFishDraftCompileError> {
     let response = llm_client
-        .request_text(LlmTextRequest::new(vec![
-            LlmMessage::system(BIG_FISH_DRAFT_JSON_ONLY_SYSTEM_PROMPT),
-            LlmMessage::user(user_prompt),
-        ]))
+        .request_text(
+            LlmTextRequest::new(vec![
+                LlmMessage::system(BIG_FISH_DRAFT_JSON_ONLY_SYSTEM_PROMPT),
+                LlmMessage::user(user_prompt),
+            ])
+            .with_model(CREATION_TEMPLATE_LLM_MODEL)
+            .with_responses_api()
+            .with_web_search(true),
+        )
         .await
         .map_err(|error| {
             BigFishDraftCompileError::new(format!("{debug_label} LLM 请求失败：{error}"))
@@ -124,12 +130,16 @@ async fn request_big_fish_json_stage(
         Ok(value) => Ok(value),
         Err(_) => {
             let repaired = llm_client
-                .request_text(LlmTextRequest::new(vec![
-                    LlmMessage::system(BIG_FISH_DRAFT_JSON_REPAIR_SYSTEM_PROMPT),
-                    LlmMessage::user(format!(
-                        "请把下面这段文本修复成单个合法 JSON 对象，不要补充额外解释：\n\n{text}"
-                    )),
-                ]))
+                .request_text(
+                    LlmTextRequest::new(vec![
+                        LlmMessage::system(BIG_FISH_DRAFT_JSON_REPAIR_SYSTEM_PROMPT),
+                        LlmMessage::user(format!(
+                            "请把下面这段文本修复成单个合法 JSON 对象，不要补充额外解释：\n\n{text}"
+                        )),
+                    ])
+                    .with_model(CREATION_TEMPLATE_LLM_MODEL)
+                    .with_responses_api(),
+                )
                 .await
                 .map_err(|error| {
                     BigFishDraftCompileError::new(format!(

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

@@ -1,6 +1,8 @@
 use platform_llm::{LlmClient, LlmMessage, LlmStreamDelta, LlmTextRequest};
 use serde_json::Value as JsonValue;
 
+use crate::llm_model_routing::CREATION_TEMPLATE_LLM_MODEL;
+
 #[derive(Clone, Copy, Debug)]
 pub(crate) struct CreationAgentLlmTurnErrorMessages<'a> {
     pub model_unavailable: &'a str,
@@ -69,6 +71,8 @@ fn build_creation_agent_llm_request(
         LlmMessage::system(system_prompt),
         LlmMessage::user(user_prompt),
     ])
+    .with_model(CREATION_TEMPLATE_LLM_MODEL)
+    .with_responses_api()
     .with_web_search(enable_web_search)
 }
 
@@ -79,10 +83,14 @@ pub(crate) async fn request_creation_agent_json_turn<E>(
     build_error: impl Fn(String) -> E,
 ) -> Result<JsonValue, E> {
     let response = llm_client
-        .request_text(LlmTextRequest::new(vec![
-            LlmMessage::system(system_prompt),
-            LlmMessage::user(user_prompt),
-        ]))
+        .request_text(
+            LlmTextRequest::new(vec![
+                LlmMessage::system(system_prompt),
+                LlmMessage::user(user_prompt),
+            ])
+            .with_model(CREATION_TEMPLATE_LLM_MODEL)
+            .with_responses_api(),
+        )
         .await
         .map_err(|error| build_error(error.to_string()))?;
     parse_json_response_text(response.content.as_str())
@@ -160,6 +168,8 @@ fn read_reply_text(parsed: &JsonValue) -> Option<String> {
 
 #[cfg(test)]
 mod tests {
+    use crate::llm_model_routing::CREATION_TEMPLATE_LLM_MODEL;
+
     use super::{
         build_creation_agent_llm_request, extract_reply_text_from_partial_json,
         parse_json_response_text,
@@ -188,6 +198,8 @@ mod tests {
             build_creation_agent_llm_request("系统提示".to_string(), "用户提示".to_string(), true);
 
         assert!(request.enable_web_search);
+        assert_eq!(request.model.as_deref(), Some(CREATION_TEMPLATE_LLM_MODEL));
+        assert_eq!(request.protocol, platform_llm::LlmTextProtocol::Responses);
         assert_eq!(request.messages.len(), 2);
     }
 }

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

@@ -38,10 +38,10 @@ use spacetime_client::{
     CustomWorldAgentSessionRecord, CustomWorldDraftCardDetailRecord,
     CustomWorldDraftCardDetailSectionRecord, CustomWorldDraftCardRecord,
     CustomWorldGalleryEntryRecord, CustomWorldLibraryEntryRecord,
-    CustomWorldProfilePlayReportRecordInput, CustomWorldProfileRemixRecordInput,
-    CustomWorldProfileUpsertRecordInput, CustomWorldPublishGateRecord,
-    CustomWorldResultPreviewBlockerRecord, CustomWorldSupportedActionRecord,
-    CustomWorldWorkSummaryRecord, SpacetimeClientError,
+    CustomWorldProfileLikeReportRecordInput, CustomWorldProfilePlayReportRecordInput,
+    CustomWorldProfileRemixRecordInput, CustomWorldProfileUpsertRecordInput,
+    CustomWorldPublishGateRecord, CustomWorldResultPreviewBlockerRecord,
+    CustomWorldSupportedActionRecord, CustomWorldWorkSummaryRecord, SpacetimeClientError,
 };
 use std::{collections::BTreeSet, convert::Infallible, sync::Arc, time::Instant};
 use time::{OffsetDateTime, format_description::well_known::Rfc3339};
@@ -73,6 +73,7 @@ use crate::{
     },
     request_context::RequestContext,
     state::AppState,
+    work_author::resolve_work_author_by_user_id,
 };
 
 const DRAFT_ASSET_GENERATION_MAX_ATTEMPTS: u32 = 3;
@@ -414,7 +415,6 @@ pub async fn get_custom_world_library(
     Extension(authenticated): Extension<AuthenticatedAccessToken>,
 ) -> Result<Json<Value>, Response> {
     let owner_user_id = authenticated.claims().user_id().to_string();
-    let author_display_name = resolve_author_display_name(&state, &authenticated);
     let entries = state
         .spacetime_client()
         .list_custom_world_works(owner_user_id.clone())
@@ -430,9 +430,9 @@ pub async fn get_custom_world_library(
                 .into_iter()
                 .filter_map(|item| {
                     map_custom_world_library_entry_response_from_work_summary(
+                        &state,
                         item,
                         &owner_user_id,
-                        &author_display_name,
                     )
                 })
                 .collect(),
@@ -467,7 +467,7 @@ pub async fn get_custom_world_library_detail(
     Ok(json_success_body(
         Some(&request_context),
         CustomWorldGalleryDetailResponse {
-            entry: map_custom_world_library_entry_response(detail.entry),
+            entry: map_custom_world_library_entry_response(&state, detail.entry),
         },
     ))
 }
@@ -548,8 +548,11 @@ pub async fn put_custom_world_library_profile(
     Ok(json_success_body(
         Some(&request_context),
         CustomWorldLibraryMutationResponse {
-            entry: map_custom_world_library_entry_response(mutation.entry.clone()),
-            entries: vec![map_custom_world_library_entry_response(mutation.entry)],
+            entry: map_custom_world_library_entry_response(&state, mutation.entry.clone()),
+            entries: vec![map_custom_world_library_entry_response(
+                &state,
+                mutation.entry,
+            )],
         },
     ))
 }
@@ -584,7 +587,7 @@ pub async fn delete_custom_world_library_profile(
         CustomWorldLibraryResponse {
             entries: entries
                 .into_iter()
-                .map(map_custom_world_library_entry_response)
+                .map(|entry| map_custom_world_library_entry_response(&state, entry))
                 .collect(),
         },
     ))
@@ -636,8 +639,11 @@ pub async fn publish_custom_world_library_profile(
     Ok(json_success_body(
         Some(&request_context),
         CustomWorldLibraryMutationResponse {
-            entry: map_custom_world_library_entry_response(mutation.entry.clone()),
-            entries: vec![map_custom_world_library_entry_response(mutation.entry)],
+            entry: map_custom_world_library_entry_response(&state, mutation.entry.clone()),
+            entries: vec![map_custom_world_library_entry_response(
+                &state,
+                mutation.entry,
+            )],
         },
     ))
 }
@@ -675,8 +681,11 @@ pub async fn unpublish_custom_world_library_profile(
     Ok(json_success_body(
         Some(&request_context),
         CustomWorldLibraryMutationResponse {
-            entry: map_custom_world_library_entry_response(mutation.entry.clone()),
-            entries: vec![map_custom_world_library_entry_response(mutation.entry)],
+            entry: map_custom_world_library_entry_response(&state, mutation.entry.clone()),
+            entries: vec![map_custom_world_library_entry_response(
+                &state,
+                mutation.entry,
+            )],
         },
     ))
 }
@@ -698,7 +707,7 @@ pub async fn list_custom_world_gallery(
         CustomWorldGalleryResponse {
             entries: entries
                 .into_iter()
-                .map(map_custom_world_gallery_card_response)
+                .map(|entry| map_custom_world_gallery_card_response(&state, entry))
                 .collect(),
         },
     ))
@@ -730,7 +739,7 @@ pub async fn get_custom_world_gallery_detail(
     Ok(json_success_body(
         Some(&request_context),
         CustomWorldGalleryDetailResponse {
-            entry: map_custom_world_library_entry_response(detail.entry),
+            entry: map_custom_world_library_entry_response(&state, detail.entry),
         },
     ))
 }
@@ -761,7 +770,7 @@ pub async fn get_custom_world_gallery_detail_by_code(
     Ok(json_success_body(
         Some(&request_context),
         CustomWorldGalleryDetailResponse {
-            entry: map_custom_world_library_entry_response(detail.entry),
+            entry: map_custom_world_library_entry_response(&state, detail.entry),
         },
     ))
 }
@@ -800,8 +809,11 @@ pub async fn remix_custom_world_gallery_profile(
     Ok(json_success_body(
         Some(&request_context),
         CustomWorldLibraryMutationResponse {
-            entry: map_custom_world_library_entry_response(mutation.entry.clone()),
-            entries: vec![map_custom_world_library_entry_response(mutation.entry)],
+            entry: map_custom_world_library_entry_response(&state, mutation.entry.clone()),
+            entries: vec![map_custom_world_library_entry_response(
+                &state,
+                mutation.entry,
+            )],
         },
     ))
 }
@@ -837,7 +849,44 @@ pub async fn record_custom_world_gallery_play(
     Ok(json_success_body(
         Some(&request_context),
         CustomWorldGalleryDetailResponse {
-            entry: map_custom_world_library_entry_response(mutation.entry),
+            entry: map_custom_world_library_entry_response(&state, mutation.entry),
+        },
+    ))
+}
+
+pub async fn record_custom_world_gallery_like(
+    State(state): State<AppState>,
+    Path((owner_user_id, profile_id)): Path<(String, String)>,
+    Extension(request_context): Extension<RequestContext>,
+    Extension(authenticated): Extension<AuthenticatedAccessToken>,
+) -> Result<Json<Value>, Response> {
+    if owner_user_id.trim().is_empty() || profile_id.trim().is_empty() {
+        return Err(custom_world_error_response(
+            &request_context,
+            AppError::from_status(StatusCode::BAD_REQUEST).with_details(json!({
+                "provider": "custom-world-gallery",
+                "message": "ownerUserId and profileId are required",
+            })),
+        ));
+    }
+
+    let mutation = state
+        .spacetime_client()
+        .record_custom_world_profile_like(CustomWorldProfileLikeReportRecordInput {
+            owner_user_id,
+            profile_id,
+            user_id: authenticated.claims().user_id().to_string(),
+            liked_at_micros: current_utc_micros(),
+        })
+        .await
+        .map_err(|error| {
+            custom_world_error_response(&request_context, map_custom_world_client_error(error))
+        })?;
+
+    Ok(json_success_body(
+        Some(&request_context),
+        CustomWorldGalleryDetailResponse {
+            entry: map_custom_world_library_entry_response(&state, mutation.entry),
         },
     ))
 }
@@ -2697,18 +2746,25 @@ async fn upsert_custom_world_draft_foundation_progress(
 }
 
 fn map_custom_world_library_entry_response(
+    state: &AppState,
     entry: CustomWorldLibraryEntryRecord,
 ) -> CustomWorldLibraryEntryResponse {
+    let author = resolve_work_author_by_user_id(
+        state,
+        &entry.owner_user_id,
+        Some(&entry.author_display_name),
+        entry.author_public_user_code.as_deref(),
+    );
     CustomWorldLibraryEntryResponse {
         owner_user_id: entry.owner_user_id,
         profile_id: entry.profile_id,
         public_work_code: entry.public_work_code,
-        author_public_user_code: entry.author_public_user_code,
+        author_public_user_code: author.public_user_code.or(entry.author_public_user_code),
         profile: entry.profile,
         visibility: entry.visibility,
         published_at: entry.published_at,
         updated_at: entry.updated_at,
-        author_display_name: entry.author_display_name,
+        author_display_name: author.display_name,
         world_name: entry.world_name,
         subtitle: entry.subtitle,
         summary_text: entry.summary_text,
@@ -2724,23 +2780,24 @@ fn map_custom_world_library_entry_response(
 }
 
 fn map_custom_world_library_entry_response_from_work_summary(
+    state: &AppState,
     item: CustomWorldWorkSummaryRecord,
     owner_user_id: &str,
-    author_display_name: &str,
 ) -> Option<CustomWorldLibraryEntryResponse> {
     let profile_id = item.profile_id.as_ref()?.clone();
     let profile = build_custom_world_library_list_profile_payload(&item, &profile_id);
+    let author = resolve_work_author_by_user_id(state, owner_user_id, None, None);
     Some(CustomWorldLibraryEntryResponse {
         owner_user_id: owner_user_id.to_string(),
         public_work_code: (item.status == "published")
             .then(|| build_public_work_code_from_profile_id(&profile_id)),
         profile_id,
-        author_public_user_code: None,
+        author_public_user_code: author.public_user_code,
         profile,
         visibility: item.status,
         published_at: item.published_at,
         updated_at: item.updated_at,
-        author_display_name: author_display_name.to_string(),
+        author_display_name: author.display_name,
         world_name: item.title,
         subtitle: item.subtitle,
         summary_text: item.summary,
@@ -2803,17 +2860,26 @@ fn build_custom_world_library_list_profile_payload(
 }
 
 fn map_custom_world_gallery_card_response(
+    state: &AppState,
     entry: CustomWorldGalleryEntryRecord,
 ) -> CustomWorldGalleryCardResponse {
+    let author = resolve_work_author_by_user_id(
+        state,
+        &entry.owner_user_id,
+        Some(&entry.author_display_name),
+        Some(&entry.author_public_user_code),
+    );
     CustomWorldGalleryCardResponse {
         owner_user_id: entry.owner_user_id,
         profile_id: entry.profile_id,
         public_work_code: entry.public_work_code,
-        author_public_user_code: entry.author_public_user_code,
+        author_public_user_code: author
+            .public_user_code
+            .unwrap_or(entry.author_public_user_code),
         visibility: entry.visibility,
         published_at: entry.published_at,
         updated_at: entry.updated_at,
-        author_display_name: entry.author_display_name,
+        author_display_name: author.display_name,
         world_name: entry.world_name,
         subtitle: entry.subtitle,
         summary_text: entry.summary_text,

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

@@ -1,6 +1,8 @@
 use platform_llm::{LlmClient, LlmMessage, LlmTextRequest};
 use serde_json::{Map as JsonMap, Value as JsonValue};
 use shared_contracts::runtime::ExecuteCustomWorldAgentActionRequest;
+
+use crate::llm_model_routing::CREATION_TEMPLATE_LLM_MODEL;
 use spacetime_client::CustomWorldAgentSessionRecord;
 
 const CUSTOM_WORLD_AGENT_CHARACTER_EXPANSION_SYSTEM_PROMPT: &str =
@@ -92,10 +94,15 @@ pub async fn generate_custom_world_agent_entities(
     };
 
     let response = llm_client
-        .request_text(LlmTextRequest::new(vec![
-            LlmMessage::system(system_prompt),
-            LlmMessage::user(user_prompt),
-        ]))
+        .request_text(
+            LlmTextRequest::new(vec![
+                LlmMessage::system(system_prompt),
+                LlmMessage::user(user_prompt),
+            ])
+            .with_model(CREATION_TEMPLATE_LLM_MODEL)
+            .with_responses_api()
+            .with_web_search(true),
+        )
         .await
         .map_err(|error| format!("{action} LLM 请求失败：{error}"))?;
     let generated_entities = parse_json_array_response(response.content.as_str())

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

@@ -35,6 +35,7 @@ use crate::{
         build_result_scene_npc_system_prompt, build_result_scene_npc_user_prompt,
     },
     http_error::AppError,
+    llm_model_routing::CREATION_TEMPLATE_LLM_MODEL,
     prompt::scene_background::{
         DEFAULT_CUSTOM_WORLD_SCENE_IMAGE_NEGATIVE_PROMPT, SceneImagePromptLandmark,
         SceneImagePromptParams, SceneImagePromptProfile, build_custom_world_scene_image_prompt,
@@ -1039,7 +1040,10 @@ async fn generate_entity_with_fallback(state: &AppState, profile: &Value, kind:
     let request = LlmTextRequest::new(vec![
         LlmMessage::system(build_result_entity_system_prompt()),
         LlmMessage::user(build_result_entity_user_prompt(profile, kind, &fallback)),
-    ]);
+    ])
+    .with_model(CREATION_TEMPLATE_LLM_MODEL)
+    .with_responses_api()
+    .with_web_search(true);
 
     llm_client
         .request_text(request)
@@ -1065,7 +1069,10 @@ async fn generate_scene_npc_with_fallback(
             landmark_id,
             &fallback,
         )),
-    ]);
+    ])
+    .with_model(CREATION_TEMPLATE_LLM_MODEL)
+    .with_responses_api()
+    .with_web_search(true);
 
     llm_client
         .request_text(request)

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

@@ -11,6 +11,8 @@ use serde_json::{Map as JsonMap, Value as JsonValue, json};
 use shared_contracts::runtime::ExecuteCustomWorldAgentActionRequest;
 use spacetime_client::CustomWorldAgentSessionRecord;
 
+use crate::llm_model_routing::CREATION_TEMPLATE_LLM_MODEL;
+
 #[derive(Clone, Debug, PartialEq, Eq)]
 pub struct CustomWorldFoundationDraftResult {
     pub draft_profile_json: String,
@@ -174,10 +176,15 @@ where
     F: Fn(&str) -> String,
 {
     let response = llm_client
-        .request_text(LlmTextRequest::new(vec![
-            LlmMessage::system(FOUNDATION_JSON_ONLY_SYSTEM_PROMPT),
-            LlmMessage::user(user_prompt),
-        ]))
+        .request_text(
+            LlmTextRequest::new(vec![
+                LlmMessage::system(FOUNDATION_JSON_ONLY_SYSTEM_PROMPT),
+                LlmMessage::user(user_prompt),
+            ])
+            .with_model(CREATION_TEMPLATE_LLM_MODEL)
+            .with_responses_api()
+            .with_web_search(true),
+        )
         .await
         .map_err(|error| format!("{debug_label} LLM 请求失败：{error}"))?;
     let text = response.content.trim();
@@ -188,10 +195,14 @@ where
         Ok(value) => Ok(value),
         Err(_) => {
             let repaired = llm_client
-                .request_text(LlmTextRequest::new(vec![
-                    LlmMessage::system(FOUNDATION_JSON_REPAIR_SYSTEM_PROMPT),
-                    LlmMessage::user(repair_prompt_builder(text)),
-                ]))
+                .request_text(
+                    LlmTextRequest::new(vec![
+                        LlmMessage::system(FOUNDATION_JSON_REPAIR_SYSTEM_PROMPT),
+                        LlmMessage::user(repair_prompt_builder(text)),
+                    ])
+                    .with_model(CREATION_TEMPLATE_LLM_MODEL)
+                    .with_responses_api(),
+                )
                 .await
                 .map_err(|error| format!("{repair_debug_label} LLM 请求失败：{error}"))?;
             parse_json_response_text(repaired.content.as_str())

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

@@ -4,7 +4,7 @@ use axum::{
     http::StatusCode,
     response::Response,
 };
-use platform_llm::{LlmError, LlmMessage, LlmMessageRole, LlmTextRequest};
+use platform_llm::{LlmError, LlmMessage, LlmMessageRole, LlmTextProtocol, LlmTextRequest};
 use serde_json::Value;
 use shared_contracts::llm::{
     LlmChatCompletionRequest, LlmChatCompletionResponse, LlmChatMessagePayload, LlmChatMessageRole,
@@ -39,6 +39,7 @@ pub async fn proxy_llm_chat_completions(
 
     let request = LlmTextRequest {
         model: payload.model,
+        protocol: LlmTextProtocol::ChatCompletions,
         messages: payload
             .messages
             .into_iter()

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

@@ -0,0 +1,2 @@
+pub(crate) const RPG_STORY_LLM_MODEL: &str = "doubao-seed-character-251128";
+pub(crate) const CREATION_TEMPLATE_LLM_MODEL: &str = "deepseek-v3-2-251201";

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

@@ -36,6 +36,7 @@ mod health;
 mod http_error;
 mod legacy_generated_assets;
 mod llm;
+mod llm_model_routing;
 mod login_options;
 mod logout;
 mod logout_all;
@@ -63,6 +64,7 @@ mod story_battles;
 mod story_sessions;
 mod wechat_auth;
 mod wechat_provider;
+mod work_author;
 
 use shared_logging::init_tracing;
 use tokio::net::TcpListener;

server-rs/crates/api-server/src/prompt/mod.rs

@@ -1,7 +1,7 @@
 pub(crate) mod big_fish;
 pub(crate) mod character_animation;
 pub(crate) mod character_visual;
-pub(crate) mod puzzle_image;
+pub(crate) mod puzzle;
 pub(crate) mod rpg;
 pub(crate) mod scene_background;
 

server-rs/crates/api-server/src/prompt/puzzle/agent_chat.rs

@@ -0,0 +1,212 @@
+use module_puzzle::{PuzzleAnchorPack, PuzzleAnchorStatus, empty_anchor_pack};
+use serde_json::{Value as JsonValue, json};
+use spacetime_client::{
+    PuzzleAgentMessageRecord, PuzzleAgentSessionRecord, PuzzleAnchorPackRecord,
+};
+
+use crate::creation_agent_anchor_templates::{
+    get_creation_agent_anchor_template, render_anchor_question_block,
+};
+use crate::creation_agent_chat::render_quick_fill_extra_rules;
+
+/// 拼图共创 Agent 的系统提示词。
+///
+/// 这里作为拼图聊天提示词主源，业务文件只负责调用 LLM、解析结果和写回状态。
+pub(crate) const PUZZLE_AGENT_SYSTEM_PROMPT: &str = r#"你是一个负责和陶泥主共创拼图画面的中文创意策划。
+
+你要帮助用户把一句灵感逐步收束成可以发布成拼图关卡的视觉方案。
+
+你必须同时输出：
+1. 一段直接发给用户的中文回复 replyText
+2. 当前进度 progressPercent
+3. 下一轮完整可用的 nextAnchorPack
+
+硬约束：
+1. 只能输出 JSON，不能输出代码块或解释
+2. nextAnchorPack 必须是完整对象，不能只输出 patch
+3. replyText 必须是自然中文，不能提“字段”“锚点”“结构”“JSON”等内部词
+4. replyText 一次最多推进一个最关键问题
+5. 如果用户已经给出明确方向，就优先吸收和收束，不要机械反问
+6. progressPercent 范围只能是 0 到 100
+7. status 只能使用 missing / inferred / confirmed / locked
+"#;
+
+/// 拼图共创 Agent 单轮 JSON 输出契约。
+const PUZZLE_AGENT_OUTPUT_CONTRACT: &str = r#"请严格按以下 JSON 输出，不要输出其他文字：
+{
+  "replyText": "",
+  "progressPercent": 0,
+  "nextAnchorPack": {
+    "themePromise": {
+      "key": "themePromise",
+      "label": "题材承诺",
+      "value": "",
+      "status": "missing"
+    },
+    "visualSubject": {
+      "key": "visualSubject",
+      "label": "画面主体",
+      "value": "",
+      "status": "missing"
+    },
+    "visualMood": {
+      "key": "visualMood",
+      "label": "视觉气质",
+      "value": "",
+      "status": "missing"
+    },
+    "compositionHooks": {
+      "key": "compositionHooks",
+      "label": "拼图记忆点",
+      "value": "",
+      "status": "missing"
+    },
+    "tagsAndForbidden": {
+      "key": "tagsAndForbidden",
+      "label": "标签与禁忌",
+      "value": "",
+      "status": "missing"
+    }
+  }
+}"#;
+
+/// 拼图共创 Agent 的用户提示词，用于触发模型按系统约定返回单轮 JSON。
+pub(crate) const PUZZLE_AGENT_JSON_TURN_USER_PROMPT: &str = "请按约定输出这一轮的 JSON。";
+
+/// 拼图草稿生成对话提示词脚本。
+pub(crate) fn build_puzzle_agent_prompt(
+    session: &PuzzleAgentSessionRecord,
+    quick_fill_requested: bool,
+) -> String {
+    let anchor_question_block = get_creation_agent_anchor_template("puzzle")
+        .map(render_anchor_question_block)
+        .unwrap_or_else(|| "模板目标：收束成可以发布为拼图关卡的视觉方案。".to_string());
+    let quick_fill_rules = if quick_fill_requested {
+        format!(
+            "\n\n{}",
+            render_quick_fill_extra_rules(
+                "当前题材方向里的拼图关键词",
+                "不要要求用户再提供素材、风格或禁忌",
+                "输出完整 nextAnchorPack，直接补齐 value 为空或 status 为 missing 的项",
+                "生成结果页",
+            )
+        )
+    } else {
+        String::new()
+    };
+    format!(
+        "{anchor_question_block}{quick_fill_rules}\n\n当前是第 {turn} 轮，当前进度 {progress}% 。\n\n是否要求自动补充剩余关键字：{quick_fill_requested_text}\n\n当前 anchor pack：\n{anchor_pack}\n\n最近聊天记录：\n{chat_history}\n\n{contract}",
+        anchor_question_block = anchor_question_block,
+        quick_fill_rules = quick_fill_rules,
+        turn = session.current_turn.saturating_add(1),
+        progress = session.progress_percent,
+        quick_fill_requested_text = if quick_fill_requested { "是" } else { "否" },
+        anchor_pack = serialize_puzzle_record_anchor_pack(&session.anchor_pack),
+        chat_history =
+            serde_json::to_string_pretty(&build_chat_history(session.messages.as_slice()))
+                .unwrap_or_else(|_| "[]".to_string()),
+        contract = PUZZLE_AGENT_OUTPUT_CONTRACT,
+    )
+}
+
+/// 将 SpacetimeDB 记录态锚点序列化成提示词可读 JSON。
+pub(crate) fn serialize_puzzle_record_anchor_pack(record: &PuzzleAnchorPackRecord) -> String {
+    serde_json::to_string_pretty(&map_puzzle_record_anchor_pack(record)).unwrap_or_else(|_| {
+        serde_json::to_string_pretty(&empty_anchor_pack()).unwrap_or_else(|_| "{}".to_string())
+    })
+}
+
+fn build_chat_history(messages: &[PuzzleAgentMessageRecord]) -> Vec<JsonValue> {
+    messages
+        .iter()
+        .map(|message| {
+            json!({
+                "role": message.role,
+                "kind": message.kind,
+                "content": message.text,
+            })
+        })
+        .collect()
+}
+
+fn map_puzzle_record_anchor_pack(record: &PuzzleAnchorPackRecord) -> PuzzleAnchorPack {
+    PuzzleAnchorPack {
+        theme_promise: map_puzzle_record_anchor_item(&record.theme_promise),
+        visual_subject: map_puzzle_record_anchor_item(&record.visual_subject),
+        visual_mood: map_puzzle_record_anchor_item(&record.visual_mood),
+        composition_hooks: map_puzzle_record_anchor_item(&record.composition_hooks),
+        tags_and_forbidden: map_puzzle_record_anchor_item(&record.tags_and_forbidden),
+    }
+}
+
+fn map_puzzle_record_anchor_item(
+    record: &spacetime_client::PuzzleAnchorItemRecord,
+) -> module_puzzle::PuzzleAnchorItem {
+    module_puzzle::PuzzleAnchorItem {
+        key: record.key.clone(),
+        label: record.label.clone(),
+        value: record.value.clone(),
+        status: parse_puzzle_anchor_status(record.status.as_str()),
+    }
+}
+
+fn parse_puzzle_anchor_status(value: &str) -> PuzzleAnchorStatus {
+    match value {
+        "confirmed" => PuzzleAnchorStatus::Confirmed,
+        "locked" => PuzzleAnchorStatus::Locked,
+        "inferred" => PuzzleAnchorStatus::Inferred,
+        _ => PuzzleAnchorStatus::Missing,
+    }
+}
+
+#[cfg(test)]
+mod tests {
+    use super::build_puzzle_agent_prompt;
+
+    fn anchor_item(
+        key: &str,
+        label: &str,
+        value: &str,
+        status: &str,
+    ) -> spacetime_client::PuzzleAnchorItemRecord {
+        spacetime_client::PuzzleAnchorItemRecord {
+            key: key.to_string(),
+            label: label.to_string(),
+            value: value.to_string(),
+            status: status.to_string(),
+        }
+    }
+
+    fn empty_session_record() -> spacetime_client::PuzzleAgentSessionRecord {
+        spacetime_client::PuzzleAgentSessionRecord {
+            session_id: "puzzle-session-test".to_string(),
+            seed_text: "雨夜猫咪遗迹".to_string(),
+            current_turn: 2,
+            progress_percent: 60,
+            stage: "collecting_anchors".to_string(),
+            anchor_pack: spacetime_client::PuzzleAnchorPackRecord {
+                theme_promise: anchor_item("themePromise", "题材承诺", "雨夜猫咪遗迹", "confirmed"),
+                visual_subject: anchor_item("visualSubject", "画面主体", "", "missing"),
+                visual_mood: anchor_item("visualMood", "视觉气质", "", "missing"),
+                composition_hooks: anchor_item("compositionHooks", "拼图记忆点", "", "missing"),
+                tags_and_forbidden: anchor_item("tagsAndForbidden", "标签与禁忌", "", "missing"),
+            },
+            draft: None,
+            messages: Vec::new(),
+            last_assistant_reply: None,
+            published_profile_id: None,
+            suggested_actions: Vec::new(),
+            result_preview: None,
+            updated_at: "2026-04-24T10:00:00.000Z".to_string(),
+        }
+    }
+
+    #[test]
+    fn quick_fill_prompt_forbids_follow_up_questions() {
+        let prompt = build_puzzle_agent_prompt(&empty_session_record(), true);
+
+        assert!(prompt.contains("用户刚刚主动要求你自动补充剩余关键字"));
+        assert!(prompt.contains("不要再继续提问"));
+        assert!(prompt.contains("progressPercent 直接输出为 100"));
+    }
+}

server-rs/crates/api-server/src/prompt/puzzle/image.rs

@@ -0,0 +1,106 @@
+/// 拼图图片生成的默认反向提示词。
+///
+/// 这里单独收口拼图图片提示词，避免图片生成链路、候选图持久化和 DashScope 请求编排
+/// 混在同一个脚本里，后续调画风或资产约束时只需要改这一处。
+pub(crate) const PUZZLE_DEFAULT_NEGATIVE_PROMPT: &str =
+    "低清晰度，低质量，文字水印，畸形构图，过度模糊，重复肢体，画面脏污";
+
+/// wan2.2 / wan2.1 文生图旧协议的正向 prompt 上限。
+///
+/// 中文注释：DashScope 旧 text2image 接口会把超长 prompt 判成请求参数不合法，
+/// 所以这里先在拼图提示词模块内压缩，保证固定玩法约束不会被用户长描述挤掉。
+pub(crate) const PUZZLE_TEXT_TO_IMAGE_PROMPT_MAX_CHARS: usize = 500;
+
+const PUZZLE_IMAGE_LEVEL_NAME_MAX_CHARS: usize = 40;
+const PUZZLE_IMAGE_PROMPT_FALLBACK: &str = "清晰、有辨识度的拼图画面";
+
+/// 根据拼图关卡名和陶泥主输入构造最终发给图片模型的提示词。
+pub(crate) fn build_puzzle_image_prompt(level_name: &str, prompt: &str) -> String {
+    let level_name =
+        truncate_puzzle_prompt_segment(level_name.trim(), PUZZLE_IMAGE_LEVEL_NAME_MAX_CHARS);
+    let prompt = prompt.trim();
+    let prompt = if prompt.is_empty() {
+        PUZZLE_IMAGE_PROMPT_FALLBACK
+    } else {
+        prompt
+    };
+    let template_chars = build_puzzle_image_prompt_text(level_name.as_str(), "")
+        .chars()
+        .count();
+    let prompt_max_chars = PUZZLE_TEXT_TO_IMAGE_PROMPT_MAX_CHARS.saturating_sub(template_chars);
+    let prompt = truncate_puzzle_prompt_segment(prompt, prompt_max_chars);
+    let image_prompt = build_puzzle_image_prompt_text(level_name.as_str(), prompt.as_str());
+
+    debug_assert!(
+        image_prompt.chars().count() <= PUZZLE_TEXT_TO_IMAGE_PROMPT_MAX_CHARS,
+        "puzzle image prompt should fit DashScope wan2.2 limit"
+    );
+    image_prompt
+}
+
+fn build_puzzle_image_prompt_text(level_name: &str, prompt: &str) -> String {
+    format!(
+        concat!(
+            "请生成一张高清插画。",
+            "关卡名：{level_name}。",
+            "画面主体：{prompt}。",
+            "画面要求：1:1 正方形拼图关卡，适配 3x3 或 4x4 拼图切块，",
+            "主体要清晰集中，前中后景层次明确，局部细节丰富但不要杂乱，",
+            "避免文字、水印、边框和 UI 元素。"
+        ),
+        level_name = level_name,
+        prompt = prompt,
+    )
+}
+
+fn truncate_puzzle_prompt_segment(value: &str, max_chars: usize) -> String {
+    if value.chars().count() <= max_chars {
+        return value.to_string();
+    }
+
+    const MARKER: &str = "...";
+    if max_chars <= MARKER.chars().count() {
+        return value.chars().take(max_chars).collect();
+    }
+
+    let keep_chars = max_chars - MARKER.chars().count();
+    format!(
+        "{}{MARKER}",
+        value.chars().take(keep_chars).collect::<String>()
+    )
+}
+
+#[cfg(test)]
+mod tests {
+    use super::*;
+
+    #[test]
+    fn build_puzzle_image_prompt_keeps_puzzle_asset_constraints() {
+        let prompt = build_puzzle_image_prompt("雨夜神庙", "猫咪在发光遗迹前寻找线索");
+
+        assert!(prompt.contains("雨夜神庙"));
+        assert!(prompt.contains("猫咪在发光遗迹前寻找线索"));
+        assert!(prompt.contains("1:1 正方形拼图关卡"));
+        assert!(prompt.contains("3x3 或 4x4"));
+        assert!(prompt.contains("避免文字、水印、边框和 UI 元素"));
+    }
+
+    #[test]
+    fn build_puzzle_image_prompt_trims_long_user_description_for_wan22() {
+        let long_level_name = "雨夜神庙".repeat(20);
+        let long_description =
+            "发光遗迹、猫咪、漂浮碎片、雨水反光、远处灯塔、适合拼图切块。".repeat(50);
+        let prompt = build_puzzle_image_prompt(long_level_name.as_str(), long_description.as_str());
+
+        assert!(prompt.chars().count() <= PUZZLE_TEXT_TO_IMAGE_PROMPT_MAX_CHARS);
+        assert!(prompt.contains("1:1 正方形拼图关卡"));
+        assert!(prompt.contains("3x3 或 4x4"));
+        assert!(prompt.contains("避免文字、水印、边框和 UI 元素"));
+    }
+
+    #[test]
+    fn default_negative_prompt_blocks_text_and_low_quality_assets() {
+        assert!(PUZZLE_DEFAULT_NEGATIVE_PROMPT.contains("低清晰度"));
+        assert!(PUZZLE_DEFAULT_NEGATIVE_PROMPT.contains("文字水印"));
+    }
+}

server-rs/crates/api-server/src/prompt/puzzle/mod.rs

@@ -0,0 +1,2 @@
+pub(crate) mod agent_chat;
+pub(crate) mod image;

server-rs/crates/api-server/src/prompt/puzzle_image.rs

@@ -1,44 +0,0 @@
-/// 拼图图片生成的默认反向提示词。
-///
-/// 这里单独收口拼图图片提示词，避免图片生成链路、候选图持久化和 DashScope 请求编排
-/// 混在同一个脚本里，后续调画风或资产约束时只需要改这一处。
-pub(crate) const PUZZLE_DEFAULT_NEGATIVE_PROMPT: &str =
-    "低清晰度，低质量，文字水印，畸形构图，过度模糊，重复肢体，画面脏污";
-
-/// 根据拼图关卡名和陶泥主输入构造最终发给图片模型的提示词。
-pub(crate) fn build_puzzle_image_prompt(level_name: &str, prompt: &str) -> String {
-    format!(
-        concat!(
-            "请生成一张适合 1:1 正方形拼图关卡的高清插画。",
-            "关卡名：{level_name}。",
-            "画面主体：{prompt}。",
-            "画面要求：1:1 正方形画布，适配 3x3 或 4x4 拼图切块，",
-            "主体要清晰集中，前中后景层次明确，局部细节丰富但不要杂乱，",
-            "避免文字、水印、边框和 UI 元素。"
-        ),
-        level_name = level_name,
-        prompt = prompt,
-    )
-}
-
-#[cfg(test)]
-mod tests {
-    use super::*;
-
-    #[test]
-    fn build_puzzle_image_prompt_keeps_puzzle_asset_constraints() {
-        let prompt = build_puzzle_image_prompt("雨夜神庙", "猫咪在发光遗迹前寻找线索");
-
-        assert!(prompt.contains("雨夜神庙"));
-        assert!(prompt.contains("猫咪在发光遗迹前寻找线索"));
-        assert!(prompt.contains("1:1 正方形拼图关卡"));
-        assert!(prompt.contains("3x3 或 4x4"));
-        assert!(prompt.contains("避免文字、水印、边框和 UI 元素"));
-    }
-
-    #[test]
-    fn default_negative_prompt_blocks_text_and_low_quality_assets() {
-        assert!(PUZZLE_DEFAULT_NEGATIVE_PROMPT.contains("低清晰度"));
-        assert!(PUZZLE_DEFAULT_NEGATIVE_PROMPT.contains("文字水印"));
-    }
-}

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

@@ -1,18 +1,16 @@
 use module_puzzle::{PuzzleAgentStage, PuzzleAnchorPack, PuzzleAnchorStatus, empty_anchor_pack};
 use platform_llm::LlmClient;
 use serde::{Deserialize, Serialize};
-use serde_json::{Value as JsonValue, json};
-use spacetime_client::{
-    PuzzleAgentMessageFinalizeRecordInput, PuzzleAgentMessageRecord, PuzzleAgentSessionRecord,
-};
+use serde_json::Value as JsonValue;
+use spacetime_client::{PuzzleAgentMessageFinalizeRecordInput, PuzzleAgentSessionRecord};
 
-use crate::creation_agent_anchor_templates::{
-    get_creation_agent_anchor_template, render_anchor_question_block,
-};
-use crate::creation_agent_chat::render_quick_fill_extra_rules;
 use crate::creation_agent_llm_turn::{
     CreationAgentLlmTurnErrorMessages, stream_creation_agent_json_turn,
 };
+use crate::prompt::puzzle::agent_chat::{
+    PUZZLE_AGENT_JSON_TURN_USER_PROMPT, PUZZLE_AGENT_SYSTEM_PROMPT, build_puzzle_agent_prompt,
+    serialize_puzzle_record_anchor_pack,
+};
 
 #[derive(Clone, Debug)]
 pub(crate) struct PuzzleAgentTurnRequest<'a> {
@@ -60,63 +58,6 @@ struct PuzzleAgentModelOutput {
     next_anchor_pack: PuzzleAnchorPack,
 }
 
-const PUZZLE_AGENT_SYSTEM_PROMPT: &str = r#"你是一个负责和陶泥主共创拼图画面的中文创意策划。
-
-你要帮助用户把一句灵感逐步收束成可以发布成拼图关卡的视觉方案。
-
-你必须同时输出：
-1. 一段直接发给用户的中文回复 replyText
-2. 当前进度 progressPercent
-3. 下一轮完整可用的 nextAnchorPack
-
-硬约束：
-1. 只能输出 JSON，不能输出代码块或解释
-2. nextAnchorPack 必须是完整对象，不能只输出 patch
-3. replyText 必须是自然中文，不能提“字段”“锚点”“结构”“JSON”等内部词
-4. replyText 一次最多推进一个最关键问题
-5. 如果用户已经给出明确方向，就优先吸收和收束，不要机械反问
-6. progressPercent 范围只能是 0 到 100
-7. status 只能使用 missing / inferred / confirmed / locked
-"#;
-
-const PUZZLE_AGENT_OUTPUT_CONTRACT: &str = r#"请严格按以下 JSON 输出，不要输出其他文字：
-{
-  "replyText": "",
-  "progressPercent": 0,
-  "nextAnchorPack": {
-    "themePromise": {
-      "key": "themePromise",
-      "label": "题材承诺",
-      "value": "",
-      "status": "missing"
-    },
-    "visualSubject": {
-      "key": "visualSubject",
-      "label": "画面主体",
-      "value": "",
-      "status": "missing"
-    },
-    "visualMood": {
-      "key": "visualMood",
-      "label": "视觉气质",
-      "value": "",
-      "status": "missing"
-    },
-    "compositionHooks": {
-      "key": "compositionHooks",
-      "label": "拼图记忆点",
-      "value": "",
-      "status": "missing"
-    },
-    "tagsAndForbidden": {
-      "key": "tagsAndForbidden",
-      "label": "标签与禁忌",
-      "value": "",
-      "status": "missing"
-    }
-  }
-}"#;
-
 pub(crate) async fn run_puzzle_agent_turn<F>(
     request: PuzzleAgentTurnRequest<'_>,
     on_reply_update: F,
@@ -128,7 +69,7 @@ where
     let turn_output = stream_creation_agent_json_turn(
         request.llm_client,
         format!("{PUZZLE_AGENT_SYSTEM_PROMPT}\n\n{prompt}"),
-        "请按约定输出这一轮的 JSON。",
+        PUZZLE_AGENT_JSON_TURN_USER_PROMPT,
         request.enable_web_search,
         CreationAgentLlmTurnErrorMessages {
             model_unavailable: "当前模型不可用，请稍后重试。",
@@ -185,10 +126,6 @@ pub(crate) fn build_failed_finalize_record_input(
     error_message: String,
     updated_at_micros: i64,
 ) -> PuzzleAgentMessageFinalizeRecordInput {
-    let anchor_pack_json = serde_json::to_string(&map_record_anchor_pack(&session.anchor_pack))
-        .unwrap_or_else(|_| {
-            serde_json::to_string(&empty_anchor_pack()).unwrap_or_else(|_| "{}".to_string())
-        });
     PuzzleAgentMessageFinalizeRecordInput {
         session_id,
         owner_user_id,
@@ -196,61 +133,12 @@ pub(crate) fn build_failed_finalize_record_input(
         assistant_reply_text: None,
         stage: session.stage.clone(),
         progress_percent: session.progress_percent,
-        anchor_pack_json,
+        anchor_pack_json: serialize_puzzle_record_anchor_pack(&session.anchor_pack),
         error_message: Some(error_message),
         updated_at_micros,
     }
 }
 
-fn build_puzzle_agent_prompt(
-    session: &PuzzleAgentSessionRecord,
-    quick_fill_requested: bool,
-) -> String {
-    let anchor_question_block = get_creation_agent_anchor_template("puzzle")
-        .map(render_anchor_question_block)
-        .unwrap_or_else(|| "模板目标：收束成可以发布为拼图关卡的视觉方案。".to_string());
-    let quick_fill_rules = if quick_fill_requested {
-        format!(
-            "\n\n{}",
-            render_quick_fill_extra_rules(
-                "当前题材方向里的拼图关键词",
-                "不要要求用户再提供素材、风格或禁忌",
-                "输出完整 nextAnchorPack，直接补齐 value 为空或 status 为 missing 的项",
-                "生成结果页",
-            )
-        )
-    } else {
-        String::new()
-    };
-    format!(
-        "{anchor_question_block}{quick_fill_rules}\n\n当前是第 {turn} 轮，当前进度 {progress}% 。\n\n是否要求自动补充剩余关键字：{quick_fill_requested_text}\n\n当前 anchor pack：\n{anchor_pack}\n\n最近聊天记录：\n{chat_history}\n\n{contract}",
-        anchor_question_block = anchor_question_block,
-        quick_fill_rules = quick_fill_rules,
-        turn = session.current_turn.saturating_add(1),
-        progress = session.progress_percent,
-        quick_fill_requested_text = if quick_fill_requested { "是" } else { "否" },
-        anchor_pack = serde_json::to_string_pretty(&map_record_anchor_pack(&session.anchor_pack))
-            .unwrap_or_else(|_| "{}".to_string()),
-        chat_history =
-            serde_json::to_string_pretty(&build_chat_history(session.messages.as_slice()))
-                .unwrap_or_else(|_| "[]".to_string()),
-        contract = PUZZLE_AGENT_OUTPUT_CONTRACT,
-    )
-}
-
-fn build_chat_history(messages: &[PuzzleAgentMessageRecord]) -> Vec<JsonValue> {
-    messages
-        .iter()
-        .map(|message| {
-            json!({
-                "role": message.role,
-                "kind": message.kind,
-                "content": message.text,
-            })
-        })
-        .collect()
-}
-
 fn parse_model_output(parsed: &JsonValue) -> Result<PuzzleAgentModelOutput, PuzzleAgentTurnError> {
     let reply_text = parsed
         .get("replyText")
@@ -348,27 +236,6 @@ fn resolve_puzzle_agent_stage(progress_percent: u32) -> PuzzleAgentStage {
     }
 }
 
-fn map_record_anchor_pack(record: &spacetime_client::PuzzleAnchorPackRecord) -> PuzzleAnchorPack {
-    PuzzleAnchorPack {
-        theme_promise: map_record_anchor_item(&record.theme_promise),
-        visual_subject: map_record_anchor_item(&record.visual_subject),
-        visual_mood: map_record_anchor_item(&record.visual_mood),
-        composition_hooks: map_record_anchor_item(&record.composition_hooks),
-        tags_and_forbidden: map_record_anchor_item(&record.tags_and_forbidden),
-    }
-}
-
-fn map_record_anchor_item(
-    record: &spacetime_client::PuzzleAnchorItemRecord,
-) -> module_puzzle::PuzzleAnchorItem {
-    module_puzzle::PuzzleAnchorItem {
-        key: record.key.clone(),
-        label: record.label.clone(),
-        value: record.value.clone(),
-        status: parse_anchor_status(record.status.as_str()),
-    }
-}
-
 fn parse_anchor_status(value: &str) -> PuzzleAnchorStatus {
     match value {
         "confirmed" => PuzzleAnchorStatus::Confirmed,
@@ -383,57 +250,9 @@ mod tests {
     use module_puzzle::PuzzleAnchorStatus;
     use serde_json::json;
 
-    use super::{build_puzzle_agent_prompt, parse_model_output};
+    use super::parse_model_output;
     use crate::creation_agent_llm_turn::extract_reply_text_from_partial_json;
 
-    fn empty_session_record() -> spacetime_client::PuzzleAgentSessionRecord {
-        spacetime_client::PuzzleAgentSessionRecord {
-            session_id: "puzzle-session-test".to_string(),
-            current_turn: 2,
-            progress_percent: 60,
-            stage: "collecting_anchors".to_string(),
-            anchor_pack: spacetime_client::PuzzleAnchorPackRecord {
-                theme_promise: spacetime_client::PuzzleAnchorItemRecord {
-                    key: "themePromise".to_string(),
-                    label: "题材承诺".to_string(),
-                    value: "雨夜猫咪遗迹".to_string(),
-                    status: "confirmed".to_string(),
-                },
-                visual_subject: spacetime_client::PuzzleAnchorItemRecord {
-                    key: "visualSubject".to_string(),
-                    label: "画面主体".to_string(),
-                    value: String::new(),
-                    status: "missing".to_string(),
-                },
-                visual_mood: spacetime_client::PuzzleAnchorItemRecord {
-                    key: "visualMood".to_string(),
-                    label: "视觉气质".to_string(),
-                    value: String::new(),
-                    status: "missing".to_string(),
-                },
-                composition_hooks: spacetime_client::PuzzleAnchorItemRecord {
-                    key: "compositionHooks".to_string(),
-                    label: "拼图记忆点".to_string(),
-                    value: String::new(),
-                    status: "missing".to_string(),
-                },
-                tags_and_forbidden: spacetime_client::PuzzleAnchorItemRecord {
-                    key: "tagsAndForbidden".to_string(),
-                    label: "标签与禁忌".to_string(),
-                    value: String::new(),
-                    status: "missing".to_string(),
-                },
-            },
-            draft: None,
-            messages: Vec::new(),
-            last_assistant_reply: None,
-            published_profile_id: None,
-            suggested_actions: Vec::new(),
-            result_preview: None,
-            updated_at: "2026-04-24T10:00:00.000Z".to_string(),
-        }
-    }
-
     #[test]
     fn extract_reply_text_from_partial_json_preserves_chinese_characters() {
         let partial_json = r#"{"replyText":"夜雨猫咪遗迹","progressPercent":42"#;
@@ -498,13 +317,4 @@ mod tests {
             "雨夜、猫咪、神庙遗迹；禁止文字水印"
         );
     }
-
-    #[test]
-    fn quick_fill_prompt_forbids_follow_up_questions() {
-        let prompt = build_puzzle_agent_prompt(&empty_session_record(), true);
-
-        assert!(prompt.contains("用户刚刚主动要求你自动补充剩余关键字"));
-        assert!(prompt.contains("不要再继续提问"));
-        assert!(prompt.contains("progressPercent 直接输出为 100"));
-    }
 }

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

@@ -22,6 +22,7 @@ use module_runtime_story_compat::{
 use crate::{
     auth::AuthenticatedAccessToken,
     http_error::AppError,
+    llm_model_routing::RPG_STORY_LLM_MODEL,
     prompt::runtime_chat::{
         NPC_CHAT_TURN_REPLY_SYSTEM_PROMPT, NPC_CHAT_TURN_SUGGESTION_SYSTEM_PROMPT,
         NpcChatTurnPromptInput, build_deterministic_chat_suggestions,
@@ -227,6 +228,7 @@ where
     ]);
     reply_request.max_tokens = Some(700);
     reply_request.enable_web_search = state.config.rpg_llm_web_search_enabled;
+    reply_request.model = Some(RPG_STORY_LLM_MODEL.to_string());
 
     let reply_response = llm_client
         .stream_text(reply_request, |delta| {
@@ -254,6 +256,7 @@ where
     ]);
     suggestion_request.max_tokens = Some(200);
     suggestion_request.enable_web_search = state.config.rpg_llm_web_search_enabled;
+    suggestion_request.model = Some(RPG_STORY_LLM_MODEL.to_string());
     let suggestion_text = llm_client
         .request_text(suggestion_request)
         .await

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

@@ -15,7 +15,8 @@ use std::convert::Infallible;
 
 use crate::{
     api_response::json_success_body, auth::AuthenticatedAccessToken, http_error::AppError,
-    prompt::runtime_chat::*, request_context::RequestContext, state::AppState,
+    llm_model_routing::RPG_STORY_LLM_MODEL, prompt::runtime_chat::*,
+    request_context::RequestContext, state::AppState,
 };
 use module_runtime_story_compat::{
     RuntimeStoryPromptContextExtras, build_runtime_story_prompt_context, current_world_type,
@@ -587,6 +588,7 @@ async fn request_runtime_plain_text(
     ]);
     request.max_tokens = Some(400);
     request.enable_web_search = state.config.rpg_llm_web_search_enabled;
+    request.model = Some(RPG_STORY_LLM_MODEL.to_string());
 
     llm_client
         .request_text(request)
@@ -618,6 +620,7 @@ fn stream_plain_text_response<'a>(
         ]);
         request.max_tokens = Some(700);
         request.enable_web_search = enable_web_search;
+        request.model = Some(RPG_STORY_LLM_MODEL.to_string());
 
         let response = llm_client
             .stream_text(request, |_| {})

server-rs/crates/api-server/src/runtime_story/compat/ai.rs

@@ -1,4 +1,5 @@
 use super::*;
+use crate::llm_model_routing::RPG_STORY_LLM_MODEL;
 use crate::prompt::runtime_chat::{
     RuntimeNpcDialoguePromptParams, RuntimeReasonedStoryPromptParams, RuntimeStoryTextPromptParams,
     build_runtime_npc_dialogue_user_prompt, build_runtime_reasoned_story_user_prompt,
@@ -100,6 +101,7 @@ pub(super) async fn generate_action_story_payload(
 
 fn apply_rpg_web_search(state: &AppState, request: &mut LlmTextRequest) {
     request.enable_web_search = state.config.rpg_llm_web_search_enabled;
+    request.model = Some(RPG_STORY_LLM_MODEL.to_string());
 }
 
 pub(super) async fn generate_npc_dialogue_payload(
@@ -144,6 +146,7 @@ pub(super) async fn generate_npc_dialogue_payload(
     ]);
     llm_request.max_tokens = Some(700);
     llm_request.enable_web_search = enable_web_search;
+    llm_request.model = Some(RPG_STORY_LLM_MODEL.to_string());
 
     let dialogue_text = llm_client
         .request_text(llm_request)
@@ -195,6 +198,7 @@ pub(super) async fn generate_reasoned_story_payload(
     ]);
     llm_request.max_tokens = Some(700);
     llm_request.enable_web_search = enable_web_search;
+    llm_request.model = Some(RPG_STORY_LLM_MODEL.to_string());
 
     let story_text = llm_client
         .request_text(llm_request)

server-rs/crates/api-server/src/runtime_story/compat/presentation.rs

@@ -271,11 +271,18 @@ pub(super) fn build_active_npc_runtime_story_options(
     game_state: &Value,
     npc_id: &str,
 ) -> Vec<RuntimeStoryOptionView> {
+    if read_current_npc_affinity(game_state) < 0 {
+        return vec![build_npc_runtime_story_option(
+            "npc_chat",
+            "继续交谈",
+            npc_id,
+            "chat",
+        )];
+    }
+
     let mut options = vec![
         build_npc_runtime_story_option("npc_chat", "继续交谈", npc_id, "chat"),
         build_npc_help_runtime_story_option(game_state, npc_id),
-        build_npc_runtime_story_option("npc_spar", "点到为止切磋", npc_id, "spar"),
-        build_npc_runtime_story_option("npc_fight", "与对方战斗", npc_id, "fight"),
     ];
 
     if current_npc_inventory_items(game_state)
@@ -332,12 +339,6 @@ pub(super) fn build_active_npc_runtime_story_options(
         ));
     }
 
-    options.push(build_npc_runtime_story_option(
-        "npc_leave",
-        "离开当前角色",
-        npc_id,
-        "leave",
-    ));
     options
 }
 

server-rs/crates/api-server/src/runtime_story/compat/tests.rs

@@ -1112,12 +1112,9 @@ fn runtime_story_state_compiler_builds_active_npc_options_with_trade_gift_and_he
         vec![
             "npc_chat",
             "npc_help",
-            "npc_spar",
-            "npc_fight",
             "npc_trade",
             "npc_gift",
-            "npc_quest_accept",
-            "npc_leave"
+            "npc_quest_accept"
         ]
     );
     assert_eq!(
@@ -1129,11 +1126,11 @@ fn runtime_story_state_compiler_builds_active_npc_options_with_trade_gift_and_he
         Some("当前 NPC 的一次性援手已经用完了。")
     );
     assert!(matches!(
-        response.view_model.available_options[4].interaction,
+        response.view_model.available_options[2].interaction,
         Some(RuntimeStoryOptionInteraction::Npc { ref action, .. }) if action == "trade"
     ));
     assert!(matches!(
-        response.view_model.available_options[5].interaction,
+        response.view_model.available_options[3].interaction,
         Some(RuntimeStoryOptionInteraction::Npc { ref action, .. }) if action == "gift"
     ));
     let npc_interaction = response
@@ -1154,6 +1151,35 @@ fn runtime_story_state_compiler_builds_active_npc_options_with_trade_gift_and_he
     );
 }
 
+#[test]
+fn runtime_story_state_compiler_limits_negative_affinity_active_npc_to_chat() {
+    let mut game_state = build_runtime_story_boundary_game_state_fixture();
+    write_bool_field(&mut game_state, "npcInteractionActive", true);
+    write_current_npc_state_i32_field(&mut game_state, "affinity", -8);
+    let response = build_runtime_story_state_response(
+        "runtime-main",
+        Some(0),
+        RuntimeStorySnapshotPayload {
+            saved_at: None,
+            bottom_tab: "adventure".to_string(),
+            game_state,
+            current_story: None,
+        },
+    );
+
+    let function_ids = response
+        .view_model
+        .available_options
+        .iter()
+        .map(|option| option.function_id.as_str())
+        .collect::<Vec<_>>();
+    assert_eq!(function_ids, vec!["npc_chat"]);
+    assert!(matches!(
+        response.view_model.available_options[0].interaction,
+        Some(RuntimeStoryOptionInteraction::Npc { ref action, .. }) if action == "chat"
+    ));
+}
+
 #[test]
 fn runtime_story_equipment_equip_updates_loadout_and_build_toast() {
     let request = RuntimeStoryActionRequest {

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

@@ -0,0 +1,54 @@
+use module_auth::AuthUser;
+
+use crate::state::AppState;
+
+#[derive(Clone, Debug, PartialEq, Eq)]
+pub struct WorkAuthorSummary {
+    pub display_name: String,
+    pub public_user_code: Option<String>,
+}
+
+/// 中文注释：作品作者的真相源是 owner_user_id；历史昵称字段只作为账号资料不可读时的兼容回退。
+pub fn resolve_work_author_by_user_id(
+    state: &AppState,
+    owner_user_id: &str,
+    fallback_display_name: Option<&str>,
+    fallback_public_user_code: Option<&str>,
+) -> WorkAuthorSummary {
+    let fallback_display_name =
+        normalize_optional_text(fallback_display_name).unwrap_or_else(|| "玩家".to_string());
+    let fallback_public_user_code = normalize_optional_text(fallback_public_user_code);
+
+    let Some(owner_user_id) = normalize_optional_text(Some(owner_user_id)) else {
+        return WorkAuthorSummary {
+            display_name: fallback_display_name,
+            public_user_code: fallback_public_user_code,
+        };
+    };
+
+    match state.auth_user_service().get_user_by_id(&owner_user_id) {
+        Ok(Some(user)) => map_auth_user_to_work_author_summary(user, fallback_display_name),
+        Ok(None) | Err(_) => WorkAuthorSummary {
+            display_name: fallback_display_name,
+            public_user_code: fallback_public_user_code,
+        },
+    }
+}
+
+fn map_auth_user_to_work_author_summary(
+    user: AuthUser,
+    fallback_display_name: String,
+) -> WorkAuthorSummary {
+    WorkAuthorSummary {
+        display_name: normalize_optional_text(Some(user.display_name.as_str()))
+            .unwrap_or(fallback_display_name),
+        public_user_code: normalize_optional_text(Some(user.public_user_code.as_str())),
+    }
+}
+
+fn normalize_optional_text(value: Option<&str>) -> Option<String> {
+    value
+        .map(str::trim)
+        .filter(|value| !value.is_empty())
+        .map(ToOwned::to_owned)
+}