# WindowAutoController

**Repository Path**: YyModel/window-auto-controller

## Basic Information

- **Project Name**: WindowAutoController
- **Description**: 一个专为Windows设计的窗口鼠标坐标追踪和自动化工具，支持动态窗口大小适配和相对坐标系统。
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-05
- **Last Updated**: 2026-01-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 窗口鼠标坐标追踪器

一个专为Windows设计的窗口鼠标坐标追踪和自动化工具，支持动态窗口大小适配和相对坐标系统。

![Python Version](https://img.shields.io/badge/Python-3.10+-blue)
![Windows](https://img.shields.io/badge/Windows-7%2F8%2F10%2F11-lightgrey)
![License](https://img.shields.io/badge/License-MIT-green)

## ✨ 主要功能

- **窗口坐标追踪**: 实时追踪鼠标在指定窗口内的坐标位置
- **智能坐标适配**: 支持窗口大小变化时坐标自动调整
- **一键复制**: 按C键快速复制当前坐标，支持批量复制
- **中文输入优化**: 完美支持中文文本自动化输入
- **窗口管理**: 自动窗口置顶、激活、位置调整等

## 🚀 快速开始

### 安装依赖

```bash
pip install pywin32 pygetwindow pyperclip pynput pyautogui
```

### 基本使用

1. 运行 `mouse_tracker.py` 启动坐标追踪器
2. 选择要追踪的窗口并绑定
3. 在窗口内移动鼠标查看实时坐标
4. 按C键复制当前坐标

```python
# 示例：使用WindowAutoController自动化操作窗口
from 类_deepseek import WindowAutoController

# 绑定窗口
controller = WindowAutoController(window_title="记事本")

# 鼠标操作
controller.click(100, 150)  # 在窗口内(100,150)位置点击
controller.move_to(200, 200, duration=0.5)  # 平滑移动到(200,200)

# 文本输入（支持中文）
controller.typewrite("你好世界！")  # 自动检测中文并使用最佳输入方式

# 键盘操作
controller.hotkey('ctrl', 's')  # 保存文件
```

## 📸 界面截图

以下是软件主要界面展示：

1. **程序和目标窗口同框显示**
   ![程序和首页同框图](/media/程序和首页同框图.png)

2. **绑定目标程序后的界面**
   ![绑定程序后的首页](/media/绑定程序后的首页.png)

3. **窗口缩放状态下的坐标适配**
   ![缩放状态下的首页](/media/缩放状态下的首页.png)

4. **全屏模式下的效果**
   ![全屏的首页](/media/全屏的首页.png)

## 📚 详细文档

- [完整使用说明](mouse_tracker_使用说明.md) - 图形界面使用指南
- [API文档](WindowAutoController文档.md) - 开发者参考手册

## 🎯 应用场景

- **GUI自动化测试**: 精确记录界面元素位置
- **游戏辅助工具**: 收集游戏内坐标点
- **自动化脚本**: 为自动化脚本提供准确的坐标数据
- **界面开发调试**: 辅助UI设计和调试工作

## ⚠️ 系统要求

- Windows 7/8/10/11
- Python 3.10+
- 管理员权限（推荐）

## 🔧 故障排除

- 某些安全软件可能需要添加例外
- 详细错误信息请查看控制台输出

### v1.0
- 初始版本发布
- 基础窗口绑定和坐标追踪功能

## 📄 许可证

本项目采用 MIT 许可证 - 详见 [LICENSE](LICENSE) 文件

## 👨‍💻 作者

BS - 微信: duyanbz

---

⭐ 如果这个项目对您有帮助，请给我们一个星标！