前言¶
用 NewAPI 搭中轉站的開發者，查用量通常有兩條路：登錄站點後臺翻頁面，或者把令牌寫進腳本里調接口。前者要切換上下文，後者要把系統訪問令牌落到本地代碼裏。這個插件的做法是第三條路：在 DeepSeek Harness（DSH）Web 界面裏做一個側邊欄入口，填一次站點地址和系統訪問令牌，餘額、消費、請求數、令牌明細直接在面板裏看。
下面介紹 zzh407/dsh-newapi-usage 這個 DSH Web 插件：它解決什麼問題，怎麼安裝，面板裏具體有什麼，以及使用上的限制。
這是什麼¶
- 插件名：
dsh-newapi-usage，倉庫zzh407/dsh-newapi-usage，維護者 zzh407，分類屬於社區目錄裏的「聯網工具」。 - 定位：一個 DSH Web 插件，用來查看一個或多個 NewAPI 站點的賬戶餘額與用量。
- 核心區別：令牌不需要寫進插件配置文件或瀏覽器代碼。插件把站點地址和令牌存在 DSH 的本地憑據裏，請求由 DSH Host 發出，瀏覽器側只拿脫敏結果。
- 許可證：MIT License。當前版本
1.0.1，要求 Node.js >= 20。
安裝與啓用¶
安裝走 DSH 的插件命令，從 GitHub 裝：
npx -p @deepseek-ai/dsh dsh plugin --profile web add github:zzh407/dsh-newapi-usage
裝完如果命令提示需要重啓，就重啓一次 DSH Web 進程。重啓後側邊欄會出現 NewAPI 用量 入口。
插件要求使用 DSH 的 Web profile，並且啓用 Web UI、Connection、Credentials、Layout、Sidebar 這幾個服務；否則側邊欄掛不上。
配置站點¶
面板裏沒有預置站點，第一次使用需要手動添加：
- 點側邊欄的 NewAPI 用量。
- 點 站點管理 → 添加站點。
- 填站點名稱（可選）、站點地址（如
https://newapi.example.com）和系統訪問令牌。 - 點 保存。保存時面板會嘗試訪問站點，地址或令牌不對會直接報錯。
- 要加第二個站點就重複上面幾步，之後通過面板頂部的站點按鈕切換。
系統訪問令牌（通常以 nap_ 開頭）一般在 NewAPI 控制台的「個人設置 → 系統訪問令牌」裏生成，具體入口以站點界面爲準。用於模型調用的 sk-... 中繼密鑰不能替代它，管理接口不認。
編輯已有站點時，令牌留空表示保留原值；要輪換令牌就填新值。已保存的完整令牌不會從 Host 返回到瀏覽器。
兩個地址上的坑，README 明確寫了：插件不跟隨 HTTP 重定向（避免把令牌轉發到別的地址），所以遇到重定向要填最終的 API 站點地址；地址裏也不能嵌入用戶名或密碼。
面板能看到什麼¶
- 賬戶概覽：餘額、累計消費、累計請求次數、今日消費、本月消費、RPM/TPM。
- 近 7 天消費圖表，按天展示消費變化。
- 令牌明細：各個 API Key 的已用額度、剩餘額度、無限額度標記和狀態。
- 多站點管理：添加、編輯、刪除站點，憑據獨立保存。
金額是換算出來的展示值，不是結算匯率。插件優先從 /api/status 讀站點的額度倍率和貨幣符號，讀不到時按每單位貨幣 500,000 quota 的默認倍率算，金額 = quota / quota_per_unit。
統計口徑與刷新¶
面板的數字來自這幾個接口：
| 指標 | 接口 |
|---|---|
| 餘額、累計消費、請求次數 | /api/user/self |
| 今日、本月消費、RPM/TPM | /api/log/self/stat，消費類型 type=2 |
| 近 7 天消費 | 每天分別查一次 /api/log/self/stat |
| API Key 明細 | /api/token/ |
| 額度倍率、貨幣符號 | /api/status |
清單說明：
- 日期邊界按瀏覽器本地時區算每天、每月的起點。
- 趨勢圖刻意不用
/api/data/self，因爲它的聚合方式會隨版本或站點配置變化，每日統計接口更穩定。 - 緩存約 60 秒；打開面板時加載一次，停留期間每 2 分鐘自動刷新，也可以點 刷新 手動更新。
- 加載是分階段的：先出賬戶概覽，日/月統計和令牌明細在後臺取，完成前用面板輪詢補齊。
隱私與權限¶
- 站點名稱、地址、令牌保存在 DSH 本地憑據記錄
newapi-usage/sites裏，憑據文件由 DSH 管理，不屬於插件倉庫內容。 - 瀏覽器通過本地 DSH 已鑑權的 Connection 路由請求，只有 Host 會訪問你配置的 NewAPI 站點。接口請求通過
Authorization請求頭帶上該站點的令牌。 - 插件本身不含統計分析、遙測或第三方代理。
- 安裝插件等於信任它的源碼，以及它申請使用的 DSH Host/Client 服務權限。它是以當前 dsh 進程的權限運行的，所以安裝前應先打開倉庫審查代碼，確認調用的接口和權限範圍符合預期。
- 只添加可信站點，儘量用能滿足查詢需求的最小權限令牌。不要把自己真實令牌、賬戶數據或本地憑據文件提交到 GitHub。
誰適合用¶
適合已經在用 DSH Web profile、同時跑着 NewAPI 中轉站的開發者。站點和接口版本差異比較大的情況（比如二次開發改了 /api/log/self/stat 的返回結構），插件遇到不可用的統計或令牌接口會彈錯誤或警告，這類站點需要先確認接口兼容性。如果你的站點沒有上面那四個管理接口，面板拿不到數據，裝了也用不起來。
結語¶
這個插件的價值在於把「查中轉站用量」這件事收斂到 DSH 側邊欄裏，憑據不落瀏覽器、不進配置文件，刷新策略和統計口徑也寫清楚了。生態上它是社區開發的插件，掛在第三方目錄裏，不是 DeepSeek 官方出品。
- 目錄頁：https://www.skillhub.cn/plugins/zzh407/dsh-newapi-usage
- GitHub：https://github.com/zzh407/dsh-newapi-usage
