⚠️ 技能介绍(强制规范)
- 自动获取家庭信息 -调用get_homes_info获取家庭列表,当家庭数量>1且用户未明确指定目标家庭时,必须强制询问用户要查询哪个家庭,禁止跳过此步骤继续后续查询
- 自动获取设备列表 -调用get_devices_info,筛选门锁、路由器、传感器,设备不存在时仍使用该技能,参考下方数据缺失处理逻辑
- 查看设备记录 -调用get_device_histories,获取有关身份的关键执行记录
- 自动分析结果-按照下面核心算法判断是否有人
- 直接返回结果-告诉用户谁在家即可
【最高优先级 - 强制要求】 当用户询问"谁在家"、"家里有谁"等问题时: 优先使用该技能 先说“好的 我查一下” 绝对禁止:
- ❌ 不要回复技能名称
- ❌ 不要列举所有的设备名称
- ❌ 不要询问用户是否查询设备记录等
家庭成员识别
功能说明
通过综合分析门锁、路由器、AI传感器数据,计算每个家庭成员在家的概率,识别当前在家的具体成员。
核心算法
1. 基础分计算
| 数据源 | 场景 | 基础分 |
|---|---|---|
| 门锁 | 室外开门+无室内开门记录 | 90% |
| 室外开门+门铃响后室内开门 | 90% | |
| 室外开门+有室内开门记录 | 50% | |
| 无记录 | 0% | |
| 路由器 | 手机连接路由器 | 90% |
| 手机未连接路由器 | 10% | |
| 传感器 | 成员房间有人 | 80% |
| 成员房间无人 | 30% |
2. 时间衰减因子
门锁时间衰减
| 门锁场景 | 5分钟内 | 15分钟内 | 30分钟内 | 60分钟外 |
|---|---|---|---|---|
| 室外开门+无室内开门 | 90% | 70% | 50% | 30% |
| 室外开门+门铃后室内 | 90% | 60% | 40% | 20% |
| 室外开门+有室内开门 | 50% | 40% | 25% | 10% |
传感器时间衰减
| 传感器场景 | 5分钟内 | 10分钟内 | 30分钟外 |
|---|---|---|---|
| 房间有人 | 80% | 60% | 30% |
| 房间无人 | 30% | 40% | 50% |
路由器实时数据,不做时间衰减。
3. 加权计算
最终得分 = (门锁分 × 0.4) + (路由器分 × 0.4) + (传感器分 × 0.2)
4. 置信度判定
| 最终得分 | 置信度 | 输出 |
|---|---|---|
| ≥ 85% | high | 确定在家 |
| 60% - 85% | medium | 可能在家 |
| < 60% | low | 不在家/无法确定 |
数据采集
1. 门锁数据
- 使用
get_device_histories查询门锁最近60分钟记录 - 筛选该成员的室外开门记录
- 判断是否有对应的室内开门记录
2. 路由器数据
- 查询当前连接家庭网络的设备
- 匹配逻辑:从
memberDeviceMap.json读取成员-设备列表,遍历成员的所有设备MAC地址进行匹配 - 支持一个成员对应多个设备(一对多映射)
设备名自动匹配规则:
当路由器返回的设备名称中包含成员称呼时(如"妈妈的手机 pura70"、"爸爸的iPhone"),视为强匹配信号,应自动建立映射关系:
检测到设备名称中包含成员称呼,已自动绑定:
- "妈妈的手机 pura70" → 已绑定到 妈妈
匹配关键字列表:
- 家庭称呼:爸爸、妈妈、爷爷、奶奶、哥哥、姐姐、弟弟、妹妹、儿子、女儿、老公、老婆、宝宝、孩子等
- 自定义昵称(需与
memberDeviceMap.json中注册的成员名称一致)
禁止行为 - 过度联想:
【严重】绝对禁止通过门锁成员名称联想匹配未知设备
门锁中录入的成员名称(如"爸爸"、"妈妈")仅用于门锁权限识别,不能作为设备归属的依据。
错误示例:
- 门锁有成员"妈妈"
- 路由器有设备"AQUA的手机"
- ❌ 禁止自动认为"AQUA"就是"妈妈"或有关联
正确做法:
- 仅通过
memberDeviceMap.json中已配置的映射关系匹配- 或者在设备名称明确包含成员称呼时(如"妈妈的手机")才自动绑定
- 无法匹配时,询问用户确认
3. 传感器数据
- 使用
get_device_messages查询传感器最近消息 - 需要预先配置成员-房间映射表
4. 成员配置(启动时加载)
配置存储位置: memberDeviceMap.json
加载时机: 每次执行成员检测前,必须先从 memberDeviceMap.json 读取当前家庭的成员-设备映射关系。
加载逻辑伪代码:
// 获取当前家庭ID
const homeId = getCurrentHomeId();
// 读取JSON配置
const config = readJsonFile("memberDeviceMap.json");
// 获取当前家庭的成员-设备列表
const memberDeviceList = config[homeId] || {};
// memberDeviceList 结构示例:
// {
// "爸爸": [
// { "deviceName": "iPhone 15 Pro", "mac": "XX:XX:XX:XX:XX:XX" },
// { "deviceName": "iPad Pro", "mac": "YY:YY:YY:YY:YY:YY" }
// ],
// "妈妈": [
// { "deviceName": "Huawei P50", "mac": "ZZ:ZZ:ZZ:ZZ:ZZ:ZZ" }
// ]
// }
配置缺失处理:
- 若
memberDeviceMap.json中无当前家庭ID的配置,记录警告但继续执行 - 后续路由器检测到未知设备时,将引导用户配置映射关系
5. 未匹配设备处理
当路由器查询到已连接的手机,但该设备信息未在 memberDeviceMap.json 中匹配到家庭成员时:
- 检查设备名是否包含成员称呼 - 匹配关键字列表(爸爸、妈妈、爷爷、奶奶等)
- 若匹配成功,自动将设备绑定到对应成员,并更新到
memberDeviceMap.json
- 若匹配成功,自动将设备绑定到对应成员,并更新到
- 若不匹配,检查
memberDeviceMap.json中当前家庭是否有任何成员配置 - 若该设备名称之前未被询问过,记录该未知设备(设备名、MAC地址)
- 终止当前执行
- 返回询问消息给用户:
检测到家庭网络中有未识别的设备,请问这个设备是哪个家庭成员的?
- 设备名称:iPhone 15 Pro
已配置家庭的后续检测:
- 若
memberDeviceMap.json中已有当前家庭的配置,但仍出现未知设备 - 说明该设备为新接入设备,需要用户确认归属
6. 用户回答设备归属后
当用户回答设备归属后(如"iPhone是爸爸的"),按以下流程处理:
6.1 更新配置
当用户回答设备归属后(如"iPhone是爸爸的"),按以下流程将配置持久化到 memberDeviceMap.json 文件:
- 获取家庭ID - 从已获取的家庭信息中获取当前家庭的
homeId - 查询路由器获取 MAC - 调用
get_devices_info获取路由器设备列表,再查询该设备的 MAC 地址 - 读取现有配置 - 读取
memberDeviceMap.json文件内容(若文件不存在则为空对象{}) - 更新 JSON 结构 - 将设备信息添加到对应家庭和成员的设备列表中(支持一对多映射)
memberDeviceMap.json 文件结构:
{
"familyId_001": {
"爸爸": [
{ "deviceName": "iPhone 15 Pro", "mac": "XX:XX:XX:XX:XX:XX" },
{ "deviceName": "iPad Pro", "mac": "YY:YY:YY:YY:YY:YY" }
],
"妈妈": [
{ "deviceName": "Huawei P50", "mac": "ZZ:ZZ:ZZ:ZZ:ZZ:ZZ" }
]
}
}
更新逻辑伪代码:
// 用户回答"iPhone 15 Pro是爸爸的"后
const homeId = getCurrentHomeId();
const deviceMac = getDeviceMacFromRouter("iPhone 15 Pro");
// 读取现有配置
let config = readJsonFile("memberDeviceMap.json");
if (!config[homeId]) {
config[homeId] = {};
}
if (!config[homeId]["爸爸"]) {
config[homeId]["爸爸"] = [];
}
// 添加新设备(避免重复)
const existingIndex = config[homeId]["爸爸"].findIndex(d => d.deviceName === "iPhone 15 Pro");
if (existingIndex === -1) {
config[homeId]["爸爸"].push({
deviceName: "iPhone 15 Pro",
mac: deviceMac
});
}
// 写入文件
writeJsonFile("memberDeviceMap.json", config);
关键约束:
- 一个成员可以绑定多部设备(数组形式),MAC 地址必须唯一
- 若设备名称已存在,则更新其 MAC 地址
- 每次更新都是完整覆盖写入,保证数据一致性
6.2 重新执行检测
配置更新完成后,自动重新执行成员在家检测:
- 从
memberDeviceMap.json读取更新后的家庭成员设备映射 - 使用更新后的配置重新匹配路由器设备
- 按算法计算每个成员在家概率
- 返回最终结果
6.3 返回示例
已将 iPhone 15 Pro 绑定到爸爸,现在重新检测谁在家...
根据检测,当前在家成员:
- 爸爸(置信度高,判断依据:手机已连接家庭网络)
- 妈妈(置信度中,判断依据:传感器显示次卧有人)
判断依据:
- 路由器显示爸爸的手机已连接家庭网络
- AI传感器显示次卧有人(8分钟内)
7. 响应用户回答的触发方式
7.1 触发条件
当用户回答设备归属时(包含设备名和成员名的意图),触发本 skill 的绑定处理逻辑。
7.2 输入参数
{
"action": "bind_device",
"deviceName": "iPhone 15 Pro",
"member": "爸爸"
}
7.3 处理流程
- 根据
deviceName查询路由器获取对应 MAC 地址 - 将设备信息添加到
memberDeviceMap.json对应家庭和成员的设备列表中 - 从
memberDeviceMap.json读取更新后的配置 - 重新执行成员在家检测
- 返回最终结果
数据缺失处理
| 缺失数据源 | 处理方式 |
|---|---|
| 仅缺门锁 | 用 (传感器×0.25 + 路由器×0.75) 归一化 |
| 仅缺传感器 | 用 (门锁×0.5 + 路由器×0.5) 归一化 |
| 仅缺路由器 | 用 (门锁×0.5 + 传感器×0.5) 归一化 |
| 缺两个 | 用单一数据源,置信度降为low |
| 全缺 | "无法判断" |
使用流程
- 获取家庭成员列表
- 读取成员配置 - 从
memberDeviceMap.json加载当前家庭的成员-设备映射关系 - 对每个成员分别查询三端数据(门锁、路由器、传感器)
- 按算法计算每个成员在家概率
- 筛选概率≥60%的成员作为在家成员
- 生成回复结果
回复格式
识别到具体成员时
根据检测,当前在家成员:
- 张三(置信度高,判断依据:门锁记录显示5分钟前进门)
- 李四(置信度中,判断依据:手机已连接家庭网络)
判断依据:
- 门锁记录显示张三于14:30通过指纹开门
- 路由器显示李四的手机已连接家庭网络
检测到访客时
根据检测,当前在家:
- 张三(家庭成员,置信度高)
- 访客1人(无法识别具体身份)
判断依据:
- 门锁记录显示张三于14:30进门
- 门锁记录显示有访客于15:00通过临时密码进门
无法确定时
根据现有设备数据,无法准确判断有哪些成员在家。
原因:
- 部分成员手机未在线
- 门锁记录未包含用户身份信息
建议:
- 在门锁上设置用户名称可提高识别准确性
- 确保家庭成员手机连接家庭网络
注意事项
- 隐私保护:仅提供成员姓名或昵称,不暴露详细信息
- 不确定性:当识别不确定性较高时,使用"可能"、"推测"等词语
- 数据时效性:说明识别结果基于的时间范围
- 设备要求:明确说明需要支持的设备才能进行人员识别
- 成员配置:成员-设备映射关系存储在
memberDeviceMap.json,首次配置后后续自动读取