前言¶

用 DeepSeek Harness（DSH）跑 Web 界面時，錢包餘額、本月大概花了多少、當前是峯時還是谷時，往往要另開頁面或自己對照定價表心算。本地會話日誌裏已經有 token 用量，但默認界面不會把這些信息收成一塊可點的摘要。

下面介紹社區插件 dsh-usage-dashboard（維護者 MrXiongBear，分類：客戶端）。它在 DSH Web 左下角側邊欄實時顯示 API 餘額、基於本地用量的消費估算、峯谷時段倒計時；點擊可展開完整用量儀表盤，並可在面板裏切換默認 LLM 服務商。數據在本機讀取與展示，不上傳第三方服務器。

這是什麼¶

dsh-usage-dashboard 是面向 DSH Web 的客戶端 bundle 插件：Host 端通過 Cordis 補丁註冊認證路由，瀏覽器端注入側邊欄與佈局相關模塊，在左下角固定展示摘要，點擊打開儀表盤。

倉庫說明其爲實驗性、自用性質，緊貼 DSH 的 apply / inject / client bundle 等接縫，僅在作者驗證過的 DSH 版本上測試；宿主升級後可能失效。代碼與文檔標註爲 AI 生成，未經專業人工審計，生產環境需自行評估。

許可爲 MIT（package.json 版本 1.0.0）。社區目錄頁：skillhub.cn 插件頁；源碼與說明：GitHub 倉庫。

核心功能¶

側邊欄摘要¶

• 餘額：通過 deepseekAccount.getBalance 讀取 DeepSeek 賬戶錢包（人民幣 / 美元），固定顯示，不可在設置裏關閉。
• 消費估算：按本地持久化的 token 用量，結合每次調用所處峯時或谷時對應單價估算，不是官方賬單。
• 峯谷倒計時：按北京時間與 DeepSeek 官方計費窗口計算。峯時爲週一至週五 09:00–12:00、14:00–18:00（不含法定節假日）；其餘含週末與節假日爲谷時。顯示形如 峯時：01:32:10 或 谷時：15:00:00，峯時與谷時用顏色區分（文檔描述爲珊瑚紅 / 綠色，標籤文字仍保留）。

底部固定兩行：第一行 餘額 + 消費，第二行 峯谷狀態 + 倒計時。消費過長時在行內省略，完整值可在儀表盤中查看。

完整用量儀表盤¶

點擊側邊欄摘要打開面板，主要包括：

• Token 用量：日 / 月 / 年 / 全部累計及各自估算消費；面板內 token 爲完整千分位，左下角摘要仍用緊湊單位。數據來自本機 DSH 會話日誌（含緩存命中與推理 token），按會話版本緩存。
• 分任務用量：按會話列出標題、今日與累計 token、今日估算消費；子代理帶 sub 標記，最近活躍帶 recent。支持按標題或 ID 搜索、按今日或累計 token 排序，默認 12 條，可展開至最多 100 條。
• 默認 API 切換：列出可用 llm 服務商與模型，切換後寫入 agentDefaultModel，對新建會話生效。

側邊欄顯示設置¶

儀表盤內「側邊欄顯示」可開關：消費估算、峯谷狀態、日 / 月 / 年 token（日 / 月 / 年默認關）；餘額不可關。字號 10px–16px，默認 12px。配置保存在瀏覽器 localStorage 鍵 dsh-usage-dashboard:footer-items。

Host 端在 /api/usage-dashboard/ 下提供需認證的 Connection Fetch 路由；價格表 PRICING_CNY、2026 年節假日 HOLIDAY_RANGES_2026 等在 index.js 中維護，定價與國務院通知鏈接見 README「已知限制」。

安裝與啓用¶

DSH 的 profile 加載爲全有或全無：任一插件 import 失敗可能影響整個 profile。安裝前建議備份 profile 內的 package.json 與 cordis.patch.yml。

官方安裝命令（Web profile）：

dsh plugin --profile web add github:MrXiongBear/dsh-usage-dashboard

裝完後重啓 dsh web，左下角應出現摘要區域。

若提示需要 allowBuilds 授權，將 pnpm 輸出的包名寫入該 profile 的 pnpm-workspace.yaml：

allowBuilds:
  dsh-usage-dashboard: true

然後重新執行上面的 add。本項目爲純 JavaScript，通常不會觸發構建授權。

如需鎖定 commit，避免後續更新靜默變更運行代碼：

dsh plugin --profile web add github:MrXiongBear/dsh-usage-dashboard#<commit-sha>

查看與卸載：

dsh plugin --profile web list
dsh plugin --profile web remove dsh-usage-dashboard

插件以當前 DSH 進程權限運行；安裝前宜瀏覽倉庫源碼與 MIT 許可條款，確認符合你的安全與合規要求。

典型用法¶

1. 按上一節命令安裝並重啓 dsh web。
2. 若需看餘額，使用已登錄 DeepSeek 賬戶的環境（僅用 API Key 時仍可用 token 統計與服務商切換，但餘額不可用）。
3. 日常在左下角查看餘額、估算消費與峯谷倒計時；需要明細時在摘要上點擊進入儀表盤，搜索或排序任務用量，在面板中調整側邊欄顯示項與字號。
4. 若要更換默認模型，在儀表盤「默認 API 切換」中選擇服務商與模型，之後新建會話會使用新默認值。

適用場景與注意¶

適合：長期在單機 DSH Web 上開發智能體、希望少開外部頁面、用本地日誌粗算消費並關注 DeepSeek 峯谷計費的開發者。

限制（來自 README）：

• Token 統計僅覆蓋當前機器上的 DSH，不含其他工具或設備。
• 節假日表目前只覆蓋 2026 年；跨年後需更新 index.js 中 HOLIDAY_RANGES_2026，否則儀表盤會提示峯谷判斷可能失效。
• 官方調價後需更新 index.js 中 PRICING_CNY。
• 餘額依賴 DSH 自身認證通道；隱私說明稱無第三方依賴、無外部腳本與埋點。

卸載或回滾：從 dsh.profile.bundles 移除登記 → pnpm remove 或刪除 link → 重啓；異常時用備份的 package.json 與 cordis.patch.yml 還原。

結尾¶

dsh-usage-dashboard 把餘額、估算消費、峯谷倒計時和分任務 token 用量收到 DSH Web 左下角與可展開面板裏，並支持切換默認 LLM，適合在本機 DSH 上持續跑 Web 工作流的開發者。DeepSeek Harness 生態強調「一切皆插件」；社區目錄爲獨立站點，與 DeepSeek / 幻方無官方從屬關係。

• 目錄頁：https://www.skillhub.cn/plugins/MrXiongBear/dsh-usage-dashboard
• GitHub：https://github.com/MrXiongBear/dsh-usage-dashboard

問題可在倉庫 Issues 反饋。