门锁出门/回家留言设置功能Skill
1. 必读项
本技能用于控制门锁的出门/回家留言设置，包括添加、删除、修改留言等操作。不支持查询操作，查询操作请参考lock-info。
服务ID（sid）
重要说明
- 回家留言和出门留言是不同的功能，执行时注意根据用户要求区分
- 留言的音量大小可以在音量设置-留言/天气提醒音量中进行设置
- 修改留言后，会在下次【门锁在线】时生效，以下任一情况会让【门锁在线】：
- 开关门
- 产生逗留录像或图片
- 有人按门铃
- 开启实时视频
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：时间戳，配置时需要生成，时间戳格式：20191226T075719Zerrno:回家/离家语音播报设置错误码,0——配置OK,1——语料ID重复,2——语料下载失败cfg：数组，可以包含多条留言，下列属性为留言属性vid：留言id，通过id值区分回家和出门。回家取值：1，2，3，4，5；出门取值：51，52，53。配置时已经使用过的id不能再次使用。当留言id均被占用时无法继续添加。rpt：留言重复类型，0-仅一次，1-每天，2-每周，3-每月，4-每年，5-指定日期act：回家/离家语音播报设置操作，0-增加配置,1-删除配置,2-修改配置uid:当前配置所属用户的id,离家语音不需要配置用户ID，传空字符串;回家语音设置勾选全部用户时，传"all";回家语音设置勾选部分用户时，传对应用户的UID： "1,4,5"switch:单条回家/离家语音播放开关 rd:与rpt强相关，表示重复日期。仅一次或每天：为空字符串""。按周："1,2,3,4,5,6,7"，分别代表周一到周日。每月："1" 代表1号。每年："1,2" 代表1月2日。指定日期："2024,1,2"代表2024年1月2日st:消息推送自定义时间开始时间，时间格式：HH:mm 使用24小时制。et:消息推送自定义时间结束时间，时间格式：HH:mm 使用24小时制。ve：留言内容，可以自定义语料内容，如"欢迎主人回家"type：1-文字留言，2-录音留言tb：音色，0-小艺女声，1-小艺少女，2-保留，3-小艺男声，4-小艺童声 |
1、本功能开启时，可以添加出门|回家留言，在出门|开门时，播放录制的音频或输入的文字2、留言的音量大小可以在音量设置-留言|天气提醒音量中进行设置，如果听不到留言声音，可以据此进行排查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)
- 增量更新原则：
data 中的 cfg 数组仅包含本次新增的留言配置，严禁携带已存在的其他留言数据。
- VID 唯一性：系统会自动校验
vid 是否已存在。若 1~5 已满，需提示用户先删除再添加。
- 修改前必须获得用户授权：门锁最多存在5条开门留言，3条回家留言，新增留言时，先检查留言是否全部用完，未用完时新增一条，用完时指导用户删除其中一条后再新增留言。
- UID 格式：
- 指定用户：
"3"
- 全部用户：
"all"
- 部分用户：
"1,4,5"
- 离家语音：
"" (空字符串)
- 操作选项：当前为添加，所以"act":0
执行命令 (Add Command)
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 删除回家留言
场景：用户要求删除 财运旺，万事顺 的留言。
配置逻辑与步骤
- 查询定位：系统根据用户意图，先查询当前已存在的留言列表，定位目标
vid (本例为 2)。
- 构建删除包：构造仅包含目标留言配置的 JSON 对象。
- 发送指令：通过
POST 请求触发删除逻辑。
核心规范 (Critical Rules)
- 精准匹配：
cfg 数组中必须且只能包含待删除的那一条留言配置。
- 忽略冗余：即使删除命令中包含了其他字段（如时间、内容），系统也仅以
vid 作为唯一标识进行删除操作，无需传入其他已存在留言的完整配置。
执行命令 (Delete Command)
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条出门留言
1---2name: lock-greeting3description: Lock Greeting4---56# 门锁出门/回家留言设置功能Skill78## 1. 必读项910本技能用于**控制**门锁的出门/回家留言设置，包括添加、删除、修改留言等操作。**不支持查询操作，查询操作请参考lock-info**。1112### 服务ID（sid）13- **sid**: `homeGreeting`1415### 重要说明16- 回家留言和出门留言是不同的功能，执行时注意根据用户要求区分17- 留言的音量大小可以在音量设置-留言/天气提醒音量中进行设置18- 修改留言后，会在下次【门锁在线】时生效，以下任一情况会让【门锁在线】：19 1. 开关门20 2. 产生逗留录像或图片21 3. 有人按门铃22 4. 开启实时视频2324### VID说明25- 通过id值区分回家和出门26- 回家取值：1，2，3，4，5，当前回家留言最多5条27- 出门取值：51，52，53，出门留言最多3条28- 配置时已经使用过的id不能再次使用2930## 2. 触发关键字3132当用户提到以下关键词时，应加载本技能：33- 出门留言34- 回家留言35- 留言设置36- 添加留言37- 删除留言3839## 3. 用户语料示例4041- "添加一条回家留言"42- "删除回家留言"43- "设置出门留言"44- "添加一条出门留言"45- "删除第二条回家留言"46- "修改留言内容"4748## 4. 相关参数说明4950### 4.1 留言设置参数表5152| 功能 | sid | 参数 | 参数说明 | 功能作用 |53|---|---|---|---|---|54| 出门/回家留言 | `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、修改留言后，会在下次【门锁在线】时生效 |5556### 4.2 核心参数说明5758| 参数 | 说明 |59|------|------|60| `ts` | 时间戳，配置时需要生成，格式：20191226T075719Z |61| `vid` | 留言id，回家：1-5，出门：51-53 |62| `act` | 操作类型，0-增加配置，1-删除配置，2-修改配置 |63| `uid` | 用户id，"all"表示全部用户，""表示离家语音 |64| `ve` | 留言内容 |65| `type` | 类型，1-文字留言，2-录音留言 |66| `tb` | 音色，0-小艺女声，1-小艺少女，2-保留，3-小艺男声，4-小艺童声 |6768## 5. 调用示例6970### 5.1 添加回家留言7172> **场景**：用户 ZTT 希望添加一条回家提醒："宝贝，回家后记得写作业"73> **前提**：当前已有 1 条留言 (`vid=1`)，上限 5 条，`vid=2` 可用。7475##### 配置逻辑与步骤7677| 步骤 | 逻辑说明 | 参数映射 |78| :--- | :--- | :--- |79| **1. VID 校验** | 检查 `vid` 是否冲突。回家留言范围 `1~5`。若 `vid=2` 未被占用，则填入。 | `vid`: `2` |80| **2. UID 映射** | 将用户名称 "ZTT" 转换为系统 ID。 | `uid`: `"3"` |81| **3. 时间默认** | 未指定日期时，默认全天生效。 | `st`: `"07:00"`, `et`: `"24:00"`, `rd`: `"1,2,3,4,5,6,7"` |82| **4. 内容润色** | 将指令转化为温暖口语。 | `ve`: `"宝贝，回家后记得写作业"` |83| **5. 属性设定** | 类型设为文字，开关默认开启。 | `type`: `1`, `switch`: `1` |8485##### 核心规范 (Critical Rules)861. **增量更新原则**：`data` 中的 `cfg` 数组**仅包含**本次新增的留言配置，**严禁**携带已存在的其他留言数据。872. **VID 唯一性**：系统会自动校验 `vid` 是否已存在。若 `1~5` 已满，需提示用户先删除再添加。883. **修改前必须获得用户授权**：门锁最多存在5条开门留言，3条回家留言，新增留言时，先检查留言是否全部用完，未用完时新增一条，用完时指导用户删除其中一条后再新增留言。894. **UID 格式**：90 - 指定用户：`"3"`91 - 全部用户：`"all"`92 - 部分用户：`"1,4,5"`93 - 离家语音：`""` (空字符串)945. **操作选项**：当前为添加，所以"act":09596##### 执行命令 (Add Command)9798```bash99node common-skill/bin/smarthome-claw.js control_device \100 --dev-id "xxx" \101 --prod-id "xxx" \102 --operation "POST" \103 --sid "homeGreeting" \104 --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"}' \105 --verbose106```107108### 5.2 删除回家留言109110> **场景**：用户要求删除 财运旺，万事顺 的留言。111112##### 配置逻辑与步骤1131141. **查询定位**：系统根据用户意图，先查询当前已存在的留言列表，定位目标 `vid` (本例为 `2`)。1152. **构建删除包**：构造仅包含目标留言配置的 JSON 对象。1163. **发送指令**：通过 `POST` 请求触发删除逻辑。117118##### 核心规范 (Critical Rules)119- **精准匹配**：`cfg` 数组中**必须且只能**包含待删除的那一条留言配置。120- **忽略冗余**：即使删除命令中包含了其他字段（如时间、内容），系统也仅以 `vid` 作为唯一标识进行删除操作，**无需**传入其他已存在留言的完整配置。121122##### 执行命令 (Delete Command)123124```bash125node common-skill/bin/smarthome-claw.js control_device \126 --dev-id "xxx" \127 --prod-id "xxx" \128 --operation "POST" \129 --sid "homeGreeting" \130 --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"}' \131 --verbose132```133*(注：实际调用时，`ve` 内容可保持任意值，系统主要依据 `vid` 识别删除目标)*134135## 6. 注意事项136137- 本技能仅支持控制，不支持查询操作138- **在执行任何删除类操作时，均需要提醒用户进行授权，禁止未经用户同意私自执行删除操作**139- 门锁最多存在5条回家留言，3条出门留言
18816132863