13 KiB
智能小夜灯 Mini PDD
产品定位
智能小夜灯 Mini 是一款面向卧室、儿童房、走廊和床头场景的 App 可控小夜灯。
产品核心目标是让用户能够稳定、低打扰地控制小灯亮灭，并在离线、权限不足、配网失败等异常场景下获得明确反馈。
目标用户
- 需要夜间柔和照明的家庭用户
- 需要远程查看和控制小灯状态的家长
- 需要通过定时或自动化减少手动操作的用户
- 对复杂照明设置无强需求，只需要可靠亮灭控制的用户
核心场景
床头即时控制
用户睡前通过 App 或本体按键打开小灯，起床后关闭小灯。
夜间照明
用户在夜间短暂起身时打开小灯，避免强光刺激。
儿童房看护
家长可以远程查看小灯当前是否开启，并在需要时打开或关闭。
定时开关
用户设置固定时间自动开灯或关灯，例如每天 22:30 自动关闭。
自动化联动
用户可将小灯加入家庭场景，例如“回家后打开走廊小灯”或“睡眠模式关闭小灯”。
功能范围
包含能力
- App 查看小灯当前亮灭状态
- App 打开小灯
- App 关闭小灯
- 本体按键切换亮灭
- 定时打开
- 定时关闭
- 自动化场景打开或关闭
- 设备共享后的授权控制
- 离线状态展示
- 配网、重置、解绑后的重新添加
- OTA 升级期间的状态限制展示
不包含能力
- 不支持彩色灯光
- 不支持亮度调节
- 不支持色温调节
- 不支持音乐律动
- 不支持语音播报
- 不支持作为网关控制其他设备
设备形态与约束
物理形态
设备为插电式小夜灯，正面为白色柔光灯面，底部有一个本体按键，侧面有一枚蓝色状态指示灯。
安装与使用
- 适合插在卧室、儿童房、走廊、床头附近插座
- 不建议用于室外、浴室淋水区或高温封闭环境
- 用户应能在不打开 App 的情况下通过本体按键完成亮灭切换
产品约束
- 主灯仅表达照明亮灭，不承担复杂状态提示
- 蓝色状态指示灯仅用于配网、失败、重置等低频状态
- 夜间使用场景下，状态提示不得产生明显打扰
- 设备离线时，本体按键仍可用于本地亮灭控制
引用的通用规则
本产品引用的完整规则清单见 引用规则清单。
主要引用：
核心状态定义
未绑定
遵循 出厂未绑定。
引用规则：DEVICE-UNBOUND
本产品表现：设备首次上电后进入可添加状态，蓝色状态指示灯慢闪。
配网中
引用规则：
- DEVICE-PAIRING
- NET-PAIRING-ENTER
- HMI-LIGHT-BLUE-SLOW
本产品表现：蓝色状态指示灯慢闪，主灯保持用户上一次可见状态。首次上电无历史状态时，主灯默认熄灭。
在线可控
遵循 在线可控。
引用规则：DEVICE-ONLINE-CONTROLLABLE
本产品表现：用户可通过 App、本体按键、定时和自动化控制小灯亮灭。
离线不可控
引用规则：
- DEVICE-OFFLINE-UNCONTROLLABLE
- ALERT-DEVICE-OFFLINE
- APP-CONTROL-OFFLINE-LIMIT
本产品表现：App 展示设备离线，不允许用户误以为远程亮灭控制已生效。本体按键仍可控制小灯亮灭。
OTA 升级限制
遵循 OTA 升级限制。
引用规则：DEVICE-OTA-LIMITED
本产品表现：升级期间 App 展示升级中，亮灭控制入口临时限制。用户仍可通过断开电源停止照明，但 App 不将其展示为一次正常关闭操作。
亮灭控制规则
App 打开小灯
引用规则：
产品定义：用户在 App 中点击开关打开小灯。
用户感知：App 开关进入开启状态，小灯亮起。
边界规则：
App 关闭小灯
引用规则：
产品定义：用户在 App 中点击开关关闭小灯。
用户感知：App 开关进入关闭状态，小灯熄灭。
边界规则：
- 在线可控时，操作应进入成功、失败或处理中三种明确结果之一
- 设备离线时，App 不展示关闭已生效
- OTA 升级限制期间，App 展示控制暂不可用
本体按键切换亮灭
引用规则：
产品定义：用户短按设备底部按键，切换当前亮灭状态。
用户感知：灯灭时短按后点亮，灯亮时短按后熄灭。
边界规则：
- 在线可控时，App 应更新为本体按键后的最新状态
- 离线时，本体按键仍可使用，但 App 在恢复在线前不展示未经确认的新状态
- OTA 升级限制期间，短按控制是否可用以 App 当前展示限制为准
定时打开或关闭
引用规则：
产品定义：用户设置指定时间自动打开或关闭小灯。
用户感知：到达设定时间后，小灯根据定时规则改变亮灭状态。
边界规则：
- 如果设备在线，定时结果应成为最新设备状态
- 如果设备离线，App 应展示定时可能未执行或执行结果不可确认
- 如果多个定时在同一时间冲突，应以用户最近保存的有效定时为准
自动化场景控制
引用规则：
产品定义：小灯可被用户创建的家庭场景或自动化规则打开或关闭。
用户感知：自动化触发后，小灯状态变化，App 设备页展示最新状态。
边界规则：
- 自动化结果与手动操作冲突时，以最后生效的操作为当前状态
- 用户手动关闭后，如果后续自动化再次打开，应展示为自动化触发后的最新状态
- 自动化执行失败时，遵循 控制失败
配网与重置
首次添加
引用规则：
- NET-PAIRING-ENTER
- NET-PAIRING-SUCCESS
- NET-PAIRING-FAILED
- NET-PAIRING-TIMEOUT
- HMI-LIGHT-BLUE-SLOW
- HMI-LIGHT-BLUE-FAST-3
本产品表现：
- 首次上电后，蓝色状态指示灯慢闪
- 配网成功后，App 进入设备控制页
- 配网失败后，蓝色状态指示灯急闪三次，App 展示失败原因和重试入口
- 配网超时后，App 展示超时结果，设备回到可重新添加状态
设备重置
引用规则：
产品定义：用户长按本体按键 5 秒，使设备进入重新添加状态。
用户感知：蓝色状态指示灯慢闪，App 可重新发现设备。
差异说明：本产品长按 5 秒仅进入重新添加状态，不直接承诺清除 App 账号中的历史设备记录；解绑关系以 App 操作为准。
差异原因：避免用户误触后失去家庭共享和定时配置。
权限与共享
拥有者
产品定义：设备拥有者可查看、打开、关闭、设置定时、创建自动化、共享和解绑设备。
可控制共享用户
引用规则：
- 权限不足：APP-CONTROL-PERMISSION-DENIED
产品定义：被授权控制的共享用户可查看、打开和关闭小灯。
限制：共享用户是否可编辑定时和自动化，由家庭权限设置决定。
只读共享用户
引用规则：
- 权限不足：APP-CONTROL-PERMISSION-DENIED
产品定义：只读用户可查看小灯亮灭状态，但不能执行打开、关闭、定时或自动化操作。
用户感知：控制入口应展示为不可用或提示权限不足。
异常与边界场景
设备离线后用户尝试开灯
引用规则：
产品定义：App 不发送或不承诺立即生效的开灯结果。
用户感知：用户看到设备离线，并获得检查电源、网络或距离的提示。
设备离线期间本体按键开灯
引用规则：
产品定义：用户仍可通过本体按键控制小灯。
用户感知：本地灯光立即变化；App 在设备恢复在线前不承诺展示最新状态。
App 显示开灯处理中
引用规则：
- 控制反馈：APP-CONTROL-FEEDBACK
产品定义：用户发起开灯后，App 尚未确认结果。
用户感知：App 展示处理中，避免用户误以为操作已经成功或失败。
处理结果：
- 确认成功后展示开启
- 确认失败后展示失败原因和重试入口
- 结果不可确认时展示状态未知或离线
自动化与手动操作冲突
引用规则：
- 多入口控制覆盖：APP-CONTROL-MULTI-ENTRY-SYNC
产品定义：多个入口都能控制小灯时，以最后生效的控制结果作为当前状态。
示例：
- 22:30 定时关灯
- 用户 22:31 手动开灯
- 当前状态应为开启
设备过热保护
引用规则：
- 设备过热保护：ALERT-OVERHEAT-PROTECTION
产品定义：设备进入保护状态时，App 限制继续开灯。
用户感知：App 展示保护中，提示用户等待恢复或检查环境。
差异说明：本产品属于低功率小夜灯，过热保护为低概率异常，但仍作为安全边界保留。
App 页面信息要求
设备卡片
应展示：
- 设备名称
- 当前亮灭状态
- 在线或离线状态
- 快捷开关入口
不应展示：
- 技术连接状态细节
- 用户无法理解的错误码
- 与亮灭无关的复杂参数
设备详情页
应展示：
- 主开关
- 当前状态
- 定时入口
- 自动化入口
- 共享与权限入口
- 设备信息入口
异常状态下应展示：
- 离线提示
- 控制失败提示
- OTA 升级中提示
- 权限不足提示
通用规则差异
主灯不承载状态提示
通用规则：HMI-LIGHT-WHITE-ON、HMI-LIGHT-WHITE-OFF
差异说明：本产品主灯仅表达照明亮灭，不用于表达配网、失败或告警。
差异原因：小夜灯主要用于夜间照明，主灯闪烁会打扰用户。
替代体验：状态提示由蓝色状态指示灯和 App 文案承担。
离线时保留本体控制
通用规则：DEVICE-OFFLINE-UNCONTROLLABLE、APP-CONTROL-OFFLINE-LIMIT
差异说明：设备离线仅表示 App 远程控制不可用，不影响本体按键亮灭。
差异原因：小灯作为近距离照明设备，本地即时控制优先级高。
替代体验：App 展示离线，本体按键继续可用。
版本记录
| 日期 | 版本 | 变更 |
|---|---|---|
| 2026-06-09 | v0.1 | 新增智能小夜灯 Mini 示例 PDD |