米家极客版小白教学

解决什么问题

米家极客版的自动化规则需要用户理解触发器、条件、动作、变量等概念，并手动拼装 JSON。零基础用户常遇到的典型困境：

• 能用生活语言描述需求（"人来了开灯"），但不知道如何翻译成规则结构
• 分不清需要哪些传感器、什么是 did、去哪查设备信息
• 容易把"条件"当成触发器，写出永远不会执行的规则
• 盲目导入可能全量覆盖已有规则，造成配置丢失

核心能力与工作流程

触发信号识别：当用户提出入门问题（"怎么用极客版"）、用生活化语言描述需求，或表现出困惑时，主动加载本教学剧本。

概念讲解：全程用生活类比替代术语——触发器是"门铃响了"，条件是"开门前看猫眼"，变量是"冰箱上的便签条"，latch 是"每个人记着自己上次说了啥"。每个概念讲完后让用户复述确认，一次只讲一个，不一次性倾倒全部概念。

结构化需求收集：把用户需求收敛为三个问题——什么时候触发、有什么附加条件、做什么动作，并用用户的原话复述一遍来确认（"所以你的需求是：有人进走廊 → 如果天暗 → 开走廊灯，对吗？"）。

范式选择与规则生成：从 8 个预置范式（进门开灯、时段门禁、过路人防抖等）中选组合，用 mijia_rule_kit 生成规则 JSON。关键点：did 必须来自用户提供的真实备份，严禁虚构；auto_layout() 要在 build_rule() 之前调用；validate(raise_on_error=True) 确保链路完整。

打包与导入：用 pack_bak() 或 bak-pack.ps1 打包为 .bak，提醒用户打开极客版控制台，有浏览器工具时可自动导入，导入后务必进编辑器确认规则正常渲染。

迭代改进：跑通后再问用户要不要加时段限制（P3）、防误触延时（P5）、多传感器覆盖（P4）、语音播报确认（P7）。

适用边界与注意点

• 先做最小可跑版，再逐步迭代，不要第一版就追求覆盖所有边缘情况
• 任何导入前都要导出备份——极客版导入是全量覆盖
• 触发器是必需的：光照度变化本身不会触发规则，必须有一个事件"叫醒"它
• 条件不能自己触发自己，这是新手最常见的死循环来源
• 复杂场景（多规则编排、.bak 解包、执行日志验证）应衔接 mijia-geek-rule、mijia-geek-backup、mijia-geek-console 三个进阶技能