# Lock Info

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

- Skill: `18816132863/lock-info` (Agent Skill)
- Install (CLI): `npx skillmds@latest add 18816132863/lock-info`
- Raw SKILL.md: https://api.skillmd.com/api/skills/18816132863/lock-info/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: 18816132863 (https://skillmd.com/u/18816132863)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/18816132863/lock-info

---


# 门锁基本信息查询功能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` 命令获取门锁所有信息后

```bash
# 获取家庭信息和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` 命令获取门锁所有信息后，根据分类过滤信息展示给用户
- 涉及到拿不准的参数，可以查阅门锁其他技能进行确认
- 严格按照上面定义的数据展示格式进行展示！！！