《觅长生》商店随机化 Mod（C# / BepInEx 游戏插件）产品系统

《觅长生》是一款修仙题材单机 RPG，游戏内商店 NPC 售卖的功法、技能、药材在开局即固定，玩家只能反复读档刷店，后期商店货品一成不变、可交易内容缺乏新鲜感，多周目体验下降。本 Mod 面向中草阁、问道楼三个交易商店，让货品在不破坏原版栏位结构与剧情物品的前提下随机化，并支持消耗灵石主动刷新，解决商店货品固化、后期可玩性下降的问题，提升多周目的探索与交易乐趣。

1、商店货品随机化：刷新时从全游戏同类型、同品阶物品池中，按原版栏位模板分组不放回抽取替换，每次刷新货品都不相同；
2、灵石刷新机制：玩家可花费灵石主动刷新商店货品，刷新费用计入对应 NPC 的灵石池；
3、剧情物品保护：任务、剧情及固定售卖物品（如《炼器入门》）按原版固定集合保留，不被随机掉，被买走后按模板自动补回；
4、跨品阶混抽：中草阁二层的额外栏位支持跨品阶混抽，抽到品阶越高、数量相应递减；
5、安全过滤：自动排除学不到的“假书”和重复发放的免费功法，避免玩家买到无效或重复物品；
6、配置可调：商店模板、刷新费用、物品池均可通过 XML / JSON 配置文件修改。

本人独立完成需求设计、C# 编码、配表解析与测试全流程。基于 BepInEx 插件框架与 Harmony 对游戏交易逻辑挂钩，使用 C# 遍历游戏物品配表 d_items，构建“类型→品阶→品极”三维物品池与平铺池；按原版背包模板 d_avatar.Backpack 分组不放回抽取，保证栏位结构与原版一致。难点与亮点：通过记录原版固定物品集合，并同步审计“可被随机产出的物品集”与“下次会被保留的物品集”、使其交集为空，彻底解决了扩大物品池后刷新货品异常叠加的问题；同时用真实配表模拟连续多次刷新，校验保留数与总数逐次恒定（问道楼保留恒 4、总恒 66），保证结果正确。