案例总览与调参方法

视觉案例在板端处理图像，无需把识别任务交给云端。浏览器用于观察同一帧的图像与识别标注，以及调整参数。建议先做色块和亮度实验，再尝试巡线和模型检测。

11个案例

下载任务名	实验	输入分辨率	输出/限制
color	多色色块	QVGA	红黄绿蓝紫中采样点最多的一类，单个合并框
line	黑线巡线	QVGA	下半幅黑线横向偏差与方向线
motion	运动检测	QVGA	相邻处理帧变化区域的总包围框
bright	亮点检测	QVGA	高亮区域，不区分光源种类
stats	亮度统计	QVGA	灰度均值与方差，不是lux
qrcode	二维码	VGA	普通QR Code位置、内容日志、16位散列
face	人脸检测	QVGA	位置和置信度，不识别身份
pedestrian	行人检测	QVGA	人体位置和置信度
cat	猫检测	QVGA	目标位置，不区分品种/身份
dog	狗检测	QVGA	目标位置，不区分品种/身份
hand	手部检测	QVGA	手部位置，不输出手势类别/关键点

每项需要对应固件，或自行选择配置重新编译。AprilTag尚未实现；协议中的Tag类型是预留定义，不代表已有可用案例。

【图片占位：视觉调试页截图，标注图像区、算法名称、帧号、耗时、参数面板和“应用参数”按钮。】

参数提交后先显示已接收，之后显示已用于当前识别帧。后者意味着该图像确实使用了新参数；只看请求成功不足以判断帧已更新。

识别间隔是每帧处理后额外等待时间，默认100 ms，不是固定100 ms完成一帧。真实周期还包含采集、识别、可选JPEG编码等时间。JPEG质量只改变网页预览压缩，不改变算法输入图像。

参数仅保存在内存，复位或恢复默认后消失。记录有效参数，二次开发时再决定是否加入NVS持久化。错误参数整组拒绝，不会一半生效。

暂停预览或把页面切到后台，只停止网页拉图；设备仍识别、仍发UART结果。若用于机器人控制，暂停预览不是停止运动的方法。

当前每帧输出一个结果，不显示全部目标。confidence在不同算法中含义不同，阈值算法的数值不是统计概率，也不能拿人脸置信度与色块覆盖评分直接比较。

每个案例保存：固件任务、拍摄角度、光照、背景、目标尺寸和距离、参数、成功/失败场景及截图。先做“有目标”与“无目标”对照，再改变背景或光照。只有目标存在时能触发、移开后能消失，才适合继续接入动作决策。

网页适合可信本地网络调试，没有额外登录权限；同热点客户端可以修改参数。先使用单浏览器观察，避免多个客户端影响体验。