# RPG 创作与资产提示词脚本抽离方案（2026-04-24）

## 背景
`server-rs/crates/api-server` 中 RPG 创作链路已经承接草稿生成、结果页补角色/补场景、场景图、角色图与角色动作生成。此前提示词散落在路由处理文件中，导致玩法规则、资产规则与结果页生成规则混杂，后续迭代容易出现落地漂移。

## 落地边界
本次只调整 Rust 后端 `api-server` 内的提示词组织，不兼容 `server-node`，也不改动前端展示文案。

## 模块拆分
1. `custom_world_rpg_draft_prompts.rs`
   - 承载 RPG 玩法草稿生成相关提示词。
   - 覆盖八锚点共创主提示词、状态识别提示词、模式规则、用户输入信号规则、上下文渲染。
   - `custom_world_agent_turn.rs` 只保留流程编排、LLM 调用和结果规范化。

2. `custom_world_asset_prompts.rs`
   - 承载生图、生动作相关提示词。
   - 覆盖角色主图提示词、角色主图负面提示词、角色动作视频/序列帧提示词、动作兜底安全提示词。
   - 场景图和封面图提示词也属于自定义世界资产提示词，统一迁入该模块。

3. `custom_world_result_prompts.rs`
   - 承载结果页新增实体相关提示词。
   - 覆盖新增可扮演角色、新增场景角色、新增场景的 LLM system/user prompt 构造。
   - 路由层继续负责 fallback 与返回结构，提示词模块只负责生成可审计的 prompt 文本。

## 约束
- 提示词模块只做纯函数拼装，不访问网络、文件、数据库或 SpacetimeDB。
- 保留原中文提示词语义，不把中文改写成英文。
- 原有 fallback 行为不变：LLM 不可用或解析失败时仍回退本地生成。
- 仅做局部迁移，避免整文件重写导致中文编码风险。

## 验证
- `cargo test -p api-server` 应能通过或至少完成编译阶段。
- 既有单元测试中关于角色图、动作结果 payload、场景图请求的断言应保持不变。