XtGameKit/Doc/Bag-System-Guide.md

Bag System Guide

模块目标

• 统一 Item 存储（货币、碎片、装备、材料都走 itemId）
• 提供增减、查询、批量发奖/扣费能力

核心接口

• AddItems(List<RewardEntry>)
• RemoveItems(List<CostEntry>)
• GetItemCount(itemId)
• HasItems(List<CostEntry>)

关键约束

• 任何资源变动都必须走 Bag 接口
• 禁止在 Player 上新增独立货币字段