SLEEP SYSTEM V1 · DEVELOPMENT ROADMAP
睡眠系统 V1
整体开发规划与当前进度
基础架构 · 设备接入 · 睡眠功能 · 交互体验 · 系统交付
当前结论：基础架构、开发工具链、TWBAG 蓝牙协议库和 BLE 会话管理的离线开发已完成主要工作，正在从“离线代码验证”向“网关集成与真实设备测试”过渡。
一、整个系统的开发总规划
当前阶段：第 2 阶段（设备接入）
01
基础架构
已完成
02
设备接入
进行中
03
睡眠功能
待开发
04
交互体验
待开发
05
测试交付
待开发
阶段位置示意，因为环节工作量不同，进度工作不代表项目已完成百分比的开发工作量。
| 阶段 | 核心开发内容 | 当前状态 |
|---|---|---|
| 1. 基础架构 | 网关+HA中心系统架构、协议分层、GitHub版本管理、开发规则、CI、远程调试环境 | 基本完成 |
| 2. 设备接入 | 蓝牙、KNX、RS485、Zigbee 等设备接入，需要实际测试，开发人员知道产品具体怎么使用 | 进行中 |
| 3. 智能睡眠功能 | 睡眠模式、场景联动、定时、自动化、状态管理 | 尚未正式开发 |
| 4. 交互体验 | HA 仪表盘、APP、手机、平板、电视、设备界面 | 尚未形成完整交付 |
| 5. 系统交付 | 集成测试、可靠性、安全验收、备份恢复、版本发布 | 持续准备，正式验收未开始 |
这里“基本完成”指基础建设能够支撑开发，不表示之后无需维护。
二、各模块详细开发规划表
状态依据：2026 年 10 月 15 日核对的 GitHub 记录以及之前的实机环境检查；未来模块排序属于建议，不代表全部任务已经批准。
| 编号 | 开发模块 | 当前状态 | 下一交付目标 |
|---|---|---|---|
| A01 | 系统架构建立 | 已完成核查 | 持续维护更新架构，并完善记录 |
| A02 | 网关和HA基础环境搭建，通讯协议规则 | 已验证 | 持续维护环境记录，协同通讯维护 |
| A03 | GitHub、演示版本和正式版本协作与审核规则 | 已建立 | 按 PR 流程执行 |
| A04 | Python、pytest、Ruff、mypy、CI | 已验收 | 持续回归测试 |
| B01 | 蓝牙智能床协议评估 | 技术审核通过 | 核对 TASK-0001 最终验收记录 |
| B02 | 蓝牙TWBAG 纯 Python 协议库 | 已验收 | 保持协议库稳定，以后TWBAG是葛浩版智能床，后续是天津版智能床 |
| B03 | TWBAG BLE 连接与会话管理 | 代码已合并 | 验证实机行为 |
| B04 | TWBAG 实际蓝牙通信测试 | 下一重点 | 真实连接、通知、断线与恢复测试 |
| B05 | TWBAG HA 自定义集成 | 待开发 | 设备发现、配置、生命周期、实体 |
| B06 | TWBAG 只读 MVP 验收 | 待开发 | HA 显示真实设备状态 |
| B07 | TWBAG 控制功能 | 待安全评估 | 单独确认控制协议及安全条件 |
| B08 | GN11 蓝牙设备接入 | 待开发 | 分析 GN11 协议，独立驱动 |
| B09 | Zigbee 接入 | 待硬件 | 采购协调器、选择后端、设备联调 |
| B10 | HA 独立 RS485 接入 | 待联调 | USB-RS485 适配器和设备协议验证 |
| B11 | 网关设备与HA设备联调测试 | 待联调 | HA KNX 通信、组地址与 DPT 验证 |
| C01 | 设备统一管理与状态表达 | 架构已确定 | 复用网关设备集成协议，标准设备、实体、状态机制 |
| C02 | 多设备场景与自动化 | 待开发 | 利用HA原生自动化+网关实现已确认场景 |
| D01 | 手机、电脑、电视端界面 | 待开发 | 基于 HA 构建与验收仪表盘 |
| E01 | 多协议集成回归测试 | 待开发 | 故障隔离、兼容性、稳定性 |
| E02 | 备份恢复与交付 | 部分准备 | 完整备份、恢复演练、发布文档 |
模块现状说明：KNX 网关本身已经完成，新接口开发中，HA 已成功接入的标准是可稳定接入和控制；Zigbee 协调器已经采购；RS485 已确定采用 HA 独立 USB-RS485 路径，但尚未实机验收。睡眠监测算法、睡眠评分、自动调床等默认是厂家提供功能，系统只提供收集和显示。
三、现在智能床开发阶段
TASK-0001：程序评估和架构设计待最终验收
完成两轮技术审核；仓库任务文档仍标记待最终验收，原因是：设备还未完全有协议对接，可能存在变化。
TASK-0002：开发工具链已完成
PR #6 合并，CI 通过。
TASK-0003：TWBAG 纯 Python 协议库已完成
PR #7 合并，491 项测试通过。
TASK-0004：BLE 会话管理已合并
PR #10 合并，666 项离线测试通过；包含连接状态机、重连、通知订阅、资源释放保护；尚缺实机验证，最终任务验收记录需核对。
当前关卡：真实 BLE 设备测试准备进入
验证真实连接、FFE4 状态通知、断线恢复，以及不会产生重叠连接。只读阶段禁止 FFE9 应用层写入。
TASK-0005：Home Assistant 正式集成下一开发任务
将 BLE 设备层接入 HA，完成配置流程、设备与实体、状态刷新及 unload/reload 生命周期管理。
关键遗留事项：TASK-0005 必须处理 HA 重新加载前后的 BLE 连接所有权问题，避免新旧设备对象对同一蓝牙地址建立重叠连接。这是 PR #10 记录的后续验收条件。
四、后续开发顺序（草稿版）
| 优先级 | 开发目标 | 备注 |
|---|---|---|
| P0 | TWBAG 只读实机测试 | 验证已经写好的协议库与 BLE 连接代码 |
| P0 | TWBAG HA 只读集成 | 形成第一款真正运行在 HA 中的新架构设备 |
| P1 | GN11 BLE 集成 | 验证多品牌 BLE 架构能否复用 |
| P1 | KNX 网关 HA 接入 | 网关硬件已有基础 |
| P1 | HA 独立 RS485 | 验证第四种设备接入之外的独立串口路径 |
| P2 | Zigbee | 依赖协调器采购及后端选择 |
| P2 | HA 界面与跨设备场景 | 根据已接入的真实设备完善 |
| P3 | 全系统回归、稳定性和 V1 交付 | 所有正式范围确定后统一验收 |
实际顺序可以根据设备到货、开发难度和优先使用的功能调整，不需严格串行；但每个模块都应独立审核与验收。
五、现在做的事情
- 完成 TWBAG 真实 BLE 只读测试。 结合已准备的实机环境，先验证连接和状态通知，不直接开放尚未验收的控制命令。
- 完成 TASK-0005 的正式设计与开发授权。 把协议库、BLE 会话层接入 Home Assistant，建立真正的设备和实体。
- 完成第一款新架构设备的 HA 实机验收。 包括安装、卸载、重新加载、断线重连、历史实体兼容以及备份恢复。
完成这三项，才意味着从“有代码”推进到“第一款可实际运行、可测试、可维护的睡眠设备集成”。
六、整体进度怎样评价？
目前处于“基础设施基本建成，首款设备驱动离线开发完成，正在进行第一款 HA 实机集成”的阶段。
现在还不能给出可靠的全项目完成百分比，因为 GN11、Zigbee、KNX、RS485 的实际接入工作量，以及最终 V1 功能范围尚未全部确定。工程上已跨过架构决策、工具链建设及第一款 BLE 设备底层代码开发的重要关卡。
里程碑：先把 TWBAG 智能床只读版本完整接入 HA 并完成实机验收，再把它作为 GN11 和其他设备接入的工程参考。让睡眠系统 V1 从“有架构、有底层代码”进入“有实际运行产品”。