name: lock-info description: "智能门锁基本信息查询技能。用于查询门锁状态、电量、在线状态、wifi配置、用户信息等基本信息。不支持控制操作。"
门锁基本信息查询功能Skill
1. 必读项
本技能用于查询门锁的基本信息,包括门锁状态、门锁配置、用户信息等。不支持控制操作。
查询时注意以下特殊参数的含义:
- faceSleepTime:回头防误开时长
- palmSleepTime:关门静默时长
- doorOpenSwitch:门未关告警开关
- vid:留言id,查询留言时通过id值区分回家和出门。回家取值:1,2,3,4,5,当前回家留言最多5条;出门取值:51,52,53,出门留言最多3条
- doorOpenSwitch:门未关告警开关
- takeSnapshotSwitch:检测模式,用户不感知,不要展示,不支持控制
2. 触发关键字
当用户提到以下关键词时,应加载本技能:
- 门锁状态、门锁电量、在线状态
- wifi状态、wifi配置
- 设备信息、门锁信息
- 用户信息、录入人数
- 人脸录入、掌静脉录入
- 门锁配置、人脸配置、猫眼配置
3. 用户语料示例
- "查询门锁状态"
- "门锁电量还有多少"
- "门锁在线吗"
- "门锁wifi连接了吗"
- "查看门锁设备信息"
- "门锁有几个人录入"
- "查看用户信息"
- "人脸录入了几个人"
- "掌静脉录入情况"
- "看一下门锁的基本信息"
- "我的门锁现在怎么样了"
4. 相关参数说明
4.1 信息查询分类
| 功能分类 | 说明 |
|---|---|
| 门锁状态查询 | 开关锁状态、电池电量、wifi配置、在线状态等 |
| 门锁配置查询 | 人脸配置、猫眼配置、掌静脉配置、声音配置、安全功能配置等 |
| 用户信息查询 | 录入人数、人脸录入数量、掌静脉录入数量等 |
4.2 服务ID(sid)参考
| sid | 功能 | 说明 |
|---|---|---|
lockStatus |
门锁状态 | 查询门锁开关状态 |
doorBattery |
门锁电量 | 查询门锁电池电量 |
wifiSetting |
门锁wifi | 查询门锁wifi状态 |
5. 调用示例
5.1 查询门锁状态
5.1.1 查询门锁信息
使用 smarthome-skill 的 get_devices_info 和 get_device_detail 命令获取门锁所有信息后
# 获取家庭信息和homeId
node common-skill/bin/smarthome-claw.js get_homes_info
# 获取所有设备信息,包括device id和prodid
node common-skill/bin/smarthome-claw.js get_devices_info
# 查询设备详细信息
node common-skill/bin/smarthome-claw.js get_device_detail --dev-id "xxx"
5.1.2 根据prodId查询门锁支持的能力,以X20 KW5L为例,实际需要在5.1.1中筛选门锁prodId
node lock-skill/bin/lock_device_info.cjs get_capability --pid KW5L
5.1.3 展示门锁信息
⚠️ 重要说明1:仅展示门锁支持的能力,不支持的能力自动忽略,除非用户明确追问
如KW5R不支持人脸(securitySetting:face),则不要展示人脸相关功能、不要展示人脸开关是否开启,也不要说明不支持人脸 如KW03不支持掌静脉(securitySetting:palm),则不要展示掌静脉相关功能、不要展示掌静脉开关是否开启,也不要说明不支持掌静脉
⚠️ 重要说明2:根据以下分类过滤信息
| 操作类型 | 查询内容 |
|---|---|
| 门锁状态 | 开关锁状态、电池电量、wifi配置 |
| 门锁配置 | 人脸配置、猫眼配置、掌静脉配置、亲情关怀配置、安全功能配置 |
| 用户信息 | 录入人数、人脸信息、掌静脉信息 |
⚠️ 重要说明3:以下内容不要展示
- 门锁在线状态
⚠️ 重要说明4:以下内容根据条件展示
- 蓝牙网关相关信息,仅在蓝牙网关已绑定条件下展示 sid:
bleGatewayStatus
5.1.3 展示今日门锁历史事件
使用lock-skill\lock-history\SKILL.md中查询历史信息的能力,展示门锁今天的开关门情况、告警情况
6. 数据展示格式
当前您家门锁状态如下
- 门锁开关门情况
- 电池电量
- Wifi连接状态
- 门锁开关状态
- 用户录入情况
- 其它配置
门锁今日开关门情况
按事件顺序展示
门锁今日告警情况(若有)
7. 注意事项
- 本技能仅支持查询,不支持控制操作
- 查询类操作使用
smarthome-skill的get_devices_info和get_device_detail命令获取门锁所有信息后,根据分类过滤信息展示给用户 - 涉及到拿不准的参数,可以查阅门锁其他技能进行确认
- 严格按照上面定义的数据展示格式进行展示!!!