1

docs/reference/FUNCTION_SCRIPT_CATALOG_2026-04-04.md

@@ -112,7 +112,7 @@
 
 - `npc_help`
   脚本：`src/data/functionCatalog/npc/npcHelp.ts`
-  说明：向 NPC 寻求补给、回复或支援的 function。奖励由本地规则稳定计算，避免帮助收益被模型临场漂移。
+  说明：向 NPC 寻求补给、回复或支援的 function。正式奖励、资源变化与 one-shot 状态由后端 runtime action resolver 稳定计算，避免帮助收益被模型临场漂移。
 
 - `npc_chat`
   脚本：`src/data/functionCatalog/npc/npcChat.ts`
@@ -140,7 +140,7 @@
 
 - `npc_quest_accept`
   脚本：`src/data/functionCatalog/npc/npcQuestAccept.ts`
-  说明：正式接下 NPC 委托的 function。它把本地生成的任务写入 quest log，并让剧情承接“玩家已经答应处理这件事”。
+  说明：正式接下 NPC 委托的 function。它把后端 pending quest offer 写入 quest log，并让剧情承接“玩家已经答应处理这件事”。
 
 - `npc_quest_turn_in`
   脚本：`src/data/functionCatalog/npc/npcQuestTurnIn.ts`
@@ -172,7 +172,7 @@
 
 - `camp_travel_home_scene`
   脚本：`src/data/functionCatalog/flow/campTravelHomeScene.ts`
-  说明：营地开场或同伴交流结束后，正式前往角色主场景的流程项。它负责定制化场景迁移和状态清理，不属于普通 state function。
+  说明：营地开场或同伴交流结束后，正式前往角色主场景的流程项。前端脚本只保留按钮与视觉元信息，目标场景、状态清理、encounter preview、`scenesTraveled` 与快照持久化由后端 runtime action resolver 负责。
 
 - `story_opening_camp_dialogue`
   脚本：`src/data/functionCatalog/flow/storyOpeningCampDialogue.ts`
@@ -182,7 +182,7 @@
 
 - `inventory_use`
   脚本：`src/data/functionCatalog/panel/inventoryUse.ts`
-  说明：在背包面板里使用药品、灵力物或 build buff 物品的 function。它先由本地规则结算资源变化，再把结果记入故事历史。
+  说明：在背包面板里使用药品、灵力物或 build buff 物品的 function。前端只提交物品动作，资源变化、数量扣减、build buff 与故事历史由后端 resolver 写入。
 
 - `equipment_equip`
   脚本：`src/data/functionCatalog/panel/equipmentEquip.ts`
@@ -190,7 +190,7 @@
 
 - `equipment_unequip`
   脚本：`src/data/functionCatalog/panel/equipmentUnequip.ts`
-  说明：从装备槽位卸下物品的 function。它确保卸装结果由本地规则严格处理，不会破坏背包数量和 loadout 一致性。
+  说明：从装备槽位卸下物品的 function。后端 resolver 负责卸装结果、背包数量和 loadout 一致性。
 
 - `forge_craft`
   脚本：`src/data/functionCatalog/panel/forgeCraft.ts`
@@ -198,7 +198,7 @@
 
 - `forge_dismantle`
   脚本：`src/data/functionCatalog/panel/forgeDismantle.ts`
-  说明：在锻造面板中拆解物品回收材料的 function。拆解产出由本地锻造规则控制，避免与物品设计脱节。
+  说明：在锻造面板中拆解物品回收材料的 function。拆解产出由后端锻造 resolver 控制，避免与物品设计脱节。
 
 - `forge_reforge`
   脚本：`src/data/functionCatalog/panel/forgeReforge.ts`