添加库存系统组件

PHY_ItemSystem_Attributes.md

@@ -0,0 +1,96 @@
+# PHY Item Attribute System (GIS)
+
+## 本次新增
+
+- `Source/PHYInventory/Private/GameplayTags/PHYInventoryItemTags.h`
+- `Source/PHYInventory/Private/GameplayTags/PHYInventoryItemTags.cpp`
+- `Source/PHYInventory/Private/Items/PHYItemFragment_PropertySet.h`
+- `Source/PHYInventory/Private/Items/PHYItemFragment_PropertySet.cpp`
+- `Source/PHYInventory/Private/Items/PHYItemBlueprintLibrary.h`
+- `Source/PHYInventory/Private/Items/PHYItemBlueprintLibrary.cpp`
+- `Source/PHY/Private/Character/PHYCharacter.h`
+- `Source/PHY/Private/Character/PHYCharacter.cpp`
+- `Source/PHY/Private/Character/PHYPlayerCharacter.h`
+- `Source/PHY/Private/Character/PHYPlayerCharacter.cpp`
+- `Source/PHY/Private/Gameplay/Player/PHYPlayerState.h`
+- `Source/PHY/Private/Gameplay/Player/PHYPlayerState.cpp`
+
+## 新增联动能力（12）
+
+### 1) 装备属性自动生效/回滚（服务器权威）
+
+- 在基础角色上新增 `UGIS_EquipmentSystemComponent`。
+- 服务器 `BeginPlay` 时：先初始化 `InventorySystem`，再初始化 `EquipmentSystem`。
+- `APHYPlayerCharacter` 监听 `OnEquipmentStateChangedEvent`。
+- 事件触发后通过 `APHYPlayerState::HandleItemEquippedState` 应用或回滚属性。
+- 使用 `AppliedEquipmentItems` 防止同一个 ItemId 重复叠加。
+
+### 2) 药品 Server RPC 使用链路
+
+- 在 `APHYPlayerCharacter` 新增：
+  - `UFUNCTION(Server, Reliable) ServerUseConsumableByItemId(FGuid ItemId, int32 Count=1)`
+- 服务端流程：
+  - 按 `ItemId` 在库存中查找道具
+  - 扣减库存数量（`RemoveItem`）
+  - 调用 `APHYPlayerState::ApplyConsumableFromItem` 应用恢复
+- 当前默认读取道具动态属性标签：
+  - `GIS.Attribute.Item.Consumable.RestoreHealth`
+  - `GIS.Attribute.Item.Consumable.RestoreInnerPower`
+
+## 设计
+
+- 基于 GIS 的 `UGIS_ItemDefinition` + Fragment。
+- 新增 `UPHYItemFragment_PropertySet` 作为统一“武器/装备/药品”属性片段。
+- 道具实例创建时会把 `BaseFloatModifiers` / `BaseIntegerModifiers` 写入 `UGIS_ItemInstance` 动态属性。
+
+## 主要能力
+
+- 统一道具大类：`EPHYItemArchetype`
+  - `Weapon`
+  - `Equipment`
+  - `Consumable`
+  - `Material`
+  - `Quest`
+- 统一装备槽：`EPHYEquipSlotType`
+- 药品效果载荷：`FPHYConsumablePayload`
+  - `RestoreHealth`
+  - `RestoreInnerPower`
+  - `DurationSeconds`
+
+## GameplayTags 管理
+
+标签已集中在 `Source/PHYInventory/Private/GameplayTags/PHYInventoryItemTags.*`，避免代码中散落字符串：
+
+- `GIS.Item.Type.Weapon`
+- `GIS.Item.Type.Equipment`
+- `GIS.Item.Type.Consumable`
+- `GIS.Item.EquipSlot.MainHand` 等
+- `GIS.Attribute.Item.Attack`、`GIS.Attribute.Item.CritRate` 等
+
+## 如何创建三类物品
+
+1. 在编辑器创建 `UGIS_ItemDefinition` 资产。
+2. 给该资产添加 Fragment：`PHY Item Property Settings`。
+3. 按类型配置：
+   - 武器：`ItemArchetype=Weapon`，`EquipSlot=MainHand/OffHand`，填写攻击/暴击等属性。
+   - 装备：`ItemArchetype=Equipment`，设置对应 `EquipSlot`，填写防御/免伤/韧性等属性。
+   - 药品：`ItemArchetype=Consumable`，填写 `ConsumablePayload`（回血/回内力）。
+4. 把物品加入你的掉落表/默认背包配置。
+
+## 蓝图辅助
+
+`UPHYItemBlueprintLibrary` 提供：
+
+- `GetItemArchetype`
+- `GetEquipSlotType`
+- `IsWeaponItem`
+- `IsEquipmentItem`
+- `IsConsumableItem`
+- `GetConsumablePayload`
+
+用于 UI 显示和使用逻辑分流。
+
+## 备注
+
+- 当前为 MVP：先打通类型与属性承载。
+- 下一步可扩展：随机词条（Roll）、品质颜色、套装、与 GAS GameplayEffect 自动联动。