火山方舟 · DeepSeek Harness 插件

火山方舟面向 DeepSeek Harness 的官方供应商插件。在 DSH 中使用方舟模型，自动同步模型目录、上下文容量和输入模态，支持工具调用与模型级能力配置。

环境要求

• DeepSeek Harness 0.2.1-rc.2，Node 运行时 24 或以上。
• 对应接入方式的 API Key，以及模型调用权限；PayGo、Agent Plan、Coding Plan 的 Key 分别保存。
• 插件不包含原生二进制模块。Windows 的安装与更新复用 DSH 内置插件管理器；实际 Windows 桌面验证尚待完成。

安装与连接

在 DSH「插件 → 添加插件 → 安装第三方插件」中输入：

dsh-volcengine-plugin

安装后打开「插件 → 火山方舟」，选择接入方式，填写对应 API Key 并保存。PayGo 在线获取模型目录，Agent Plan / Coding Plan 使用插件内维护的套餐目录；勾选常用模型，点击「保存模型配置」。只有已保存的模型会出现在会话模型选择器中，首次使用不会默认展示全量模型。

API Key 保存在 DSH 凭据存储中，不会写入插件包或回显。模型目录不代表当前账号已获得调用权限。

接入方式

三种接入方式分别保存密钥、各协议服务地址与已选模型；切换后不会沿用另一种方式的 Key 或模型选择。默认接入方式为 PayGo，原有配置保持有效。

接入方式	Messages 基础地址	Chat / Responses 基础地址	模型来源
PayGo	https://ark.cn-beijing.volces.com/api/compatible	https://ark.cn-beijing.volces.com/api/v3	/models 与覆盖文件
Agent Plan	https://ark.cn-beijing.volces.com/api/plan	https://ark.cn-beijing.volces.com/api/plan/v3	plan-models.json
Coding Plan	https://ark.cn-beijing.volces.com/api/coding	https://ark.cn-beijing.volces.com/api/coding/v3	plan-models.json

地址均可修改，默认使用 Messages。套餐不调用 /models，也不使用 PayGo 的 EP 绑定。目录可在未填写 Key 时查看；真实调用仍需已开通的套餐及专属 Key。

plan-models.json 按套餐维护模型 ID、真实模型来源和能力。仅包含本次核对的 21 个 LLM/VLM 模型，排除向量化、音频和图片/视频生成模型。请求始终使用套餐模型 ID，真实模型 ID 只用于能力核对。修改文件后点击「刷新模型」；可通过 planModelsFile 指定插件目录外的统一配置。插件不直接访问 Nacos。

具体模型能力来自套餐映射对应的 modelmeta；同一 ID 在个人版与企业版指向多个版本时，取共同输入能力与较小容量。ark-code-latest 由账号在控制台选定或自动路由，没有唯一的底层模型；当前按官方接入示例使用保守范围：文本、256000 上下文、32000 最大输出，不开放可调推理档位。需要明确能力时请选择具体模型。当前 DSH 只映射文本/图片输入，文件中的视频/音频信息保留为元数据。

可选 EP 绑定（PayGo）

选择模型后，在「已选模型」清单的「推理接入点」中填写对应的 ep-...，点击「保存模型配置」。调用方舟时，插件仅将请求中的 model 替换为 EP；模型名称、版本、上下文、输入模态和推理档位仍使用原模型配置。

留空时使用原模型 ID。清空 EP 并保存即可解除绑定；取消模型选择并保存，也会移除该模型的 EP 绑定。EP 应对应所选模型。

模型调用

默认使用 Anthropic Messages，可在「自定义设置」切换协议并修改地址。不同协议的地址分别保存；留空 API Key 可只更新连接设置。

协议	默认基础地址	自动追加路径
Anthropic Messages	https://ark.cn-beijing.volces.com/api/compatible	/v1/messages
OpenAI Chat Completions	https://ark.cn-beijing.volces.com/api/v3	/chat/completions
OpenAI Responses	https://ark.cn-beijing.volces.com/api/v3	/responses

模型目录默认读取 https://ark.cn-beijing.volces.com/api/v3/models，其基础地址也可单独修改。地址须使用 HTTPS，客户端不会跟随重定向。

模型目录过滤已下线模型，按发布时间从新到旧排列。仅收录 domain 为 LLM 或 VLM、支持文本输入输出与工具调用且容量信息完整的模型，不按 task_type 过滤。能力未声明时不进行猜测。

自定义模型能力

在插件「自定义设置」中查看 overridesFile 路径。该 JSON 文件按模型 ID 配置，优先于接口返回值：

{
  "deepseek-v4-1-flash-261017": {
    "input": ["text", "image"],
    "reasoningEfforts": {"off": null, "low": "low", "high": "high", "max": "max"},
    "defaultReasoningEffort": "high",
    "thinkingFormat": "deepseek",
    "supportsReasoningEffort": true
  }
}

确认模型支持关闭思考后，可在 reasoningEfforts 配置 "off": null。DSH 展示官方 Off 档位，底层 SDK 负责序列化：Messages / Chat 发送 thinking.type = "disabled"；Responses 发送 reasoning.effort = "none"。若模型使用 minimal 表示关闭，可配置 "off": "minimal"，Responses 会采用对应值。未配置 Off 的模型不提供该选项；不能仅因存在 none 档位就假定模型允许关闭。

defaultReasoningEffort 指定未选择档位时的模型默认值，必须是已声明的档位。内置配置按 modelmeta 保留 High / Medium 等默认值，避免增加 Off 选项改变原有默认行为。覆盖配置中的 off: null 表示允许 Off；解析后底层 thinkingLevelMap.off 会省略，底层的 off: null 则表示禁止 Off，两者含义不同。

保存 API Key 后，后续请求即时读取对应接入方式的新凭据，无需重启；已发出的请求不受影响。

features.cache 可覆盖 prefix_cache、session_cache，features.structured_outputs 可覆盖 json_object、json_schema，均填写布尔值；逐字段优先于 /models，未配置项沿用接口值。这些字段记录目录能力，不会自动给推理请求增加缓存或结构化输出参数。

name、domain、status、created、input、output、contextWindow、maxTokens、maxInputTokenLength、maxReasoningTokenLength、supportsTools 也可明确覆盖。input 可保留方舟声明的文本、图片、视频和音频，当前 DSH 仅映射文本与图片；maxInputTokenLength、maxReasoningTokenLength 记录元数据，DSH 实际使用的容量字段为 contextWindow、maxTokens。目录明确已下线的模型仍会排除，覆盖文件不能将其重新启用。

完整字段结构以插件附带的 model-overrides.json 为准。企业统一维护的配置文件请放在插件安装目录之外，并在 DSH 配置中指定 overridesFile，避免更新覆盖。修改后点击「刷新模型」。

更新

方舟插件页提供「检查更新」。发现新版本后点击更新按钮，由 DSH 内置插件管理器安装对应 npm 版本；根据页面提示重启 DSH。更新不要求配置 Git 或 SSH，也不要求额外安装 Node 或 pnpm。

0.8.1 / 0.8.2 的旧更新器可能提示 INSTALL_FAILED，首次升级到 0.8.3 请先退出 DSH，再通过 DSH 官方 CLI 执行一次（桌面配置名为 desktop）：

dsh plugin --profile desktop add [email protected] --save-exact --registry=https://registry.npmjs.org/

重新启动后加载新版。0.8.3 起的更新器使用独立管理上下文安装到磁盘，再提示重启，避免热重载拒绝替换已有插件。

检查结果缓存 5 分钟，手动检查会立即刷新。凭据与已选模型保存在 DSH 设置中，更新时保留。更新未完成时请重试，或联系管理员。

许可

MIT