Refine NPC interactions and runtime item generation

2026-04-05 17:13:07 +08:00
parent c49c64896a
commit 89cecda7da
58 changed files with 4199 additions and 1562 deletions
--- a/src/hooks/story/characterChat.ts
+++ b/src/hooks/story/characterChat.ts
@@ -283,7 +283,7 @@ export function useCharacterChatFlow({
              messages: baseMessages,
              isSending: false,
              isLoadingSuggestions: false,
-              error: error instanceof Error ? error.message : '未知 AI 错误',
+              error: error instanceof Error ? error.message : '未知智能生成错误',
              suggestions: current.suggestions.length > 0
                ? current.suggestions
                : buildLocalCharacterChatSuggestions(target.character),
--- a/src/hooks/story/choiceActions.ts
+++ b/src/hooks/story/choiceActions.ts
@@ -472,7 +472,7 @@ export function createStoryChoiceActions({
            setCurrentStory(nextStory);
          } catch (storyError) {
            console.error('Failed to continue npc battle resolution story:', storyError);
-            setAiError(storyError instanceof Error ? storyError.message : '未知 AI 错误');
+            setAiError(storyError instanceof Error ? storyError.message : '未知智能生成错误');
            setCurrentStory(buildFallbackStoryForState(nextState, character, victory.resultText));
          }
          return;
@@ -533,7 +533,7 @@ export function createStoryChoiceActions({
      );
    } catch (error) {
      console.error('Failed to get next step:', error);
-      setAiError(error instanceof Error ? error.message : '未知 AI 错误');
+      setAiError(error instanceof Error ? error.message : '未知智能生成错误');
      setCurrentStory(buildFallbackStoryForState(fallbackState, character));
    } finally {
      setIsLoading(false);
--- a/src/hooks/story/npcEncounterActions.ts
+++ b/src/hooks/story/npcEncounterActions.ts
@@ -11,6 +11,7 @@ import {
  buildNpcLeaveResultText,
  buildNpcSparResultText,
  createNpcBattleMonster,
+  generateNpcHelpReward,
  getChatAffinityOutcome,
  getNpcLootItems,
  getNpcSparMaxHp,
@@ -36,6 +37,7 @@ import {
 } from '../../data/sceneEncounterPreviews';
 import { generateNextStep, streamNpcChatDialogue } from '../../services/ai';
 import type { StoryGenerationContext } from '../../services/aiTypes';
+import { generateQuestForNpcEncounter } from '../../services/questDirector';
 import type {
  Character,
  Encounter,
@@ -459,7 +461,7 @@ export function createStoryNpcEncounterActions({
      await typewriterPromise;
      console.error('Failed to stream npc chat story:', error);
      setAiError(
-        error instanceof Error ? error.message : 'NPC 对话 AI 不可用。',
+        error instanceof Error ? error.message : '角色对话智能生成不可用。',
      );
      const fallbackOptions =
        getAvailableOptionsForState(provisionalState, character) ?? [];
@@ -545,51 +547,136 @@ export function createStoryNpcEncounterActions({

    switch (option.interaction.action) {
      case 'help': {
-        const reward = buildNpcHelpReward(encounter);
-        let cooldowns = gameState.playerSkillCooldowns;
-        for (let index = 0; index < (reward.cooldownBonus ?? 0); index += 1) {
-          cooldowns = Object.fromEntries(
-            Object.entries(cooldowns).map(([skillId, turns]) => [
-              skillId,
-              Math.max(0, turns - 1),
-            ]),
-          );
-        }
+        setAiError(null);
+        setIsLoading(true);
+        void (async () => {
+          let committed = false;

-        let nextState = updateNpcState(
-          gameState,
-          encounter,
-          (currentNpcState) => ({
-            ...markNpcFirstMeaningfulContactResolved(currentNpcState),
-            helpUsed: true,
-          }),
-        );
+          try {
+            const reward = await generateNpcHelpReward(encounter, gameState);
+            let cooldowns = gameState.playerSkillCooldowns;
+            for (
+              let index = 0;
+              index < (reward.cooldownBonus ?? 0);
+              index += 1
+            ) {
+              cooldowns = Object.fromEntries(
+                Object.entries(cooldowns).map(([skillId, turns]) => [
+                  skillId,
+                  Math.max(0, turns - 1),
+                ]),
+              );
+            }

-        nextState = {
-          ...nextState,
-          playerHp: Math.min(
-            nextState.playerMaxHp,
-            nextState.playerHp + (reward.hp ?? 0),
-          ),
-          playerMana: Math.min(
-            nextState.playerMaxMana,
-            nextState.playerMana + (reward.mana ?? 0),
-          ),
-          playerSkillCooldowns: cooldowns,
-          playerInventory: reward.item
-            ? addInventoryItems(nextState.playerInventory, [
-                cloneInventoryItemForOwner(reward.item, 'player'),
-              ])
-            : nextState.playerInventory,
-        };
+            let nextState = updateNpcState(
+              gameState,
+              encounter,
+              (currentNpcState) => ({
+                ...markNpcFirstMeaningfulContactResolved(currentNpcState),
+                helpUsed: true,
+              }),
+            );

-        void commitGeneratedState(
-          nextState,
-          gameState.playerCharacter,
-          option.actionText,
-          buildNpcHelpResultText(encounter, reward),
-          option.functionId,
-        );
+            nextState = {
+              ...nextState,
+              playerHp: Math.min(
+                nextState.playerMaxHp,
+                nextState.playerHp + (reward.hp ?? 0),
+              ),
+              playerMana: Math.min(
+                nextState.playerMaxMana,
+                nextState.playerMana + (reward.mana ?? 0),
+              ),
+              playerSkillCooldowns: cooldowns,
+              playerInventory:
+                reward.items.length > 0
+                  ? addInventoryItems(
+                      nextState.playerInventory,
+                      reward.items.map((item) =>
+                        cloneInventoryItemForOwner(
+                          item,
+                          'player',
+                          item.quantity,
+                        ),
+                      ),
+                    )
+                  : nextState.playerInventory,
+            };
+
+            await commitGeneratedState(
+              nextState,
+              gameState.playerCharacter,
+              option.actionText,
+              buildNpcHelpResultText(encounter, reward),
+              option.functionId,
+            );
+            committed = true;
+          } catch (error) {
+            console.error('Failed to resolve npc help reward:', error);
+            const reward = buildNpcHelpReward(encounter, gameState);
+            let cooldowns = gameState.playerSkillCooldowns;
+            for (
+              let index = 0;
+              index < (reward.cooldownBonus ?? 0);
+              index += 1
+            ) {
+              cooldowns = Object.fromEntries(
+                Object.entries(cooldowns).map(([skillId, turns]) => [
+                  skillId,
+                  Math.max(0, turns - 1),
+                ]),
+              );
+            }
+
+            let nextState = updateNpcState(
+              gameState,
+              encounter,
+              (currentNpcState) => ({
+                ...markNpcFirstMeaningfulContactResolved(currentNpcState),
+                helpUsed: true,
+              }),
+            );
+
+            nextState = {
+              ...nextState,
+              playerHp: Math.min(
+                nextState.playerMaxHp,
+                nextState.playerHp + (reward.hp ?? 0),
+              ),
+              playerMana: Math.min(
+                nextState.playerMaxMana,
+                nextState.playerMana + (reward.mana ?? 0),
+              ),
+              playerSkillCooldowns: cooldowns,
+              playerInventory:
+                reward.items.length > 0
+                  ? addInventoryItems(
+                      nextState.playerInventory,
+                      reward.items.map((item) =>
+                        cloneInventoryItemForOwner(
+                          item,
+                          'player',
+                          item.quantity,
+                        ),
+                      ),
+                    )
+                  : nextState.playerInventory,
+            };
+
+            await commitGeneratedState(
+              nextState,
+              gameState.playerCharacter,
+              option.actionText,
+              buildNpcHelpResultText(encounter, reward),
+              option.functionId,
+            );
+            committed = true;
+          } finally {
+            if (!committed) {
+              setIsLoading(false);
+            }
+          }
+        })();
        return true;
      }
      case 'chat': {
@@ -645,32 +732,83 @@ export function createStoryNpcEncounterActions({
          getNpcEncounterKey(encounter),
        );
        if (existingQuest) return true;
+        setAiError(null);
+        setIsLoading(true);
+        void (async () => {
+          let committed = false;

-        const quest = buildQuestForEncounter({
-          issuerNpcId: getNpcEncounterKey(encounter),
-          issuerNpcName: encounter.npcName,
-          roleText: encounter.context,
-          scene: gameState.currentScenePreset,
-          worldType: gameState.worldType,
-        });
-        if (!quest) return true;
+          try {
+            const quest =
+              (await generateQuestForNpcEncounter({
+                state: gameState,
+                encounter,
+              })) ??
+              buildQuestForEncounter({
+                issuerNpcId: getNpcEncounterKey(encounter),
+                issuerNpcName: encounter.npcName,
+                roleText: encounter.context,
+                scene: gameState.currentScenePreset,
+                worldType: gameState.worldType,
+              });
+            if (!quest) {
+              return;
+            }

-        const nextState = incrementRuntimeStats(
-          updateNpcState(
-            updateQuestLog(gameState, (quests) => acceptQuest(quests, quest)),
-            encounter,
-            (currentNpcState) =>
-              markNpcFirstMeaningfulContactResolved(currentNpcState),
-          ),
-          { questsAccepted: 1 },
-        );
-        void commitGeneratedState(
-          nextState,
-          gameState.playerCharacter,
-          option.actionText,
-          buildQuestAcceptResultText(quest),
-          option.functionId,
-        );
+            const nextState = incrementRuntimeStats(
+              updateNpcState(
+                updateQuestLog(gameState, (quests) => acceptQuest(quests, quest)),
+                encounter,
+                (currentNpcState) =>
+                  markNpcFirstMeaningfulContactResolved(currentNpcState),
+              ),
+              {questsAccepted: 1},
+            );
+            await commitGeneratedState(
+              nextState,
+              gameState.playerCharacter,
+              option.actionText,
+              buildQuestAcceptResultText(quest),
+              option.functionId,
+            );
+            committed = true;
+          } catch (error) {
+            console.error('Failed to accept npc quest:', error);
+            const fallbackQuest = buildQuestForEncounter({
+              issuerNpcId: getNpcEncounterKey(encounter),
+              issuerNpcName: encounter.npcName,
+              roleText: encounter.context,
+              scene: gameState.currentScenePreset,
+              worldType: gameState.worldType,
+            });
+            if (!fallbackQuest) {
+              return;
+            }
+
+            const nextState = incrementRuntimeStats(
+              updateNpcState(
+                updateQuestLog(gameState, (quests) =>
+                  acceptQuest(quests, fallbackQuest),
+                ),
+                encounter,
+                (currentNpcState) =>
+                  markNpcFirstMeaningfulContactResolved(currentNpcState),
+              ),
+              {questsAccepted: 1},
+            );
+            await commitGeneratedState(
+              nextState,
+              gameState.playerCharacter,
+              option.actionText,
+              buildQuestAcceptResultText(fallbackQuest),
+              option.functionId,
+            );
+            committed = true;
+          } finally {
+            if (!committed) {
+              setIsLoading(false);
+            }
+          }
+        })();
        return true;
      }
      case 'quest_turn_in': {
--- a/src/hooks/story/npcInteraction.ts
+++ b/src/hooks/story/npcInteraction.ts
@@ -17,12 +17,16 @@ import {
 } from '../../data/economy';
 import {
  addInventoryItems,
+  buildNpcGiftCommitActionText,
  buildNpcGiftResultText,
  buildNpcRecruitResultText,
+  buildNpcTradeTransactionActionText,
  buildNpcTradeTransactionResultText,
  getGiftCandidates,
+  getPreferredGiftItemId,
  markNpcFirstMeaningfulContactResolved,
  removeInventoryItem,
+  syncNpcTradeInventory,
 } from '../../data/npcInteractions';
 import { streamNpcRecruitDialogue } from '../../services/ai';
 import type { StoryGenerationContext } from '../../services/aiTypes';
@@ -326,7 +330,7 @@ export function useStoryNpcInteractionFlow({
      })
      .catch(error => {
        console.error('Failed to continue recruit story:', error);
-        runtime.setAiError(error instanceof Error ? error.message : '未知 AI 错误');
+        runtime.setAiError(error instanceof Error ? error.message : '未知智能生成错误');
        runtime.setCurrentStory(
          runtime.buildFallbackStoryForState(stateWithHistory, gameState.playerCharacter!, recruitResultText),
        );
@@ -412,7 +416,7 @@ export function useStoryNpcInteractionFlow({
      await typewriterPromise;
      console.error('Failed to stream recruit dialogue:', error);
      dialogueText = displayedText || buildOfflineRecruitDialogue(encounter, releasedCompanionName);
-      runtime.setAiError(error instanceof Error ? error.message : '未知 AI 错误');
+      runtime.setAiError(error instanceof Error ? error.message : '未知智能生成错误');
    }

    const finalDialogueText = normalizeRecruitDialogue(
@@ -426,7 +430,20 @@ export function useStoryNpcInteractionFlow({
  };

  const openTradeModal = (encounter: Encounter, actionText: string) => {
-    const npcState = getResolvedNpcState(gameState, encounter);
+    const currentNpcState = getResolvedNpcState(gameState, encounter);
+    const npcState = syncNpcTradeInventory(
+      gameState,
+      encounter,
+      currentNpcState,
+    );
+
+    if (
+      gameState.npcStates[getNpcEncounterKey(encounter)] !== npcState
+      || npcState !== currentNpcState
+    ) {
+      setGameState(updateNpcState(gameState, encounter, () => npcState));
+    }
+
    setTradeModal({
      encounter,
      actionText,
@@ -438,10 +455,20 @@ export function useStoryNpcInteractionFlow({
  };

  const openGiftModal = (encounter: Encounter, actionText: string) => {
+    const selectedItemId = getPreferredGiftItemId(
+      gameState.playerInventory,
+      encounter,
+      {
+        worldType: gameState.worldType,
+        customWorldProfile: gameState.customWorldProfile,
+      },
+    );
+    if (!selectedItemId) return;
+
    setGiftModal({
      encounter,
      actionText,
-      selectedItemId: gameState.playerInventory[0]?.id ?? null,
+      selectedItemId,
    });
  };

@@ -494,7 +521,12 @@ export function useStoryNpcInteractionFlow({
      void commitGeneratedState(
        nextState,
        gameState.playerCharacter,
-        tradeModal.actionText,
+        buildNpcTradeTransactionActionText({
+          encounter,
+          mode: 'buy',
+          item: npcItem,
+          quantity,
+        }),
        buildNpcTradeTransactionResultText({
          encounter,
          mode: 'buy',
@@ -534,7 +566,12 @@ export function useStoryNpcInteractionFlow({
    void commitGeneratedState(
      nextState,
      gameState.playerCharacter,
-      tradeModal.actionText,
+      buildNpcTradeTransactionActionText({
+        encounter,
+        mode: 'sell',
+        item: playerItem,
+        quantity,
+      }),
      buildNpcTradeTransactionResultText({
        encounter,
        mode: 'sell',
@@ -590,7 +627,7 @@ export function useStoryNpcInteractionFlow({
    void commitGeneratedState(
      nextState,
      gameState.playerCharacter,
-      giftModal.actionText,
+      buildNpcGiftCommitActionText(encounter, giftItem),
      buildNpcGiftResultText(encounter, giftItem, affinityGain, nextAffinity, attributeSummary ?? undefined),
      'npc_gift',
    );
--- a/src/hooks/story/openingAdventure.ts
+++ b/src/hooks/story/openingAdventure.ts
@@ -269,7 +269,7 @@ export async function playOpeningAdventureSequence({
      }
    } catch (error) {
      console.error('Failed to infer opening camp dialogue:', error);
-      setAiError(error instanceof Error ? error.message : '未知 AI 错误');
+      setAiError(error instanceof Error ? error.message : '未知智能生成错误');
    }

    const finalHistory = [
@@ -313,7 +313,7 @@ export async function playOpeningAdventureSequence({
    );
  } catch (error) {
    console.error('Failed to play opening adventure sequence:', error);
-    setAiError(error instanceof Error ? error.message : '未知 AI 错误');
+    setAiError(error instanceof Error ? error.message : '未知智能生成错误');
    setCurrentStory(
      buildDialogueStoryMoment(
        encounter.npcName,
--- a/src/hooks/story/progressionActions.ts
+++ b/src/hooks/story/progressionActions.ts
@@ -100,7 +100,7 @@ export function createStoryProgressionActions({
      setCurrentStory(nextStory);
    } catch (error) {
      console.error('Failed to continue scripted story:', error);
-      setAiError(error instanceof Error ? error.message : '未知 AI 错误');
+      setAiError(error instanceof Error ? error.message : '未知智能生成错误');
      setCurrentStory(buildFallbackStoryForState(stateWithHistory, character, resultText));
    } finally {
      setIsLoading(false);
@@ -149,7 +149,7 @@ export function createStoryProgressionActions({
      setCurrentStory(nextStory);
    } catch (error) {
      console.error('Failed to continue encounter-entry story:', error);
-      setAiError(error instanceof Error ? error.message : '未知 AI 错误');
+      setAiError(error instanceof Error ? error.message : '未知智能生成错误');
      setCurrentStory(buildFallbackStoryForState(stateWithHistory, character, resultText));
    } finally {
      setIsLoading(false);
--- a/src/hooks/story/storyGenerationState.test.ts
+++ b/src/hooks/story/storyGenerationState.test.ts
@@ -34,7 +34,10 @@ vi.mock('../../data/scenePresets', () => ({
  getWorldCampScenePreset: () => scenes[0] ?? null,
 }));

-import { buildInitialNpcState, MAX_COMPANIONS } from '../../data/npcInteractions';
+import {
+  buildInitialNpcState,
+  MAX_COMPANIONS,
+} from '../../data/npcInteractions';
 import { getScenePresetsByWorld } from '../../data/scenePresets';
 import {
  AnimationState,
@@ -74,7 +77,11 @@ function createCharacter(): Character {
  };
 }

-function createInventoryItem(id: string, name: string): InventoryItem {
+function createInventoryItem(
+  id: string,
+  name: string,
+  overrides: Partial<InventoryItem> = {},
+): InventoryItem {
  return {
    id,
    name,
@@ -84,6 +91,7 @@ function createInventoryItem(id: string, name: string): InventoryItem {
    rarity: 'common',
    tags: [],
    value: 1,
+    ...overrides,
  };
 }

@@ -229,6 +237,46 @@ describe('storyGenerationState', () => {
    expect(decision.modal.selectedReleaseNpcId).toBe('npc-1');
  });

+  it('opens the gift modal with the preferred gift candidate selected', () => {
+    const state = {
+      ...createBaseState(),
+      playerInventory: [
+        createInventoryItem('empty-slot', 'Empty Slot', { quantity: 0 }),
+        createInventoryItem('jade-token', 'Jade Token', {
+          rarity: 'rare',
+          category: '专属',
+          tags: ['merchant'],
+        }),
+      ],
+    };
+
+    const decision = resolveNpcInteractionDecision(
+      state,
+      createInteractionOption('gift'),
+    );
+
+    expect(decision.kind).toBe('gift_modal');
+    if (decision.kind !== 'gift_modal') {
+      throw new Error('Expected gift modal decision');
+    }
+
+    expect(decision.modal.selectedItemId).toBe('jade-token');
+  });
+
+  it('does not open the gift modal when there are no gift candidates', () => {
+    const state = {
+      ...createBaseState(),
+      playerInventory: [],
+    };
+
+    const decision = resolveNpcInteractionDecision(
+      state,
+      createInteractionOption('gift'),
+    );
+
+    expect(decision.kind).toBe('none');
+  });
+
  it('builds a map travel transition that increments runtime stats and clears battle state', () => {
    const scenes = getScenePresetsByWorld(WorldType.WUXIA);
    const sourceScene = scenes[0];
--- a/src/hooks/story/storyGenerationState.ts
+++ b/src/hooks/story/storyGenerationState.ts
@@ -9,6 +9,7 @@ import {
 } from '../../data/functionCatalog';
 import {
  buildInitialNpcState,
+  getPreferredGiftItemId,
  MAX_COMPANIONS,
 } from '../../data/npcInteractions';
 import { incrementGameRuntimeStats } from '../../data/runtimeStats';
@@ -83,10 +84,29 @@ export function resolveNpcInteractionDecision(
        ),
      };
    case NPC_GIFT_FUNCTION.id:
-      return {
-        kind: 'gift_modal',
-        modal: buildNpcGiftModalState(state, encounter, option.actionText),
-      };
+      {
+        const selectedGiftItemId = getPreferredGiftItemId(
+          state.playerInventory,
+          encounter,
+          {
+            worldType: state.worldType,
+            customWorldProfile: state.customWorldProfile,
+          },
+        );
+        if (!selectedGiftItemId) {
+          return { kind: 'none' };
+        }
+
+        return {
+          kind: 'gift_modal',
+          modal: buildNpcGiftModalState(
+            state,
+            encounter,
+            option.actionText,
+            selectedGiftItemId,
+          ),
+        };
+      }
    case NPC_RECRUIT_FUNCTION.id:
      if (shouldNpcRecruitOpenModal(state.companions.length, MAX_COMPANIONS)) {
        return {