火山方舟套餐 lionXiao/dsh-llm-volcengine-plans

dsh-llm-volcengine-plans

面向 DeepSeek Harness 的火山方舟 Agent Plan 与 Coding Plan 社区插件。

功能

- 注册 volcengine-plan/ 与 volcengine-coding/ 两组独立路由，不接管其他提供方。
- 为每个模型声明经过适配的上下文窗口、最大输出、输入模态和思考等级。
- Coding Plan 请求包含网关需要的 OpenAI 兼容开关：不发送 developer、store 和 strict mode，并使用 max_tokens。
- DeepSeek、GLM、Kimi 等模型按各自协议发送 reasoning_effort 或 enable_thinking。
- 默认读取火山官方接入示例常用的 ARK_API_KEY；同时兼容旧插件的凭据变量名。
- 在 DSH 的“设置 → 插件 → 插件配置”中提供 Key 表单，可保存、更新或删除凭据。
- 配置更改按请求生效，插件卸载或热更新时自动释放路由。
- 不注册 DSH rc.6 无法渲染的第三方 Models 编辑器，因此不会破坏“添加提供方”弹窗。

命名与包结构

DSH 会将声明 dsh.bundle.patch 的 npm 包识别为可安装 bundle。本包采用社区常见的 dsh- 命名约定：

- npm 包：dsh-llm-volcengine-plans
- Cordis 插件：dsh-llm-volcengine-plans
- 设置命名空间：llm-volcengine-plans
- GitHub 仓库发布时建议添加 dsh-plugin topic

dsh- 不是 DSH 的强制命名规则；火山官方文档规定的是 API Key、端点和兼容协议，也没有规定第三方 DSH npm 包名。本包不使用 @deepseek-ai/，避免让社区插件看起来像 DeepSeek 官方包。

安装

从 GitHub 安装：

dsh plugin --profile web add github:lionXiao/dsh-llm-volcengine-plans#v0.3.1

安装后重启 DSH。旧插件 dsh-llm-volcengine 不能与本包同时安装，因为两者会注册相同路由。

API Key

默认凭据引用为 ARK_API_KEY。插件不会把明文 Key 写入 settings.yaml，而是通过 DSH 的 credential service 按请求读取。

安装并重启 DSH 后，打开：

设置 → 插件 → 插件配置 → 火山方舟 Plans

在这里填写并保存 Key。浏览器只会收到“已配置/未配置”状态，已经保存的 Key 不会从 Host 返回。真实 Key 由 DSH 写入 $DSH_HOME/.credentials.yaml。

火山方舟 Plans 的 Key 配置界面

默认 Agent Plan 和 Coding Plan 共用 ARK_API_KEY，表单只显示一个字段。如果高级配置为两条路由指定了不同的凭据引用，表单会自动显示两个字段。

如果你原来的自定义 ark 提供方使用的就是 ARK_API_KEY，已经保存的 Key 可以直接复用；插件不依赖该自定义提供方本身。确认插件可用后，自定义 ark 提供方可以删除。

也可以不使用表单，改为在启动 DSH 的环境或 $DSH_HOME/.env 中提供：

ARK_API_KEY=你的火山方舟_API_Key

不要把真实 Key 提交到插件目录或 Git 仓库。

模型与思考等级

模型选择器中使用以下路由，而不是 ark/：

volcengine-coding/deepseek-v4-flash
volcengine-coding/glm-5.3
volcengine-plan/deepseek-v4-pro

插件只为端点明确支持切换的模型展示思考等级。没有展示开关的模型仍可正常工作，但由模型或服务端自行决定推理行为。

| 模型选择 | 思考等级选择 |
| 火山方舟模型选择器 | 思考等级选择器 |

配置

默认配置位于 cordis.patch.yml。高级用户可在 profile 或 home 级 patch 中用相同 id 覆盖完整配置行：

- id: llm-volcengine-plans
name: dsh-llm-volcengine-plans
config:
agentPlanEnabled: false
codingPlanEnabled: true
agentPlanApiKeyEnv: ARK_API_KEY
codingPlanApiKeyEnv: ARK_API_KEY
agentPlanBaseURL: https://ark.cn-beijing.volces.com/api/plan/v3
codingPlanBaseURL: https://ark.cn-beijing.volces.com/api/coding/v3
defaultReasoning: high
streamIdleTimeoutMs: 300000

支持的 defaultReasoning：off、minimal、low、medium、high、xhigh、max。模型不支持的等级会由 PiAiAdapter 按该模型实际能力处理。

DSH rc.6 的界面限制

DSH rc.6 的 Models 表单只认识 llm-deepseek 与 llm-pi-ai 两种编辑布局。第三方插件虽然能注册 settings schema，但 Models 页面不会为新命名空间渲染可提交表单。

因此本包刻意不把 llm-volcengine-plans 声明为“添加提供方”候选项，而是使用 DSH 正式提供的 settings.plugin.item 扩展点，把 Key 表单放在“插件配置”中。这既保持原生弹窗可用，也不需要修改 DSH。模型选择和思考等级仍会正常显示。

验证

npm test
npm run pack:check
dsh --profile web --dump-config

真实接口验证需要用户自己的火山 Key，不包含在自动测试中。

参考

- DSH：打包与安装插件
- 火山方舟 Coding Plan 个人版
- 火山方舟 Coding Plan 用量与限额
- 火山方舟兼容 OpenAI SDK

许可证

MIT