ARTICLE · 1310377
DeepSeek Harness 插件教程 简单几步换上方舟大模型

火山方舟 × DeepSeek Harness
豆包、GLM、Kimi、DeepSeek 按任务切
插件包 dsh-volcengine-plugin
维护方 火山引擎 方舟难度 照着做就行
日期 2026.10 (DSH 仍处于开发者预览阶段)
一句话 如果你已经买了火山方舟的 Coding Plan 或 Agent Plan,这个插件能省掉手填 Base URL、协议、模型列表的麻烦。装完在插件卡片里选套餐、填 Key,模型就出现在下拉框里。
读完你会得到
·用套餐额度:Coding Plan 的额度直接给 DSH 用,不用另开 DeepSeek API。
·按任务换模型:写代码用 DeepSeek,写文案用豆包,长文档用 Kimi,随时切。
·接托管 Agent:装 @volcengine/ark-managed-agents 后,可以把任务派到方舟云端的托管 Agent。
另外附上:安装流程图、配置对照表、常见问题排查顺序、安全提醒和官方资料链接。
01使用场景
先说清楚它解决什么问题。如果下面这几条都不沾边,别装,装了也是负担。
场景 1 用套餐额度 Coding Plan 的额度直接给 DSH 用,不用另开 DeepSeek API。
场景 2 按任务换模型 写代码用 DeepSeek,写文案用豆包,长文档用 Kimi,随时切。
场景 3 接托管 Agent 装 @volcengine/ark-managed-agents 后,可以把任务派到方舟云端的托管 Agent。
不适合 只用 DeepSeek 官方 API、没有方舟套餐的,装了反而多一层配置。
02准备工作
需要 | 说明 |
方舟套餐 | Coding Plan 或 Agent Plan 已订阅 |
API Key | 在方舟控制台拿,注意是套餐对应的 Key |
DSH | 已安装并启动 |
版本号不是摆设。DSH 还在快速迭代,插件和宿主对不上,最常见的表现就是装完不显示、扫码乱码、启动报错。
03安装步骤

先把整个流程看一眼,再往下做
第 1 步 装插件
插件页搜包名安装,或者用 CLI。装完点立即启用。
dsh plugin --profile web add dsh-volcengine-plugin

插件页填包名并安装
第 2 步 选接入方式
点「火山方舟」卡片,选 Coding Plan 或 Agent Plan。
第 3 步 填 Key 保存
把套餐 API Key 填进去;需要改协议和地址再展开自定义配置。
第 4 步 选模型
在模型目录里勾要用的,保存模型配置,回输入框右下角切换。

模型目录里勾选后保存
04配置与使用
项目 | 怎么配 / 能做什么 |
Coding Plan | Base URL 用 /api/coding/v3(OpenAI 协议)或 /api/coding(Anthropic 协议) |
Agent Plan | 在插件里选 Agent Plan,按控制台套餐走 |
后付费 | 按量计费,适合临时测试,注意别和套餐额度混用 |
模型 | doubao-seed-2.1-pro / glm-5.3 / deepseek-v4.1-flash / kimi-k3 等 |
装完先把一条最简单的任务跑通,再逐步加权限和范围。不要一上来就把所有开关打开。
05常见问题
·别用 /api/v3:Coding Plan 用错地址会按后付费额外计费,套餐额度不扣。
·Auto 只能控制台切:配置文件里填 Auto 不生效。
·别重复配 provider:插件配了又在模型页手动加一个,会出现两套路由。
·额度分套餐:Coding Plan、Agent Plan、后付费是三本账。
06安全提醒
先看这一条 插件只保存你的方舟 Key。Key 按套餐权限来,别把企业主账号的 Key 填进个人电脑。
07参考资料
· DeepSeek Harness 接入方舟 Coding Plan · 火山方舟文档https://ark.volcengine.com/region:cn-beijing/docs/coding-plan-personal-ai-deepseek-harness
· npm · dsh-volcengine-pluginhttps://www.npmjs.com/package/dsh-volcengine-plugin
以上链接截至 2026 年 10 月。DSH 和插件都还在快速迭代,界面、包名和参数以官方页面当前版本为准。















































































