Hatsune Miku Monitor

---

name: hatsune-miku-monitor description: 初音未来监控器 - 可爱的桌面系统监控工具（GIF动画 + 贴边隐藏 + 一键加速） version: 1.0.1 author: gsp

---

初音未来监控器

一个可爱的桌面系统监控工具，使用初音未来 GIF 动画形象。

功能特性

🎤 GIF 动画 — 流畅的初音未来动画

📊 系统监控 — 实时显示 CPU、内存、磁盘、温度

🖱️ 点击交互 — 点击初音切换状态面板

📍 贴边隐藏 — 拖到屏幕边缘自动隐藏

⚡ 一键加速 — 清理内存和系统缓存

🎨 透明度调节 — 滑条实时调整透明度

↔️ 自由拖动 — 随意移动位置

快速开始

1. 从 ClawHub 安装

clawhub install hatsune-miku-monitor

2. 准备初音 GIF 图片

将你的初音 GIF 图片放到 /tmp/chuyin.gif：

# 如果你有 chuyin.gif
cp /path/to/your/chuyin.gif /tmp/chuyin.gif
或者创建 assets 目录
mkdir -p ~/.openclaw/workspace/skills/hatsune-miku-monitor/assets
cp /path/to/your/hatsune.gif ~/.openclaw/workspace/skills/hatsune-miku-monitor/assets/

3. 安装依赖

# Ubuntu/Debian
sudo apt install python3-gi python3-gi-cairo gir1.2-gtk-3.0
安装 Python 包
pip3 install psutil pillow
或使用安装脚本
cd ~/.openclaw/workspace/skills/hatsune-miku-monitor
bash scripts/install-deps.sh

4. 启动监控器

cd ~/.openclaw/workspace/skills/hatsune-miku-monitor
python3 scripts/hatsune-ball.py
或后台运行
python3 scripts/hatsune-ball.py &

使用说明

操作方式：

点击初音 → 切换状态面板（显示/隐藏）

拖动 → 移动位置

拖到边缘 → 自动隐藏成细条

点击"⚡ 一键加速" → 清理内存和缓存

调节透明度 → 打开面板，拖动滑条

关闭 → 点击面板里的"✕ 关闭"

显示内容：

CPU 使用率

内存使用率

磁盘使用率

CPU 温度

一键加速功能

点击"⚡ 一键加速"按钮会：

Python 垃圾回收（3次）

清理系统缓存（PageCache/dentries/inodes）

Swap 刷新

清理用户缓存目录（thumbnails/pip/mesa）

清理 journalctl 日志（保留1天）

增强效果（可选）：

如果想让清理效果更明显，允许无密码执行：

sudo visudo

添加（替换 your_username）：

your_username ALL=(ALL) NOPASSWD: /usr/bin/sh -c echo * > /proc/sys/vm/drop_caches
your_username ALL=(ALL) NOPASSWD: /usr/sbin/swapoff
your_username ALL=(ALL) NOPASSWD: /usr/sbin/swapon
your_username ALL=(ALL) NOPASSWD: /usr/bin/journalctl

自定义图片

脚本会自动查找以下位置的 GIF 图片： 1. ~/.openclaw/workspace/skills/hatsune-miku-monitor/assets/hatsune.gif 2. ~/.openclaw/workspace/skills/hatsune-miku-monitor/assets/chuyin.gif 3. /tmp/chuyin.gif 4. /tmp/hatsune.gif

支持格式：GIF（推荐）、PNG、JPG

开机自启

Linux (Systemd)

创建：~/.config/systemd/user/hatsune-monitor.service

[Unit]
Description=Hatsune Miku Monitor
[Service]
ExecStart=/usr/bin/python3 %h/.openclaw/workspace/skills/hatsune-miku-monitor/scripts/hatsune-ball.py
Restart=always
[Install]
WantedBy=default.target

启用：

systemctl --user enable hatsune-monitor
systemctl --user start hatsune-monitor

故障排除

问题：ModuleNotFoundError: No module named 'gi'

解决：

sudo apt install python3-gi python3-gi-cairo gir1.2-gtk-3.0

问题：在 conda 环境中无法运行

解决： 退出 conda 环境，使用系统 Python

conda deactivate
python3 scripts/hatsune-ball.py

问题：GIF 不显示

解决： 确保 GIF 在正确位置

# 检查文件
ls -la /tmp/chuyin.gif
或
ls -la ~/.openclaw/workspace/skills/hatsune-miku-monitor/assets/
安装 Pillow
pip3 install pillow

问题：只显示笑脸图标

解决： 未找到 GIF 图片，请将初音 GIF 放到上述路径之一

许可证

MIT License