火山方舟
火山方舟
订阅 [Agent/Coding Plan]
请输入
- 文档首页
火山方舟Coding Plan 个人版接入 AI 工具DeepSeek Harness
复制全文
下载 pdfDeepSeek Harness
文档反馈
问问助手DeepSeek Harness 是 DeepSeek AI 开发的一套用来构建、运行和扩展智能体的应用框架，采用一切皆插件的架构。本文介绍如何在 DeepSeek Harness 中接入方舟 Coding Plan 个人版使用。
注意
DeepSeek Harness 目前处于开发者预览阶段，正在快速迭代，后续可能会出现破坏兼容性的变更。
说明
核心配置
接入工具的核心参数如下：
模型配置
支持以下两种方式配置模型：
在工具配置文件中指定 Model Name，可实时切换模型。支持配置的 Model Name：
注意
- doubao-seed-evolving
- doubao-seed-2.1-pro
- doubao-seed-2.1-lite
- doubao-seed-2.0-mini
- glm-5.3 (glm-latest)
- glm-5.3-flash
- deepseek-v4.1-flash
- deepseek-v4.1-flash-economy
- deepseek-v4-flash
- deepseek-v4-pro
- kimi-k2.8-preview
- kimi-k3
- kimi-k3.1-pro
说明
Model Name 不支持配置为 Auto，如需使用，请通过控制台切换该模式。
- 在配置文件中指定模型为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
注意
请勿使用 https://ark.cn-beijing.volces.com/api/v3 ：该 Base URL 不会消耗您的 Coding Plan 额度，而是会产生额外费用。
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。
-
- 登录 Ark CLI。
-
-
- 根据界面提示选择登录方式。若之前已登录过 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。
-
- 在浏览器打开命令输出的访问地址。默认地址为 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-completionshttps://ark.cn-beijing.volces.com/api/coding/v3openai-responseshttps://ark.cn-beijing.volces.com/api/coding/v3anthropic-messageshttps://ark.cn-beijing.volces.com/api/coding
- API 密钥：填写 Coding Plan API Key。
- 添加模型：可用的模型参见 模型配置。
- (可选) 如果需要给模型配置支持图片输入，则需要在配置文件中进行配置。
- 在模型配置页面，单击打开配置文件，路径$DSH_HOME/settings.yaml。
- 在支持的模型配置部分加上 input: [text, image]，配置示例如下。
方式 3：通过火山方舟插件配置
方舟提供 DeepSeek Harness 官方插件 dsh-volcengine-plugin。安装并启用插件后，可以在 火山方舟 插件中配置方舟 Agent Plan、Coding Plan 或后付费模型的接入方式。本文以接入 Coding Plan 为例。
- 启动 DeepSeek Harness。
- 在终端执行以下命令启动 DeepSeek Harness 的 Web UI。
-
- 在浏览器打开命令输出的访问地址。默认地址为 http://127.0.0.1:3080/。
- 安装并启用火山方舟插件。
- 在 DeepSeek Harness Web UI 中，单击左侧导航插件进入插件添加入口。
- 输入插件包名 dsh-volcengine-plugin，单击安装。
-
- 插件安装完成后，单击 立即启用。
- 配置火山方舟插件。
- 单击 火山方舟 插件卡片，进入插件配置页面。
- 在连接配置区域，选择接入方式 Coding Plan。
- 填写 Coding Plan 个人版 API Key，单击 保存。
- （可选）如需调整调用协议或服务地址，展开自定义配置，按实际接入环境修改调用协议和 Base URL。
- 配置模型。
- 选择模型目录中的模型。
- 单击 保存模型配置。
-
- 完成上述操作后，回到对话页，在输入框右下角的模型下拉菜单中选择配置的模型，即可开始使用。
二、使用 DeepSeek Harness
- 在页面中点击 选择工作区，添加你启动 dsh 时所在的项目目录。选中工作区后，会话输入框才可用。
- 在输入框右下角的模型下拉菜单中选择 Ark Coding Plan 下的模型即可开始使用。可用模型列表参见 支持的模型。
- 在输入框输入需求即可开始使用 DeepSeek Harness。
- Agent 可以读取和编辑工作区文件、运行命令、委派工作并维护计划。当操作在当前权限策略下需要审批时，Web UI 会先询问你。
最近更新时间：2026.10.29 17:35:41
这个页面对您有帮助吗？
有用
有用
无用
无用