AI 程式助理用量化身像素英雄血條：我打造的桌面小工具 Token Slayer

我整天在 Claude Code、Codex 和 Cursor 之間切換，對於不斷檢查每個工具的剩餘用量感到厭煩。每次檢查都意味著要前往不同的地方，我重複這個動作只是為了決定接下來要使用哪個 AI 代理。因此，我打造了 Token Slayer，這是一個小巧且始終置頂的桌面小工具。

每個服務都獲得一個像素英雄，剩餘用量就是英雄的生命值（HP）。當 AI 代理工作時，英雄就會戰鬥；當它閒置時，英雄則會在營火旁休息。

Token Slayer 的功能包括：將 Claude Code（5 小時和每週）、Codex（5 小時和每週）以及 Cursor（每月）的剩餘用量顯示為英雄的 HP。當您的 AI 代理工作時，英雄會進行戰鬥，它會監測本機活動，因此英雄會在新的回合開始後幾秒內做出反應。

它還提供「用量耗盡預測」功能，根據過去 30 分鐘的使用情況，估計您何時會達到 0%。如果預計在重置前用完，它會發出警告（例如「OUT 1H20」）。此外，它設計了「升級」機制，鼓勵您使用而非囤積用量，您在使用限額時會獲得經驗值（XP）。

當每週或每月重置時間臨近，而您仍有大量剩餘用量時，經驗值會加倍（「燃燒時間」），因為未使用的配額在重置時無論如何都會消失。遊戲中包含 64 項成就（其中一些是隱藏的）、一條非常稀有的傳奇巨龍，以及一張您可以隨處分享的每週記錄卡。

客製化方面，提供 17 種免費外觀（如海盜、廚師或維京人等英雄職業、來襲敵人、休息場景），以及可選購的付費外觀包。應用程式本身是免費的，支援 macOS 和 Windows 作業系統。它沒有分析功能，也沒有我的伺服器，僅與各服務的用量 API（以及購買外觀包時的授權服務）進行通訊。

開發過程中比預期困難的部分：首先，「AI 代理現在是否正在工作？」這個問題出乎意料地難以回答。我的第一個版本使用 fs.watch 來監控檔案，但在 macOS 上，這種方法會遺漏很多情況，因為應用程式會將內容附加到已經開啟的檔案中，而這些附加操作通常不會產生事件。

對於 Cursor，我嘗試計算其 SQLite WAL 檔案的變更，但即使您什麼都不做，該檔案也會大約每 30 秒變更一次，導致訊號雜亂。最終有效的解決方案是讀取 Cursor 代理日誌檔案的最後一行：如果最後一個條目不是 turn_ended 記錄，並且檔案最近有變更，則表示一個回合正在進行中。（值得一提的是，我是從開源應用程式 Muster 中學到這個方法的。）

其次，本機顯示的用量數據與實際數據存在差異。例如，對於 Codex，我從本機會話檔案中得出的剩餘百分比是 78%，而帳戶頁面顯示的卻是 72%。來自其他裝置或網頁的使用情況不會同步到您的本機檔案。因此，我改用伺服器端的數據，只將本機數據作為備用方案。

第三，一些「用量 API」並非公開 API。Claude 和 Cursor 的用量數據來自其自家應用程式使用的端點，而非公開文件化的 API。這些端點可能會在沒有通知的情況下變更，因此應用程式將所有錯誤視為「未知」，並繼續顯示最後一個正確的值，而不是進行猜測。

一個有趣的錯誤是：Cursor 曾對一個完全有效的 token 返回 401 錯誤。原因在於 Electron 的共享 cookie jar 中存在一個過期的 cookie，它隨著我的請求一起發送。在發送請求時不帶 cookie jar 解決了這個問題。

第四，伺服器短暫回報的「0%」不應讓您升級。有一次，某個服務短暫地回報用量為 0%，然後又恢復到實際值。應用程式將這次跳動計為新的用量，導致我的 Cursor 英雄在一夜之間飆升到 12 級。現在，在同一個重置週期內，突然的跳動和下降會先等待第二次讀取確認後才計入。

立即試用：您可以免費下載 Token Slayer（支援 macOS 和 Windows），網址是：https://token-slayer.vercel.app/en。

Windows 版本尚未進行程式碼簽章，因此首次執行時 SmartScreen 會發出警告（請點擊「更多資訊」→「仍要執行」）。每個版本都附有 SHA256SUMS.txt 檔案。我非常樂意收到回饋，特別是來自 Windows 用戶或我尚未測試過的方案用戶。您認為它還應該支援哪些其他 AI 代理呢？

本文是在 AI 輔助下撰寫的；但這個專案、其中的錯誤和修復都是由我獨立完成的。