更新 README.md

This commit is contained in:
2026-01-22 17:31:15 +08:00
parent 02934466c1
commit 646e0c8c39

114
README.md Normal file
View File

@@ -0,0 +1,114 @@
# 无线键盘系统 - README
## 概述
这是一个基于 CC:T (ComputerCraft: Tweaked) 的无线键盘系统,通过红网 (Rednet) 实现远程输入功能。系统由客户端运行在CC:T手提电脑上和服务器端运行在目标主机电脑上组成允许您使用手提电脑作为无线键盘向主机发送键盘和鼠标事件。
主要为在大屏幕上运行程序的输入服务
## 功能特点
- **无线输入**: 通过红网传输键盘和鼠标事件
- **多频道支持**: 可存储多达4个目标电脑的ID (Q/W/E/R键对应)
- **Fn组合键功能**:
- Fn + Q/W/E/R (短按): 切换目标频道
- Fn + Q/W/E/R (长按): 进入ID配对模式
- Fn + 数字键(1-0,-,=): 模拟F1-F12功能键
- **多种事件支持**: 支持按键、鼠标点击、滚动、字符输入、粘贴等事件
## 安装要求
- **客户端**: CC:T 手提电脑 + 无线调制解调器
- **服务器端**: 任何CC:T电脑 + 无线调制解调器
- **CC:T版本**: 支持最新版CC:T mod
## 文件结构
```
客户端程序: keyboard_client.lua
服务器端程序: keyboard_server.lua
配置文件: .key_config (自动生成)
```
## 使用说明
### 1. 服务器端设置
在目标主机电脑上运行服务器程序:
```lua
wget https://git.liulikeji.cn/xingluo/cct-keyboard/raw/branch/main/Keyboard_server.lua
```
```lua
keyboard_server.lua
```
服务器启动后会自动:
- 初始化红网连接
- 监听来自客户端的输入事件
- 将接收的事件注入到本地事件队列
### 2. 客户端设置
在手提电脑上运行客户端程序:
```lua
wget https://git.liulikeji.cn/xingluo/cct-keyboard/raw/branch/main/Keyboard_client.lua
```
```lua
keyboard_client.lua
```
### 3. 配对目标电脑
1. 按下 `Fn + Q/W/E/R` (长按) 进入配对模式
2. 输入目标电脑的ID数字
3. 配对信息会自动保存到配置文件
### 4. 切换目标频道
- 短按 `Fn + Q/W/E/R` 在不同目标频道间切换
- 屏幕顶部会显示当前选中的目标频道和对应电脑ID
### 5. 特殊功能键
- `Fn + 1``Fn + =`: 分别对应 F1 至 F12 功能键
## 配置说明
配置文件 `.key_config` 自动生成,包含以下设置:
```lua
{
events = {支持的输入事件类型},
fn_key = "功能键设置", -- 默认为右Alt键
target_channels = {频道配置}, -- Q/W/E/R对应的目标电脑ID
special_keys = {特殊键映射}, -- Fn组合键映射
protocol = "通信协议" -- 默认为"wireless_keyboard"
}
```
## 通信协议
系统使用自定义协议 `wireless_keyboard` 进行通信,确保客户端和服务器使用相同的协议名称。
## 故障排除
1. **无法连接**: 确认双方都安装了无线调制解调器且红网已开启
2. **事件未传递**: 检查目标电脑ID是否正确配置
3. **Fn键无效**: 确认配置中的fn_key设置与实际按键匹配
## 注意事项
- 确保客户端和服务器在红网覆盖范围内
- 首次使用前需要先配对目标电脑ID
- 配置文件会自动保存,重启后设置不会丢失
## 更新日志
- 初始版本: 基础键盘事件传输功能
- 支持多频道切换和Fn组合键功能
这个系统可以让您的CC:T手提电脑变成一个功能完善的无线输入设备非常适合在程序运行在大屏时使用