Genarrative/docs/reference/BUSINESS_PROMPT_INVENTORY_2026-04-19.md

# 业务提示词清单（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` | 角色形象 / 动作资产生成 | `buildNpcVisualPrompt`、`buildNpcAnimationPrompt`、`buildArkCharacterAnimationPrompt`、`buildImageSequencePrompt`、`buildNpcVisualNegativePrompt` |

### 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` |

### 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/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/customWorldRolePromptDefaults.ts` | 工作台默认词种子 | 角色视觉词、动画词、场景词默认值 |
| `src/prompts/customWorldEntityActionPrompts.ts` | 编辑器动作词 | 技能动作描述 prompt builder |

当前调用关系：

- `server-node/src/modules/assets/characterAssetRoutes.ts` 调用 `server-node/src/prompts/characterAssetPrompts.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/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 正文维护职责