cc物流系统V5

2025-10-24 02:43:59 +08:00
parent b6dea93a18
commit c38a55330c
15 changed files with 4804 additions and 0 deletions
--- a/Logistics/V5/README.md
+++ b/Logistics/V5/README.md
@@ -0,0 +1,148 @@
+# 物流系统 v5.0 文档
+
+## 概述
+物流系统 v5.0 是一个高级物品和流体传输系统，支持多容器操作和缓存模式。系统通过配置文件管理任务，支持复杂的过滤规则和优先级设置。
+
+## 核心功能
+
+### 1. 传输类型
+- **物品传输**：在容器间移动物品
+- **流体传输**：在容器间移动流体
+
+### 2. 缓存模式
+- 适用于及作为输出也作为输入的容器
+- 物品被送如时添加临时黑名单 这些物品不会被再次传输到别的容器
+
+### 3. 过滤规则
+- **白名单**：只允许特定物品传输
+- **黑名单**：禁止特定物品传输
+- **数量限制**：设置一次传输物品数量
+
+### 4. 优先级系统
+- 输出容器按优先级分组
+- 高优先级容器优先接收物品
+- 同优先级采用轮询机制
+
+## 配置文件结构
+配置文件存储在 `config.cfg` 中，包含以下部分：
+
+```lua
+{
+    settings = {
+        logEnabled = false, -- 日志开关
+        zhlog = false,      -- 中文日志开关
+        delay = 0.01        -- 轮询延迟(秒)
+    },
+    tasks = { -- 任务列表
+        -- 任务示例
+        {
+            type = "item", -- 或 "fluid"
+            input = {
+                ["容器名"] = {
+                    cache = true/false,
+                    whitelist = {["物品名"] = {}},
+                    blacklist = {["物品名"] = {}}
+                }
+            },
+            output = {
+                ["容器名"] = {
+                    priority = 数字,
+                    cache = true/false,
+                    whitelist = {["物品名"] = {count = 数量}},
+                    blacklist = {["物品名"] = {}}
+                }
+            }
+        }
+    },
+    Tlist = {} -- 缓存传输列表
+}
+```
+
+## 使用命令
+
+### 基本命令
+| 命令 | 描述 | 示例 |
+|------|------|------|
+| `add <JSON>` | 添加新任务 | `add {"type":"item","input":{"left":{...}},"output":{"right":{...}}}` |
+| `list` | 列出所有任务 | `list` |
+| `remove <索引>` | 移除任务 | `remove 1` |
+| `set <key> <value>` | 修改设置 | `set delay 0.05` |
+| `help` | 显示帮助信息 | `help` |
+| `exit` | 退出程序 | `exit` |
+
+### 设置命令
+| 键 | 值 | 描述 |
+|----|----|------|
+| `log` | true/false | 启用/禁用日志 |
+| `zh` | true/false | 启用/禁用中文日志 |
+| `delay` | 数字 | 设置轮询延迟(秒) |
+
+## 任务配置示例
+
+### 物品传输任务
+```json
+{
+    "type": "item",
+    "input": {
+        "left": {
+            "cache": true,
+            "whitelist": {
+                "minecraft:stone": {}
+            }
+        }
+    },
+    "output": {
+        "right": {
+            "priority": 1,
+            "whitelist": {
+                "minecraft:stone": {"count": 64}
+            },
+            "blacklist": {
+                "minecraft:dirt": {}
+            }
+        }
+    }
+}
+```
+
+### 流体传输任务
+```json
+{
+    "type": "fluid",
+    "input": {
+        "tank_left": {
+            "whitelist": {
+                "water": {}
+            }
+        }
+    },
+    "output": {
+        "tank_right": {
+            "priority": 2
+        }
+    }
+}
+```
+
+## 日志系统
+- **日志级别**：
+  - SUCCESS (绿色)：成功操作
+  - SKIPPED (橙色)：跳过操作
+  - INFO (白色)：一般信息
+  - WARNING (黄色)：警告信息
+  - ERROR (红色)：错误信息
+  - DEBUG (浅灰色)：调试信息
+
+- **日志格式**：
+  ```
+  [时间] 级别: 消息
+  ```
+
+## 注意事项
+1. 确保所有容器名称正确且可访问
+2. 确保所有容器链接到电脑的同一个调制解调器
+3. 流体容器必须支持流体接口
+4. 复杂的过滤规则可能影响性能
+5. 轮询延迟设置过低可能导致CPU占用过高
+
+系统通过高效的缓存机制和优先级处理，实现了复杂的多容器物流管理，适用于各种自动化场景。