设备操作记录简报 (Get Control Records)
核心定位
本技能是一个数据源技能。它不直接面向用户生成最终的阅读报告,而是作为面向用户的技能(例如“全屋简报”)子技能。它的核心职责是从指定范围的设备操控记录中,汇总出全屋设备操控记录,并返回一份全屋设备操控记录的分析报告。
触发与协作
- 前置依赖:
get-home-info: 获取homeId。get-device-info: 获取deviceId列表(若用户未指定,则默认为全屋设备)。
- 输入:
homeId,lastDays,deviceId。 - 输出: 全屋设备操作记录的简报。
输出文件
out_put/get_control_records/control_brief.txt- 控制记录概要out_put/get_control_records/control_detail.txt- 控制记录详情
执行流程
上下文确认
- 获取
homeId和deviceId。 - 确定
lastDays(默认为“最近24h”)。
- 获取
调用JS接口查询日志
- 命令:
node common-skill/bin/smarthome-claw.js get_control_records --home-id reg8vvop194up5ooe85ah4o --last-days 1解析数据:接收脚本返回的 JSON 格式原始数据。
分析汇总:
- 按
uniqueId和functionName对数据进行分组,统计操作次数。 - 区分手动和自动操作:目前默认均为手动操作。
- 按
生成报告:
- 文字总结:用自然语言概括关键发现,例如“过去24小时内,共发生XX次设备操作,其中手动操作XX次,自动化操作XX次。操作最频繁的设备是客厅主灯。”
- 汇总表格:创建一个 Markdown 表格,清晰地展示每个设备的操作类型和次数。
设备名称 操作内容 手动操控次数 自动操控次数 [设备名][动作]5 0 [设备名][动作]3 0