家庭档案管理

记录家庭档案的目的不是"存档"，而是让 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 — 提交保存

工作流

1. 先拉全量档案（任何增删查改前必做）：执行 miloco-cli home-profile list --target profile。

   家庭档案不再随系统提示词注入，必须每次现拉：写入要条目 id（merge / replace / delete 都要 id），不拉全量会写重复 / 改错条目，查询只凭记忆会漏答。每次都重新拉、不要复用上一轮输出（档案随时可能被其它 session 更新）。

2. 判断意图：
   • 查询 → 基于全量档案返回相关内容
   • 更新（含被动记录）→ 进入写入流程
3. 执行操作（执行 miloco-cli home-profile profile-write 并带 --user-edit）：
   • 全新信息 → op add，传入 entry
   • 补充确认已有 → op merge，传入 id
   • 修正/更新已有 → op replace，传入 id + entry
   • 要求删除 → op delete，传入 id
4. 提交：执行 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 分类

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 等敏感信息