前言¶
DeepSeek Harness 支持插件化配置。在開發或測試場景中，有時需要使用不同的 API 端點以節省成本。dsh-ark-plan 插件旨在解決在 DeepSeek Harness 中通過 Volcano Ark 計劃 API 激活 DeepSeek v4 Flash 的配置問題，無需創建自定義提供者。
插件介紹¶
該插件由 snow-The 維護，遵循 MIT 許可證。它複用了內置的 pi-ai deepseek 提供者，該提供者已包含對推理模型、effort=max 和 1M 上下文的支持。插件通過覆蓋 baseURL 來指向 Ark 計劃 API，從而創建了一個“預算車道”。
系統中存在兩個車道：
| 車道 | 提供者 | baseURL | 環境變量 | 密鑰前綴 |
|---|---|---|---|---|
| 官方（默認） | deepseek-official |
api.deepseek.com | DEEPSEEK_API_KEY |
sk-... |
| Ark 預算 | deepseek |
Ark 計劃 API | ARK_API_KEY |
ark-... |
安裝與啓用¶
執行以下命令安裝插件，然後重啓 DeepSeek Harness Web。
dsh plugin --profile web add github:snow-The/dsh-ark-plan
配置與使用¶
- 配置密鑰：在
~/.dsh/.credentials.yaml中配置兩個獨立的密鑰。官方車道使用DEEPSEEK_API_KEY（前綴sk-），Ark 車道使用ARK_API_KEY（前綴ark-）。 - 切換車道：將模型選擇器切換到
deepseek提供者的模型，以使用 Ark 預算車道。 - 驗證：運行
ark_plan_doctor工具以檢查配置並測試連接。
注意事項¶
- 避免過時的提供者：確保沒有安裝過時的獨立
ark提供者（v0.1 佈局），否則會在模型列表中出現重複的“ark | 自定義”條目。 - 設置推理強度：插件默認注入
reasoningEffort: max。如果未設置，思考將運行在端點默認值（較高）上。 - 密鑰匹配：將密鑰家族與端點匹配。
sk-用於api.deepseek.com，ark-用於 Ark 計劃 API。 - API 密鑰要求：Ark 車道需要
ARK_API_KEY；缺失會導致 401 錯誤。 - 默認值覆蓋：插件默認僅在用戶尚未配置相同密鑰時應用。它不會覆蓋現有的用戶設置。
結語¶
該插件通過複用內置提供者和自動注入配置，簡化了在 Volcano Ark 計劃 API 上使用 DeepSeek v4 Flash 的流程。這對於需要預算友好型 token 包的場景很有用。
