# 按键助手

**Repository Path**: yang230147961/button-assistant

## Basic Information

- **Project Name**: 按键助手
- **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-01
- **Last Updated**: 2026-06-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 跑图按键

游戏按键自动化工具，支持 macOS 和 Windows。

## 特性

- 🎮 5 种模式：拦截、长按、点按、脉冲、序列
- 🖥️ 跨平台支持：macOS + Windows
- 🪟 浮窗界面：始终置顶，透明背景
- ⚡ 原生性能：CGEventTap (macOS) / ctypes (Windows)
- 🎨 现代 UI：Electron + HTML/CSS/JS

## 快速开始

```bash
# 直接运行
python main.py

# 或使用 python3
python3 main.py
```

## 项目结构

```
跑图按键/
├── main.py                    # 主入口
├── README.md
├── requirements.txt
├── src/                       # 源代码
│   └── core/                 # 核心逻辑
│       └── electron_bridge.py
├── electron-app/             # Electron 版本
│   ├── package.json
│   ├── src/
│   └── assets/
├── build.py                  # 打包脚本
└── .github/
    └── workflows/
        └── build.yml
```

## 使用说明

1. 运行 `python main.py`
2. 界面会自动显示
3. 选择目标应用和模式
4. 点击"开始"

## 快捷键

- `Ctrl+按键`：释放当前按键
- `Esc`：停止所有操作

## 权限设置

### macOS

1. 系统设置 → 隐私与安全性 → 辅助功能
2. 添加 Python 或 Electron 应用

### Windows

以管理员权限运行

## 打包

```bash
cd electron-app

# 打包当前平台
npm run build

# 打包所有平台
npm run build:all
```

## 开发

### 环境要求

- Python 3.10+
- Node.js 18+
- macOS: 辅助功能权限
- Windows: 管理员权限

### 依赖安装

```bash
# Electron 依赖
cd electron-app
npm install
```

## 许可证

MIT