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 令牌使用和配額的開發者和團隊。