Syrtis
Σύρτις
源自 σύρω(拖曳):潮水挾帶細沙前行,水緩處沉積成洲。

積沙成洲

Syrtis 是一款免費開源的 macOS 選單列軟體,也有 Windows 系統匣版本,直接讀取電腦上既有的 AI 寫程式工具紀錄,計算累積的 token 與花費。在本機解析超過 25 個 agent 的使用量,不需註冊帳號、不收集遙測資料,亦不同步至雲端。

brew install --cask nanako0129/tap/syrtis
需使用 Apple Silicon Mac,系統版本為 macOS 14 以上。Homebrew 安裝指令在 2.0 正式發行前為過渡版本。軟體尚未經過 Apple 公證,請透過 Homebrew 安裝,cask 會清除原本會擋下它的隔離標記。

支援 25 款以上工具的紀錄讀取,涵蓋 Claude Code、Codex、Cursor、Gemini CLI、OpenCode、Copilot、Kiro 與 Antigravity。

細沙沉積成形

單次呼叫模型的 token 微小得難以察覺,但數週積累下來,終究會顯出輪廓。Syrtis 梳理本機既有的歷程檔案,清楚呈現這些零散呼叫沉積出的總量與花費。

將一整年的使用量呈現為 3D 貢獻地形
將一整年的使用量渲染為可自由旋轉視角的 3D 地形,能按模型或 agent 堆疊,切換檢視 token 數或花費金額。

儀表板的八種視圖

總覽

平靜水面下的暗沙

《使徒行傳》第二十七章記載,水手在暴風雨中最先採取的行動,便是竭力避免船隻擱淺在隱沒難辨的 Syrtis 暗沙上。AI 服務商的用量限制亦是如此:平時沉在日常工作底層毫無跡象,直到請求中斷受阻時才猝不及防。

Syrtis 將剩餘配額常駐於選單列,可顯示為訊號條、環形進度環,或隨消耗消融的冰棒圖示。剩餘額度低於 25% 時指標轉為琥珀色,低於 10% 則變為紅色。額度卡會分析當前使用節奏是否超前或落後,並推算照此速度用盡額度的確切時間。

25% 以上
低於 25%
低於 10%

在 macOS 27 上,儀表板會以 Liquid Glass 面板懸浮展開於桌面桌布之上。

選單列上的 Syrtis:環形量表與剩餘額度 63%
選單列圖示,以實際大小呈現。

測量行星的一天

1659 年,克里斯蒂安.惠更斯在火星表面描摹出一塊暗色斑塊,見其每日重返相同位置,由此推導出火星自轉一週約為 24 小時。那塊斑塊如今被稱為 Syrtis Major,是人類在另一顆行星上記錄的第一個地表特徵,也是第一個用來度量行星晝夜的基準。克里斯蒂安.惠更斯,火星觀測紀錄,1659 年

各家配額各有其週期節奏:短則數小時的單次對話視窗,長則每週重設的完整額度。Syrtis 能倒數每次重設時間,完整留存過往週期的紀錄與花費,並標示出一週當中額度消耗最密集的鐘點。

額度
額度視圖:過往時間窗紀錄,以及額度在一週之中的消耗分布。

純本機運作

本機直接解析

透過內嵌的 tokscale-core 程式庫,Syrtis 直接讀取本機已有的對話紀錄以計算 token 與花費。解析完全在本機執行,歷史檔案絕不上傳。

無帳號、零遙測

無需註冊帳號,不設使用者身分追蹤,也不收集任何遙測資料。軟體沒有雲端後端,不同步任何資料。

連線請求完全透明

僅在必要時發起特定請求:簽署過的更新檢查、公開模型定價資料,以及僅在電腦上已有你自己的服務商憑證時(例如 Claude、Codex、Copilot 與 Grok),查詢該服務商的配額端點。每個端點只會收到它自己的憑證,除此之外不傳送至任何地方。

原名 TokenBar

macOS 版在 2.0 版本前名為 TokenBar。更名為 Syrtis,典故取自水流力竭處沉積成洲的暗沙,以及首度記錄行星自轉的火星地貌。升級至 2.0 版時,你原有的偏好設定、歷史紀錄與開機啟動項目皆會原樣保留。

〈為什麼叫 Syrtis:關於命名的文章〉

tokscale(作者 Junho Yeo)──其 tokscale-core 負責解析、去除重複紀錄與用量計價,其終端機介面亦是各個檢視模式的原型。
tokcat(作者 handlecusion)──本專案產品線的起點,也是選單列上旋轉 oiiai 貓咪的由來。
RunCat(作者 Takuto Nakamura)──原創的選單列寵物軟體,系統越忙碌時奔跑得越快。
CodexBar(作者 Peter Steinberger)──配額消耗速度計算的參考實作。

安裝 Syrtis

選擇你的作業系統平台。兩個版本皆為 MIT 授權的免費開源軟體,共用同一套 Rust 解析核心讀取本機紀錄。

brew install --cask nanako0129/tap/syrtis
需使用 Apple Silicon Mac,系統版本為 macOS 14 以上。Homebrew 安裝指令在 2.0 正式發行前為過渡版本。軟體尚未經過 Apple 公證,請透過 Homebrew 安裝,cask 會清除原本會擋下它的隔離標記。