三步把闲置的 USB-C 小屏变成系统监控中心：turing-smart-screen-python 完整上手指南

【免费下载链接】turing-smart-screen-pythonUnofficial Python system monitor and library for small IPS USB-C displays like Turing Smart Screen / TURZX项目地址: https://gitcode.com/GitHub_Trending/tu/turing-smart-screen-python

你给电脑接了一块 Turing Smart Screen 或 XuanFang 之类的 USB-C 小屏，却不想被厂商自带软件绑住，或者需要在 Linux、树莓派上跑监控？turing-smart-screen-python 是一个面向这类小尺寸 IPS USB-C 显示屏的开源 Python 系统监控程序，能把 CPU、GPU、内存、磁盘等数据实时画到屏幕上，同时自带一套可二次开发的显示屏抽象库。

一句话说清：它是一块 USB-C 屏的系统监控程序

这个项目做的事很直接：把小屏变成一块随时可看的硬件监控面板，并且让你可以用自己的 Python 代码统一控制不同品牌、不同协议的屏幕。

• 开箱即用：Windows、Linux（含树莓派）可直接运行，macOS 同样支持，但 README 标注该平台仍有已知 bug
• 覆盖 Turing 2.1" 到 12.3" 共 10 种尺寸，以及 XuanFang 3.5"、WeAct 0.96"/3.5"、Kipye Qiye 3.5"、UsbPCMonitor 3.5"/5" 等兼容屏
• 全部配置通过config.yaml或图形化向导完成，不需要写代码

快速上手：从克隆到亮屏只需三步

第一步，克隆仓库并安装依赖：

git clone https://gitcode.com/GitHub_Trending/tu/turing-smart-screen-python cd turing-smart-screen-python pip install -r requirements.txt

第二步，运行python configure.py打开图形化配置向导，选择屏幕型号与串口即可；也可以跳过向导，直接编辑config.yaml：

config: COM_PORT: AUTO THEME: 3.5inchTheme2 display: REVISION: A

其中REVISION对应硬件版本（A/B/C/D/TUR_USB/WEACT_A/WEACT_B），COM_PORT设为 AUTO 会自动探测串口。HW_SENSORS: AUTO则会在 Windows 上走 LibreHardwareMonitor（需要管理员权限），其他系统走 Python 库读取传感器。

第三步，python main.py启动，程序会驻留托盘，需要退出时从托盘图标操作即可。

核心场景拆解：小屏的三种用法

场景一：把 CPU 与内存数据常驻在桌面上

这是买小屏最常见的目的。选一个与屏幕尺寸匹配的主题（theme.yaml中的DISPLAY_SIZE会注明适配尺寸），CPU 占用、GPU 占用、显存、内存、磁盘使用率、温度、网络速度会按theme.yaml里配置的INTERVAL周期自动刷新。内置主题风格差异很大：Terminal 是仿终端的 1/5/15 分钟负载面板，Landscape6Grid 用六宫格铺满横屏。config.yaml还支持填入 OpenWeatherMap API key 与经纬度，让支持天气的主题顺带显示天气，并提供 ping 时延传感器。

场景二：还没有屏幕？用"模拟屏"模式先体验

屏幕还没到货，或者只想在电脑上调试主题，可以把config.yaml里display的REVISION设为SIMU。此时程序不连接任何硬件，而是把每一帧画面写成本地的screencap.png，分辨率根据所选主题自动确定。全部主题调试完成后再接真屏，省去反复插拔试错。

场景三：只想让它当常亮时钟或进度条显示屏

不关心硬件数据也可以。仓库自带 BigClock 这类纯展示主题；或者直接运行simple-program.py示例，它会持续绘制当前时间、水平进度条和环形进度条——这也是这个库的最小使用入口，几行代码就能让屏幕显示任意内容。

进阶定制：主题编辑、自定义数据源与二次开发

• 自定义主题：一个主题就是一个文件夹，包含theme.yaml加背景图，可参考主题列表 里 60 多个内置主题的写法，调整文本位置、字体、进度条颜色。
• 可视化编辑：运行python theme-editor.py 主题名，会在电脑上弹出预览窗口，随文件修改实时刷新，不必反复连接实体屏。
• 自定义数据源：在 library/sensors/sensors_custom.py 中继承CustomDataSource实现as_numeric等两个方法，你自己的指标就能像 CPU、内存一样被主题引用，仓库中的 CustomDataExample 主题给了完整示例。
• 二次开发：把 library/lcd/ 里的LcdComm类导入自己的项目（simple-program.py是完整样例），可以调用DisplayBitmap贴图、DisplayText渲染文字、DisplayProgressBar/DisplayRadialProgressBar画进度条、SetOrientation旋转屏幕，在支持的型号上还能控制背板 RGB 灯带颜色。

踩坑提示：三个容易遇到的设置

• Turing 3.5"（硬件版本 A）在高亮度下会明显发热，官方示例代码注释明确建议BRIGHTNESS控制在 50% 以下。
• RESET_ON_STARTUP默认为 true，启动时会让屏幕短暂断开重连、COM 口随之变化；如果你的 rev. A 屏幕因此频繁"找不到串口"，把它改为 false。
• Windows 上若选择 LHM 传感器读取方式，它通过 LibreHardwareMonitor 工作，必须以管理员权限运行；拿不准就保持HW_SENSORS: AUTO。

写在最后

如果你的桌面上有一块"半闲置"的 USB-C 小屏，turing-smart-screen-python 能让它在几行 YAML 之内变成一个随改随用的系统监控中心；支持的完整型号列表、主题说明与故障排查，可以从 README 和主题目录 继续看。

【免费下载链接】turing-smart-screen-pythonUnofficial Python system monitor and library for small IPS USB-C displays like Turing Smart Screen / TURZX项目地址: https://gitcode.com/GitHub_Trending/tu/turing-smart-screen-python