peon-ping

当你的 AI 编程助手需要关注时，提供游戏角色语音提示 + 可视化覆盖通知 —— 或者通过 MCP 让代理自主选择声音。

AI 编程代理在完成任务或需要权限时通常不会主动通知你。你会因为切换窗口而失去专注，浪费 15 分钟重新找回状态。peon-ping 通过来自《魔兽争霸》、《星际争霸》、《传送门》、《塞尔达传说》等经典游戏的语音和醒目的屏幕横幅解决了这个问题。它适用于 Claude Code、Amp、GitHub Copilot、Codex、Cursor、OpenCode、Kilo CLI、Kiro、Kimi Code、Windsurf、Google Antigravity、Rovo Dev CLI、DeepAgents 以及任何 MCP 客户端。

查看演示 → peonping.com

安装
你将听到的内容
快速控制
配置
Peon 训练器
MCP 服务器
多 IDE 支持
远程开发
移动端通知
音效包
调试
卸载
系统要求
工作原理
链接

安装

选项 1：Homebrew (推荐)

brew install PeonPing/tap/peon-ping

安装完成后，运行 peon-ping-setup 来注册钩子（hooks）并下载音效包。支持 macOS 和 Linux。

选项 2：安装脚本 (macOS, Linux, WSL2)

curl -fsSL https://raw.githubusercontent.com/PeonPing/peon-ping/main/install.sh | bash

⚠️ WSL2 音频说明。 peon-ping 在 Windows 端播放音频。首次运行时，它会探测你的 Windows 主机（按 Windows 构建版本缓存）以选择最佳的播放路径：

在 Windows 10 / Windows 11 24H2 之前的版本上，直接使用 WPF MediaPlayer —— 支持原生 MP3 + WAV，无需额外依赖。
在 Windows 11 24H2+ (构建版本 26100+) 上，微软从操作系统中移除了旧版 Windows Media Player，导致 WPF MediaPlayer 报错 (MILAVERR_INVALIDWMPVERSION)。peon-ping 会回退到使用 System.Media.SoundPlayer，它调用 Win32 PlaySound API，在任何环境下都适用。但它仅支持 WAV 格式，因此 MP3 音效包需要 ffmpeg 进行实时转码：
```
sudo apt update; sudo apt install -y ffmpeg
```

你可以通过设置 PEON_WSL_AUDIO_BACKEND=auto|mediaplayer|soundplayer 来覆盖自动检测：

auto (默认) — 如上所述进行探测 + 缓存
mediaplayer — 强制使用通过 WSL UNC 路径的 WPF MediaPlayer (在 24H2+ 上会静默失败)
soundplayer — 强制使用 tmpfile 复制 + SoundPlayer (通用，非 WAV 文件需要 ffmpeg)

选项 3：Windows 安装程序

Invoke-WebRequest -Uri "https://raw.githubusercontent.com/PeonPing/peon-ping/main/install.ps1" -OutFile ".\install.ps1" -UseBasicParsing
powershell -ExecutionPolicy Bypass -File .\install.ps1

默认安装一套精选的初始音效包。重新运行即可在保留配置/状态的同时进行更新。或者访问 peonping.com 在线选择你的音效包 并获取自定义安装命令。

Windows 安装程序参数：

-All — 安装所有可用音效包
-Packs peon,sc_kerrigan,... — 仅安装特定音效包
-Lang en,fr,... — 仅安装匹配语言的音效包
-Local — 将音效包、配置、钩子和技能安装到当前项目的 ./.claude/ 目录下
-Global — 显式全局安装 (与默认行为相同)
-InitLocalConfig — 创建 ./.claude/hook