02 · C · 架构
唤醒词训练 整体架构
%%{init: {'theme': 'dark', 'themeVariables': { 'primaryColor': '#1e293b', 'primaryTextColor': '#f1f5f9', 'primaryBorderColor': '#475569', 'lineColor': '#e040fb', 'secondaryColor': '#334155', 'tertiaryColor': '#0f172a', 'fontFamily': 'Space Grotesk, Noto Sans SC, sans-serif'}}}%%
graph TB
subgraph 前端层["前端 Dashboard"]
UI[Web 管理界面]
end
subgraph API层["jabobo-backend REST API (FastAPI, port 8007)"]
TrainAPI["POST /api/user/wake-word/train"]
StatusAPI["GET /api/user/wake-word/train/status"]
SyncAPI["POST /api/user/sync-config"]
end
subgraph 核心业务层["核心业务流程"]
direction TB
NORMALIZE["_normalize_wake_word()
标准化唤醒词名"]
TRAIN["_run_wakeword_training()
异步训练任务"]
UPDATE_STATUS["_update_wake_word_status()
更新数据库状态"]
end
subgraph 外部系统["外部系统"]
CMD1["train_wakeword.py
--generate-samples
（TTS 多音色 × 多语速）"]
CMD2["train_wakeword.py
（特征提取 + 训练）"]
CMD3["deploy_wakeword.py
（OTA 部署 .tflite）"]
end
subgraph 数据层["MySQL"]
DB[("user_personas 表")]
end
subgraph 固件层["ESP32 设备"]
DEVICE["捷宝宝硬件"]
OTA_RECEIVER["OTA 接收 + 模型加载"]
end
UI -->|"POST /user/wake-word/train"| TrainAPI
UI -->|"GET 训练状态"| StatusAPI
UI -->|"POST sync-config"| SyncAPI
TrainAPI -->|"asyncio.create_task"| TRAIN
SyncAPI -->|"wake_word 变更时"| TRAIN
StatusAPI -->|"查询"| DB
TRAIN --> NORMALIZE
TRAIN --> UPDATE_STATUS
TRAIN -->|"Step 1"| CMD1
CMD1 -->|"Step 2"| CMD2
CMD2 -->|"输出 .tflite"| CMD3
CMD3 -->|"OTA 推送"| OTA_RECEIVER
OTA_RECEIVER --> DEVICE
UPDATE_STATUS -->|"UPDATE model_status"| DB
style 前端层 fill:#0f766e,stroke:#14b8a6,color:#fff
style API层 fill:#1d4ed8,stroke:#3b82f6,color:#fff
style 核心业务层 fill:#15803d,stroke:#22c55e,color:#fff
style 外部系统 fill:#b45309,stroke:#f59e0b,color:#fff
style 数据层 fill:#7c3aed,stroke:#a855f7,color:#fff
style 固件层 fill:#b91c1c,stroke:#ef4444,color:#fff
前端 → API → 业务层 → 外部脚本 → 数据库 → 设备 · 可滚动查看完整图
