DeepSeek Harness

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

核心配置#

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

模型配置#

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

在工具配置文件中指定 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.8-preview
kimi-k3

在配置文件中指定模型为ark-code-latest。
通过开通管理页面选择或切换目标模型，切换模型后 3-5 分钟即可生效。
支持 Auto 模式，通过「效果 + 速度」双维度智能算法自动选择模型。

Base URL#

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

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

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。安装并运行该助手，根据界面提示操作可自动完成工具配置，降低手动配置的时间成本和出错风险。

安装 Ark CLI。

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

# 2. 验证安装
arkcli --version

登录 Ark CLI。
Bash
```
1arkcli auth login
```
根据界面提示选择登录方式。若之前已登录过 arkcli，会沿用上次选择的配置；如需重新选择，请先执行 arkcli config reset 后再运行 arkcli auth login。首次登录时，按提示完成以下配置：
1. 选择项目（Project）：可按需选择，或默认选择账号全部资源。
2. 选择消费模式（Type）：选择 coding-plan。
其中：
- <ARK_API_KEY>：运行 ArkCLI Helper 时填写的 Coding Plan API Key。
运行 ArkCLI Helper，根据界面提示完成 DeepSeek Harness 的配置。
1. 在命令行界面输入 arkcli helper 命令，启动 ArkCLI Helper。
2. 选择要配置的 Plan profile：选择 coding-plan_cn-beijing_personal (Coding Plan)。
3. 选择默认 model：按需选择。
4. 选择要配置的 AI Agent：DeepSeek Harness。

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

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

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

启动 DeepSeek Harness。
1. 在终端执行以下命令启动 DeepSeek Harness 的 Web UI。
  bash
```
1npx @deepseek-ai/dsh web
```
2. 在浏览器打开命令输出的访问地址。默认地址为 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](https://ark.volcengine.com/region:cn-beijing/apikey)。
    - **添加模型**：可用的模型参见 [模型配置](/docs/coding-plan-personal-ai-deepseek-harness#3a775131)。

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

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

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

1
2
3
4
5
6
7
8
9
10
11llm-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。
1. 在终端执行以下命令启动 DeepSeek Harness 的 Web UI。
  bash
```
1npx @deepseek-ai/dsh web
```
2. 在浏览器打开命令输出的访问地址。默认地址为 http://127.0.0.1:3080/。

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

1帮我安装下面的插件：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 下的模型即可开始使用。