# 智能小夜灯 Mini PDD

## 产品定位

智能小夜灯 Mini 是一款面向卧室、儿童房、走廊和床头场景的 App 可控小夜灯。

产品核心目标是让用户能够稳定、低打扰地控制小灯亮灭，并在离线、权限不足、配网失败等异常场景下获得明确反馈。

## 目标用户

- 需要夜间柔和照明的家庭用户
- 需要远程查看和控制小灯状态的家长
- 需要通过定时或自动化减少手动操作的用户
- 对复杂照明设置无强需求，只需要可靠亮灭控制的用户

## 核心场景

### 床头即时控制

用户睡前通过 App 或本体按键打开小灯，起床后关闭小灯。

### 夜间照明

用户在夜间短暂起身时打开小灯，避免强光刺激。

### 儿童房看护

家长可以远程查看小灯当前是否开启，并在需要时打开或关闭。

### 定时开关

用户设置固定时间自动开灯或关灯，例如每天 22:30 自动关闭。

### 自动化联动

用户可将小灯加入家庭场景，例如“回家后打开走廊小灯”或“睡眠模式关闭小灯”。

## 功能范围

### 包含能力

- App 查看小灯当前亮灭状态
- App 打开小灯
- App 关闭小灯
- 本体按键切换亮灭
- 定时打开
- 定时关闭
- 自动化场景打开或关闭
- 设备共享后的授权控制
- 离线状态展示
- 配网、重置、解绑后的重新添加
- OTA 升级期间的状态限制展示

### 不包含能力

- 不支持彩色灯光
- 不支持亮度调节
- 不支持色温调节
- 不支持音乐律动
- 不支持语音播报
- 不支持作为网关控制其他设备

## 设备形态与约束

### 物理形态

设备为插电式小夜灯，正面为白色柔光灯面，底部有一个本体按键，侧面有一枚蓝色状态指示灯。

### 安装与使用

- 适合插在卧室、儿童房、走廊、床头附近插座
- 不建议用于室外、浴室淋水区或高温封闭环境
- 用户应能在不打开 App 的情况下通过本体按键完成亮灭切换

### 产品约束

- 主灯仅表达照明亮灭，不承担复杂状态提示
- 蓝色状态指示灯仅用于配网、失败、重置等低频状态
- 夜间使用场景下，状态提示不得产生明显打扰
- 设备离线时，本体按键仍可用于本地亮灭控制

## 引用的通用规则

本产品引用的完整规则清单见 [引用规则清单](references.md)。

主要引用：

- [HMI 全局交互字典](../../domain/hmi-dictionary.md)
- [设备生命周期状态](../../domain/device-lifecycle.md)
- [通用配网体验规则](../../domain/networking.md)
- [App 设备控制规则](../../domain/app-device-control.md)
- [通用异常与告警规则](../../domain/alerts.md)

## 核心状态定义

### 未绑定

遵循 [出厂未绑定](../../domain/device-lifecycle.md#出厂未绑定)。

引用规则：DEVICE-UNBOUND

本产品表现：设备首次上电后进入可添加状态，蓝色状态指示灯慢闪。

### 配网中

遵循 [配网中](../../domain/device-lifecycle.md#配网中) 和 [进入配网](../../domain/networking.md#进入配网)。

引用规则：

- DEVICE-PAIRING
- NET-PAIRING-ENTER
- HMI-LIGHT-BLUE-SLOW

本产品表现：蓝色状态指示灯慢闪，主灯保持用户上一次可见状态。首次上电无历史状态时，主灯默认熄灭。

### 在线可控

遵循 [在线可控](../../domain/device-lifecycle.md#在线可控)。

引用规则：DEVICE-ONLINE-CONTROLLABLE

本产品表现：用户可通过 App、本体按键、定时和自动化控制小灯亮灭。

### 离线不可控

遵循 [离线不可控](../../domain/device-lifecycle.md#离线不可控) 和 [设备离线](../../domain/alerts.md#设备离线)。

引用规则：

- DEVICE-OFFLINE-UNCONTROLLABLE
- ALERT-DEVICE-OFFLINE
- APP-CONTROL-OFFLINE-LIMIT

本产品表现：App 展示设备离线，不允许用户误以为远程亮灭控制已生效。本体按键仍可控制小灯亮灭。

### OTA 升级限制

遵循 [OTA 升级限制](../../domain/device-lifecycle.md#ota-升级限制)。

引用规则：DEVICE-OTA-LIMITED

本产品表现：升级期间 App 展示升级中，亮灭控制入口临时限制。用户仍可通过断开电源停止照明，但 App 不将其展示为一次正常关闭操作。

## 亮灭控制规则

### App 打开小灯

引用规则：

- [白灯常亮](../../domain/hmi-dictionary.md#白灯常亮)：HMI-LIGHT-WHITE-ON
- [控制反馈](../../domain/app-device-control.md#控制反馈)：APP-CONTROL-FEEDBACK
- [控制状态一致](../../domain/app-device-control.md#控制状态一致)：APP-CONTROL-STATE-CONSISTENCY

产品定义：用户在 App 中点击开关打开小灯。

用户感知：App 开关进入开启状态，小灯亮起。

边界规则：

- 在线可控时，操作应进入成功、失败或处理中三种明确结果之一
- 设备离线时，遵循 [离线控制限制](../../domain/app-device-control.md#离线控制限制)
- 权限不足时，遵循 [权限不足](../../domain/app-device-control.md#权限不足)

### App 关闭小灯

引用规则：

- [白灯熄灭](../../domain/hmi-dictionary.md#白灯熄灭)：HMI-LIGHT-WHITE-OFF
- [控制反馈](../../domain/app-device-control.md#控制反馈)：APP-CONTROL-FEEDBACK
- [控制状态一致](../../domain/app-device-control.md#控制状态一致)：APP-CONTROL-STATE-CONSISTENCY

产品定义：用户在 App 中点击开关关闭小灯。

用户感知：App 开关进入关闭状态，小灯熄灭。

边界规则：

- 在线可控时，操作应进入成功、失败或处理中三种明确结果之一
- 设备离线时，App 不展示关闭已生效
- OTA 升级限制期间，App 展示控制暂不可用

### 本体按键切换亮灭

引用规则：

- [按键短按](../../domain/hmi-dictionary.md#按键短按)：HMI-BUTTON-SHORT-PRESS
- [多入口控制覆盖](../../domain/app-device-control.md#多入口控制覆盖)：APP-CONTROL-MULTI-ENTRY-SYNC

产品定义：用户短按设备底部按键，切换当前亮灭状态。

用户感知：灯灭时短按后点亮，灯亮时短按后熄灭。

边界规则：

- 在线可控时，App 应更新为本体按键后的最新状态
- 离线时，本体按键仍可使用，但 App 在恢复在线前不展示未经确认的新状态
- OTA 升级限制期间，短按控制是否可用以 App 当前展示限制为准

### 定时打开或关闭

引用规则：

- [控制反馈](../../domain/app-device-control.md#控制反馈)：APP-CONTROL-FEEDBACK
- [多入口控制覆盖](../../domain/app-device-control.md#多入口控制覆盖)：APP-CONTROL-MULTI-ENTRY-SYNC

产品定义：用户设置指定时间自动打开或关闭小灯。

用户感知：到达设定时间后，小灯根据定时规则改变亮灭状态。

边界规则：

- 如果设备在线，定时结果应成为最新设备状态
- 如果设备离线，App 应展示定时可能未执行或执行结果不可确认
- 如果多个定时在同一时间冲突，应以用户最近保存的有效定时为准

### 自动化场景控制

引用规则：

- [多入口控制覆盖](../../domain/app-device-control.md#多入口控制覆盖)：APP-CONTROL-MULTI-ENTRY-SYNC
- [控制状态一致](../../domain/app-device-control.md#控制状态一致)：APP-CONTROL-STATE-CONSISTENCY

产品定义：小灯可被用户创建的家庭场景或自动化规则打开或关闭。

用户感知：自动化触发后，小灯状态变化，App 设备页展示最新状态。

边界规则：

- 自动化结果与手动操作冲突时，以最后生效的操作为当前状态
- 用户手动关闭后，如果后续自动化再次打开，应展示为自动化触发后的最新状态
- 自动化执行失败时，遵循 [控制失败](../../domain/alerts.md#控制失败)

## 配网与重置

### 首次添加

遵循 [进入配网](../../domain/networking.md#进入配网)、[配网成功](../../domain/networking.md#配网成功)、[配网失败](../../domain/networking.md#配网失败) 和 [配网超时](../../domain/networking.md#配网超时)。

引用规则：

- NET-PAIRING-ENTER
- NET-PAIRING-SUCCESS
- NET-PAIRING-FAILED
- NET-PAIRING-TIMEOUT
- HMI-LIGHT-BLUE-SLOW
- HMI-LIGHT-BLUE-FAST-3

本产品表现：

- 首次上电后，蓝色状态指示灯慢闪
- 配网成功后，App 进入设备控制页
- 配网失败后，蓝色状态指示灯急闪三次，App 展示失败原因和重试入口
- 配网超时后，App 展示超时结果，设备回到可重新添加状态

### 设备重置

引用规则：

- [长按五秒](../../domain/hmi-dictionary.md#长按五秒)：HMI-BUTTON-LONG-PRESS-5S
- [进入配网](../../domain/networking.md#进入配网)：NET-PAIRING-ENTER

产品定义：用户长按本体按键 5 秒，使设备进入重新添加状态。

用户感知：蓝色状态指示灯慢闪，App 可重新发现设备。

差异说明：本产品长按 5 秒仅进入重新添加状态，不直接承诺清除 App 账号中的历史设备记录；解绑关系以 App 操作为准。

差异原因：避免用户误触后失去家庭共享和定时配置。

## 权限与共享

### 拥有者

产品定义：设备拥有者可查看、打开、关闭、设置定时、创建自动化、共享和解绑设备。

### 可控制共享用户

引用规则：

- [权限不足](../../domain/app-device-control.md#权限不足)：APP-CONTROL-PERMISSION-DENIED

产品定义：被授权控制的共享用户可查看、打开和关闭小灯。

限制：共享用户是否可编辑定时和自动化，由家庭权限设置决定。

### 只读共享用户

引用规则：

- [权限不足](../../domain/app-device-control.md#权限不足)：APP-CONTROL-PERMISSION-DENIED

产品定义：只读用户可查看小灯亮灭状态，但不能执行打开、关闭、定时或自动化操作。

用户感知：控制入口应展示为不可用或提示权限不足。

## 异常与边界场景

### 设备离线后用户尝试开灯

引用规则：

- [离线控制限制](../../domain/app-device-control.md#离线控制限制)：APP-CONTROL-OFFLINE-LIMIT
- [设备离线](../../domain/alerts.md#设备离线)：ALERT-DEVICE-OFFLINE

产品定义：App 不发送或不承诺立即生效的开灯结果。

用户感知：用户看到设备离线，并获得检查电源、网络或距离的提示。

### 设备离线期间本体按键开灯

引用规则：

- [按键短按](../../domain/hmi-dictionary.md#按键短按)：HMI-BUTTON-SHORT-PRESS
- [控制状态一致](../../domain/app-device-control.md#控制状态一致)：APP-CONTROL-STATE-CONSISTENCY

产品定义：用户仍可通过本体按键控制小灯。

用户感知：本地灯光立即变化；App 在设备恢复在线前不承诺展示最新状态。

### App 显示开灯处理中

引用规则：

- [控制反馈](../../domain/app-device-control.md#控制反馈)：APP-CONTROL-FEEDBACK

产品定义：用户发起开灯后，App 尚未确认结果。

用户感知：App 展示处理中，避免用户误以为操作已经成功或失败。

处理结果：

- 确认成功后展示开启
- 确认失败后展示失败原因和重试入口
- 结果不可确认时展示状态未知或离线

### 自动化与手动操作冲突

引用规则：

- [多入口控制覆盖](../../domain/app-device-control.md#多入口控制覆盖)：APP-CONTROL-MULTI-ENTRY-SYNC

产品定义：多个入口都能控制小灯时，以最后生效的控制结果作为当前状态。

示例：

- 22:30 定时关灯
- 用户 22:31 手动开灯
- 当前状态应为开启

### 设备过热保护

引用规则：

- [设备过热保护](../../domain/alerts.md#设备过热保护)：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 |