前言¶
DeepSeek Harness 支持插件化配置。在开发或测试场景中，有时需要使用不同的 API 端点以节省成本。dsh-ark-plan 插件旨在解决在 DeepSeek Harness 中通过 Volcano Ark 计划 API 激活 DeepSeek v4 Flash 的配置问题，无需创建自定义提供者。
插件介绍¶
该插件由 snow-The 维护，遵循 MIT 许可证。它复用了内置的 pi-ai deepseek 提供者，该提供者已包含对推理模型、effort=max 和 1M 上下文的支持。插件通过覆盖 baseURL 来指向 Ark 计划 API，从而创建了一个“预算车道”。
系统中存在两个车道：
| 车道 | 提供者 | baseURL | 环境变量 | 密钥前缀 |
|---|---|---|---|---|
| 官方（默认） | deepseek-official |
api.deepseek.com | DEEPSEEK_API_KEY |
sk-... |
| Ark 预算 | deepseek |
Ark 计划 API | ARK_API_KEY |
ark-... |
安装与启用¶
执行以下命令安装插件，然后重启 DeepSeek Harness Web。
dsh plugin --profile web add github:snow-The/dsh-ark-plan
配置与使用¶
- 配置密钥：在
~/.dsh/.credentials.yaml中配置两个独立的密钥。官方车道使用DEEPSEEK_API_KEY（前缀sk-），Ark 车道使用ARK_API_KEY（前缀ark-）。 - 切换车道：将模型选择器切换到
deepseek提供者的模型，以使用 Ark 预算车道。 - 验证：运行
ark_plan_doctor工具以检查配置并测试连接。
注意事项¶
- 避免过时的提供者：确保没有安装过时的独立
ark提供者（v0.1 布局），否则会在模型列表中出现重复的“ark | 自定义”条目。 - 设置推理强度：插件默认注入
reasoningEffort: max。如果未设置，思考将运行在端点默认值（较高）上。 - 密钥匹配：将密钥家族与端点匹配。
sk-用于api.deepseek.com，ark-用于 Ark 计划 API。 - API 密钥要求：Ark 车道需要
ARK_API_KEY；缺失会导致 401 错误。 - 默认值覆盖：插件默认仅在用户尚未配置相同密钥时应用。它不会覆盖现有的用户设置。
结语¶
该插件通过复用内置提供者和自动注入配置，简化了在 Volcano Ark 计划 API 上使用 DeepSeek v4 Flash 的流程。这对于需要预算友好型 token 包的场景很有用。
