前言¶
在 DSH 中使用火山方舟的 Agent Plan 與 Coding Plan 時，需要先對齊 provider 路由、協議、兼容開關、憑據順序和模型上限。dsh-llm-volcengine 把這些內容打包成 DSH 插件，安裝後兩條 provider 會直接進入模型選擇器。
這是什麼¶
dsh-llm-volcengine 由 Badakonpro 維護，許可證爲 MIT。它爲 DeepSeek Harness（DSH）註冊 volcengine-plan 與 volcengine-coding 兩條 LLM provider 路由，並帶有已驗證的思考強度兼容性。
插件使用 self-contained pi-ai-backed LlmAdapter，使模型目錄和兼容性開關進入 pi-ai，且不依賴 dsh-llm-pi-ai settings compat schema。
核心功能¶
- 註冊
volcengine-plan與volcengine-coding兩條 LLM provider 路由。 - Agent Plan 路由使用
openai-responses；其中 Kimi K2.6 / K2.7 Code 使用openai-completions。 - Coding Plan 路由使用
openai-completions，並設置supportsDeveloperRole: false、supportsStore: false、supportsStrictMode: false、maxTokensField: "max_tokens"。 - 在端點支持時暴露 thinking levels：
low/medium/high/xhigh/max。 - 支持通過 DSH credential service 或 ambient environment 解析 API key。
- 支持通過
cordis.patch.yml配置agentPlanApiKeyEnv、codingPlanApiKeyEnv、defaultReasoning。
安裝與啓用¶
在 DSH profile 根目錄（例如 ~/.dsh/profiles/web）執行：
dsh plugin --profile web add dsh-llm-volcengine
安裝後重啓 DSH 或 reload profile，使新的 bundle layer 生效。
啓用後，兩個 provider 會出現在模型選擇器中：
volcengine-plan/<model>volcengine-coding/<model>
典型用法¶
憑據¶
插件通過 DSH credential service 或 ambient environment 解析 API key。默認嘗試順序爲：
volcengine-plan：ARK_AGENT_PLAN_API_KEY、VOLCENGINE_ARK_PLAN_API_KEY、ARK_CODE_API_KEYvolcengine-coding：ARK_CODING_PLAN_API_KEY、VOLCENGINE_CODING_API_KEY、HUOSHAN_API_KEY
可以通過 web Models 頁面保存 API key（寫入 DSH credential store），也可以 export 環境變量。
cordis.patch.yml¶
在 cordis.patch.yml 中可配置以下字段：
agentPlanApiKeyEnv: ARK_AGENT_PLAN_API_KEY
codingPlanApiKeyEnv: ARK_CODING_PLAN_API_KEY
defaultReasoning: high
defaultReasoning 可取 off | minimal | low | medium | high | xhigh | max，默認值爲 high。
適用場景與注意¶
適合需要把火山方舟 Agent Plan / Coding Plan 接入 DSH、統一處理 provider 路由、憑據解析和 thinking level 的場景。
需要注意：
- 插件以當前 DSH 進程權限運行；安裝前應檢查源碼和 MIT 許可證。
package.json聲明 peerDependencies：@deepseek-ai/dsh-credentials、@deepseek-ai/dsh-launch-environment、@deepseek-ai/dsh-llm、@deepseek-ai/dsh-llm-pi-ai、@earendil-works/pi-ai。- Coding Plan 網關拒絕 developer 角色、store，並要求
max_tokens字段；插件通過 Coding Plan 路由的兼容開關處理這些請求項。 - 部分 Coding Plan 模型沒有 thinking control：
minimax-m2.7、minimax-m3、doubao-seed-code。 - 不同模型有各自的
maxTokens上限，README 按模型列出已驗證上限；選擇模型時應以 README 中對應模型的上限爲準。
鏈接¶
dsh-llm-volcengine 的價值在於把火山方舟兩條計劃路由的協議、兼容開關、憑據順序和 thinking level 集中到 DSH 插件中。
GitHub：https://github.com/Badakonpro/dsh-llm-volcengine
目錄頁線索：https://www.skillhub.cn/plugins/Badakonpro/dsh-llm-volcengine（來自插件線索，未在當前抓取資料中核對）。社區目錄是獨立站點，不要將其理解爲 DeepSeek / 幻方官方應用商店。
