Generic Pipe（通用管道方块）

Generic Pipe 是 LogisticsPipes 模组中的核心管道方块，实际上是一个玻璃方块，用于承载 40+ 种管道类型。

基本信息

双层架构

[LogisticsBlockGenericPipe] (玻璃方块, BlockContainer)
         ↓ createNewTileEntity()
[LogisticsTileGenericPipe] (TileEntity wrapper)
         ↓ contains
[CoreUnroutedPipe / CoreRoutedPipe] (实际管道逻辑)

• LogisticsBlockGenericPipe：Minecraft 层面的方块，处理放置、破坏、渲染
• LogisticsTileGenericPipe：包装层，处理连接逻辑、渲染状态、facades
• CoreRoutedPipe/CoreUnroutedPipe：实际管道逻辑，定义行为

管道注册

每种管道类型是独立的 Item 类（在 src/main/java/logisticspipes/items/ 下），放置时调用 LogisticsBlockGenericPipe.pipes 映射：

ItemPipes.BasicLogisticsPipe         → Basic Logistics Pipe
ItemPipes.RequestLogisticsPipeMk2    → Request Logistics Pipe Mk2
ItemPipes.CraftingLogisticsPipe      → Crafting Logistics Pipe Mk1
ItemPipes.CraftingLogisticsPipeMk2   → Crafting Logistics Pipe Mk2
ItemPipes.CraftingLogisticsPipeMk3   → Crafting Logistics Pipe Mk3
ItemPipes.ProviderLogisticsPipeMk2   → Provider Logistics Pipe Mk2
ItemPipes.SatelliteLogisticsPipe     → Satellite Logistics Pipe
// ... 40+ 种

管道类型分类总览

物品运输管道详解

Basic Logistics Pipe（基础物流管道）

核心差异：最基础的路由管道，只有一个 ModuleItemSink，作为网络的简单终点。被动接收物品，没有提取/请求/合成能力。

特有功能：

• ModuleItemSink 集成：接收路由过来的物品，插入相邻库存
• isLockedExit() — 电力枢纽和安全提供者方向锁定出口
• hasGenericInterests() — 作为默认路由时返回 true（接受任何物品）

使用场景：作为简单的存储终点。物品路由到它会直接插入相邻库存。

与 Provider 管道的区别：Basic 没有提取/供应逻辑。Provider 主动从相邻库存提取并向网络提供物品。Basic 只是被动接收。

Provider Pipe Mk1 / Mk2（供应管道）

核心差异：物流网络的物品来源。主动从相邻库存提取物品并发布给路由系统，让网络任何地方的请求都能用到这些物品。

两代区别：

共有功能：

• ExtractionMode 提取模式：控制从箱子提取时留下多少
  • Normal：提取全部
  • LeaveFirst：每堆留 1 个
  • LeaveLast：每堆留最后 1 个
  • LeaveFirstAndLast：首尾各留 1 个
  • Leave1PerStack：每堆留 1 个
  • Leave1PerType：每种物品留 1 个
• 9 槽过滤器库存：白名单或黑名单特定物品（isExcludeFilter 切换）
• HUD 支持：监视箱子内容和订单管理器状态

使用场景：放在任何存储物品的库存（箱子、机器输出）旁边。它会持续提取物品并发布到物流网络供其他地方请求。

Request Pipe Mk1 / Mk2（请求管道）

核心差异：玩家向物流网络请求物品的主要接口。提供 GUI 界面和完整的 IRequestAPI + ComputerCraft 编程接口。

使用方式：放在玩家存储/末影箱或合成区附近。用扳手右键打开 Orderer GUI，向网络请求任何可提供或可合成的物品。

Mk1 vs Mk2

Mk2 可以预配置请求列表到磁盘，实现一键批量订购。

请求类型（ActiveRequestType）

Request Pipe 内部使用 RequestTree.ActiveRequestType 枚举定义请求行为：

实际使用中的请求模式：

• 普通请求（Normal）：阻塞直到完全满足或无法满足，返回 SimulationResult{used, missing}
• 模拟请求（Simulate）：仅预览，不实际执行 — 用于查询"如果请求 X 会发生什么"
• 接受部分（AcceptPartial）：不等全额，有多少算多少 — 用于分批供应场景

ComputerCraft 编程接口：

-- 请求物品
makeRequest("minecraft:iron_ingot", 64)
-- 查询
getAvailableItems()     -- 返回网络可用的所有物品
getCraftableItems()     -- 返回可合成的物品
getItemAmount("minecraft:gold_ingot")  -- 返回可用数量

Remote Orderer Pipe（远程订购管道）

核心差异：没有自己的 GUI，通过手持 RemoteOrderer 物品进行远程交互。可以跨维度操作。

与 Request Pipe 的区别：Request Pipe 有内置 GUI（扳手右键打开）。Remote Orderer 无 GUI — 所有交互通过手持工具远程渲染 GUI。

特有功能：

• 手持 RemoteOrderer 物品对管道右键链接（connectToPipe(stack, this)）
• RemoteOrderer 在 NBT 中存储管道坐标和维度
• 能量消耗随距离缩放：跨维度 2500 + 欧几里得距离

Crafting Pipe Mk1 / Mk2 / Mk3（合成管道）

核心差异：自动化合成引擎。连接到 Minecraft 合成机器（Forestry 多线/合成台），处理完整的合成流程：接收合成请求、管理原料、触发合成、交付成品。

使用场景：放在 Forestry 多线/合成台旁边。配置要合成的物品，或链接卫星管道从远程箱子获取原料。

三代区别

Mk3 的关键价值：当网络繁忙无法立即接收成品时，16 槽缓冲库存可以暂存最多 16 叠溢出物品，等网络空闲时再注入。实现持续向繁忙网络合成而不卡死。

卫星管道链接（Satellite ID）

合成管道支持链接卫星管道实现分布式合成：

1. 在装有原料的箱子旁边放置 Satellite Pipe，分配一个 ID（如 1）
2. 在合成管道 GUI 的卫星槽填入 1
3. 合成时，系统会从 ID=1 的卫星管道所在箱子获取原料

高级卫星：Mk2/Mk3 支持最多 9 个卫星 ID（advancedSatelliteIdArray[9]），并行从 9 个不同位置获取不同原料。

模糊合成：fuzzyCraftingFlagArray[9] 对每个原料槽启用 OreDictionary 模糊匹配（羊毛 16 色、圆石变种等自动识别为等价原料）。

NEI 配方导入

Crafting Pipe 是所有管道类型中功能最丰富的，具有独立的 3×3 合成界面。通过 LogisticsPipes 内置的 NEI 集成，可以直接将其他模组的配方导入管道。

操作流程：

1. 右击 Crafting Logistics Pipe，打开管道 GUI
2. 打开 NEI，找到目标输出物品的合成配方
3. NEI 界面左下角点击 “Overlay” 按钮
4. 系统自动将配方映射到管道的 3×3 合成格
5. 若某格子有多个候选物品（如羊毛有 16 色），弹出 GuiRecipeImport 让你选择

支持导入的配方来源：

Satellite Pipe（卫星管道）

核心差异：作为合成的原料来源中继。通过卫星 ID 将合成请求重定向到不同位置 — 使合成机器可以放在离需求地点远的地方。

核心机制：

• 分配一个 卫星 ID（0-9+，用 GUI 按钮循环）
• 每 20 ticks 扫描所有 6 个相邻库存并跟踪内容
• 当合成管道 satelliteId = N 时，从 ID=N 的卫星管道获取原料
• 同时支持物品和流体合成

使用场景：放在装有合成原料的箱子旁边。分配一个 ID。在合成管道中填入该 ID。现在合成管道会从那个远程箱子获取原料，而不必把原料箱放在合成机旁边。

HUD 支持：显示连接的箱子内容。

Supplier Pipe（主动供应管道）

核心差异：Provider 管道的"反函数"。Provider 从库存提取服务于网络；Supplier 监视库存并主动从网络请求物品以保持该库存的补给。

特有功能：

• 9 槽"保持库存"库存：指定需要的物品和数量
• 每 tick 轮询：比较当前库存与需求数量，请求差额
• _requestPartials：是否接受部分交付
• _requestedItems 映射：跟踪待处理请求，物品到达时递减避免重复请求
• isRequestFailed()：如任何请求无法满足则为 true Request Mode（请求模式）：控制何时请求、请求多少、是否接受部分交付。

触发条件代码逻辑（ModuleActiveSupplier.createSupplyRequest() 第 352-364 行）：

if (_requestMode == SupplyMode.Infinite) {
    // 持续补货到 maxStackSize
    item.setValue(Math.min(item.getKey().getMaxStackSize(), spaceAvailable));
} else if (spaceAvailable == 0
        || (_requestMode == SupplyMode.Bulk50 && haveCount > item.getValue() / 2)
        || (_requestMode == SupplyMode.Bulk100 && haveCount >= item.getValue())) {
    item.setValue(0); // 不请求
}

Partial vs Full 请求方式（第 395-406 行）：

• Partial → RequestTree.requestPartial() — 允许部分交付，网络有货就收
• Full → RequestTree.request() — 阻塞式，必须全部满足才成功

Bulk 阈值示意：

Bulk50:  [====|====|----] → 50% 以下才补货
Bulk100: [----|====|====] → 不满即补货
         ↑            ↑
       补货点       补货点

使用场景：

• Partial：适用于消耗快速的物品，希望尽可能拿到货
• Full：适用于精确需求的合成原料，缺一件都不行
• Bulk50：减少请求频率，适合稳定消耗的物品
• Bulk100：更积极的补货策略，适合不能断货的关键物品
• Infinite：持续向网络拉货到最大堆叠数，适合作为全网络的中转分发点

与 Provider 的区别：

底盘管道（Chassis Pipe）

概述

核心差异：一个空壳管道，接受插入式模块（来自 ItemModule）到物理槽中。模块决定实际功能 — 单一管道类型根据插入的模块变成 Provider、Crafter、Sink、Extractor 或自定义行为。

这使得 Chassis Pipe 成为 LogisticsPipes 中最灵活的系统：通过不同的模块组合，一个管道可以实现几乎任何功能。

Mk1-Mk5 对比

只有槽数不同。所有其他底盘机制（方向旋转、模块路由、升级系统）完全相同。

方向旋转机制

Chassis Pipe 会自动旋转面对相邻库存（非管道、非路由的方块）。nextOrientation() 循环到下一个有效相邻库存，确保管道始终指向正确的目标。

模块路由

ChassiModule 内部管理最多 getChassiSize() 个模块。ChassiTargetInformation 将到达的物品路由到正确的模块槽。

蜜蜂管道（Bee Pipes）

Apiarist Analyser Pipe（蜜蜂分析管道）

核心差异：专为 Forestry 蜜蜂分析的专业管道。将蜜蜂路由到物流网络并自动插入分析机。

特有功能：

• 自动检测相邻 Forestry IAnalyser 或 Binnie IAnalyser
• getPointedOrientation()：扫描 6 个面找到分析机
• TransportLayer.itemArrived()：将到达物品重定向到分析机
• hasGenericInterests()：true — 接受任何蜜蜂

使用场景：放在 Forestry 蜜蜂分析机旁边。路由到该管道的蜜蜂自动插入分析机进行基因分析。蜜蜂分析后可以追踪基因信息。

Apiarist Sink Pipe（蜜蜂接收管道）

核心差异：专为 Forestry 蜜蜂的专用接收管道。按基因特征过滤蜜蜂，只接受匹配的蜜蜂进入物流网络。

FilterType 枚举（12 种过滤模式）：

特有功能：

• SinkSetting[6]：每个槽有 filterType、firstBee、secondBee、filterGroup
• 只接受已分析的蜜蜂（未分析的蜜蜂不被路由）
• 能量消耗：2/接受的物品
• FixedPriority.APIARIST_BeeSink：蜜蜂的高优先级接收器

使用场景：作为有特定基因的蜜蜂的目的地。配置过滤器槽只接受特定蜜蜂物种/特征，用于筛选纯种、优选繁殖系等。

网络管理管道

Firewall Pipe（防火墙管道）

核心差异：阻塞管道，作为网络分段工具。可基于物品过滤器阻塞路由、合成、供应和电力。

特有功能：

• 36 槽（6×6）过滤器库存
• 阻塞标志：
  • blockProvider：阻塞对面 Provider 管道的物品
  • blockCrafting：阻塞对面合成管道
  • blockSorting：阻塞常规路由/分拣
  • blockPower：阻塞电力枢纽（默认: true）
  • isBlocking：总开关
• 扳手点击打开防火墙配置 GUI

使用场景：

• 将网络分段成区域
• 放在子网络之间隔离合成设置
• 创建防火墙区域防止某区域物品外流
• 防止 Provider 从不该提取的地方提取

InvSys Connector（库存系统连接器）

核心差异：使用频率卡（UUID）在网络中两个远距离管道之间创建直接、低阻力的连接。用于桥接大距离而不经过中间管道。

特有功能：

• 1 槽频率卡库存
• addDirectConnection()：在 SimpleServiceLocator.connectionManager 注册此管道
• 直接路由：物品发送到这里绕过正常路由，直达配对的连接器
• itemsOnRoute 映射：跟踪此连接上正在传输的物品

使用场景：在两个位置各放置一个 InvSys Connector，插入相同的频率卡。现在它们形成直接点对点链路。用于跨维度或长距离桥接，无需经过大量中间管道。

与基础物流管道的区别：基础物流使用累积路由成本的正常路由。InvSys Connector 创建专用的低阻力直接链路。

System Destination / Entrance Pipe（系统目标/入口管道）

核心差异：通过频率卡配对的端点管道对。Destination 发送、Entrance 接收，形成专用通道。

流体管道详解

PipeFluidBasic（流体基础管道）

核心差异：最简单的流体管道。接收来自网络的流体并存储在内部罐中。

特有功能：

• 1 槽过滤器库存（过滤接受的流体类型）
• IFluidSink 接口：sinkAmount(FluidStack) — 返回要接受多少流体
• GUI 打开时暂停接收（guiOpenedBy 玩家列表）

使用场景：简单的流体缓冲/接收器。放在流体使用机器旁边。

PipeFluidProvider（流体供应管道）

核心差异：流体版 Provider 管道。主动从相邻罐提取流体并向流体物流网络提供。

特有功能：

• IProvideFluids 接口
• getAvailableFluids()：扫描相邻罐并返回流体类型+数量
• canProvide(RequestTreeNode, RequestTree, List<IFilter>)：响应流体请求
• 支持 ISpecialTankAccessHandler（GT5 超级罐等）

PipeFluidRequestLogistics（流体请求管道）

核心差异：流体版请求管道。允许玩家向网络请求流体。

特有功能：

• 扳手点击打开 GUI_Fluid_Orderer_ID
• makeRequest(FluidIdentifier, Long amount)：ComputerCraft 命令请求毫桶（mB）单位的流体
• getAvailableFluids()：返回 fluidRegistryName -> amount(mB) 映射

PipeFluidExtractor（流体提取管道）

核心差异：主动从相邻 IFluidHandler 罐拉取流体到流体管道网络。

特有功能：

• 提取速率：每 tick 每方向 500 mB
• 能量/流：5
• 每 10 ticks 运行一次

PipeFluidInsertion（流体插入管道）

核心差异：流体版基础物流管道。接收来自网络的流体并插入相邻罐。

特有功能：

• canInsertToTanks()：false（不插入网络罐）
• canReceiveFluid()：true（从网络接收）
• 使用 SimpleServiceLocator.logisticsFluidManager.getBestReply() 找最佳目的地

PipeFluidSatellite（流体卫星管道）

核心差异：物品卫星管道的流体版。链接到合成管道以获取流体合成原料。

特有功能：

• ModuleSatelite 内嵌模块
• satelliteId：链接到合成管道的数字 ID
• 每 20 ticks 扫描相邻 IFluidHandler 罐
• liquidLost()：跟踪失败交付实现可靠传输

PipeItemsFluidSupplier Mk1 / Mk2（流体供应管道）

核心差异：流体版主动供应管道。监视相邻流体罐并自动订购流体容器以保持罐的补给。

Mk1 vs Mk2

Mk2 特有：

• phantomTank：表示目标液位的单个 FluidTank
• amount：维持的目标量（mB）
• refillThreshold：触发新请求前的最小空位（mB）
• requestPartials：是否接受部分填充
• IMUICompatiblePipe：使用 ModularUI 配置 GUI

Crafting Pipe 的请求类型详解

Crafting Pipe（合成管道）内部使用 RequestTree.ActiveRequestType 来处理合成请求，以下是各类型的实际作用：

Provide（0）

声明可提供某物品。从相邻合成机器提取成品并发布到物流网络。用于 Provider 管道。

Craft（1）

触发合成管道执行合成任务的核心类型。当 Request Pipe 向网络请求某物品时，如果没有 Provider 能直接满足，系统会找到 Crafting Pipe 并发送 Craft 请求。

AcceptPartial（2）

接受部分满足。正常情况下请求会阻塞直到完全满足（或者返回 missing 列表）。启用 AcceptPartial 后，即使只能满足一部分，也继续交付已有的部分，不等待全额。这对分批供应和缓冲合成场景很重要。

SimulateOnly（3）

仅模拟，不执行。返回 SimulationResult{used, missing} 预览如果执行该请求会使用哪些物品、缺少哪些物品。用于 ComputerCraft 编程查询"请求 X 需要什么原料"。

LogMissing（4）

记录缺失但不阻塞。如果请求无法满足，记录到日志但不停止请求流程。用于监控/调试。

LogUsed（5）

记录已使用的物品到历史。Crafting Pipe 维护最近 20 个网络库存快照（每 1200 tick / 约 60 秒）。LogUsed 记录实际消耗的物品，用于历史追踪。

管道选择指南

我应该用哪个管道？

关键架构模式

1. 管道+模块分离：大多数管道委托给内嵌模块类（如 PipeItemsCraftingLogistics → ModuleCrafter）。Mk 变体通常只交换模块类而保持管道外壳。

2. Mk 版本命名语义：跨所有管道类型，Mk2 = “更高吞吐量/更快” — 相同基本功能，更多功率。Mk3 增加缓冲或附加功能。

3. 可靠传输：实现 IRequireReliableTransport 的管道通过 DelayQueue 跟踪丢失物品并自动重新请求。

4. 卫星 ID 系统：被物品和流体合成管道使用，从远程卫星管道获取原料 — 实现分布式合成设置。

5. RequestTree 路由算法：ResourceType 顺序 PROVIDER → CRAFTING → EXTRA 决定优先满足路径。先查 Provider 有没有现货，没有则查 Crafting 能否合成，都没有则返回缺失。

第三方集成