1

docs/design/RPG_NPC_CHAT_HOSTILE_TERMINATION_AND_INLINE_FUNCTION_OPTIONS_2026-04-25.md

@@ -0,0 +1,80 @@
+# RPG NPC 聊天敌对中止与聊天内 Function 选项设计（2026-04-25）
+
+## 1. 目标
+
+本次迭代调整运行时 NPC 聊天，让敌对角色聊天从固定五回合上限改为由模型按当前语境判定是否中止；好感度大于等于 0 的角色继续保持可持续聊天，不由模型强制结束。
+
+同时，原本部分只在退出聊天后才出现的 NPC function 选项，需要进入聊天续写候选池。模型在生成聊天候选时要能看到可触发的 function 选项，并把它们改写成玩家可直接点击的动作文本。聊天中保留“换一换”能力，用于刷新下方候选。
+
+## 2. 行为规则
+
+1. 负好感或敌对 NPC 进入聊天后，不再设置固定 5 回合上限。
+2. 负好感或敌对 NPC 每轮回复后，模型必须判断本轮是否结束聊天。
+3. 敌对 NPC 判定时应偏向随时结束聊天并进入对峙，但必须结合玩家刚说的话、NPC 性格、当前剧情压力和对话历史。
+4. 好感度大于等于 0 且非敌对 NPC 不启用模型终止判定，玩家可一直聊天。
+5. 模型判定终止后，聊天面板不再继续提供聊天输入，只显示“继续”按钮，点击后沿用原流程继续生成冒险选项。
+6. 点击“退出聊天”不再直接收起聊天页，也不立即进入剧情推理；它会发送一条结束聊天的玩家输入，对方回复后同样只显示“继续”按钮。
+7. 正向 NPC 的退出聊天只是玩家主动收束，不代表模型强制中止，也不展示战斗/逃跑选项。
+8. 对负好感或敌对 NPC，在聊天终止后的后续流程仍沿用原敌对出口：继续推进后回到原有战斗或逃跑选择。
+9. 聊天候选中允许混入当前 NPC 可执行 function，例如交易、送礼、请求帮助、招募、接任务、交任务、开战、离开等。
+10. Function 候选进入聊天上下文时只作为可触发动作，不在 UI 中展示说明类文本。
+11. “换一换”在聊天态可用，用于在不推进对话的情况下改排/轮换当前候选；它不调用后端，不改变聊天历史。
+
+## 3. 后端契约
+
+`NpcChatTurnDirective` 增加：
+
+1. `terminationMode`：`none | hostile_model`
+2. `isHostileChat`：当前聊天是否按敌对中止规则处理
+3. `functionOptions`：可进入聊天候选的 function 列表，包含 `functionId`、`actionText`、`detailText`、`action`
+
+`NpcChatTurnCompletionDirective` 增加：
+
+1. `forceExit`：本轮回复后是否关闭聊天输入
+2. `closingMode`：保留 `free | foreshadow_close`
+3. `terminationReason`：`hostile_breakoff | player_exit | null`
+
+后端返回 `suggestions` 仍是字符串数组，前端按字符串生成 `npc_chat` 续写选项；新增 `functionSuggestions`，元素包含 `functionId` 与模型生成的 `actionText`，前端按对应 function 触发原 NPC action。
+
+## 4. Prompt 规则
+
+回复 prompt 需要明确：
+
+1. 敌对聊天可随时中止，NPC 更偏好结束谈判转入战斗或驱逐。
+2. 终止不等于在回复正文里直接执行战斗，只需要用台词把对话收束到对峙、威胁、驱逐、最后通牒或行动前一刻。
+3. 玩家主动退出聊天时，NPC 回复要对这次收束作出回应，并留下自然的后续入口。
+
+建议 prompt 需要明确：
+
+1. 常规聊天候选继续生成玩家台词。
+2. Function 候选要根据提供的 function 列表，改写成玩家可直接点击的动作文本。
+3. 不输出规则说明，不把 functionId 暴露给玩家。
+
+## 5. 前端流程
+
+1. `enterNpcChat` 与每轮 `handleNpcChatTurn` 统一构造聊天可用 function 列表。
+2. 聊天中的普通候选仍触发 `npc_chat`，function 候选触发原 `handleNpcInteraction` 分流。
+3. `exitNpcChat` 改为调用 `handleNpcChatTurn`，输入文本为结束聊天意图，并携带 `player_exit` 指令。
+4. 收到终止结果后，当前 `StoryMoment` 保留 `dialogue`，移除 `npcChatState`，`options` 只保留 `buildContinueAdventureOption()`。
+5. 点击“继续”后沿用已有 deferred continue / story continue 逻辑进入下一阶段。
+6. 聊天态“换一换”只轮换当前 `options`，若 function 候选不足则补普通聊天兜底候选。
+
+## 6. 追加规则：Function 标签与场景幕推进
+
+1. 运行时选项按钮需要在动作文本前展示 function 短标签，例如 `npc_chat` 显示“聊天”，`npc_quest_accept` / `npc_quest_turn_in` 显示“任务”，`npc_gift` 显示“送礼”。
+2. 标签只承担识别用途，不展示 functionId，也不展示规则说明。
+3. NPC 聊天终止后点击“继续冒险”，不再重新请求剧情推理；如果当前场景还有下一幕，直接进入下一幕并展示该幕可用的冒险选项。
+4. 当当前场景已经到最后一幕，再点击“继续冒险”应展示所有相邻场景入口；选项文案按方向表达为“向东走，前往xxxx”“向南走，前往xxxx”等。
+5. 相邻场景选项继续使用 `idle_travel_next_scene`，并在 `runtimePayload.targetSceneId` 中携带目标场景，后续点击沿用现有地图跳转结算。
+6. 若没有场景幕数据，则继续使用当前可用选项作为兜底，不额外生成规则说明文案。
+
+## 7. 验收
+
+1. 负好感主 NPC 不再出现固定 `turnLimit: 5`。
+2. 敌对 NPC 每轮请求会向后端传 `terminationMode: hostile_model`。
+3. 模型返回 `forceExit: true` 后，聊天输入消失，只显示继续按钮。
+4. 好感度大于等于 0 的 NPC 聊天不传敌对中止模式。
+5. 点击退出聊天会新增玩家结束聊天气泡与 NPC 回复，而不是直接切走面板。
+6. 聊天态可看到并点击 function 候选，且“换一换”可改变候选顺序。
+7. 选项文字前出现中文 function 标签，且标签不改变原 actionText。
+8. 聊天结束后的“继续冒险”直接进入下一幕；最后一幕则展示多个相邻场景方向入口。