返回目錄

tokdash

維護狀態: 活躍

jingbiaomei/tokdash

智慧體儀表盤:以熱力圖、成本追蹤與 Token 計數視覺化各提供方的會話與配額用量,幫助分析與最佳化。

前往 GitHub專案首頁
$ dsh plugin add tokdash

92

星數

21

Fork

Python

語言

MIT

授權條款

2026-02-24

建立於

2026-11-20

最近推送

MIT 授權、本機優先的 token/成本分析儀表板,原生相容 DeepSeek Harness 本機工作階段資料,提供熱力圖、成本追蹤與配額監控。

DSH 整合

相容

作者聲明

安全稽核

未稽核

最後核實

2026-08-29

授權條款

MIT

01它能幫你完成什麼?

  • 在一套本機儀表板中追蹤並分析各 AI 編碼軟體的 token 用量與成本

    本機 Web 儀表板中的熱力圖、精確 token 拆分、成本統計與配額重置倒數,以及選用的選單列伴侶軟體

    使用 DeepSeek Harness、Claude Code、Codex、Kimi 等 Agent、希望本機掌握 token 與成本花費的開發者與團隊

  • 監控訂閱配額視窗與重置倒數

    配額標籤頁中的訂閱視窗條與重置計時器,資料來自本機日誌或 opt-in 即時輪詢

    使用按量或訂閱方案(Codex、Claude Code、Antigravity)並需避免觸達配額上限的使用者

02如何將外掛接入 DeepSeek Harness?

先決條件

  • Python **3.10+**
  • One or more [supported clients](docs/reference/SUPPORTED_CLIENTS.md) installed

安裝步驟

  1. 01

    pipx install tokdash

  2. 02

    python3 -m pip install --user tokdash

  3. 03

    tokdash setup

  4. 04

    tokdash setup --auto --json

  5. 05

    tokdash setup --dry-run

驗證整合成功

  • tokdash doctor
  • tokdash doctor --json

復原

  • tokdash uninstall

03DSH 整合程度與能力邊界

DSH 整合相容

從 $DSH_HOME/sessions 本機讀取 DeepSeek Harness(dsh)工作階段,不需 API Key,僅限本機存取,相容 DSH 資料結構

  • 精確 token 計數

    Agent 工作階段日誌(本機檔案)→Input / Output / Cache token 拆分

  • 貢獻日曆

    歷史用量記錄→以 Tokens / Cost / Messages 為指標的 2D 熱力圖 + 3D 等距視圖

  • 配額標籤頁

    本機工作階段日誌或 opt-in 即時配額輪詢→Codex、Claude Code、Antigravity 的訂閱視窗條與重置倒數

    開啟的即時輪詢會使用本機 CLI 憑證呼叫各服務商自己的配額介面
  • 狀態列整合

    本機 HTTP 介面(Tokdash API)→Claude Code 狀態列或任何可存取本機介面的 Agent 的即時 token 用量指示

  • 伴侶狀態列應用

    已設定的 Tokdash 端點→在 macOS 選單列或 Windows 通知區顯示花費與訂閱配額

    伴侶應用只連線你設定的 Tokdash 端點

04適合誰?何時不該用?

適合

  • 使用 DeepSeek Harness、Claude Code、Codex、Kimi 等 Agent、希望本機掌握 token 與成本花費的開發者與團隊
  • 使用按量或訂閱方案(Codex、Claude Code、Antigravity)並需避免觸達配額上限的使用者

不適合

  • 選用的配額輪詢僅使用你本機的 CLI 憑證呼叫服務商自己的配額介面,並將回應存入本機 usage SQLite 資料庫;預設關閉,且需逐服務商授權。

05相容性、維護與安全提醒

  • Tokdash 預設僅繫結回送位址(loopback);儀表板與本機 API 皆為唯讀且僅限 localhost,Tokdash 未執行時會靜默失敗。
  • 選用的配額輪詢僅使用你本機的 CLI 憑證呼叫服務商自己的配額介面,並將回應存入本機 usage SQLite 資料庫;預設關閉,且需逐服務商授權。
  • 成本預設依內建定價庫計算,可能落後服務商實際價格;請視為估算,重要時依帳單核對。
  • 支援 macOS;Windows 原生支援仍為實驗性質。
2026-02-242026-08-27v2.4.0

MIT · 活躍維護中(最新發布 v2.4.0,2026-08-28)

06常見問題

Tokdash 如何與 DeepSeek Harness 相容?

它直接從本機的 $DSH_HOME/sessions(預設 ~/.dsh)讀取 DSH 工作階段,不需 API Key 或連網。每個 zstd 日誌幀都會解碼,並跳過分叉工作階段的繼承前綴,避免 token 重複計費。

Tokdash 需要連網嗎?

不需要。預設全部在 localhost 運作,只讀本機日誌檔。只有當你主動開啟即時配額輪詢時才會連網,且僅用你既有的 CLI 憑證呼叫各服務商自己的配額介面。

如何安裝並驗證 Tokdash?

用 `pipx install tokdash`(或 `python3 -m pip install --user tokdash`)安裝,執行 `tokdash setup` 設定精靈,再用 `tokdash doctor` 確認執行環境、服務、埠號與資料路徑。

成本數字準確嗎?

token 計數來自各用戶端本機日誌;成本依內建定價庫計算,可能落後服務商實際價格。請視為估算,重要時依帳單核對。

如何復原(移除)Tokdash?

執行 `tokdash uninstall` 可精確撤銷 setup 所建立的項目,預設保留用量歷史;加 `--purge` 可一併清除歷史。

08資料與來源

  • 作者聲明github.com5386ed15ea6a…

    DeepSeek Harness (`dsh`) usage and sessions are read locally from `$DSH_HOME/sessions/*/*/session.jsonl.zstd` (or the un…

  • 作者聲明github.com5386ed15ea6a…

    | DeepSeek Harness | ✅ | ✅ |

此頁面根據專案公開文件、儲存庫中繼資料與 DSH Plugins 的結構化解析所產生;最後核實於 2026-08-29。發現錯誤?提交更正。

🏆

最佳 DeepSeek Harness 外掛

從全目錄挑出的 12 個值得優先安裝的外掛,涵蓋各個分類。

DSH Plugins 是獨立的 DeepSeek Harness 外掛目錄,與 DeepSeek 官方無關,也不代表官方背書。第三方外掛未經安全稽核,安裝前請審查原始碼。

每週取得最新的 DeepSeek Harness 外掛,絕不濫發。