一、项目基本信息
1.1 背景信息
OpenManus 是基于大语言模型（LLM）构建的智能体框架，致力于打造灵活、可扩展且功能强大的系统，助力 AI 借助各类工具与外界交互，攻克复杂任务。它与传统聊天机器人大相径庭，不局限于文本理解与生成，还具备强大实操技能。既能快速精准搜索信息，又能流畅浏览网页，代码执行、文件保存等操作也不在话下，已然成为真正实用的 "智能助手"。其核心的 "思考 - 行动" 循环独具匠心。智能体接到任务，先审慎分析当下状态与需求，完成 "思考" 步骤；随即挑选并启用恰当工具付诸 "行动"；再依据行动结果展开新一轮思考。如此循环，OpenManus 逐步拆解难题，始终精准把握任务全貌，高效满足用户需求。
1.2 项目主要目录结构
OpenManus 项目的 app 目录下主要包含了与智能体、配置、工具、流程等相关的模块，以下是根据代码片段总结的主要结构及各部分功能：
1.2.1 核心功能模块
agent 目录：包含智能体相关的实现。
-
manus.py：定义了 Manus 类，这是一个通用的多功能智能体，集成了多种工具，如 PythonExecute、BrowserUseTool 等。
-
config.py：负责项目的配置管理。定义了各种配置类，如 LLMSettings（大语言模型设置）、SearchSettings（搜索设置）、BrowserSettings（浏览器设置）、SandboxSettings（沙盒设置）和 MCPSettings（MCP 配置）。
tool 目录：包含各种工具的实现。
-
base.py：定义了工具的基类 BaseTool，所有具体工具类都继承自该类。BaseTool 类包含工具的基本属性（如名称、描述、参数）和执行方法，同时提供了将工具转换为函数调用格式的方法 to_param。
-
planning.py：实现了 PlanningTool 类，用于创建和管理解决复杂任务的计划。该工具支持创建计划、更新计划步骤、跟踪进度等操作。
-
search 目录：包含搜索工具相关的实现。
-
base.py：定义了 WebSearchEngine 基类和 SearchItem 类，WebSearchEngine 类提供了执行搜索的抽象方法，SearchItem 类用于表示单个搜索结果。
1.2.2 辅助功能模块
prompt 目录：包含提示信息的定义。
- manus.py：定义了 Manus 智能体的系统提示信息 SYSTEM_PROMPT 和下一步提示信息 NEXT_STEP_PROMPT，用于指导智能体的行为。
- planning.py：定义了规划工具的系统提示信息 PLANNING_SYSTEM_PROMPT 和下一步提示信息 NEXT_STEP_PROMPT，帮助智能体更好地使用规划工具。
- schema.py：定义了项目中使用的各种数据模型和枚举类型。
- Role 枚举：定义了消息的角色选项，包括 SYSTEM、USER、ASSISTANT 和 TOOL。
- ToolChoice 枚举：定义了工具选择的选项，如 NONE、AUTO 和 REQUIRED。
- AgentState 枚举：定义了智能体的执行状态，如 IDLE、RUNNING、FINISHED 和 ERROR。
- Message 类：表示对话中的消息，包含角色、内容、工具调用等信息，并提供了消息的创建和转换方法。
- Memory 类：用于管理智能体的内存，支持添加消息、获取最近消息等操作。 flow 目录：包含执行流程相关的实现。
- base.py：定义了 BaseFlow 类，作为执行流程的基类，支持多个智能体的协作。该类提供了管理智能体的方法，如获取主智能体、添加智能体等，并定义了执行流程的抽象方法 execute。
1.2.3 其他模块
- init.py：对 Python 版本进行检查，确保使用的 Python 版本在 3.11 - 3.13 之间。如果版本不兼容，会输出警告信息。
综上所述，OpenManus 项目的 app 目录结构清晰，各个模块分工明确，通过合理的设计和组织，实现了智能体、工具、配置和流程的有效管理和协作。