前言¶

DeepSeek Harness 的理念是「一切皆插件」，社區可以把模型供應商、工作流和展示面板作爲插件接入 DSH。日常使用 DSH 做智能體開發時，常見的問題不只是“能不能調用某個模型”，還包括：OAuth 賬號和 API key 如何管理、模型列表是否最新、當天消耗了多少 token、估算花費是多少、訂閱計劃還剩多少額度。

dsh-providers 是一個面向 DeepSeek Harness 的模型供應商插件：用 OAuth 或 API key 登錄，並儘量保持每個供應商的模型目錄最新。它不是官方應用商店裏的產品；DeepSeek Harness 社區目錄是獨立站點，與 DeepSeek / 幻方沒有官方從屬關係。

這是什麼¶

dsh-providers 由 tyql688 維護，許可證爲 MIT。

它的一句話定位是：

Model providers for DeepSeek Harness: sign in with OAuth or an API key, and keep every provider’s model catalog current.

簡單說，它把模型供應商的登錄、模型列表刷新、用量查看和額度查看放到 DSH 的 web profile 中，減少開發者在多個模型供應商之間手工切換、查賬單和維護模型列表的開銷。

核心功能¶

賬號與模型目錄¶

下面介紹插件在賬號和模型目錄方面的能力。

• 使用 OAuth 或 API key 登錄。
• 同一個供應商可以同時保持多個賬號登錄。
• 從 curated catalog 刷新某個供應商的模型列表。
• 讀取 OpenAI 兼容的 /v1/models 端點。
• 導入 OpenAI Codex CLI 已有的登錄，而不是重新登錄一遍。
• 顯示已保存的 API key、退出登錄，並一步移除 route。

這裏的“多賬號”不是隻保留一個當前 key。插件會把登錄後的賬號保留下來，開發者可以在同一個供應商下切換不同賬號。

用量與費用¶

插件會展示與 token、費用相關的信息。

• 側邊欄卡片顯示當天的 token、估算費用、14 天趨勢，以及 input / output / cache 的佔比。
• 用量視圖支持 today、7 天、30 天、90 天和 all time。
• 用量可按模型和供應商拆分。
• 如果某個模型在 catalog 中沒有價格，可以手動輸入價格，相關數字會立即重新計算。

這裏強調的是“本地查看與重算”：插件會基於已有數據和手工價格展示估算結果，方便判斷一段時間內哪個模型、哪個供應商消耗更多。

額度¶

插件還會展示賬號額度信息。

• 訂閱計劃：顯示 quota。
• 按量付費賬號：顯示剩餘 balance。
• 查詢從當前機器發出，使用已保存的憑據訪問供應商自己的 API。
• 到達瀏覽器的只是百分比和餘額。

也就是說，敏感憑據不進入瀏覽器；瀏覽器端看到的是用於展示的百分比和餘額。

會話統計¶

插件也會展示單個會話的統計。

• token
• cost
• calls
• tool calls
• cache hit rate
• context peak
• per-call timeline

這些信息適合在跑完一次任務後，快速查看這次會話到底消耗了多少、工具調用多不多、上下文是否接近峯值。

刷新方式¶

插件不做後臺輪詢：

• 側邊欄卡片在打開時刷新，並在頁面重新可見時刷新。
• 各個 tab 在打開時抓取數據。

這意味着它不會持續佔用後臺請求，數據更新與頁面打開動作綁定。

安裝與啓用¶

從 GitHub 安裝¶

先運行安裝命令：

dsh plugin --profile web add github:tyql688/dsh-providers

這條命令會把 tyql688/dsh-providers 添加到 DSH 的 web profile。

首次 add 可能會因爲 @google/genai 和 protobufjs 出現 ERR_PNPM_IGNORED_BUILDS。按提示處理這兩個 build 腳本後，再次運行同一條安裝命令即可。也可以按下面的示例顯式處理後再重試：

dsh plugin --profile web approve-builds '!@google/genai' '!protobufjs'
dsh plugin --profile web add github:tyql688/dsh-providers

從本地源碼安裝¶

如果已經有一份本地代碼，可以按下面步驟安裝當前目錄：

git clone https://github.com/tyql688/dsh-providers.git
cd dsh-providers
pnpm install
dsh plugin --profile web add "$PWD"

pnpm install 用於準備本地依賴，最後一條命令把當前目錄作爲插件加入 DSH。

卸載¶

卸載命令如下：

dsh plugin --profile web remove dsh-providers

典型用法¶

下面是一些基於插件能力整理的使用路徑。

1. 安裝插件後，在 DSH 的 web profile 中處理模型供應商登錄。
   可以先用 OAuth 登錄，也可以用 API key 登錄。

2. 對同一個供應商保留多個賬號。
   之後可以在不同賬號之間切換，而不必每次重新登錄。

3. 刷新模型列表。
   可以從 curated catalog 刷新，也可以讀取 OpenAI 兼容的 /v1/models 端點。

4. 查看用量。
   可以查看今天、7/30/90 天和 all time 的 token、費用，以及按模型、按供應商的拆分。

5. 對未定價模型補充價格。
   輸入價格後，相關估算數字會立即重新計算。

6. 查看額度。
   訂閱計劃看 quota，按量付費賬號看剩餘 balance。

7. 查看會話統計。
   在一次會話結束後，查看 token、cost、calls、tool calls、cache hit rate、context peak 和 per-call timeline。

文件與密鑰¶

插件會把相關文件存放在 $DSH_HOME 下，默認目錄是 ~/.dsh。

密鑰相關的行爲如下：

• 來自環境變量 environment variables 的 key 從不被存儲。
• Secrets 不出現到日誌裏。
• API key 只在用戶點擊 reveal 時到達瀏覽器。
• OAuth tokens 從不到達瀏覽器。

如果本地已經通過環境變量配置了 key，插件不會把它寫進本地文件；本地文件裏看到的是插件保存的賬號、憑據、模型目錄和路由配置。

適用場景與注意¶

這個插件適合：

• 在 DSH 中同時使用多個模型供應商的開發者。
• 需要同時管理 OAuth 登錄和 API key 的用戶。
• 想在一個地方查看 token、費用、模型拆分和供應商拆分的用戶。
• 需要查看訂閱 quota 或按量付費餘額的用戶。
• 需要按會話查看上下文、調用和工具調用情況的智能體開發者。

使用前需要注意：

• 插件以當前 dsh 進程權限運行。
• 安裝前應檢查源碼與許可證。
• 許可證爲 MIT。
• 已驗證的版本組合是 @deepseek-ai/dsh@0.1.1-rc.2，Node 22+。
• package.json 中的 engines 聲明爲 node ^22.19.0 || >=24.0.0。
• 首次安裝可能遇到 ERR_PNPM_IGNORED_BUILDS，需要按提示處理 @google/genai 和 protobufjs。

結尾¶

dsh-providers 把模型供應商登錄、模型目錄刷新、用量估算和額度查看集中到 DSH 的 web profile 中。對於需要同時使用多個模型供應商的開發者來說，它的價值在於把“登錄、看模型、看花費、看額度”這幾件事放到同一個工具裏處理，而不是分散到多個網頁和命令行之間。

倉庫地址：

https://github.com/tyql688/dsh-providers