# superAgent

**Repository Path**: ooderCN/super-agent

## Basic Information

- **Project Name**: superAgent
- **Description**: SuperAgent是一套基于MIT协议的开源企业级自动化协作框架，它通过创新的Agent架构和SKILL管理机制，为企业提供了从简单任务到复杂流程的全场景自动化解决方案。开源协议文档
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 5
- **Forks**: 2
- **Created**: 2026-01-15
- **Last Updated**: 2026-01-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ooder SuperAgent - 企业级AI能力分发与自动化协作框架

## 项目概述

ooder SuperAgent 是一套基于 MIT 协议的开源企业级 AI 能力分发与自动化协作框架，它通过创新的 Agent 架构和 SKILL 管理机制，为企业提供了从简单任务到复杂流程的全场景自动化解决方案。

本项目作为 ooderAI 开源生态的核心组件，实现了基于场景化协作架构的数据流转系统，展示了 SuperAgent 平台的核心设计理念和技术实现。系统由三个核心服务（SKILL A、B、C）组成，通过标准化协议实现服务发现、数据流转和协同工作。

最新更新 (v0.6.3)：
- **A2UI (AI to UI) 集成**：增强了图生代码功能，支持多格式和多主题
- **南向协议统一**：统一了南向协议格式，集成了 LLM 分册
- **VFS 增强**：添加了事务约束和全局地址列表，优化了文件同步机制
- **命令体系完善**：添加了 A2UI 相关命令，优化了命令执行流程
- **Token 优化**：减少了 Token 消耗，提高了系统效率
- **术语标准化**：统一使用"南向协议"和"北向协议"术语
- **mcpAgent 增强**：Agent SDK v0.6.3 全面升级，提供完整的南向协议实现框架

## 项目生态

ooder SuperAgent 包含以下核心组件：

1. **核心服务**：
   - skill-a：数据获取服务
   - skill-b：数据提交服务
   - skill-c：协调服务

2. **技能包**：
   - trae-solo-standard：标准 Skills 实现，专为 trae-solo IDE 设计
   - skills-a2ui：A2UI 图转代码服务

3. **工具链**：
   - ES6 模块系统：现代化 JavaScript 开发体验
   - VFS 工具：虚拟文件系统管理
   - A2UI 工具：AI 辅助 UI 生成

## 核心设计理念

基于 [ooderAI Agent 管理平台设计](https://cloud.tencent.com/developer/article/2619515)，SuperAgent 采用以下核心设计理念：

- **MCPAgent 分发网络**：企业/第三方系统可以将自己的 MCPAgent 接入 AIServer，将 AI 能力通过 SuperAgent 分发；个人用户拥有专属 MCPAgent，整合个人 AI 工具
- **AI 能力标准化**：定义统一的 AI 能力接口规范，支持 1:n Capability 关系，实现 AI 能力的模块化设计
- **跨域自动化编排**：通过 Skillflow 可视化工具，实现跨企业/个人 MCPAgent 的工作流编排
- **安全可靠的设计**：基于 RBAC 的权限管理，支持多种部署方式，确保系统安全可靠

## 核心协议体系

ooder SuperAgent 围绕两大核心协议构建完整的协作生态：

### 1. AIbridge 协议

AIbridge 协议定义了 MCPAgent 与 AIServer 之间的通信规范，采用 TCP/HTTP 协议确保通信的可靠性和安全性。该协议包含：

- **命令参数规范**：标准化的命令格式和参数定义
- **协议完整性说明**：确保数据传输的完整性和一致性
- **安全机制增强**：基于 HMAC-SHA256 的认证机制，确保通信安全
- **技术实现细节**：详细的协议实现指南和最佳实践

### 2. A2A 协议（Scene/Group 机制）

A2A 协议定义了 Agent 之间的协作规范，通过 Scene 和 Group 机制实现多 Agent 协同工作：

- **Scene（场景）**：协作上下文环境，定义了协作的业务场景和规则
- **Group（组）**：协作团队，由多个 Agent 组成，共同完成特定任务
- **自主加入机制**：Agent 可以通过 UDP 广播自动发现并加入相关场景
- **命令协同机制**：基于场景的命令分发和执行协同

## 最新技术更新

### VFS (Virtual File System) 更新

- **增强的文件同步机制**：优化了 VFS 与本地文件系统的同步流程，提高了文件传输速度和可靠性
- **完整的文件管理功能**：支持文件上传、下载、删除、重命名等操作
- **文件监控**：实时监控文件变化，自动触发同步
- **错误处理**：改进了错误处理机制，提供更详细的错误信息

### SDK 更新

- **ES6 模块支持**：集成了完整的 ES6 模块系统，支持现代 JavaScript 语法
- **Tree Shaking 优化**：针对现代打包工具（Webpack、Rollup）进行了优化，减少了打包体积
- **TypeScript 类型定义**：提供了完整的 TypeScript 类型定义，提升开发体验
- **向后兼容性**：保持与遗留 `ood.Class` 系统的完全兼容，支持渐进式迁移
- **构建系统优化**：使用 Webpack 4 构建，提供开发和生产版本

### A2UI (AI to UI) 更新

- **增强的图转代码能力**：优化了 AI 模型，提高了代码生成的准确性和质量
- **多格式支持**：支持 HTML、JavaScript、JSON 等多种输出格式
- **多主题支持**：内置 Light、Dark、Purple 三种主题，可根据需求自定义
- **组件库扩展**：增加了更多 UI 组件，包括 Button、Input、Dialog、TreeGrid、Tabs 等 60+ 组件
- **响应式设计**：生成的代码支持响应式布局，适配不同设备尺寸

### trae-solo 集成与增强

- **标准 Skills 实现**：完全按照 Skills 标准规范实现，支持分级加载机制
- **Web API 调用**：通过 HTTP API 调用服务，减少 Token 消耗
- **无缝集成**：专为 trae-solo IDE 优化，提供友好的用户体验
- **功能丰富**：支持基本实用功能（问候、计算、时间获取等）和 A2UI 图转代码功能
- **完整协作流程**：实现了 SKILL A、B、C 三个核心服务的完整协作流程
- **性能优化**：减少了初始化时间、Token 消耗和内存占用
- **多格式支持**：支持 HTML、JavaScript、JSON 等多种输出格式
- **多主题支持**：支持 Light、Dark、Purple 三种主题

### mcpAgent 增强

- **Agent SDK v0.6.3 全面升级**：提供完整的南向协议实现框架
- **核心功能增强**：增强了 Agent 生命周期管理、命令发送与接收、网络链路管理等
- **高级功能支持**：提供命令队列与超时处理、网络拓扑管理、LLM 交互管理
- **框架集成**：完善了与 Spring Boot 等框架的集成支持
- **性能优化**：提供了详细的性能优化建议和最佳实践

## 测试代码设计范围

本次测试代码实现了 SuperAgent 核心功能的验证，覆盖以下关键场景：

1. **入网测试**：Agent 接入网络并完成服务注册
2. **命令测试**：验证命令的发送、接收和执行
3. **场景测试**：创建和管理协作场景
4. **加入组测试**：Agent 加入协作组并参与协同工作

系统通过三个核心服务（SKILL A、B、C）演示完整的协作流程：
- **SKILL A**：数据获取服务，负责从数据源获取原始数据
- **SKILL B**：数据提交服务，负责将处理后的数据提交到目标系统
- **SKILL C**：协调服务，负责场景管理和任务协同

## 系统架构

ooder SuperAgent 企业总体结构由六大核心组件构成：

1. **Auth 认证中心**：提供统一的身份认证和授权服务
2. **DataServer 数据中心**：统一管理企业数据
3. **Skill 能力管理中心**：统一管理 SKILL 的注册、分类、发现和调用
4. **LLM 调度中心**：统一管理 LLM 资源，实现 LLM 的高效调度和管控
5. **Skillflow 调度中心**：实现跨域自动化编排
6. **Agent 协作层**：实现 Agent 之间的协同工作

本次测试代码实现了 Agent 协作层的核心功能，展示了 Scene 和 Group 机制的实际应用。

## 快速开始

### 环境要求

- JDK 1.8+
- Maven 3.6+
- Spring Boot 2.7.0

### 快速运行测试用例

#### 1. 编译项目

```bash
# 编译所有模块
mvn clean compile
```

#### 2. 启动服务

按顺序启动三个 SKILL 服务：

```bash
# 启动 Skill A (端口 9000)
cd skill-a
mvn spring-boot:run

# 启动 Skill B (端口 9001)
cd ../skill-b
mvn spring-boot:run

# 启动 Skill C (端口 9010)
cd ../skill-c
mvn spring-boot:run
```

#### 3. 执行测试

```bash
# 使用 curl 测试完整数据流转流程
curl -X POST http://localhost:9010/api/v1/coordinate -H "Content-Type: application/json" -d '{"sceneId":"RBC_SCENE_001"}'
```

#### 4. 查看测试结果

检查三个服务的日志，确认数据流转是否成功完成：
- Skill A 日志：数据获取成功
- Skill B 日志：数据提交成功
- Skill C 日志：数据流转协调成功

## 项目结构

```
super-agent/
├── skill-a/                      # 数据获取服务
│   ├── src/                      # 源代码
│   └── pom.xml                   # Maven 配置
├── skill-b/                      # 数据提交服务
│   ├── src/                      # 源代码
│   └── pom.xml                   # Maven 配置
├── skill-c/                      # 协调服务
│   ├── src/                      # 源代码
│   └── pom.xml                   # Maven 配置
├── trae-solo-standard/           # 标准 Skills 实现
│   ├── skills/                   # 技能目录
│   │   ├── trae-solo/            # 主技能
│   │   └── a2ui/                 # A2UI 技能
│   └── README.md                 # 说明文档
├── skills-a2ui/                  # A2UI 图转代码服务
│   ├── src/                      # 源代码
│   ├── docs/                     # 文档
│   └── pom.xml                   # Maven 配置
├── protocol-release/             # 协议发布目录
│   └── v0.6.3/                   # 0.6.3 版本协议文档
│       ├── agent/                # Agent 协议文档
│       ├── ai-bridge/            # AI Bridge 协议文档
│       ├── general/              # 通用文档
│       ├── guide/                # 指南文档
│       ├── main/                 # 主协议文档
│       ├── sdk/                  # SDK 文档
│       ├── skill/                # Skill 协议文档
│       ├── skill-implementation/ # Skill 实现文档
│       └── skill-spec/           # Skill 规范文档
├── docs/                         # 文档目录
│   ├── architecture/             # 架构文档
│   ├── communication/            # 通信文档
│   ├── components/               # 组件文档
│   ├── deployment/               # 部署文档
│   ├── faq/                      # 常见问题
│   ├── overview/                 # 概览文档
│   ├── reference/                # 参考文档
│   ├── security/                 # 安全文档
│   └── skills/                   # 技能文档
├── command-system-list.md        # 命令系统列表
├── ooderAgent-SDD实践解析.md      # SDD实践解析
├── ooderai-agent-quickstart-guide.md # 快速上手指南
├── SDK-集成说明.md                # SDK集成说明
└── README.md                      # 项目说明文档
```

## 测试用例说明

### 核心测试用例

| 测试用例 | 描述 | 执行方式 |
|---------|------|----------|
| 服务启动测试 | 验证三个 SKILL 服务的正常启动和初始化 | 依次启动三个服务 |
| 场景加入测试 | 验证基于 UDP 广播的自主场景加入机制 | 启动服务后观察日志 |
| 数据流转测试 | 验证完整数据流转流程 | 执行 curl 命令测试 |
| 离线功能测试 | 验证系统在离线场景下的功能表现 | 停止某个服务后测试 |

### 测试报告

- **rpa-skills-test-summary.md**：完整的测试总结报告
- **test-vs-protocol-differences.md**：测试与协议差异对比

## AI-IDE 一键构建

### VS Code 配置

在项目根目录创建 `.vscode/launch.json` 文件：

```json
{
  "version": "0.2.0",
  "configurations": [
    {
      "type": "java",
      "name": "Skill A",
      "request": "launch",
      "mainClass": "net.ooder.examples.skilla.RpaSkillApplication",
      "projectName": "skill-a"
    },
    {
      "type": "java",
      "name": "Skill B",
      "request": "launch",
      "mainClass": "net.ooder.examples.skillb.RpaSkillApplication",
      "projectName": "skill-b"
    },
    {
      "type": "java",
      "name": "Skill C",
      "request": "launch",
      "mainClass": "net.ooder.examples.skillc.RpaSkillApplication",
      "projectName": "skill-c"
    }
  ]
}
```

### IntelliJ IDEA 配置

1. 打开项目根目录
2. 配置三个 Spring Boot 运行配置
3. 设置正确的主类和工作目录
4. 使用一键运行功能启动所有服务

## 协议文档

### v0.6.3 协议文档

ooder SuperAgent v0.6.3 提供了完整的协议文档体系，详细说明请参考 `protocol-release/v0.6.3` 目录：

- **main/protocol-main.md**：Ooder AI Bridge 协议主文档
- **ai-bridge/ai-bridge-protocol.md**：AI Bridge 协议分册
- **agent/agent-protocol.md**：Agent 协议分册
- **skill/skill-protocol.md**：Skill 协议分册
- **skill/skill-vfs-protocol.md**：Skill VFS 专用协议分册
- **sdk/SDK-集成说明.md**：SDK 集成说明
- **sdk/SDK-Usage-Guide.md**：SDK 使用指南
- **guide/ooderai-agent-quickstart-guide.md**：ooderAI Agent 快速上手指南
- **general/protocol-overview.md**：协议概述
- **general/protocol-statement.md**：协议声明

### 核心协议体系

v0.6.3 版本围绕两大核心协议构建完整的协作生态：

1. **北向协议（AI Bridge 协议）**：以 mcpAgent 为中心，向云服务（包括公云、私有云、混合云）通信的协议统称
2. **南向协议**：mcpAgent 向下与其他组件通信的协议统称

### UDP 通信规范

系统采用 UDP 广播实现服务发现，详情请参考协议文档中的相关部分。

## 开发指南

### 代码结构

每个 SKILL 服务采用标准的 Spring Boot 项目结构：

```
skill-x/
├── src/
│   ├── main/java/net/ooder/examples/skillx/
│   │   ├── config/     # 配置类
│   │   ├── controller/ # 控制器
│   │   ├── model/      # 数据模型
│   │   ├── service/    # 服务层
│   │   └── RpaSkillApplication.java # 主类
│   └── resources/      # 配置文件
└── pom.xml             # Maven 配置
```

### 错误码体系

系统采用 1000-5999 范围的错误码：

| 错误码 | 描述 |
|-------|------|
| 1001 | Scene 不存在 |
| 1002 | Scene 已存在 |
| 1003 | Group 不存在 |
| 1004 | Group 已存在 |
| 1005 | Agent 不存在 |
| 1006 | Agent 已在 Scene 中 |
| 1007 | Agent 已在 Group 中 |

## 联系方式

- Gitee 项目地址：`https://gitee.com/ooderCN/super-agent.git`

## 更新说明

### 最新更新（2026-01-23 - v0.6.3）

- **A2UI (AI to UI) 集成**：
  - 增强了图生代码功能，支持多格式和多主题
  - 优化了 AI 模型，提高了代码生成的准确性和质量
  - 支持 HTML、JavaScript、JSON 等多种输出格式
  - 内置 Light、Dark、Purple 三种主题，可根据需求自定义
  - 增加了更多 UI 组件，包括 Button、Input、Dialog、TreeGrid、Tabs 等 60+ 组件
  - 生成的代码支持响应式布局，适配不同设备尺寸

- **南向协议统一**：
  - 统一了南向协议格式，集成了 LLM 分册
  - 增强了协议的灵活性和可扩展性
  - 优化了命令执行流程，提高了系统效率

- **VFS 增强**：
  - 添加了事务约束和全局地址列表，确保数据的完整性和一致性
  - 优化了文件同步机制，提高了文件传输速度和可靠性
  - 支持完整的文件管理功能，包括上传、下载、删除、重命名等操作
  - 实现了文件监控功能，实时监控文件变化并自动触发同步
  - 改进了错误处理机制，提供更详细的错误信息

- **命令体系完善**：
  - 添加了 A2UI 相关命令，优化了命令执行流程
  - 统一了命令格式，提高了系统的一致性
  - 增强了命令的错误处理能力，提高了系统的可靠性

- **Token 优化**：
  - 减少了 Token 消耗，提高了系统效率
  - 优化了 Token 管理机制，确保系统的稳定性

- **术语标准化**：
  - 统一使用"南向协议"和"北向协议"术语
  - 确保了文档中术语的一致性和准确性
  - 提升了文档的专业性和可读性

- **trae-solo Skill 增强**：
  - 引入了 Trae Solo Standard Skills 规范，完全按照 Skills 标准规范实现
  - 实现了分级加载机制（1级元数据、2级文档、3级脚本），节省 Token 消耗
  - 通过 Web API 调用服务，提高执行效率，支持更复杂的功能
  - 专为 trae-solo IDE 优化，提供无缝的技能调用体验
  - 支持基本实用功能（问候、计算、时间获取等）和 A2UI 图转代码功能
  - 实现了完整的协作流程演示（SKILL A、B、C），展示了标准 Skills 的协同工作能力
  - 提供了详细的功能列表和使用方法，便于开发者快速上手
  - 优化了性能，减少了初始化时间、Token 消耗和内存占用
  - 支持多格式输出（HTML、JavaScript、JSON）和多主题（Light、Dark、Purple）

- **mcpAgent 增强**：
  - Agent SDK v0.6.3 全面升级，提供完整的南向协议实现框架
  - 增强了 Agent 生命周期管理、命令发送与接收、网络链路管理等核心功能
  - 优化了网络状态监控和错误处理机制
  - 提供了更丰富的高级功能，如命令队列与超时处理、网络拓扑管理、LLM 交互管理
  - 完善了与 Spring Boot 等框架的集成支持
  - 提供了详细的性能优化建议和最佳实践

### 后续规划

- 测试用例覆盖度提升
- 性能优化和稳定性增强
- 安全机制完善
- 文档更新和完善
- 更多 AI 能力的集成和扩展