PeonPing/peon-ping

peon‑ping – AI 编码助手的音视频提示

是什么 – peon‑ping 是一个轻量级辅助工具，可接入 AI 驱动的编码助手（Claude Code、GitHub Copilot、Cursor 等），让助手能与你对话。当助手完成任务、需要权限、遇到错误或发生其他重要事件时，peon‑ping 会播放一段简短的语音（通常是《魔兽》或《传送门》等游戏的梗图式台词），并显示醒目的屏幕横幅。目标是让你无需持续盯着终端或 IDE，也能保持工作流的顺畅。

如何工作 – 该项目提供一个小型 CLI（peon）和一组 钩子，支持的助手会在关键节点调用这些钩子。这些钩子会触发 编码事件音效包规范 (CESP)，将 task.complete 或 input.required 等事件映射到存储在 音效包 中的音频文件。CLI 还管理以下功能：

• 安装和切换音效包（包括社区贡献的版本）。
• 控制音量、哪些事件类别发声、是否显示桌面叠加层。
• 通过音频中继守护进程，支持远程开发（WSL2、SSH、devcontainers）。
• 可选的移动端推送通知，通过免费的 ntfy 服务实现。

主要功能

功能	你将获得
广泛的助手支持	为 Claude Code、Amp、GitHub Copilot、Codex、Cursor、Kiro、Qwen Code 等众多助手提供预设适配器。
跨平台支持	macOS、Linux、Windows、WSL2、MSYS2 – 音频播放自动适配（WPF MediaPlayer、PlaySound 或 ffmpeg 转码的 WAV）。
音效包	以游戏角色（如 GLaDOS、Kerrigan）为主题的现成音效包，以及社区音效包注册表。音效包可安装、绑定到项目，或自动轮换。
视觉叠加层	在任意屏幕上显示大而可配置的横幅（霓虹、玻璃、樱花、Jarvis），并更新终端标签页标题。
CLI 控制	peon toggle、peon volume 0.7、peon packs install …、peon preview 等。所有命令均支持 Tab 补全。
专注模式静音	可选地在 macOS 的“勿扰模式”或检测到耳机时静音。
远程开发支持	通过音频中继守护进程，将容器/SSH 会话中的声音转发到主机。
移动端通知	通过免费的 ntfy 服务推送通知；使用 peon mobile ntfy <topic> 设置。
可扩展配置	JSON 配置存储在 ~/.claude/hooks/peon-ping/（或项目本地的 .claude/），并提供交互式 peon setup 向导。

典型工作流程

1. 通过 Homebrew、提供的脚本或 Nix 安装。
2. 运行 peon setup – 选择音量、希望发声的事件类别、叠加层主题等。
3. 安装程序将适当的钩子脚本注册到你的 AI 编码助手（例如，向 ~/.claude/settings.json 添加条目）。
4. 编码过程中，助手将自动触发声音/叠加层：生成完成时显示“Work complete.”，需要权限时显示“Hmm?”等。
5. 使用 peon toggle 或 Claude Code 中的斜杠命令 /peon-ping-toggle 实时静音/取消静音，或让工具尊重你的 macOS 聚焦模式。

为何你需要它 – 如果你经常让编码助手在后台运行，可能会错过它完成任务或达到限制的时刻。peon‑ping 提供了听觉和视觉提示，让你无需频繁查看 IDE，也能保持专注。

---

安装快捷方式

• Homebrew（macOS/Linux）：brew install PeonPing/tap/peon-ping && peon-ping-setup
• 一键脚本（macOS/Linux/WSL2）：curl … | bash
• Windows PowerShell 安装器支持 -All、-Packs、-Local 等选项。
• Nix：nix run github:PeonPing/peon-ping -- status

进一步阅读 – 请访问 https://peonping.com/ 查看实时演示，查看 CESP 规范仓库（github.com/PeonPing/openpeon），以及社区音效包注册表（openpeon.com）。