build-game-inventory

构建游戏物品栏

使用一个类型明确、可序列化的物品数据源作为唯一事实来源，并确保每次转移都是原子的。

定义物品契约

分别对稳定 ID、物品定义、所有权、堆叠上限、装备兼容性、效果、稀有度、展示数据和迁移版本进行建模。运行时 UI 必须通过 ID 引用物品定义，而不是重复存储属性或描述。

将转移实现为事务

对于拾取、装备、卸下、交换、拖放、消耗和出售：

1. 验证来源所有权和目标位置是否合法。
2. 计算完整的下一个物品栏／装备状态。
3. 一次性提交；否则拒绝操作，且不更改任一方的状态。
4. 仅在已提交状态有效后持久化。

切勿在确认存在合法目标位置之前移除物品。交换时保留物品身份，并防止重复注册效果。

构建易用的 UI

显示槽位兼容性、装备状态、数量、提示框信息和失败反馈。除仅支持拖放的交互外，还要提供键盘和触控操作方式。确保焦点行为、对话框和提示框均具有良好的无障碍支持。

测试物品丢失边界

覆盖无效目标位置、物品栏已满、重复拾取、装备交换、操作过程中的交换、保存／加载、架构迁移、重置／新游戏、提示框更新和重复派发。验证已拥有物品的总身份始终保持不变，除非存在明确的消耗或奖励规则。