Technical Details & Key Features（技术细节与核心特性）

编辑器扩展功能

- 支持 Undo/Redo，并自动标记场景为已修改（scene-dirty）。

- Inventory Manager 编辑器窗口包含五个标签页：
Create Inventory、Create Item、Create Quick-Access Bar、Item Database、Create Equipment Panel。

- 一键 “Create” 按钮可将已配置好的 UI 预制体直接生成到场景中。

- 内置的 HUD 设置：生命值、法力值、耐力条，以及多层级货币显示。

Inventory Creation（物品栏创建）

- 可配置网格布局：每行槽位数、每页行数、边距、间距、单元格大小。

- 自定义背景图、槽位预制体、上一页/下一页按钮。

- 可分配运行时拾取预制体和拾取文字预制体（pickup-text prefab）。

Item Authoring（物品定义）

- 基于 ScriptableObject 的 InventoryItem：
名称、描述、图标、可堆叠性、最大堆叠数量
基于枚举的 ItemType（Consumable、Equipment、Currency）
属性（stats）列表、数量（用于消耗品）
装备子类型（weapon、armor、slots）

- 支持使用 QuickAccessBar.UseSlot(index) 触发消耗品使用。

Quick-Access Bar（快捷访问栏）

- 支持 1–0 的快捷键槽位，可自定义槽位数量和按钮数字预制体。

- 编辑器标签可刷新或重建数据库。

Item Database（物品数据库）

- 自动收集所有 InventoryItem 资源，并生成一个统一的 ItemDB ScriptableObject。

- 自动将每个 UI 槽位映射到其对应的 InventorySlot 字段（图标 + 堆叠文本）。

Equipment Panel（装备面板）

- 支持拖拽头盔、武器、靴子等 UI 槽位。

- 编辑器面板自动将 EquipmentCanvas 预制体与玩家对象连接：
在 Player GameObject 上添加或查找 Equipment 组件
分配 ItemDB
调用 PopulateAllItemsList() 初始化数据

Runtime API（运行时 API）

- Inventory：包含多页 InventorySlot，支持添加、移除、堆叠与分页。

- InventorySlot：数据容器 + UI 关联，SetItem(item, qty)。

- InventoryItem：配合 ItemPickup 组件实现世界拾取逻辑。

- Equipment：装备/卸下方法，根据物品类型匹配槽位。

- QuickAccessBar、HUD、UIManager：更新数值条、文本与槽位显示。

Drag-and-Drop Handler（拖拽交互）

InventoryDragHandler 支持：

- 堆叠合并，直到达到 maxStackSize，并处理溢出。

- 在槽位与装备槽之间交换物品。

- 非法放置保护（例如错误的装备槽）。

- 将鼠标拖拽到下一页/上一页按钮上时自动分页。

Currency Manager（货币管理）

- 多层级货币列表（按价值从高到低）。

- 自动转换（例如银币 → 金币），基于每层级的 conversionRate。

- 实时刷新 UI 文本。

- 支持通过 GetCurrencyData() / SetCurrencyData(...) 进行保存与读取。

Save/Load System（存档系统）

- SaveLoadManager 基于 JSON 的持久化系统。

- 可序列化：物品栏内容、已装备物品、快捷栏槽位、货币余额。

- 编辑器可挂接的一行 SaveGame(...) / LoadGame(...) 调用。

In-World Pickup（世界拾取）

- ItemPickup MonoBehaviour：
可配置碰撞半径与高度
触发后生成拾取预制体并显示漂浮文字（PickupText）

Extensibility（可扩展性）

- 所有主要类均公开方法、事件和属性，便于自定义。

- 可替换的预制体与 ScriptableObject 资源，支持完整 UI 主题更换与行为重写。

- 提供完善的代码注释与详细 README，便于快速集成到任何项目。