204 lines
5.4 KiB
Markdown
204 lines
5.4 KiB
Markdown
|
# 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`，位于可执行文件所在目录。
|
|||
|
|
|
|||
|
|
### 配置文件示例
|
|||
|
|
|
|||
|
|
```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 = "请思考下一步行动，使用可用的工具来解决用户的问题。"
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 运行时指定配置文件
|
|||
|
|
|
|||
|
|
可以在运行时通过命令行参数指定配置文件路径：
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
./openmanus_cpp /path/to/your/config.toml
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 构建与运行
|
|||
|
|
|
|||
|
|
### 构建主程序
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
cd cpp
|
|||
|
|
mkdir -p build
|
|||
|
|
cd build
|
|||
|
|
cmake ..
|
|||
|
|
make
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 运行主程序
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
./openmanus_cpp
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 构建MCP服务器
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
cd cpp/server
|
|||
|
|
mkdir -p build
|
|||
|
|
cd build
|
|||
|
|
cmake ..
|
|||
|
|
make
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 运行MCP服务器
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
./openmanus_mcp_server
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 依赖
|
|||
|
|
|
|||
|
|
- C++17
|
|||
|
|
- CMake 3.10+
|
|||
|
|
- nlohmann/json (包含在mcp/common目录中)
|
|||
|
|
- httplib.h (包含在项目中)
|
|||
|
|
- Python 3 (用于PythonExecute工具)
|
|||
|
|
- LLM API服务 (如OpenAI API或本地部署的LLM服务)
|
|||
|
|
|
|||
|
|
## 许可证
|
|||
|
|
|
|||
|
|
与原始OpenManus项目相同的许可证。
|