公共场所吸烟行为智能检测

要解决什么问题

园区、社区和企事业单位的控烟管理，往往依赖人工巡查或事后回看录像，难以在实时视频流、静态抓拍和本地录像上稳定识别「是否真的在吸烟」。环境里的类似物体、光影和遮挡也容易造成误报，管理人员还需要把检测结果和历史记录对齐，而不是散落在本地会话文件里。

技能如何工作

本技能面向「上传或给出 URL 的视频/图片 → 结构化吸烟检测分析报告」这一主路径，并在用户明确要求时走云端历史报告清单查询。

• 媒体输入：支持本地路径（--input）或公网 URL（--url）；类型用 --media-type 区分 video / image，常见格式为 mp4/avi/mov 与 jpg/png/jpeg，单文件上限约 10MB。
• 检测逻辑（由后端 API 完成）：结合香烟目标、烟雾形态与「手持—口部」动作特征，过滤部分环境干扰，输出违规次数、置信度与预警信息。
• 执行入口：在技能根目录调用 python -m scripts.smoking_detection_analysis，必填 --open-id（不可臆造或跳过验证）；历史列表使用 --list --open-id，可选日期范围过滤。
• 强制数据规则：历史检测报告只从云端接口拉取，禁止读取 memory/、MEMORY.md 或 LanceDB 等本地记忆；清单以 Markdown 表格展示，并用 reportImageUrl 生成「🔗 查看报告」链接。
• 依赖：需先具备 smyx_common 技能，用于公共基座相关文本能力。

适用边界与注意点

分析结果供控烟管理参考，具体处置仍按单位制度执行。API Key 可选；若传入则需鉴权成功，否则按无鉴权路径处理。不要临时编写替代脚本，仅使用技能自带的 scripts/smoking_detection_analysis.py 与 scripts/config.py；接口细节与错误码见 references/api_doc.md。