文档中心

火山方舟

接入 AI 工具

DeepSeek Harness

DeepSeek Harness 是 DeepSeek AI 开发的一套用来构建、运行和扩展智能体的应用框架，采用一切皆插件的架构。本文介绍如何在 DeepSeek Harness 中接入方舟 Coding Plan 个人版使用。

注意

DeepSeek Harness 目前处于开发者预览阶段，正在快速迭代，后续可能会出现破坏兼容性的变更。

说明

需要先访问方舟 Coding Plan活动，按需订阅套餐后再配置使用编程工具。

核心配置

接入工具的核心参数如下：

模型配置

支持以下两种方式配置模型：

配置 Model Name (配置文件指定)

配置 ark-code-latest (控制台管理)

在工具配置文件中指定 Model Name，可实时切换模型。支持配置的 Model Name：

注意

配置 Model Name 时，支持使用全小写格式，同时也支持直接复制中的模型名称。

doubao-seed-evolving

doubao-seed-2.1-pro

doubao-seed-2.1-lite

doubao-seed-2.0-mini

minimax-m3

glm-5.3 (glm-latest)

glm-5.3-flash

deepseek-v4.1-flash

deepseek-v4-flash

deepseek-v4-pro

kimi-k2.7-code

kimi-k2.8-preview

kimi-k3

说明

Model Name 不支持配置为 Auto，如需使用，请通过控制台切换该模式。

Base URL

不同的工具配置的 Base URL 根据兼容的协议会有不同：

兼容 Anthropic 接口协议工具：https://ark.cn-beijing.volces.com/api/coding

兼容 OpenAI 接口协议工具：https://ark.cn-beijing.volces.com/api/coding/v3

注意

请勿使用 https://ark.cn-beijing.volces.com/api/v3 ：该 Base URL 不会消耗您的 Coding Plan 额度，而是会产生额外费用。

API Key

获取 API Key

一、配置 DeepSeek Harness

您可以按下面任一方式在 DeepSeek Harness 中接入方舟 Coding Plan。自动化助手通过 ArkCLI Helper 引导完成工具配置；通过 Web UI 手动配置通过 DeepSeek Harness Web UI 逐项填写；通过 Ark 插件配置借助方舟官方插件自动完成 provider 添加，只需填入 API Key。

方式 1：自动化助手（推荐）

ArkCLI Helper 是一个编码工具助手，支持快速配置选择的工具接入 Coding Plan。安装并运行该助手，根据界面提示操作可自动完成工具配置，降低手动配置的时间成本和出错风险。

注意

ArkCLI Helper 是基于 Ark Helper 升级演进的工具配置服务，相关能力将持续在 ArkCLI Helper 上迭代更新。建议优先使用 ArkCLI Helper 完成工具配置。

ArkCLI Helper 支持 macOS、Linux、Windows 系统。

安装 Ark CLI。

# 1. 通过 NPM 安装
npm install -g @volcengine/ark-cli@latest

# 2. 验证安装
arkcli --version

arkcli auth login

根据界面提示选择登录方式。若之前已登录过 arkcli，会沿用上次选择的配置；如需重新选择，请先执行 arkcli config reset 后再运行 arkcli auth login。首次登录时，按提示完成以下配置：

选择项目（Project）：可按需选择，或默认选择账号全部资源。

选择消费模式（Type）：选择 coding-plan。

其中：

<ARK_API_KEY>：运行 ArkCLI Helper 时填写的 Coding Plan API Key。

运行 ArkCLI Helper，根据界面提示完成 DeepSeek Harness 的配置。

在命令行界面输入 arkcli helper 命令，启动 ArkCLI Helper。

选择要配置的 Plan profile：选择 coding-plan_cn-beijing_personal (Coding Plan)。

选择默认 model：按需选择。

选择要配置的 AI Agent：DeepSeek Harness。

完成上述操作后，将自动完成 DeepSeek Harness 的基础配置，无需手动安装。

方式 2：通过 Web UI 手动配置

前提条件：您已安装 Node.js（建议使用 LTS 版本）。

启动 DeepSeek Harness。

在终端执行以下命令启动 DeepSeek Harness 的 Web UI。

npx @deepseek-ai/dsh web

在浏览器打开命令输出的访问地址。默认地址为 http://127.0.0.1:3080/。

在 DeepSeek Harness Web UI 中，单击左下角设置。

在左侧导航栏单击模型，根据界面信息进行配置。

方式一：配置 DeepSeek 卡片

在 DeepSeek 卡片，选择自定义设置，按下面信息填写并保存。

API 密钥：填写 Coding Plan API Key。

API 地址：https://ark.cn-beijing.volces.com/api/coding/v3

添加模型：可用的模型参见模型配置。

方式二：添加自定义提供方

单击添加自定义提供方，按下面信息填写完成提供方的创建。

Provider ID：自定义设置，后续如需重命名则需要添加新的提供方，并删除旧的提供方。

显式名称：自定义设置。

API 地址、API 协议：支持的 API 地址、API 协议及对应关系如下，不要配置错误。

API 协议	API 地址
openai-completions	https://ark.cn-beijing.volces.com/api/coding/v3
openai-responses	https://ark.cn-beijing.volces.com/api/coding/v3
anthropic-messages	https://ark.cn-beijing.volces.com/api/coding

API 密钥：填写 Coding Plan API Key。

添加模型：可用的模型参见模型配置。

(可选) 如果需要给模型配置支持图片输入，则需要在配置文件中进行配置。

在模型配置页面，单击打开配置文件，路径$DSH_HOME/settings.yaml。

在支持的模型配置部分加上 input: [text, image]，配置示例如下。

llm-pi-ai:
providers:
ark-plan:
displayName: ark-plan
apiKeyEnv: CODING_PLAN_API_KEY
api: openai-responses
baseURL: https://ark.cn-beijing.volces.com/api/coding/v3
models:
- id: doubao-seed-2.1-pro
name: doubao-seed-2.1-pro
input: [text, image]

方式 3：通过 Ark 插件配置

方舟提供以下官方 Ark Plan 和后付费模型插件，自动为 DeepSeek Harness 配置方舟 Coding Plan、Harness(专业数据集、豆包搜索、Agent 记忆等)与后付费模型 provider，安装后可以自动完成 DeepSeek Harness 与方舟服务的对接，免去手动填写 API 地址、API Key 等步骤：

启动 DeepSeek Harness。

在终端执行以下命令启动 DeepSeek Harness 的 Web UI。

npx @deepseek-ai/dsh web

在浏览器打开命令输出的访问地址。默认地址为 http://127.0.0.1:3080/。

在对话框中输入以下 Prompt，让 Agent 帮你完成安装ark-plan-api 插件。

帮我安装下面的插件：curl -fsSL -o dsh-ark-plugin-install.sh "https://lf3-static.bytednsdoc.com/obj/eden-cn/ylwslo-yrh/ljhwZthlaukjlkulzlp/ark-cli-outer-resource/dsh-ark-plugin-install.sh" && bash dsh-ark-plugin-install.sh --plugin-name ark-plan-api

ark-plan-api 插件安装后会在设置 > 模型页面自动添加 Agent Plan、Coding Plan 以及后付费的模型 provider，用户可输入自己的 API Key。回到对话页，在输入框右下角的模型下拉菜单中选择 Ark Coding Plan 下的模型即可开始使用。

(可选) 安装插件市场，方便后续查看和管理已装插件。

帮我安装下面插件：dsh plugin --profile web add dshmarket

安装完成后，设置侧边栏会新增插件市场页。

二、使用 DeepSeek Harness

在页面中点击选择工作区，添加你启动 dsh 时所在的项目目录。选中工作区后，会话输入框才可用。

在输入框右下角的模型下拉菜单中选择 Ark Coding Plan 下的模型即可开始使用。可用模型列表参见支持的模型。

在输入框输入需求即可开始使用 DeepSeek Harness。

Agent 可以读取和编辑工作区文件、运行命令、委派工作并维护计划。当操作在当前权限策略下需要审批时，Web UI 会先询问你。

最近更新时间：2026.09.23 17:06:45

这个页面对您有帮助吗？

有用

无用