锻造历史记录

锻造历史记录用于保存玩家的关键锻造行为，便于追踪高价值装备来源、排查材料消耗争议、统计配方使用情况和回溯异常结果。

配置位置

历史记录位于 config.yml 的 history 节点。不同发行配置可能会调整字段默认值，但推荐保留自动保存能力：

history:
  enabled: true
  auto_save: true
  save_interval_ticks: 6000

字段说明

字段	说明
enabled	是否启用锻造历史记录。
auto_save	是否定时保存历史缓存。
save_interval_ticks	自动保存间隔，单位 tick。6000 tick 约为 5 分钟。

记录内容

一次锻造记录通常关注以下信息：

信息	用途
玩家 UUID / 名称	定位操作者。
配方 ID	统计配方热度，排查配方问题。
材料列表	判断材料是否被正确识别与消耗。
品质结果	回溯高品质装备来源。
成功或失败	分析失败率、材料消耗策略是否合理。
时间戳	与日志、经济流水、玩家反馈对应。
结果物品摘要	判断结果物品是否与配方一致。

与品质保底的关系

历史记录不是品质保底计数器本身，但两者经常一起用于排查：

• 玩家连续未获得高品质时，可用历史记录确认实际锻造次数。
• 如果品质结果与预览不一致，检查历史记录中的材料、配方和时间窗口。
• 如果重载后保底表现异常，检查历史记录与玩家数据是否正常保存。

使用建议

• 正式服建议开启 enabled 和 auto_save。
• 高并发服务器可适当提高 save_interval_ticks，减少频繁写盘。
• 赛季服或活动服可以在活动结束后归档历史数据，用于统计高品质装备产出。
• 如果玩家反馈“材料被吞”“结果不对”，先查历史记录，再查控制台报错。

排查建议

• 历史未保存：检查 enabled、auto_save 和保存目录权限。
• 记录过多：定期归档旧数据，或缩短保留周期。
• 结果无法对应玩家反馈：确认服务器时间、玩家名称变化和 UUID 是否一致。
• 重载后数据丢失：确认自动保存间隔，必要时在维护前手动停服保存。