初始仓库迁移

src/data/functionCatalog/npc/npcSpar.ts

@@ -0,0 +1,29 @@
+import type { FunctionDocumentationEntry } from '../types';
+
+/**
+ * npc_spar
+ *
+ * 与眼前 NPC 切磋武艺的非致命战斗 function。
+ */
+export const NPC_SPAR_FUNCTION: FunctionDocumentationEntry = {
+  id: 'npc_spar',
+  domain: 'npc',
+  title: '与对方切磋武艺',
+  source: 'src/data/functionCatalog/npc/npcSpar.ts',
+  summary: '把 NPC 互动切到点到为止的 spar 战斗模式。',
+  detailedDescription:
+    '它和 npc_fight 共用战斗骨架，但数值与结算目标不同，重点是以低伤害对局换取关系推进，而不是击杀或掠夺。',
+  trigger: '在可交流的 NPC 菜单里作为友好或试探性过招选项出现。',
+  execution: '点击后进入 spar 模式，本地规则会限制伤害与战后回场逻辑。',
+  result: '切磋结束后通常返回 NPC 场景，并小幅提高 affinity 或推进相关任务。',
+  active: true,
+  runtime: {
+    storyMode: 'special_sequence',
+    uiMode: 'none',
+    executor: 'src/hooks/story/npcEncounterActions.ts -> handleNpcInteraction',
+    animationNote: '切到 spar 战斗模式后，由战斗播放链路驱动切磋演出。',
+    storyNote: '不会先弹窗，直接进入点到为止的切磋流程。',
+    uiNote: '不弹 modal，直接切磋。',
+    compactDetailText: '切磋几招看身手',
+  },
+};