← 返回 Skills 市场

Hatsune Miku Monitor

Name: Hatsune Miku Monitor
Author: 1173910773

作者 1173910773 · GitHub ↗ · v1.0.1 · MIT-0

cross-platform ⚠ suspicious

126

总下载

当前安装

版本数

在 OpenClaw 中安装

/install hatsune-miku-monitor

功能描述

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

使用说明 (SKILL.md)

初音未来监控器

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

~/.openclaw/workspace/skills/hatsune-miku-monitor/assets/hatsune.gif
~/.openclaw/workspace/skills/hatsune-miku-monitor/assets/chuyin.gif
/tmp/chuyin.gif
/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

安全使用建议

This package appears to do what it says (desktop GIF monitor + system stats) but includes instructions that can change system behavior and logs. Before installing: 1) Review the full hatsune-ball.py file (particularly the 'boost' handler) to see exactly what commands it runs when you click '一键加速'. 2) Avoid adding NOPASSWD sudoers lines — they grant passwordless root-capable actions and are risky; instead run boost commands manually or with sudo when needed. 3) Prefer installing Python deps into a virtualenv rather than system-wide pip to avoid breaking system packages. 4) If you want to test, run it in a disposable VM or container first. 5) If you proceed on a production machine, remove or modify any instructions that delete/rotate logs (journalctl) or manipulate swap without confirmation. If you want, I can scan the remainder of hatsune-ball.py (the truncated portion) for exact commands executed by the boost function and any subprocess usage — that would raise confidence in this assessment.

能力评估

ℹ Purpose & Capability

The package (GTK + psutil + Pillow, a Python UI script, asset lookup in ~/.openclaw and /tmp) aligns with a desktop GIF-based system monitor. The 'one‑click boost' feature legitimately requires elevated actions to drop caches or manage swap, but the SKILL.md goes further by recommending adding NOPASSWD sudoers entries — that is not strictly necessary and expands privilege requirements beyond a typical desktop widget.

⚠ Instruction Scope

Runtime instructions include installing system packages and global Python packages, copying GIFs to /tmp or the skill assets, creating a systemd user service, and — importantly — editing /etc/sudoers to grant NOPASSWD for echo > /proc/sys/vm/drop_caches, swapoff/swapon, and journalctl. Those steps instruct the user to enable passwordless execution of potentially destructive system commands (including log deletion via journalctl), which is out-of-scope for an untrusted third-party widget and could be abused or misapplied.

ℹ Install Mechanism

No remote download/install spec; the repo includes an install-deps.sh script that uses the system package manager (apt/dnf/pacman) and runs pip3 install globally (with --break-system-packages). That is traceable and typical, but global pip installs and the --break-system-packages flag can alter system Python packages and may have side effects. No network endpoints or obscure downloads were seen.

⚠ Credentials

The skill requests no environment variables or credentials, which is good. However, the instructions explicitly ask the user to add unsafe sudoers NOPASSWD entries to permit cache clearing, swap control, and journalctl without a password. Granting these capabilities to the user process is a privilege escalation risk and is disproportionate unless you fully trust the code and understand the implications.

✓ Persistence & Privilege

The skill suggests creating a user-level systemd service for autostart, which is standard for desktop utilities and is scoped to the user's account. The package does not request always:true or system-wide persistent privileges beyond this guidance.

如何使用

确保已安装 OpenClaw（本地或 Docker 部署）
在对话框中输入安装命令：/install hatsune-miku-monitor
安装完成后，直接呼叫该 Skill 的名称或使用 /hatsune-miku-monitor 触发
根据 Skill 的参数说明提供必要输入，即可获得结构化输出

版本历史

v1.0.1

- Improved documentation for easier installation and setup, including clearer instructions for placing custom Hatsune Miku GIFs. - Added instructions for using a new install-deps.sh script to automate dependency installation. - Clarified and simplified the one-click acceleration (清理加速) feature and GIF image selection logic. - Updated systemd auto-start and troubleshooting sections for better clarity. - Minor adjustments to feature descriptions and usage steps for improved user experience.

v1.0.0

Initial release of Hatsune Miku Monitor. - Cute desktop system monitor with animated Miku GIF - Real-time display of CPU, memory, disk usage, temperature, and FPS - Interactive features: panel toggle, drag to move, edge auto-hide, adjustable transparency - One-click system acceleration and cleaning (optional enhanced effect with proper setup) - Supports custom images for personalization - Linux systemd autostart and common troubleshooting steps provided

元数据

Slug hatsune-miku-monitor

版本 1.0.1

许可证 MIT-0

累计安装 0

当前安装数 0

历史版本数 2

常见问题