peon-ping

English | 한국어 | 中文 | 日本語

当你的 AI 编程助手需要关注时，提供游戏角色语音及可视化叠加通知 — 或者通过 MCP 让 AI 自行选择提示音。

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 Trainer
• MCP server
• 多 IDE 支持
• 远程开发 (SSH / DevContainers / Codespaces)
• 移动端通知
• 音效包
• 调试
• 卸载
• 系统需求
• 工作原理
• 相关链接

---

安装

方式 1：Homebrew (推荐)

brew install PeonPing/tap/peon-ping

然后运行 peon-ping-setup 来注册钩子并下载音效包。适用于 macOS 和 Linux。

方式 2：安装脚本 (macOS, Linux, WSL2)

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

⚠️ 在 WSL2 中，如果使用非 WAV 格式的音效包，必须安装 ffmpeg。在 Debian 发行版中，请运行：

sudo apt update; sudo apt install -y ffmpeg

方式 3：Windows 安装程序

Invoke-WebRequest -Uri "https://raw.githubusercontent.com/PeonPing/peon-ping/main/install.ps1" -UseBasicParsing | Invoke-Expression

默认会安装 5 个精选音效包（魔兽争霸、星际争霸、传送门）。重新运行即可更新，同时保留配置/状态。或者前往 peonping.com/#picker 交互式选择你喜欢的音效包并获取定制安装命令。

有用的安装参数：

• --all — 安装所有可用音效包
• --packs=peon,sc_kerrigan,... — 仅安装特定音效包
• --local — 将音效包、配置和钩子安装到当前项目的 ./.claude/ 目录下
• --global — 显式全局安装（默认行为）
• --init-local-config — 仅创建 ./.claude/hooks/peon-ping/config.json 文件

使用 --local 不会修改你的 shell 配置文件（不会注入全局 peon 别名或补全）。钩子以绝对路径注册在项目级的 ./.claude/settings.json 中，因此在项目内的任何工作目录下均可正常工作。

示例：

curl -fsSL https://raw.githubusercontent.com/PeonPing/peon-ping/main/install.sh | bash -s -- --all
curl -fsSL https://raw.githubusercontent.com/PeonPing/peon-ping/main/install.sh | bash -s -- --packs=peon,sc_kerrigan
curl -fsSL https://raw.githubusercontent.com/PeonPing/peon-ping/main/install.sh | bash -s -- --local

如果系统中已存在全局安装版本，而你尝试进行本地安装（反之亦然），安装程序会提示你移除现有版本以避免冲突。

方式 4：克隆并检出代码

git clone https://github.com/PeonPing/peon-ping.git
cd peon-ping
./install.sh

方式 5：Nix (macOS, Linux)

直接从源码运行，无需安装：

nix run github:PeonPing/peon-ping -- status