dsh-import-newapi：將 New API 連接導入 DeepSeek Harness

在 DeepSeek Harness (DSH) 的開發流程中，配置第三方供應商（如 New API）通常需要手動編輯配置文件和憑據文件。這容易出錯，且流程繁瑣。dsh-import-newapi 插件解決了這個問題，它允許開發者直接從 New API 複製的 JSON 信息中提取連接數據，並將其適配到 @deepseek-ai/dsh-llm-pi-ai 適配器中，同時自動管理密鑰。

插件概況¶

這是一個由 Deanyu148 維護的插件，屬於聯網工具分類。它的核心功能是將 New API 的站點地址和密鑰寫入 DSH 的 cordis.patch.yml，並將密鑰引用寫入 .credentials.yaml，從而實現一鍵導入供應商配置。

安裝與啓用¶

使用 DSH CLI 進行安裝：

dsh plugin --profile desktop add dsh-import-newapi

安裝完成後刷新頁面，在 DSH 設置面板的「模型」下方會出現「New API 導入」選項。

使用流程¶

1. 連接信息
   將 New API 複製的 JSON 信息粘貼到輸入框（例如 {"_type":"newapi_channel_conn","key":"sk-…","url":"https://…"}）。識別成功後，插件會自動填好站點地址與密鑰，也可以完全手填。

2. 供應商配置
   填寫供應商 ID、顯示名和協議。插件會根據站點地址和協議自動推導 baseURL：

   • OpenAI Chat Completions / OpenAI Responses：自動添加 /v1
   • Anthropic Messages：不添加 /v1（由 SDK 處理）
   • 也可以手動修改 baseURL。

3. 模型管理
   點擊「獲取模型列表」，使用搜索欄過濾模型，然後逐個勾選。對於每個模型，可以設置：

   • 名稱：該模型的顯示名，留空或與 ID 相同時不會寫入配置。
   • 容量：支持 256K、1.05M 這種寫法（1K=1000），留空則不寫入。
   • 輸入格式：勾選文本或圖像。
   • 思考強度：設置 reasoningEfforts，提供六個檔位，可自定義鍵名和值。

4. 導入
   點擊「導入」，插件會將供應商信息寫入 cordis.patch.yml，密鑰寫入 .credentials.yaml。導入前可以展開預覽框查看將要寫入的數據。

規則與限制¶

• 供應商 ID 規則：必須小寫字母開頭，只能包含小寫字母、數字和連字符，且連字符不能開頭、結尾或連續出現。已存在的 ID 一律拒絕導入，插件只新增不覆蓋。
• 密鑰命名約定：密鑰引用名由供應商 ID 推導，格式爲全大寫、連字符換成下劃線、末尾加 _API_KEY。例如 example-api → EXAMPLE_API_API_KEY。
• 環境變量處理：如果密鑰已由環境變量提供（writable: false），導入時會跳過寫入 .credentials.yaml。
• 依賴要求：插件需要 Node.js 版本 ^22.19.0 || >=24.0.0，依賴 @deepseek-ai/cordis (^4.0.2) 和 React (^18.3.1)。

總結¶

該插件將 New API 的繁瑣配置流程標準化，適合需要頻繁接入或管理多個 New API 站點的開發者。它通過界面化的操作替代了手動編輯 YAML 文件，同時保留了嚴格的格式校驗。

• 倉庫地址：https://github.com/Deanyu148/dsh-import-newapi