jf-open-pro-ai-outdoor - 室外安防技能

技能描述

杰峰开放平台室外安防技能，提供完整的室外安防监控解决方案。支持车辆检测、异常告警、智能检测、灵敏度设置、检测区域配置、推送计划管理等功能，全面提升室外安防监控能力。

核心功能模块：

合并说明： 本技能由 28 个独立技能合并而成，提供统一的 API 接口和参数规范。

触发词

• 室外安防 / 车辆检测 / 异常告警
• 智能检测 / 灵敏度设置 / 检测区域
• 推送配置 / 通知计划 / 车辆管理

⚠️ 环境变量检查（使用前必读）

使用本技能前，必须先检查以下 7 个必需环境变量是否已配置！

检查清单

前置条件

前置条件

1. 设备在线 - 设备需在线且可访问
2. 设备绑定 - 设备需先绑定到开放平台账号
3. 套餐开通 - 需开通相应 AI 套餐 - 需开通室外安防 AI 套餐

签名算法** - 使用杰峰官方 SignatureUtil.getEncryptStr() 方法生成 signature 2. 时间戳算法 - 使用杰峰官方 TimeMillisUtil.getTimMillis() 方法生成 timeMillis 3. 设备绑定 - 设备需先绑定到开放平台账号

环境变量（使用前必须配置）

API 接口总览

1. 服务开关管理

2. 异常提醒配置

3. 报警记录查询

4. 智能检测配置

5. 灵敏度设置

6. 检测区域设置

7. 推送配置管理

8. 通知计划管理

9. 车辆管理

10. 统计分析

11. 设备认证

核心功能详解

1. 服务开关管理

查询服务状态： POST /outdoorSecurity/ai/analysis/switch/get

请求参数：

响应参数：

开关服务： POST /outdoorSecurity/ai/analysis/switch/change

请求参数：

2. 异常提醒配置

异常类型枚举：

查询异常配置： POST /outdoorSecurity/abnormalAlarmConfig/list

保存异常配置： POST /outdoorSecurity/abnormalAlarmConfig/save

3. 报警记录查询

查询报警列表： POST /child/alarm/page

请求参数：

4. 智能检测配置

智能检测类型：

查询智能配置： POST /outdoorSecurity/smartConfig/list

更新智能配置： POST /outdoorSecurity/smartConfig/update

5. 灵敏度设置

灵敏度范围： 1-10（1=最低，10=最高）

查询灵敏度： POST /outdoorSecurity/devInfo/getSensitivity

设置灵敏度： POST /outdoorSecurity/devInfo/setSensitivity

6. 检测区域设置

检测区域格式： JSON 数组，包含多边形坐标点

查询检测区域： POST /outdoorSecurity/areaConfig/get

设置检测区域： POST /outdoorSecurity/areaConfig/update

7. 推送配置管理

推送模式：

查询推送配置： POST /outdoorSecurity/pushConfig/query

保存推送配置： POST /outdoorSecurity/pushConfig/save

8. 通知计划管理

查询通知计划： POST /outdoorSecurity/pushPlan/query

新增通知计划： POST /outdoorSecurity/pushPlan/add

更新通知计划： POST /outdoorSecurity/pushPlan/update

删除通知计划： POST /outdoorSecurity/pushPlan/delete

9. 车辆管理

查询车辆列表： POST /outdoorSecurity/car/list

添加车辆： POST /outdoorSecurity/car/add

编辑车辆： POST /outdoorSecurity/car/edit

删除车辆： POST /outdoorSecurity/car/del

车牌识别： POST /outdoorSecurity/car/preview

10. 统计分析

查询统计次数： POST /outdoorSecurity/static/count

查询当日图表： POST /outdoorSecurity/static/dayDataChart

查询周图表： POST /outdoorSecurity/static/weekDataChart

11. 设备认证

同步设备凭证： POST /outdoorSecurity/devInfo/save

使用示例

环境准备

# 设置环境变量
export JF_UUID="\x3Cyour-uuid>"
export JF_APP_KEY="\x3Cyour-appkey>"
export JF_APP_SECRET="\x3Cyour-secret>"
export JF_MOVE_CARD="7"
export JF_DEVICE_SN="\x3Cyour-device-sn>"
export JF_AUTHORIZATION="eyJhbGciOiJIUzI1NiIs..."
export JF_USER="\x3Cyour-uuid>"
export JF_ENDPOINT="api-cn.jftechws.com"

1. 查询服务状态

cd /root/.openclaw/workspace/skills/aiscene/jf-open-pro-ai-outdoor/scripts

# 查询室外安防服务状态
python3 switch_manager.py --action get \
  --sn "\x3Cyour-device-sn>" \
  --user "\x3Cyour-uuid>" \
  --uuid "\x3Cyour-uuid>" \
  --appkey "\x3Cyour-appkey>" \
  --secret "\x3Cyour-secret>" \
  --auth "\x3Cyour-uuid>" \
  --movecard 7

2. 开关服务

# 开启室外安防服务
python3 switch_manager.py --action change --enable true \
  --sn "\x3Cyour-device-sn>" \
  --user "\x3Cyour-uuid>"

# 关闭室外安防服务
python3 switch_manager.py --action change --enable false \
  --sn "\x3Cyour-device-sn>" \
  --user "\x3Cyour-uuid>"

3. 查询异常提醒配置

python3 alarm_config.py --action list \
  --sn "\x3Cyour-device-sn>" \
  --user "\x3Cyour-uuid>"

4. 查询报警记录

# 查询最近 7 天的报警记录
python3 alarm_query.py --action page \
  --start-time 1733241600 --end-time 1733846399 \
  --page 1 --rows 10 \
  --sn "\x3Cyour-device-sn>" \
  --user "\x3Cyour-uuid>"

5. 车辆管理

# 查询车辆列表
python3 car_manager.py --action list \
  --user "\x3Cyour-uuid>"

# 添加车辆
python3 car_manager.py --action add \
  --plate-number "浙 A12345" \
  --color "黑色" \
  --type "小型车" \
  --user "\x3Cyour-uuid>"

6. 查询统计数据

# 查询统计次数
python3 stats_query.py --action count \
  --start-time 1733241600 --end-time 1733327999 \
  --sn "\x3Cyour-device-sn>" \
  --user "\x3Cyour-uuid>"

# 查询当日图表
python3 stats_query.py --action day-chart \
  --start-time 1733241600 --end-time 1733327999 \
  --sn "\x3Cyour-device-sn>" \
  --user "\x3Cyour-uuid>"

状态码

平台状态码

错误码 12504 详细处理步骤

错误信息： authorize failed,Please check it in the open platform

原因： 设备未开通室外安防服务，或未绑定套餐卡

解决步骤：

1. 登录杰峰开放平台：https://developer.jftech.com
2. 进入 套餐管理 / 服务管理
3. 找到 室外安防 套餐
4. 为设备购买并绑定套餐卡
5. 等待配置生效（通常 1-5 分钟）
6. 重新调用 API 测试

注意事项

1. 时间格式 - 通知计划时间格式为 HH:mm:ss
2. 工作日枚举 - 1=周一，2=周二，...，7=周日
3. 时间戳 - 统计查询使用秒级时间戳
4. 套餐开通 - 使用前需确保设备已开通室外安防套餐
5. Token 有效期 - authorization 需在有效期内
6. 签名算法 - 使用杰峰官方移位加密算法
7. 灵敏度范围 - 1-10，1=最低灵敏度，10=最高灵敏度

相关文件

参考文档

• 杰峰开放平台
• 签名算法
• 时间戳算法
• 室外安防 API 文档

📋 前置配置文档（环境变量缺失时参考）

⚠️ 重要提示： 如果在使用本技能时发现缺少必需的环境变量，请先完成以下配置步骤，然后再继续操作。

必需环境变量清单

以下 7 个环境变量 必须全部配置，缺一不可：

参数获取指南

1. JF_UUID（jf_uuid）

获取方式：

• 登录杰峰开放平台：https://developer.jftech.com
• 进入 个人中心 或 开发者信息
• 复制您的用户 UUID

说明： 这是您在杰峰开放平台的唯一用户标识

2. JF_APP_KEY（jf_appKey）

获取方式：

• 登录杰峰开放平台：https://developer.jftech.com
• 进入 应用管理 → 我的应用
• 选择或创建一个应用
• 复制应用的 appKey

说明： 这是您创建的应用的唯一标识

3. JF_APP_SECRET（jf_secret）

获取方式：

• 登录杰峰开放平台：https://developer.jftech.com
• 进入 应用管理 → 我的应用
• 选择对应的应用
• 查看应用详情，复制 secret 密钥

说明： 这是应用的密钥，用于 API 签名，请妥善保管

4. JF_MOVE_CARD（jf_moveCard）

获取方式：

• 方式一： 通过 appKey 查询接口获取并缓存（24 小时有效）
• 方式二： 登录杰峰开放平台，进入应用详情页查看

说明： 移动卡标识，用于签名算法生成

5. JF_DEVICE_SN（jf_device_sn）

获取方式：

• 查看设备底部标签或包装盒上的序列号
• 或在杰峰开放平台 设备管理 中查看已绑定的设备

说明： 设备的唯一序列号，格式通常为 16 位十六进制字符串

6. JF_AUTHORIZATION（jf_authorization）⭐

获取方式（二选一）：

方式 A：使用杰峰用户系统

请参考 用户登录接口 获取 Authorization 值

调用登录接口后，从响应中提取 authorization 字段（JWT Token）

方式 B：使用开发者自己的用户系统

传值参考 套餐卡使用说明 中的 userId

将您的用户系统生成的 userId 作为 authorization 值传入

说明： 用户鉴权 Token，用于 API 请求的身份验证

7. JF_USER（jf_user）

获取方式：

• 与 JF_UUID 通常相同
• 或在杰峰开放平台 个人中心 查看用户 ID

说明： 用户 ID，用于 API 请求中标识当前用户

配置示例

完成上述参数获取后，在您的环境中设置：

# 设置环境变量（请替换为您的实际值）
export JF_UUID="your-uuid-here"
export JF_APP_KEY="your-appkey-here"
export JF_APP_SECRET="your-secret-here"
export JF_MOVE_CARD="your-movecard-here"
export JF_DEVICE_SN="your-device-sn-here"
export JF_AUTHORIZATION="your-authorization-token-here"
export JF_USER="your-user-id-here"
export JF_ENDPOINT="api-cn.jftechws.com"  # 可选，默认值

验证配置

配置完成后，可以先调用一个简单的接口验证配置是否正确：

# 查询服务状态（验证配置）
python3 switch_manager.py --action get \
  --sn "$JF_DEVICE_SN" \
  --user "$JF_USER"

如果返回 code: 2000，说明配置成功！

重要提醒

使用原则： 后续所有 API 调用，必须严格使用用户环境变量中配置的参数值，不允许技能自己发散去获取或推算参数！

这样可以确保：

• 参数来源可控、可追溯
• 避免使用错误的或过期的凭证
• 符合安全和审计要求