前言¶
在 DeepSeek Harness（DSH）裏使用 CLIProxyAPI 後面的模型時，常見做法是手工維護端點和模型列表。dsh-cliproxyapi-provider 把這件事簡化爲本地自動發現、模型目錄動態同步，並讓 CLIProxyAPI 中的模型進入 DSH 原生模型選擇器。
下面介紹它的定位、能力、安裝方式，以及幾個典型使用步驟。
這是什麼¶
dsh-cliproxyapi-provider 是 ChadCSong 維護的一個 DeepSeek Harness 插件，定位爲 CLIProxyAPI provider。
它主要解決這幾類問題：
- 本地 CLIProxyAPI 服務需要被 DSH 發現；
- CPA 返回的模型目錄需要同步到 DSH；
- DSH 會話中需要方便地切換 CPA 下的模型；
- 主模型僅支持文本時，需要先用視覺模型處理圖片。
該插件是標準 DSH bundle，適用於 DSH Web、headless profiles 和 DSH Desktop，不是 Desktop-only 擴展。許可證爲 MIT。
核心能力¶
這個插件提供的能力都比較具體：
- 本地自動發現 CLIProxyAPI，探測
127.0.0.1:8317、localhost:8317和[::1]:8317。 - 從
/v1/models?client_version=pi讀取模型目錄，並支持標準data[].id回退。 - 模型在 DSH 原生模型選擇器中以
CLIProxyAPI (auto)組出現，支持原生模型切換。 - 同一模型族內按最新版本優先排序。
- 支持從自動加載目錄中選擇視覺模型；當主模型僅文本時，先調用視覺模型描述圖片，再將文本發送給主模型。
- 當 CPA 報告時，同步上下文/輸出限制、推理支持、圖像輸入和服務等級。
- CPA 賬戶或模型變化後自動刷新，無需重裝插件。
- API key 通過 DSH credential service 存儲，不寫入
settings.yaml。 - 提供
/cpa-status和/cpa-refresh命令。 - 默認推理協議爲
openai-completions，使用 CPA 的/v1/chat/completions路由；可選openai-responses。
版本要求¶
使用前需要確認當前環境滿足以下條件：
- DeepSeek Harness
0.1.0-rc.7或0.1.0-rc.8 - Node.js
22.19+或24+ - 一個運行中的 CLIProxyAPI 實例
該插件當前針對 DSH 0.1.0-rc.8 公共契約構建，並保留與 rc.7-based DSH Desktop 的運行時兼容。安裝後需要重啓對應 DSH 進程一次。
安裝與啓用¶
下面是官方給出的安裝命令示例，以 web profile 爲例：
dsh plugin --profile web add github:ChadCSong/dsh-cliproxyapi-provider
如果你是從本地代碼安裝，可以按下面步驟執行：
git clone https://github.com/ChadCSong/dsh-cliproxyapi-provider.git
cd dsh-cliproxyapi-provider
pnpm install
pnpm build
dsh plugin --profile web add "$PWD"
安裝完成後，重啓對應 DSH 進程一次。
典型用法¶
先啓動 CLIProxyAPI，再在 DSH 中啓用插件，最後回到會話選擇模型。
- 啓動 CLIProxyAPI。如果它監聽默認端口
8317，URL 留空即可。 - 在 DSH 打開
Settings → Plugins → CLIProxyAPI (auto discovery)。 - 如果啓用了 CPA bearer authentication，輸入一次 API key。
- URL 和 key 有效後，從自動加載下拉框中選擇 vision model。
- 回到會話，在 DSH 原生選擇器中選擇
CLIProxyAPI (auto)下的任意模型。
如果只是想確認當前接入狀態，可以使用：
/cpa-status
/cpa-status 用於查看當前端點和已同步模型數量。
如果想立即重新探測 CPA 並刷新 DSH 模型目錄，可以使用：
/cpa-refresh
視覺模型處理¶
這個插件的視覺模型選擇和主模型選擇是兩件事。
如果主模型本身支持圖像，圖片可以直接進入主模型。
如果主模型僅支持文本，插件會先調用你選擇的視覺模型描述圖片，再把描述文本發送給主模型。這樣可以在不修改 DSH 本身的前提下，讓包含圖片的會話繼續使用僅文本的 CPA 模型。
需要注意的是，DSH 內置的 DeepSeek provider 不在這個插件的路由內。當會話已經包含圖片時，DSH 仍會拒絕切換到僅文本的內置模型。插件不會修改、封裝或重標內置 DSH DeepSeek 模型。
配置與憑據¶
這個插件在憑據處理上比較明確：
- API key 通過 DSH credential service 存儲，不寫入
settings.yaml。 apiKeyEnv是 credential reference，不是密鑰本身。- 默認引用爲
CLIPROXYAPI_API_KEY。
端點方面，自動發現只連接 loopback 地址。非 loopback 服務僅在你顯式配置 baseURL 時訪問。
推理協議默認使用 openai-completions，對應 CPA 的 /v1/chat/completions 路由。如果你的 CPA 部署通過 Responses API 暴露目標模型，可以選擇 openai-responses。
適用場景與注意¶
這個插件適合本地運行 CLIProxyAPI，並且希望 DSH 自動發現模型目錄、動態切換模型的開發者。
安裝前建議檢查源碼、構建產物和許可證。該插件以當前 DSH 進程權限運行，接入本地模型服務時，端點、API key 和模型目錄都會被納入實際調用鏈路，需要自己確認來源可信。
另外需要注意：
- 自動發現只連接 loopback 地址；
- 插件不會把明文 API key 寫入 settings、模型緩存或日誌；
- DSH 內置 DeepSeek 模型仍由 DSH 自身管理；
- 設置命名空間保持
dsh-cliproxyapi，以兼容升級。
鏈接¶
GitHub：
https://github.com/ChadCSong/dsh-cliproxyapi-provider
插件線索給出的目錄頁爲：
https://www.skillhub.cn/plugins/ChadCSong/dsh-cliproxyapi-provider
該目錄頁 URL 未在本文覈實資料中確認爲穩定入口，使用前請自行覈對。
