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

注意

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

说明

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

# 核心配置接入工具的核心参数如下： ## **模型配置** 支持以下两种方式配置模型：配置 Model Name (配置文件指定) 在工具配置文件中指定 Model Name，可实时切换模型。支持配置的 Model Name：

注意

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

* \`doubao-seed-2.1-turbo\` * \`doubao-seed-2.0-lite\` * \`minimax-m3\` * \`glm-5.2\` (\`glm-latest\`) * \`glm-5.3\` * \`deepseek-v4-flash\` * \`deepseek-v4-pro\` * \`kimi-k2.7-code\`

说明

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

配置 ark-code-latest (控制台管理) 1. 在配置文件中指定模型为\`ark-code-latest\`。 2. 通过[开通管理页面](https://console.volcengine.com/ark/region:cn-beijing/openManagement?LLM=%7B%7D&advancedActiveKey=subscribe)选择或切换目标模型，切换模型后 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\`

注意

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

## **API Key** [获取 API Key](https://console.volcengine.com/ark/region:cn-beijing/apikey) # 一、配置 DeepSeek Harness 前提条件：您已安装 Node.js（建议使用 LTS 版本）。 1. 启动 DeepSeek Harness。 1. 在终端执行以下命令启动 DeepSeek Harness 的 Web UI。 ```bash npx @deepseek-ai/dsh web ``` 2. 在浏览器打开命令输出的访问地址。默认地址为 `http://127.0.0.1:3080/`。 2. 在 DeepSeek Harness Web UI 中，单击左下角 **设置** 。 ![图片](https://arkdocs.tos-cn-beijing.volces.com/images/CodingPlan/image-20260814-001513-207.png) 3. 在左侧导航栏单击 **模型** ，根据界面信息进行配置。 * 方式一：配置 DeepSeek 卡片在 DeepSeek 卡片，选择 **自定义设置** ，按下面信息填写并保存。 * **API 密钥** ：填写 Coding Plan [API Key](https://console.volcengine.com/ark/region:cn-beijing/apikey)。 * **API 地址** ：`https://ark.cn-beijing.volces.com/api/coding/v3` * **添加模型** ：可用的模型参见 [模型配置](https://docs.volcengine.com/docs/82379/2637930#3a775131)。 ![图片](https://arkdocs.tos-cn-beijing.volces.com/images/CodingPlan/image-20260814-001035-757.png) * 方式二：添加自定义提供方单击 **添加自定义提供方** ，按下面信息填写完成提供方的创建。 * **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://console.volcengine.com/ark/region:cn-beijing/apikey)。 * **添加模型** ：可用的模型参见 [模型配置](https://docs.volcengine.com/docs/82379/2637930#3a775131)。 4. (可选) 如果需要给模型配置支持图片输入，则需要在配置文件中进行配置。 1. 在模型配置页面，单击 **打开配置文件** ，路径`$DSH_HOME/settings.yaml`。 2. 在支持的模型配置部分加上 `input: [text, image]`，配置示例如下。 ```Yaml 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-turbo name: doubao-seed-2.1-turbo input: [text, image] ``` # 二、使用 DeepSeek Harness 1. 在页面中点击 **选择工作区** ，添加你启动 `dsh` 时所在的项目目录。选中工作区后，会话输入框才可用。 2. 在输入框右下角，选择要使用的模型。 3. 在输入框输入需求即可开始使用 DeepSeek Harness。 Agent 可以读取和编辑工作区文件、运行命令、委派工作并维护计划。当操作在当前权限策略下需要审批时，Web UI 会先询问你。

火山方舟