Genarrative/docs/technical/RPG_PROMPT_SCRIPT_EXTRACTION_PLAN_2026-04-24.md

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、场景图请求的断言应保持不变。