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 正文维护职责