一、回收无响应/无法触发问题
1. 核心成因
触发标识错误、命令语法与引擎不兼容、脚本路径配置偏差、权限未开放。常见于NPC回收脚本点击后无反馈，一键回收命令执行无效果，多因跨引擎误用命令或路径填写错误导致。
2. 排查步骤
首先核对触发标识（如[@Recycle]、[@AdvancedRecycle]）是否规范，传奇脚本标识区分大小写，漏写@符号或拼写错误会直接阻断触发。其次检查回收核心命令是否适配当前引擎，HERO、GOM、翎风等引擎的物品检测、回收命令差异较大，例如翎风引擎的GetBagItemInfo命令参数与其他引擎不同，误用会报错。最后验证脚本文件路径，#CALL调用的外部装备列表文件需与服务端目录一致，路径错误会导致脚本无法加载回收规则。
3. 修复方案
统一触发标识格式，严格参照对应引擎手册修正命令语法，如翎风引擎使用GetBagItemInfo需核对参数数量，避免因参数冗余或缺失报错。将脚本文件放置于服务端指定目录（Mir200\Envir\Market_Def或QuestDiary），调用外部文件时填写完整相对路径。测试时简化脚本，仅保留单件装备回收逻辑，逐步添加批量回收、属性判断等条件，排除无效代码干扰。
二、回收物品异常（漏收/错收/货不对板）
1. 核心成因
物品ID错误、属性判断逻辑漏洞、绑定状态冲突、装备列表配置失误。常见案例为指定装备无法回收、极品装备被误回收、勾选回收后实际回收物品与显示不符，部分因未区分普通装备与附加属性装备导致。
2. 排查步骤
从服务端物品数据库（Mir200\Envir\Items.txt）核对装备ID，确保脚本中ID与数据库完全一致，ID偏差会导致回收目标错误。检查属性判断脚本，若设置“跳过极品装备回收”，需确认CheckItemAddValueEx等命令的属性阈值是否合理，变量重复初始化会导致判断失效。验证物品绑定状态，绑定装备需对应绑定回收命令，通用回收命令无法识别绑定装备，易造成漏收。核查装备列表文件，确认文本内装备名称、ID与脚本调用规则匹配，列表错乱会引发错收问题。
3. 修复方案
逐一校验物品ID与名称，确保脚本、装备列表、数据库三者一致。优化属性判断逻辑，避免变量在循环内重复初始化，例如检测极品属性时，先定义阈值再执行循环判断，符合条件则跳过回收。区分绑定与非绑定装备，添加绑定状态校验命令，适配对应回收逻辑。整理装备列表文件，删除冗余内容，采用“名称+ID”双重标识，避免因名称重复导致错收。
三、回收奖励异常（货币/道具不对等/显示不一致）
1. 核心成因
奖励数值计算错误、货币类型混淆、命令参数配置不当、显示文本与执行逻辑脱节。常见于回收后金币/元宝到账不足、绑定与非绑定货币混用、奖励显示金额与实际发放不符等场景。
2. 排查步骤
检查奖励计算命令，如div（除法）、mul（乘法）的参数是否正确，部分脚本因未正确拆分商店价格与回收比例，导致奖励金额偏差。核对货币类型命令，确保判断命令（如CHECKGAMEGOLD）与发放命令（如GAMEGOLD +）的货币类型一致，避免绑定与非绑定货币混淆。观察服务端日志，确认奖励命令是否正常执行，参数错误会导致奖励发放失效但显示正常。
3. 修复方案
逐位核对奖励数值与计算逻辑，明确回收比例，例如按商店价格1/3回收时，需确保div命令参数设置正确。统一货币类型，绑定奖励对应绑定货币命令，非绑定奖励使用通用货币命令，避免混用。同步奖励显示文本与执行命令，确保显示金额与脚本内发放数值一致，修复“显示与实际不符”的视觉偏差。
四、循环回收问题（死循环/批量回收失效）
1. 核心成因
循环条件设置不当、变量未递增/递减、CONTINUE命令误用、背包位置计数错误。常见于一键批量回收时服务器卡顿、角色卡死，或循环回收仅执行一次便终止，多因循环逻辑闭环缺失导致。
2. 排查步骤
检查WHILE循环条件，如“WHILE P0 < 46”（背包位置计数）是否合理，计数范围超出实际背包容量会引发死循环。核查变量递增/递减命令，循环内未执行INC P0（变量递增）会导致无限循环，服务器负载飙升。验证CONTINUE命令使用场景，该命令需在循环内合理调用，误用会导致循环中断，批量回收失效。
3. 修复方案
优化循环逻辑，根据背包实际容量设定计数范围，普通背包与扩展背包需区分配置，避免范围过大或过小。确保循环内变量同步递增/递减，每个循环周期执行一次变量更新命令，形成完整逻辑闭环。规范CONTINUE命令使用，仅在需跳过当前循环时调用，且调用后需同步更新变量，避免循环中断。添加循环终止条件，如回收数量达标或背包无对应装备时，自动退出循环。
五、专属场景问题（特殊装备/引擎适配异常）
1. 核心成因
专属装备回收规则缺失、引擎版本更新后接口变更、跨引擎脚本迁移未适配。常见于剧毒之牙、青龙项链等专属装备无法回收，或引擎升级后原有回收脚本失效。
2. 排查与修复
针对专属装备，添加专属回收分支，明确装备ID、回收条件及对应奖励，补充至主回收脚本。引擎版本更新后，查阅更新日志，替换废弃接口命令，如GEE与HERO引擎兼容场景下，微调命令格式确保适配。跨引擎迁移脚本时，逐句核对命令语法，避免因引擎特性差异导致失效，优先参考目标引擎的回收脚本示例编写。
六、完整修复示例脚本（通用版）
[@AdvancedRecycle]
#IF
#ACT
MOV P0 0 ; 初始化背包位置计数器
MOV D0 0 ; 初始化回收计数器
MOV D1 1 ; 极品属性阈值（单属性≥1视为极品）
WHILE P0 < 46 ; 适配普通背包46个位置
GetBagItemInfo P0 S$ItemName N$ItemCount I$ItemID S$ItemAttr
MOV D2 0 ; 重置极品属性标记
MOV N0 0 ; 初始化属性类型计数器
WHILE N0 < 12 ; 覆盖常用属性类型（攻击、魔法、道术等）
#IF
CheckItemAddValueEx P0 N0 > D1
#ACT
MOV D2 1 ; 标记为极品装备
INC N0 1
#ELSEACT
INC N0 1
ENDWHILE
#IF
EQUAL D2 1 ; 跳过极品装备
#ACT
INC P0 1
CONTINUE
#IF
CHECKTEXTLIST ..\QuestDiary\普通装备列表.txt S$ItemName ; 校验回收列表
#ACT
GetDBItemFieldValue <$STR(S$ItemName)> price <$STR(N$Price)>
div N$Price 3 ; 按1/3商店价格回收
TakeBagItem S$ItemName 1 P0 ; 回收指定位置装备
GIVE 金币 <$STR(N$Price)>
INC D0 1
INC P0 1
#ELSEACT
INC P0 1
ENDWHILE
SendMsg 3 共回收 <$STR(D0)> 件普通装备，奖励已发放！
Break
七、排查与规避技巧
1. 日志辅助排查：开启服务端脚本日志（Mir200\Log\ScriptLog.txt），通过日志定位报错行数与命令，快速锁定语法错误、变量异常等问题。
2. 分段测试原则：新脚本或修改后脚本，先测试单件装备回收，再测试批量回收、极品过滤功能，逐步增加复杂度，降低排查难度。
3. 备份与适配：修改前备份原始脚本与装备列表文件，引擎更新或迁移前，先在测试服验证脚本兼容性，避免影响正式服运行。
4. 变量管理：规范变量命名与初始化，循环内避免重复定义变量，关键变量（如属性阈值、背包计数）单独标注，便于后续维护。
