Skip to content

Latest commit

 

History

History
215 lines (178 loc) · 16.5 KB

roadmap.md

File metadata and controls

215 lines (178 loc) · 16.5 KB

开发计划

本文记录后续方向与已发布功能待补的专项验证。已发布功能见 CHANGELOG,已完成的实机验收见实机验证记录。

当前版本:v0.34.0

本版新增温湿度趋势、可选 SD 月度历史、普通偏好备份/恢复,改进设置保存;普通页面 同时短按 BOOT 和 KEY 可返回时钟,不停止音乐与计时。正常每 30 秒、省电每 60 秒采样, 5 分钟汇总,缺失区间留空。页面扩展到八项,升级保留原顺序并将环境追加末尾。 用户于 2026-10-14 确认 dev.4 整体使用正常并同意发布,正式版沿用同一功能源码。 真实断电、异常卡、长期运行和功耗专项仍需独立验证;实施、主机检查与发布记录见 v0.34.0 记录,不将整体反馈或软件故障注入等同于这些专项通过。

v0.33.0 记录:计时与图片取景

v0.33.0 新增计时页、浏览器图片铺满裁剪与拖动取景、日历未校时空态。 用户于 2026-10-03 确认 dev.2 整体使用正常并同意正式发布;操作以 dev.2 为基础。

倒计时与秒表独立、离线运行,切页继续,重启清除进度。网页独立保存 1–180 分钟时长; 开机后倒计时初始选择 5 分钟,选择态短按 KEY 循环 1/5/10/30 及不重复的网页 自定义值,最多五档;按住 KEY 2 秒开始。运行/暂停短按暂停/继续,长按重置回选择态并 保留本次所选时长;完成后短按仅回选择态。秒表操作不变。 新装门户自定义值默认 5 分钟,保存只更新候选,不改变当前选择或本次计时;schema 12 不变,用户旧 25 分钟或其他自定义值不改写,仍可作为第五档。 有声到期提醒沿用闹钟音量,停止正在播放的音乐且不自动恢复,0% 只显示视觉提醒、不调用 音频试听。RTC 闹钟优先,其他在途事务期间有界延后,60 秒后放弃过时通知。 图片原图及裁剪留在浏览器,底部 50 像素仍保留;日历空态不再遮住导航。

dev.2 的完整主机测试、构建与 Beta 公网校验记录保留。长期运行、真实断电迁移、 提醒与闹钟/音乐/AI/维护事务交接、不同浏览器触摸及日历无效日期等专项继续单独跟踪, 不因整体使用反馈自动标为逐项通过。范围、七页迁移及分版本构建与发布记录见 v0.33.0 记录。

v0.32.0 记录:对话与日常操作优化

功能页可在网页排序,时钟固定第一位;AI 增加五种音色、两种回答风格及失败后手动重试, 音乐上传队列可在当前网页恢复。天气与 AI 的普通设置可通过同 Wi-Fi 授权门户保存, 只有录入、更换 API Key 需要热点;不增加设备菜单或改变功耗规则。 用户于 2026-09-29 确认 dev.3 整体使用正常并同意发布。 长期运行、异常网络、断电迁移与上传恢复等专项实测继续跟踪,不以整体反馈代替逐项验证。 范围与记录见 v0.32.0 计划。

v0.31.0 记录:AI 模型迁移

AI 默认模型切换为 Audio 3,自动迁移旧配置并保留 Key、Host 与开关;完善错误提示、 门户最近对话结果和连接诊断,不增加菜单、唤醒词或自动收费测试。 用户在 dev.2 中完成新模型授权后确认对话恢复正常,并于 2026-09-28 同意发布。 模型授权与配置迁移是两件事,教程已补充对应步骤;长期会话、异常网络、断电迁移与资源 交接等专项验证继续跟踪,不将基本对话反馈记为所有场景通过。 范围、验证和发布记录见 v0.31.0 计划。

设置分工(已确认)

2026-09-27:v0.30.0 完成天气保存一致性、日常页面显隐与配套回归。 网页配置六个可选页面,保留固定顺序和时钟/维护入口;天气保存不关闭门户、不抢页面。 同日追加的音乐循环、定时停止与门户读取失败后的原地重试合并进 dev.2,获用户确认后正式发布; 设备端不增加菜单。范围与验收见 v0.30.0 计划。 温湿度历史已纳入 v0.34.0。歌曲上传队列恢复已纳入 v0.32.0。

2026-09-16:v0.29.0 市场看板按已确认范围发布,功能继续保留 Beta,默认关闭。 后续先验证不同网络和交易时段的表现,不增加任意股票代码、K 线、提醒或设备配置菜单。

v0.28.0 日常体验优化包括同 Wi-Fi 临时门户、批量顺序上传、音乐页与即时 音量试听、独立闹钟音量。实施、限制和待验证项统一记录在 v0.28.0 计划。 本版不改功耗策略、不加设备菜单,不把下面的实测工作标记为已完成。

2026-09-14 追加确认:Chat 归入功能页;设置页长按 KEY 2 秒直接打开网页,取消二级菜单。 网页分为常用、联网、媒体、维护。设备端只保留音乐页音量与手动提前省电,闹钟配置统一 交给网页。dev.2 修复 OTA 复用旧目标的问题;dev.3 调整设置页排版与字体,已纳入正式版。 后续已确认实施的固件改动,应先完成验证和 Beta OTA 准备,再通知用户测试; 提交、推送与正式发布仍等待确认。具体遵循 设置分工。

2026-09-05 撤回设备端闹钟调时的下一版建议:ALARM 只切换开关并显示已保存的规则, 时刻与重复日期继续在门户中编辑。该记录对应 v0.27.0,后续以 9 月 14 日的分工为准。

v0.27.0 记录:本地音乐与交互优化

2026-09-05 确认音乐、设备菜单和设置门户合并为一个版本。首版歌曲存放 microSD, 支持 MP3/PCM WAV、播放/暂停、下一首、后台播放和直接音量调整;无卡不影响其他功能。 菜单仍为四个系统页,复杂设置继续在门户,音乐不挤入系统菜单。 实施清单、验收和后续边界统一保存在 microSD 音乐播放。 同日补充:歌曲必须能在设置门户管理,本版纳入列表、手机/电脑上传、播放、停止与确认删除, 不要求用户反复取卡。dev.2 经用户确认后按相同功能源码发布;歌曲下载和更多格式放在后续评估, 本版不新增唤醒词、流媒体、闹钟调时菜单或图片轮播。

后续优先级

1. 启动恢复与 OTA 健康判定的专项验证

  • 同一应用镜像在 60 秒健康门槛前连续发生 3 次异常复位后,下一次启动进入恢复模式;开机 时按住 KEY 也可主动进入。计数只保存在 RTC 保留内存,正常断电、棕断、USB/JTAG 复位、已标记的更新重启和应用镜像变化不会把旧故障链带入下一次启动;
  • 恢复模式只初始化显示、按键、持久化设置、RTC、网络和固件更新所需基础服务,页面只保留 “在线更新”与“设置”。恢复门户仅提供 Wi-Fi 管理和本地 OTA,不启动天气、音频、 microSD、温湿度与闹钟等非恢复服务;
  • 待验证 OTA 只在正常模式确认显示和按键可用、完成首轮周期任务、成功显示页面并运行至少 15 秒后确认;确认失败每 5 秒重试。稳定运行满 60 秒才清除异常复位链,恢复模式自身不 确认待验证镜像;
  • v0.25.0 已发布上述实现,但仍需在目标板注入 panic、看门狗和未标记软件复位,验证连续 3 次后的下一次启动进入恢复、正常断电与计划内 OTA 重启不误触发、开机按住 KEY 可 主动进入、精简门户能 更换 Wi-Fi 与完成本地 OTA、按键不可用时自动开放精简门户,以及待验证镜像的延迟确认、失败重试和 Bootloader 回滚。完成前不得把整体使用反馈记为这些专项场景的实机验收通过。

2. 外部仪表功耗与续航基线

  • v0.18.0 已实现始终生效的自动低电规则、手动提前省电、20% / 25% 滞回、 运行期连续两次确认以及 80—240 MHz DFS;连接 USB 数据主机时强制恢复 NORMAL。 v0.19.0 进一步明确 NORMAL 使用 WIFI_PS_MIN_MODEM 保持家庭 Wi-Fi,SAVING 只为 用户主动操作临时联网; 原板未向 ESP32 提供 VBUS 或充电状态输入,若以后要求识别墙充或充电宝,需先增加隔离后 的 VBUS 检测硬件,不能仅靠固件补齐。这些实现项不再列为后续工作,当前缺口是实机电流 与续航数据;
  • 在断开 USB、仅由受控电池供电的统一条件下,使用外部电流表或功耗分析仪分别测量 NORMAL 已连接、NORMAL 断网重试、SAVING | MANUAL 与 SAVING | LOW BAT 的 稳态电流和工作峰值,并覆盖闹钟开关、microSD 有无、Wi-Fi 任务、设置门户、屏幕刷新和 音频空闲等状态;
  • 记录仪表、供电电压、电池容量、固件版本、测试时长、环境与重复次数。只有取得可复现 数据后,才根据瓶颈继续处理未使用外设、轮询间隔、Modem-sleep 参数与断线退避,并估算 实际续航;
  • 同时记录拔掉 USB 静置 2—5 分钟、插入 USB 30—60 秒、再次拔线静置 2—5 分钟三组 GPIO4 还原电压,并用万用表抽查电芯端电压。当前百分比是端电压近似值,不是真实容量; 充电和负载变化会造成跳动,插线后抬升也不得解释为瞬间充入相应电量。取得实测序列后再 评估显示侧的跨样本平滑、死区或 5% 粒度,不用电压上升趋势冒充可靠充电状态。需要准确 荷电状态时必须增加电量计硬件;
  • 当前仍不启用 Light-sleep 或 Deep-sleep。Light-sleep 只有在 USB Serial/JTAG、实体按键、 屏幕刷新、RTC 闹钟、音频、microSD 与 OTA 均有独立实机验收方案后才重新评估;在外部 仪表数据和确定电池容量齐备前,不承诺固定续航时长、节电百分比或提升倍数。

3. 离线语音可靠性基线

  • 已准备易失统计、结构化 USB 日志、固定 50 次测试矩阵和串口采集工具;这些开发能力不 增加用户页面,不保存 PCM,也不能代替目标板上的声学、功耗和报警时序验证;
  • 在安静、日常背景声、近距离和较远距离下重复测试固定白名单,记录误接受与拒绝,避免 用单次识别成功推断整体声学表现;
  • 连续执行成功、未识别和取消会话,记录 PSRAM、内部 RAM、任务栈和碎片趋势,并分别 验证闹钟在准备、监听、识别和结果阶段的抢占;
  • 在 SAVING | MANUAL 与 SAVING | LOW BAT 下测量一次语音会话的电流峰值和 brownout 风险。没有这些数据前不增加唤醒词、持续监听或更大的模型。

4. AI 对话 Beta 后续实机基线

  • 使用独立测试 Key,验证启用、停用但保留 Key、空白 Key 保存、清除、正确 Key、错误 Key、 无权限、无互联网和服务端超时;检查设置状态、屏幕与日志均不泄漏完整 Key、Authorization、 PCM 或对话正文;
  • 分别完成中文、英文、短句、接近 10 秒输入、无声、KEY 提前结束和各阶段 BOOT 取消,确认 16 kHz 采集、手动提交、24 kHz 流式播放及错误恢复;验证 v0.31 新默认 qwen-audio-3.0-realtime-flash 与旧配置迁移;分别覆盖北京 共享、新加坡共享及北京/新加坡 Workspace 专属 Host,确认地域不匹配时安全失败,并拒绝 scheme、路径、端口、IP、任意域名、独立 Workspace ID、App ID 和任意模型名;
  • 使用可观测的连续问答验证 2—5 轮始终复用同一 TLS WebSocket,第 2 轮以后能正确 利用前文;覆盖播放中 KEY 跳过回复并续问、FOLLOW-UP 中 KEY 继续与 BOOT 结束、第 5 轮自动结束、30 秒续问超时、5 分钟下一轮准入边界和在途回答保护;
  • 连续执行至少 20 段成功与失败交错会话,观察内部 RAM、PSRAM、任务栈、codec、Wi-Fi 和性能锁是否全部回收;验证闹钟抢占后无迟到回复、设置门户与 OTA 仍可正常使用;
  • 评估 WebSocket 传输层的敏感 Header 生命周期。应用侧临时缓冲会主动清零,但当前上游 组件销毁其内部 Header 副本时只释放内存,不保证覆盖旧内容;在不维护大段第三方分支的 前提下,研究可验证清零的封装或上游修复;
  • 在确认当前有界多轮半双工体验、延迟、资源回收和实际账单前,不提高 5 轮、 30 秒续问或 5 分钟准入边界,不增加唤醒词、后台监听、自动 VAD、全双工、 自动执行云端命令或跨会话持久历史。

5. 温湿度历史专项验证

  • v0.34.0 正常 30 秒、省电 60 秒采样,5 分钟聚合,RAM 保留最近 24 小时。 SD 可选滚动快照或明确授权的长期月度 CSV;完整桶后尝试保存,音频/维护期间延后。 空间不足停止,不自动删除旧记录;断电可能丢失尚未保存的数据。
  • 屏幕和网页区分本次开机与恢复的数据,失败/缺失不补值;恢复依赖可信 RTC。 不改分区,不向 NVS 写历史;旧月份分页下载,操作和限制见环境记录。
  • 无卡、卡满、损坏、异常断电和长时间音频交接仍需目标板验证;不把主机测试当作实机验收。

6. 天气 Beta 后续验证

  • v0.24.0 首次提供独立天气页:首屏继续显示板载 SHTC3 的室内温湿度,天气页只显示 所选地点的室外实况、三日预报、更新时间和过期状态;功能开启后即加入 BOOT 页面环, 请求中和失败原因都在固定天气布局内显示;
  • 设置门户按“省份 → 城市”选择中国大陆地点,并保存用户自己的 QWeather API Host 和 API Key。设备通过 HTTPS 直连 QWeather,不经过项目服务器;设置页不回显 Key,普通保存不重启。v0.30.0 起保存后继续留在门户,普通退出或到期后再获取,不强制切页;
  • 实时天气约 30 分钟、逐日预报约 6 小时刷新;同地点后台刷新失败时保留最后一次成功缓存, SAVING 不执行周期天气联网。v0.25.0 在天气页增加按住 KEY 2 秒手动刷新,用户 明确操作时可在 NORMAL 或 SAVING 为本次请求临时联网;不再使用临时全屏状态页或 3 秒自动返回。位置目录、响应解析、缓存时效、页面稳定状态与手动刷新门控均需主机测试 覆盖;
  • Beta 阶段仍需继续验证中国大陆网络可达性、证书链、Gzip 与分块响应、真实地点解析、 缓存跨重启、断网过期显示、保存后退出门户获取、天气页手动刷新、NORMAL/SAVING 联网 收尾、API Key 不回显与错误凭据恢复,并按实际账号核对请求量和账单。

7. 市场看板 Beta 后续验证

  • v0.29.0 的显示效果已获用户确认;还需分别记录 1/5 项选择、排序、保存后重启、 同 Wi-Fi 与热点管理,以及切换分区时草稿保留。
  • 覆盖至少两个刷新周期、离页停止请求、快速切回不重复拉取、交易日期不同与部分报价缺失; 断网时保留原报价,重启无网络时显示空值,始终能正常切页。
  • 分别验证省电下手动刷新和自动联网关闭,以及与天气、闹钟、对话、设置门户、OTA 的 资源交接;连续运行观察内部 RAM、任务栈与真实网络延迟,不以主机模拟替代实机结果。
  • 公开行情接口没有可用性承诺;继续保留原报价时间与错误提示,不扩展为逐笔行情或交易工具。

暂缓方向

  • BLE:只有在手机配网或配套应用形成完整流程时再启用,不为未使用的无线能力 增加开关、图标、功耗和安全面;
  • 唤醒与常驻语音:离线指令和可选 AI 对话 Beta 都只在用户长按后开始;在持续监听功耗、 误唤醒、唤醒提示、隐私和用户价值完成独立验证前,不增加唤醒词或后台麦克风采集;
  • 图片自动轮播:当前保持“用户选择后持续显示、短按手动切换”,不增加按小时、 日期或其他周期自动换图的设置;
  • 日程与联网集成:日程只有在数据来源、配置入口、过期标识与离线缓存都明确后才考虑 进入日常页面;MQTT 或 Home Assistant 仅作为开发者集成候选, 优先复用现有温湿度、电池和设备状态,不为集成入口增加日常页面。

后续功能进入实现前,应先确定用户价值、交互位置、离线行为和验收边界; 实现时同步更新设计规范、用户文档、SVG 效果图、主机测试和实机记录。