# DeepSeek Harness
> 全部文档的索引见 [llms.txt](https://ark.volcengine.com/llms.txt)；在任一文档页面地址后追加 `.md` 可获取该页的 Markdown 版本。
DeepSeek Harness 是 DeepSeek AI 开发的一套用来构建、运行和扩展智能体的应用框架，采用**一切皆插件**的架构。本文介绍如何在 DeepSeek Harness 中接入方舟 Coding Plan 个人版使用。
> **注意**
>
> DeepSeek Harness 目前处于**开发者预览**阶段，正在快速迭代，后续可能会出现破坏兼容性的变更。
> **说明**
>
> 需要先访问 [方舟 Coding Plan活动](https://www.volcengine.com/activity/codingplan)，按需订阅套餐后再配置使用编程工具。
# 核心配置
接入工具的核心参数如下：
## **模型配置**
支持以下两种方式配置模型：
**选项：配置 Model Name (配置文件指定)**
在工具配置文件中指定 Model Name，可实时切换模型。支持配置的 Model Name：
> **注意**
>
> 配置 Model Name 时，支持使用全小写格式，同时也支持直接复制 [开通管理页面](https://ark.volcengine.com/region:cn-beijing/openManagement?LLM=%7B%7D&advancedActiveKey=subscribe) 中的模型名称。
* `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`
> **说明**
>
> Model Name 不支持配置为 `Auto`，如需使用，请通过控制台切换该模式。
**选项：配置 ark-code-latest (控制台管理)**
1. 在配置文件中指定模型为`ark-code-latest`。
2. 通过 [开通管理页面](https://ark.volcengine.com/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://ark.volcengine.com/region:cn-beijing/apikey)
# 一、配置 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 系统。
1. 安装 Ark CLI。
```Bash
# 1. 通过 NPM 安装
npm install -g @volcengine/ark-cli@latest
# 2. 验证安装
arkcli --version
```
2. 登录 Ark CLI。
```Bash
arkcli auth login
```
根据界面提示选择登录方式。若之前已登录过 arkcli，会沿用上次选择的配置；如需重新选择，请先执行 `arkcli config reset` 后再运行 `arkcli auth login`。首次登录时，按提示完成以下配置：
1. **选择项目（Project）**：可按需选择，或默认选择**账号全部资源**。
2. **选择消费模式（Type）**：选择 `coding-plan`。
其中：
* ``：运行 ArkCLI Helper 时填写的 Coding Plan API Key。
3. 运行 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 版本）。
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 中，单击左下角**设置**。
3. 在左侧导航栏单击**模型**，根据界面信息进行配置。
- 方式一：配置 DeepSeek 卡片
在 DeepSeek 卡片，选择**自定义设置**，按下面信息填写并保存。
- **API 密钥**：填写 Coding Plan [API Key](https://ark.volcengine.com/region:cn-beijing/apikey)。
- **API 地址**：`https://ark.cn-beijing.volces.com/api/coding/v3`
- **添加模型**：可用的模型参见 [模型配置](/docs/coding-plan-personal-ai-deepseek-harness#3a775131)。
- 方式二：添加自定义提供方
单击**添加自定义提供方**，按下面信息填写完成提供方的创建。
- **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)。
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-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 等步骤：
1. 启动 DeepSeek Harness。
1. 在终端执行以下命令启动 DeepSeek Harness 的 Web UI。
```bash
npx @deepseek-ai/dsh web
```
2. 在浏览器打开命令输出的访问地址。默认地址为 `http://127.0.0.1:3080/`。
2. 在对话框中输入以下 Prompt，让 Agent 帮你完成安装`ark-plan-api` 插件。
```bash
帮我安装下面的插件：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
```
3. `ark-plan-api` 插件安装后会在 **设置 > 模型** 页面自动添加 Agent Plan、Coding Plan 以及后付费的模型 provider，用户可输入自己的 [API Key](https://ark.volcengine.com/region:cn-beijing/apikey)。回到对话页，在输入框右下角的模型下拉菜单中选择 **Ark Coding Plan** 下的模型即可开始使用。
4. (可选) 安装插件市场，方便后续查看和管理已装插件。
```bash
帮我安装下面插件：dsh plugin --profile web add dshmarket
```
安装完成后，**设置** 侧边栏会新增 **插件市场** 页。
# 二、使用 DeepSeek Harness
1. 在页面中点击 **选择工作区**，添加你启动 `dsh` 时所在的项目目录。选中工作区后，会话输入框才可用。
2. 在输入框右下角的模型下拉菜单中选择 **Ark Coding Plan** 下的模型即可开始使用。可用模型列表参见 [支持的模型](/docs/coding-plan-personal-plan-overview#51b87c17)。
3. 在输入框输入需求即可开始使用 DeepSeek Harness。
Agent 可以读取和编辑工作区文件、运行命令、委派工作并维护计划。当操作在当前权限策略下需要审批时，Web UI 会先询问你。