前言¶
在 DSH 裏跑模型時，常見做法是隻看平臺網頁上的賬單，或憑感覺估算 Token。官方賬單是扣費真值，但不告訴你「哪幾個模型」花了多少錢；本地會話裏 provider 上報的 usage 能按模型、按天拆開，卻可能缺上報、還混着中轉和非官方路由。只看一邊，對賬結論很容易偏。DeepSeek Usage 是社區維護的 DSH 插件，把兩種口徑放進同一面板，並給出覆蓋率與差額，方便寫代碼間隙覈對「今天燒了多少、餘額還剩多少」。
這是什麼¶
DeepSeek Usage（npm 包名 deepseek-usage）由 sdiwenchen-lang 維護，歸類爲 admin-security。當前 package 版本爲 0.1.6，許可證 MIT，Node 要求 >=18.19.0。
插件在側邊欄提供「用量」入口，點開是居中大彈窗：默認走 官方模式（無登錄表單、不接收 token、不落盤憑據），按需讀取宿主已登錄 DeepSeek 賬號的憑據記錄，調用平臺內部接口取餘額與逐日逐模型用量；可切換到 本地模式，通過 DSH 的 sessionPersistence 聚合本機會話日誌裏的 Token，並按內置/自定義費率估算費用。兩種口徑並排展示，便於校正。
核心功能¶
官方模式：賬單真值¶
取數時讀取宿主憑據：
records["deepseek-account-platform/default"].payload.token // kind: "grant"
請求帶 x-dsh-auth-token，調用 DeepSeek 平臺接口（README 註明爲抓包確認的非公開 API），例如：
| 用途 | 端點 |
|---|---|
| 餘額 / 累計消費 | GET /api/v0/users/get_user_summary |
| 用量明細（逐日逐模型） | GET /api/v0/usage/amount?month=&year= |
| 費用明細 | GET /api/v0/usage/cost?month=&year= |
在 DSH 裏登錄 DeepSeek 賬號則有數據；退出則面板提示「未檢測到 DeepSeek 賬號」。上游請求需帶瀏覽器 UA 與 x-app-version，否則可能返回 429。
本地模式：會話日誌聚合¶
不依賴 tokenizer，通過宿主可選的 sessionPersistence 讀會話事件，摺疊規則與 DSH provider-reported usage 一致：四桶互斥（cacheReadTokens、inputTokens、cacheWriteTokens、outputTokens），同一 (turn, step) 的最終 assistant/message 替換 chunk 樣本。默認包含本機所有 Provider（DeepSeek、中轉、OpenAI/Codex 等）。本地範圍不等於官方全客戶端賬單；對賬條會顯示覆蓋率與說明，不聲稱兩邊 1:1。
看板與對賬¶
- 總額：充值餘額、累計消費（官方口徑）。
- 用量趨勢：所選時間範圍內的消費、API 次數、Token；各模型堆疊柱狀圖與走勢圖。
- 本地 AI 聚合：按天/小時摺疊；金額標註「按當前費率估算」，未定價模型顯示「暫無費率」。
- 用量日曆：當月每日 Token 熱力圖，支持按周/按月跨月彙總。
- 篩選：今天 / 昨天 / 近 7 天 / 近 30 天 / 本月的 / 上月，以及模型多選。
- 各模型消費金額：圖表可在「趨勢」與「綜合」維度切換。
側邊欄底部可常駐三個摘要指標（Token / 消費 / API 次數），各自可開關、改名、換圖標並拖拽排序。面板提供 5 套主題色與 17 個內置圖標，也可上傳 PNG/JPG/SVG（≤200KB）。
本地費用估算¶
內置 139 個模型的四通道費率（輸入未命中 / 輸出 / 緩存命中 / 緩存寫入，USD/百萬 Tokens），快照日期 2026-10-30，覆蓋 15 家供應商；可在「管理定價」中增刪改模型，匯率默認 6.7 可在「顯示設置 → 定價」修改，改完重算已緩存 Token 而不重讀日誌。
插件自有 API（僅迴環）¶
端點只監聽迴環地址，並對 peer 與 Host 做雙重校驗。例如：
GET /api/deepseek-usage/summary?year=&month=GET /api/deepseek-usage/official?range=today|yesterday|last7|…GET /api/deepseek-usage/local?range=…&scope=all|deepseek&…GET /api/deepseek-usage/reconcile?range=…— 同範圍官方 vs 本地對賬
完整列表見倉庫 README。
安裝與啓用¶
插件以當前 DSH 進程權限運行；安裝前建議自行查看 GitHub 源碼 與 MIT 許可證。
DSH 桌面 App¶
desktop profile 由 Electron 獨佔，不能使用 dsh plugin --profile desktop 安裝。
- 打開 設置 → 插件
- 點 + / Add plugin
- 輸入 npm 包名
deepseek-usage（本地開發可填倉庫絕對路徑，按link:處理） - 安裝完成後完全退出並重開 DSH
剛啓動時若未見插件入口，刷新一次頁面後再試。
Web 版 / CLI¶
確認 CLI 可用：
dsh --version
若未安裝，需安裝與 App 同版本的 CLI（README 示例版本號，請換成你的 App 版本）：
npm install -g @deepseek-ai/dsh@0.2.1-rc.3
Web 版安裝：
dsh plugin --profile web add deepseek-usage
從源碼安裝（開發調試）：
dsh plugin --profile web add github:sdiwenchen-lang/DeepSeek-Usage
裝好後 重啓 DSH；側邊欄會出現「DeepSeek Usage · 用量」。
典型用法¶
- 在 DSH 中登錄 DeepSeek 賬號，安裝並重啓（或刷新）插件。
- 點擊側邊欄 用量，在默認官方視圖查看餘額、累計消費與所選時間範圍的模型用量。
- 切換到本地聚合，查看本機會話 Token 與估算費用；打開對賬相關視圖，對照覆蓋率與官方差額。
- 在「看板設置」中配置側邊欄摘要指標；在「顯示設置 → 定價」調整匯率或管理模型單價。
可選配置片段（均有默認值，見 README）：
- id: deepseek-usage-panel
name: deepseek-usage
config:
xAppVersion: "0.1.0"
requestTimeoutMs: 10000
cacheTtlMs: 600000
lookbackMonths: 24
local:
sweepTtlMs: 30000
maxSessions: 5000
pricing:
enabled: true
適用場景與注意¶
適合：需要在 DSH 內快速覈對 DeepSeek 官方扣費與本機實際 Token 消耗、按模型看趨勢、用日曆掃一眼當月用量的開發者。
注意：
- 官方數據依賴 DSH 內已登錄的 DeepSeek 賬號；插件不單獨存憑據。
- 本地日誌只覆蓋本機 DSH 會話，可能因清理或缺上報而不完整；估算費用依賴費率表，與賬單不等價處面板會標明。
- 社區插件目錄 SkillHub 條目 與 DeepSeek / 幻方無官方從屬關係；DSH 生態理念是「一切皆插件」，安裝第三方插件前應審閱源碼。
結尾¶
DeepSeek Usage 把官方賬單餘額、逐日逐模型用量與本機會話日誌聚合放在同一面板，用對賬與覆蓋率減少「只看一邊」的誤判。目錄頁與源碼：
