# Rust 生成链路 Prompt 脚本迁移设计（2026-04-25）

## 1. 目标

把 `server-rs` 中四条现役生成链路的提示词从业务流程文件中抽离到独立 `prompt` 目录，后续迭代只修改 prompt 脚本，不在路由、任务、资产持久化代码中直接堆提示词。

## 2. 目录约定

新增目录：`server-rs/crates/api-server/src/prompt/`

模块划分：

1. `scene_background.rs`：场景背景图与幕背景图提示词。
2. `character_visual.rs`：角色主形象提示词与负向提示词。
3. `character_animation.rs`：角色动作、序列帧、图生视频、动作迁移提示词。
4. `foundation_draft.rs`：草稿生成各阶段 JSON 系统提示词、修复提示词、框架/角色/场景/档案分阶段 user prompt。
5. `mod.rs`：统一导出子模块。

## 3. 迁移边界

1. 只迁移 prompt 构造与 prompt 常量，不迁移 DashScope、OSS、SpacetimeDB、任务状态、并发控制和持久化逻辑。
2. `custom_world.rs` 只保留场景幕引用收集、校验和调用生成服务，不再承载幕背景图提示词正文。
3. `custom_world_ai.rs` 只保留图片生成、下载、入库、接口 payload 归一化；场景图 prompt builder 迁入 `prompt::scene_background`。
4. `custom_world_asset_prompts.rs` 作为兼容转发层保留，避免一次性改动角色资产调用点过大；真实提示词脚本迁入 `prompt::character_visual` 与 `prompt::character_animation`。
5. `custom_world_foundation_draft.rs` 只保留分阶段编排、JSON 解析、归一化和写回；所有阶段 prompt builder 迁入 `prompt::foundation_draft`。

## 4. 验收标准

1. `cargo fmt -p api-server` 通过。
2. `cargo check -p api-server` 通过。
3. 四条链路仍能从原调用点拿到相同语义的提示词。
4. 文档明确后续 prompt 修改主源在 `src/prompt/`。

## 5. 聊天类 Prompt 追加迁移

2026-04-25 追加迁移两类聊天提示词：

1. Agent 聊天创作：`server-rs/crates/api-server/src/prompt/agent_chat.rs`，承接原 `custom_world_rpg_draft_prompts.rs` 中的共创主系统提示词、状态识别提示词、输出契约、动态状态上下文、聊天历史上下文等脚本。
2. 游戏运行时与对方角色聊天：`server-rs/crates/api-server/src/prompt/runtime_chat.rs`，承接运行时剧情导演、NPC 对话导演、战斗结算叙事的 system prompt 与 user prompt 组装。

迁移后约束：

1. `custom_world_rpg_draft_prompts.rs` 只作为兼容 re-export，后续不要在该文件新增提示词正文。
2. `runtime_story/compat/ai.rs` 只负责读取状态、调用 LLM 和组装返回，不再内联 NPC 对话或剧情导演提示词。
3. 后续所有 Agent 共创聊天、运行时角色聊天的提示词调整统一进入 `src/prompt/`。