167 lines
6.8 KiB
Rust
167 lines
6.8 KiB
Rust
#[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}。")
|
||
}
|
||
}
|