Lock Claw

智能门锁设备专用技能（根Skill）

重要提醒：当用户提到智能门锁、猫眼、掌静脉、人脸、门铃声、进门/出门留言、回家提醒、天气提醒等智能门锁相关操作时，必须优先加载本技能。

路由原则：本技能作为总入口，负责根据用户请求路由到具体的功能skill。不要一次性加载所有功能skill。

1. 技能说明

智能门锁（devType='A0B'）设备专用操作技能的总入口，提供智能门锁特有的门锁状态查询、门锁配置查询、用户信息查询、猫眼设置、人脸设置、掌静脉设置、声音设置、出门|回家留言设置、回家提醒设置、天气提醒设置等服务。

2. 设备识别

2.1 基础设备识别

• 设备类型：智能门锁
• devType：'A0B'
• 通过 devType 可以从设备列表中快速筛选出智能门锁设备
• 通过 PID 获得设备产品ID

2.2 产品能力识别（重要）

【强制】不同型号的门锁支持的功能能力不同，在进行功能操作前必须先根据产品ID(PID)校验设备是否支持该功能

门锁设备能力定义文件：bin/lock_device_info.js

常见门锁型号能力对照表

门锁设备能力定义详见配置文件：bin/lock_device_capabilities.json

设备能力校验命令

# 列出所有已定义的门锁型号
node lock-skill/bin/lock_device_info.cjs list

# 根据PID查询设备能力
node lock-skill/bin/lock_device_info.cjs get_capability --pid KW5L

# 检查是否支持特定功能
node lock-skill/bin/lock_device_info.cjs check_feature --pid KW5L --feature securitySetting:face

# 获取门锁支持的功能列表（推荐）
node lock-skill/bin/lock_device_info.cjs get_supported --pid KW5L

# 检查功能是否支持并返回友好信息
node lock-skill/bin/lock_device_info.cjs check_with_message --pid KW5L --feature securitySetting:face

# 查看配置信息
node lock-skill/bin/lock_device_info.cjs config_info

# 重新加载配置文件
node lock-skill/bin/lock_device_info.cjs reload

API 说明：

使用示例：

// 示例1：查询门锁支持的功能列表（在查询门锁信息前调用）
const pid = 'KW5L'; // 从 get_devices_info 获取的 prodId
const featureInfo = getSupportedFeatures(pid);
// 返回: { supported: ['指纹', 'NFC', '密码', '门卡', '猫眼/视频', '留言功能', '天气提醒', '回家提醒'], unsupported: ['人脸识别', '掌静脉识别'], ... }

// 示例2：检查门锁是否支持某功能
const result = checkFeatureWithMessage('KW5L', 'face');
// 返回: { supported: true, message: '华为智能门锁 Pro支持人脸识别功能', featureCN: '人脸识别' }

// 示例3：在展示门锁信息时，只输出支持的能力
const info = getSupportedFeatures(pid);
const response = `您的${info.deviceName}（${info.model}）支持以下功能：${info.supported.join('、')}`;

能力校验失败的处理：

3. 功能Skill路由表（精确路由）

根据用户请求的关键词，直接路由到对应的功能skill文件：

4. 不支持的功能清单

以下功能当前不支持，若用户请求这些功能，需明确告知用户：

5. 依赖的通用技能

以下通用操作由 common-skill 提供：

6. 使用流程

1. 使用 get_devices_info 获取设备列表，通过 deviceTypeId='A0B' 找到智能门锁
2. 根据用户请求关键词，通过路由表找到对应的功能skill
3. 加载对应功能skill获取完整的命令格式和参数说明
4. 执行对应功能skill中的操作

7. 注意事项

7.1 【强制】回复规范

回复用户时，只展示用户可理解的中文结果，禁止暴露任何技术细节

• 回复内容：最终结果以简洁清晰的 checklist 形式统一展示
• 禁止展示：
  • 命令执行过程、CLI调用、API请求等技术细节
  • 参数名、参数值等内部参数
  • 子技能名称、技能目录结构等技术实现细节
• 多设备场景：当用户有多个家庭或多把门锁时，必须明确询问用户具体选择，禁止随机或默认选择
• 意图不明：若无法明确理解用户意图，必须详细追问，禁止编造参数或假设条件执行

7.2 【强制】敏感信息保护

以下信息为个人敏感数据，严禁输出给用户

• homeId、设备 id 及各类 id
• 用户的 uid 和 api-key
• 云侧原始信息（接口名、参数名、参数值等）

7.3 【强制】控制类操作

1. 执行前：重新查看功能skill中关于设置项的相关说明，确保不遗漏关键参数
2. 删除操作：执行任何删除类操作前，必须提醒用户确认授权，禁止未经用户同意私自执行
3. 执行后：必须再次查询云侧结果验证修改是否成功，避免误认为已修改成功

8. Profile 定义参考

如需了解智能门锁的完整服务能力定义，可参考：

https://smartlife-sandbox-drcn.things.dbankcloud.cn/device/guide/<产品ID>/<产品ID>.json

示例：

https://smartlife-sandbox-drcn.things.dbankcloud.cn/device/guide/KW5L/KW5L.json