附录 A：octos 完整 Crate 依赖图

本附录以当前 ../octos main 分支的 Cargo.toml 为准。图中展开 11 个 octos-* 核心 crate；app-skills 与 platform-skills 也是 workspace 成员，但它们是能力二进制程序，依赖形态更接近外部工具，故不展开到核心库依赖图中。

需要注意：最新 agent/goal/loop/coding autonomy 相关实现主要落在 octos-cli 的 API runtime 模块（如 agent_orchestrator.rs、goal_loop_runtime.rs、master_continuation_scheduler.rs、supervisor_store.rs）和 octos-agent 的工具/TaskSupervisor 层，并没有新增独立 octos-autonomy crate。因此 crate 图不会因为这些能力出现新节点；它们是现有 octos-cli -> octos-agent -> octos-core 依赖链上的运行时模块。

内部 Crate 依赖拓扑

graph BT
    subgraph "独立基础设施"
        core["octos-core"]
        plugin["octos-plugin"]
        sandbox["octos-sandbox"]
    end

    subgraph "领域服务"
        llm["octos-llm"]
        memory["octos-memory"]
        bus["octos-bus"]
    end

    subgraph "运行时引擎"
        agent["octos-agent"]
        pipeline["octos-pipeline"]
        swarm["octos-swarm"]
        dora["octos-dora-mcp"]
    end

    subgraph "用户入口"
        cli["octos-cli"]
    end

    llm --> core
    memory --> core
    bus --> core

    agent --> core
    agent --> bus
    agent --> memory
    agent --> llm
    agent --> plugin

    pipeline --> core
    pipeline --> agent
    pipeline --> llm
    pipeline --> memory

    swarm --> agent
    dora --> agent

    cli --> core
    cli --> agent
    cli --> memory
    cli --> llm
    cli --> bus
    cli --> pipeline
    cli --> swarm

箭头方向为"依赖于"。例如 cli --> agent 表示 octos-cli 的 Cargo.toml 依赖 octos-agent。octos-sandbox 是 Windows AppContainer 辅助 crate，当前不被其他核心 crate 直接依赖。

各 Crate 关键外部依赖

Crate关键依赖版本用途
octos-coreserde, serde_json, chrono, uuid, eyre1.x, 1.x, 0.4, 1.x, 0.6序列化、时间、ID、错误
octos-llmreqwest, async-trait, futures, secrecy, redb, metrics0.12, 0.1, 0.3, 0.10, 2.x, 0.24HTTP、异步 trait、流式、密钥、凭据池状态、指标
octos-memoryredb, hnsw_rs, bincode, tokio, uuid2.x, 0.3, 1.x, 1.x, 1.x嵌入式 DB、向量搜索、序列化、异步、ID
octos-bustokio, lru, cron, subtle, aes/cbc, teloxide*, serenity*, axum*1.x, 0.16, 0.15, 2.x, 0.8/0.1, 0.17, 0.12, 0.8异步、缓存、定时、常量时间比较、加密、频道/API 集成
octos-agenttokio, async-trait, reqwest, chromiumoxide, gix*, tree-sitter*1.x, 0.1, 0.12, 0.9, 0.79, 0.24Agent 异步运行、工具 HTTP、浏览器自动化、Git/AST feature
octos-pipelineasync-trait, tokio, futures, regex, glob0.1, 1.x, 0.3, 1.x, 0.3Handler 抽象、异步执行、并发、模式匹配、文件匹配
octos-swarmasync-trait, redb, uuid, metrics, tokio0.1, 2.x, 1.x, 0.24, 1.x子 Agent 编排、持久化、ID、指标、异步
octos-dora-mcpasync-trait, tokio, serde, serde_json, eyre0.1, 1.x, 1.x, 1.x, 0.6Dora/MCP 工具桥接、异步、序列化、错误
octos-cliclap, rustyline, axum*, tower-http*, rust-embed*, keyring, metrics-exporter-prometheus*4.x, 15.x, 0.8, 0.6, 8.x, 3.x, 0.16CLI、交互输入、Web/API、静态资源、系统凭据、Prometheus
octos-pluginserde, serde_json, eyre, which, tokio, metrics1.x, 1.x, 0.6, 7.x, 1.x, 0.24Manifest、错误、可执行文件发现、异步、指标
octos-sandboxclap, eyre, rappct**, windows**4.x, 0.6, 0.13, 0.62CLI、错误、Windows AppContainer

* 表示 feature-gated 依赖；** 表示仅在 Windows target 下启用。

Workspace 共享依赖

以下依赖在 [workspace.dependencies] 中统一定义，所有引用 workspace 依赖的 crate 使用相同版本：

  • tokio 1.x（full features）：异步运行时
  • serde 1.x（derive）/ serde_json 1.x：序列化框架
  • eyre 0.6 / color-eyre 0.6：错误处理
  • tracing 0.1 / tracing-subscriber 0.3：结构化日志
  • reqwest 0.12（rustls-tls）：HTTP 客户端（纯 Rust TLS）
  • redb 2.x：嵌入式持久化
  • axum 0.8 / tower-http 0.6：可选 Web/API 入口