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，便于快速集成到任何项目。