Rework story engine flow and reorganize project docs

src/components/SkillEffectPreview.tsx

@@ -3,7 +3,7 @@ import { useEffect, useMemo, useState } from 'react';
 
 import { getCharacterAnimationDurationMs, getSkillCasterAnimation, getSkillDelivery } from '../data/characterCombat';
 import { PRESET_CHARACTERS } from '../data/characterPresets';
-import { createSceneMonstersFromIds } from '../data/monsters';
+import { createSceneHostileNpcsFromIds } from '../data/hostileNpcs';
 import { buildInitialNpcState, createNpcBattleMonster } from '../data/npcInteractions';
 import { getScenePreset } from '../data/scenePresets';
 import { buildSkillEffects } from '../hooks/useCombatFlow';
@@ -14,7 +14,7 @@ import {
   CombatActionMode,
   CombatVisualEffect,
   Encounter,
-  SceneMonster,
+  SceneHostileNpc,
   WorldType,
 } from '../types';
 import { GameCanvas } from './GameCanvas';
@@ -38,7 +38,7 @@ function getSkillReleaseDelayMs(character: Character, skill: CharacterSkillDefin
 }
 
 function buildPreviewTargetMonster(worldType: WorldType, targetMonsterId?: string | null) {
-  const previewMonster = createSceneMonstersFromIds(
+  const previewMonster = createSceneHostileNpcsFromIds(
     worldType,
     targetMonsterId ? [targetMonsterId] : [],
     PLAYER_X,
@@ -54,7 +54,7 @@ function buildPreviewTargetMonster(worldType: WorldType, targetMonsterId?: strin
     : null;
 }
 
-function resetNpcPreviewMonster(monster: SceneMonster) {
+function resetNpcPreviewMonster(monster: SceneHostileNpc) {
   return {
     ...monster,
     animation: 'idle' as const,
@@ -100,7 +100,7 @@ export function SkillEffectPreview({
 
   const [playerAnimation, setPlayerAnimation] = useState(AnimationState.IDLE);
   const [playerActionMode, setPlayerActionMode] = useState<CombatActionMode>('idle');
-  const [sceneMonsters, setSceneMonsters] = useState<SceneMonster[]>(initialMonsters);
+  const [sceneHostileNpcs, setSceneMonsters] = useState<SceneHostileNpc[]>(initialMonsters);
   const [activeCombatEffects, setActiveCombatEffects] = useState<CombatVisualEffect[]>([]);
   const [replayTick, setReplayTick] = useState(0);
   const [isPlaying, setIsPlaying] = useState(false);
@@ -224,7 +224,7 @@ export function SkillEffectPreview({
         <div>
           <div className="text-sm font-semibold text-white">{skill?.name ?? '未选择技能'}</div>
           <div className="mt-1 text-xs text-zinc-400">
-            {mode === 'player' ? `受击对象：${sceneMonsters[0]?.name ?? '无目标'}` : `受击对象：${fallbackTargetCharacter.name}`}
+            {mode === 'player' ? `受击对象：${sceneHostileNpcs[0]?.name ?? '无目标'}` : `受击对象：${fallbackTargetCharacter.name}`}
           </div>
         </div>
         <button
@@ -247,7 +247,7 @@ export function SkillEffectPreview({
             encounter={null}
             currentScenePreset={scenePreset}
             worldType={worldType}
-            sceneMonsters={sceneMonsters}
+            sceneHostileNpcs={sceneHostileNpcs}
             playerX={PLAYER_X}
             playerOffsetY={0}
             playerFacing="right"