前言¶
DeepSeek Harness (DSH) 採用插件化架構，旨在通過插件擴展模型接入能力。對於需要接入 Volcengine Ark Agent Plan 和 Coding Plan 的場景，開發者需要處理特定的路由註冊、OpenAI 兼容性適配以及憑證管理。現有的集成方式往往需要手動修改配置文件，且容易與 DSH 的內置機制衝突。這個插件提供了開箱即用的集成方案，通過註冊獨立的路由和提供者配置，將 Volcengine Ark 的計劃能力無縫接入 DSH。
這是什麼¶
這是一個由社區開發者 lionXiao 維護的 DeepSeek Harness 插件包。它的核心作用是爲 DSH 提供 Volcengine Ark Agent Plan 和 Coding Plan 的提供者支持。通過這個插件，DSH 可以識別並調用火山引擎的 Ark 計劃接口，同時處理必要的元數據發佈和 API 兼容性轉換。
核心功能¶
該插件在 DSH 中實現了以下功能：
- 獨立路由註冊：註冊了獨立的
volcengine-plan/*和volcengine-coding/*路由，避免與現有插件衝突。 - 元數據發佈：發佈每模型的上下文、輸出、模態和思維級別元數據，使 DSH 能夠正確識別模型能力。
- 兼容性適配：應用 Coding Plan 網關所需的 OpenAI 兼容開關，確保請求格式符合接口要求。
- 憑證解析：通過 DSH 憑據服務解析
ARK_API_KEY，同時保留對舊版環境變量的回退支持。 - 配置管理：在 Settings → Plugins → Plugin configuration 下提供可視化的憑據表單。支持對路由、端點、標頭、超時、重試和默認推理進行驗證和實時重載配置。
- 兼容性修復：避免了導致 DSH rc.6 添加提供者對話框失效的第三方模型編輯器註冊問題。
安裝與啓用¶
安裝插件需要使用 DSH 的插件管理命令。
- 在終端中執行以下命令安裝指定版本：
dsh plugin --profile web add github:lionXiao/dsh-llm-volcengine-plans#v0.3.1
- 安裝完成後，重啓 DeepSeek Harness。
- 在模型選擇器中，選擇
volcengine-coding/deepseek-v4-flash或其他volcengine-plan/*/volcengine-coding/*開頭的模型。
配置¶
插件的配置依賴於 DSH 的憑據服務。默認的憑證引用名稱爲 ARK_API_KEY。
- 在重啓 DSH 後，進入 Settings → Plugins → Plugin configuration。
- 找到 Volcengine Plans 配置項。
- 在該表單中保存、替換或移除 API Key。瀏覽器界面只會顯示當前的配置狀態；實際的密鑰由 DSH 存儲在
$DSH_HOME/.credentials.yaml文件中，絕不會通過表單返回。 - 也可以通過環境變量配置。DSH 會從
$DSH_HOME/.env或啓動環境變量中讀取ARK_API_KEY。
注意事項¶
- 避免衝突：不要同時安裝舊的
dsh-llm-volcengine包，兩者擁有相同的路由，會導致衝突。 - 安全規範：不要將真實的 API Key 提交到代碼倉庫中。插件支持從本地環境變量讀取密鑰。
- 運行權限：插件以當前 DSH 進程的權限運行，使用前請檢查源碼與許可證。
總結¶
該插件解決了在 DeepSeek Harness 中接入 Volcengine Ark 計劃的配置與兼容性問題。通過標準化的路由註冊和憑證管理，開發者可以專注於業務邏輯，而無需手動維護複雜的 API 調用細節。
