连接参数
公共 HiveMQ：TCP 1883 给设备；浏览器用 WSS
wss://broker.hivemq.com:8884/mqtt。与 Maix 填同一
farm_id / device_id。
同 WiFi 更流畅：若 Maix 与电脑连同一局域网，请在网关/树莓派部署
Mosquitto + WebSocket，下方选「局域网」并让Maix 固件也指向该 Broker（仅改网页无效）。可走
ws:// 内网地址，避免流量绕公网。
「类视频」监控：非 RTSP，而是设备按间隔经 MQTT 发 JPEG 预览帧（见 Maix
upload.auto_live_preview）。网页端对预览帧做「只显示最新一帧」合并以降低延迟。
画面与流（下发 Maix）
需已连接 MQTT。通过 set_stream_params 调整设备侧预览 JPEG 质量、缩小长边与预览间隔（帧率≈1000/间隔 ms）。修改 Maix
config.json 中的默认值可被覆盖。参考仓库 docs/GITHUB-REFERENCES.md。
指令说明
下面列出本页按钮发往 Maix 的 JSON 字段 action；主题格式为
strawberry/<farm_id>/devices/<device_id>/cmd。板载小屏若显示一串问号：Maix 默认字库不含中文，请在
config.json 的 camera.status_screen_text 使用英文（如 Running OK），程序会自动丢弃非 ASCII。
若看不到右侧「AI Agent」区块，请上传最新静态文件并 Ctrl+F5 强刷。
| 界面操作 | action 值 |
说明 |
|---|---|---|
| 锁定目标 | lock_target |
若 Maix 配置 analysis_requires_lock，拍照分析前需先锁定。 |
| 解除锁定 | unlock_target |
取消锁定状态。 |
| 拍照指令 | capture |
触发快照；锁定后才会走云端分析（见「分析」区）。 |
| Ping | ping |
连通性测试，状态见日志 / status。 |
| 单帧预览 | preview_once |
抓一帧预览图。 |
| 开始定时预览 | start_preview + interval_ms |
按间隔持续发预览帧（值 ≥200，单位 ms）。 |
| 停止预览 | stop_preview |
停止定时预览。 |
| 画面与流 → 应用到设备 | set_stream_params |
可选字段（均可单独下发）：preview_jpeg_quality（40–100）、preview_max_side（160–960
像素）、interval_ms（设备预览间隔，约 1000/帧率）、jpeg_quality（拍照）、live_preview_min_interval_ms（20–500）。
成功时 evt/status 的 message 为 stream_params_applied。
|
AI Agent（Claw）— 可说的话
右侧 AI Agent 在 ECS 运行 claw（默认 8788），大模型解析意图后向
Maix / ESP32 下发 MQTT。请填写可访问的服务器地址（勿用 127.0.0.1 访问公网站点）。
- 关键词示例：锁定、拍照、巡视 / 巡逻（会编排锁定 + 开始预览）。
- 自然语言示例：先锁定目标再拍照、开始每 500 毫秒预览、解除锁定。
- ESP32：由网关在
devices/<esp32_id>/cmd下发，JSON 由固件解析（需在网关.env配置ESP32_DEVICE_ID）。
操作
MQTT 预览（与 Maix 端指令一致）
画面（监控 / 拍照）
左：监控流（kind=preview），本页用 Canvas + createImageBitmap 解码 JPEG，减轻
<img> 反复换源导致的卡顿；右：最近一次拍照（kind=snapshot）。设备端可降低
preview_max_side、preview_jpeg_quality、适当加大
live_preview_interval_ms 以减小 MQTT 包（公共 Broker 下更易流畅）。网页侧已限制监控画格率并缩略大图；若仍卡顿请再加大间隔或降分辨率。未锁定时仅推送
evt/recognition；锁定目标后再拍照才会下发 evt/analysis。
识别（未拍照阶段）
每帧监控伴随 strawberry.recognition/v1（占位）；真实检测模型可替换 extra.detections。
（无）
分析（锁定后拍照）
来自 strawberry.analysis/v1，仅在设备已锁定目标且收到拍照指令后推送。
（无）