import type { FunctionDocumentationEntry } from '../types';

/**
 * npc_help
 *
 * 向眼前 NPC 寻求帮助或支援的 function。
 */
export const NPC_HELP_FUNCTION: FunctionDocumentationEntry = {
  id: 'npc_help',
  domain: 'npc',
  title: '向对方寻求帮助',
  source: 'src/data/functionCatalog/npc/npcHelp.ts',
  summary: '从 NPC 处申请一次性补给、回复或援助。',
  detailedDescription:
    '它把 NPC 互动导向资源支持，奖励内容由本地规则预先计算，避免关键数值完全交给模型临场决定。',
  trigger: 'NPC 允许帮助且该角色尚未消耗过 helpUsed 时出现。',
  execution: '点击后直接按本地奖励规则结算，然后继续推进后续剧情。',
  result:
    '玩家可能获得生命、灵力、冷却收益或道具补给，并让故事承接“被对方照应了一次”。',
  active: true,
  runtime: {
    storyMode: 'local_effect_then_generate',
    uiMode: 'none',
    executor:
      'src/hooks/rpg-runtime-story/useRpgRuntimeNpcInteraction.ts -> handleNpcInteraction',
    animationNote: '不单独开窗口，直接在当前交互里结算帮助结果。',
    storyNote: '点击后立即按本地奖励规则结算，并继续生成新的故事状态。',
    uiNote: '不弹 modal，直接获得帮助反馈。',
    compactDetailText: '看看能得到什么帮助',
  },
};