screen-keyboard 1.0.2

手机键盘控制电脑 - 通过手机浏览器控制电脑输入

手机键盘控制电脑

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

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

快速安装

方法一：pip 安装（推荐）

# 安装
pip install screen-keyboard

# 运行
screen-keyboard

方法二：源码安装

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

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

方法三：一行命令安装

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

使用方法

1. 启动服务

screen-keyboard
# 或
python app.py

服务端启动后会显示局域网地址，例如：

局域网地址：http://192.168.1.100:5000

2. 手机访问

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

功能

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

说明

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

开发

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

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

# 运行
python app.py

发布到 PyPI

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

# 构建包
python -m build

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

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

首次发布需要配置 PyPI API Token：

# 创建 ~/.pypirc 文件
cat > ~/.pypirc << EOF
[distutils]
index-servers =
    pypi

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

License

MIT License