添加示例文件

2026-06-09 23:04:53 +08:00
parent ce8486d452
commit ac39cde79f
11 changed files with 1032 additions and 0 deletions
--- a/docs/domain/hmi-dictionary.md
+++ b/docs/domain/hmi-dictionary.md
@@ -0,0 +1,128 @@
+# HMI 全局交互字典
+
+本文档定义无屏 IoT 设备常用的指示灯、按键和本体反馈语言。
+
+## 适用范围
+
+适用于具备本体按键、指示灯或简单反馈能力的无屏设备。
+
+## 规则列表
+
+### 白灯常亮
+
+规则编号：HMI-LIGHT-WHITE-ON
+
+适用范围：具备白色照明能力的灯类设备。
+
+产品定义：主灯处于开启状态。
+
+用户感知：用户可以直接看到设备发光。
+
+触发条件：用户通过 App、本体按键、自动化、定时或其他被授权入口打开设备。
+
+例外情况：设备进入故障保护、断电、离线不可控或 OTA 升级限制状态时，主灯表现以对应规则为准。
+
+被引用产品：
+
+- [智能小夜灯 Mini PDD](../products/smart-lamp-mini/pdd.md)
+
+### 白灯熄灭
+
+规则编号：HMI-LIGHT-WHITE-OFF
+
+适用范围：具备白色照明能力的灯类设备。
+
+产品定义：主灯处于关闭状态。
+
+用户感知：用户可以直接看到设备不发光。
+
+触发条件：用户通过 App、本体按键、自动化、定时或其他被授权入口关闭设备。
+
+例外情况：设备断电时不等同于用户主动关闭，App 应根据设备状态区分展示。
+
+被引用产品：
+
+- [智能小夜灯 Mini PDD](../products/smart-lamp-mini/pdd.md)
+
+### 蓝灯慢闪
+
+规则编号：HMI-LIGHT-BLUE-SLOW
+
+适用范围：具备蓝色状态指示灯的无屏设备。
+
+产品定义：设备正在等待配网或绑定。
+
+用户感知：用户可通过 App 搜索并绑定设备。
+
+触发条件：设备进入配网状态。
+
+例外情况：不具备独立状态指示灯的设备，应在单品 PDD 中定义替代体验。
+
+被引用产品：
+
+- [智能小夜灯 Mini PDD](../products/smart-lamp-mini/pdd.md)
+
+### 蓝灯急闪三次
+
+规则编号：HMI-LIGHT-BLUE-FAST-3
+
+适用范围：具备蓝色状态指示灯的无屏设备。
+
+产品定义：设备配网或绑定失败。
+
+用户感知：用户可感知当前操作未成功，需要回到 App 查看失败原因并重试。
+
+触发条件：配网失败、绑定失败或用户主动取消配网。
+
+例外情况：失败原因需要由 App 展示，不应仅依赖指示灯表达。
+
+被引用产品：
+
+- [智能小夜灯 Mini PDD](../products/smart-lamp-mini/pdd.md)
+
+### 按键短按
+
+规则编号：HMI-BUTTON-SHORT-PRESS
+
+适用范围：具备单个本体按键的设备。
+
+产品定义：用户进行一次短时按压，用于触发设备最常用的即时操作。
+
+用户感知：设备应在短按后立即给出可见或可感知反馈。
+
+触发条件：用户短按设备按键。
+
+例外情况：设备处于配网、OTA、故障保护等限制状态时，应在单品 PDD 中说明短按是否可用。
+
+被引用产品：
+
+- [智能小夜灯 Mini PDD](../products/smart-lamp-mini/pdd.md)
+
+### 长按五秒
+
+规则编号：HMI-BUTTON-LONG-PRESS-5S
+
+适用范围：具备本体按键且支持重置的设备。
+
+产品定义：用户长按按键 5 秒，用于触发设备重置或进入配网准备状态。
+
+用户感知：设备进入可重新绑定或重新配网的状态。
+
+触发条件：用户连续按住设备按键达到 5 秒。
+
+例外情况：是否清除已有绑定关系，由对应产品的绑定规则或单品 PDD 定义。
+
+被引用产品：
+
+- [智能小夜灯 Mini PDD](../products/smart-lamp-mini/pdd.md)
+
+## 版本记录
+
+| 日期 | 规则编号 | 变更 |
+| --- | --- | --- |
+| 2026-06-09 | HMI-LIGHT-WHITE-ON | 新增灯类设备主灯开启规则 |
+| 2026-06-09 | HMI-LIGHT-WHITE-OFF | 新增灯类设备主灯关闭规则 |
+| 2026-06-09 | HMI-LIGHT-BLUE-SLOW | 新增配网等待状态规则 |
+| 2026-06-09 | HMI-LIGHT-BLUE-FAST-3 | 新增配网失败反馈规则 |
+| 2026-06-09 | HMI-BUTTON-SHORT-PRESS | 新增短按规则 |
+| 2026-06-09 | HMI-BUTTON-LONG-PRESS-5S | 新增长按五秒规则 |