feat(providers): add Volcengine Ark Agent Plan / Coding Plan presets

apps/desktop/electron/main/models-dev-catalog.ts

@@ -559,7 +559,16 @@ const KNOWN_PROVIDER_BASE_URLS: Record<string, string[]> = {
   "alibaba-cn": ["https://dashscope.aliyuncs.com/compatible-mode/v1"],
   "moonshotai-cn": ["https://api.moonshot.cn/v1"],
   "siliconflow-cn": ["https://api.siliconflow.cn/v1"],
-  volcengine: ["https://ark.cn-beijing.volces.com/api/v3"],
+  // Ark subscription plans (Agent Plan / Coding Plan) live on dedicated
+  // paths of the same host. Map them to the same models.dev provider so a
+  // plan row still inherits Doubao-family metadata.
+  volcengine: [
+    "https://ark.cn-beijing.volces.com/api/v3",
+    "https://ark.cn-beijing.volces.com/api/coding",
+    "https://ark.cn-beijing.volces.com/api/coding/v3",
+    "https://ark.cn-beijing.volces.com/api/plan",
+    "https://ark.cn-beijing.volces.com/api/plan/v3",
+  ],
   // MiniMax exposes both an Anthropic endpoint (the published models.dev
   // URL) and an OpenAI-compatible `/v1` endpoint. Treat the latter as the
   // same provider so a custom OpenAI-style row still inherits M3's vision

docs/spec/03-runtime/12-provider-config-schema.md

@@ -273,7 +273,10 @@ Fireworks, OpenCode Go (`opencode_go`), Z.AI / Z.AI Coding Plan.
 
 China: DeepSeek, Qwen DashScope (`alibaba-cn`), Moonshot (`moonshotai-cn`),
 Zhipu AI / Coding Plan, SiliconFlow (`siliconflow-cn`), Volcengine Ark,
-MiniMax (`anthropic_messages` at `https://api.minimaxi.com/anthropic/v1`),
+Volcengine Ark Coding Plan / Agent Plan (each in an `anthropic_messages`
+variant at `https://ark.cn-beijing.volces.com/api/coding` or `/api/plan`
+and an OpenAI `chat_completions` variant at `/api/coding/v3` or
+`/api/plan/v3`; all keep the shared `volcengine` vendor key), MiniMax (`anthropic_messages` at `https://api.minimaxi.com/anthropic/v1`),
 MiniMax (OpenAI) (`chat_completions` at `https://api.minimaxi.com/v1`, aliases
 `minimax-openai` / `minimax-compatible`), Kimi For Coding (`anthropic_messages`).
 

docs/zh-CN/spec/03-runtime/12-provider-config-schema.md

@@ -176,7 +176,10 @@ API 密钥；自定义端点在常见路径上并排显示 API 密钥与接口
 Together、Fireworks、OpenCode Go、Z.AI。
 
 国内：DeepSeek、通义千问、月之暗面、智谱 / Coding Plan、硅基流动、火山方舟、
-MiniMax（`anthropic_messages`，`https://api.minimaxi.com/anthropic/v1`）、
+火山方舟 Coding Plan / Agent Plan（各有 `anthropic_messages` 变体，地址
+`https://ark.cn-beijing.volces.com/api/coding` 或 `/api/plan`，以及 OpenAI
+`chat_completions` 变体 `/api/coding/v3` 或 `/api/plan/v3`；均沿用共享的
+`volcengine` vendor key）、MiniMax（`anthropic_messages`，`https://api.minimaxi.com/anthropic/v1`）、
 MiniMax (OpenAI)（`chat_completions`，`https://api.minimaxi.com/v1`，别名
 `minimax-openai` / `minimax-compatible`）、Kimi 编程。
 

packages/i18n/src/locales/de/index.ts

@@ -856,6 +856,10 @@ export const de = {
     "presetZaiCodingPlan": "Z.AI Codierungsplan",
     "presetSiliconflowCn": "SiliconFlow",
     "presetVolcengine": "Volcengine Ark",
+    "presetVolcengineCodingPlan": "Volcengine Ark Coding Plan",
+    "presetVolcengineCodingPlanOpenai": "Volcengine Ark Coding Plan (OpenAI)",
+    "presetVolcengineAgentPlan": "Volcengine Ark Agent Plan",
+    "presetVolcengineAgentPlanOpenai": "Volcengine Ark Agent Plan (OpenAI)",
     "presetMinimaxCn": "MiniMax",
     "presetMinimaxCnOpenai": "MiniMax (OpenAI)",
     "presetKimiCoding": "Kimi für Codierung",

packages/i18n/src/locales/en/index.ts

@@ -869,6 +869,10 @@ export const en = {
     presetZaiCodingPlan: "Z.AI Coding Plan",
     presetSiliconflowCn: "SiliconFlow",
     presetVolcengine: "Volcengine Ark",
+    presetVolcengineCodingPlan: "Volcengine Ark Coding Plan",
+    presetVolcengineCodingPlanOpenai: "Volcengine Ark Coding Plan (OpenAI)",
+    presetVolcengineAgentPlan: "Volcengine Ark Agent Plan",
+    presetVolcengineAgentPlanOpenai: "Volcengine Ark Agent Plan (OpenAI)",
     presetMinimaxCn: "MiniMax",
     presetMinimaxCnOpenai: "MiniMax (OpenAI)",
     presetKimiCoding: "Kimi For Coding",

packages/i18n/src/locales/es/index.ts

@@ -856,6 +856,10 @@ export const es = {
     "presetZaiCodingPlan": "Z.AI Plan de codificación",
     "presetSiliconflowCn": "SiliconFlow",
     "presetVolcengine": "Volcengine Ark",
+    "presetVolcengineCodingPlan": "Volcengine Ark Coding Plan",
+    "presetVolcengineCodingPlanOpenai": "Volcengine Ark Coding Plan (OpenAI)",
+    "presetVolcengineAgentPlan": "Volcengine Ark Agent Plan",
+    "presetVolcengineAgentPlanOpenai": "Volcengine Ark Agent Plan (OpenAI)",
     "presetMinimaxCn": "MiniMax",
     "presetMinimaxCnOpenai": "MiniMax (OpenAI)",
     "presetKimiCoding": "Kimi para codificación",

packages/i18n/src/locales/fr/index.ts

@@ -856,6 +856,10 @@ export const fr = {
     "presetZaiCodingPlan": "Plan de codage Z.AI",
     "presetSiliconflowCn": "SiliconFlow",
     "presetVolcengine": "Volcengine Ark",
+    "presetVolcengineCodingPlan": "Volcengine Ark Coding Plan",
+    "presetVolcengineCodingPlanOpenai": "Volcengine Ark Coding Plan (OpenAI)",
+    "presetVolcengineAgentPlan": "Volcengine Ark Agent Plan",
+    "presetVolcengineAgentPlanOpenai": "Volcengine Ark Agent Plan (OpenAI)",
     "presetMinimaxCn": "MiniMax",
     "presetMinimaxCnOpenai": "MiniMax (OpenAI)",
     "presetKimiCoding": "Kimi pour le codage",

packages/i18n/src/locales/ko/index.ts

@@ -871,6 +871,10 @@ export const ko = {
     presetZaiCodingPlan: "Z.AI Coding Plan",
     presetSiliconflowCn: "SiliconFlow",
     presetVolcengine: "Volcengine Ark",
+    presetVolcengineCodingPlan: "Volcengine Ark Coding Plan",
+    presetVolcengineCodingPlanOpenai: "Volcengine Ark Coding Plan (OpenAI)",
+    presetVolcengineAgentPlan: "Volcengine Ark Agent Plan",
+    presetVolcengineAgentPlanOpenai: "Volcengine Ark Agent Plan (OpenAI)",
     presetMinimaxCn: "MiniMax",
     presetMinimaxCnOpenai: "MiniMax (OpenAI)",
     presetKimiCoding: "Kimi For Coding",

packages/i18n/src/locales/tr/index.ts

@@ -871,6 +871,10 @@ export const tr = {
     presetZaiCodingPlan: "Z.AI Coding Plan",
     presetSiliconflowCn: "SiliconFlow",
     presetVolcengine: "Volcengine Ark",
+    presetVolcengineCodingPlan: "Volcengine Ark Coding Plan",
+    presetVolcengineCodingPlanOpenai: "Volcengine Ark Coding Plan (OpenAI)",
+    presetVolcengineAgentPlan: "Volcengine Ark Agent Plan",
+    presetVolcengineAgentPlanOpenai: "Volcengine Ark Agent Plan (OpenAI)",
     presetMinimaxCn: "MiniMax",
     presetMinimaxCnOpenai: "MiniMax (OpenAI)",
     presetKimiCoding: "Kimi For Coding",

packages/i18n/src/locales/zh-CN/index.ts

@@ -865,6 +865,10 @@ export const zhCN = {
     presetZaiCodingPlan: "Z.AI Coding Plan",
     presetSiliconflowCn: "硅基流动",
     presetVolcengine: "火山方舟",
+    presetVolcengineCodingPlan: "火山方舟 Coding Plan",
+    presetVolcengineCodingPlanOpenai: "火山方舟 Coding Plan（OpenAI）",
+    presetVolcengineAgentPlan: "火山方舟 Agent Plan",
+    presetVolcengineAgentPlanOpenai: "火山方舟 Agent Plan（OpenAI）",
     presetMinimaxCn: "MiniMax",
     presetMinimaxCnOpenai: "MiniMax（OpenAI）",
     presetKimiCoding: "Kimi 编程",

packages/i18n/src/locales/zh-TW/index.ts

@@ -865,6 +865,10 @@ export const zhTW = {
     presetZaiCodingPlan: "Z.AI Coding Plan",
     presetSiliconflowCn: "矽基流動",
     presetVolcengine: "火山方舟",
+    presetVolcengineCodingPlan: "火山方舟 Coding Plan",
+    presetVolcengineCodingPlanOpenai: "火山方舟 Coding Plan（OpenAI）",
+    presetVolcengineAgentPlan: "火山方舟 Agent Plan",
+    presetVolcengineAgentPlanOpenai: "火山方舟 Agent Plan（OpenAI）",
     presetMinimaxCn: "MiniMax",
     presetMinimaxCnOpenai: "MiniMax（OpenAI）",
     presetKimiCoding: "Kimi 程式設計",

packages/shared/src/provider-presets.test.ts

@@ -132,4 +132,38 @@ describe("named endpoint presets", () => {
       })?.id,
     ).toBe("opencode_go");
   });
+
+  it("distinguishes Volcengine Ark plan endpoints from the standard API by path", () => {
+    expect(
+      matchNamedPreset({ baseUrl: "https://ark.cn-beijing.volces.com/api/v3/" })?.id,
+    ).toBe("volcengine");
+    expect(
+      matchNamedPreset({ baseUrl: "https://ark.cn-beijing.volces.com/api/coding" })
+        ?.apiStyle,
+    ).toBe("anthropic_messages");
+    expect(
+      matchNamedPreset({ baseUrl: "https://ark.cn-beijing.volces.com/api/coding/v3" })
+        ?.id,
+    ).toBe("volcengine-coding-plan-openai");
+    expect(
+      matchNamedPreset({ baseUrl: "https://ark.cn-beijing.volces.com/api/plan" })?.id,
+    ).toBe("volcengine-agent-plan");
+    expect(
+      matchNamedPreset({ baseUrl: "https://ark.cn-beijing.volces.com/api/plan/v3" })
+        ?.apiStyle,
+    ).toBe("chat_completions");
+  });
+
+  it("keeps Ark plan rows on the shared volcengine vendor key for catalog metadata", () => {
+    for (const id of [
+      "volcengine-coding-plan",
+      "volcengine-coding-plan-openai",
+      "volcengine-agent-plan",
+      "volcengine-agent-plan-openai",
+    ]) {
+      expect(NAMED_ENDPOINT_PRESETS.find((preset) => preset.id === id)?.vendorKey).toBe(
+        "volcengine",
+      );
+    }
+  });
 });

packages/shared/src/provider-presets.ts

@@ -185,6 +185,47 @@ export const NAMED_ENDPOINT_PRESETS: readonly NamedEndpointPreset[] = [
     labelKey: "settings.presetVolcengine",
     aliases: ["doubao", "ark"],
   },
+  // Volcengine Ark subscription plans (Agent Plan / Coding Plan) are served
+  // from dedicated hosts with their own protocol variants; the standard
+  // `/api/v3` endpoint above does not cover them. All plan rows keep the
+  // `volcengine` vendor key so models.dev metadata still resolves; the
+  // stored base URL is what distinguishes the preset on a saved row.
+  {
+    id: "volcengine-coding-plan",
+    vendorKey: "volcengine",
+    name: "Volcengine Ark Coding Plan",
+    baseUrl: "https://ark.cn-beijing.volces.com/api/coding",
+    apiStyle: "anthropic_messages",
+    labelKey: "settings.presetVolcengineCodingPlan",
+    aliases: ["ark-coding-plan", "doubao-coding-plan"],
+  },
+  {
+    id: "volcengine-coding-plan-openai",
+    vendorKey: "volcengine",
+    name: "Volcengine Ark Coding Plan (OpenAI)",
+    baseUrl: "https://ark.cn-beijing.volces.com/api/coding/v3",
+    apiStyle: "chat_completions",
+    labelKey: "settings.presetVolcengineCodingPlanOpenai",
+    aliases: ["ark-coding-plan-openai"],
+  },
+  {
+    id: "volcengine-agent-plan",
+    vendorKey: "volcengine",
+    name: "Volcengine Ark Agent Plan",
+    baseUrl: "https://ark.cn-beijing.volces.com/api/plan",
+    apiStyle: "anthropic_messages",
+    labelKey: "settings.presetVolcengineAgentPlan",
+    aliases: ["ark-agent-plan"],
+  },
+  {
+    id: "volcengine-agent-plan-openai",
+    vendorKey: "volcengine",
+    name: "Volcengine Ark Agent Plan (OpenAI)",
+    baseUrl: "https://ark.cn-beijing.volces.com/api/plan/v3",
+    apiStyle: "chat_completions",
+    labelKey: "settings.presetVolcengineAgentPlanOpenai",
+    aliases: ["ark-agent-plan-openai"],
+  },
   {
     id: "minimax-cn",
     vendorKey: "minimax-cn",
@@ -255,6 +296,31 @@ function presetByUrl(url: string): NamedEndpointPreset | undefined {
       preset.id === (url.includes("/coding/") ? "zai-coding-plan" : "zai"),
     );
   }
+  if (url.includes("volces.com")) {
+    // Plan endpoints win over the standard `/api/v3` host so a saved row is
+    // catalog-matched to the preset it was created from.
+    if (url.includes("/api/coding/v3")) {
+      return NAMED_ENDPOINT_PRESETS.find(
+        (preset) => preset.id === "volcengine-coding-plan-openai",
+      );
+    }
+    if (url.includes("/api/coding")) {
+      return NAMED_ENDPOINT_PRESETS.find(
+        (preset) => preset.id === "volcengine-coding-plan",
+      );
+    }
+    if (url.includes("/api/plan/v3")) {
+      return NAMED_ENDPOINT_PRESETS.find(
+        (preset) => preset.id === "volcengine-agent-plan-openai",
+      );
+    }
+    if (url.includes("/api/plan")) {
+      return NAMED_ENDPOINT_PRESETS.find(
+        (preset) => preset.id === "volcengine-agent-plan",
+      );
+    }
+    return NAMED_ENDPOINT_PRESETS.find((preset) => preset.id === "volcengine");
+  }
   return undefined;
 }