AmeKrance/anan-thermal-monitor ↗★ 1
anan-thermal-monitor
紫白桌宠温度监控:CPU/内存/GPU/NVMe 实时温度 + 硬件信息,悬浮于 Windows 桌面的 DSH 插件
AI 분석
核心用途是提供 Windows 系统的硬件温度监控悬浮窗。适合需要实时监控硬件状态的用户。必要条件为 Windows 10/11 系统,且读取 CPU/内存温度需要管理员权限。
설치
npx -p @deepseek-ai/dsh dsh plugin --profile web add github:AmeKrance/anan-thermal-monitor或使用本地已解压的源码目录:
dsh plugin --profile web add /path/to/anan-thermal-monitor
安装后 **重启 dsh(web profile)**,桌宠自动出现在桌面右下角;首次运行弹 UAC 提权确认(读取 CPU/内存温度需要管理员权限),点"是"即可。
### 卸载
```bash
dsh plugin --profile web remove anan-thermal-monitor
🖥️ 独立运行(不依赖 DeepSeek Harness / Bigfish)
桌宠本身就是独立程序——脚本、素材、硬件监控库全部自包含,无需 DSH 或 Bigfish 即可运行。
启动
双击 start-pet.vbs(隐藏窗口启动,无控制台闪烁),或命令行:
powershell.exe -NoProfile -ExecutionPolicy Bypass -File assets\desktop-pet.ps1
- 首次运行弹 UAC 提权(读取 CPU/内存温度需要管理员权限),点"是"
- 启动后无控制台窗口残留;右键桌宠卡片 → "退出安安热能监控" 关闭
开机自启(免 UAC 弹窗)
双击 install-autostart.bat——通过 Windows 任务计划程序注册"登录时以最高权限运行"(管理员权限、不再弹 UAC)。卸载自启:双击 uninstall-autostart.bat。
独立运行 vs DSH 插件
| 方式 | 启动 | 特点 |
|---|---|---|
| 独立(vbs/自启) | 双击 start-pet.vbs / 开机自动 | 不依赖 DSH/Bigfish;无 GUI 控制卡片 |
| DSH 插件 | dsh plugin add + 重启 | 随 DSH 启停;对话流内有实时温度卡片 + 启停按钮 |
两种方式可共存(脚本有幂等检查,不会双开桌宠)。
🖥️ 对电脑各种信息的调用
| 信息 | 调用方式 | 权限 | 说明 |
|---|---|---|---|
| CPU 温度 | LibreHardwareMonitorLib (Ring0 / Intel MSR) | 管理员 | CPU Package / Core Max 温度 |
| 内存温度 | LibreHardwareMonitorLib (SMBus / SPD) | 管理员 | DDR DIMM 温度传感器,无传感器显示 "--" |
| GPU 温度 | LibreHardwareMonitorLib (NVIDIA NVAPI / AMD ADL) | 普通 | GPU Core 温度 |
| NVMe 固态温度 | LibreHardwareMonitorLib (NVMe SMART / ATA) | 普通 | Composite Temperature,多盘取最热 |
| CPU 型号 | WMI Win32_Processor.Name | 普通 | 精简为如 i7-12800HX |
| 显卡型号 | WMI Win32_VideoController.Name(过滤虚拟显卡) | 普通 | 精简为如 RTX 4070 |
| 内存容量 | WMI Win32_ComputerSystem.TotalPhysicalMemory | 普通 | 四舍五入到 GB |
| 屏幕分辨率 | WMI Win32_VideoController.CurrentHorizontal/VerticalResolution | 普通 | 如 1920×1080 |
| 硬盘总容量 | WMI Win32_DiskDrive.Size(多盘求和) | 普通 | 换算 TB/GB |
| 电池状态 | System.Windows.Forms.SystemInformation.PowerStatus | 普通 | 电量 % + 状态,每 10 秒刷新 |
| 进程托管 | 插件 Host:node:child_process spawn + 停止信号文件 | — | 生命周期随插件启停 |
| 硬件库 | assets/LibreHardwareMonitor/LibreHardwareMonitorLib.dll | — | MIT License v0.9.6,随包内置 |
WMI 查询仅在桌宠启动时执行一次;温度采集在后台 runspace 线程每 2 秒执行,UI 线程零阻塞。
🧱 插件包结构
anan-thermal-monitor/
├── package.json # npm 包清单:声明 dsh.bundle.patch(使插件可被 dsh plugin add 识别)
├── cordis.patch.yml # 组合层 patch:把插件插入 profile 的层栈
├── lib/index.js # 插件 Host(ESM,完整 Node API):spawn/停止桌宠进程
├── assets/
│ ├── desktop-pet.ps1 # 桌宠主脚本(WPF + LHM 采集 + 自提权,路径全相对,可移植)
│ ├── 素材1号.jpg # 桌宠素材(可替换)
│ └── LibreHardwareMonitor/ # 硬件监控库(运行时依赖)
├── install.ps1 # 备选手动安装脚本
├── README.md
└── backups/ # 历史版本备份
安装原理
dsh plugin --profile add 是一个 pnpm 转发器:安装依赖后,会读取每个新依赖的 package.json,凡声明 dsh.bundle.patch 的包会自动加入 profile 的 dsh.profile.bundles 层栈;下次启动时,该 patch(cordis.patch.yml)把插件作为一行 - id: anan-thermal-monitor / name: anan-thermal-monitor 插入组合,插件 apply() 随即执行并拉起桌宠进程。
⚙️ 配置与运行时文件
- 所有资源路径基于脚本自身目录相对定位(
$PSScriptRoot),任意位置部署无需改路径 - 运行时临时文件写入
%TEMP%\anan-thermal-monitor\:
| 文件 | 作用 |
|---|---|
desktop-pet.pid | 桌宠进程 PID(插件判定运行状态) |
desktop-pet-data.json | 最新传感器数据 {cpu, mem, gpu, nvme, ts} |
desktop-pet-stop.flag | 停止信号(插件停止时写入,桌宠优雅退出) |
desktop-pet-pos.txt | 窗口位置记忆 |
desktop-pet-error.log | 运行诊断日志 |
🐛 常见问题
- 硬件显示 "--":对应传感器未暴露(如笔记本主板无板载温度传感器),非故障
- 每次启动弹 UAC:Ring0/SMBus 读取需要管理员权限,属正常现象
- 重复启动双开:脚本内置幂等检查,已运行实例存在时新实例直接退出
📄 许可
- 代码:MIT License
assets/LibreHardwareMonitor/:LibreHardwareMonitor (MIT License, v0.9.6)- 桌宠素材(
assets/素材1号.jpg)作者:X (Twitter) @yua_6ukkr,版权归原作者所有
⚙️ 配置与运行时文件
- 所有资源路径基于脚本自身目录相对定位(
$PSScriptRoot),任意位置部署无需改路径 - 运行时临时文件写入
%TEMP%\anan-thermal-monitor\:
| 文件 | 作用 |
|---|---|
desktop-pet.pid | 桌宠进程 PID(插件判定运行状态) |
desktop-pet-data.json | 最新传感器数据 {cpu, mem, gpu, nvme, ts} |
desktop-pet-stop.flag | 停止信号(插件停止时写入,桌宠优雅退出) |
desktop-pet-pos.txt | 窗口位置记忆 |
desktop-pet-error.log | 运行诊断日志 |