什麼是 PeonPing？

PeonPing 是一款必不可少的實用工具，旨在消除監控靜默 AI 代理程式終端機的挫敗感。它直接掛接到流行的 AI 編碼環境和代理程式——包括 Claude Code、Cursor、Codex 等——以便在代理程式完成任務、需要權限或遇到錯誤時，立即發出及時、帶有角色語音的聲音通知。透過將被動監控轉變為主動的聽覺回饋，PeonPing 允許開發人員和使用者專注於其他任務（如 Slack 或電子郵件），而不會丟失上下文或工作流程。

PeonPing 不僅提供簡單的警報，還提供深度客製化功能，擁有一個豐富的音效包庫，其中包含來自《魔獸爭霸 III》、《星海爭霸》和《特戰英豪》等經典遊戲的角色。使用者可以選擇他們偏好的角色語音來傳達狀態更新，確保回饋是引人入勝而非干擾性的。此外，可選的 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. 多工處理的專業人士： 與 AI 開發環境並行管理多個通訊管道（Slack、電子郵件、Jira）的使用者，可以利用獨特的角色語音，立即區分關鍵的 AI 提示和標準訊息，確保對代理程式需求的快速響應。
3. AI 代理程式開發與測試： 在建置自訂 AI 工作流程或測試新代理程式功能時，PeonPing 為每個狀態轉換（問候、權限請求、錯誤）提供清晰、明確的回饋，使調試代理程式邏輯變得更加容易。
4. 遊戲化的生產力與健身： 守衛訓練模式 (Peon Trainer Mode) 充當獨特的問責夥伴，將強制性的微鍛鍊整合到編碼時間表中，吸引那些喜歡在技術工作之餘進行遊戲化自我提升的使用者。

常見問題

問：PeonPing 官方支援哪些 AI 代理程式？ 答：PeonPing 官方支援主要平台，包括 Claude Code、Cursor、Codex、OpenCode、Kiro 和 Antigravity。也為支援自訂掛鉤的 IDE 提供了轉接器。

問：我可以建立和使用自己的自訂音效包嗎？ 答：可以。PeonPing 鼓勵社群貢獻。您可以為您的聲音建立一個 GitHub 儲存庫，註冊它，並使用 peon packs install 命令將其新增到您的系統中。

問：MCP 伺服器如何運作？ 答：MCP 伺服器允許 AI 代理程式本身透過呼叫直接的 API 端點 (play_sound) 來啟動聲音播放。這意味著決定播放哪個聲音的是代理程式本身，而不是僅僅是本機的 PeonPing 用戶端，這取決於其內部狀態。

問：PeonPing 在辦公環境中會造成干擾嗎？ 答：不會。該系統包含可在設定中配置的細微音量控制（0.0 至 1.0），允許使用者將聲音設定得足夠小，適用於共用工作空間。此外，「不重複」功能可防止同一語句連續播放。

問：什麼是守衛訓練模式 (Peon Trainer Mode)？它是如何運作的？ 答：守衛訓練模式是一種健身整合，其中守衛會不斷提醒您每天完成 300 次俯臥撐和 300 次深蹲。它會發送提醒，允許在對話中途透過命令記錄次數，並在目標達成時慶祝，有效地將您的編碼休息時間變成強制性的鍛鍊。