# haidu

**Repository Path**: wsige/haidu

## Basic Information

- **Project Name**: haidu
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-19
- **Last Updated**: 2026-07-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 海斗助手 (Haidou Assistant)

基于 [PenguLoader](https://github.com/PenguLoader/PenguLoader) 的英雄联盟海克斯大乱斗助手插件。

## 功能特性

### 阵容分析与推荐
- 实时分析我方/敌方阵容组成（伤害类型、前排数量、控制能力）
- 根据阵容互补推荐最优英雄选择
- 替补席英雄价值评估，提示最佳交换时机
- 智能 Reroll 建议（基于英雄胜率和阵容匹配度）

### 强化符文推荐
- 按英雄角色类型推荐海斗强化符文
- 按等级（3/7/11/15）分组推荐银色/金色/棱彩符文
- 符文评级（S/A/B）帮助快速决策

### 自动操作
- **自动选择英雄** - 根据推荐评分自动锁定最优选择
- **自动重随** - 低胜率英雄时自动触发重随
- **自动替补交换** - 发现更好的替补英雄时自动交换
- **自动配置符文页** - 一键生成当前英雄的推荐符文配置

### 信息面板 Overlay
- 在客户端内嵌可拖拽的信息面板
- 实时显示阵容分析、推荐和敌方情报
- 支持标签页切换（阵容/强化/设置）
- Toast 通知反馈自动操作结果

## 技术架构

```
src/
├── index.js              # 插件入口 (init/load 生命周期)
├── config.js             # 配置常量
├── services/
│   ├── lcu-api.js        # LCU REST API 客户端
│   └── event-manager.js  # LCU WebSocket 事件管理
├── features/
│   ├── team-analysis.js  # 阵容分析与推荐
│   ├── augment-advisor.js # 符文/强化推荐
│   └── auto-actions.js   # 自动操作 (pick/reroll/swap)
├── data/
│   ├── champions.js      # 英雄数据 (胜率/评级)
│   └── augments.js       # 强化符文数据
├── ui/
│   ├── overlay.js        # Overlay 面板 (Shadow DOM)
│   └── styles/
│       └── overlay.css   # 样式
└── utils/
    ├── logger.js         # 日志工具
    └── helpers.js        # 通用工具函数
```

## 构建 & 安装

### 前置要求
- Node.js >= 18
- [PenguLoader](https://pengu.lol) 已安装并配置

### 构建

```bash
# 安装依赖
pnpm install

# 开发模式 (监听文件变化自动构建)
pnpm dev

# 生产构建
pnpm build
```

### 安装

1. 构建插件: `pnpm build`
2. 将 `dist/index.js` 复制到 PenguLoader 的 `plugins/` 目录:
   ```
   PenguLoader/
   └── plugins/
       └── index.js    # <-- 放在这里
   ```
3. 启动英雄联盟客户端
4. 进入海克斯大乱斗模式即可看到助手面板

### 使用 CommandBar

按 PenguLoader 快捷键打开 CommandBar，搜索 "海斗" 可以:
- 切换面板显示/隐藏
- 手动配置推荐符文
- 手动重随英雄
- 启用调试模式

## 设置项

| 设置 | 说明 | 默认值 |
|------|------|--------|
| autoPick | 自动选择推荐英雄 | false |
| autoReroll | 自动重随低胜率英雄 | false |
| autoSwap | 自动交换替补英雄 | false |
| autoRunePage | 自动配置推荐符文页 | true |
| showRecommendations | 显示英雄推荐 | true |
| showWinRates | 显示胜率数据 | true |
| showAugmentTips | 显示强化符文建议 | true |

设置会自动持久化到 PenguLoader 的 DataStore 中。

## 数据说明

插件内置了一份英雄参考数据集（胜率、评级、角色标签等），用于离线推荐。
实际使用时建议定期更新 `src/data/champions.js` 中的数据以获取最新信息。

> 数据来源参考: op.gg, u.gg, lolalytics.com 等

## 注意事项

- 此插件依赖 PenguLoader 框架运行
- 海斗模式的强化符文选择发生在游戏客户端内（非 LCU），插件仅提供推荐建议
- 符文页配置功能在普通 ARAM 中可用，海斗模式可能禁用符文系统
- 自动操作功能请谨慎使用，建议手动确认后再操作

## License

MIT