dsh-token-plan-quota

前言¶

在 DeepSeek Harness（DSH）中開發或使用智能體時，隨時瞭解當前使用的模型供應商剩餘額度是常見需求。對於 DeepSeek、Moonshot、OpenRouter 和阿里雲費用中心，有公開接口可以獲取真值。然而，阿里雲 / 千問 Token Plan 有額度卻沒有公開的額度接口；只能走控制台數據網關（Cookie 會話）。本插件把那套契約內置了，順手也把有官方接口的幾家按真值接上。

是什麼¶

這是一個 Web UI 插件，用於在輸入框工具行顯示當前模型供應商的剩餘額度。插件由 xinghe-1018 維護，主要解決“在 DSH 中查看當前模型供應商還剩多少額度”的問題，特別是補齊了阿里雲 / 千問 Token Plan 這類只有控制台數據網關（Cookie 會話）且沒有公開 API 的廠商的缺口。

核心功能¶

輸入框工具行顯示額度徽標並跟隨模型供應商切換
徽標是個小膠囊，跟隨當前模型的供應商切換。有官方接口的顯示百分比和餘量條，沒有官方接口的顯示「實測」。
支持多家廠商的官方接口獲取真值
支持 DeepSeek、Moonshot、OpenRouter、阿里雲費用中心官方接口獲取真值。
支持千問 Token Plan 控制台數據網關
支持 Token Plan 控制台數據網關（Cookie 會話）。
零配置自動識別在用路由
插件按可信度排序識別在用路由，自動補齊數據源。用戶無需寫 sources，也不用手填 providers。
不折算 Credits、不估算餘量
不折算 Credits、不估算餘量，不按歷史推算剩餘。
附 token_plan_quota 模型工具
提供了模型工具 token_plan_quota。

安裝與啓用¶

使用以下命令安裝：

dsh plugin --profile web add github:xinghe-1018/dsh-token-plan-quota

安裝後，重啓一次 dsh web 以使更改生效。

配置¶

插件支持以下配置項（默認值在代碼中）：

{
  "autoDetect": true,
  "refreshMinutes": 10,
  "pollSeconds": 10,
  "panelScope": "current",
  "debug": false
}

autoDetect：默認爲 true，按宿主在用路由自動補齊數據源。設爲 false 時以用戶寫的 sources 爲唯一事實。
panelScope：默認爲 "current"，只列當前模型供應商的卡；設爲 "all" 可查看所有。
refreshMinutes 和 pollSeconds：控制數據刷新頻率。

界面與用法¶

額度徽標：輸入框工具行裏的徽標是個小膠囊，跟隨當前模型的供應商切換。Tooltip 中包含名字、速度和天數等信息。
明細麪板：顯示官方餘量卡（有官方分母才畫條、纔給百分比）和本地實測賬本。面板可以拖成懸浮小窗（拖標題欄，雙擊復位）。
模型工具：使用 token_plan_quota 模型工具可以查詢額度。

適用場景與注意¶

適合需要實時查看各廠商剩餘額度、且不希望手動配置過多參數的用戶。
插件以當前 dsh 進程權限運行，安裝前應檢查源碼（許可證信息未在資料中明確出現）。
對於沒有官方額度接口的供應商（如 MiniMax、普通 Key），插件只顯示本實例的實測用量。
插件不做會產生計費的探活；只用只讀端點。

權限¶

插件運行時需要訪問以下網絡端點：

https://api.deepseek.com
https://api.moonshot.cn
https://api.moonshot.ai
https://openrouter.ai
https://business.aliyuncs.com
https://cs-data.qianwenai.com
https://platform-home.qianwenai.com
https://cdn.jsdelivr.net

總結¶

dsh-token-plan-quota 解決了在 DSH 中查看當前模型供應商剩餘額度的問題，特別是補齊了阿里雲 / 千問 Token Plan 這類只有控制台數據網關（Cookie 會話）且沒有公開 API 的廠商的缺口。零配置自動識別和只讀端點的設計，使其在不折算 Credits、不做計費探活的前提下，提供真值或明確的實測數據。

插件目錄：https://www.skillhub.cn/plugins/xinghe-1018/dsh-token-plan-quota
GitHub 倉庫：https://github.com/xinghe-1018/dsh-token-plan-quota