jf-open-pro-ai-child-care - 儿童看护技能

技能描述

实时监控客厅、书房等场景，提供人身、生活安全守护，及时掌握孩子在家状态，保障安全的同时，关注其生活起居、学习娱乐情况。

核心功能：

• 服务状态管理 - 开启/关闭儿童看护服务
• 异常提醒配置 - 查询和设置异常提醒（可疑人员/危险区域/久未出现/进入离开）
• 异常告警查询 - 查询可疑车辆/可疑人员/非机动车/明火等告警
• 陌生人管理 - 添加/移除陌生人到人形库
• 行为统计 - 查询学习/娱乐/吃喝/走动/坐卧的次数和时间
• 七日图表 - 查询近七日行为时间图表

触发词

• 儿童看护 / 孩子看护 / 居家安全
• 异常告警 / 行为统计 / 学习娱乐

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

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

检查清单

前置条件

前置条件

1. 设备在线 - 设备需在线且可访问
2. 设备绑定 - 设备需先绑定到开放平台账号
3. 套餐开通 - 需开通相应 AI 套餐 - 需开通儿童看护 AI 套餐

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

环境变量

API 接口

核心功能

1. 服务状态管理

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

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

2. 异常提醒配置

异常类型枚举：

告警类型枚举：

3. 陌生人管理

添加到人形库： POST /child/stranger/add

移除人形库： POST /child/stranger/remove

4. 行为统计

行为类型枚举：

使用示例

环境准备

# 设置环境变量
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.jftechws.com"

1. 查询服务状态

cd ~/.openclaw/workspace/jf-open-pro-ai-child-care/scripts

# 查询儿童看护服务状态
python3 child_care.py --action status \
  --sn "\x3Cyour-device-sn>" \
  --user "\x3Cyour-uuid>"

2. 查询异常告警

# 查询可疑人员告警
python3 alarm_query.py --action list \
  --msg-type "PIRAlarm" \
  --start-time 1733241600 --end-time 1733846399 \
  --sn "\x3Cyour-device-sn>" \
  --user "\x3Cyour-uuid>"

3. 陌生人管理

# 添加陌生人到人形库
python3 stranger_manager.py --action add \
  --alarm-id "240911184509171" \
  --image "https://..." \
  --sn "\x3Cyour-device-sn>" \
  --user "\x3Cyour-uuid>"

# 从人形库移除
python3 stranger_manager.py --action remove \
  --alarm-id "240911184509171" \
  --sn "\x3Cyour-device-sn>" \
  --user "\x3Cyour-uuid>"

4. 查询行为统计

# 查询今日学习次数
python3 stats_query.py --action count \
  --type "studying" \
  --start-time 1733241600 --end-time 1733327999 \
  --sn "\x3Cyour-device-sn>" \
  --user "\x3Cyour-uuid>"

# 查询近七日学习时间图表
python3 stats_query.py --action week-chart \
  --type "studying" \
  --start-time 1732982400 --end-time 1733587199 \
  --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. 时间戳 - 统计查询使用秒级时间戳
2. 套餐开通 - 使用前需确保设备已开通儿童看护套餐
3. Token 有效期 - authorization 需在有效期内
4. 签名算法 - 使用杰峰官方移位加密算法

相关文件

参考文档

• 杰峰开放平台
• 签名算法
• 时间戳算法
• 套餐卡使用说明

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

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

必需环境变量清单

以下 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.jftechws.com"  # 可选，默认值

验证配置

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

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

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

重要提醒

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

这样可以确保：

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