VramWidget

Windows 桌面悬浮小组件：实时监控 NVIDIA 显存 (VRAM) / 内存 (RAM) / CPU，一键释放显存与内存，并与 ComfyUI、llama.cpp 等本地 AI 服务深度联动。

单文件 C# 源码，仅依赖系统自带的 .NET Framework 4（Windows 10/11 原生支持），无需安装任何运行时。

✨ 功能

📊 实时监控

• 通过 NVML 读取 NVIDIA 显存占用、GPU 利用率、温度
• 系统内存与 CPU 使用率，1 秒刷新
• 温度监控 (v1.5.0 / v1.5.1)：面板每行显示对应温度——VRAM 行显示 GPU 温度、CPU 行显示 CPU 温度、RAM 行显示内存温度（仅有传感器时）
  • CPU/内存温度三级数据源：MSI Afterburner 共享内存 (MAHMSharedMemory，正在运行小飞机即可用) → LibreHardwareMonitor / OpenHardwareMonitor WMI 接口 → 系统 ACPI 热区，都不可用时自动隐藏该读数
  • 后台线程 3 秒轮询，不阻塞 1 秒 UI 刷新；温度 ≥65°C 橙色、≥80°C 红色预警
• 悬浮窗置顶显示，背景透明度可用滚轮任意调节

🧲 顶部吸附 · 显存小药丸模式 (v1.4.0)

• 把悬浮窗拖到屏幕顶部即吸附，收起为只显示已用显存数字的小药丸（如 15.4），边框按占用率变色（绿 → 橙 → 红），宽度自适应文字
• 小药丸鼠标完全穿透（WS_EX_TRANSPARENT）：盖在浏览器标签栏上也不挡任何点击
• 鼠标悬停到药丸上即展开完整面板，移开后约 300ms 自动收起回药丸
• 想挪位置：悬停展开后直接拖走即解除吸附

⚡ 一键清理 VRAM

• ComfyUI 模型卸载：调用 /free API（自动探测 8188 / 8189 端口），卸载加载到显存的模型
• llama.cpp KV Cache 擦除：调用 /slots/{id}?action=erase（探测 8080 / 8081 端口）擦除 slot 上下文缓存
• 进程内存整理：整理 python / llama / ollama 等 AI 进程的物理内存工作集

🧹 一键清理 RAM / 双清

• 单独清理内存，或 VRAM + RAM 一键双清，Toast 提示释放量

🛡️ 生成保护

• 清理前自动探测 ComfyUI /queue，正在出图时自动跳过清理，防止卸载模型毁掉正在生成的任务

🔗 ComfyUI 运行前联动

• 监听本机 UDP 127.0.0.1:19899，外部脚本 / 工作流在启动 ComfyUI 任务前发送信号，即可触发一次自动显存清理

🖥️ 其他实用功能

• 任意窗口置顶：托盘菜单快速勾选置顶目标窗口（免疫 Win+D 显示桌面）
• 副屏电源控制：一键开启 / 待机关闭副屏显示器
• 开机自启、托盘菜单
• 位置记忆：悬浮窗位置自动保存，重启后还原

🔧 构建

电脑需装有 NVIDIA 显卡驱动（自带 nvml.dll）。源码用系统自带的 C# 编译器即可构建：

build.cmd

• build.cmd：调用 C:\Windows\Microsoft.NET\Framework64\v4.0.30319\csc.exe 编译单文件 VramWidget.exe（含图标、manifest 与防杀毒误判的程序集元数据），随后调用 sign.ps1 签名
• sign.ps1：（可选）用本机自签名证书做 Authenticode 签名并加时间戳，需按自己环境修改证书指纹

⚠️ 重新编译前先关闭正在运行的 VramWidget.exe，否则输出文件被锁定。

📦 使用

双击 VramWidget.exe 即可运行，无安装过程：

• 悬浮窗滚轮 / 菜单调节背景透明度，拖动调整位置（自动记忆）
• 右键托盘图标打开完整菜单：清理、置顶、副屏、开机自启等

📄 相关项目

• whtools —— 同作者的 ComfyUI 综合工具箱插件