# 🎮 自动公屏广告助手

> 一款专为游戏玩家设计的自动化工具，帮助您在游戏公屏中定时发送广告信息（如公会招人、物品交易等）

## 🌟 功能特点

- **精准坐标控制**：通过可视化界面设置游戏内文本框和发送按钮的精确坐标
- **内容自定义**：自由编辑要发送的广告内容（支持中英文及特殊符号）
- **智能定时**：自定义发送间隔（0.1秒至1小时）和发送次数（支持无限循环）
- **操作反馈**：提供操作提示音和实时日志记录
- **深色主题**：现代化深色界面设计，减少长时间使用眼睛疲劳
- **配置保存**：自动保存所有设置，下次启动无需重新配置
- **安全可靠**：纯Python开发，不修改游戏内存，仅模拟鼠标键盘操作

## 📦 项目结构

```plaintext
.
├── pyproject.toml
├── readme.md
├── requirements.txt
└── src
    └── stv_AdHelper
        ├── core
        │   ├── window.py
        │   └── worker.py
        ├── main-ui.py
        ├── main.py
        └── utils
            └── utils.py
```

## ⚙️ 使用说明

### 1. 设置坐标

1. 点击"获取坐标"按钮
2. 5秒倒计时内将鼠标移动到游戏内：
   - **A点**：聊天输入框位置
   - **B点**：发送按钮位置
3. 程序自动捕获并保存坐标

### 2. 编辑内容

在"内容设置"区域输入要在公屏发送的广告文本

### 3. 配置参数

- **操作间隔**：设置发送广告的时间间隔（秒）
- **重复次数**：0=无限循环，n=执行n次后停止
- **提示音**：开启/关闭操作提示音

### 4. 开始执行

点击"开始执行"按钮，程序将按设定自动发送广告

## 🛠 运行环境

- **操作系统**：Windows 10/11, macOS, Linux

- **Python版本**：3.10+

- **依赖库**：
  
  ```bash
  PyQt5
  pyautogui
  pyperclip
  ```

## 🚀 安装与运行

1. 克隆仓库：
   
   ```bash
   git clone https://github.com/yourusername/stv_AdHelper.git
   cd stv_AdHelper
   ```

2. 安装程序：
   
   ```bash
   pip install .
   ```

3. 运行程序：
   
   `sadui` 是本工具的gui模式，如果您更喜欢cli模式，也可以运行 `sad`.
   `sad` 即为 `send Ad`.

   ```bash
   sadui
   ```

## ⚠️ 注意事项

1. 使用前请确保游戏窗口位置固定
2. 操作过程中请勿移动鼠标或切换窗口
3. 遵守游戏规则，避免发送过于频繁导致封号
4. 建议设置合理间隔（通常15-30秒为宜）
5. 本工具仅用于合法用途，禁止用于任何违规操作

## 📜 开源协议

本项目采用 [GPL v3 License](https://github.com/StarWindv/Ad-Helper/blob/main/LICENSE) 开源协议
