Hyde
/
openmanus.cpp
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
openmanus.cpp/README.md

5.4 KiB
Raw Permalink Blame History

OpenManus C++版本

这是OpenManus项目的C++实现版本，旨在提供与原始Python版本相同的功能。

项目结构

cpp/
├── include/            # 头文件目录
│   ├── agent_base.h    # 代理基类
│   ├── manus.h         # Manus代理
│   ├── tool_base.h     # 工具基类
│   ├── tool_call.h     # 工具调用类
│   ├── tool_call_agent.h # 工具调用代理
│   ├── tool_collection.h # 工具集合类
│   ├── flow/           # 流程头文件目录
│   │   ├── base_flow.h # 流程基类
│   │   ├── planning_flow.h # 规划流程
│   │   └── flow_factory.h # 流程工厂
│   └── tools/          # 工具头文件目录
│       └── terminate.h # 终止工具
├── src/                # 源文件目录
│   ├── agent_base.cpp  # 代理基类实现
│   ├── manus.cpp       # Manus代理实现
│   ├── tool_base.cpp   # 工具基类实现
│   ├── tool_call.cpp   # 工具调用类实现
│   ├── tool_call_agent.cpp # 工具调用代理实现
│   ├── tool_collection.cpp # 工具集合类实现
│   ├── flow/           # 流程实现目录
│   │   ├── base_flow.cpp # 流程基类实现
│   │   ├── planning_flow.cpp # 规划流程实现
│   │   └── flow_factory.cpp # 流程工厂实现
│   └── tools/          # 工具实现目录
│       └── terminate.cpp # 终止工具实现
├── server/             # MCP服务器目录
│   ├── mcp_server_main.cpp # MCP服务器主程序
│   └── CMakeLists.txt  # 服务器构建文件
├── main.cpp            # 主程序入口
├── mcp/                # MCP协议库
└── CMakeLists.txt      # CMake构建文件

已完成工作

  1. 基础框架搭建

    • 创建了基本的项目结构和CMakeLists.txt文件
    • 实现了基础代理类(AgentBase)
    • 实现了工具集合类(ToolCollection)
    • 实现了工具基类(ToolBase)
    • 实现了工具调用类(ToolCall)
    • 实现了工具调用代理类(ToolCallAgent)
    • 实现了Manus代理类

  2. 流程层实现

    • 实现了流程基类(BaseFlow)
    • 实现了规划流程(PlanningFlow)
    • 实现了流程工厂(FlowFactory)
    • 修改了主程序，使用流程层执行任务

  3. 工具实现

    • 实现了终止工具(Terminate)，用于终止代理执行
    • 实现了Python执行工具(PythonExecute)，可以执行Python代码

  4. MCP服务器

    • 实现了基本的MCP服务器
    • 实现了PythonExecute工具，可以执行Python代码

  5. LLM集成

    • 使用httplib.h实现了与LLM API的通信
    • 实现了think方法，能够调用LLM API获取下一步行动
    • 实现了工具调用的解析和执行
    • 添加了Authorization头部，支持API密钥认证

  6. 配置系统

    • 实现了TOML格式的配置文件读取
    • 支持从配置文件中读取LLM API、工具和代理等参数
    • 支持在运行时指定配置文件路径

  7. 编译与运行

    • 成功编译并运行了基本框架
    • 解决了与MCP协议库的集成问题

未完成工作

  1. 工具实现

    • Google搜索工具(GoogleSearch)
    • 浏览器使用工具(BrowserUseTool)
    • 文件保存工具(FileSaver)
    • 其他工具...

  2. LLM集成完善

    • 添加更多的LLM模型支持
    • 实现流式响应处理
    • 添加更多的提示模板

  3. MCP协议完整集成

    • 完善客户端与MCP服务器的通信
    • 实现完整的请求-响应流程

  4. 错误处理与日志

    • 添加更完善的错误处理机制
    • 实现日志记录功能

  5. 测试与文档

    • 编写单元测试
    • 编写集成测试
    • 完善API文档

配置文件

OpenManus使用TOML格式的配置文件来配置LLM API、工具和代理等参数。默认配置文件为config.toml，位于可执行文件所在目录。

配置文件示例

# OpenManus配置文件

[llm]
# LLM API主机
host = "localhost"
# LLM API端口
port = 8000
# LLM API路径
path = "/chat/completions"
# LLM API密钥
api_key = "your_api_key_here"
# LLM模型名称
model = "gpt-3.5-turbo"
# 是否启用流式响应
stream = false

[tools]
# 是否启用Python执行工具
enable_python_execute = true
# 是否启用Google搜索工具
enable_google_search = false
# 是否启用浏览器使用工具
enable_browser_use = false
# 是否启用文件保存工具
enable_file_saver = false

[agent]
# 最大步骤数
max_steps = 30
# 系统提示
system_prompt = "你是Manus，一个通用的智能助手，可以使用多种工具解决各种任务。"
# 下一步提示
next_step_prompt = "请思考下一步行动，使用可用的工具来解决用户的问题。"

运行时指定配置文件

可以在运行时通过命令行参数指定配置文件路径：

./openmanus_cpp /path/to/your/config.toml

构建与运行

构建主程序

cd cpp
mkdir -p build
cd build
cmake ..
make

运行主程序

./openmanus_cpp

构建MCP服务器

cd cpp/server
mkdir -p build
cd build
cmake ..
make

运行MCP服务器

./openmanus_mcp_server

依赖

  • C++17
  • CMake 3.10+
  • nlohmann/json (包含在mcp/common目录中)
  • httplib.h (包含在项目中)
  • Python 3 (用于PythonExecute工具)
  • LLM API服务 (如OpenAI API或本地部署的LLM服务)

许可证

与原始OpenManus项目相同的许可证。