| name | miloco-home-profile |
| description | 家庭档案管理 — 当用户提到自己或家人的喜好、兴趣、习惯、身体状况、作息规律、家庭规则时激活，无论用户是否明确要求"记录"。也在用户修正已有记录、要求删除、或查询家庭档案时激活。 |
| metadata | {"author":"miloco","version":"5.1","date":"2026-06-12T00:00:00.000Z","openclaw":{"requires":{"bins":["miloco-cli"]}}} |
家庭档案管理
记录家庭档案的目的不是"存档"，而是让 miloco 越来越懂这家人——后续控制设备、给建议、写通知都会参考档案，贴合成员的偏好与习惯。所以记得准、记得全，比记得多更重要：脏数据（重复、过期、张冠李戴）会让后续操作变笨。
何时激活
主动场景：
- 用户明确告知家庭信息："我们家 3 室 1 厅"、"爸爸不喜欢灯太亮"、"晚上 10 点后不要播报"
- 用户查询家庭档案："查看家庭档案"、"我爸的作息是什么"
- 用户要求修改/删除记录
被动场景（对话中自然提及，无需用户说"记录"）：
- 用户提到自己的喜好/兴趣："我喜欢喝咖啡"、"我不喜欢太甜的"、"我最近在看《三体》"
- 用户提到家人的信息："我妈对花粉过敏"、"我爸每天早起跑步"、"弟弟喜欢打篮球"
- 用户提到生活习惯/规律："我一般 11 点睡"、"周末我们全家会一起吃早餐"
被动场景下，先完成用户当前请求的主要回答，然后静默写入档案（无需向用户确认）。
命令使用（必须遵守）
操作家庭档案使用 miloco-cli home-profile 命令，不要直接编辑 profile.md 文件：
miloco-cli home-profile list --target profile — 查看当前档案miloco-cli home-profile profile-write --ops '...' --user-edit — 写入/更新/删除条目miloco-cli home-profile commit — 提交保存
工作流
- 先拉全量档案（任何增删查改前必做）：执行
miloco-cli home-profile list --target profile。
家庭档案不再随系统提示词注入，必须每次现拉：写入要条目 id（merge / replace / delete 都要 id），不拉全量会写重复 / 改错条目，查询只凭记忆会漏答。每次都重新拉、不要复用上一轮输出（档案随时可能被其它 session 更新）。
- 判断意图：
- 查询 → 基于全量档案返回相关内容
- 更新（含被动记录）→ 进入写入流程
- 执行操作（执行
miloco-cli home-profile profile-write 并带 --user-edit）：
- 全新信息 → op
add，传入 entry
- 补充确认已有 → op
merge，传入 id
- 修正/更新已有 → op
replace，传入 id + entry
- 要求删除 → op
delete，传入 id
- 提交：执行
miloco-cli home-profile commit 保存
miloco-cli home-profile profile-write --user-edit --ops '[
{"op": "add", "entry": {"type": "member_preference", "subject_id": "<person_id 或留空>", "subject_name": "爸爸", "content": "喜欢 24°C 制冷", "evidence_log": ["2026-05-29 20:10: 用户告知爸爸偏好24度"]}}
]'
条目格式
entry 字段：
- type: 分类（类型枚举见下方）
- subject_id: member_* 类型优先绑定身份库 person_id（从
miloco-cli identity member list 查得）；其它类型留空
- subject_name: 关联主体显示名/兜底
- member_* → 成员名（如"爸爸"），多成员共同适用时 "shared"
- family → 固定 "shared"
- space/device → 空间名/设备名（如"主卧"、"小米空调"），通用信息 "general"
- content: 一句话描述
- confidence: 1.0（用户直接告知，带
--user-edit 时自动设定）
- source: "user_told"（带
--user-edit 时自动设定）
- evidence_log: ["YYYY-MM-DD HH:mm: 用户告知 <原话摘要>"]
type 分类
| type | 含义 | 示例 |
|---|
| member_persona | 成员画像（家庭角色、身份、外貌） | "爸爸是家里的主厨" |
| member_health | 体质健康（过敏、禁忌、慢性病） | "妈妈对花粉过敏" |
| member_routine | 日常习惯（作息、出行规律） | "爸爸通常 7:30 出门上班" |
| member_entertain | 娱乐习惯（观影、游戏、音乐） | "妈妈睡前听白噪音" |
| member_preference | 个人偏好（温度、光线、饮食） | "爸爸喜欢 24°C 制冷" |
| family | 全家共同遵守的规则/约定（仅规则，非家庭构成信息） | "22:00 后全屋静音"、"访客来访自动开走廊灯" |
| space | 空间环境（户型、朝向、动线） | "主卧空调出风口对床头" |
| device | 设备信息（常用功能、操作习惯） | "客厅空调制冷需 5 分钟达温" |
subject 命名规则
- member_ 类型*：
subject_id = 身份库 person_id（优先）；subject_name = 成员名（如"爸爸"），多成员共同适用时 subject_name = "shared" 且 subject_id 留空
- family 类型：
subject_name 固定为 "shared"（家庭规则天然多主体）
- space/device 类型：
subject_name = 空间名或设备名（如"主卧"、"小米空调"），通用信息 subject_name = "general"
宠物与家庭构成归类（避免误入 family）
family 只指"全家共同遵守的规则/约定"，不是家庭相关信息的兜底类。以下两类常被误塞进 family，各有归处：
宠物 — 视为非人成员主体（不进人身份库、不走人脸识别）。先查开关 miloco-cli config get features.pet_recognition --value-only（输出 True / False），按开 / 关分流：
- 开 → 提到新宠物先建花名册
miloco-cli pet add --name <宠物名> --species <猫/狗/其他> 拿 pet_id；各维度按 member_* 写入，subject_id = 该 pet_id、subject_name = 宠物名。
- 关 → 花名册端点不可用，不建花名册；宠物事实照记：
member_*、subject_id 留空、subject_name = 宠物名（纯家庭事实、一直可见；日后开启并注册后 commit 会按名收敛回 pet_id）。
- "养了只小狗旺财" →
member_persona（开：subject_id=<pet_id> / 关：subject_id 留空，subject_name="旺财"）
- "旺财每天傍晚要遛" →
member_routine（subject_id / subject_name 同上）
- 外观写
member_persona：按「物种 → 体型 → 主毛色/花纹 → 毛长 → 显著标记」凝成一句（如"中等体型的黑色短毛英短猫，尾巴尖一撮白毛"），供感知在画面中区分与称呼；把握不大的维度（如品种）宁可不写。
- 用户想专门登记这只宠物（描述它的样子 或 附照片/视频）→ 走
miloco-miot-pet-register skill（对话端到端注册：文字通路建壳+外观 / 素材通路再加识别参照，均确认后落库），或引导 web「宠物」页「自动生成」。本 skill 处理的是泛档案里顺带提到的宠物事实（作息/习惯/健康 + 首次提及建壳）——顺带遇到的纯文字外观也可直接写 member_persona。
家庭构成 / 成员关系（家里几口人、谁是谁的什么人）→ member_persona，subject_name 为对应成员；全家整体构成用 subject_name="shared"。
写入原则
- 只写持久知识：习惯、偏好、规则、空间特征
- 不写临时状态："爸爸今天还没回来"不写，"爸爸通常 18:00 回家"写
- 精简表达：每条 content 简洁明了，不加冗余修饰
- 安全过滤：不记录密码、证件号、银行卡、API Key 等敏感信息
