lock-info

star 2

智能门锁基本信息查询技能。用于查询门锁状态、电量、在线状态、wifi配置、用户信息等基本信息。不支持控制操作。

18816132863 By 18816132863 schedule Updated 4/25/2026

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-skillget_devices_infoget_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-skillget_devices_infoget_device_detail 命令获取门锁所有信息后,根据分类过滤信息展示给用户
  • 涉及到拿不准的参数,可以查阅门锁其他技能进行确认
  • 严格按照上面定义的数据展示格式进行展示!!!
Install via CLI
npx skills add https://github.com/18816132863/xiaoyi-claw-omega-final --skill lock-info
Repository Details
star Stars 2
call_split Forks 0
navigation Branch main
article Path SKILL.md
More from Creator