pylvgl smart screen：Python 主题与 LVGL 智能屏方案
简体中文 · English
pylvgl smart screen
把关心的数据，放到桌面上的另一块屏幕
Python 定义主题，LVGL 绘制界面， AI 帮你把想法变成屏幕上的内容。
pylvgl-smart-screen 是面向 D125 的 USB 智能副屏项目。Windows 上位机采集和组织数据，通过 USB 传给设备；设备使用 MicroPython + LVGL 在本地绘制主题，展示硬件状态、Cursor/Codex 用量、A 股行情或自定义信息。
上位机真实窗口截图与项目主题预览合成。全部读数为演示数据，非设备实拍。
GitHub 项目仓库 · 下载资料包 · 查看主题 · 了解工作原理 · 开始使用 · 获取与支持
让主题定制，像修改脚本一样灵活
用 Python 改界面，常规主题修改无需编译
通过 MicroPython 的 LVGL 绑定，用 Python 脚本描述界面。布局、配色、文字、图表和刷新逻辑都可以随主题调整，让同一块屏幕适应不同的信息需求。
在现有固件和接口支持范围内，修改主题脚本与资源后，预览、下发并按提示重新加载即可，无需重新编译固件，也无需重新打包上位机 EXE。
脚本负责灵活，LVGL 负责绘制
LVGL 图形引擎预先编译在设备固件中，Python 通过绑定调用控件和绘图能力。主题用脚本组织界面，底层绘制交给原生图形引擎，兼顾定制的灵活性与绘制效率。
电脑传送数据，设备本地更新画面。无需为每次布局调整重新构建底层图形引擎；实际流畅度取决于主题复杂度、资源大小和设备能力。
不必先成为嵌入式工程师，也能开始定制主题
从现有主题出发，用自然语言描述想法：“把 CPU 温度放大，将内存改成环形图，整体使用深色配色。” AI 辅助生成修改方案和主题代码，你通过预览与差异审阅确认效果，再下发到屏幕。
常见的界面调整可以从想法和模板开始，无需先搭建嵌入式编译环境。AI 编辑需配置兼容的模型 API，支持范围以主题编辑功能为准；新增硬件驱动、固件能力或数据采集接口仍属于开发工作。
从一个想法，到一份脚本，再到属于你的桌面信息屏。
为什么选择它
| 能力 | 带来的体验 |
|---|---|
| Python 脚本主题 | 在现有接口范围内修改脚本与资源，常规主题调整无需编译固件 |
| 预编译 LVGL 引擎 | Python 调用绑定接口，设备端原生图形引擎负责绘制 |
| USB 连接 | 通过 HID 传实时数据与控制，通过 MTP 管理主题和配置 |
| 设备本地绘制 | 传输结构化数据，由 SoC 绘制界面；不是电脑桌面镜像 |
| 多种数据源 | 硬件监测、Cursor/Codex 用量、A 股行情，按需选择 |
| 横竖屏主题 | 支持方向选择，主题可提供不同方向的布局 |
| 主题独立管理 | 新建、导入、预览、同步、下发和导出，无需为常规换主题重打 EXE |
| 可选 AI 辅助编辑 | 从模板与自然语言描述开始，预览、审阅后应用主题修改，降低定制门槛 |
适合哪些场景
- 电脑状态看板：在副屏持续查看 CPU、GPU、内存和网络等受支持的硬件指标。
- 开发者桌面：展示 Cursor 或 Codex 数据源提供的用量信息，减少来回切换窗口。
- 行情信息屏：选择股票代码，在独立屏幕查看电脑联网获取的 A 股行情。
- 个性化展示：基于现有主题调整布局、配色、信息层级和已有图片资源。
可用指标取决于电脑硬件、采集权限和数据源。用量数据不由主题自行登录获取；行情可用性与更新时间取决于数据源。
如何工作
同一套主题体系连接两端：Host 组织数据与管理主题，Device 接收数据并更新画面。主题绘制与设备通用运行时分离，视觉主题之间无需互相依赖。
硬件介绍
同一套 D125 硬件，搭配不同固件，实现不同应用。
pylvgl-smart-screen 与 D125 Zephyr 显示调试板共用硬件平台。板卡、接口与硬件资料可参考该页面；本项目使用配套的 MicroPython + LVGL 固件，通过 USB 与 Windows 上位机配合，运行可定制的 Python 主题。
使用本项目时，请安装 pylvgl-smart-screen 配套固件与完整运行文件。两个项目的固件不同，请勿直接将 Zephyr 方案的固件作为本项目运行固件。当前资料包附带 D125 2.5 IMG 及校验文件，详见下载资料包。
硬件连接
- 准备 Windows 电脑、支持数据传输的 USB 线和兼容的 D125 设备。
- 确认设备已安装配套固件与完整运行文件。
- 连接 USB，在上位机刷新并选择设备。
- 选择主题，按需下发，再开始传输数据。
这是一张逻辑连接示意图。USB 接口类型、供电方式、额定电压、板卡引脚及 TF 卡要求，以实际板卡说明为准；本页不将其作为已确认的硬件参数。
产品外观与配色示意
基于提供的参考图经 AI 编辑制作的效果合成图，非设备实拍。后排从左到右为红色 Hardware、绿色 Cursor、蓝色 Codex Mist，前排为黄色 A 股横屏；屏幕采用主题预览：硬件和用量为模拟数据，A 股为 2026-10-30 历史行情回放。外壳颜色仅作效果展示，实际外观与可选颜色以实物为准。板卡接口近照和供电标注仍待补充。
软件架构
Host：运行在电脑上的上位机
| 模块 | 职责 |
|---|---|
ui / app | PySide6 界面、会话、服务装配、主题操作及运行状态 |
sources | 公共采集、数据源注册和可选主题采集插件 |
library | 主题元信息校验、导入导出、依赖和设备同步 |
主题编码 / stream / protocol | 将采集快照编码为主题数据，构建公共帧并调度发送 |
transport | HID 数据与控制发送、MTP 文件读写 |
preview | 电脑预览，复用主题绘制与便携解析能力 |
ai | 可选模型请求、受限文件上下文、修改方案和候选结果校验 |
| 竖屏预览 · Codex Mist | 横屏预览 · Codex Mist |
|---|---|
 |  |
真实上位机界面的隔离仿真实例：Qt 原生 2× 绘制，无损 PNG，横竖两个窗口图均为 1096 × 1166；未连接硬件、用户账号或模型 API。预览与主题原图使用同一份 fake 数据。
Device：运行在 SoC 上的下位机
| 模块 | 职责 |
|---|---|
main.py / runtime | 应用启动、数据轮询、刷新、主题切换和显示生命周期 |
transport / protocol | 接收 USB 数据，校验公共帧并读取控制字段 |
| 主题解析器 | 使用共享或主题本地协议，将数据更新到遥测状态 |
storage / config | 配置读写、主题映射和文件管理 |
ui/<slug> / LVGL | 加载主题绘制、图片和字体，刷新设备画面 |
下位机使用 MicroPython + LVGL。MTP 文件传输能力由配套设备固件提供；仓库中的设备 Python 应用不等同于底层固件构建工程。
主题：连接两端的可扩展单元
themes/<slug>/
theme.json 名称、版本、数据源、协议与 API 要求
host/
preview.json 电脑预览与方向声明
source.py 可选：主题专用数据采集
encoder.py 可选：本地协议编码
device/
dashboard.py 设备界面绘制
layout.py 按主题需要拆分布局
decoder.py 可选：本地协议解析
assets/ 图片等主题资源常规主题复用共享协议；需要新数据接口时，可提供专用采集插件或本地编解码。设备主题负责显示，不承担电脑账号登录与网络采集。资源与代码随主题完整打包，便于分享和迁移。
主题展示
2026-11-06 主题背景资源
本次更新包含 Hardware、Holo Glass、Millennium、Cursor、Codex、Codex Mist 和 A 股 7 套主题的源码、背景图片及共享协议。以下采用统一卡片展示随包提供的背景原图，可切换横竖屏并打开原图查看。
此处是静态背景资源预览，不是完整运行界面。 动态数值、曲线、控件与部分前景装饰由对应主题代码在运行时绘制；背景中已有文字及读数属于素材内容，不代表实时数据。竖屏为 720 × 1280，横屏为 1280 × 720。
下载独立主题资源包（2026-11-06） · SHA-256 校验文件
独立资源包包含主题源码、共享协议和配套参考文档，不包含上位机 EXE 或固件。更新前请备份已有主题，解压至独立目录并按配套版本的主题导入流程操作；保留主题 slug、目录结构与资源文件名。
从主题模板到自己的界面
新建与分享
- 在上位机点击“新建”，设置名称、标识、版本、模板和支持方向。
- 修改主题，检查电脑预览。
- 停止推流，导入或下发，核对主题对齐与删除提示。
- 按提示重启设备，恢复推流并做实机检查。
- 导出完整主题 ZIP，用于备份或分享。
EXE 用户无需安装 Python，即可使用应用的主题管理与 AI 辅助编辑功能。主题脚本由配套运行环境执行，常规修改不需要编译；手动编写代码时可参考 Python、LVGL 和主题接口说明，新增依赖须在已有运行环境支持范围内。
可选 AI 辅助编辑
描述想法 → 生成方案 → 确认范围 → 生成修改 → 审阅差异 → 应用与验证。
用户自行配置兼容的模型 API。内置编辑只处理受限的主题绘制文件、显示元信息和预览配置，不自动修改采集器、通信协议或设备通用程序。应用前备份主题；校验失败时由用户决定是否再次请求修复。
使用前了解
方案、代码生成和修复分别可能产生 API 费用。请先审阅发送内容；应用不会主动发送 API 配置文件或 KEY，但主题源码中自行写入的秘密仍需用户清除。静态检查与电脑预览均不能替代实机验证。
快速上手
1. 准备设备和程序
使用已安装兼容固件及运行文件的 D125。完整解压发布包，保留以下同级目录：
pylvgl-smart-screen/
pylvgl-smart-screen.exe
assets/
themes/
docs/
device/firmware/2. 连接与预览
USB 连接设备，运行 EXE，刷新并选择 D125。选中一个已有主题，开启电脑预览，并设置主题实际支持的方向。
3. 下发与显示
设备没有对应主题时，先停止推流并下发。确认可能删除设备其他主题的提示；完成后按提示重启，再点击“开始”。
应用支持托盘运行；关闭窗口可能仅隐藏，彻底结束请使用“退出”。
规格与使用条件
| 项目 | 当前说明 |
|---|---|
| 产品名称 | pylvgl-smart-screen |
| 配套设备 | 兼容 D125 板卡、固件及完整设备运行文件 |
| 上位机 | Windows；发布版 EXE 无需安装 Python |
| 下位机 | SoC 运行 MicroPython + LVGL |
| USB 通信 | HID：实时数据与控制；MTP：主题与配置 |
| 主题画布 | 竖屏 720 × 1280；横屏 1280 × 720 |
| 方向选择 | 0° / 90° / 180° / 270°，以主题实际布局为准 |
| 数据条件 | 账号用量依赖对应数据源；行情和模型 API 需要相应网络服务 |
| 固件资源 | 仓库与用户资料包提供 2.5 镜像与校验；底层构建工程、烧录工具另行准备 |
目前不在本页承诺未验证的刷新率、端到端延迟、功耗或所有电脑硬件指标覆盖。固件烧录兼容性、供电和存储要求须按目标设备验证。
常见问题
是电脑扩展显示器吗？
它是一块显示结构化数据的主题副屏。上位机传输数据，设备本地绘制，不用于拖放电脑应用窗口或镜像桌面。
不使用 AI 也能用吗？
可以。数据展示、主题导入和设备下发不要求配置模型 API。AI 编辑是可选功能。
电脑预览和设备画面完全相同吗？
电脑预览用于检查布局和数据。设备字体、资源和运行环境仍需实机检查；预览不能当作真机截图。
下发会影响设备已有主题吗？
可能。同步与下发会对齐主题库，可能删除未保留的设备主题。操作前停止推流、备份并阅读提示；可下发数量还受到存储空间限制。
如何保护账号和 API KEY？
不要将凭据写入主题，也不要分享本地 ai-settings.json。公开截图和日志前隐藏账号、KEY、个人路径及设备标识。
下载资料包
下载 pylvgl-smart-screen 0.2.0 上位机、主题与固件资料包
资源更新：2026-11-06。 下方完整包保留 0.2.0 上位机，已同步本次 7 套主题与共享协议；这是主题资源更新。
Windows 上位机发布包，完整解压后运行 pylvgl-smart-screen.exe，无需安装 Python。适用于已安装兼容固件与完整运行文件的 D125，也可用于基于 EXE 的主题开发。
| 项目 | 内容 |
|---|---|
| 文件名 | pylvgl-smart-screen-0.2.0.zip |
| 文件大小 | 110,919,254 字节，约 105.8 MiB |
| 应用 | 上位机 EXE 与运行资源，包含新建及 AI 编辑主题功能 |
| 主题 | 7 个内置主题、主题绘制源码、图片资源、预览配置及共享编解码协议 |
| 固件 | device/firmware/：D125 2.5 IMG、对应 SHA-256 与中英文说明 |
| 用户资料 | 中英文快速开始、日常操作、设备准备、主题开发、采集插件及 AI 编辑说明 |
| 给 AI 的资料 | 中英文 docs/ai/THEME-EXE 指南，适用于仅持有 EXE 的主题开发 |
| 协议资料 | 通用 USB HID、主题配置约定及随主题维护的专用协议 |
d4809e962051a0502a11b4980c491fe7017bbab72f23bbdb451aa227ec77f12d完整解压，保留 assets/、themes/、docs/ 和 device/ 与 EXE 同级。可使用 Windows PowerShell 校验下载内容：
Get-FileHash .\pylvgl-smart-screen-0.2.0.zip -Algorithm SHA256首次准备设备还需要什么
此包包含电脑端使用、主题开发资料与 D125 2.5 固件 IMG，不包含完整下位机运行包、烧录工具或底层构建工程。固件位于 device/firmware/，请先阅读同目录说明并核对 SHA-256，再按板卡说明选择版本；该镜像尚未完成本项目的真机烧录验证。新设备初始化、固件升级或自定义设备解析器需要另行获取匹配的设备资料与运行文件；请向维护者确认板卡、供电和烧录步骤。资料包也不提供模型 API KEY 或账号凭据。
获取与支持
| 入口 | 链接 |
|---|---|
| 上位机、主题与固件资料包 | 下载 0.2.0 |
| GitHub 项目仓库 | UltraSemiCN/pylvgl-smart-screen |
| 独立主题资源（2026-11-06） | 下载主题 ZIP · SHA-256 |
| 配套硬件与设计资料 | D125 显示开发板 |