dsh-claude-provider:爲 DeepSeek Harness 補齊 Claude Provider 配置與模型發現

前言

在 DeepSeek Harness(DSH)裏接 Claude,常見做法是走通用 Custom Provider,協議填 anthropic-messages。這條路徑能發請求,但配置體驗並不完整:模型列表往往要手填,推理檔位(reasoning effort)要自己對照文檔寫進 settings.yaml,Claude 各型號支持的檔位集合也不盡相同。

DeepSeek Harness 0.1.1-rc.1 起,核心已支持 Claude 的 reasoning-effort 參數,但仍需在 settings.yaml 裏手動維護。@mofeng2223/dsh-claude-provider(維護者 MoFeng2223,GitHub 38 stars,分類:模型推理)針對這一缺口,提供獨立的 Claude Provider 類型、前端表單與模型發現,並在保存時把對應配置寫入 DSH 原生設置,而不在運行時攔截或改寫請求。

下面介紹這個插件的定位、能力與安裝用法。

這是什麼

@mofeng2223/dsh-claude-provider 是面向 DeepSeek Harness 的 Claude Provider 擴展插件,當前 npm 版本 0.3.1,MIT 許可證。一句話定位:爲 DSH 增加專用的 Claude Provider 配置入口、Anthropic 模型發現,以及按型號寫入 reasoning 相關原生設置

與「在通用 Custom Provider 裏填同一個 anthropic-messages 地址」相比,本插件把 Claude 相關能力收斂到獨立 Provider 類型;保存時寫入 settings.yaml,用戶不必手改 YAML,同時保留 DSH 核心尚未覆蓋的模型發現與已知型號默認值填充。

核心功能

獨立的 Claude Provider 類型

Models 設置頁會多出 Claude Provider 入口,可在此類型下創建多個 Provider ID,與通用 Custom Provider 分開管理。選擇 Add Claude Provider 後,打開專用的 Anthropic Messages 表單,字段與 Claude 接入場景對齊。

按模型配置 reasoning 檔位

每個模型可綁定三種檔位模式之一:

  • 五檔:Low、Medium、High、XHigh、Max
  • 四檔:Low、Medium、High、Max
  • 開關:On 或 Off

新模型默認使用五檔;Claude Provider 默認 reasoning 爲 High。對於 adaptive thinking 模型,插件在用戶保存時把所選檔位寫入 DSH 原生配置(reasoningEfforts、默認 reasoningcompat.forceAdaptiveThinking 等),不再在請求鏈路裏做運行時轉換。

Anthropic 原生模型發現

DSH 的通用 Custom Provider 無法爲 anthropic-messages 協議列出模型。本插件對顯式創建爲 Claude Provider 的配置,通過 Provider 自帶的 Anthropic 兼容 GET /v1/models 端點拉取模型列表,並支持 cursor 分頁。

發現後自動填充已知 Claude 默認值

若發現到的 model ID 命中插件內記錄的 Claude 型號,會自動填入上下文窗口、最大輸出長度和 reasoning 檔位集合。手動錄入的模型仍可完全編輯,不會被查找結果覆蓋。

不影響其他 Provider

模型發現、默認值與 reasoning 控件僅作用於 Claude Provider 類型。DSH 內置 Provider 以及普通 Custom Provider(即便協議是 anthropic-messages 或模型 ID 形如 claude-*)保持原有行爲。

安裝與啓用

插件通過 DSH 官方 CLI 安裝,按使用場景選擇 profile。安裝後需重啓對應的 DSH 進程。

Web 界面場景:

npx @deepseek-ai/dsh plugin --profile web add @mofeng2223/dsh-claude-provider

無 Web 界面的 Headless 場景:

npx @deepseek-ai/dsh plugin --profile headless add @mofeng2223/dsh-claude-provider

從源碼構建時,需 Node.js >= 22.19。克隆倉庫後執行 npm installnpm run build,再用 npm pack 生成 tgz,以本地包路徑安裝到對應 profile:

npx @deepseek-ai/dsh plugin --profile web add ./dist/mofeng2223-dsh-claude-provider-*.tgz

卸載命令(每個已安裝的 profile 各執行一次):

npx @deepseek-ai/dsh plugin --profile web remove @mofeng2223/dsh-claude-provider
npx @deepseek-ai/dsh plugin --profile headless remove @mofeng2223/dsh-claude-provider

卸載不會刪除 ~/.dsh/settings.yaml 或已存憑據;已有 Claude Provider 會退化爲普通 anthropic-messages 路由,原生 reasoning 配置仍可用,但專用增刪 UI、模型發現與記錄默認值會消失。

典型用法

  1. 按上文命令安裝插件並重啓 DSH。
  2. 打開 Models 設置,選擇 Add Claude Provider,填寫 Provider ID、API Base、API Key 等 Anthropic Messages 所需字段。
  3. 在表單內觸發模型發現,或手動添加模型;對已收錄的 Claude 型號,上下文窗口、輸出上限與 reasoning 檔位會自動帶出,可按需調整。
  4. 爲各模型選定 reasoning 檔位模式與默認值,保存 Provider。插件會把對應項寫入 settings.yaml 的 DSH 原生字段。
  5. 在 Agent 或會話裏選用該 Provider 下的模型;推理檔位通過 DSH 前端選擇器切換,由核心按已寫入的配置發請求。

適用場景與注意

適合誰: 需要在 DSH 中穩定接入 Claude、希望用表單而非手改 YAML 管理 reasoning 檔位,並依賴 Provider 側模型列表的開發者。

權限與安全: 插件以當前 DSH 進程的權限運行,會讀寫本地 settings.yaml 並與 Provider 的 API 通信。安裝前應閱讀 GitHub 倉庫 源碼與 MIT 許可證,確認 API Key 存儲與網絡出站策略符合你的環境要求。

與核心的關係: 推理參數已由 DSH 0.1.1-rc.1 原生支持;本插件的價值集中在配置 UX、模型發現與 Claude 型號默認值,而非請求攔截。SkillHub 等社區目錄爲獨立站點,與 DeepSeek / 幻方無官方從屬關係,插件列表僅供參考。

結尾

@mofeng2223/dsh-claude-provider 把 Claude 接入從「通用 Custom Provider + 手改 YAML」收斂爲專用類型:前端保存即寫入原生配置,附帶模型發現與已知型號默認值。若你在 DSH 里長期使用 Claude,可先按 profile 安裝插件,再在 Models 頁創建 Claude Provider 驗證發現與 reasoning 檔位是否符合預期。

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜