HoloCubic Hub:配置窗口与后台状态桥共用一个程序
同一块桌面显示器既要设置网络和图片,也要在后台显示工作状态。HoloCubic Hub 将配置工作台与 Codex 状态桥整合为一个 Windows 可执行程序。

仓库创建:2026-08-23 22:21(不等同于项目开工日期)
本篇参考的默认分支提交:2026-08-27 17:13 · e18d3823
时间采用 UTC+8。文章发布时间是本次整理时间,不按 GitHub 历史日期倒填。
一个入口,两种运行方式
正常打开程序时,用户可以管理 Wi-Fi、天气、图片、行情、RGB 和投屏;以 --background 启动时则不打开窗口,通过 USB 同步时钟,并在有活动任务时显示 Codex 状态。两种模式使用同一入口,避免维护两个用途相近的程序。
USB 时钟同步让设备在没有 Wi-Fi 时仍可作为时钟使用。状态界面在任务结束后回到普通桌面,也让设备不必长期停留在一张已经过时的完成画面上。
把状态传输与画面传输分开
仓库的稳定性说明记录了早期状态展示依赖 Wi-Fi JPEG 投屏的问题。当前方向改为发送精简 USB 状态,由设备本地绘制动画,使状态切换不再依赖投屏监听器和图像传输。
同时运行的工作台和桥接进程也可能争用 USB。合并入口并串行化设备操作,是针对这一争用路径的处理。其他补丁还涉及 LVGL 对象生命周期、投屏就绪确认和断网后的连接状态检查。
固件补丁的适用范围
仓库提供的是围绕 HoloCubic/AIO 生态的整合层与定向补丁,并非完整上游固件的替代品。编译前要确认上游版本匹配,并保留许可证与来源说明。连接时自动识别兼容设备,也比把某个固定 COM 端口写进安装说明更可靠。
对应版本与提交记录
以下为采集时默认分支的近期提交,链接保留原始记录。
- fix: restore compact Codex header position
- fix: keep large Codex state below header
- fix: lower Codex status layout for round display
资料来源:README 固定版本 · GitHub 仓库。