Install
openclaw skills install jf-open-pro-device-human-detectionjf-open-pro-device-human-detection
🔑API key required杰峰设备人形检测技能（开发版）。支持人形检测开关设置、人形检测灵敏度设置、云台设备人形追踪开关设置等功能。
jf-open-pro-device-human-detection - 杰峰设备人形检测技能（开发版）
技能描述
支持杰峰设备的人形检测和追踪功能，基于杰峰开放平台 OpenAPI 实现：
- 人形检测开关设置 - 开启/关闭人形检测报警
- 人形检测灵敏度设置 - 调节检测灵敏度（低/中/高）
- 人形追踪开关设置 - 开启/关闭云台自动追踪人形
- 人形追踪灵敏度设置 - 调节追踪灵敏度
- 追踪返回时间设置 - 设置无人时返回守望位的时间
触发词
- 查询人形检测配置 / 设置人形检测开关 / 开启人形检测 / 关闭人形检测
- 设置人形灵敏度 / 查询人形追踪配置 / 设置人形追踪开关
- 开启人形追踪 / 关闭人形追踪 / 人形跟踪设置
前置条件
必需配置
- 签名算法 - 使用杰峰官方移位加密算法生成 signature
- 时间戳算法 - counter(7 位) + timeMillis(13 位)，实时生成
- 设备绑定 - 设备需先绑定到开放平台账号
- 云台设备 - 人形追踪功能需要云台设备支持
环境变量
| 变量名 | 说明 | 默认值 | 必需 |
|---|---|---|---|
JF_UUID | 开放平台用户 uuid | - | ✅ |
JF_APP_KEY | 开放平台应用 appKey | - | ✅ |
JF_APP_SECRET | 开放平台应用密钥 | - | ✅ |
JF_MOVE_CARD | 移动卡标识（用于签名） | 2 | ✅ |
JF_DEVICE_SN | 设备序列号 | - | ✅ |
JF_DEVICE_TOKEN | 设备接口访问令牌 | - | ✅ |
JF_ENDPOINT | API 接入地址 | api-cn.jftechws.com | ❌ |
API 接口
| 功能 | 地址 | 方法 | 需要 Token | 需要在线 |
|---|---|---|---|---|
| 获取人形检测配置 | POST /gwp/v3/rtc/device/getconfig/{token} | POST | ✅ | ✅ |
| 设置人形检测配置 | POST /gwp/v3/rtc/device/setconfig/{token} | POST | ✅ | ✅ |
| 获取人形追踪配置 | POST /gwp/v3/rtc/device/getconfig/{token} | POST | ✅ | ✅ |
| 设置人形追踪配置 | POST /gwp/v3/rtc/device/setconfig/{token} | POST | ✅ | ✅ |
核心功能
1. 人形检测配置（Detect.HumanDetection）
配置项说明：
| 字段 | 类型 | 说明 | 取值 |
|---|---|---|---|
Enable | boolean | 人形检测开关 | true=开启，false=关闭 |
Sensitivity | int | 检测灵敏度 | 0=低，1=中，2=高，3=灵敏度数量 |
PedFdrAlg | int | 人形人脸算法类型 | 0=单人形，1=人形 + 人脸，2=人形 + 人脸识别，3=人形 + 车形，4=人形 + 车形 + 人脸，5=宠物 |
ObjectType | int | 检测目标类型 | 0=检测人，1=检测物体 |
ShowRule | boolean | 是否叠加人形规则框 | true=是，false=否 |
ShowTrack | boolean | 是否叠加移动人形框 | true=是，false=否 |
PushInterval | int | 单人脸推图间隔（毫秒） | -1=不推图，其他=间隔时间 |
警戒规则（PedRule）：
| 字段 | 类型 | 说明 |
|---|---|---|
Enable | boolean | 规则是否使能 |
RuleType | int | 规则类型（0=警戒线，1=警戒区域） |
RuleRegion | object | 警戒区域参数 |
RuleLine | object | 警戒线参数 |
警戒区域参数：
PtsNum: 区域点数（3-8）AlarmDirect: 检测方向（0=进入，1=离开，2=双向）Pts: 坐标点数组（0-8192）Sensitivity: 该区域灵敏度
2. 人形追踪配置（Detect.DetectTrack）
配置项说明：
| 字段 | 类型 | 说明 | 取值 |
|---|---|---|---|
Enable | int | 人形追踪开关 | 0=关闭，1=开启 |
Sensitivity | int | 追踪灵敏度 | 0=低，1=中，2=高 |
ReturnTime | int | 返回默认位置时间（秒） | 0=不返回，1-600=指定时间 |
注意： 人形追踪不是报警，只是云台自动跟随人形移动。画面需要正放，识别出人形才能生效。
使用示例
环境准备
# 设置环境变量
export JF_UUID="uuidxxxx"
export JF_APP_KEY="appkeyxxxx"
export JF_APP_SECRET="appsecretxxxx"
export JF_MOVE_CARD=0
export JF_DEVICE_SN="snxxx1"
export JF_DEVICE_TOKEN="NTQ0NzQ3YmE3MXwyYzFk..."
export JF_ENDPOINT="api-cn.jftechws.com"
1. 查询人形检测配置
cd ~/.openclaw/workspace/skills/developer/jf-open-pro-device-human-detection/scripts
python3 human_detection.py --action get-human-detect-config
2. 开启/关闭人形检测
# 开启人形检测
python3 human_detection.py --action set-human-detect-switch --enable true
# 关闭人形检测
python3 human_detection.py --action set-human-detect-switch --enable false
3. 设置人形检测灵敏度
# 设置低灵敏度
python3 human_detection.py --action set-human-detect-sensitivity --level 0
# 设置中灵敏度
python3 human_detection.py --action set-human-detect-sensitivity --level 1
# 设置高灵敏度
python3 human_detection.py --action set-human-detect-sensitivity --level 2
4. 查询人形追踪配置
python3 human_detection.py --action get-human-track-config
5. 开启/关闭人形追踪
# 开启人形追踪
python3 human_detection.py --action set-human-track-switch --enable true
# 关闭人形追踪
python3 human_detection.py --action set-human-track-switch --enable false
6. 设置人形追踪灵敏度
# 设置低灵敏度
python3 human_detection.py --action set-human-track-sensitivity --level 0
# 设置中灵敏度
python3 human_detection.py --action set-human-track-sensitivity --level 1
# 设置高灵敏度
python3 human_detection.py --action set-human-track-sensitivity --level 2
7. 设置追踪返回时间
# 设置 10 秒后返回
python3 human_detection.py --action set-track-return-time --seconds 10
# 设置不返回
python3 human_detection.py --action set-track-return-time --seconds 0
# 设置 5 分钟后返回（300 秒）
python3 human_detection.py --action set-track-return-time --seconds 300
灵敏度说明
人形检测灵敏度
| 级别 | 值 | 说明 | 适用场景 |
|---|---|---|---|
| 低灵敏度 | 0 | 检测较宽松，误报少 | 人员流动频繁区域 |
| 中灵敏度 | 1 | 平衡检测和误报 | 一般区域（默认） |
| 高灵敏度 | 2 | 检测更敏感，易触发 | 重要安防区域 |
人形追踪灵敏度
| 级别 | 值 | 说明 | 适用场景 |
|---|---|---|---|
| 低灵敏度 | 0 | 追踪较平缓 | 目标移动缓慢 |
| 中灵敏度 | 1 | 追踪速度适中 | 一般场景（默认） |
| 高灵敏度 | 2 | 追踪响应快 | 目标移动快速 |
人形人脸算法类型
| 类型 | 值 | 说明 |
|---|---|---|
| 单人形检测 | 0 | 仅检测人形（默认） |
| 人形加人脸检测 | 1 | 检测人形并检测人脸 |
| 人形加人脸识别 | 2 | 检测人形并识别人脸身份 |
| 人形加车形检测 | 3 | 检测人形和车辆 |
| 人形加车形加人脸 | 4 | 检测人形、车形和人脸 |
| 宠物检测 | 5 | 检测宠物 |
状态码
平台状态码
| code | 说明 | 处理建议 |
|---|---|---|
| 2000 | 成功 | - |
| 28007 | Header 参数错误 | 检查 uuid、appKey、timeMillis、signature |
| 40103 | 无效 Token | deviceToken 过期，重新获取 |
| 50000 | 服务器内部错误 | 联系杰峰技术支持 |
设备状态码（Ret）
| Ret | 说明 |
|---|---|
| 100 | 成功 |
| 106 | 用户名或密码错误 |
注意事项
- deviceToken 有效期 - 24 小时，过期需重新获取
- 设备在线要求 - 配置类操作需要设备在线
- 云台设备 - 人形追踪功能仅云台设备支持
- 画面正放 - 人形追踪需要画面正放才能生效
- 识别生效 - 需先识别出人形，追踪功能才能生效
- 坐标范围 - 警戒区域坐标需缩放到 0-8192 范围
- 北京时间 - 建议使用北京时间（UTC+8）进行时间查询
- 算法创建 - 多通道设备可能部分通道不创建算法（AlgoCreate 字段）
相关文件
| 文件 | 说明 |
|---|---|
SKILL.md | 技能文档 |
scripts/human_detection.py | Python 执行脚本 |
scripts/crypto.py | 签名/时间戳加密工具（复用） |