SuperAPI AI 工具集

xgg-rule-authoring

通用与其它

查看项目

更新于 10-16 06:51

技能介绍

用途:把用户自然语言编译成小米中枢网关极客版的有向规则图,并支持通过 xgg 云端控制米家设备。

主要能力:扫码云端授权与网关六位码获取;设备发现与 spec 读取;typed 方式添加节点与边、rule layout 排布;rule new/node add/edge add,rule validate --spec-aware、rule lint --strict、rule view 校验;rule enable 后可用 rule logs、rule trace、变量与设备 readback 验证行为;内置 references 覆盖 graph-model、node-catalog、device-semantics、recipes、cloud-workflows、gateway-discovery、operations、habit-learning。更新检查用 xgg update --check 与 xgg update,可用 XGG_UPDATE_REGISTRY 指定源。

使用方式:先 xgg status、xgg device list、xgg device spec <did>、xgg rule list/view 查明事实;每批修改后依次执行 layout、validate、lint、view;默认先写 disabled,用户授权后再 enable 并取 logs/trace 证明。习惯学习按 learn plan → start(disabled)→ start --enable --plan-id → capture --follow → status → finish → profile 生命周期。

适用场景:米家设备云端读写观察、中枢网关自动化规则编写与调试、家庭习惯学习与画像、变量与表达式、日志 trace、备份恢复。

限制:规则 JSON 需以当前 xgg 校验为准,不能凭经验猜字段;静态 schema 不证明固件运行时序;--allow-no-push 仅限明确授权的隔离探针且不能作为生产验收;写入依赖 snapshot 与 enable 状态,登录码不得外泄,未知结果写入不自动重放。部分卡片行为与容量、价格、平台细节资料暂未提供。