openclaw/hatsune-miku-monitor

初音未来监控器

一个可爱的桌面系统监控工具，使用初音未来 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