前言¶
DeepSeek Harness (DSH) 采用插件化架构，旨在通过插件扩展模型接入能力。对于需要接入 Volcengine Ark Agent Plan 和 Coding Plan 的场景，开发者需要处理特定的路由注册、OpenAI 兼容性适配以及凭证管理。现有的集成方式往往需要手动修改配置文件，且容易与 DSH 的内置机制冲突。这个插件提供了开箱即用的集成方案，通过注册独立的路由和提供者配置，将 Volcengine Ark 的计划能力无缝接入 DSH。
这是什么¶
这是一个由社区开发者 lionXiao 维护的 DeepSeek Harness 插件包。它的核心作用是为 DSH 提供 Volcengine Ark Agent Plan 和 Coding Plan 的提供者支持。通过这个插件，DSH 可以识别并调用火山引擎的 Ark 计划接口，同时处理必要的元数据发布和 API 兼容性转换。
核心功能¶
该插件在 DSH 中实现了以下功能：
- 独立路由注册：注册了独立的
volcengine-plan/*和volcengine-coding/*路由，避免与现有插件冲突。 - 元数据发布：发布每模型的上下文、输出、模态和思维级别元数据，使 DSH 能够正确识别模型能力。
- 兼容性适配：应用 Coding Plan 网关所需的 OpenAI 兼容开关，确保请求格式符合接口要求。
- 凭证解析：通过 DSH 凭据服务解析
ARK_API_KEY，同时保留对旧版环境变量的回退支持。 - 配置管理：在 Settings → Plugins → Plugin configuration 下提供可视化的凭据表单。支持对路由、端点、标头、超时、重试和默认推理进行验证和实时重载配置。
- 兼容性修复：避免了导致 DSH rc.6 添加提供者对话框失效的第三方模型编辑器注册问题。
安装与启用¶
安装插件需要使用 DSH 的插件管理命令。
- 在终端中执行以下命令安装指定版本：
dsh plugin --profile web add github:lionXiao/dsh-llm-volcengine-plans#v0.3.1
- 安装完成后，重启 DeepSeek Harness。
- 在模型选择器中，选择
volcengine-coding/deepseek-v4-flash或其他volcengine-plan/*/volcengine-coding/*开头的模型。
配置¶
插件的配置依赖于 DSH 的凭据服务。默认的凭证引用名称为 ARK_API_KEY。
- 在重启 DSH 后，进入 Settings → Plugins → Plugin configuration。
- 找到 Volcengine Plans 配置项。
- 在该表单中保存、替换或移除 API Key。浏览器界面只会显示当前的配置状态；实际的密钥由 DSH 存储在
$DSH_HOME/.credentials.yaml文件中，绝不会通过表单返回。 - 也可以通过环境变量配置。DSH 会从
$DSH_HOME/.env或启动环境变量中读取ARK_API_KEY。
注意事项¶
- 避免冲突：不要同时安装旧的
dsh-llm-volcengine包，两者拥有相同的路由，会导致冲突。 - 安全规范：不要将真实的 API Key 提交到代码仓库中。插件支持从本地环境变量读取密钥。
- 运行权限：插件以当前 DSH 进程的权限运行，使用前请检查源码与许可证。
总结¶
该插件解决了在 DeepSeek Harness 中接入 Volcengine Ark 计划的配置与兼容性问题。通过标准化的路由注册和凭证管理，开发者可以专注于业务逻辑，而无需手动维护复杂的 API 调用细节。
