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-plugintopic
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。
默认 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，不包含在自动测试中。
参考
许可证
MIT