hsp-pi

树莓派任务完成通知工具,静默工作,完成后发声提醒

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:hsp-pi。
它的用途是:树莓派任务完成通知工具,静默工作,完成后发声提醒
详细介绍见:https://321skill.com/skills/hsp-pi/
请根据该页面的说明完成安装。

使用示例

'帮我编译树莓派上的内核,完成后用声音通知我',它会调用 hsp-pi 执行 'make -j4',编译结束后立即播放 R2 啁啾声提醒你。或者

对AI说:'监控我树莓派上的数据备份任务,完成时通知我',AI 会使用 hsp-pi 包装 rsync 命令,后台静默运行,备份完成后发出提示音。

介绍

在树莓派上执行长时间任务(如编译、数据处理、模型训练)时,你往往需要不断查看进度,或者担心任务完成而错过提醒。HSP Relay for Pi 解决了这个问题:它专为树莓派设计,在任务执行期间保持完全静默,不占用系统资源,一旦任务结束,会通过树莓派的扬声器或蜂鸣器发出标志性的“R2 settle chatter”声音,让你第一时间感知完成。

使用方式非常简单:通过 npm 安装 hsp-pi 包,在你的脚本或命令行中调用 hsp-pi 命令,将任务执行命令作为参数传入。例如 hsp-pi --cmd 'make build',工具会在命令执行完毕后自动播放提示音,同时支持静音模式、自定义音频文件等高级配置。支持与 Bash、Python、Node.js 等任何生成进程的脚本集成。

适合树莓派开发者、IoT 项目爱好者、运维工程师、以及任何需要在树莓派上运行后台任务并希望获得非侵入式通知的用户。尤其适合在无屏幕、无图形界面的环境中使用,例如在树莓派 Zero 或远程 SSH 场景下,通过声音信号代替视觉检查。

建议在安静的工作环境或耳机场景下使用,避免声音干扰他人。注意树莓派板载音频输出可能需要额外配置。如果任务需要多阶段通知或实时进度反馈,本工具可能不适用,建议搭配其他监控方案。

核心特点

区别于通用的通知工具(如 pushover 或桌面通知),hsp-pi 专为树莓派硬件优化,使用 HSP 协议实现零资源占用,并且以独特的 R2 机器人音效作为完成提示,既有趣又实用,无需依赖网络或外部服务。

注意事项

不适合需要实时进度条或连续日志输出的场景,也无法在无音频输出硬件的树莓派上工作(如仅通过 GPIO 控制)。

常见问题

如何安装 hsp-pi?

全局安装:npm install -g hsp-pi,或作为项目依赖:npm install hsp-pi

hsp-pi 支持自定义提示音吗?

支持,通过 --sound 参数指定 wav/mp3 文件路径,或使用内置音效库。