核心用法
本技能为基础目标检测技能，通过调用 basic_object_detection_analysis 脚本，对视频流或图片中的目标区域进行实时检测。核心能力包括：
1. 目标分类定位：精准识别人员、车辆、非机动车、宠物（猫/狗）、包裹等5大类目标
2. 数量统计：自动统计各类目标出现频次与分布位置
3. 存在性检测：判断特定目标是否出现在监控区域内
4. 历史报告管理：支持云端历史检测报告查询与列表展示
触发方式：
- 默认触发：用户上传监控视频/图片URL或文件时自动启用
- 关键词触发：用户提及"目标检测"、"物体检测"、"人员车辆识别"等
- 历史查询触发：提及"查看历史检测报告"、"检测报告清单"等自动切换至报告查询模式
关键约束：
- 强制身份验证：必须按优先级获取
open-id（配置文件 → 用户提供 → 暂停请求），禁止假设或生成默认值 - 数据获取强制规则：历史报告必须从云端API获取（
--list --open-id），绝对禁止读取本地记忆文件或LanceDB
显著优点
- 多场景适配：支持多种监控视角与复杂环境，覆盖社区、工业园区、仓库等通用安防场景
- 双模输入支持：同时支持本地文件（multipart/form-data上传）与网络URL（服务端自动下载）
- 灵活阈值调节：可通过
--confidence-threshold调整置信度（默认0.5），平衡检出率与误报 - 结构化输出：提供JSON/standard/basic三种详细程度，便于系统集成或快速预览
- 云端化报告管理：检测记录持久化存储，支持按日期范围查询历史报告清单
潜在缺点与局限性
- 身份验证依赖：
open-id获取流程繁琐，若用户拒绝提供则无法继续，影响体验流畅度 - 网络依赖性强：历史报告查询、API调用均需联网，离线环境完全不可用
- 目标类别固定：仅支持预设5类目标，无法自定义扩展新类别
- 文件格式限制：视频限mp4/avi/mov，图片限jpg/png/jpeg，单文件上限100MB
- 无实时流处理：需先上传完整文件或提供URL，不支持RTSP等实时流直连
适合人群
- 物业安防管理人员：社区、写字楼、园区日常监控与异常事件回溯
- 仓储物流管理员：仓库包裹识别、人员车辆进出统计
- 中小型企业主：低成本快速部署基础AI视觉能力，无需自建算法团队
- 系统集成商：需要结构化检测数据对接现有安防平台的开发者
常规风险
- 隐私合规风险：人员检测涉及人脸识别相关场景时，需确保符合《个人信息保护法》及当地监控法规
- 数据安全风险：检测报告含敏感位置信息，云端存储需确认服务商安全等级
- 误报漏报风险：复杂光照、遮挡、小目标场景下可能出现检测失效，关键场景建议人工复核
- API密钥泄露风险：
api-key若通过命令行参数传递，可能被shell历史记录或进程列表暴露
---
技术实现：基于Python脚本调用RESTful API，依赖requests>=2.28.0，支持置信度阈值调节、输出格式控制、结果文件持久化。