# EquipFavorite

**Repository Path**: alon_li/EquipFavorite

## Basic Information

- **Project Name**: EquipFavorite
- **Description**: EquipFavorite
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-21
- **Last Updated**: 2026-05-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 装备收藏助手 - UI 预览

## 📁 插件文件结构

```
EquipFavorite/
├── EquipFavorite.toc    # 插件元数据
├── main.lua            # 核心逻辑 + Mock数据
└── UI.lua              # 界面模块
```

## 🎮 使用方法

1. 将 `EquipFavorite` 文件夹复制到魔兽世界的插件目录：
   ```
   World of Warcraft\_retail_\Interface\AddOns\
   ```

2. 游戏中输入命令打开界面：
   - `/efa`
   - `/装备收藏`

## 🖼️ UI 界面说明

### 主窗口布局

```
┌─────────────────────────────────────────────────────────────┐
│  装备收藏助手                                    [_][□][X]  │
├─────────────────────────────────────────────────────────────┤
│  [⭐我的收藏] [📦全部装备] [👤按部位] [🏰副本]              │
├─────────────────────────────────────────────────────────────┤
│                                                             │
│  我的收藏 (4)                                    [按优先级] │
│  ┌─────────────────────────────────────────────────────┐   │
│  │ [?] 巨龙之怒                    ⭐        装等: 502 │   │
│  │     主手 | 武器 | 化身巨龙牢窟   (毕业武器，优先获取)│   │
│  ├─────────────────────────────────────────────────────┤   │
│  │ [?] 霜火护腿                    ⭐        装等: 498 │   │
│  │     腿部 | 锁甲 | 化身巨龙牢窟   (属性很好)          │   │
│  ├─────────────────────────────────────────────────────┤   │
│  │ [?] 暗影之戒                    ⭐        装等: 495 │   │
│  │     手指 | 饰品 | 奈萨鲁斯       (缺戒指)            │   │
│  ├─────────────────────────────────────────────────────┤   │
│  │ [?] 守护者的胸甲                ⭐        装等: 502 │   │
│  │     胸部 | 板甲 | 化身巨龙牢窟   (套装部件)          │   │
│  └─────────────────────────────────────────────────────┘   │
│                                                             │
└─────────────────────────────────────────────────────────────┘
```

### 四个标签页

#### 1️⃣ ⭐ 我的收藏
- 显示所有已收藏的装备
- 显示装备名称、装等、部位、来源
- 点击 ⭐ 可取消收藏
- 鼠标悬停显示详细属性 tooltip

#### 2️⃣ 📦 全部装备
- 显示所有可用的装备（包括未收藏）
- 可以浏览全部装备并添加收藏

#### 3️⃣ 👤 按部位
- 网格布局显示所有装备部位
- 每个部位显示收藏数量徽章
- 点击部位查看该部位的所有装备

```
┌──────────────────────────────────────────┐
│ 按部位查看                                │
├──────────────────────────────────────────┤
│  [  头部  ]  [  颈部  ]  [  肩部  ]      │
│  [  背部  ]  [  胸部 1]  [  手腕  ]      │
│  [  手部  ]  [  腰部  ]  [  腿部 1]      │
│  [  脚部  ]  [  手指 1]  [  饰品  ]      │
│  [  主手 1]  [  副手  ]  [  双手  ]      │
└──────────────────────────────────────────┘
```

#### 4️⃣ 🏰 副本
- 列出所有副本（团本 + 五人本）
- 显示每个副本的收藏数量

```
┌──────────────────────────────────────────┐
│ 副本列表                                  │
├──────────────────────────────────────────┤
│  化身巨龙牢窟                             │
│  团本 - 8 个BOSS                 3 件收藏 │
├──────────────────────────────────────────┤
│  艾杰斯亚学院                             │
│  五人本 - 4 个BOSS                        │
├──────────────────────────────────────────┤
│  奈萨鲁斯                                 │
│  五人本 - 4 个BOSS               1 件收藏 │
└──────────────────────────────────────────┘
```

## 🎯 交互功能

### 鼠标悬停 Tooltip
```
┌──────────────────────────────┐
│ 巨龙之怒                      │  ← 紫色（史诗品质）
│ 物品等级: 502                 │  ← 金色
│                              │
│ 主手 - 武器                   │
│                              │
│ 属性:                         │  ← 蓝色
│   +450 strength              │
│   +320 crit                  │
│   +280 haste                 │
│                              │
│ 掉落: 化身巨龙牢窟            │  ← 蓝色
│ BOSS: 莱萨杰丝                │
└──────────────────────────────┘
```

### 收藏切换
- 点击装备右侧的 ⭐ 图标可切换收藏状态
- 已收藏：显示黄色星星
- 未收藏：显示灰色骷髅图标

## 🎨 视觉设计

- **窗口尺寸**: 900 × 600 像素
- **配色方案**: 深色主题，符合魔兽UI风格
- **品质颜色**:
  - 🟢 精良 (蓝)
  - 🟣 史诗 (紫)
  - 🟠 传说 (橙)

## 📦 Mock 数据说明

当前包含 5 件测试装备：

| 装备名 | 部位 | 装等 | 品质 | 来源 | 收藏状态 |
|--------|------|------|------|------|----------|
| 巨龙之怒 | 主手 | 502 | 史诗 | 化身巨龙牢窟 | ⭐ |
| 霜火护腿 | 腿部 | 498 | 史诗 | 化身巨龙牢窟 | ⭐ |
| 风暴使者 | 双手 | 500 | 史诗 | 艾杰斯亚学院 | - |
| 暗影之戒 | 手指 | 495 | 精良 | 奈萨鲁斯 | ⭐ |
| 守护者的胸甲 | 胸部 | 502 | 史诗 | 化身巨龙牢窟 | ⭐ |

## 🚀 下一步开发计划

1. **连接真实数据** - 从游戏API读取实际装备
2. **添加筛选功能** - 按属性、装等筛选
3. **装备对比** - 与当前装备对比属性
4. **团本CD追踪** - 读取副本锁定状态
5. **数据持久化** - 保存收藏到 SavedVariables

---

**版本**: 1.0.0 (演示版)  
**作者**: QClaw