From 02934466c1591a731ea36a36091f59a488ced75a Mon Sep 17 00:00:00 2001 From: xingluo Date: Thu, 22 Jan 2026 17:27:50 +0800 Subject: [PATCH] =?UTF-8?q?=E6=B7=BB=E5=8A=A0=20README?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README | 104 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 104 insertions(+) create mode 100644 README diff --git a/README b/README new file mode 100644 index 0000000..35bb12f --- /dev/null +++ b/README @@ -0,0 +1,104 @@ +# 无线键盘系统 - 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 +keyboard_server.lua +``` + +服务器启动后会自动: +- 初始化红网连接 +- 监听来自客户端的输入事件 +- 将接收的事件注入到本地事件队列 + +### 2. 客户端设置 + +在手提电脑上运行客户端程序: + +```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手提电脑变成一个功能完善的无线输入设备,非常适合在需要远程操作或多电脑环境下使用。 \ No newline at end of file