# pygui-tsh

**Repository Path**: exlimit/pygui-tsh

## Basic Information

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

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-22
- **Last Updated**: 2026-06-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# PrtSc - Windows 自动化截图工具

基于 Python 的 Windows 桌面自动化截图工具，通过 YAML 配置文件驱动鼠标点击、滚轮滚动、键盘操作，实现软件界面的自动化截图。

## 功能

- 自动查找并激活目标窗口
- 支持坐标点击、鼠标滚轮、键盘按键
- 全屏或区域截图，自动命名保存
- YAML 配置驱动，无需修改代码即可调整截图流程
- 支持翻页/滚动后连续多张截图

## 安装

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

## 使用

```bash
# 运行截图任务
python main.py --task config/tasks/sample.yaml

# 预览步骤（不实际执行）
python main.py --task config/tasks/sample.yaml --dry-run

# 列出所有可用任务
python main.py --list-tasks
```

## 配置文件格式

参见 `config/tasks/sample.yaml` 示例。

### 支持的 Action 类型

| Action | 参数 | 说明 |
|--------|------|------|
| `activate_window` | - | 查找并激活目标窗口 |
| `click` | `x`, `y` | 鼠标左键点击指定坐标 |
| `right_click` | `x`, `y` | 鼠标右键点击指定坐标 |
| `double_click` | `x`, `y` | 鼠标双击指定坐标 |
| `scroll` | `clicks`, `x?`, `y?` | 滚轮滚动（正=上，负=下） |
| `press_key` | `key` | 按下键盘按键（如 page_down） |
| `hotkey` | `keys` | 组合键（如 ctrl+c） |
| `type_text` | `text` | 输入文本 |
| `wait` | `seconds` | 等待指定秒数 |
| `screenshot` | `name`, `region?` | 截图并保存 |