Show HN: Tokdash – 本地AI令牌與配額追蹤儀表盤

Tokdash 是一款面向 AI 開發者的開源本地儀表盤工具，旨在幫助使用者精確追蹤和管理 AI 客戶端（如 Claude Code、Codex 等）的令牌使用量和配額。該專案已在 GitHub 上開源，並獲得了社群的積極反饋。

Tokdash 的核心功能包括精確的令牌計數（輸入/輸出/快取分解）、貢獻日曆熱力圖（2D 和 3D 檢視）、會話探索器以及配額監控標籤頁。配額標籤頁支援顯示訂閱週期進度條和重置倒計時，適用於 Codex、Claude Code 等平臺。此外，Tokdash 還支援狀態列整合，允許使用者在 Claude Code 等代理的 statusline 中即時檢視令牌和成本資料。

安裝非常簡便，推薦使用 pipx 進行隔離安裝：pipx install tokdash。首次執行透過 tokdash setup 啟動向導，配置後臺服務並列印儀表盤 URL（預設 http://127.0.0.1:55423）。使用者還可以使用 tokdash doctor 進行環境檢查，tokdash update 進行升級，tokdash uninstall 進行解除安裝。

Tokdash 預設僅繫結到本地迴環地址，保障資料安全。對於遠端訪問，建議使用 Tailscale Serve 或 SSH 隧道。Tailscale Serve 配置簡單，嚮導可自動完成設定，但遠端訪問僅支援只讀操作，寫入操作需透過 SSH 轉發。

Tokdash 還支援持久化使用資料庫（預設啟用），將解析後的令牌資料儲存在 SQLite 索引中，提高重複查詢效能。使用者可透過環境變數自定義資料目錄、快取時間、併發限制等。整體設計注重隱私和安全性，無遙測功能，所有資料解析均在本地完成。

該專案目前處於活躍開發階段，已支援 Linux（包括 WSL2）、macOS，Windows 為實驗性支援。未來計劃包括更多客戶端的相容性改進和功能擴充套件。Tokdash 的配置選項非常豐富，包括 TOKDASH_HOST、TOKDASH_PORT、TOKDASH_CACHE_TTL 等環境變數，以及持久化資料庫的配置。此外，Tokdash 還支援透過 tokdash db 系列命令進行資料庫維護，如狀態檢查、同步、驗證和修復。

對於使用配額監控的使用者，Tokdash 提供了可選的配額輪詢功能，需要透過 tokdash quota consent 啟用，並使用本地 CLI 憑證呼叫提供商自己的配額端點。所有響應資料儲存在本地 SQLite 資料庫中。

Tokdash 的安裝嚮導還支援從舊版本遷移，例如從 v1.0 之前的版本升級時，需要先升級 tokdash 命令，然後執行 tokdash setup 以接管後臺服務。對於使用 conda 或系統 Python 的使用者，可以遷移到 Tokdash 管理的虛擬環境。

總之，Tokdash 是一個功能強大且注重隱私的本地儀表盤工具，適合所有希望精確控制 AI 令牌使用和配額的開發者和團隊。