什么是 PeonPing？

PeonPing 是一款必不可少的实用工具，旨在消除监控静默 AI 代理终端的烦恼。它直接挂接到流行的 AI 编码环境和代理（包括 Claude Code、Cursor、Codex 等），在代理完成任务、需要权限或遇到错误时，立即以富有特色的声音发送及时通知。通过将被动监控转变为主动的听觉反馈，PeonPing 允许开发人员和用户专注于其他任务（如 Slack 或电子邮件），而不会丢失上下文或工作流程。

PeonPing 不仅仅提供简单的警报，它还通过一个庞大的音效包库提供深度定制，该音效库包含来自《魔兽争霸 III》、《星际争霸》和《军团要塞 2》等经典游戏的角色的声音。用户可以选择自己喜欢的角色声音来传达状态更新，确保反馈是引人入胜而不是干扰性的。此外，可选的 MCP（主控制程序）服务器允许 AI 代理本身动态选择和播放适当的声音，提供真正集成和智能的通知体验。

核心特性

• 广泛的代理兼容性： 通过专用的挂钩和适配器，与 Claude Code、Cursor、Codex、OpenCode、Kiro、Windsurf、Antigravity 以及其他 IDE/代理无缝集成。
• 丰富的音效包系统： 涵盖 7 种语言的 75 多个音效包，收录了标志性角色（如兽人农民、莎拉·凯瑞根、TF2 工程师、GLaDOS 等）。用户可以轻松更换音效包或创建和注册自己的音效包。
• 主控制程序 (MCP) 服务器： 使 AI 代理能够直接触发特定声音，允许代理根据上下文选择自己的反馈机制。
• 工作流程增强： 当终端窗口未聚焦时提供桌面通知，并提供动态标签标题以显示项目状态（例如，任务完成后显示一个点指示器）。
• 智能播放控制： 具有音量控制（0.0 – 1.0）、类别切换（问候、确认、错误、权限）和一个“不重复”系统，该系统会跟踪最近播放的台词，以防止听觉疲劳。
• 农民训练模式 (Peon Trainer Mode) (2.0 新增)： 一项独特的、游戏化的功能，在编码会话之间“督促”用户完成每日健身目标（300 个俯卧撑/深蹲），通过 Claude 技能记录次数并庆祝目标达成。

如何使用 PeonPing

开始使用 PeonPing 非常简单，主要涉及通过包管理器安装或直接执行脚本。

1. 安装： 使用 Homebrew（brew install PeonPing/tap/peon-ping）或通过提供的 curl 脚本进行直接 bash 安装。
2. 配置与音效包选择： 在安装之前，用户可以访问网站选择他们想要的音效包（例如，默认兽人农民、星际争霸战列巡航舰）。安装命令会根据这些选择实时更新。
3. 集成： 确保您的 AI 代理（如 Claude Code 或 Cursor）已配置为使用 PeonPing 进行通知。对于高级控制，可以启用 MCP 服务器，以便代理处理声音播放。
4. 工作流程监控： 激活后，只需启动您的 AI 代理任务。当代理需要权限、完成工作或遇到错误时，PeonPing 会通过声音提醒您，让您可以放心地切换上下文。
5. 定制： 修改配置文件以调整音量、切换特定声音类别（如禁用“恼怒”的声音），或使用 peon packs install 命令安装新包。

使用场景

1. 深度专注编码会话： 处理复杂问题的开发人员可以深入研究代码或文档，完全依赖 PeonPing 独特的声音提示，仅在 AI 代理需要输入或发出完成信号时才将他们拉回，从而最大限度地提高不间断的流畅状态。
2. 多任务处理专业人士： 在管理多个通信渠道（Slack、电子邮件、Jira）以及 AI 开发环境的同时，可以使用独特角色声音立即区分关键的 AI 提示和标准消息，确保对代理需求做出快速响应。
3. AI 代理开发与测试： 在构建自定义 AI 工作流程或测试新代理功能时，PeonPing 为每个状态转换（问候、权限请求、错误）提供清晰、明确的反馈，使调试代理逻辑变得更加容易。
4. 游戏化生产力与健身： 农民训练模式充当独特的问责伙伴，将强制性的微型锻炼融入编码时间表，吸引那些喜欢在技术工作的同时进行游戏化自我提升的用户。

常见问题 (FAQ)

问：PeonPing 官方支持哪些 AI 代理？ A：PeonPing 官方支持主要平台，包括 Claude Code、Cursor、Codex、OpenCode、Kiro 和 Antigravity。也为支持自定义挂钩的 IDE 提供了适配器。

问：我可以创建和使用自己的自定义音效包吗？ A：可以。PeonPing 鼓励社区贡献。您可以为声音创建一个 GitHub 存储库，注册它，然后使用 peon packs install 命令将其添加到您的系统中。

问：MCP 服务器如何工作？ A：MCP 服务器允许 AI 代理本身通过调用直接 API 端点（play_sound）来启动声音播放。这意味着决定播放哪种声音的是代理本身，而不是本地的 PeonPing 客户端，这是基于其内部状态决定的。

问：PeonPing 在办公室环境中会造成干扰吗？ A：不会。该系统包含可在设置中配置的精细音量控制（0.0 至 1.0），允许用户将声音设置得足够小，以适应共享工作空间。此外，“不重复”功能可防止同一台词连续播放。

问：什么是农民训练模式及其功能？ A：农民训练模式是一种健身集成，其中“农民”会“唠叨”您每天完成 300 个俯卧撑和 300 个深蹲。它会发送提醒，允许在对话中途通过命令记录次数，并在目标达成时进行庆祝，有效地将您的编码休息时间变成强制性锻炼。