dsh-better-model-select：模型列表實時同步與用量徽標

在 DSH (DeepSeek Harness) 的日常開發中，模型列表的更新和用量監控是兩個高頻痛點。DSH 內置的模型發現機制對已安裝的 provider（如 GLM Coding、MiniMax 等）返回的是打包時的靜態目錄，新發布的模型需要等待 pi-ai 升級才能出現。同時，原生界面缺乏對各類 provider 實時用量的展示。dsh-better-model-select 插件通過 API 同步和 RPC 通道解決了這兩點。

這是一個 DSH 插件，旨在讓模型列表跟隨各 provider 的 API 實時更新，並將各 provider 的實時用量顯示在原生會話統計行下方。插件由 sxy-kumako 維護，屬於聯網工具類別。

模型列表實時同步¶

DSH 內置的模型發現對 pi-ai 目錄裏已有的 provider 會直接返回打包時的靜態目錄，從不請求遠端接口。本插件補上這一環：

定時讀取：插件每 30 分鐘（包含啓動時）讀取 llm-pi-ai.providers 下配置的每條路由。
API 請求：利用該路由的憑據（通過 DSH 憑據庫解析），請求 provider 的模型列表接口（OpenAI 兼容 GET {baseURL}/models 或 Anthropic 兼容格式）。
合併與寫入：將遠端列表與已安裝目錄合併。目錄已有的模型保持原樣（裸 {id} 條目會自動繼承目錄完整定義），遠端新增的模型會根據同家族目錄模型生成完整條目。用戶手寫的條目永遠優先，不會被刪除。
實時生效：結果寫入該路由的 models 設置列表。模型選擇器實時生效，無需重啓。
容錯處理：一次失敗的遠端請求不會寫任何東西；寫入被 llm-pi-ai 校驗拒絕時僅記日誌、保留原值。

用量徽標與顏色¶

插件通過 RPC 通道 /dsh-better-model-select 向宿主暴露用量數據。

顯示內容：
- GLM / MiniMax：顯示編碼計劃剩餘量（5 小時窗口 + 周窗口）。
- DeepSeek / OpenRouter / Kimi：顯示現金餘額。
顏色編碼：
- 剩餘量 >30%：綠色
- 剩餘量 ≤30%：橙色
- 剩餘量 ≤10%：紅色

安裝與啓用¶

    cd ~/.dsh/profiles/<你的 profile>          # 例如 desktop 或 web

刪除舊版插件副本（更新時必須先刪，不要原地覆蓋）：

    rm -rf node_modules/dsh-better-model-select

複製新插件到 node_modules：

    cp -R ~/.dsh/plugins/dsh-better-model-select node_modules/

重啓 DSH Desktop。

典型用法¶

實時生效：配置寫入 models 設置後，模型選擇器立即生效，無需重啓。
手動同步模型列表：在會話中輸入 /dsh-better-model-select?syncModels。
強制刷新用量數據：在會話中輸入 /dsh-better-model-select?quota=force。

適用場景與注意¶

直連模式：歷史版本內置的 127.0.0.1:9999 代理已移除，provider 請求走 DSH (pi-ai) 原生直連。
數據安全：憑據通過 DSH 憑據庫解析，不會落日誌。一次失敗的遠端請求不會寫任何東西。
權限與源碼：插件以當前 DSH 進程權限運行。安裝前建議檢查源碼與許可證。

該插件通過定時同步與 RPC 暴露，解決了模型列表滯後和用量不透明的問題。更多細節與源碼見：GitHub。