Crate 依赖关系

EnerOS 由 56 个 Rust crate 组成，按依赖层次从下到上分为 L0 - L5 六个等级，对应五层架构。所有依赖单向向下流动，禁止循环依赖，通过 Cargo workspace + cargo-deny 在编译期与 CI 中强制保证。

依赖层次总览

┌─────────────────────────────────────────────────────────────────────┐
│  L5  应用层（Application）                                          │
│  dispatch-agent · forecast-agent · operation-agent                  │
│  self-healing-agent · planning-agent · trading-agent                │
│  market · report · dashboard · nl · edge                            │
├─────────────────────────────────────────────────────────────────────┤
│  L4  Agent 运行时（Agent Runtime）                                  │
│  eneros-agent · eneros-reasoning · eneros-memory                    │
│  eneros-tool · eneros-ai · eneros-twin · eneros-aiops               │
├─────────────────────────────────────────────────────────────────────┤
│  L3  电力原生内核（Power-Native Kernel）                            │
│  eneros-topology · eneros-powerflow · eneros-constraint             │
│  eneros-equipment · eneros-cnpower · eneros-timeseries              │
│  eneros-eventbus · eneros-analysis · eneros-emtp · eneros-simulator │
│  eneros-network · eneros-3d · eneros-bridge                        │
├─────────────────────────────────────────────────────────────────────┤
│  L2  实时安全网关（Safety Gateway）                                 │
│  eneros-gateway · eneros-trust · eneros-ids                         │
│  eneros-audit · eneros-compliance                                   │
├─────────────────────────────────────────────────────────────────────┤
│  L1  基础设施（Infrastructure）                                     │
│  eneros-os · eneros-multiregion · eneros-tenant                     │
│  eneros-scada · eneros-device · eneros-perf                         │
│  eneros-protocol-* · eneros-iot-hub · eneros-plugin                 │
│  eneros-sdk · eneros-runtime · eneros-api                           │
│  eneros-graphql · eneros-slo · eneros-ops                           │
│  eneros-i18n · eneros-test-utils · eneros-plugin-macros             │
├─────────────────────────────────────────────────────────────────────┤
│  L0  核心（Core）                                                   │
│  eneros-core · eneros-linalg                                        │
└─────────────────────────────────────────────────────────────────────┘

L0 - 核心层

核心层是所有 crate 的根基，提供统一类型、错误处理、配置与线性代数。

eneros-core 暴露的核心类型

// eneros-core/src/types.rs
pub struct Bus {
    pub id: u32,
    pub name: String,
    pub base_kv: f64,
    pub bus_type: BusType,
}

pub struct Branch {
    pub id: u32,
    pub from_bus: u32,
    pub to_bus: u32,
    pub resistance: f64,
    pub reactance: f64,
}

pub enum Command {
    SwitchToggle { switch_id: u32, closed: bool },
    GeneratorSetpoint { generator_id: u32, target_mw: f64 },
    TransformerTap { transformer_id: u32, tap: f64 },
    LoadShed { load_id: u32, amount_mw: f64 },
}

pub enum Event {
    FaultDetected { bus_id: u32, fault_type: FaultType },
    SwitchChanged { switch_id: u32, closed: bool },
    FrequencyDeviation { hz: f64 },
}

L1 - 基础设施层

基础设施层依赖 L0，提供 OS、设备、协议、网络等基础能力。

L2 - 实时安全网关层

实时安全网关层依赖 L0 + L1，提供安全、信任、审计、合规能力。

L3 - 电力原生内核层

电力原生内核层依赖 L0 + L1（部分依赖 L2 做约束校验），提供电网领域核心能力。

L4 - Agent 运行时层

Agent 运行时层依赖 L0 - L3，提供 Agent 生命周期、记忆、工具、推理能力。

L5 - 应用层

应用层依赖 L0 - L4，提供面向电力业务的具体场景应用。

核心依赖链

内核依赖链

eneros-core (L0 统一类型/错误/配置)
  │
  ├── eneros-linalg (L0 稀疏线性代数)
  │     │
  │     └── eneros-powerflow (L3 潮流计算)
  │           │     ↑ 依赖 eneros-topology
  │           ├── eneros-analysis (L3 状态估计/OPF/短路/DSA)
  │           │     ↑ 依赖 eneros-topology
  │           └── eneros-emtp (L3 电磁暂态仿真)
  │                 ↑ 依赖 eneros-topology
  │
  ├── eneros-topology (L3 电网拓扑)
  │     │
  │     ├── eneros-constraint (L3 安全约束)
  │     │     ↑ 依赖 eneros-powerflow
  │     ├── eneros-cnpower (L3 中国配网)
  │     │     ↑ 依赖 eneros-equipment
  │     ├── eneros-network (L3 CIM 网络模型)
  │     └── eneros-3d (L3 3D 可视化场景)
  │
  ├── eneros-equipment (L3 设备模型)
  │
  ├── eneros-timeseries (L3 时序存储)
  │     ↑ 依赖 eneros-perf
  │
  └── eneros-eventbus (L3 事件总线)

Agent 依赖链

eneros-agent (L4 Agent 运行时)
  │
  ├── eneros-memory (L4 记忆系统)
  │     ↑ 依赖 eneros-timeseries
  │
  ├── eneros-tool (L4 工具引擎)
  │     ↑ 依赖 eneros-topology, eneros-powerflow, eneros-constraint
  │
  ├── eneros-reasoning (L4 推理引擎)
  │     │
  │     └── eneros-ai (L4 AI/ML 集成)
  │
  ├── eneros-twin (L4 数字孪生)
  │     ↑ 依赖 eneros-topology, eneros-powerflow, eneros-timeseries
  │
  └── eneros-gateway (L2 安全网关)
        ↑ 依赖 eneros-constraint, eneros-device, eneros-perf

安全依赖链

eneros-gateway (L2 安全网关)
  │
  ├── eneros-constraint (L3 约束引擎)
  │
  ├── eneros-device (L1 设备管理)
  │
  └── eneros-perf (L1 性能优化)

eneros-trust (L2 零信任)
  │
  └── rustls + tokio-rustls

eneros-audit (L2 审计)
  │
  └── eneros-core

eneros-ids (L2 入侵检测)
  │
  └── eneros-audit

eneros-compliance (L2 合规)
  │
  └── eneros-audit

完整 Crate 索引表

下表列出全部 56 个 crate 及其层次、职责与直接依赖数量：

注：表中的”直接依赖数”统计 EnerOS workspace 内部 crate 依赖数量，不含第三方依赖。Agent 二进制（dispatch-agent / forecast-agent / operation-agent / self-healing-agent / planning-agent / trading-agent）由 eneros-agent crate 的 bins/ 子目录构建，不单独计数。

Crate 分组

按功能类别分组

按执行域分组

依赖规则

强制规则

Cargo Workspace 配置

# Cargo.toml (workspace 根)
[workspace]
resolver = "2"
members = [
    "crates/eneros-core",
    "crates/eneros-linalg",
    "crates/eneros-perf",
    "crates/eneros-audit",
    "crates/eneros-topology",
    "crates/eneros-powerflow",
    "crates/eneros-constraint",
    "crates/eneros-equipment",
    "crates/eneros-cnpower",
    "crates/eneros-timeseries",
    "crates/eneros-eventbus",
    "crates/eneros-eventbus/bins/broker",
    "crates/eneros-gateway",
    "crates/eneros-gateway/bins/gateway",
    "crates/eneros-device",
    "crates/eneros-api",
    "crates/eneros-runtime",
    "crates/eneros-bridge",
    "crates/eneros-network",
    "crates/eneros-memory",
    "crates/eneros-tenant",
    "crates/eneros-tool",
    "crates/eneros-reasoning",
    "crates/eneros-agent",
    "crates/eneros-agent/bins/dispatch-agent",
    "crates/eneros-agent/bins/forecast-agent",
    "crates/eneros-agent/bins/operation-agent",
    "crates/eneros-agent/bins/self-healing-agent",
    "crates/eneros-agent/bins/planning-agent",
    "crates/eneros-agent/bins/trading-agent",
    "crates/eneros-test-utils",
    "crates/eneros-scada",
    "crates/eneros-twin",
    "crates/eneros-graphql",
    "crates/eneros-ai",
    "crates/eneros-aiops",
    "crates/eneros-edge",
    "crates/eneros-protocol-iec103",
    "crates/eneros-protocol-cdt",
    "crates/eneros-protocol-pmu",
    "crates/eneros-protocol-iccp",
    "crates/eneros-analysis",
    "crates/eneros-dashboard",
    "crates/eneros-simulator",
    "crates/eneros-slo",
    "crates/eneros-plugin",
    "crates/eneros-plugin/bins/plugin-daemon",
    "crates/eneros-plugin-macros",
    "crates/eneros-sdk",
    "crates/eneros-sdk/bindings/c",
    "crates/eneros-sdk/bindings/python",
    "crates/eneros-ops",
    "crates/eneros-os",
    "crates/eneros-os/bins/eneros-init",
    "crates/eneros-os/bins/eneros-ha",
    "crates/eneros-os/bins/eneros-timesync",
    "crates/eneros-os/bins/enerosctl",
    "crates/eneros-os/bins/eneros-installer",
    "crates/eneros-os/bins/eneros-autoscaler",
    "crates/eneros-os/bins/eneros-backup",
    "crates/eneros-os/bins/eneros-oncall",
    "crates/eneros-os/bins/eneros-dr-orchestrator",
    "crates/eneros-os/bins/eneros-upgrader",
    "crates/eneros-market",
    "crates/eneros-market/bins/market-server",
    "crates/eneros-ids",
    "crates/eneros-compliance",
    "crates/eneros-trust",
    "crates/eneros-multiregion",
    "crates/eneros-emtp",
    "crates/eneros-protocol-mqtt",
    "crates/eneros-protocol-coap",
    "crates/eneros-protocol-lwm2m",
    "crates/eneros-protocol-dlt698",
    "crates/eneros-iot-hub",
    "crates/eneros-nl",
    "crates/eneros-3d",
    "crates/eneros-report",
    "crates/eneros-i18n",
    "os/tests",
    "tests/e2e",
    "tests/protocol_conformance",
    "tests/security",
    "benches",
]

[workspace.package]
version = "0.44.0"
edition = "2021"
authors = ["GAWG-AI"]
license = "MIT"
description = "EnerOS - Power-Native Agent Operating System"

[workspace.dependencies]
# Async runtime
tokio = { version = "1", features = ["full"] }
async-trait = "0.1"
futures = "0.3"

# Serialization
serde = { version = "1", features = ["derive"] }
serde_json = "1"
bincode = "1"

# Logging
tracing = "0.1"
tracing-subscriber = { version = "0.3", features = ["json", "env-filter"] }

# Error handling
thiserror = "1"
anyhow = "1"

# Data structures
dashmap = "5"
parking_lot = "0.12"
uuid = { version = "1", features = ["v4", "serde"] }
chrono = { version = "0.4", features = ["serde"] }

# Math/Science
ndarray = { version = "0.15", features = ["serde"] }
num-complex = { version = "0.4", features = ["serde"] }
sprs = "0.11"

# Security
jsonwebtoken = "9"
sha2 = "0.10"
hmac = "0.12"
aes-gcm = "0.10"
ed25519-dalek = { version = "2", features = ["rand_core"] }
zeroize = { version = "1", features = ["derive", "serde", "alloc"] }
libseccomp = "0.4"

# TLS
tokio-rustls = "0.26"
rustls = { version = "0.23", default-features = false, features = ["ring", "std"] }

# Internal crates (path dependencies)
eneros-core = { path = "crates/eneros-core" }
eneros-linalg = { path = "crates/eneros-linalg" }
eneros-topology = { path = "crates/eneros-topology" }
eneros-powerflow = { path = "crates/eneros-powerflow" }
# ... 其余内部 crate 同样以 path 声明

循环依赖检测

CI 流水线通过以下方式检测循环依赖：

# 1. cargo-deny 检查重复依赖与许可
cargo deny check

# 2. cargo-tree 检查依赖树
cargo tree -d  # 重复依赖
cargo tree --invert eneros-core  # 反向依赖

# 3. 自定义脚本检测循环
# scripts/check_cycles.sh

示例：eneros-gateway 的依赖声明

# crates/eneros-gateway/Cargo.toml
[package]
name = "eneros-gateway"
version.workspace = true
edition.workspace = true
authors.workspace = true
license.workspace = true
description = "EnerOS real-time safety gateway"

[dependencies]
# EnerOS 内部依赖（L0 + L1 + L3）
eneros-core = { workspace = true }
eneros-constraint = { workspace = true }
eneros-device = { workspace = true }
eneros-perf = { workspace = true }

# 第三方依赖
tokio = { workspace = true }
async-trait = { workspace = true }
serde = { workspace = true }
serde_json = { workspace = true }
tracing = { workspace = true }
thiserror = { workspace = true }
parking_lot = { workspace = true }
dashmap = { workspace = true }
crossbeam-skiplist = "0.1"
rayon = "1"

[dev-dependencies]
eneros-test-utils = { workspace = true }

可视化依赖图

以下是核心 crate 的依赖关系图（简化版，箭头表示”依赖于”）：

                    ┌──────────────┐
                    │ eneros-core  │
                    └──────┬───────┘
                           │
              ┌────────────┼────────────┐
              │            │            │
              ▼            ▼            ▼
       ┌──────────┐ ┌──────────┐ ┌──────────┐
       │ linalg   │ │ perf     │ │ audit    │
       └────┬─────┘ └────┬─────┘ └────┬─────┘
            │            │            │
            ▼            │            ▼
       ┌──────────┐      │     ┌──────────┐
       │topology  │      │     │  ids     │
       └────┬─────┘      │     └──────────┘
            │            │
            ▼            │
       ┌──────────┐      │
       │powerflow │◄─────┘
       └────┬─────┘
            │
            ▼
       ┌──────────┐
       │constraint│
       └────┬─────┘
            │
            ▼
       ┌──────────┐
       │ gateway  │
       └────┬─────┘
            │
            ▼
       ┌──────────┐
       │  agent   │
       └──────────┘

版本管理

语义化版本

EnerOS 遵循语义化版本 2.0.0：

内部 crate 版本

所有内部 crate 使用 workspace 统一版本（version.workspace = true），与主版本保持一致。

相关文档

• 项目结构 - 目录结构说明
• Crate 索引 - 完整 crate 列表
• 分层架构 - 五层架构详解
• 双执行架构 - 双执行域详解