Girls_Frontline_Helper

KO | EN

gitlite — search

#javascript #python #typescript #llm #golang #android #rust #docker #java #cli #kubernetes #security #mcp #open-source

Girls_Frontline_Helper

(★ 19)

Girl's Frontline Helper 少女前线Steam版自动化脚本

Girls_Frontline_Helper 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Girl's Frontline Helper

少女前线 Steam 版自动化脚本(至少要知道怎么安装python才能使用)

---

## 🧾 最新更新

- **2025.12.14**: v1.1.0.3(测试版)
    - 修复:任务序列时各种卡住的问题

- **2025.12.04**: v1.1.0.2(测试版)
    - 修复:
      - 总控执行一个任务后退出进程
      - 打捞出新人形卡住
      - 主界面回收人形后,错误点击钻石充值界面

- **2025.12.04**: v1.1.0.1(测试版)
    - 新增功能:
        - 添加总控，用于统一管理与调度所有关卡脚本，原本每个脚本都需要独立执行，现在可以通过一个总控入口统一管理，
          通过配置`mission_plan.yaml`文件，然后运行`launcher.py`
        - 日志系统重构，日志统一保存在项目根目录下的logs文件夹内，并自动清理旧日志（仅保留最新 10 条）
        - 打捞前会先进行一遍人形回收(仅二星)
    - 修复:上个版本打捞出现的各种问题:清理人形后卡在主界面等

---

## 🛠️ 功能介绍

### ✅ 已实现功能

📅 活动战役

| 状态 | 功能介绍                                 | 脚本名称                          |
|:--:|:-------------------------------------|:------------------------------|
| ✅  | **“纵向应变 - 五重奏回旋曲ux”** 自动打捞 (M240L)   | `longitudinal_strain`         |
| ✅  | **“灰域调查 - 计划模式”** 自动执行               | `grey_zone_inquiry`           |
| ✅  | **“裂变链接 - 底层归乡2 战斗EX ”** 自动打捞 (MP41) | `shattered_connexion`         |
| ✅  | **“裂变链接 - 认知裂变1 战斗EX (跑步机)”** 自动执行   | `shattered_connexion_running` |
| ❌  | ~~**“溯源回归 - 行星环ex”** 自动打捞~~ (活动已结束)  | `back_to_origin`              |
| ❌  | ~~**“虚子粒对 - 真空湮灭ex”** 自动打捞~~ (活动已结束) | `virtual_pair`                |
| ❌  | ~~**“蝴蝶星云-特殊的派遣ex”** 自动打捞~~ (活动已结束)  | `butterfly_nebula`            |
| ❌  | ~~**“零态潮汐-种子ex”** 自动打捞~~ (活动已结束)     | `quantum_fluctuation`         |

🗺️ 常规战役

| 状态 | 功能介绍                          | 脚本名称           |
|:--:|:------------------------------|:---------------|
| ✅  | **“1-1 刷友情点”** 自动执行           | `1_1`          |
| ✅  | **“8-1 夜战 双Zas拖尸”** 自动执行      | `8_1_midnight` |
| ✅  | **“9-4 夜战 ”** 自动打捞 (斯捷奇金专属枪托) | `9_4_midnight` |
| ✅  | **“13-4 双vector拖尸”** 自动执行     | `13_4_vector`  |
| ✅  | **“循演战役 A-普通”** 自动执行          | `a_normal`     |
| ✅  | **“循演战役 A-紧急”** 自动执行          | `a_emergency`  |
| ✅  | **“循演战役 A-夜战”** 自动执行          | `a_midnight`   |

📂 其他

| 状态 | 功能介绍               | 脚本名称               |
|:--:|:-------------------|:-------------------|
| ✅  | **“拉弗伯雷兵棋”** 开房间挂机 | `wargame`          |
| ⬜  | **资源管家**（新建文件夹）📁  | `asset_maintainer` |

### 🚨 异常处理能力

可自动识别并处理以下常见意外窗口并返回主菜单：

- 仓库已满 → 自动操作人形、装备回收
- 主界面检测重创 → 自动一键修理
- 后勤完成提示 → 重新执行
- 成就解锁提示 → 自动关闭
- “灰域调查”模式下各种异常情况

### 📌 使用注意事项

- **关闭 “自动补给” 功能**：设置方法：游戏设置 → 作战 → **关闭**“自动补给”。
- **关闭 “二次确认” 功能**：设置方法：游戏设置 → 作战 → **关闭**“回合结束二次确认”。
- **使游戏处于主菜单页面**：运行脚本前需要让游戏在主菜单页面，所有的操作都从主菜单开始。未打开游戏时，脚本会自动打开游戏。
- **详细注意事项在每个脚本最上方的注释中**：如梯队设置(主力/狗粮)
  ，打捞人形设置，难度设置等，请仔细观看。**参数设置在脚本最下方的`main()`函数内**

---

## 📖 使用说明

1. 本项目需在 **125% 缩放比例** 下运行，分辨率 **1920x1080**，游戏设置为 **窗口化 + 分辨率1600x900**
    - 设置方法：
        - 系统缩放：桌面右键 → 显示设置 → 缩放与布局 → 125%
        - 系统分辨率：桌面右键 → 显示设置 → 分辨率 → 1920x1080
            - 屏幕分辨率可以不用设置成 1920x1080，只要确保缩放是125%(但如果运行脚本时出现问题，建议还是设置成 1920x1080)
        - 游戏分辨率：游戏设置 → 分辨率 → 1600x900
        - 游戏显示模式：游戏设置 → 显示模式 → 选择“窗口化”

2. 请确保项目路径中不包含中文或特殊字符
3. 建议以 **管理员权限运行**（不是必须，只要不报错）
4. **执行脚本位于 `game_scripts/` 文件夹内，参数设置见执行脚本中的 `main()` 函数**
5. 使用该程序时尽力关闭含"少女前线"字样的其他程序，避免干扰窗口识别:如带有"少女前线"字样的的网页，QQ群聊等

---

## 🧩 总控脚本（Launcher）使用说明

总控脚本用于统一调度所有关卡脚本，让整个项目不再需要“逐个进入脚本文件、修改参数、手动运行”。现在只需要编辑一个配置文件就能完成复杂的自动化任务流程。

1. 执行入口只有一个，`game_scripts/launcher.py`，运行之后程序会自动加载 `game_scripts/mission_plan.yaml`
2. `mission_plan.yaml` 配置说明:一个任务包含三个字段`type`、`level`、`args`,可以配置多个任务,启动后从上到下依次执行

| 字段      | 类型     | 说明                                                    |
|---------|--------|-------------------------------------------------------|
| `type`  | string | 脚本文件夹的名称，(日常战役对应`main_mission`/`活动战役对应event_mission`) |
| `level` | string | 脚本文件名：如`a_normal`（不含 .py）                             |
| `args`  | dict   | 对应脚本的参数，具体填什么需要看具体脚本的主函数 `main(**params)`             |

---

# 鼠标图像识别与控制工具

本项目是一个基于图像识别的鼠标控制工具，结合 `pyautogui` 与 `win32api` 实现更加精确和人性化的鼠标操作，适用于自动化测试、游戏脚本、图像点击器等场景。

---

## ✨ 功能特色

- ✅ 基于图像识别的鼠标定位与点击（支持中心/随机点击）
- ✅ 精确模拟真实用户鼠标操作（贝塞尔曲线平滑移动 + 微抖动）
- ✅ 支持等待图像出现、识别后点击/移动等复合行为
- ✅ 控制参数高度可配置：延迟时间、偏移量、相似度等

---

## 🧰 依赖库

详情见 requirements.txt文件，安装方法：

```bash
pip install -r requirements.txt
```

---

## 📁 文件结构与功能说明

**文件结构**

| 路径 / 模块         | 功能简介           |
|-----------------|----------------|
| `assets/`       | 存放图像识别所需的模板图片  |
| └── `common/`   | 通用图像资源         |
| `config/`       | 配置文件           |
| `core_ops/`     | 鼠标控制与图像识别的核心模块 |
| `game_ops/`     | 封装各类游戏内常用的操作   |
| `game_scripts/` | 游戏脚本目录         |
| ├── `battle/`   | 战斗相关的脚本        |
| └── `other/`    | 其他类型的脚本        |
| `logs/`         | 脚本运行日志         |

**核心模块功能**

| 模块        | 功能简介                                                                              |
|-----------|-----------------------------------------------------------------------------------|
| 鼠标操作函数    | `move_to()`、`one_left_click()`、`scroll_mouse()` 等基本鼠标操作封装                         |
| 图像识别函数    | `locate_image()`、`locate_random_point_in_image()` 支持静态图像定位                        |
| 图像识别+鼠标动作 | `wait_image()`、`find_image()`、`hold_click_until_image()` 等综合操作                    |
| 鼠标平滑移动    | `move_mouse_smoothly()` 支持贝塞尔曲线模拟移动轨迹，带抖动与可视化                                     |
| 窗口操作函数    | `close_window()` `activate_window()`  `move_to_window_center()` 等基本窗口操作封装         |
| 应用程序控制    | `open_application_by_url()` 使用URL协议打开应用                                           |
| 总控调度模块    | `launcher.py` 统一管理与调度所有脚本，基于 `mission_plan.yaml` 自动加载并执行任务流程，实现“一键执行所有关卡脚本”的自动化流程 |

---

## 📷 鼠标轨迹可视化

开启 `move_mouse_smoothly(..., plot=True)` 参数可调试轨迹路径，查看模拟鼠标行为：
> 贝塞尔曲线模拟移动轨迹，到终点偏移后回正，并且模拟人手的微抖动

![轨迹示意图](https://github.com/user-attachments/assets/fd340e55-45c7-42fe-92c9-d909161d5223)

---

## 🧾 版本信息

- **2025.12.14**: v1.1.0.3(测试版)
    - 修复:任务序列时各种卡住的问题

- **2025.12.04**: v1.1.0.2(测试版)
    - 修复:
      - 总控执行一个任务后退出进程
      - 打捞出新人形卡住
      - 主界面回收人形后,错误点击钻石充值界面

- **2025.12.04**: v1.1.0.1(测试版)
    - 新增功能:
        - 添加总控，用于统一管理与调度所有关卡脚本，原本每个脚本都需要独立执行，现在可以通过一个总控入口统一管理，
          通过配置`mission_plan.yaml`文件，然后运行`launcher.py`
        - 日志系统重构，日志统一保存在项目根目录下的logs文件夹内，并自动清理旧日志（仅保留最新 10 条）
    - 修复:上个版本打捞出现的各种问题:清理人形后卡在主界面等

- **2025.11.28**: v1.0.12
    - 实现:常规战役 “循演战役 A-普通” 、“循演战役 A-紧急” 、“循演战役 A-夜战”自动打捞，可选择作战关卡跟打捞线路，参数设置见执行脚本中的
      `main()` 函数

- **2025.11.15**: v1.0.11
    - 修复:无法正确点击常驻活动入口，由之前的识别标识物+相对坐标来定位全部更换为通过图片定位

- **2025.10.20**: v1.0.10
    - 实现:“零态潮汐-种子ex” 自动打捞
    - 可以选择需要打捞的人形，如果不选择则默认打捞OTs-14，参数设置见执行脚本中的 `main()` 函数

- **2025.08.29**: v1.0.9.1
    - 修复:“蝴蝶星云-特殊的派遣ex” :打捞FARA 83线路选点错误的bug

- **2025.08.29**: v1.0.9
    - 实现:“蝴蝶星云-特殊的派遣ex” 自动打捞
        - 可以选择需要打捞的人形，如果不选择则默认打捞VHS，参数设置见执行脚本中的 `main()` 函数

- **2025.08.09**: v1.0.8
    - 新增“8-1n双Zas拖尸”脚本 （由 @moonight1199 编写）
    - 13-4vector拖尸脚本结构优化
    - 兵棋开房间挂机脚本结构优化

- **2025.08.09**: v1.0.7
    - 实现:“纵向应变-五重奏回旋曲ux” 自动打捞(M240L)
    - 实现:“1-1 刷友情点数” 自动执行

- **2025.08.02**: v1.0.6
    - 实现:“拉弗伯雷兵棋”开房间挂机 （由 @moonight1199 编写）
    - 修复少量bug

- **2025.08.01**: v1.0.5
    - 实现:“虚子粒对-真空湮灭ex” 自动打捞
        - 可以选择需要打捞的人形，如果不选择则默认打捞TKB-408，参数设置见执行脚本中的 `main()` 函数
    - 添加功能:通过脚本直接打开游戏，根据Steam的游戏url(AppID)打开少女前线:"steam://rungameid/3347970"
        - window_ops也封装了关闭应用的函数，如有需要可自行调用，实现全自动

- **2025.07.22**: v1.0.4
    - 实现:“9-4 夜战 斯捷奇金专属(APS专用枪托) ” 自动打捞
    - 修复了一些bug

- **2025.07.21**: v1.0.3
    - 实现:“裂变链接 - 认知裂变1 战斗EX (跑步机)” 自动执行
    - 实现:“13-4 双vector拖尸” 自动执行 （由 @moonight1199 编写）
    - 修复了一些bug

- **2025.07.20**: v1.0.2
    - 代码优化:重构操作逻辑的代码(放着不管迟早要变成屎山
    - 修复了一些bug

- **2025.07.18**: v1.0.1
    - 实现 “裂变链接 - 底层归乡2 战斗EX” 自动打捞 (MP41)

- **2025.07.16**: v1.0.0 初始版本
    - 实现 “溯源回归” 自动打捞
    - 实现 “灰域调查” 自动任务执行功能

---

## 🙏 鸣谢

特别感谢以下贡献者：

* **[@moonight1199](https://github.com/moonight1199)**

感谢他们的辛勤付出，完善了这个项目！

---

## 📜 授权协议

本项目遵循 MIT 开源协议，欢迎修改与分发，仅供学习与自动化测试使用，禁止用于恶意自动化行为。

Girls_Frontline_Helper

Girls_Frontline_Helper 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Girls_Frontline_Helper

Girls_Frontline_Helper 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README