系统监视仪表盘 Eason-zys/dsh-550c-monitor

dsh-550c-monitor

一个 DSH Web UI 的系统监视器，按 550C 皮肤裁剪：半透明仪表盘，停靠在阅读栏右缘，实时读取 CPU、GPU、内存、磁盘、网络和温度。

它是 dsh-550c-skin 的配套插件——但也能单独运行：没装皮肤时，回退到宿主主题的 token。

550C // SYS UP 6h23m
────────────────────────────────────────────────────
LIVE / SYSTEM
CPU ▐▌▌▌▌▌▌▌▌▌▌▌▌▌▌▌▌▌▌▌▌▌▌▌▌▌▌▌▌▌▌▌▌▌▌▌▌▌▌ 36% 20×
GPU ▐▌▌▌▌▌▌▌▌▌ 12% 1.6G
MEM ▐▌▌▌▌▌▌▌▌▌▌▌▌▌▌▌▌▌▌▌▌▌▌▌▌ 52% 16G
DSK ▐▌▌▌▌▌▌▌▌▌▌▌▌▌▌▌▌▌▌▌▌▌▌▌▌▌▌▌▌▌▌▌▌▌▌▌▌▌▌▌▌▌▌▌ 85% F 42G
NET ▐▌▌ ↓0B ↑1.0K
TMP ▐▌▌▌▌▌▌▌▌▌▌▌▌▌▌▌▌▌▌▌▌▌▌▌▌▌▌▌▌ 62° GPU
────────────────────────────────────────────────────
HOST / DEVICE
HOST DESKTOP-H639F3B
OS win32 10.0.26200 x64
CPU 12th Gen Intel(R) Core(TM) i7-12700H · 20 MEM 32G GPU NVIDIA GeForce RTX 3070 Ti Laptop GPU · 8.0G

功能

六项实时读数
- CPU —— 用 os.cpus() 的 tick 差值算出总负载，外加核心数。
- GPU —— 装了 nvidia-smi 时显示利用率和已用显存；没有就静默隐藏。
- MEM —— 已用 / 总物理内存。
- DSK —— $DSH_HOME 所在卷的剩余空间，附挂载点。
- NET —— 接收 / 发送吞吐量，按间隔采样（没有计数器就不给数字：头 ~4 秒显示 --，而不是编一个 0）。
- TMP —— GPU 温度取自 nvidia-smi，CPU 温度取自 ACPI 热区（前提是进程有权限读取）。

设备清单 —— 主机名、操作系统、CPU 型号、内存、GPU、磁盘卷、局域网地址、Node 版本、屏幕、时区。窗口矮时，可选行从下往上折叠，数字绝不会在行中间被截断。

按皮肤的做法打造
- 方形仪表轨：4 px 单元、6 px 间距、skewX(-18deg)，用强调色填充，一条 1 px 液位线悬出两端，硬直角（不用模糊投影——那会把 4 px 单元糊成药丸）。
- 毛玻璃卡片：半透明着色叠在 backdrop-filter: blur(34px) saturate(1.32) 上，5 %→1 % 顶部高光，淡淡的扫描线，四角括号由八段渐变画出。
- HUD 数字：等宽、斜杠零、text-shadow 辉光；标签带 2×10 px 状态刻度。
- 调色板先读皮肤 token（--c-amber、--c-glow-rgb、--c-red、--c-text-），再回退到宿主主题（--dsw-alias-）。

像仪表，不像对话框
- 拖动标题栏可移动；双击标题栏交还给布局引擎。位置在刷新后保留。
- 点右上角 – / + 键折叠——一条 46 px 的窄条，显示 CPU · MEM · NET。折叠状态在刷新后保留。
- 自适应：面板贴在阅读栏右侧留白处，高度最多占可见高度的 60%，这样右下角还能留给其他组件。窗口变窄时，面板收成 18 px 宽的竖条，由六根细条组成。
- 除标题栏和折叠键之外，整块面板都可点击穿透；有对话框或菜单打开时，面板自动隐藏。

加宽阅读栏（可选，默认开启） DSH 会把对话记录限制在适合阅读的宽度，大屏上就空出一大片右侧留白。这个插件会找出真正被 max-width 限制住的那个盒子（计算出的像素上限，以及已经顶到上限的盒子），给这个元素打上 data-550c-monitor-wide 标记，然后去掉宽度限制。其他元素一概不动；这一轮扫描每 3 秒最多执行一次，并且可以从控制台完全还原：

__monitor550c.widen(false) // give the reading measure back
__monitor550c.widen(true) // take the gutter again

选择会记在 localStorage 里（dsh-550c-monitor:wide）。

环境要求

- DSH Web UI，且带 Web 服务器（插件会注册一条精确路由）。
- Node.js >= 20。
- 系统探测支持 Windows 或 Linux；Windows 上还能通过 nvidia-smi 读取 GPU 数据，提权后还能读 CPU 温度。macOS 未测试。

安装

从本地检出安装（插件是纯 JS，无需构建）：

inside the DSH profile directory
pnpm add link:/path/to/dsh-550c-monitor

然后在配置档里启用这个 bundle（配置档 package.json 中的 dsh.profile.bundles），或者用 Harness 插件管理器界面操作。包内已声明自己的 dsh.bundle.patch，不需要手写进 cordis.patch.yml。

这一行会以 monitor-550c 的名字写进配置档。

HTTP API

宿主侧只注册一条精确路由，只读：

GET /dsh-550c-monitor/stats

{
"at": 1761.., // sample timestamp (ms)
"cpu": { "pct": 36.4, "cores": 20 },
"mem": { "pct": 52.1, "used": 19833176064, "total": 34037551104 },
"disk": { "mount": "C:\\", "total": 290205761536, "free": 45441830912, "pct": 84.3 },
"net": { "rx": 127.0, "tx": 1024.0 }, // bytes/second, null until two samples exist
"gpu": { "name": "…", "pct": 12, "memUsed": 1702887424, "memTotal": 8589934592, "temp": 61 },
"temps": { "cpu": null, "gpu": 61 },
"uptime": { "system": 21165, "process": 7171 },
"device": { "host": "…", "os": "win32 10.0.26200", "arch": "x64", "cpuModel": "…",
"node": "v24.21.0", "ip": "192.168.3.8", "cores": 20,
"memTotal": 34037551104, "diskMount": "C:\\", "diskTotal": 290205761536 }
}

其他方法一律返回 405。响应头为 cache-control: no-store。

数值说明

- CPU 温度来自 MSAcpi_ThermalZoneTemperature。在大多数笔记本上，读取它需要提权进程；当探测被拒绝（或机器没有暴露 ACPI 热区——大多数台式机都没有），该行只显示 GPU 的值，TMP 回退为报告 GPU 传感器。连续两次被拒后探测就放弃，不会一直轮询下去。
- 网络在 Windows 上读 netstat -e，在 Linux 上读 /proc/net/dev。两者都无响应时，对应行显示 --。
- GPU 每个间隔用一次性的 nvidia-smi 查询轮询；二进制缺失时省略 GPU 行，其余行保持面板的节奏。
- 磁盘指存放 $DSH_HOME 的卷（回退到用户主目录所在的卷）。
- 宿主侧探测用 spawn 写入临时文件，不走管道 stdio，因为有些沙箱拒绝匿名管道（spawn EPERM）。

开发

node --check index.js # host half
node --check client.js # browser half (plain ModuleLoader factory, no bundler)

客户端部分刻意写成手写模块——DSH 原样加载它。它向文档追加一个 元素和一张 position: fixed 卡片，两者都由同一个清理函数负责，该函数通过 ctx.effect 注册。

许可证

MIT——见 LICENSE。