前言¶
在 DeepSeek Harness(DSH)裏跑智能體或接模型 API 時,賬戶餘額、限時額度和當日調用花費往往要單獨打開基元律動(tokenrhythm.studio)費用中心才能看清。社區裏曾有多渠道賬單插件,一次對接多家平臺;若你只用基元律動一家,多出來的渠道代碼和路由只會增加維護面。下面介紹由 DongHua3 維護的單渠道插件 dsh-tokenrhythm:在 DSH 側欄打開面板即可看餘額、用量、模型價格,憑據只落在本機 host 進程。
這是什麼¶
dsh-tokenrhythm 是基元律動費用中心的 DSH 插件,單渠道版。項目 fork 自 162568316/dsh-tokenrhythm-bill v0.7.5(MIT),去掉另外四家平臺,只保留基元律動。當前倉庫版本爲 0.2.0,包名、cordis id(donghua-tokenrhythm)與 HTTP 路由前綴(/dsh-tokenrhythm/*)自 0.2.0 起與上游 dsh-tokenrhythm-bill 分離,兩份可同時安裝且不會互相頂替舊行——若從 0.1.x 升級,需先在插件管理器移除舊插件 dsh-tokenrhythm-bill 再裝新包,否則側欄會出現兩條入口。
目錄頁:skillhub.cn/plugins/DongHua3/dsh-tokenrhythm
源碼:github.com/DongHua3/dsh-tokenrhythm
核心功能¶
README 與 package.json 描述中已覈實的能力如下。
餘額與用量
- 賬戶餘額與限時額度(到期失效)。
- 今日調用、輸入、輸出、緩存命中、花費五項統計。
- 近 7 天花費柱狀圖與最近調用明細;面板每 60 秒自動刷新。
- 側欄入口「基元律動-費用中心」右側顯示在用密鑰的賬戶餘額角標。
模型價格
- 22 個模型的上下文、輸入、輸出、緩存、最大輸出五項價格;折扣與峯谷分時標在價格卡上。
- 頂部可按文本、圖像、視頻篩選。
賬號與密鑰
- 密鑰管理:列表掩碼、複製完整值、新建與刪除。
- 賬號管理:多賬號、密碼登錄、Cookie 粘貼、自動續期;同一面板內可查看當前會話登錄狀態,備用時手動粘貼憑證。
其它
- 連通檢測:真實 1-token 探測,默認關閉,手動開啓纔會計費。
- 快捷鍵:
Ctrl/Cmd + J開合面板(網頁版爲Ctrl/Cmd + Alt + J;網頁版 Linux 默認不綁),可在 DSH 快捷鍵設置中修改。
安裝與啓用¶
插件以當前 DSH 進程權限運行;安裝前建議瀏覽倉庫源碼與 MIT 許可證,確認出網域名與憑據存儲方式符合你的環境策略。
桌面版:在 App 的插件管理器中選擇「添加插件」,粘貼:
github:DongHua3/dsh-tokenrhythm
命令行:僅對 web 等 profile 有效。桌面版的 desktop profile 由 Electron App 獨佔,CLI 會提示 profile "desktop" is managed exclusively by the Electron application 並拒絕寫入:
dsh plugin --profile web add github:DongHua3/dsh-tokenrhythm
裝完必須重啓 DSH。若從本地目錄安裝,將 github:... 換成目錄路徑即可。
更新方式:在插件管理器中重新添加同一地址,或再次執行上述 CLI 命令。「檢查更新」讀取本倉庫 main 分支的 package.json 版本號;結果本地緩存 24 小時。
兼容性與運行環境¶
| 項 | 要求 |
|---|---|
| DSH | 宿主需同時提供 webServer 與 web GUI;README 記載在桌面版 0.2.1-rc.3 上實測 |
| Node | ≥ 20(package.json 的 engines) |
| 系統 | 代碼無平臺專屬調用;維護者目前僅在 Windows 上驗證 |
憑據與出網¶
憑據僅寫入 host 進程本地文件 ~/.dsh/tokenrhythm-bill-state.json(文件名沿用改名前,升級不丟登錄),首次寫入權限爲 mode 0o600。Cookie、密碼、密鑰不經瀏覽器,也不上傳第三方。
出網域名僅四條:
https://tokenrhythm.studio # 基元平臺 API
https://raw.githubusercontent.com # 版本檢查(讀本倉庫 main 的 package.json)
https://cdn.jsdelivr.net/gh # raw 連不上時兜底
https://api.github.com # 最後兜底(tags 列表)
上游多渠道路由裏涉及的 stepfun、tierflow、opencsg、zcode、bigmodel 等域名在本 fork 中不再訪問。
典型用法¶
- 按上一節安裝並重啓 DSH。
- 在插件面板「密鑰 / 賬號」頁添加基元律動賬號或粘貼 Cookie,確認側欄餘額角標有數。
- 用
Ctrl/Cmd + J(或你在 DSH 裏改過的快捷鍵)打開費用中心,查看餘額頁、模型價格卡與調用明細。 - 若需確認 API 可達,在設置中手動開啓連通檢測(默認關閉,開啓後會產生 1-token 計費)。
倉庫提供冒煙自檢,與 CI 在每次 push 時執行同一腳本:
node scripts/smoke.mjs
覆蓋語法、加載、路由註冊與跨站攔截四項。
適用場景與注意¶
適合只使用基元律動(tokenrhythm.studio)、希望在 DSH 內集中看賬單與模型價目、且接受憑據存本機 host 的開發者。若仍需階躍、Tierflow 等多平臺賬單,應使用上游 dsh-tokenrhythm-bill 而非本單渠道 fork。
DSH 社區插件目錄(如 skillhub.cn)爲獨立站點,與 DeepSeek / 幻方無官方從屬關係;安裝命令以 README 爲準,勿憑插件名自行拼接錯誤 owner 或 repo。
README 註明:npm run lint 當前爲 0 error / 96 warning,均爲刪掉四家渠道後 lib/client.js 中遺留的未使用變量,不影響運行;CI 使用 --quiet 僅報 error。
結尾¶
dsh-tokenrhythm 把基元律動費用中心收進 DSH 側欄:餘額、限時額度、用量與 22 個模型價格在一處刷新,憑據與出網範圍在文檔裏寫得很清楚。需要安裝入口或 issue 時,見 目錄頁 與 GitHub 倉庫。