前言¶
在 DeepSeek Harness 裏接第三方模型聚合服務，常見做法是手寫服務商 YAML、配環境變量裏的 API Key，或在多處重複建同一家服務商。DMXAPI 用一把 Key 覆蓋多種協議與模型，但路由 ID、上下文上限、思考參數和圖片能力仍要逐項對齊 Harness 的配置格式。
下面介紹維護者 YV919 發佈的 DMXAPI-DSH 配置工具（倉庫 YV919/dmxapi-dsh，SkillHub 分類爲 admin-security）。它在 Harness 桌面端與 Web 工作臺提供表單化配置：選接口預設、填密鑰、增改模型，保存後仍在原生聊天界面選模型，無需把密鑰寫進 YAML。
這是什麼¶
DMXAPI-DSH 配置工具（npm 包名 dsh-dmxapi，當前 Release 0.2.1，MIT 許可證）是面向 DMXAPI 的 Harness 插件。官方說明：在 DeepSeek Harness 桌面和 Web 工作臺配置模型、密鑰，並編輯已有服務商的模型。
插件 0.2.1 適用於 DeepSeek Harness Desktop / Web 0.2.0-rc.2，並已通過 0.2.1-alpha.2 SDK / runtime 兼容驗證。仍使用舊 Harness Web 0.1.5-rc.2 的用戶需保留插件 v0.1.9。
核心功能¶
三種 DMXAPI 接口預設¶
可按協議分別配置：
- DMXAPI · Chat（OpenAI Chat Completions）
- DMXAPI · Responses（OpenAI Responses）
- DMXAPI · Anthropic（Anthropic Messages）
同一服務商內添加模型時共用該服務商的協議；需要另一種請求格式時，切換到對應協議的預設即可。
12 個模型預設¶
插件按接口預填模型 ID，以及圖片輸入、上下文、輸出上限和適用的思考選項；數值可在表單中核對和調整。可用模型、賬號權限與計費以你的 DMXAPI 賬號及 DMXAPI 模型目錄 爲準。
| 格式 | 模型 ID | 圖片 | 上下文 / 最大輸出 | 默認可選思考等級 |
|---|---|---|---|---|
| Chat | deepseek-v4.1-flash |
是 | 1M / 384K | off / low / high / max |
| Chat | glm-5.3 |
否 | 1M / 128K | low / high / max |
| Chat | glm-5.3-flash |
是 | 1M / 128K | low / high / max |
| Chat | qwen3.8-max |
是 | 1M / 131072 | off / medium / xhigh |
| Chat | qwen3.8-max-0902 |
是 | 1M / 131072 | off / medium / xhigh |
| Chat | mimo-v2.6-pro |
是 | 1M / 128K | 關閉 / 開啓 |
| Responses | gpt-6-astra |
是 | 1050K / 128K | low / high / max |
| Responses | gpt-6-sol |
是 | 1050K / 128K | off / low / high / max |
| Responses | gpt-6-luna |
是 | 1050K / 128K | off / low / high / max |
| Anthropic | claude-fable-5-1-cc |
是 | 1M / 128K | low / high / max |
| Anthropic | claude-opus-5-5-cc |
是 | 1M / 128K | low / high / max |
| Anthropic | claude-sonnet-5-cc |
是 | 1M / 128K | off / low / high / max |
DMXAPI 對具體 ID 的路由、賬號權限及參數支持仍需用自己的 Key 驗證；名稱帶 -cc 的 Claude 路由 ID 爲 DMXAPI 側標識，不應去掉 -cc 後當作 Anthropic 原生模型 ID 發送。
密鑰與已有服務商¶
- API Key 在插件內填寫，默認隱藏，可切換顯示；保存時交給 Harness 憑據服務，無需寫入 YAML 或配置環境變量。
- 選擇預設時，插件優先打開 ID 和協議相符的已有服務商；增改模型後點 保存模型修改，不重建服務商，也不改動已有密鑰、地址和協議。
- 需要另一份配置時，可明確選擇 新建獨立配置（會分配
dmxapi-chat-2等標識），或 新建自定義服務商，以及導入、導出單服務商 YAML。YAML 中不要寫apiKey；密鑰由憑據服務保存，apiKeyEnv僅作引用。
思考等級與多模態¶
Qwen 預設使用原生 off / medium / xhigh；MiMo 在表單與聊天菜單中顯示 關閉 / 開啓；其他模型只展示各自預設支持的選項。模型仍由 Harness 原生聊天菜單選擇，圖片仍通過原生附件按鈕上傳。
安裝與啓用¶
經過下面的步驟，可在 Harness 工作臺安裝預構建包 0.2.1。
- 左側打開 插件 → 添加插件，粘貼 Release 安裝包地址：
https://github.com/YV919/dmxapi-dsh/releases/download/v0.2.1/dsh-dmxapi-0.2.1.tgz
- 點擊 安裝，完成後 立即啓用；若 Harness 提示重啓，按提示操作。
- 打開 插件 → DMXAPI-DSH配置工具，選擇接口預設。首次創建服務商時填寫 DMXAPI API Key 並 新增配置；已有同 ID、同協議服務商時，直接增改模型並 保存模型修改。
Windows 用戶可下載 v0.2.1 安裝 ZIP，解壓後在完全退出桌面端托盤後運行 ./install.ps1（默認 desktop profile）。Web 用戶運行 ./install.ps1 -Profile web，需 Node.js ^22.19.0 或 >=24.0.0。更細的步驟見倉庫 QUICKSTART.md。
GitHub Release 提供公開安裝包；社區插件市場收錄狀態以 awesome-dsh-plugin 相關 PR 與市場目錄爲準，與 DeepSeek / 幻方無官方從屬關係。
典型用法¶
- 安裝並啓用插件後，進入 DMXAPI-DSH配置工具。
- 在 DMXAPI · Chat、Responses 或 Anthropic 中選一種接口預設；若已有同協議服務商，表單會優先打開該路由。
- 首次：填寫 API Key → 新增配置。已有服務商：展開模型卡檢查圖片、思考選項與容量，新增或修改模型 → 保存模型修改（無需重填 Key）。
- 回到聊天，從原生模型菜單選擇剛保存的模型；需要換協議格式時，回到插件選擇另一預設，而不是在同一服務商裏混用協議。
配置前建議對照 DMXAPI 模型列表查詢說明 中的 supported_endpoint_types，確認模型支持的接口格式。表單保存成功只表示通過 Harness 配置校驗，不能代替真實接口驗收。
接口地址（DMXAPI 預設）¶
插件對精確匹配 DMXAPI 預設根地址或 /v1 的配置，會按協議修正地址：
| 協議 | DMXAPI 配置地址 | SDK 請求路徑 |
|---|---|---|
| OpenAI Chat Completions | https://www.dmxapi.cn/v1 |
/v1/chat/completions |
| OpenAI Responses | https://www.dmxapi.cn/v1 |
/v1/responses |
| Anthropic Messages | https://www.dmxapi.cn |
/v1/messages |
Anthropic 使用根地址可避免 SDK 拼出 /v1/v1/messages。密鑰需與所在站點域名匹配，詳見 DMXAPI 地址說明。
適用場景與注意¶
適合誰： 已在或計劃使用 DMXAPI 統一 Key 的 Harness 用戶，希望在 GUI 裏維護 Chat / Responses / Anthropic 三類路由和模型列表，並減少手寫 YAML 與環境變量。
安裝前建議： 插件在 Harness 進程權限下運行，安裝前應查看 源碼與 MIT 許可證，確認符合你對 admin-security 類插件的信任要求。安裝或升級插件不會自動遷移或改寫已有模型配置；編輯已有路由時僅更新模型列表及表單中調整的默認思考等級。
結尾¶
DMXAPI-DSH 配置工具把 DMXAPI 的三類協議、12 組模型預設和 Harness 憑據服務接到同一套表單流程裏：裝包、選預設、填 Key 或改模型、回到原生聊天選用。目錄與詳情見 SkillHub 插件頁，源碼與 Release 見 GitHub：YV919/dmxapi-dsh。
