dsh-llm-volcengine

DeepSeek Harness (DSH) 的火山方舟 Agent Plan 与 Coding Plan 提供商，思考强度兼容性已实测验证。

一个 DSH profile bundle，通过自带的 pi-ai LlmAdapter 注册两条 LLM 路由，让模型目录与兼容性开关直接进入 pi-ai，不依赖 dsh-llm-pi-ai settings 的 compat schema。端点支持的档位会暴露 low / medium / high / xhigh / max 思考强度。

为什么需要

在 settings.yaml 里手配火山方舟路由会踩几个坑，本 bundle 一次性解决：

安装

在某个 DSH profile 根目录（如 ~/.dsh/profiles/web）执行：

dsh plugin --profile web add dsh-llm-volcengine

重启 DSH（或重载 profile）让新 bundle 层被组合进来。两个提供商出现在模型选择器中：

• volcengine-plan/<模型>
• volcengine-coding/<模型>

凭据

bundle 依次尝试候选凭据引用（从左到右）通过 DSH 凭据服务解析，再回退到环境变量：

在 web 的 Models 页录入 key（写入 DSH 凭据库），或 export 环境变量。如果已有 ARK_CODE_API_KEY / HUOSHAN_API_KEY，bundle 会作为回退自动使用。

通过 cordis.patch.yml 的 bundle config 可覆盖每条路由首选的引用：

- id: llm-volcengine
name: dsh-llm-volcengine
config:
agentPlanApiKeyEnv: ARK_AGENT_PLAN_API_KEY
codingPlanApiKeyEnv: ARK_CODING_PLAN_API_KEY
defaultReasoning: high

defaultReasoning 取 off | minimal | low | medium | high | xhigh | max（默认 high）。

提供商路由

volcengine-plan — 火山方舟 Agent Plan

• 端点：https://ark.cn-beijing.volces.com/api/plan/v3
• 协议：多数模型用 openai-responses；Kimi K2.6 / K2.7 Code 用 openai-completions（同一个混合 api 的 provider）
• reasoning.effort 映射到所选思考档位

volcengine-coding — 火山方舟 Coding Plan

• 端点：https://ark.cn-beijing.volces.com/api/coding/v3
• 协议：openai-completions，supportsDeveloperRole: false、supportsStore: false、supportsStrictMode: false、maxTokensField: "max_tokens"
• DeepSeek/GLM 接受 reasoning_effort；Kimi 用 qwen 的 enable_thinking 开关；MiniMax/Doubao-seed-code 不支持思考控制（推理内容自动捕获）

工作原理

bundle 插入一条插件 row（id: llm-volcengine）。apply 时：

1. 用 createProvider 直接构建两个 pi-ai Provider，把完整 compat 块附在每个 Model 上。因为模型是在代码里构造的（不走 dsh-llm-pi-ai 的 settings 解析），Coding Plan 网关所需的 compat 字段能直接进到 pi-ai，不受已安装的 dsh-llm-pi-ai compat schema 限制。
2. 用 @deepseek-ai/dsh-llm-pi-ai 导出的 PiAiAdapter 包裹它们——它已实现 harness 的 LlmAdapter 契约（stream/resolveModel/listModels），并按模型 thinkingLevelMap 做思考档位限幅。
3. 通过 ctx.llm.registerAdapter 注册这两条路由，提供商由此进入模型选择器与请求路由，和内置路由并无二致。

Agent Plan 的模型共用一个混合 api 的 provider（createProvider 的 api 用 map），Kimi K2.6/K2.7 Code 分发到 openai-completions，其余走 openai-responses。

致谢

模型目录、输出上限与兼容性开关来自社区验证的火山方舟 pi 扩展：

• pi-provider-volcengine-agent-plan —— Agent Plan 的 Responses 路径、套餐分级与 Kimi 路由决策
• pi-provider-volcengine-codingplan —— Coding Plan 的 compat 开关与模型上限
• pi-provider-volcengine-ark —— coding 端点的各模型 thinking 格式

本 bundle 把这些 compat 结论适配到 DeepSeek Harness 的 LLM 接缝。

许可证

MIT