Qiansui Screen / 千岁屏幕

一块基于 ESP8266 与 240×240 ST7789 屏幕的桌面状态屏。它从 PrintSphere Lite 演进而来，在保留 Bambu Lab 打印状态显示的基础上，增加了天气、电脑状态、Codex / Claude 任务、通用通知、日历和安全 OTA。

准备建立公开仓库时，请按 首次公开发布指南 操作；不要直接把 当前 origin 推送回上游项目。

功能

• 主页显示时间、日期、本地天气、多日预报、空气质量与网络状态。
• 监控 Bambu 打印任务、进度、层数、温度、耗材、AMS、异常与模型缩略图。
• 展示 Windows 电脑的 CPU、GPU、内存、温度、网络和媒体状态。
• 识别 Codex 与 Claude 主任务，显示运行、等待、完成和失败状态。
• 接收统一通知、日历、倒计时和番茄钟。
• 页面按在线状态自动轮播；离线模块自动跳过。
• 支持局部刷新、夜间亮度、Wi-Fi 自动重连、看门狗与诊断导出。
• 支持带密码、镜像校验和失败保护的局域网 OTA。
• 提供 Windows 本地伴随服务与网页配置控制台。

组成

目录	用途
src/、include/	ESP8266 固件与 ST7789 配置
companion/	Windows 本地伴随服务、配置控制台与测试
assets/	千岁小屏角色源图与生成结果
scripts/	素材生成辅助脚本
固件/	本地发布用固件镜像（生成文件，不提交 Git）
刷固件工具/	Windows 刷写入口

家庭服务器部署和千岁 AI 私有联动不属于本公开仓库；千岁 Screen 的品牌、像素角色与 本地帧动画保留。

硬件

• ESP8266EX / NodeMCU 兼容模块
• 240×240 ST7789 SPI 屏幕
• CH340 / CH341 USB 串口（按实际开发板而定）

当前 platformio.ini 与 include/User_Setup.h 按现有 SD2 硬件接线配置。换用其他 开发板或屏幕前，请先核对供电、电平、背光和 SPI 引脚。

快速开始

1. 从项目的 Releases 下载完整交付包。
2. 通过 USB 连接屏幕设备。
3. 运行 后端配置工具/打开配置工具.bat。
4. 登录 Bambu 云服务（如需打印机页面），配置 2.4 GHz Wi-Fi 和显示选项。
5. 写入配置并确认屏幕联网后，可改用普通 USB 电源供电。

ESP 联网后可在局域网访问：

http://ESP_IP:8081/

伴随服务默认只在本机提供配置页：

http://127.0.0.1:8795/

从源码构建

固件需要 PlatformIO：

platformio run -e sd2

生成文件位于 .pio/build/sd2/firmware.bin。

伴随服务仅使用 Node.js 内置模块，要求 Node.js 18 或更高版本：

node companion/server.js 8795

运行测试：

Set-Location companion
npm test

隐私与安全

Wi-Fi 密码、Bambu token、打印机序列号、设备地址、OTA 密码摘要和配对令牌只应保存在 本地运行数据中。以下内容已被 .gitignore 排除，禁止手动强制提交：

companion/data/
.env
secrets.yaml
server/
integrations/

公开发布前请阅读 SECURITY.md。默认发布脚本不会捆绑 Node.js、 esptool 或串口驱动，并会为 ZIP 生成 SHA-256 文件。发现安全问题时，不要在公开 Issue 中 粘贴 token、密码、诊断导出或完整配置文件。

贡献

提交 Issue 或 Pull Request 前请阅读 CONTRIBUTING.md。

上游、商标与许可

本项目是 PrintSphere Lite 的非官方衍生版本。上游版权与许可声明必须保留，详见 NOTICE 与 THIRD_PARTY_NOTICES.md。Bambu Lab、 OpenAI、Codex、Anthropic、Claude 等名称与标识归各自权利人所有；项目与这些公司没有 隶属或官方背书关系。