v0.17.0 — 耗材跃迁推送

watch 现在每小时检查一次耗材,状态跃迁走完整通知管道:

• 恶化:"扫地机的耗材滤网不足了" → MeoW/Bark/ntfy/钉钉/飞书/音箱
• 恢复:换新耗材后 "刷头充足了" 闭环确认
• 事件进本地历史,query_history 可查"滤网什么时候耗尽的"
• --only/--ignore 过滤同样生效;耗材接口失败不影响设备监控

至此耗材信息三条通道齐了:专门问(list_consumables)、顺带看(快照 attention)、变化推(watch)。78 个测试全绿。

v0.16.0 — 耗材三态标识与提醒

list_consumables 从裸透传改为语义化:每条耗材给出 状态(充足/不足/耗尽)/设备/房间/剩余量,needs_attention 置顶该换的,按紧急度排序。get_home_snapshot 的 attention 新增 consumables——问"家里怎么样"时该换的耗材自动冒出来。

state 枚举无官方文档,由真实数据 + hass-xiaomi-miot#2422 抓包 + inadeq/exhaust 双阈值结构交叉验证:云端拿剩余量对"不足线/耗尽线"两条线,1/2/3 对应线上/线间/线下三个区间。

真实环境验证:8 条耗材,牙刷头 state=3 被正确标为耗尽并进入快照提醒。76 个测试全绿。

v0.15.0 — MCP resources

挂了三个 resource:

• mijia://devices — 设备清单,几乎不变,读取零成本
• mijia://homes — 家庭/房间结构
• mijia://snapshot — 实时快照(读取拉云端,30s 缓存)

OpenClaw 会把它们转成 resources_read 工具,Claude Code 里 @ 引用。默认家庭配置对 resources 同样生效。74 个测试全绿,真实环境验证(65 台设备/两个家庭)。

v0.13.0 + v0.14.0 — turn_on/off 快捷工具,Bark/ntfy 推送

v0.13.0

• turn_on / turn_off:开关是最高频操作,自动匹配 on/power/switch-status 属性,不用先查 spec;传感器类报可读错误,危险设备照走门控(借鉴 javen-yan/miot-mcp)

v0.14.0

• Bark(iOS)与 ntfy(安卓/桌面)推送通道,配合已有的 MeoW(鸿蒙),三端手机推送补齐
• device key / topic 即用,也支持自建服务器 URL
• MIJIA_HOME_MCP_BARK / MIJIA_HOME_MCP_NTFY,或 serve --bark/--ntfy

73 个离线测试全绿。

v0.12.0 — 多家庭账号锁定默认家庭

账号下有多个家庭时,可以锁定一个作为默认:

"env": { "MIJIA_HOME_MCP_HOME_NAME": "我的家" }

或 serve --home 我的家。锁定后所有工具(快照/diff/设备列表/电量/场景/耗材)不传 home 时只看这个家,显式传参仍可覆盖;CLI 的 watch/snapshot/battery 同样生效。auth_status 返回 default_home 便于确认。

实测(两个家庭的账号):锁定后不传参只拉 21 台,显式覆盖能看到另一家 44 台。70 个测试全绿。

v0.11.0 — 更新检查

• doctor 新增版本检查:对比 GitHub latest release,落后时给出 uvx --refresh 更新命令,网络失败静默跳过
• auth_status 返回 version 字段,MCP 对话里也能确认在跑哪个版本
• README(中英)补充更新方法与锁定 tag 的写法

更新本地缓存的命令:

uvx --refresh --from git+https://github.com/jiayunlimailutorontoca/mijia-home-mcp mijia-home-mcp --version

v0.9.0 + v0.10.0 — 事件历史、HTTP 鉴权、消息卡片、英文文档

v0.9.0 — 本地事件历史

• watch 与 get_home_changes 的每条变化落 JSONL(按天分文件,保留 30 天)
• 新增 query_history 工具:时间窗/设备 glob/属性 glob/类型过滤——AI 可以回��'今天门开过几次''洗衣机几点跑完'

v0.10.0 — HTTP Bearer 鉴权 + 消息卡片

• --http-token(或 MIJIA_HOME_MCP_HTTP_TOKEN):http 传输启用 Bearer 鉴权,端到端验证 401/200
• watch 变化事件:钉钉 markdown 卡片、飞书 interactive 卡片,逐条设备变化,超 10 条折叠
• 英文 README(README.en.md)

64 个离线测试全绿。

v0.7.0 — 通知通道配置化,send_notification 统一推送

通知从「命令行玩法」升级为「安装时声明、对话里直接用」:

在 .mcp.json 的 env 里配置通道:

"env": {
  "MIJIA_HOME_MCP_SPEAKER": "auto",
  "MIJIA_HOME_MCP_MEOW": "你的MeoW昵称",
  "MIJIA_HOME_MCP_FEISHU": "https://open.feishu.cn/...",
  "MIJIA_HOME_MCP_DINGTALK": "https://oapi.dingtalk.com/..."
}

Claude 里即出现 send_notification 工具:一次调用统一推送到全部通道(音箱播报 + 手机推送 + 群机器人同时到达),逐通道返回成败,单通道失败互不影响。未配置任何通道时工具不出现。

watch 未显式传参时自动复用同一套配置。52 个离线测试全绿,音箱通道真机验证。

v0.6.0 — 钉钉 / 飞书 / MeoW 推送

watch 推送通道从通用 webhook 扩展为四家,可任意组合:

• --dingtalk URL [--dingtalk-secret SEC...]:钉钉机器人,支持加签,校验业务错误码
• --feishu URL:飞书自定义机器人
• --meow 昵称:MeoW 鸿蒙系统级推送(昵称即用,也接受完整 URL)
• --webhook URL:通用 diff JSON(保持不变)

新增独立播报能力:

• 终端 mijia-home-mcp say "下楼取快递"
• MCP 工具 speaker_announce:纯 TTS(play-text),无指令执行能力,受普通设备门控

49 个离线测试全绿(三家推送格式经本地 HTTP 接收端逐一校验);say 已真机验证。

v0.5.0 — watch 通知:小爱播报 / webhook

watch 的变化事件现在可以推出去了:

• --speak:小爱音箱 TTS 播报(play-text 纯播报,刻意不用 execute-text-directive,不会触发任何指令执行)
• --webhook URL:diff JSON POST 到你的服务,text 字段是现成的一句话中文摘要,直接接 Bark/ntfy
• --only / --ignore(glob):噪音控制,比如 --ignore left-time 压掉洗碗机倒计时
• 通知失败只记录不中断监控

真机验证:音箱实际播报成功;webhook 本地接收端端到端通过。44 个离线测试全绿。