Metadata-Version: 2.4
Name: screen-keyboard
Version: 1.0.2
Summary: 手机键盘控制电脑 - 通过手机浏览器控制电脑输入
Author-email: Your Name <your-email@example.com>
License-Expression: MIT
Project-URL: Homepage, https://github.com/your-username/screen-keyboard
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: flask>=2.3.0
Requires-Dist: flask-socketio>=5.3.0
Requires-Dist: pynput>=1.7.6
Requires-Dist: python-socketio>=5.10.0
Requires-Dist: python-engineio>=4.8.0
Requires-Dist: simple-websocket>=1.0.0
Requires-Dist: click>=8.0.0
Provides-Extra: dev
Requires-Dist: pytest; extra == "dev"
Requires-Dist: black; extra == "dev"
Requires-Dist: flake8; extra == "dev"
Dynamic: license-file

# 手机键盘控制电脑

通过手机浏览器访问网页，使用虚拟键盘控制电脑输入。

**原理**：网页发送键盘按键到电脑，由电脑上的输入法（如搜狗、微软拼音）处理拼音转换。

## 快速安装

### 方法一：pip 安装（推荐）

```bash
# 安装
pip install screen-keyboard

# 运行
screen-keyboard
```

### 方法二：源码安装

```bash
# 克隆或直接下载后
pip install -e .

# 运行
screen-keyboard
# 或
python app.py
```

### 方法三：一行命令安装

```bash
curl -sL https://raw.githubusercontent.com/your-username/screen-keyboard/main/install-one-line.sh | bash
```

## 使用方法

### 1. 启动服务

```bash
screen-keyboard
# 或
python app.py
```

服务端启动后会显示局域网地址，例如：
```
局域网地址：http://192.168.1.100:5000
```

### 2. 手机访问

在手机上连接同一 WiFi，用浏览器访问该地址即可。

## 功能

- ✅ 全键盘布局（QWERTY）
- ✅ 符号/数字键盘切换
- ✅ Shift 大写切换
- ✅ 特殊按键（回车、退格、空格）
- ✅ 方向键（倒 T 布局）
- ✅ 触控板鼠标控制
- ✅ 摇杆鼠标控制
- ✅ 鼠标左右中键 + 滚轮
- ✅ Win+Space 中英文切换
- ✅ 拖动窗口/文件（双击触控板后拖动）
- ✅ 锁定页面防止误触

## 说明

- 确保手机和电脑在同一局域网
- 电脑需开启拼音输入法
- 如果防火墙阻止，请开放 5000 端口

## 开发

```bash
# 创建 conda 环境
conda env create -f environment.yml
conda activate screen-keyboard

# 安装依赖
pip install -r requirements.txt

# 运行
python app.py
```

## 发布到 PyPI

```bash
# 安装构建和发布工具
pip install build twine

# 构建包
python -m build

# 上传到 PyPI
python -m twine upload dist/*

# 或使用发布脚本
chmod +x publish.sh
./publish.sh
```

首次发布需要配置 PyPI API Token：
```bash
# 创建 ~/.pypirc 文件
cat > ~/.pypirc << EOF
[distutils]
index-servers =
    pypi

[pypi]
username = __token__
password = pypi-xxxxx  # 从 https://pypi.org/manage/account/token/ 获取
EOF
```

## License

MIT License

