# ms

**Repository Path**: rock_wang/ms

## Basic Information

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

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-12-17
- **Last Updated**: 2025-12-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 🎮 MS Smart Assistant - 智能辅组打怪系统

> **基于深度学习(YOLOv11)与计算机视觉的新一代智能游戏辅助**
> 
> *不仅仅是脚本，而是拥有"眼睛"和"大脑"的智能伴侣*

---

## ✨ 核心亮点

### 🧠 视觉智能
- **YOLOv11s 深度集成**: 毫秒级识别玩家、怪物、物品、BOSS
- **动态小地图导航**: 不依赖固定坐标，完全基于图像识别的相对坐标定位
- **多维度视觉感知**: 结合传统图色识别与深度学习，精准判断血条、技能状态

### 🤖 智能战斗核心 (Auto-Combat)
- **职业专属策略**:
  - **🐲 龙骑士 (Dragon Knight)**: 支持单层平推 & CD图三层循环模式，智能龙咆哮(Roar)清怪
  - **🔥 火毒 (Fire/Poison)**: 优化的技能释放循环（开发中）
- **多模式支持**:
  - **🎯 单层模式**: 适合平地地图，智能左右巡逻
  - **🏢 多层/CD图模式**: 智能识别传送点(Portal)，自动爬楼/换层循环
- **人性化操作**: 防卡墙机制、智能拾取(优先拾取贵重物品)、BUFF自动续航

### 🛡️ 安全与交互
- **👀 可视化GUI**: 现代化的PyQt6界面，实时预览检测结果和小地图状态
- **⌨️ 虚拟键盘映射**: 实时显示模拟按键状态，便于调试和监控
- **🛡️ 行为模拟**: 随机化的按键间隔与持续时间，模拟真实玩家操作习惯（防封号优化）

---

## 🚀 快速开始

### 1. 环境准备
- Windows 10/11 (推荐)
- Python 3.9+
- NVIDIA显卡 (推荐，使用CUDA加速)

### 2. 启动程序
双击运行项目根目录下的启动脚本：
```bash
启动GUI.bat
```
或者在终端中运行：
```bash
python gui_main.py
```

### 3. 操作流程
1. **自动锁定窗口**: 程序启动后会自动寻找 "MapleStory" 窗口
2. **选择职业策略**: 在控制面板选择 "龙骑士" 或其他职业
3. **配置参数**: 设置攻击距离、Y轴检测范围
4. **一键启动**: 点击 "▶️ 开始打怪"
   - *建议先点击 "📸 单次检测" 确认识别准确度*

---

## 🛠️ 功能模块详解

### 🖥️ 可视化控制台
- **左侧控制区**: 
  - 窗口状态监控
  - 职业策略切换 (单层/多层)
  - 实时虚拟键盘 (显示当前按下的键位)
- **右侧数据区**:
  - **小地图实时预览**: 显示识别到的玩家位置、传送点位置
  - **检测日志**: 详细的运行状态和识别统计

### 🗺️ 智能导航系统
不同于传统的按键精灵，本系统通过**扫描小地图**来确定位置：
- **Portal配置**: 支持自定义传送点位置（使用相对坐标，窗口大小改变不影响）
- **楼层判断**: 智能分析Y轴坐标，自动判断当前所在楼层
- **边界检测**: 自动识别地图左右边界，防止人物卡死

### ⚔️ 自动化策略
| 职业 | 支持模式 | 特性 |
|------|----------|------|
| **龙骑士** | 单层 / CD图(3层) | 智能冲锋、龙咆哮全屏攻击、三层楼梯循环 |
| **火毒** | 多层 | 毒雾蔓延策略 |
| **通用** | 单层 | 基础左右巡逻 + 攻击 |

---

## 📁 项目结构

```
ms/
├── gui_main.py                 # 🎮 GUI主入口
├── automation/                 # 🤖 自动化战斗核心逻辑
│   ├── dragon_knight.py        # 龙骑士专属策略
│   ├── fire_poison.py          # 火毒专属策略
│   └── base_fighter.py         # 基础战斗类
├── core/                       # 🔧 核心工具 (窗口管理, 覆层绘制)
├── detection/                  # 👁️ 视觉感知模块
│   ├── yolo_detection.py       # YOLO检测封装
│   └── minimap_monitor.py      # 小地图导航逻辑
├── input/                      # ⌨️ 输入控制与录制
├── tools/                      # 🛠️ 训练与辅助工具
├── minimap_config.json         # 🗺️ 地图/传送点配置文件
└── config.json                 # ⚙️ 全局配置
```

---

## ⚙️ 高级配置

### 配置文件 `config.json`
```json
{
  "recognition": {
    "use_yolo": true,
    "yolo_conf_threshold": 0.25  // 识别灵敏度
  },
  "automation": {
    "attack_distance": 180,      // 攻击触发距离
    "y_distance_threshold": 40   // Y轴判定范围
  }
}
```

### 小地图配置 `minimap_config.json`
支持为不同地图配置传送点位置（0-1相对坐标）：
```json
"cd_map": {
  "portal_positions": {
    "1": { "down": {"rel_x": 0.654, "rel_y": 0.333} }
  }
}
```

---

## 🤝 开发与贡献

### 训练自己的模型
1. 使用 `tools/采集训练数据.py` 快速截图
2. 使用 LabelImg / AnyLabeling 进行标注
3. 运行 `tools/增量训练模型.py` 优化识别效果

### 待办清单 (Roadmap)
- [x] YOLOv11 集成
- [x] 龙骑士 CD图三层循环
- [x] 火毒 PW多层循环
- [x] 虚拟键盘可视化
- [ ] 更多职业支持 (冰雷, 标飞)
- [ ] 自动释放符文 (Rune)
- [ ] 掉线自动重连

---

## ⚠️ 免责声明

本项目仅供计算机视觉与自动化测试技术的学习研究使用。
请勿在官方服务器使用本程序，以免违反游戏服务条款。
作者不对使用本软件产生的任何账号封禁负责。

---

*Made with ❤️ by Agent Antigravity*