1

docs/reference/BUSINESS_PROMPT_INVENTORY_2026-04-19.md

@@ -0,0 +1,185 @@
+# 业务提示词清单（2026-04-19）
+
+## 1. 目标
+
+这份清单用于回答两个问题：
+
+- 目前业务里到底有哪些提示词还在被使用。
+- 哪些提示词已经收口到独立目录，哪些仍散落在前后端与工具链里。
+
+本次统计范围：
+
+- `server-node/src/**`
+- `src/**`
+- `packages/shared/src/**`
+
+本次“提示词”统计口径包含：
+
+- system prompt
+- user prompt builder
+- repair prompt
+- negative prompt
+- 图像 / 动画生成 prompt
+- 编辑器里会直接喂给模型的默认 prompt 种子
+
+本次不计入：
+
+- 单纯转发 prompt 的接口入参校验
+- 普通剧情文案、UI 文案、剧情预设文本
+- 纯测试断言文件
+
+## 2. 当前结论
+
+截至 2026-04-19 本轮收口完成后，业务 prompt 主源已经集中到 3 个目录：
+
+1. `server-node/src/prompts/`
+2. `src/prompts/`
+3. `packages/shared/src/prompts/`
+
+当前业务模块、路由、服务层里的旧 prompt 文件大多已经退化成两类：
+
+- prompt 调用方
+- 薄 re-export 兼容层
+
+目前没有再发现“正式业务 prompt 正文仍长期内联在主流程文件里”的大块散点；剩余位于非 prompt 目录的相关文件，主要是兼容层、测试文件或普通调用方。
+
+## 3. 当前 Prompt 目录清单
+
+### 3.1 后端
+
+| 文件 | 业务域 | 关键导出 |
+| --- | --- | --- |
+| `server-node/src/prompts/storyPromptBuilders.ts` | 主剧情推进 | `SYSTEM_PROMPT`、`buildUserPrompt` |
+| `server-node/src/prompts/storyOrchestratorPrompts.ts` | 剧情语言修复 | `STORY_LANGUAGE_REPAIR_SYSTEM_PROMPT`、`buildStoryLanguageRepairPrompt` |
+| `server-node/src/prompts/chatPromptBuilders.ts` | 角色私聊 / NPC 对话 / 招募 | `CHARACTER_PANEL_CHAT_*`、`NPC_CHAT_*`、多个 `build*Prompt` |
+| `server-node/src/prompts/questPrompts.ts` | 任务意图 | `QUEST_INTENT_SYSTEM_PROMPT`、`buildQuestIntentPrompt` |
+| `server-node/src/prompts/runtimeItemPrompts.ts` | 运行时物品意图 | `RUNTIME_ITEM_INTENT_SYSTEM_PROMPT`、`buildRuntimeItemIntentPromptText` |
+| `server-node/src/prompts/customWorldOrchestratorPrompts.ts` | 自定义世界主编排 | `CUSTOM_WORLD_GENERATION_JSON_ONLY_SYSTEM_PROMPT`、`CUSTOM_WORLD_JSON_REPAIR_SYSTEM_PROMPT`、`buildCustomWorldProfilePrompt`、`buildCustomWorldProfileRepairPrompt` |
+| `server-node/src/prompts/customWorldAgentPrompts.ts` | 世界草稿增补 | `FOUNDATION_JSON_ONLY_SYSTEM_PROMPT`、`FOUNDATION_JSON_REPAIR_SYSTEM_PROMPT`、多个扩展 prompt |
+| `server-node/src/prompts/customWorldEntityPrompts.ts` | 世界编辑器实体生成 | `CUSTOM_WORLD_ENTITY_GENERATOR_SYSTEM_PROMPT`、`buildPlayablePrompt`、`buildStoryPrompt`、`buildLandmarkPrompt` |
+| `server-node/src/prompts/customWorldSceneNpcPrompts.ts` | 世界编辑器场景 NPC | `CUSTOM_WORLD_SCENE_NPC_SYSTEM_PROMPT`、`buildCustomWorldSceneNpcPrompt` |
+| `server-node/src/prompts/eightAnchorPrompts.ts` | 八锚点共创 | `BASE_SYSTEM_PROMPT`、`GLOBAL_HARD_RULES`、`MODE_RULES`、`USER_SIGNAL_RULES`、`buildPromptDynamicStateInferencePrompt`、`buildEightAnchorSingleTurnPrompt` |
+| `server-node/src/prompts/characterAssetPrompts.ts` | 角色形象 / 动作资产生成 | `CHARACTER_PROMPT_BUNDLE_SYSTEM_PROMPT`、`buildFallbackCharacterPromptBundle`、`buildCharacterPromptBundleUserPrompt`、`buildNpcVisualPrompt`、`buildNpcAnimationPrompt`、`buildArkCharacterAnimationPrompt` |
+
+### 3.2 前端
+
+| 文件 | 业务域 | 关键导出 |
+| --- | --- | --- |
+| `src/prompts/storyPromptBuilders.ts` | 剧情推进 | `SYSTEM_PROMPT`、`buildUserPrompt` |
+| `src/prompts/characterChatPrompts.ts` | 角色面板私聊 | `CHARACTER_PANEL_CHAT_*`、多个 `build*Prompt` |
+| `src/prompts/questPrompts.ts` | 前端任务意图兜底 | `QUEST_INTENT_SYSTEM_PROMPT`、`buildQuestIntentPrompt` |
+| `src/prompts/runtimeItemPrompts.ts` | 前端物品意图兜底 | `RUNTIME_ITEM_INTENT_SYSTEM_PROMPT`、`buildRuntimeItemIntentPrompt` |
+| `src/prompts/customWorldPrompts.ts` | 自定义世界分阶段生成 + 场景背景图 | 多个 `buildCustomWorld*Prompt`、`DEFAULT_CUSTOM_WORLD_SCENE_IMAGE_NEGATIVE_PROMPT` |
+| `src/prompts/customWorldOrchestratorPrompts.ts` | 世界 JSON 修复 / JSON only | `CUSTOM_WORLD_JSON_REPAIR_SYSTEM_PROMPT`、`CUSTOM_WORLD_GENERATION_JSON_ONLY_SYSTEM_PROMPT` |
+| `src/prompts/storyOrchestratorPrompts.ts` | 剧情中文修复 | `STORY_LANGUAGE_REPAIR_SYSTEM_PROMPT` |
+| `src/prompts/customWorldRolePromptDefaults.ts` | 角色资产工作台默认词 | `buildDefaultRolePromptBundle` |
+| `src/prompts/customWorldEntityActionPrompts.ts` | 编辑器技能动作词 | `buildSkillActionPrompt` |
+| `src/prompts/qwenSpriteSheetToolPrompts.ts` | Qwen 精灵图工具 prompt 模型 | 主 prompt / sheet prompt / repair prompt / negative prompt 系列 |
+
+### 3.3 共享层
+
+| 文件 | 业务域 | 关键导出 |
+| --- | --- | --- |
+| `packages/shared/src/prompts/qwenSprite.ts` | 共享像素角色主 prompt 模板 | `QWEN_SPRITE_ACTION_TEMPLATES`、`buildMasterPrompt`、`buildVideoActionPrompt`、`getActionTemplateById` |
+
+## 4. 兼容层与调用层
+
+为了避免一次性打断旧引用，当前保留了若干兼容层：
+
+- `src/services/prompt.ts`
+- `src/services/characterChatPrompt.ts`
+- `src/services/questPrompt.ts`
+- `src/services/runtimeItemAiPrompt.ts`
+- `server-node/src/services/eightAnchorPromptBuilder.ts`
+- `src/tools/qwenSpriteSheetToolModel.ts`
+- `src/components/asset-studio/customWorldRolePromptDefaults.ts`
+- `packages/shared/src/assets/qwenSprite.ts`
+
+这些文件当前职责是：
+
+- 维持旧路径可用
+- re-export 到新的 prompt 目录
+
+它们不再是 prompt 正文主源。
+
+## 5. AI 角色形象生成当前来源
+
+这部分是你点名要求补齐的重点，现在已经收口为：
+
+| 文件 | 角色 | 当前定位 |
+| --- | --- | --- |
+| `server-node/src/prompts/characterAssetPrompts.ts` | 正式角色资产生成 prompt | 后端角色主图、动作试片、角色场景词主源 |
+| `packages/shared/src/prompts/qwenSprite.ts` | 共享角色主 prompt 模板 | 共享给后端资产链使用的基础模板 |
+| `src/prompts/qwenSpriteSheetToolPrompts.ts` | 工具链 prompt 模型 | Qwen 精灵图工具主词、分镜词、修帧词、负面词 |
+| `src/prompts/customWorldRolePromptDefaults.ts` | 工作台默认词种子 | 角色视觉词、动画词、场景词默认值 |
+| `src/prompts/customWorldEntityActionPrompts.ts` | 编辑器动作词 | 技能动作描述 prompt builder |
+
+当前调用关系：
+
+- `server-node/src/modules/assets/characterAssetRoutes.ts` 调用 `server-node/src/prompts/characterAssetPrompts.ts`
+- `src/tools/QwenSpriteSheetTool.tsx` 通过兼容层消费 `src/prompts/qwenSpriteSheetToolPrompts.ts`
+- `src/components/CustomWorldRoleAssetStudioModal.tsx` 通过兼容层消费 `src/prompts/customWorldRolePromptDefaults.ts`
+- `src/components/CustomWorldEntityEditorModal.tsx` 直接调用 `src/prompts/customWorldEntityActionPrompts.ts`
+
+## 6. AI 场景背景生成当前来源
+
+场景背景图 prompt 现在已经从业务流程文件里抽出，统一主源是：
+
+| 文件 | 角色 | 当前定位 |
+| --- | --- | --- |
+| `src/prompts/customWorldPrompts.ts` | 场景背景图 prompt 主源 | `buildCustomWorldSceneImagePrompt`、`DEFAULT_CUSTOM_WORLD_SCENE_IMAGE_NEGATIVE_PROMPT` |
+| `src/services/ai.ts` | 前端编排调用方 | 组装请求并调用同一份 prompt builder |
+| `server-node/src/services/sceneImageService.ts` | 后端执行器调用方 | 在服务端用同一份 prompt builder 生成 prompt，再请求上游模型 |
+
+这条链的关键变化是：
+
+- 不再让 `src/services/customWorld.ts` 承担场景图 prompt 正文主源
+- 前后端场景图生成改为共用 `src/prompts/customWorldPrompts.ts`
+
+## 7. 本轮完成的原散点收口
+
+本轮已经完成的原散点包括：
+
+- `server-node/src/modules/assets/characterAssetRoutes.ts` 中的角色资产 prompt
+- `server-node/src/services/eightAnchorPromptBuilder.ts` 中的八锚点 prompt
+- `src/services/customWorld.ts` 中的自定义世界分阶段 prompt 与场景背景图 prompt
+- `src/services/ai.ts` 中的世界修复 / 语言修复 / JSON only system prompt
+- `src/services/prompt.ts`、`characterChatPrompt.ts`、`questPrompt.ts`、`runtimeItemAiPrompt.ts` 这批前端 prompt 脚本
+- `src/tools/qwenSpriteSheetToolModel.ts`、`src/components/asset-studio/customWorldRolePromptDefaults.ts`、`src/components/CustomWorldEntityEditorModal.tsx` 里的工具 / 编辑器 prompt 散点
+
+## 8. 当前仍在非 Prompt 目录中的相关文件
+
+仍在非 prompt 目录中的相关文件，当前主要是：
+
+- 调用方
+- 兼容层
+- 测试
+
+因此现在的工程状态已经从“散点查找”变成“目录集中 + 兼容过渡”。
+
+## 9. 验证结果
+
+本轮收口后已验证：
+
+- `npm run check:encoding`
+- `npm --prefix server-node run build`
+- `npm run build`
+- `npm run server-node:test`
+
+结果：
+
+- 编码检查通过
+- 前端构建通过
+- 后端构建通过
+- `server-node` 测试 143 项全部通过
+
+## 10. 本次盘点后的判断
+
+截至 2026-04-19，本仓库的业务 prompt 已经基本完成目录化管理。
+
+当前更准确的结论是：
+
+- 后端正式业务 prompt 主源集中在 `server-node/src/prompts/`
+- 前端与编辑器 prompt 主源集中在 `src/prompts/`
+- 共享资产 prompt 主源集中在 `packages/shared/src/prompts/`
+- 旧服务路径、旧工具路径仍保留为兼容层，但不再承担 prompt 正文维护职责

docs/reference/README.md

@@ -2,6 +2,7 @@
 
 ## 当前入口
 
+- [BUSINESS_PROMPT_INVENTORY_2026-04-19.md](./BUSINESS_PROMPT_INVENTORY_2026-04-19.md)：业务中现存提示词的总清单，覆盖后端主链、前端遗留、自定义世界、角色形象生成、场景背景生成与工具链 prompt。
 - [FUNCTION_SCRIPT_CATALOG_2026-04-04.md](./FUNCTION_SCRIPT_CATALOG_2026-04-04.md)：Function 独立脚本目录与分类速查。
 - [TASK_GENERATION_TRACE_2026-04-08.md](./TASK_GENERATION_TRACE_2026-04-08.md)：任务描述、达成条件与奖励生成链路梳理。
 - [CUSTOM_WORLD_TEMPLATE_DEPENDENCY_INVENTORY_2026-04-08.md](./CUSTOM_WORLD_TEMPLATE_DEPENDENCY_INVENTORY_2026-04-08.md)：自定义世界当前仍依赖哪些模板世界设定的清单。