# phone-remote-pc

**Repository Path**: migeking_admin/phone-remote-pc

## Basic Information

- **Project Name**: phone-remote-pc
- **Description**: 📱 手机遥控PC - 用手机浏览器无线遥控你的电脑。支持键盘快捷键、鼠标模拟、场景预设等功能。
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

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

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 📱 手机遥控PC

用手机浏览器无线遥控你的电脑——控制PPT翻页、动画播放、大屏滚屏、快捷键注入、鼠标模拟、场景预设。同一局域网内，扫码即连，无需任何硬件。

---

## 功能特性

### ⌨️ 键盘控制
- 单键按键：方向键、空格、回车、Tab、ESC、PageUp/Down、Home、End、F5
- Ctrl 组合：复制(Ctrl+C)、粘贴(Ctrl+V)、撤销(Ctrl+Z)、全选(Ctrl+A)、保存(Ctrl+S)、刷新(Ctrl+R)、新标签(Ctrl+T)、关标签(Ctrl+W)、重做(Ctrl+Y)
- Alt 组合：切换窗口(Alt+Tab)、关闭窗口(Alt+F4)

### 🖱️ 鼠标控制
- 方向板移动鼠标
- 单击 / 双击 / 右键
- 滚轮上滑 / 下滑

### 🎬 场景预设
内置15个常用场景：PPT开始、PPT退出、全屏、播放/暂停、上一页、下一页、刷新、新标签、保存、音量+/-、静音、切换窗口、关闭窗口、开头

⭐ **自定义场景**：可在手机端直接添加自定义多步场景

### 🔗 连接方式
- **同一局域网**：手机浏览器直接访问 `http://<PC的IP>:8765`
- **扫码连接**：访问 `http://<PC的IP>:8765/qrcode.png` 获取二维码，手机扫码直连
- **UDP自动发现**：Phase 2 支持局域网UDP广播自动发现PC服务

---

## 快速开始

### 1. 安装依赖

```bash
cd D:\code\phone-remote-pc
pip install -r requirements.txt
```

### 2. 启动服务

```bash
python server.py
```

启动成功后会显示：

```
==================================================
  📱 手机遥控PC - 服务已启动
==================================================
  手机浏览器访问: http://192.168.x.x:8765
  二维码地址:      http://192.168.x.x:8765/qrcode.png
  按 Ctrl+C 停止服务
==================================================
```

### 3. 手机连接

**方式一**：手机浏览器直接访问显示的 IP 地址

**方式二**：手机扫描 `http://<PC的IP>:8765/qrcode.png` 生成的二维码

> ⚠️ 手机和PC必须在**同一Wi-Fi网络**下才能连接

---

## 项目结构

```
D:\code\phone-remote-pc\
├── SPEC.md          # 项目规格说明
├── README.md        # 本文件
├── requirements.txt # Python依赖
└── server.py        # 主服务程序（含手机HTML面板）
```

---

## API 接口

| 方法 | 路径 | 描述 |
|------|------|------|
| GET | `/` | 手机遥控面板HTML |
| GET | `/qrcode.png` | 连接二维码图片 |
| GET | `/status` | 服务状态 |
| GET | `/scene/list` | 所有场景列表 |
| POST | `/key` | 单键按键 `{"key": "f5"}` |
| POST | `/hotkey` | 组合键 `{"keys": ["ctrl","c"]}` |
| POST | `/mouse` | 鼠标操作 |
| POST | `/scroll` | 滚轮控制 |
| POST | `/scene/execute` | 执行场景 `{"scene": "ppt_start"}` |
| POST | `/scene/add` | 添加自定义场景 |
| POST | `/discover/start` | 启动UDP广播 |
| POST | `/discover/stop` | 停止UDP广播 |
| WS | `/ws` | WebSocket实时通道 |

---

## 分阶段计划

| 阶段 | 内容 | 时间 |
|------|------|------|
| **Phase 1** | MVP基础（键盘+鼠标+场景） | 1-3天 |
| **Phase 2** | WebSocket + 自定义场景 + UDP发现 | 4-7天 |
| **Phase 3** | Playwright大屏控制 + 定时轮播 | 8-14天 |
| **Phase 4** | Windows打包 + 配置UI + 日志 | 15-30天 |

---

## 技术栈

- Python 3.10+ / FastAPI + uvicorn
- pyautogui（键盘/鼠标模拟）
- WebSocket（实时双向通信）
- qrcode[pil]（二维码生成）
- Playwright（Phase 3 浏览器自动化）

---

## 安全说明

- `pyautogui.FAILSAFE = True`：鼠标移到屏幕左上角角落可强制停止所有操作
- 仅限局域网内使用，不建议暴露到公网
- Phase 4 将增加连接密码保护

---

## 常见问题

**Q: 手机打不开页面？**
A: 确认手机和PC连的是同一个Wi-Fi路由器；检查PC防火墙是否允许8765端口

**Q: 按键没反应？**
A: 有些程序需要管理员权限运行，请用管理员身份启动 `python server.py`

**Q: 怎么退出服务？**
A: 在运行服务的终端按 `Ctrl+C`

---

*MIT License · 2026*