前言¶
在 DeepSeek Harness（DSH）裏切換模型、跑長會話時，用量和費用往往分散在各家控制台或零散插件裏。想確認「今天花了多少 Token」「本月預算還剩多少」「GLM / Kimi 訂閱窗口還剩幾成」，通常要另開頁面或手工對賬。
下面介紹社區插件 dsh-token-dash（維護者 spartawhy117），在 DSH 輸入框旁和整頁看板裏彙總按量餘額、月度預算與訂閱配額，並在本地估算費用與真實 Tokens，支持導出 / 導入當月賬本備份。插件分類爲 admin-security，當前 npm 包版本 1.3.0，許可證 MIT。
這是什麼¶
dsh-token-dash 是 DSH 的 Web 客戶端插件：讀本地會話 usage 做記賬，憑宿主 credentials 拉取餘額與配額，費用與 Tokens 按內置價格表在本地估算，不發起計費請求。三個入口共用同一份本地賬本：底欄 Pill（當前模型）、浮層（預算 / 餘額 / 用量表）、整頁看板（7 家供應商卡片與模型明細）。
目錄頁：skillhub.cn/plugins/spartawhy117/dsh-token-dash
源碼與說明：github.com/spartawhy117/dsh-token-dash
支持的供應商與憑據¶
在 DSH 憑據設置中按下列名稱保存 Key；插件只通過宿主 credentials 讀取，不讀環境變量或本機登錄文件。填 Key 後自動探測計費形態（訂閱 / 按量）；GLM、Kimi、OpenCode Go、Command Code 可在整頁看板底部重新檢測訂閱。
| 供應商 | 計費形態 | 憑據 | 能看到什麼 |
|---|---|---|---|
| DeepSeek | 按量 | DS 賬號錢包 / DEEPSEEK_API_KEY |
賬戶餘額、本月已花、預算 |
| 智譜 GLM Coding | 訂閱 / 按量 | ZHIPU_API_KEY / GLM_API_KEY / ZAI_API_KEY |
5h + 周窗口 |
| Kimi Coding | 訂閱 / 按量 | KIMI_API_KEY / KIMI_CODING_API_KEY，可選 MOONSHOT_API_KEY |
5h + 周/月窗口；訂閱查詢失敗可回落餘額 |
| OpenRouter | 按量 | OPENROUTER_API_KEY |
Credits（USD） |
| 通義千問 | 按量 | DASHSCOPE_API_KEY（CNY）/ DASHSCOPE_INTL_API_KEY（USD） |
僅用量；餘額不支持 |
| OpenCode Go | 訂閱 | OPENCODE_GO_API_KEY |
5h / 周 / 月窗口（USD） |
| Command Code | 訂閱 | COMMAND_CODE_API_KEY + COMMAND_CODE_ORG_ID |
5h + 周窗口、Credits（CNY） |
訂閱模型計入 Tokens，但不計費用；餘額、配額、用量分開展示；餘額接口失敗不會把當天的 Token 記賬清零。
界面與典型操作¶
底欄 Pill 與浮層¶
Pill 區分按量 / 訂閱兩種形態，點擊展開浮層，點擊外部、× 或 Esc 收起。
浮層固定寬度 380，單行四組信息：已用環、已用·預算、真實餘額、本月已花（按量）；訂閱形態則展示最多三個固定槽位的窗口環、剩餘百分比與倒計時。時間範圍可選當天 / 7 天 / 30 天 / 全部，下方是用量表；模型列上限 150，Tokens / 請求 / 命中右對齊。
整頁看板¶
整頁展示 7 家供應商卡片、摘要帶、8 列模型明細（模型 / Tokens / 輸入 / 緩存 / 輸出 / 請求 / 命中 / 費用），底部爲設置膠囊：刷新間隔、賬戶餘額開關、日誌、導出導入、價格表與版本。按量卡可設預算；訂閱卡每個窗口一個環。明細除模型列外右對齊。
導出與導入¶
導出 / 導入在本地完成：導出設置與當月使用數據，不含配額、餘額與日誌；導入覆蓋前會備份原文件。換機或重裝 DSH 後可用導入恢復當月賬本。
安裝與啓用¶
需要 DSH 0.2.1 或更新；README 標明已在 DSH 0.2.2-rc.1 上驗證。DSH 0.2.2 自身要求 Node 24.9+；插件包 engines.node 爲 >=20。
推薦通過 npm 安裝到 desktop profile：
dsh plugin --profile desktop add dsh-token-dash
也可從 GitHub 直裝（純 JS，無構建）：
dsh plugin --profile desktop add github:spartawhy117/dsh-token-dash
離線場景可下載 Releases 中的 dsh-token-dash-x.y.z.tgz 後本地安裝：
dsh plugin --profile desktop add /path/to/dsh-token-dash-x.y.z.tgz
更新使用同名 update 命令（npm / github: 各自同名），或在插件設置頁「價格與版本」右側的更新入口完成。卸載用 remove 同名命令；賬本與設置保留在 $DSH_HOME/dsh-token-dash/，不隨插件包刪除。
數據、隱私與排障¶
默認數據目錄爲 $DSH_HOME/dsh-token-dash/：daily.json、months/、prefs.json。只讀本地會話 usage，不統計標題生成；憑據經宿主解析，不落盤、不寫日誌。餘額訪問官方接口；成功結果緩存 60s、失敗結果緩存 10s，併發請求會合並。
日誌位於 $DSH_HOME/logs/dsh-token-dash/，JSONL 格式。在插件倉庫目錄可執行：
npm run logs -- --tail 50
npm run logs -- --module adapter.*
npm run logs -- --module provider,route
常見前綴爲 [TD:adapter.*]（配額 / 餘額 / 偵測）、[TD:provider]（探測與緩存）、[TD:route]（路由異常）。
適用場景與注意¶
適合需要在 DSH 內持續對照 月度預算、訂閱窗口、賬戶餘額 與 真實 Tokens / 本地估算費用 的開發者。通義千問僅統計用量；上游接口有速率限制，展示以接口實際返回爲準。
DSH 生態是「一切皆插件」；SkillHub 等社區目錄爲獨立站點，與 DeepSeek / 幻方無官方從屬關係。插件以當前 DSH 進程權限運行，安裝前請閱讀源碼與 MIT 許可證，自行評估憑據與出站請求範圍。升級 DSH 後插件可能從 profile 消失，重裝同一 tarball 即可，賬本不會被刪。
結尾¶
dsh-token-dash 把當前模型 Pill、浮層用量與七家供應商整頁看板綁在同一份本地賬本上，便於在 Harness 裏看清花費與配額，並用 JSON 備份當月數據。
- 目錄頁：https://www.skillhub.cn/plugins/spartawhy117/dsh-token-dash
- GitHub：https://github.com/spartawhy117/dsh-token-dash
