KremeCN
0144ea992c
## Summary - add a root README with project overview, setup, usage, architecture, security, and contribution guidance - replace stale planning and requirement notes with current 1.0 project overview - update architecture and hardware validation docs to match the implemented app - remove obsolete UI branch notes and the old Java/XML AsyncTask example - remove the superpowers documentation and move vendor ABSDK references into docs/vendor - preserve vendor Markdown and XLS content byte-for-byte ## Verification - Markdown relative links checked - vendor files verified as 100% Git renames - git diff --check passed - no application tests run; documentation-only change Reviewed-on: #15 Co-authored-by: KremeCN <3265494849@qq.com>
2.9 KiB
2.9 KiB
设备数据能力矩阵
本文记录正式版代码能够从领域端口获得、确认和持久化的数据能力。未列出的数据不得在界面、活动记录或自动化中以固定值、随机值、占位趋势或推测结果呈现。
| 能力 | ABox | 本地体验 | 界面与自动化策略 |
|---|---|---|---|
| 插座状态读取 | 支持 | 支持 | 展示已确认状态；可作为状态触发器或条件 |
| 插座开关控制 | 支持 | 支持 | 命令成功后回读；回读失败显示等待确认 |
| 温度当前读数 | 支持，字段可能缺失 | 支持 | 字段存在时展示；可作为触发器或条件 |
| 湿度当前读数 | 支持，字段可能缺失 | 支持 | 字段存在时展示；可作为触发器或条件 |
| 红外按键发送 | 支持 | 支持 | 只记录领域结果，不记录原始码值 |
| 红外按键学习 | 支持 | 支持 | 仅自定义遥控器使用，区分未学习、失败和完成 |
| 红外码下载 | 支持 | 支持 | 用于预置遥控器导入，保留逐项成功或失败 |
| 情景与自动化结果 | 支持 | 支持 | 记录情景及动作级结果 |
| 系统通知 | 支持，受通知权限影响 | 支持，受通知权限影响 | 权限缺失或系统拒绝时明确失败 |
| 活动记录 | App 本地持久化 | App 本地持久化 | 按 profile 隔离，支持分页读取 |
| 插座电压、电流、功率和电量 | 不可用 | 不可用 | 不渲染，不作为自动化数据源 |
| 插座倒计时 | 不可用 | 不可用 | 不渲染 |
| 插座与温湿度历史趋势 | 不可用 | 不可用 | 不生成伪历史图表 |
| 网关诊断延迟 | 不可用 | 不适用 | 不渲染 |
| Token 精确有效期 | 不可用 | 不适用 | 不展示倒计时或推测时间 |
状态确认
- 控制请求成功只表示网关接受了命令，不等于物理设备状态已经确认。
- 插座控制后必须回读状态；只有回读值与目标一致才显示确认成功。
- 设备断电、离线或无法读取时，不得在前端仅依据用户点击更新为开启或关闭。
- 温湿度单个字段缺失时保留另一个有效字段，两个字段都缺失时进入无数据状态。
自动化数据语义
- 温度、湿度和插座状态来自一次评估快照。
- 状态型触发器在“不匹配”到“匹配”的转换上触发，不会因持续满足而在每次轮询重复执行。
- 条件只决定一次已触发执行是否可以继续，不会单独启动自动化。
- 设备数据不可用时，对应触发器或条件为不可用，本轮不执行。
数据与隐私边界
- ABox 设备目录只保存用户确认的设备名称和类型；本地体验使用独立模拟目录。
- 两个 Provider 的设备状态、遥控器、情景和活动记录不可互换。
- 活动记录不得包含密码、Token、原始 SDK Map、完整响应文本或红外原始码值。
- 外部错误码可以在领域层脱敏后保留，用于区分认证、网络、离线和操作失败。