# Lock Greeting

> Lock Greeting

- Skill: `18816132863/lock-greeting` (Agent Skill)
- Install (CLI): `npx skillmds@latest add 18816132863/lock-greeting`
- Raw SKILL.md: https://api.skillmd.com/api/skills/18816132863/lock-greeting/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-greeting

---


# 门锁出门/回家留言设置功能Skill

## 1. 必读项

本技能用于**控制**门锁的出门/回家留言设置，包括添加、删除、修改留言等操作。**不支持查询操作，查询操作请参考lock-info**。

### 服务ID（sid）
- **sid**: `homeGreeting`

### 重要说明
- 回家留言和出门留言是不同的功能，执行时注意根据用户要求区分
- 留言的音量大小可以在音量设置-留言/天气提醒音量中进行设置
- 修改留言后，会在下次【门锁在线】时生效，以下任一情况会让【门锁在线】：
  1. 开关门
  2. 产生逗留录像或图片
  3. 有人按门铃
  4. 开启实时视频

### VID说明
- 通过id值区分回家和出门
- 回家取值：1，2，3，4，5，当前回家留言最多5条
- 出门取值：51，52，53，出门留言最多3条
- 配置时已经使用过的id不能再次使用

## 2. 触发关键字

当用户提到以下关键词时，应加载本技能：
- 出门留言
- 回家留言
- 留言设置
- 添加留言
- 删除留言

## 3. 用户语料示例

- "添加一条回家留言"
- "删除回家留言"
- "设置出门留言"
- "添加一条出门留言"
- "删除第二条回家留言"
- "修改留言内容"

## 4. 相关参数说明

### 4.1 留言设置参数表

| 功能 | sid | 参数 | 参数说明 | 功能作用 |
|---|---|---|---|---|
| 出门/回家留言 | `homeGreeting` | `ts`, `errno`, `cfg`, `vid`, `rpt`, `act`, `uid`, `switch`, `rd`, `st`, `et`, `ve`, `type`, `fid`, `tb`| ts：时间戳，配置时需要生成，时间戳格式：20191226T075719Z<br/>errno:回家/离家语音播报设置错误码,0——配置OK,1——语料ID重复,2——语料下载失败<br/>cfg：数组，可以包含多条留言，下列属性为留言属性<br/>vid：留言id，通过id值区分回家和出门。回家取值：1，2，3，4，5；出门取值：51，52，53。配置时已经使用过的id不能再次使用。当留言id均被占用时无法继续添加。<br/>rpt：留言重复类型，0-仅一次，1-每天，2-每周，3-每月，4-每年，5-指定日期<br/>act：回家/离家语音播报设置操作，0-增加配置,1-删除配置,2-修改配置<br/>uid:当前配置所属用户的id,离家语音不需要配置用户ID，传空字符串;回家语音设置勾选全部用户时，传"all";回家语音设置勾选部分用户时，传对应用户的UID： "1,4,5"<br/>switch:单条回家/离家语音播放开关 <br/>rd:与rpt强相关，表示重复日期。仅一次或每天：为空字符串""。按周："1,2,3,4,5,6,7"，分别代表周一到周日。每月："1" 代表1号。每年："1,2" 代表1月2日。指定日期："2024,1,2"代表2024年1月2日<br/>st:消息推送自定义时间开始时间，时间格式：HH:mm 使用24小时制。<br/>et:消息推送自定义时间结束时间，时间格式：HH:mm 使用24小时制。<br/>ve：留言内容，可以自定义语料内容，如"欢迎主人回家"<br/>type：1-文字留言，2-录音留言<br/>tb：音色，0-小艺女声，1-小艺少女，2-保留，3-小艺男声，4-小艺童声 | 1、本功能开启时，可以添加出门\|回家留言，在出门\|开门时，播放录制的音频或输入的文字<br/>2、留言的音量大小可以在音量设置-留言\|天气提醒音量中进行设置，如果听不到留言声音，可以据此进行排查<br/>3、修改留言后，会在下次【门锁在线】时生效 |

### 4.2 核心参数说明

| 参数 | 说明 |
|------|------|
| `ts` | 时间戳，配置时需要生成，格式：20191226T075719Z |
| `vid` | 留言id，回家：1-5，出门：51-53 |
| `act` | 操作类型，0-增加配置，1-删除配置，2-修改配置 |
| `uid` | 用户id，"all"表示全部用户，""表示离家语音 |
| `ve` | 留言内容 |
| `type` | 类型，1-文字留言，2-录音留言 |
| `tb` | 音色，0-小艺女声，1-小艺少女，2-保留，3-小艺男声，4-小艺童声 |

## 5. 调用示例

### 5.1 添加回家留言

> **场景**：用户 ZTT 希望添加一条回家提醒："宝贝，回家后记得写作业"
> **前提**：当前已有 1 条留言 (`vid=1`)，上限 5 条，`vid=2` 可用。

##### 配置逻辑与步骤

| 步骤 | 逻辑说明 | 参数映射 |
| :--- | :--- | :--- |
| **1. VID 校验** | 检查 `vid` 是否冲突。回家留言范围 `1~5`。若 `vid=2` 未被占用，则填入。 | `vid`: `2` |
| **2. UID 映射** | 将用户名称 "ZTT" 转换为系统 ID。 | `uid`: `"3"` |
| **3. 时间默认** | 未指定日期时，默认全天生效。 | `st`: `"07:00"`, `et`: `"24:00"`, `rd`: `"1,2,3,4,5,6,7"` |
| **4. 内容润色** | 将指令转化为温暖口语。 | `ve`: `"宝贝，回家后记得写作业"` |
| **5. 属性设定** | 类型设为文字，开关默认开启。 | `type`: `1`, `switch`: `1` |

##### 核心规范 (Critical Rules)
1. **增量更新原则**：`data` 中的 `cfg` 数组**仅包含**本次新增的留言配置，**严禁**携带已存在的其他留言数据。
2. **VID 唯一性**：系统会自动校验 `vid` 是否已存在。若 `1~5` 已满，需提示用户先删除再添加。
3. **修改前必须获得用户授权**：门锁最多存在5条开门留言，3条回家留言，新增留言时，先检查留言是否全部用完，未用完时新增一条，用完时指导用户删除其中一条后再新增留言。
4. **UID 格式**：
   - 指定用户：`"3"`
   - 全部用户：`"all"`
   - 部分用户：`"1,4,5"`
   - 离家语音：`""` (空字符串)
5. **操作选项**：当前为添加，所以"act":0

##### 执行命令 (Add Command)

```bash
node common-skill/bin/smarthome-claw.js control_device \
  --dev-id "xxx" \
  --prod-id "xxx" \
  --operation "POST" \
  --sid "homeGreeting" \
  --data '{"cfg":[{"vid":2,"fid":"","uid":"3","st":"07:00","rd":"1,2,3,4,5,6,7","act":0,"rpt":1,"type":1,"tb":0,"switch":1,"et":"24:00","ve":"宝贝，回家后记得写作业"}],"ts":"20260408T150744Z842"}' \
  --verbose
```

### 5.2 删除回家留言

> **场景**：用户要求删除 财运旺，万事顺 的留言。

##### 配置逻辑与步骤

1. **查询定位**：系统根据用户意图，先查询当前已存在的留言列表，定位目标 `vid` (本例为 `2`)。
2. **构建删除包**：构造仅包含目标留言配置的 JSON 对象。
3. **发送指令**：通过 `POST` 请求触发删除逻辑。

##### 核心规范 (Critical Rules)
- **精准匹配**：`cfg` 数组中**必须且只能**包含待删除的那一条留言配置。
- **忽略冗余**：即使删除命令中包含了其他字段（如时间、内容），系统也仅以 `vid` 作为唯一标识进行删除操作，**无需**传入其他已存在留言的完整配置。

##### 执行命令 (Delete Command)

```bash
node common-skill/bin/smarthome-claw.js control_device \
  --dev-id "xxx" \
  --prod-id "xxx" \
  --operation "POST" \
  --sid "homeGreeting" \
  --data '{"cfg":[{"vid":2,"fid":"","uid":"all","st":"07:00","rd":"1,2,3,4,5,6,7","act":0,"rpt":1,"type":1,"tb":0,"switch":1,"et":"24:00","ve":"财运旺，万事顺"}],"ts":"20260408T150744Z842"}' \
  --verbose
```
*(注：实际调用时，`ve` 内容可保持任意值，系统主要依据 `vid` 识别删除目标)*

## 6. 注意事项

- 本技能仅支持控制，不支持查询操作
- **在执行任何删除类操作时，均需要提醒用户进行授权，禁止未经用户同意私自执行删除操作**
- 门锁最多存在5条回家留言，3条出门留言