前言¶
用 DeepSeek Harness（DSH）做智能體開發時，若上游選用商湯 SenseNova Token Plan，額度、模型權限和實際消耗往往要切到網頁控制台覈對；把模型註冊進 DSH、處理限頻與配額誤判，又需要單獨配 Key 和 provider。維護者 eghrhegpe 的插件 dsh-connect-sensenova-token-plan（分類：聯網工具）把商湯 Token Plan 接進 DSH 的 Plugins 頁插件卡，並在會話輸入框右側提供常駐用量膠囊；可選地把商湯模型註冊爲 DSH provider、接入小浣熊網關，並在 Host 側對 429 做退避重試，避免限頻被當成「額度耗盡」後模型從列表裏消失。
下面按定位、功能、安裝與典型用法說明，事實以 GitHub 倉庫 README 爲準。
這是什麼¶
dsh-connect-sensenova-token-plan 是 DSH 社區插件（npm 包名同插件搜索名），當前資料中版本爲 0.8.1，MIT 許可證。它不替代商湯賬務操作：不改套餐、不代扣積分、不在面板里長期保存 Key 明文；默認以信息展示爲主（積分與消耗），真正會改動 Host 行爲的四項——註冊 provider、掛出圖工具、接小浣熊上游、切換聯網搜索——均爲 opt-in 且默認關閉。
面板是 Plugins 頁內的內聯卡片，不在側邊欄；數據來自商湯控制台 API，與網頁控制台口徑一致。
核心功能¶
三個 Tab（按使用順序）¶
-
積分額度
首次在「連接商湯控制台」填寫賬號與密碼，Host 在後臺完成標準登錄並自動續期（refresh_token 到期前換新，一般無需再輸密碼）。面板打開時輪詢只讀本地路由，關閉即停。可查看：積分池（額度窗口、已用/剩餘/百分比/重置時間、返贈餘額與到期）、模型清單（套餐覆蓋 vs 當前 Key 實際可調）、近 N 小時各模型積分消耗排名。登錄失敗時表單展示商湯返回原因（含平臺規則如多次錯誤鎖定）；清除賬號用面板底部按鈕。 -
接入 API（可選，默認關）
在「API Key」卡粘貼sk-Key 保存後，Host 以sensenova-token-plan註冊 OpenAI 兼容 provider，參與對話與出圖。語言模型列表隨/v1/models刷新，可看圖模型自動帶圖片輸入；出圖側 Host 爲 agent 註冊工具sensenova_draw_image，模型由 catalog 的output_modalities判定。開關與勾選在面板熱生效，但工具的實際掛載/缺席發生在下一次 Host 啓動（細節見倉庫docs/SETUP.md、docs/PROVIDER-HOT-RELOAD.md）。 -
小浣熊（可選，默認關）
微信掃碼登錄xiaohuanxiong.com網關，獨立賬號與獨立積分；上游限流相對寬鬆，可作 Token Plan 硬配額之外的日常通道。登錄後顯示積分餘額與模型清單，各模型展示上下文窗口、最大輸出及網關聲明的積分倍率（如free、×0.75；目錄未聲明則不顯示）。聯網搜索（默認關）：開啓後 DSH 的web_search後端改爲小浣熊託管 MCP，複用小浣熊憑據。
輸入框用量膠囊¶
會話輸入框右側常駐用量膠囊，顯示當前模型正在消耗哪套配額；點擊可展開額度卡（原始用量、重置時刻、池歸屬）。切模型即換讀數，不保留上一模型讀數。商湯檔對應 5 小時/每週等滾動窗口，小浣熊檔讀積分餘額；前綴 商湯 · / 浣熊 · 標明歸屬。
429 自愈¶
限頻被誤判爲額度耗盡時，Host 側糾正並退避重試，避免模型無端從可用列表中消失。
安裝與啓用¶
- 在 DSH「插件」頁搜索
dsh-connect-sensenova-token-plan點擊安裝，或執行：
dsh plugin --profile web add dsh-connect-sensenova-token-plan # Web 端
dsh plugin --profile desktop add dsh-connect-sensenova-token-plan # 桌面端
-
完全退出 DSH（含系統托盤）後再啓動。
-
打開 Plugins 頁，在本插件卡片內使用三個 Tab 與登錄表單。
社區目錄頁：SkillHub - dsh-connect-sensenova-token-plan。DSH 生態強調「一切皆插件」；SkillHub 等爲社區目錄，與 DeepSeek / 幻方無官方從屬關係。
典型用法¶
只盯額度（最常見默認路徑）
安裝並重啓 → Plugins 頁打開本插件 →「積分額度」Tab 連接商湯控制台 → 日常在輸入框右側膠囊查看當前模型配額，需要明細時再點開卡片或回到「積分額度」Tab 看模型消耗排名。
要在 DSH 裏直接調商湯模型
在「接入 API」Tab 打開開關並保存 sk- Key → 按文檔確認需重啓 Host 的場景（出圖工具掛載）→ 在 DSH 模型選擇中使用 sensenova-token-plan provider。
小浣熊 + 可選聯網搜索
「小浣熊」Tab 微信掃碼登錄 → 按需開啓模型與「聯網搜索」→ 憑據與小浣熊通道複用，無需單獨配搜索端點 Key。
排查 provider 是否生效
provider / 出圖開關值在插件私有狀態文件中（按 profile 分段，見倉庫 docs/PITFALLS.md）。在插件源碼目錄可運行：
npm run doctor # 人類可讀：各 profile 的 provider / draw 開關與模型清單
npm run doctor:json # JSON，便於巡檢腳本
現象導向排查見倉庫 docs/TROUBLESHOOTING.md；doctor --json 的 symptoms 與文檔中的症狀碼對齊。
適用場景與注意¶
適合誰
已在用或計劃用商湯 Token Plan 的 DSH 用戶：希望少切網頁、在會話旁看配額，並可選地把商湯/小浣熊接進同一 Host。
安全與權限
插件以當前 DSH 進程權限運行；安裝前建議閱讀 GitHub 源碼 與 LICENSE。憑據經 DSH 憑據服務保存，資料說明密碼不落盤，插件不寫明文憑據文件或調試日誌。若 refresh_token 被吊銷且環境無密碼，面板會提示重新登錄而非靜默展示舊數據。
邊界
GET /v1/models 僅區分權限，不計費、不佔推理額度；面板不代操作賬務。npm 發佈包不含完整 docs/，深度配置與踩坑列表請在 GitHub 倉庫查看（如 docs/AUTH.md、docs/SENSENOVA-API.md、docs/PITFALLS.md）。
結尾¶
dsh-connect-sensenova-token-plan 把商湯 Token Plan 的額度可視化和可選 API/小浣熊接入收攏到 DSH Plugins 頁與輸入框膠囊，默認只做展示，擴展能力按需打開。目錄與安裝入口見 SkillHub 插件頁，源碼與文檔見 GitHub。
