前言¶

如果你在 DSH 裏同時接了 openai-codex、kimi-coding、deepseek-official 等多個 Provider，大概遇到過兩件事：一是廠商上新模型後，llm-pi-ai.providers.<id>.models 裏的模型 id 要自己對照文檔手動補；二是各家額度分散在各自的控制檯，5 小時窗口還剩多少、按量餘額還夠不夠，切換頁面才能確認。

dsh-model-sync 把這兩件事搬進了 DSH 的設置頁：一個頁面同步模型列表，一個頁面看額度，輸入框旁邊再加一個跟隨當前會話模型的圓環。下面介紹它的功能、安裝和用法。

這是什麼¶

dsh-model-sync 是一個 DSH 插件，作者是 jiay98528-dev，許可證爲 MIT。

一句話定位：把各 Provider 的線上最新模型列表寫進 DSH 設置，輸入框圓環跟隨當前會話模型，顯示 5 小時/7 天窗口或按量剩餘餘額。它佔用兩個設置頁——Model Sync 負責拉取並寫入模型 id，Usage 負責按模型的額度讀數，Composer 圓環負責在會話內隨時可見。

核心功能¶

Model Sync：模型列表寫入設置¶

Settings → Model Sync 頁面爲每個 Provider 提供一張卡片，列出 provider id、baseURL 和模型 chips。尚未寫入設置的 id 用藍色描邊標記，點擊 Apply N new models 即寫入 llm-pi-ai.providers.<id>.models。

MiniMax、Kimi Coding 和 OpenAI Codex 沒有開放 OpenAI 風格的 /models 端點，插件對這些 Provider 使用已知目錄 id。

Usage：額度窗口與按量餘額¶

Settings → Usage 頁面按 Provider 列出額度：

• 5 小時/7 天窗口各佔一行，顯示剩餘百分比、廠商累計計數和重置倒計時（如 2d 3h left），並帶彩色進度條，顏色跟隨剩餘額度；
• 按量行顯示 current / baseline，首次採樣自動作爲基線，也可以點擊 Use current balance as baseline 把當前餘額設爲基線，餘額行會記錄基線設置時間。

Composer 圓環¶

圓環位於輸入框中模型名右側、上下文用量左側，跟隨當前會話模型，切換模型時隨之切換。同時有兩種限額的模型畫雙環：內環 5 小時、外環 7 天。懸停圓環會彈出標題爲 provider / model 的詳情卡片，每個窗口一行剩餘百分比和倒計時，例如 5 hours left 100% · 2h 15m left；kimi-coding 的充值包也放在懸停卡片中。其他 Provider 的額度仍在 Usage 頁查看。

刷新與語言¶

頁面每 60 秒自動刷新額度，也可手動點擊 Refresh 立即拉取。UI 文本跟隨 DSH 語言設置，支持英文和中文。

安裝與啓用¶

在 npm 上安裝：

dsh plugin --profile web add dsh-model-sync

也可以從 GitHub 源安裝，源碼包自帶預構建的 lib/，無需 allowBuilds：

dsh plugin --profile web add github:jiay98528-dev/dsh-model-sync

插件自帶 cordis.patch.yml bundle patch（dsh.bundle），並聲明 dsh.client.immediately: true，安裝後即生效，無需手動配置。經過上面的步驟，重啓 dsh web、刷新頁面，打開 Settings → Model Sync 即可；列表爲空時點擊 Refresh。

典型用法¶

同步模型列表¶

1、打開 Settings → Model Sync。

2、列表爲空時點擊 Refresh。

3、查看每張卡片上的 provider id、baseURL 和模型 chips，藍色描邊的 id 表示尚未寫入設置；點擊 Apply N new models 寫入 llm-pi-ai.providers.<id>.models。

4、頁面下方的 Enable plugins 摺疊塊可切換本插件和可選的 sub-model-access，它會在 cordis.patch.yml 寫入 disabled 標誌，即時生效。

查看額度¶

1、打開 Settings → Usage。

2、逐行查看各 Provider 的 5 小時/7 天窗口剩餘百分比、廠商累計計數和重置倒計時；按量行查看 current / baseline，需要時點擊 Use current balance as baseline 重設基線。

3、頁面每 60 秒自動刷新，等不及就點 Refresh。

各 Provider 的額度來源如下：

會話內看圓環¶

1、像平時一樣選擇模型。

2、看輸入框中模型名右側的圓環，它會跟隨會話模型，切換模型時跟着變。

3、懸停圓環查看詳情卡片，標題爲 provider / model，每行是一個窗口的剩餘百分比和倒計時。

配置¶

插件的默認配置如下：

- id: model-sync
  name: dsh-model-sync
  config:
    profile: web
    pollMs: 60000

兩個配置項：

適用場景與注意¶

適合同時在 DSH 裏掛多個 Provider、不想離開當前界面去查模型列表和額度的用戶。使用前有幾點需要注意：

• 額度調用使用已存於 DSH 的憑據，插件自身不保存任何密鑰。
• DeepSeek 按量基線存於 $DSH_HOME/profiles/<profile>/model-sync.baseline.json，讀數高於已存基線會被視爲充值並重置基線。
• 圓環位置綁定 DSH 0.1.0-rc.6 的 composer class names，DSH 版本更新後可能需要適配。
• 宿主代碼位於 node_modules 下；修改並重新構建本包後需重啓 dsh web，僅客戶端改動刷新頁面即可。
• xiaomi 沒有公開套餐 API，插件對其無數據。

另外，插件以當前 dsh 進程的權限運行。安裝任何插件前，建議先查看其源碼與許可證，本插件爲 MIT，源碼在 GitHub 上可直接審閱。

結尾¶

回顧一下：dsh-model-sync 做兩件事——把各 Provider 的最新模型列表同步進 DSH 設置，把 5 小時/7 天窗口和按量餘額畫成進度條與輸入框圓環；自帶 bundle patch，安裝即生效。如果你維護多 Provider 的 DSH 環境，值得裝一份試試。

• GitHub：https://github.com/jiay98528-dev/dsh-model-sync
• 社區插件目錄收錄頁（社區維護，與 DeepSeek / 幻方無官方從屬關係）：https://www.skillhub.cn/plugins/jiay98528-dev/dsh-model-sync