添加 README.md

README.md

@@ -0,0 +1,221 @@
+# ME空间原件控制器系统
+
+## 项目简介
+这是一个用于管理Applied Energistics 2（AE2）ME空间原件的自动化控制系统。通过海龟（ComputerCraft）和红网（Rednet）实现远程控制和监控ME空间原件的切换。
+
+## 系统架构
+- **服务器端**：运行在海龟上，负责实际控制ME空间原件的切换
+- **客户端**：运行在另一台计算机上，提供图形界面进行远程控制
+- **简易控制端**：紧急情况下使用的简单控制程序
+
+## 快速开始
+
+### 1. 环境要求
+服务端：
+- 基础外围设备：
+  - 左侧：红网调制解调器
+  - 右侧：扬声器（可选）
+  - 前方：AE2空间IO端口
+- 海龟（任意型号）
+
+客户端和简易控制端：
+- 基础外围设备：
+  - 任意：红网调制解调器
+
+### 2. 下载安装
+
+#### 服务器端（海龟）
+
+```shell
+wget https://git.liulikeji.cn/xingluo/computer-craft-AEspatial/raw/branch/main/server/startup.lua
+```
+
+#### 客户端（控制计算机）
+```shell
+wget https://git.liulikeji.cn/xingluo/computer-craft-AEspatial/raw/branch/main/panel/startup.lua
+```
+
+#### 简易控制端（备用）
+```shell
+wget https://git.liulikeji.cn/xingluo/computer-craft-AEspatial/raw/branch/main/sospanel/startup.lua
+```
+
+### 3. 依赖库自动安装
+程序会自动下载所需库文件：
+- **utf8ptrint.lua**：UTF-8打印支持
+- **basalt.lua**：图形界面库
+
+## 配置文件编写
+
+### 服务器端配置（海龟）
+
+#### 配置文件位置
+`config.cfg`（位于海龟的根目录）
+
+#### 配置格式
+```lua
+{
+    -- 当前已放出的原件 默认没有，代表没有已放出
+    current_disk = "主世界基地",  -- 当前激活的原件名称
+    current_slot = 1,             -- 当前原件所在的槽位
+    
+    -- 原件映射配置
+    disks = {
+        ["空间1"] = 1,      -- 格式: ["显示名称"] = 槽位编号
+        ["空间2"] = 2,
+        ["空间3"] = 3,
+    },
+    
+    -- 红网端口配置
+    rednet_ports = {
+        listen = 101,   -- 监听端口（接收命令）
+        status = 100,   -- 状态发送端口
+        response = 102  -- 响应发送端口
+    }
+}
+```
+
+#### 配置步骤
+1. 将ME空间原件放入海龟的指定槽位
+2. 编辑配置文件，为每个原件设置：
+   - 唯一的显示名称
+   - 对应的槽位编号
+
+#### 示例配置
+假设你有以下原件：
+- 槽位1：AE 工作区
+- 槽位2：MEK工作区
+
+配置文件示例：
+```lua
+{
+    disks = {
+        ["AE 工作区"] = 1,
+        ["MEK工作区"] = 2,
+    },
+    rednet_ports = {
+        listen = 101,
+        status = 100,
+        response = 102
+    }
+}
+```
+
+### 客户端配置（控制计算机）
+
+#### 配置文件位置
+`config.cfg`（位于控制计算机的根目录）
+
+#### 配置格式
+```lua
+{
+    -- 红网端口配置（必须与服务器端对应）
+    rednet_ports = {
+        control = 101,   -- 控制端口（发送命令）
+        response = 102,  -- 响应接收端口
+        status = 100     -- 状态接收端口
+    }
+}
+```
+
+### 简易控制端配置
+
+#### 配置文件位置
+`config.cfg`（位于简易控制端所在计算机的根目录）
+
+#### 配置格式
+```lua
+{
+    rednet_ports = {
+        control = 101,   -- 控制端口
+        response = 102   -- 响应端口
+    },
+    name = "空间1"  -- 要切换的原件名称
+}
+```
+
+## 使用方法
+
+### 服务器端（海龟）
+1. 确保海龟正确放置：
+   - 前方：连接AE2空间IO端口
+   - 左侧：连接红网调制解调器
+   - 右侧：连接扬声器
+
+2. 放入所有ME空间原件到海龟的对应槽位
+
+3. 启动服务器：
+```shell
+startup
+```
+
+4. 编辑配置文件，设置原件映射
+
+5. 再次启动服务器：
+```shell
+startup
+```
+
+5. 启动后会自动：
+   - 初始化红网连接
+   - 加载配置文件
+   - 开始监听控制命令
+   - 定期发送状态更新
+
+### 客户端（图形界面控制）
+1. 确保控制计算机有可用的红网调制解调器
+
+2. 编辑配置文件，设置正确的端口
+
+3. 启动客户端：
+```shell
+startup
+```
+
+4. 界面说明：
+   - 选中原件为绿色
+   - 当前激活的原件显示为红色
+   - 通过上下箭头或W/S键选择
+   - 按Enter或空格键切换
+   - 通过左右箭头或A/D键翻页
+
+### 简易控制端（紧急使用）
+1. 在任意有网卡的计算机上运行
+2. 编辑配置文件，设置要切换的原件名称
+3. 启动程序：
+```lua
+startup
+```
+4. 按下任意键即可切换到配置的原件
+
+## 端口说明
+| 端口 | 用途 | 方向 |
+|------|------|------|
+| 101 | 控制信道 | 客户端 → 服务器 |
+| 102 | 响应信道 | 服务器 → 客户端 |
+| 100 | 状态信道 | 服务器 → 客户端 |
+
+如果你有多个系统，请确保每个系统的端口独立，且同一系统端口一致
+
+
+## 高级功能
+
+### 声音提示
+服务器在操作时会播放声音：
+- 工作中：三次提示音 警告人员离开区域
+- 成功：高音提示
+- 错误：低音提示
+
+## 注意事项
+
+1. **安全警告**
+   - 确保主机处于区块加载内
+   - 在切换原件时，原空间内的玩家会被送往原件内
+   - 建议在无人时进行原件切换
+   - 如果不幸被送入原件，可以使用简易控制端
+
+
+如需进一步帮助，请提供：
+- 错误截图
+- 配置文件内容
+- 控制台输出信息