This commit is contained in:
109
useage.md
109
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命令),同时网络相关服务在连接建立后按顺序启动。
|
||||
|
||||
Reference in New Issue
Block a user