init with react+axum+spacetimedb

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

@@ -0,0 +1,166 @@
+#[derive(Clone, Debug, Default)]
+pub(crate) struct SceneImagePromptProfile<'a> {
+    pub name: &'a str,
+    pub subtitle: &'a str,
+    pub tone: &'a str,
+    pub player_goal: &'a str,
+    pub summary: &'a str,
+    pub setting_text: &'a str,
+}
+
+#[derive(Clone, Debug, Default)]
+pub(crate) struct SceneImagePromptLandmark<'a> {
+    pub name: &'a str,
+    pub description: &'a str,
+}
+
+#[derive(Clone, Debug)]
+pub(crate) struct SceneImagePromptParams<'a> {
+    pub profile: SceneImagePromptProfile<'a>,
+    pub landmark: SceneImagePromptLandmark<'a>,
+    pub user_prompt: &'a str,
+    pub has_reference_image: bool,
+    pub fallback_landmark_name: Option<&'a str>,
+    pub fallback_world_name: &'a str,
+}
+
+#[derive(Clone, Debug)]
+pub(crate) struct SceneActBackgroundPromptParams<'a> {
+    pub world_name: &'a str,
+    pub world_tone: &'a str,
+    pub scene_name: &'a str,
+    pub title: &'a str,
+    pub summary: &'a str,
+    pub act_goal: &'a str,
+    pub transition_hook: &'a str,
+    pub primary_role_name: &'a str,
+    pub support_role_names: Vec<String>,
+    pub prompt_text: &'a str,
+}
+
+pub(crate) const DEFAULT_CUSTOM_WORLD_SCENE_IMAGE_NEGATIVE_PROMPT: &str = "文字，水印，logo，UI界面，对话框，边框，人物近景特写，多人合照，模糊，低清晰度，畸形建筑，现代车辆，监控摄像头";
+
+pub(crate) fn build_custom_world_scene_image_prompt(params: SceneImagePromptParams<'_>) -> String {
+    let world_name = clamp_scene_image_text(
+        if params.profile.name.trim().is_empty() {
+            params.fallback_world_name
+        } else {
+            params.profile.name
+        },
+        18,
+    );
+    let world_subtitle = clamp_scene_image_text(params.profile.subtitle, 18);
+    let world_tone = clamp_scene_image_text(params.profile.tone, 48);
+    let world_goal = clamp_scene_image_text(params.profile.player_goal, 48);
+    let world_summary = clamp_scene_image_text(params.profile.summary, 72);
+    let world_setting = clamp_scene_image_text(params.profile.setting_text, 72);
+    let landmark_name = clamp_scene_image_text(
+        if params.landmark.name.trim().is_empty() {
+            params.fallback_landmark_name.unwrap_or("未命名场景")
+        } else {
+            params.landmark.name
+        },
+        18,
+    );
+    let landmark_description = clamp_scene_image_text(params.landmark.description, 96);
+    let requested_visual = clamp_scene_image_text(params.user_prompt, 120);
+
+    vec![
+        "为横版 16:9 2D RPG 生成高完成度像素风场景背景，适合作为剧情探索与战斗底图。".to_string(),
+        "画面构图必须严格按上下 1:1 分区：上半部分严格控制在整张图的 1/2 高度内，只描绘场景远景与中远景轮廓，不要让背景内容向下侵占超过半屏。".to_string(),
+        "下半部分严格占据整张图的 1/2 高度，用于玩家角色站位与展示，必须是模拟 3D 游戏视角的地面近景，有明确的透视延伸和近大远小关系，不是平铺的 2D 侧视地面。".to_string(),
+        "下半部分的内容必须是明确可站立的地面本体，例如道路、石板、平台、广场、甲板、沙地或草地，要有连续、稳定、可落脚的站位逻辑，不能只是装饰性前景、坑洞、障碍堆、栏杆带或不可通行的景物。".to_string(),
+        "下半部分地面近景要保持相对简洁、低细节、轮廓清楚、便于角色站立，不要堆满道具、植被、碎石、栏杆或复杂装饰。".to_string(),
+        if params.has_reference_image {
+            "已提供一张自定义参考图，请沿用其构图、镜头或氛围线索，同时继续满足本次场景需求。".to_string()
+        } else {
+            String::new()
+        },
+        format!(
+            "世界：{}{}。",
+            if world_name.is_empty() {
+                "未命名世界"
+            } else {
+                world_name.as_str()
+            },
+            if world_subtitle.is_empty() {
+                String::new()
+            } else {
+                format!("，{world_subtitle}")
+            }
+        ),
+        conditional_prompt_line("玩家设定", world_setting.as_str()),
+        conditional_prompt_line("世界概述", world_summary.as_str()),
+        conditional_prompt_line("整体基调", world_tone.as_str()),
+        conditional_prompt_line("玩家目标关联", world_goal.as_str()),
+        format!(
+            "场景名称：{}。",
+            if landmark_name.is_empty() {
+                "未命名场景"
+            } else {
+                landmark_name.as_str()
+            }
+        ),
+        conditional_prompt_line("场景描述", landmark_description.as_str()),
+        conditional_prompt_line("本次想要生成的画面内容", requested_visual.as_str()),
+        "不要出现 UI、字幕、文字、水印、logo 或装饰边框，人物仅可作为很小的远景剪影，画面重点放在场景本身，不要遮挡下半部分的角色展示区域。".to_string(),
+    ]
+    .into_iter()
+    .filter(|line| !line.is_empty())
+    .collect::<Vec<_>>()
+    .join("")
+}
+
+pub(crate) fn build_scene_act_background_image_prompt(
+    params: SceneActBackgroundPromptParams<'_>,
+) -> String {
+    // 幕背景图不是普通地点图，必须把世界、幕目标、过渡钩子和角色关系一起写入图像提示词，
+    // 同时明确禁止角色立绘和 UI 元素进入背景资产。
+    [
+        format!("这是世界《{}》中的场景幕背景图。", params.world_name),
+        format!("场景：{}", params.scene_name),
+        format!("幕标题：{}", params.title),
+        format!("幕摘要：{}", params.summary),
+        format!("幕目标：{}", params.act_goal),
+        format!("过渡钩子：{}", params.transition_hook),
+        format!(
+            "主角色：{}",
+            if params.primary_role_name.trim().is_empty() {
+                "待补主角色"
+            } else {
+                params.primary_role_name.trim()
+            }
+        ),
+        if params.support_role_names.is_empty() {
+            String::new()
+        } else {
+            format!("辅助角色：{}", params.support_role_names.join("、"))
+        },
+        format!("世界气质：{}", params.world_tone),
+        format!("背景描述：{}", params.prompt_text),
+        "要求：只生成环境背景，不出现角色立绘、站位 UI、对白框、按钮或文字。".to_string(),
+    ]
+    .into_iter()
+    .filter(|line| !line.trim().is_empty())
+    .collect::<Vec<_>>()
+    .join("\n")
+}
+
+fn clamp_scene_image_text(value: &str, max_length: usize) -> String {
+    value
+        .trim()
+        .replace(char::is_whitespace, " ")
+        .chars()
+        .take(max_length)
+        .collect::<String>()
+        .trim()
+        .to_string()
+}
+
+fn conditional_prompt_line(prefix: &str, value: &str) -> String {
+    if value.is_empty() {
+        String::new()
+    } else {
+        format!("{prefix}：{value}。")
+    }
+}