OoderAgent AI 能力分发与自动化协作框架白皮书（V0.7.3 ）

1. 概述

OoderAgent 是一套基于 MIT 协议的开源企业级 AI 能力分发与自动化协作框架。采用 P2P 网络架构，支持多 Agent 协作、Skill 模块化能力封装和场景化编排。

🌐 去中心化

P2P 网络架构，无单点故障，自动节点发现和故障恢复

🎯 场景驱动

基于场景的能力编排和协作，支持复杂业务流程自动化

🔌 能力复用

模块化 Skill 封装，即插即用，支持多语言运行时

☁️ 云原生

支持 Kubernetes 集群部署，自动伸缩和高可用

2. 产品矩阵

OoderAgent 2.2 提供完整的产品矩阵，覆盖个人开发者到企业级应用场景。

产品	定位	目标用户	部署方式
ooder-sdk	SDK 核心	开发者	Maven 依赖
ooder-Nexus	分发枢纽（个人版）	个人开发者	本地/边缘设备
ooder-Nexus-Enterprise	分发枢纽（企业版）	企业用户	私有云/K8s
agent-skillcenter	能力中心	运维人员	独立部署
ooder-skills	能力库	所有用户	GitHub/Gitee

3. 核心架构

3.1 一核两翼三链架构

应用层用户应用组织管理技能市场协作平台三链引擎层SkillsFlow数据中心数据工具链飞轮能力中心层能力规范能力分发能力管理能力监测能力协同北向服务层域管理协议立体观测P2P 网络域级安全云托管协议南向服务层发现协议登录协议角色协议协作协议离线服务核心抽象层（一核）核心网络抽象核心安全抽象核心协作抽象应用三链能力两翼一核

3.2 三层 Agent 架构

Agent 类型	职责	说明
MCP Agent	主控节点	AI 能力分发和管理，网络协调和安全认证
Route Agent	路由节点	命令路由和任务协调，动态拓扑和负载均衡
End Agent	终端节点	数据采集、处理和执行，本地优先执行

4. 技术特性

🌐 P2P 分布式架构

去中心化网络，支持 UDP 广播、DHT、mDNS、GitHub/Gitee 等多种发现方式

🔧 技能模块化

完整的技能生命周期管理，支持注册、部署、执行、监控、下线

📊 场景驱动设计

场景定义、成员管理、状态管理、快照恢复，支持多 Agent 协同

☁️ 云原生支持

Kubernetes 集成，支持 Deployment、Service、Ingress、HPA 自动伸缩

🔒 安全认证

本地认证协议、密钥对管理、端到端加密、访问控制、安全审计

🔌 多语言运行时

支持 Java、Node.js、Python 等多种运行时执行器

5. 协议体系

南向协议DiscoveryProtocolLoginProtocolRoleProtocolCollaborationProtocolAgent 发现 · 用户认证 · 角色决策 · 任务协同北向协议DomainManagementObservationProtocolCloudHostingProtocol域管理 · 立体观测 · 云托管SDK

6. 部署方案

本地部署JDK 8+ · Maven 3.6+内存 512MB+java -jar nexus.jarDocker 部署Docker Engine 20+镜像 ooder/nexus:2.2docker run -p 8080:8080Kubernetes 部署K8s 1.20+Helm Chart / YAMLkubectl apply -f nexus.yaml高可用部署架构Load BalancerNexus Pod 18080Nexus Pod 28080Nexus Pod 38080DatabaseMySQL / PostgreSQL

7. 开发指南

7.1 快速开始

添加 Maven 依赖：

复制代码

<dependency>
    <groupId>net.ooder</groupId>
    <artifactId>agent-sdk</artifactId>
    <version>0.7.3</version>
</dependency>

7.2 创建 Agent

复制代码

import net.ooder.sdk.OoderSDK;
import net.ooder.sdk.infra.config.SDKConfiguration;

public class MyAgent {
    public static void main(String[] args) {
        SDKConfiguration config = new SDKConfiguration();
        config.setAgentId("my-agent-001");
        config.setAgentName("My Agent");

        OoderSDK sdk = OoderSDK.builder()
            .configuration(config)
            .build();

        sdk.initialize();
        sdk.start();
    }
}

7.3 开发技能

复制代码

import net.ooder.annotation.Agent;
import net.ooder.annotation.Skill;

@Agent(id = "data-agent", name = "Data Processing Agent")
public class DataAgent {

    @Skill(id = "data-extract", name = "数据提取")
    public ExtractResult extract(ExtractRequest request) {
        return new ExtractResult();
    }
}

8. 生态规划

仓库	说明	地址
super-Agent	核心框架	github.com/oodercn/super-Agent
ooder-sdk	SDK 核心	github.com/oodercn/ooder-sdk
ooder-skills	能力库	github.com/oodercn/ooder-skills

版本规划

版本	计划日期	主要特性
2.2	2026-02-22	SDK 统一、云托管增强
2.3	2026-03	AI 桥接协议、多模型支持
3.0	2026-Q2	分布式计算引擎、流式处理

GitHub · Gitee

Made with ❤️ by Ooder Team