<!-- markdownlint-disable MD033 MD041 -->

<p align="center">
  <img src="https://cdn.jsdelivr.net/gh/LeonNagant/MaaGF1_Test/example_img/icon/icon.png" width="200" height="200" alt="LOGO">
</p>

<div align="center">

# MaaGF1_Test - 少女前线自动化助手

<div align="center">

> **基于 [MaaFramework](https://github.com/MaaXYZ/MaaFramework) 项目模板创建**

</div>

---

## ⚠️ 项目状态说明

**MaaGF1** 项目是专为**少女前线电脑端**设计的自动化工具。作为新生项目：

```!
🚧 当前状态：
- 界面仍在优化中
- 功能持续扩展中
- 结构逐步调整中
- 逻辑不断完善中

- 调度器准备中
```

### 🔒 账号安全警告

少女前线官方曾有大量封禁脚本记录！  
**使用风险自行承担，本项目不承担任何后果**  
[查看完整免责声明](#-免责声明与许可)

---

## 🚨 使用前必读

⚠️ **重要提示** ⚠️  

1. 请更新至[最新发行版](https://github.com/LeonNagant/MaaGF1_Test/releases)  
2. 仔细阅读相关[使用手册](https://github.com/LeonNagant/MaaGF1_Test/tree/main/manual)  
3. 确认脚本兼容性后再使用！

</div>

### 🐞 问题反馈指南

```!
遇到问题请先：
1. 检查资源版本
2. 阅读使用手册
3. 确认是否最新发行版

如需提交bug：
- 附带软件根目录下 debug/maa.log
- 提供复现视频/截图更佳
```

---

## 🛠 核心配置

### 🖥 分辨率设置

- **主支持分辨率**：1280×720

- **关键设置**：
  
  ```!
  必须开启：记录上次完成关卡时镜头缩放
  ```

### ⚠️ 重要注意事项

1. **鼠标占用问题**

   - 现象：执行时系统鼠标被占用（~丹小姐抢鼠标~）

   - 解决方案：

     ```快捷键
     Win + ↓ (连续按至窗口最小化)
     ```

2. **必读文档**  
   [使用手册全集](https://github.com/LeonNagant/MaaGF1_Test/tree/main/manual)

---

## 🚀 快速开始

### 用户使用指南

1. 下载最新[发行版](https://github.com/LeonNagant/MaaGF1_Test/releases)  
   `MaaGF1-GUI-v1.x.xx-x86_64-.zip`
2. 解压文件
3. （管理员）运行 `MFAAvalonia.exe`
4. 选择「少女前线」窗口
5. 选择脚本，查看并调整对应设置
6. 点击开始运行

---

## 🌟 功能

### ⚔️ 作战升级

| 功能           | 作者                                          | 手册链接                                                                                                                                                        |
| ------------ | ------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
| ▶️ 13-4循环    | [LeonNagant](https://github.com/LeonNagant) | [使用手册](https://github.com/LeonNagant/MaaGF1_Test/blob/main/manual/13-4%E5%8F%8C%E6%89%93%E6%89%8B%E6%8B%96%E5%B0%B8%E4%BD%BF%E7%94%A8%E6%89%8B%E5%86%8C.md) |
| ▶️ 13-4地图初始化 |                                             |                                                                                                                                                             |
| ▶️ 8-1N循环    | [LeonNagant](https://github.com/LeonNagant) | [使用手册](https://github.com/LeonNagant/MaaGF1_Test/blob/main/manual/8-1N%E5%8F%8C%E6%89%93%E6%89%8B%E7%82%B8%E7%8B%97%E4%BD%BF%E7%94%A8%E6%89%8B%E5%86%8C.md) |
| ▶️ 8-1N地图初始化 |                                             |                                                                                                                                                             |
| ▶️ 跑步机       | [白烛](https://github.com/Talulah-x)          | [使用手册](https://github.com/LeonNagant/MaaGF1_Test/blob/main/manual/%E8%B7%91%E6%AD%A5%E6%9C%BA%E4%BD%BF%E7%94%A8%E6%89%8B%E5%86%8C.md)                       |

### 🎣 打捞系统

| 功能        | 作者                                                                                 | 手册链接                                                                                                                                           |
| --------- | ---------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| ▶️ 常驻人形打捞 | [Ethan Lee](https://github.com/hake971920), [坠机の科比](https://github.com/LIUBEI1233) | [使用手册](https://github.com/LeonNagant/MaaGF1_Test/blob/main/manual/%E6%89%93%E6%8D%9E%E4%BD%BF%E7%94%A8%E6%89%8B%E5%86%8C.md)                   |
| ▶️ 夜战打捞   | [白烛](https://github.com/Talulah-x)                                                 | [使用手册](https://github.com/LeonNagant/MaaGF1_Test/blob/main/manual/%E5%A4%9C%E6%88%98%E6%89%93%E6%8D%9E%E4%BD%BF%E7%94%A8%E6%89%8B%E5%86%8C.md) |
| ▶️ 虚粒子对打捞 | [do_e](https://github.com/isla23)                                                  |                                                                                                                                                |
| ▶️ 蝴蝶星云打捞 | [白烛](https://github.com/Talulah-x)                                                 |                                                                                                                                                |

### 🏠 宿舍功能

| 功能           | 作者                                          | 手册链接                                                                                                                                                             |
| ------------ | ------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| ▶️ 兵棋挂机循环    | [LeonNagant](https://github.com/LeonNagant) | [使用手册](https://github.com/LeonNagant/MaaGF1_Test/blob/main/manual/%E5%85%B5%E6%A3%8B%E8%87%AA%E5%8A%A8%E6%8C%82%E6%9C%BA%E4%BD%BF%E7%94%A8%E6%89%8B%E5%86%8C.md) |
| ▶️ 宿舍内自动点击爱心 | [LeonNagant](https://github.com/LeonNagant) |                                                                                                                                                                  |
| ▶️ 宿舍自动点赞    | [LeonNagant](https://github.com/LeonNagant) |                                                                                                                                                                  |

### 🧩 其他功能

| 功能              | 作者                                                                    | 手册链接                                                                                                                                                                      |
| --------------- | --------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| ▶️ 灰域探查         | [do_e](https://github.com/isla23), [白烛](https://github.com/Talulah-x) | [使用手册](https://github.com/LeonNagant/MaaGF1_Test/blob/main/manual/%E8%87%AA%E5%8A%A8%E6%89%93%E7%81%B0%E5%A5%96%E5%8A%B1%E5%85%B3%E4%BD%BF%E7%94%A8%E6%89%8B%E5%86%8C.md) |
| ▶️ 裂变链接捡垃圾      | [白烛](https://github.com/Talulah-x)                                    | [使用手册](https://github.com/LeonNagant/MaaGF1_Test/blob/main/manual/%E6%8D%A1%E5%9E%83%E5%9C%BE%E4%BD%BF%E7%94%A8%E6%89%8B%E5%86%8C.md)                                     |
| ▶️ 指挥官后勤        | [白烛](https://github.com/Talulah-x)                                    | [使用手册](https://github.com/LeonNagant/MaaGF1_Test/blob/main/manual/%E6%8C%87%E6%8C%A5%E5%AE%98%E5%90%8E%E5%8B%A4%E4%BD%BF%E7%94%A8%E6%89%8B%E5%86%8C.md)                   |
| ▶️ 静默沙盒刷资源(WIP) | [Morning](https://github.com/SwordofMorning)                          | [使用手册](https://github.com/LeonNagant/MaaGF1_Test/blob/main/manual/%E9%9D%99%E9%BB%98%E6%B2%99%E7%9B%98%E5%88%B7%E8%B5%84%E6%BA%90.md)                                                                                                                                                                          |

---

## 📬 反馈渠道

- [提交 Issue](https://github.com/LeonNagant/MaaGF1_Test/issues)
- QQ交流群：`720731834`

---

## 📄 免责声明与许可

### **该项目仅供学习交流使用，不对账号风险负责**

> 使用本程序即表示**已完全阅读并同意**  
> [MaaFramework](https://github.com/MaaXYZ/MaaFramework) 及本项目的所有声明与许可

---

## 🙏 鸣谢

### 核心驱动

[![MaaFramework](https://img.shields.io/badge/Powered_by-MaaFramework-blue?logo=github)](https://github.com/MaaXYZ/MaaFramework)

### 贡献者墙

[![Contributors](https://contrib.rocks/image?repo=LeonNagant/MaaGF1_Test&show_noncode=true)](https://github.com/LeonNagant/MaaGF1_Test/graphs/contributors)

### 相关项目

#### 感谢 [FMddl-MAAutoGirlsFrontLine](https://github.com/Fufu-OuO/FMddl-MAAutoGirlsFrontLine) 开发组对本项目的支持与贡献

#### 感谢所有参与开发、测试的贡献者和用户
