初音未来监控器

---

name: hatsune-miku-monitor

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

version: 1.0.1

author: gsp

---

# 初音未来监控器

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

功能特性

快速开始

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 &

使用说明

**操作方式：**

**显示内容：**

一键加速功能

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

**增强效果（可选）：**

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

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