miloco-overview

name	miloco-overview
description	Xiaomi Miloco 米家智能家居能力总览与适配说明。当用户提到米家/小米设备、家庭场景、家人身份、家庭事件/告警、自动化/任务、家庭档案/习惯、感知范围、主动通知时加载本 skill，了解 Miloco 全部能力以及它们在 SSR 中对应的 miloco_* 工具。
metadata	{"author":"ssr-miloco","version":"1.0"}

Miloco 能力总览（SSR 适配）

SSR 通过原生集成 Xiaomi Miloco 接入米家。 本仓库已把 Miloco 官方 plugins/skills 下的全部技能文档纳入知识库（miloco-* skills），它们描述了 Miloco 的完整能力与判断逻辑。

重要适配说明：官方技能是为 OpenClaw 写的，正文里大量使用 miloco-cli ... 命令行。在 SSR 中：

• 优先使用下面的 miloco_* 工具（直接走 Miloco 的本地 REST API，无需 miloco-cli）。
• 仅当环境里确实安装了 miloco-cli（例如与 Miloco 同机）时，才用 run_command 执行官方技能里的 miloco-cli 命令；在 ssr-miloco 的 Docker 部署里 ssr 容器没有 miloco-cli，请一律用 miloco_* 工具。
• 把官方技能当作「能力说明书 + 判断准则」来读，把其中的 miloco-cli <子命令> 映射成对应的 miloco_* 工具调用。

能力 → SSR 工具映射

Miloco 能力（官方 skill）	SSR 工具
连通性 / 账号绑定 / 运维（miloco-miot-admin）	miloco_status、miloco_refresh
设备查询/控制（miloco-devices）	miloco_devices、miloco_device_status、miloco_device_spec、miloco_device_control
触发场景（miloco-devices 场景部分）	miloco_trigger_scene
摄像头列表	miloco_cameras
家庭成员档案 CRUD（miloco-miot-identity）	miloco_family（读取；增删改名走 Miloco 端）
身份样本注册/录脸（miloco-miot-identity-register）	需上传图像，走 Miloco 端/ miloco-cli（SSR 暂只读 miloco_family）
家庭事件/感知回顾（miloco-perception, events）	miloco_activities，并订阅总线 miloco.activity.**
自动化规则（rule）	miloco_automations
持续家庭任务（miloco-create-task, terminate-task）	miloco_tasks（读取；增删走 Miloco 端）
家庭档案/长期记忆（miloco-home-profile, habit-suggest）	miloco_home_profile
感知范围：家庭/摄像头（miloco-miot-scope）	miloco_scope
主动通知 TTS/IM/米家推送（miloco-notify）	miloco_notify（也可用 SSR 自带 push_notification）
一次性快照进上下文	miloco_sync（设备/摄像头/成员/事件/规则/任务/家庭档案/感知范围）

事件驱动（总线）

Miloco 的家庭事件（Activity）会被 SSR 桥接为总线事件 miloco.activity.<type>。要「当家里发生 X 时自动做 Y」，用 bus_create_handler 订阅 miloco.activity.**（或更具体的子主题），在处理器里调用上面的工具或 push_notification 主动触达。

未覆盖/受限能力（需 Miloco 端或 miloco-cli）

• 身份样本注册（录脸/录身形）：需要上传图像/视频帧，SSR 暂未封装，请走 Miloco 仪表盘或 miloco-cli（见 miloco-miot-identity-register skill）。
• 成员/任务/规则/家庭档案的写操作：SSR 目前以读取 + 设备控制 + 触发场景 + 主动通知为主；档案写入、任务创建/删除、规则增删请走 Miloco 端能力（官方 skill 里的 miloco-cli 命令）或后续在 SSR 中补充对应工具。