SideScreen Kit

SideScreen Kit 是一套把旧 iPad、平板或局域网设备变成本地副屏看板的方案。它在 Windows 主机上运行轻量 Web 服务，采集系统状态、硬件传感器、网络速率、GPU 信息和 AI 使用额度，并通过网页展示到同一局域网内的 iPad 上。

首套内置 UI 主题为 XplorOne，参考 AIDA64 SensorPanel 风格，适合 iPad 横屏常驻显示。项目内置 .agents skill，推荐通过 Codex 对话完成启动、配置、诊断和面板身份切换。

主要功能

• 旧 iPad / 平板局域网副屏展示
• Windows 本机实时 telemetry 采集
• CPU、GPU、RAM、VRAM、Storage、Network 数据展示
• LibreHardwareMonitor 扩展支持温度、功耗、风扇、水泵等数据
• Codex / Claude 面板身份显示切换
• 项目级 .agents skill，适合复制、打包和多 UI 体系扩展

快速开始

解压或复制项目后，请保持整个文件夹结构不变。用 Codex 打开项目目录，然后发送：

请按 START_HERE.md 和 AGENTS.md 的流程启动 XplorOne 副屏。

Codex 会按流程完成：

1. 读取 config/app.json。
2. 询问面板上显示 Codex 还是 Claude，默认推荐 Codex。
3. 写入 assistantProvider 配置。
4. 启动本地服务。
5. 验证本机页面和 /api/telemetry。
6. 输出 iPad 可访问的局域网地址。

最终会得到类似这样的地址：

http://192.168.x.x:3000/

在 iPad Safari 中打开这个地址即可。

手动启动

如果暂时不用 Codex，也可以在项目根目录打开 PowerShell：

.\scripts\start.ps1

停止服务：

.\scripts\stop.ps1

配置

核心配置位于 config/app.json：

{
  "activeUi": "XplorOne",
  "assistantProvider": "codex",
  "host": "0.0.0.0",
  "port": 3000,
  "refreshMs": 1000
}

activeUi 用于选择当前 UI。每套 UI 放在 uis/<UiName>/ 下，并至少包含 dashboard.html 和 manifest.json。

切换 Codex / Claude 显示

面板左上方的 AI 身份可以切换为 Codex 或 Claude：

.\scripts\set-assistant-provider.ps1 -Provider codex
.\scripts\set-assistant-provider.ps1 -Provider claude

目前这个选项只改变面板图标和文字。AI 使用额度的取数机制暂时仍沿用当前 Codex/OpenAI 机制。

数据来源

• CPU、RAM、网络速率：Windows API / PowerShell
• NVIDIA GPU：nvidia-smi
• CPU 温度、功耗、风扇、水泵：LibreHardwareMonitor library
• AI 使用额度：本机 Codex/OpenAI 登录信息可用时自动读取

LibreHardwareMonitor 默认路径：

C:\Users\<User>\Downloads\LibreHardwareMonitor

服务可以直接使用其中的库文件，LibreHardwareMonitor 图形界面不需要常驻打开。

项目结构

config/                 配置文件
runtime/                本地 Web 服务和 telemetry 采集
scripts/                启动、停止、切换显示身份等脚本
uis/XplorOne/           第一套 UI 主题
.agents/skills/         项目内 Codex skill
tests/                  本地验证测试
tools/                  LibreHardwareMonitor 辅助工具

验证

运行完整测试：

python -m unittest tests\test_dashboard_preview.py tests\test_dashboard_realtime.py tests\test_telemetry_server.py -v

如果只是微调静态 UI 像素，可以按实际调试节奏刷新 iPad 页面确认效果。