diff --git a/useage.md b/useage.md index ac71481..eb0ed26 100644 --- a/useage.md +++ b/useage.md @@ -5,3 +5,112 @@ idf.py fullclean idf.py set-target esp32s3 ``` + +## MimiClaw 启动顺序图 +┌─────────────────────────────────────────────────────────┐ +│ app_main() 开始 │ +└─────────────────────────────────────────────────────────┘ + │ + ▼ +┌─────────────────────────────────────────────────────────┐ +│ 1. 核心基础设施初始化 │ +│ ┌───────────────────────────────────────────────┐ │ +│ │ • 初始化NVS (非易失性存储) │ │ +│ │ • NVS安全检查 │ │ +│ │ • 创建默认事件循环 │ │ +│ │ • 初始化SPIFFS (文件系统) │ │ +│ └───────────────────────────────────────────────┘ │ +└─────────────────────────────────────────────────────────┘ + │ + ▼ +┌─────────────────────────────────────────────────────────┐ +│ 2. 子系统初始化 │ +│ ┌───────────────────────────────────────────────┐ │ +│ │ • 消息总线 (message_bus_init) │ │ +│ │ • 内存存储 (memory_store_init) │ │ +│ │ • 技能加载器 (skill_loader_init) │ │ +│ │ • 会话管理器 (session_mgr_init) │ │ +│ │ • WiFi管理器 (wifi_manager_init) │ │ +│ │ • HTTP代理 (http_proxy_init) │ │ +│ │ • Telegram机器人 (telegram_bot_init) │ │ +│ │ • 飞书机器人 (feishu_bot_init) │ │ +│ │ • LLM代理 (llm_proxy_init) │ │ +│ │ • 工具注册表 (tool_registry_init) │ │ +│ │ • 定时服务 (cron_service_init) │ │ +│ │ • 心跳服务 (heartbeat_init) │ │ +│ │ • 代理循环 (agent_loop_init) │ │ +│ └───────────────────────────────────────────────┘ │ +└─────────────────────────────────────────────────────────┘ + │ + ▼ +┌─────────────────────────────────────────────────────────┐ +│ 3. 串口CLI启动 (无WiFi依赖) │ +│ ┌───────────────────────────────────────────────┐ │ +│ │ • 串口CLI初始化 (serial_cli_init) │ │ +│ └───────────────────────────────────────────────┘ │ +└─────────────────────────────────────────────────────────┘ + │ + ▼ +┌─────────────────────────────────────────────────────────┐ +│ 4. WiFi连接阶段 │ +│ ┌───────────────────────────────────────────────┐ │ +│ │ • 启动WiFi管理器 (wifi_manager_start) │ │ +│ │ • 扫描附近AP并打印 │ │ +│ │ • 等待WiFi连接 (30秒超时) │ │ +│ └───────────────────────────────────────────────┘ │ +└─────────────────────────────────────────────────────────┘ + │ + ▼ + ┌───────────────┐ + │ WiFi连接成功? │ + └───────────────┘ + │ + ┌───────────────────┼───────────────────┐ + │ │ │ + ▼ │ ▼ +┌─────────────────────┐ │ ┌─────────────────────┐ +│ 5a. 连接成功路径 │ │ │ 5b. 连接失败路径 │ +│ • 获取IP地址 │ │ │ • 进入WiFi配置门户│ +│ • 初始化时间同步 │ │ │ (wifi_onboard_start)│ +│ (time_sync_init) │ │ │ • 重启设备 │ +└─────────────────────┘ │ └─────────────────────┘ + │ + ▼ + ┌─────────────────────┐ + │ 启动管理门户(可选) │ + │ (wifi_onboard_start)│ + └─────────────────────┘ + │ + ▼ +┌─────────────────────────────────────────────────────────┐ +│ 6. 网络服务启动 │ +│ ┌───────────────────────────────────────────────┐ │ +│ │ • 创建出站调度任务 (outbound_dispatch_task) │ │ +│ │ • 启动代理循环 (agent_loop_start) │ │ +│ │ • 启动Telegram机器人 (telegram_bot_start) │ │ +│ │ • 启动飞书机器人 (feishu_bot_start) │ │ +│ │ • 启动定时服务 (cron_service_start) │ │ +│ │ • 启动心跳服务 (heartbeat_start) │ │ +│ │ • 启动WebSocket服务器 (ws_server_start) │ │ +│ └───────────────────────────────────────────────┘ │ +└─────────────────────────────────────────────────────────┘ + │ + ▼ +┌─────────────────────────────────────────────────────────┐ +│ MimiClaw 启动完成 │ +│ "Type 'help' for CLI commands" │ +└─────────────────────────────────────────────────────────┘ +关键启动点和依赖关系 +时间依赖 +1. *时间同步 (time_sync_init)*:只在WiFi连接成功后初始化 +2. 网络服务:所有网络服务(Telegram、飞书、WebSocket等)都在WiFi连接成功后启动 +无依赖启动 +1. 串口CLI:最早启动,即使没有WiFi也能工作 +2. 核心基础设施:NVS、SPIFFS等必须首先初始化 +条件分支 +1. WiFi连接失败:进入配置门户模式,阻塞直到配置成功并重启 +2. WiFi连接成功:继续启动所有网络服务 +并行启动 +- 多个子系统初始化是顺序执行的,但一旦启动,它们会在各自的FreeRTOS任务中并行运行 +- 出站调度任务在启动网络服务前创建,以避免丢失早期响应 +这个启动顺序确保了核心功能在没有网络时也能部分工作(如CLI命令),同时网络相关服务在连接建立后按顺序启动。