feat: add Volcengine Ark China direct API

apps/desktop/e2e/providers.spec.ts

@@ -330,6 +330,36 @@ for (const stepfun of [
  await expect(page.getByRole('textbox', { name: '模型密钥' })).toBeVisible();
 });
 
+test('adds Volcengine Ark China with its exact snapshot model, API-key field, and shared official mark', async ({ window: page }) => {
+ await page.getByRole('button', { name: '展开侧边栏' }).click();
+ await page.getByRole('button', { name: '设置' }).click();
+ await page.locator('[aria-label="设置分组"]').getByText('模型', { exact: true }).click();
+ await page.getByRole('button', { name: '添加服务商' }).click();
+
+ await page.getByRole('tab', { name: 'API', exact: true }).click();
+ await page.getByPlaceholder('搜索服务商').fill('Volcengine');
+ const catalogMark = page.locator(
+ '.providerCatalogRow[data-provider="volcengine-ark"] .providerLogo .providerAssetMask',
+ );
+ await expect(catalogMark).toBeVisible();
+ expect(await catalogMark.evaluate(maskRenderContract)).toEqual({ usesAssetMask: true, followsForeground: true });
+ await page.getByRole('button', { name: /添加模型供应商：Volcengine Ark \(China\)/ }).click();
+
+ await expect(page.getByLabel('模型供应商连接标识')).toHaveValue('volcengine-ark');
+ await expect(page.getByLabel('模型供应商服务地址')).toHaveValue('https://ark.cn-beijing.volces.com/api/v3');
+ await expect(page.getByLabel('模型供应商默认模型')).toHaveValue('doubao-seed-2-0-pro-260215');
+ await page.getByRole('button', { name: '保存供应商' }).click();
+
+ await expect(page.getByRole('heading', { name: 'Volcengine Ark (China)', exact: true }).first()).toBeVisible();
+ const detailMark = page.locator(
+ '.providerSubpageHeader .providerLogo[data-provider="volcengine-ark"] .providerAssetMask',
+ );
+ await expect(detailMark).toBeVisible();
+ expect(await detailMark.evaluate(maskRenderContract)).toEqual({ usesAssetMask: true, followsForeground: true });
+ await expect(page.getByText('doubao-seed-2-0-pro-260215', { exact: true }).first()).toBeVisible();
+ await expect(page.getByRole('textbox', { name: '模型密钥' })).toBeVisible();
+});
+
 test('restores keyboard focus across provider child pages', async ({ window: page }) => {
  await page.getByRole('button', { name: '展开侧边栏' }).click();
  await page.getByRole('button', { name: '设置' }).click();

apps/desktop/src/main/__tests__/icon-governance-contract.test.ts

@@ -46,6 +46,7 @@ const NVIDIA_BRAND_MARK_FILE = resolve(REPO_ROOT, 'apps/desktop/src/renderer/ass
 const TENCENT_HUNYUAN_BRAND_MARK_FILE = resolve(REPO_ROOT, 'apps/desktop/src/renderer/assets/provider-brands/hunyuan.svg');
 const TENCENT_CLOUD_BRAND_MARK_FILE = resolve(REPO_ROOT, 'apps/desktop/src/renderer/assets/provider-brands/tencentcloud.svg');
 const STEPFUN_BRAND_MARK_FILE = resolve(REPO_ROOT, 'apps/desktop/src/renderer/assets/provider-brands/stepfun.svg');
+const VOLCENGINE_BRAND_MARK_FILE = resolve(REPO_ROOT, 'apps/desktop/src/renderer/assets/provider-brands/volcengine.svg');
 const DESKTOP_PACKAGE_FILE = resolve(REPO_ROOT, 'apps/desktop/package.json');
 const THIRD_PARTY_NOTICES_FILE = resolve(REPO_ROOT, 'apps/desktop/src/renderer/public/THIRD_PARTY_LICENSES.txt');
 const ONBOARDING_HERO_FILE = resolve(REPO_ROOT, 'apps/desktop/src/renderer/OnboardingHero.tsx');
@@ -430,6 +431,31 @@ describe('icon + typography governance contract', () => {
  assert.match(componentSrc, /case 'stepfun':\s*return <ProviderAssetMask src=\{stepfunBrandMark\} \/>/);
  });
 
+ it('vendors and routes the byte-exact upstream Volcengine mark through the shared asset-mask seam', async () => {
+ const [volcengineMark, componentSrc, notices] = await Promise.all([
+ readFile(VOLCENGINE_BRAND_MARK_FILE),
+ readFile(PROVIDER_BRAND_MARKS_FILE, 'utf8'),
+ readFile(THIRD_PARTY_NOTICES_FILE, 'utf8'),
+ ]);
+
+ assert.equal(
+ createHash('sha256').update(volcengineMark).digest('hex'),
+ 'f29d0bdc284b33d8664ef221add7fbf06a5b370ef92767fa33f6020c914d3d33',
+ 'the vendored Volcengine mark must remain byte-identical to @lobehub/icons-static-svg@1.91.0 volcengine.svg',
+ );
+ assert.match(
+ notices,
+ /apps\/desktop\/src\/renderer\/assets\/provider-brands\/volcengine\.svg[\s\S]*e4302041fbb3039608d25f9f618bd462783b875e[\s\S]*packages\/static-svg\/icons\/volcengine\.svg[\s\S]*f29d0bdc284b33d8664ef221add7fbf06a5b370ef92767fa33f6020c914d3d33/,
+ 'Volcengine must append byte-exact provenance to the existing Lobe Icons notice entry',
+ );
+ assert.match(componentSrc, /import volcengineBrandMark from '\.\.\/assets\/provider-brands\/volcengine\.svg';/);
+ assert.match(
+ componentSrc,
+ /Volcengine mark vendored byte-for-byte from Lobe Icons:[\s\S]*@lobehub\/icons-static-svg@1\.91\.0[\s\S]*e4302041fbb3039608d25f9f618bd462783b875e[\s\S]*packages\/static-svg\/icons\/volcengine\.svg[\s\S]*MIT[\s\S]*f29d0bdc284b33d8664ef221add7fbf06a5b370ef92767fa33f6020c914d3d33/,
+ );
+ assert.match(componentSrc, /case 'volcengine-ark':\s*return <ProviderAssetMask src=\{volcengineBrandMark\} \/>/);
+ });
+
  it('vendors and routes the byte-exact Tencent Cloud mark for Tencent Coding Plan', async () => {
  const [tencentCloudMark, componentSrc, notices] = await Promise.all([
  readFile(TENCENT_CLOUD_BRAND_MARK_FILE),

apps/desktop/src/renderer/public/THIRD_PARTY_LICENSES.txt

@@ -53,6 +53,10 @@ This file records notices for third-party source assets vendored into the Maka d
  - Upstream commit: `e4302041fbb3039608d25f9f618bd462783b875e`
  - Upstream path: `packages/static-svg/icons/stepfun.svg`
  - SHA-256: `f46fbd1eee00a3dc7874395484bcc3e25a803e9eb4b79f07b7eec377a1e2f25c`
+ - `apps/desktop/src/renderer/assets/provider-brands/volcengine.svg`
+ - Upstream commit: `e4302041fbb3039608d25f9f618bd462783b875e`
+ - Upstream path: `packages/static-svg/icons/volcengine.svg`
+ - SHA-256: `f29d0bdc284b33d8664ef221add7fbf06a5b370ef92767fa33f6020c914d3d33`
 
 MIT License
 

apps/desktop/src/renderer/settings/provider-brand-marks.tsx

@@ -25,6 +25,7 @@ import mistralBrandMark from '../assets/provider-brands/mistral.svg';
 import togetherBrandMark from '../assets/provider-brands/together.svg';
 import nvidiaMarkUrl from '../assets/provider-brands/nvidia.svg';
 import stepfunBrandMark from '../assets/provider-brands/stepfun.svg';
+import volcengineBrandMark from '../assets/provider-brands/volcengine.svg';
 import xaiMarkUrl from '../assets/provider-brands/xai.svg';
 
 // Real xAI/Grok mark vendored byte-for-byte from Lobe Icons:
@@ -92,6 +93,14 @@ function XAI(): ReactElement {
 // - license: MIT (repository LICENSE)
 // - SHA-256: f46fbd1eee00a3dc7874395484bcc3e25a803e9eb4b79f07b7eec377a1e2f25c
 
+// Volcengine mark vendored byte-for-byte from Lobe Icons:
+// - repository: https://github.com/lobehub/lobe-icons
+// - package/version: @lobehub/icons-static-svg@1.91.0
+// - commit: e4302041fbb3039608d25f9f618bd462783b875e
+// - path: packages/static-svg/icons/volcengine.svg
+// - license: MIT (repository LICENSE)
+// - SHA-256: f29d0bdc284b33d8664ef221add7fbf06a5b370ef92767fa33f6020c914d3d33
+
 function ProviderAssetMask({ src }: { src: string }): ReactElement {
  const mask = `url("${src}")`;
  return <span className="providerAssetMask" style={{ maskImage: mask, WebkitMaskImage: mask }} aria-hidden="true" />;
@@ -278,6 +287,8 @@ export function ProviderBrandMark({ type }: { type: ProviderType }): ReactElemen
  case 'stepfun-ai':
  case 'stepfun':
  return <ProviderAssetMask src={stepfunBrandMark} />;
+ case 'volcengine-ark':
+ return <ProviderAssetMask src={volcengineBrandMark} />;
  default:
  return <GenericProviderMark />;
  }

packages/cli/src/__tests__/connection-target.test.ts

@@ -4,6 +4,30 @@ import type { LlmConnection } from '@maka/core/llm-connections';
 import { listReadyModelChoices, resolveDefaultSessionTarget } from '../connection-target.js';
 
 describe('default session target resolver', () => {
+ test('resolves Volcengine Ark credentials without rewriting the snapshot model id', async () => {
+ const modelId = 'doubao-seed-2-0-pro-260215';
+ const connection = makeConnection({
+ slug: 'volcengine-ark',
+ name: 'Volcengine Ark (China)',
+ providerType: 'volcengine-ark',
+ defaultModel: modelId,
+ });
+
+ const target = await resolveDefaultSessionTarget({
+ connectionStore: {
+ getDefault: async () => 'volcengine-ark',
+ get: async (slug) => slug === 'volcengine-ark' ? connection : null,
+ },
+ credentialStore: {
+ getSecret: async (_slug, kind) => kind === 'api_key' ? 'ark-test-key' : null,
+ },
+ });
+
+ assert.equal(target.connection.providerType, 'volcengine-ark');
+ assert.equal(target.apiKey, 'ark-test-key');
+ assert.equal(target.model, modelId);
+ });
+
  test('resolves Fireworks credentials without rewriting the exact model path', async () => {
  const connection = makeConnection({
  slug: 'fireworks-ai',

packages/core/src/__tests__/llm-connections.test.ts

@@ -48,6 +48,7 @@ describe('provider compatibility contract', () => {
  'tencent-tokenhub',
  'stepfun',
  'stepfun-ai',
+ 'volcengine-ark',
  'ollama',
  'lm-studio',
  'openai-compatible',
@@ -80,6 +81,7 @@ describe('provider compatibility contract', () => {
  'stepfun',
  'tencent-coding-plan',
  'stepfun-ai',
+ 'volcengine-ark',
  ]);
  assert.deepEqual(CATALOG_PROVIDER_TYPES, [
  'kimi-coding-plan',
@@ -106,6 +108,7 @@ describe('provider compatibility contract', () => {
  'stepfun',
  'tencent-coding-plan',
  'stepfun-ai',
+ 'volcengine-ark',
  ]);
 
  for (const orderField of ['readyOrder', 'catalogOrder', 'recommendedOrder'] as const) {
@@ -371,6 +374,23 @@ describe('provider compatibility contract', () => {
  'step-3.5-flash',
  ]);
  });
+
+ it('owns Volcengine Ark China direct API behavior under the stable volcengine-ark id', () => {
+ const ark = (PROVIDER_REGISTRY as Partial<Record<string, (typeof PROVIDER_REGISTRY)[keyof typeof PROVIDER_REGISTRY]>>)['volcengine-ark'];
+
+ assert.ok(ark, 'Volcengine Ark China direct API must have its own persisted provider id');
+ assert.equal(ark.label, 'Volcengine Ark (China)');
+ assert.equal(ark.baseUrl, 'https://ark.cn-beijing.volces.com/api/v3');
+ assert.equal(ark.authKind, 'api_key');
+ assert.equal(ark.protocol, 'openai');
+ assert.deepEqual(ark.runtimeAdapter, { kind: 'openai-compatible', name: 'provider' });
+ assert.deepEqual(ark.modelDiscovery, { kind: 'fallback' });
+ assert.equal(ark.category, 'domestic');
+ assert.equal(ark.catalogGroup, 'api');
+ assert.equal(ark.signupUrl, 'https://console.volcengine.com/ark/region:ark+cn-beijing/model');
+ assert.equal(ark.modelsDevId, undefined);
+ assert.deepEqual(ark.fallbackModels, ['doubao-seed-2-0-pro-260215']);
+ });
 });
 
 describe('validateConnectionBaseUrl (PR-UI-IPC-1, @kenji msg 35260e29)', () => {

packages/core/src/__tests__/model-catalog.test.ts

@@ -34,6 +34,25 @@ describe('ModelCatalogEntry', () => {
  });
  });
 
+ it('uses the official Volcengine Ark snapshot without inventing live model discovery', () => {
+ const entries = buildConnectionModelCatalogEntries({
+ connection: {
+ slug: 'volcengine-ark',
+ providerType: 'volcengine-ark',
+ defaultModel: 'doubao-seed-2-0-pro-260215',
+ },
+ });
+
+ assert.deepEqual(entries.map((entry) => entry.id), ['doubao-seed-2-0-pro-260215']);
+ assert.equal(entries[0]?.displayName, 'Doubao Seed 2.0 Pro');
+ assert.equal(entries[0]?.source, 'static_catalog');
+ assert.equal(entries[0]?.provenance.modelSource, 'fallback');
+ assert.deepEqual(entries[0]?.capabilities, {
+ reasoning: true,
+ functionCalling: true,
+ });
+ });
+
  it('uses the checked-in StepFun China snapshot until account discovery succeeds', () => {
  const entries = buildConnectionModelCatalogEntries({
  connection: {

packages/core/src/__tests__/provider-auth.test.ts

@@ -48,6 +48,19 @@ describe('ProviderAuth contract', () => {
  expect(contract.actionAvailability.fetch_models).toBe('available');
  });
 
+ test('Volcengine Ark China uses the shared API-key credential and snapshot-model flow', () => {
+ const contract = deriveProviderAuthContract({
+ providerType: 'volcengine-ark',
+ hasSecret: true,
+ });
+
+ expect(contract.providerType).toBe('volcengine-ark');
+ expect(contract.setupMode).toBe('api_key');
+ expect(contract.requiresSecret).toBe(true);
+ expect(contract.actionAvailability.test_credentials).toBe('available');
+ expect(contract.actionAvailability.fetch_models).toBe('hidden');
+ });
+
  test('Together AI uses the shared API-key credential flow under its stable provider id', () => {
  const contract = deriveProviderAuthContract({
  providerType: 'togetherai',

packages/core/src/model-metadata.ts

@@ -118,6 +118,19 @@ const STATIC_MODEL_METADATA: Partial<Record<ProviderType, Record<string, ModelMe
  'tencent-coding-plan': {
  'kimi-k2.5': { capabilities: { vision: false } },
  },
+ 'volcengine-ark': {
+ 'doubao-seed-2-0-pro-260215': {
+ displayName: 'Doubao Seed 2.0 Pro',
+ lifecycle: 'active',
+ docsUrl: 'https://www.volcengine.com/docs/82379',
+ capabilities: { reasoning: true, functionCalling: true },
+ thinkingOptions: {
+ efforts: ['minimal', 'low', 'medium', 'high'],
+ toggle: true,
+ offBehavior: 'volcengine-thinking-disabled',
+ },
+ },
+ },
  deepseek: {
  'deepseek-v4-flash': { thinkingOptions: { efforts: ['high', 'max'], toggle: true } },
  },

packages/core/src/model-thinking.ts

@@ -43,7 +43,8 @@ export function isThinkingLevel(value: unknown): value is ThinkingLevel {
  */
 export type ThinkingOffBehavior =
  | 'anthropic-thinking-disabled'
- | 'google-thinking-budget-zero';
+ | 'google-thinking-budget-zero'
+ | 'volcengine-thinking-disabled';
 
 export interface ThinkingOptions {
  readonly efforts?: readonly string[];

packages/core/src/provider-registry.ts

@@ -580,6 +580,24 @@ const providerRegistry = {
  readyOrder: 24,
  catalogOrder: 24,
  },
+ 'volcengine-ark': {
+ label: 'Volcengine Ark (China)',
+ description: 'Volcengine Ark direct API for reasoning and tool-use agents in China.',
+ baseUrl: 'https://ark.cn-beijing.volces.com/api/v3',
+ authKind: 'api_key',
+ backendKind: 'ai-sdk',
+ fallbackModels: ['doubao-seed-2-0-pro-260215'],
+ status: 'ready',
+ protocol: 'openai',
+ runtimeAdapter: { kind: 'openai-compatible', name: 'provider' },
+ modelDiscovery: { kind: 'fallback' },
+ category: 'domestic',
+ catalogGroup: 'api',
+ catalogBadge: 'API',
+ signupUrl: 'https://console.volcengine.com/ark/region:ark+cn-beijing/model',
+ readyOrder: 25,
+ catalogOrder: 25,
+ },
  ollama: {
  label: 'Ollama',
  description: 'Local models from Ollama on localhost.',

packages/headless/src/__tests__/harbor-cell.test.ts

@@ -2362,6 +2362,33 @@ setTimeout(() => {
  assert.equal(missing.apiKey, '');
  });
 
+ test('resolves Volcengine Ark only from its official direct API credential env', () => {
+ const modelId = 'doubao-seed-2-0-pro-260215';
+ const resolved = resolveHarborCellAiSdkEnv({
+ provider: 'volcengine-ark',
+ model: modelId,
+ env: {
+ ARK_API_KEY: 'ark-key',
+ ARK_BASE_URL: 'https://ark.cn-shanghai.volces.com/api/v3',
+ OPENAI_API_KEY: 'openai-key',
+ },
+ ts: 1,
+ });
+
+ assert.equal(resolved.apiKey, 'ark-key');
+ assert.equal(resolved.connection.providerType, 'volcengine-ark');
+ assert.equal(resolved.connection.defaultModel, modelId);
+ assert.equal(resolved.connection.baseUrl, 'https://ark.cn-shanghai.volces.com/api/v3');
+
+ const missing = resolveHarborCellAiSdkEnv({
+ provider: 'volcengine-ark',
+ model: modelId,
+ env: { OPENAI_API_KEY: 'must-not-cross-provider-boundary' },
+ ts: 1,
+ });
+ assert.equal(missing.apiKey, '');
+ });
+
  test('resolves Cerebras only from Cerebras credential env without rewriting the model id', () => {
  const resolved = resolveHarborCellAiSdkEnv({
  provider: 'cerebras',

packages/headless/src/__tests__/provider-env.test.ts

@@ -94,3 +94,11 @@ test('StepFun Global keeps direct API credentials separate from China and plan i
  baseUrls: ['STEPFUN_AI_BASE_URL'],
  });
 });
+
+test('Volcengine Ark direct API uses its official credential namespace', () => {
+ assert.deepEqual(providerCredentialEnv('volcengine-ark'), {
+ apiKeys: ['ARK_API_KEY'],
+ apiKeyFile: 'ARK_API_KEY_FILE',
+ baseUrls: ['ARK_BASE_URL'],
+ });
+});

packages/headless/src/provider-env.ts

@@ -27,6 +27,7 @@ const PROVIDER_CREDENTIAL_ENV = {
  'tencent-tokenhub': env('TENCENT_TOKENHUB', ['TENCENT_TOKENHUB_BASE_URL']),
  stepfun: env('STEPFUN', ['STEPFUN_BASE_URL']),
  'stepfun-ai': env('STEPFUN_AI', ['STEPFUN_AI_BASE_URL']),
+ 'volcengine-ark': env('ARK', ['ARK_BASE_URL']),
  'openai-compatible': env('OPENAI', ['OPENAI_BASE_URL']),
  'claude-subscription': env('ANTHROPIC'),
 } satisfies Partial<Record<ProviderType, ProviderCredentialEnv>>;

packages/runtime/src/__tests__/model-factory-thinking.test.ts

@@ -71,6 +71,20 @@ describe('buildProviderOptions: thinking level', () => {
  assert.deepEqual(buildProviderOptions(conn('deepseek'), 'deepseek-chat', 'high'), {});
  });
 
+ test('Volcengine Ark sends its official thinking object and optional reasoning effort', () => {
+ const modelId = 'doubao-seed-2-0-pro-260215';
+ assert.deepEqual([...thinkingVariantsForModel('volcengine-ark', modelId)], ['off', 'minimal', 'low', 'medium', 'high']);
+ assert.deepEqual(buildProviderOptions(conn('volcengine-ark'), modelId), {
+ 'volcengine-ark': { thinking: { type: 'enabled' } },
+ });
+ assert.deepEqual(buildProviderOptions(conn('volcengine-ark'), modelId, 'high'), {
+ 'volcengine-ark': { thinking: { type: 'enabled' }, reasoningEffort: 'high' },
+ });
+ assert.deepEqual(buildProviderOptions(conn('volcengine-ark'), modelId, 'off'), {
+ 'volcengine-ark': { thinking: { type: 'disabled' } },
+ });
+ });
+
  test('a level the model does not support is dropped (defensive)', () => {
  assert.deepEqual(buildProviderOptions(conn('openai'), 'gpt-4o', 'high'), { openai: {} });
  assert.deepEqual(buildProviderOptions(conn('anthropic'), 'claude-haiku-4-5', 'max'), { anthropic: {} });
@@ -115,6 +129,7 @@ describe('buildProviderOptions: resolver/options drift guard', () => {
  { providerType: 'google', model: 'gemini-3.5-flash' },
  { providerType: 'deepseek', model: 'deepseek-v4-flash' },
  { providerType: 'zai-coding-plan', model: 'glm-5.2', slug: 'zai-coding-plan' },
+ { providerType: 'volcengine-ark', model: 'doubao-seed-2-0-pro-260215' },
  ];
  for (const { providerType, model, slug } of cases) {
  test(`every effort level for ${providerType}/${model} maps to a non-empty fragment`, () => {

apps/desktop/e2e/providers.spec.ts

@@ -330,6 +330,36 @@ for (const stepfun of [
  await expect(page.getByRole('textbox', { name: '模型密钥' })).toBeVisible();
 });
 
+test('adds Volcengine Ark China with its exact snapshot model, API-key field, and shared official mark', async ({ window: page }) => {
+ await page.getByRole('button', { name: '展开侧边栏' }).click();
+ await page.getByRole('button', { name: '设置' }).click();
+ await page.locator('[aria-label="设置分组"]').getByText('模型', { exact: true }).click();
+ await page.getByRole('button', { name: '添加服务商' }).click();
+
+ await page.getByRole('tab', { name: 'API', exact: true }).click();
+ await page.getByPlaceholder('搜索服务商').fill('Volcengine');
+ const catalogMark = page.locator(
+ '.providerCatalogRow[data-provider="volcengine-ark"] .providerLogo .providerAssetMask',
+ );
+ await expect(catalogMark).toBeVisible();
+ expect(await catalogMark.evaluate(maskRenderContract)).toEqual({ usesAssetMask: true, followsForeground: true });
+ await page.getByRole('button', { name: /添加模型供应商：Volcengine Ark \(China\)/ }).click();
+
+ await expect(page.getByLabel('模型供应商连接标识')).toHaveValue('volcengine-ark');
+ await expect(page.getByLabel('模型供应商服务地址')).toHaveValue('https://ark.cn-beijing.volces.com/api/v3');
+ await expect(page.getByLabel('模型供应商默认模型')).toHaveValue('doubao-seed-2-0-pro-260215');
+ await page.getByRole('button', { name: '保存供应商' }).click();
+
+ await expect(page.getByRole('heading', { name: 'Volcengine Ark (China)', exact: true }).first()).toBeVisible();
+ const detailMark = page.locator(
+ '.providerSubpageHeader .providerLogo[data-provider="volcengine-ark"] .providerAssetMask',
+ );
+ await expect(detailMark).toBeVisible();
+ expect(await detailMark.evaluate(maskRenderContract)).toEqual({ usesAssetMask: true, followsForeground: true });
+ await expect(page.getByText('doubao-seed-2-0-pro-260215', { exact: true }).first()).toBeVisible();
+ await expect(page.getByRole('textbox', { name: '模型密钥' })).toBeVisible();
+});
+
 test('restores keyboard focus across provider child pages', async ({ window: page }) => {
  await page.getByRole('button', { name: '展开侧边栏' }).click();
  await page.getByRole('button', { name: '设置' }).click();

apps/desktop/src/main/__tests__/icon-governance-contract.test.ts

@@ -46,6 +46,7 @@ const NVIDIA_BRAND_MARK_FILE = resolve(REPO_ROOT, 'apps/desktop/src/renderer/ass
 const TENCENT_HUNYUAN_BRAND_MARK_FILE = resolve(REPO_ROOT, 'apps/desktop/src/renderer/assets/provider-brands/hunyuan.svg');
 const TENCENT_CLOUD_BRAND_MARK_FILE = resolve(REPO_ROOT, 'apps/desktop/src/renderer/assets/provider-brands/tencentcloud.svg');
 const STEPFUN_BRAND_MARK_FILE = resolve(REPO_ROOT, 'apps/desktop/src/renderer/assets/provider-brands/stepfun.svg');
+const VOLCENGINE_BRAND_MARK_FILE = resolve(REPO_ROOT, 'apps/desktop/src/renderer/assets/provider-brands/volcengine.svg');
 const DESKTOP_PACKAGE_FILE = resolve(REPO_ROOT, 'apps/desktop/package.json');
 const THIRD_PARTY_NOTICES_FILE = resolve(REPO_ROOT, 'apps/desktop/src/renderer/public/THIRD_PARTY_LICENSES.txt');
 const ONBOARDING_HERO_FILE = resolve(REPO_ROOT, 'apps/desktop/src/renderer/OnboardingHero.tsx');
@@ -430,6 +431,31 @@ describe('icon + typography governance contract', () => {
  assert.match(componentSrc, /case 'stepfun':\s*return <ProviderAssetMask src=\{stepfunBrandMark\} \/>/);
  });
 
+ it('vendors and routes the byte-exact upstream Volcengine mark through the shared asset-mask seam', async () => {
+ const [volcengineMark, componentSrc, notices] = await Promise.all([
+ readFile(VOLCENGINE_BRAND_MARK_FILE),
+ readFile(PROVIDER_BRAND_MARKS_FILE, 'utf8'),
+ readFile(THIRD_PARTY_NOTICES_FILE, 'utf8'),
+ ]);
+
+ assert.equal(
+ createHash('sha256').update(volcengineMark).digest('hex'),
+ 'f29d0bdc284b33d8664ef221add7fbf06a5b370ef92767fa33f6020c914d3d33',
+ 'the vendored Volcengine mark must remain byte-identical to @lobehub/icons-static-svg@1.91.0 volcengine.svg',
+ );
+ assert.match(
+ notices,
+ /apps\/desktop\/src\/renderer\/assets\/provider-brands\/volcengine\.svg[\s\S]*e4302041fbb3039608d25f9f618bd462783b875e[\s\S]*packages\/static-svg\/icons\/volcengine\.svg[\s\S]*f29d0bdc284b33d8664ef221add7fbf06a5b370ef92767fa33f6020c914d3d33/,
+ 'Volcengine must append byte-exact provenance to the existing Lobe Icons notice entry',
+ );
+ assert.match(componentSrc, /import volcengineBrandMark from '\.\.\/assets\/provider-brands\/volcengine\.svg';/);
+ assert.match(
+ componentSrc,
+ /Volcengine mark vendored byte-for-byte from Lobe Icons:[\s\S]*@lobehub\/icons-static-svg@1\.91\.0[\s\S]*e4302041fbb3039608d25f9f618bd462783b875e[\s\S]*packages\/static-svg\/icons\/volcengine\.svg[\s\S]*MIT[\s\S]*f29d0bdc284b33d8664ef221add7fbf06a5b370ef92767fa33f6020c914d3d33/,
+ );
+ assert.match(componentSrc, /case 'volcengine-ark':\s*return <ProviderAssetMask src=\{volcengineBrandMark\} \/>/);
+ });
+
  it('vendors and routes the byte-exact Tencent Cloud mark for Tencent Coding Plan', async () => {
  const [tencentCloudMark, componentSrc, notices] = await Promise.all([
  readFile(TENCENT_CLOUD_BRAND_MARK_FILE),

apps/desktop/src/renderer/public/THIRD_PARTY_LICENSES.txt

@@ -53,6 +53,10 @@ This file records notices for third-party source assets vendored into the Maka d
  - Upstream commit: `e4302041fbb3039608d25f9f618bd462783b875e`
  - Upstream path: `packages/static-svg/icons/stepfun.svg`
  - SHA-256: `f46fbd1eee00a3dc7874395484bcc3e25a803e9eb4b79f07b7eec377a1e2f25c`
+ - `apps/desktop/src/renderer/assets/provider-brands/volcengine.svg`
+ - Upstream commit: `e4302041fbb3039608d25f9f618bd462783b875e`
+ - Upstream path: `packages/static-svg/icons/volcengine.svg`
+ - SHA-256: `f29d0bdc284b33d8664ef221add7fbf06a5b370ef92767fa33f6020c914d3d33`
 
 MIT License
 

apps/desktop/src/renderer/settings/provider-brand-marks.tsx

@@ -25,6 +25,7 @@ import mistralBrandMark from '../assets/provider-brands/mistral.svg';
 import togetherBrandMark from '../assets/provider-brands/together.svg';
 import nvidiaMarkUrl from '../assets/provider-brands/nvidia.svg';
 import stepfunBrandMark from '../assets/provider-brands/stepfun.svg';
+import volcengineBrandMark from '../assets/provider-brands/volcengine.svg';
 import xaiMarkUrl from '../assets/provider-brands/xai.svg';
 
 // Real xAI/Grok mark vendored byte-for-byte from Lobe Icons:
@@ -92,6 +93,14 @@ function XAI(): ReactElement {
 // - license: MIT (repository LICENSE)
 // - SHA-256: f46fbd1eee00a3dc7874395484bcc3e25a803e9eb4b79f07b7eec377a1e2f25c
 
+// Volcengine mark vendored byte-for-byte from Lobe Icons:
+// - repository: https://github.com/lobehub/lobe-icons
+// - package/version: @lobehub/icons-static-svg@1.91.0
+// - commit: e4302041fbb3039608d25f9f618bd462783b875e
+// - path: packages/static-svg/icons/volcengine.svg
+// - license: MIT (repository LICENSE)
+// - SHA-256: f29d0bdc284b33d8664ef221add7fbf06a5b370ef92767fa33f6020c914d3d33
+
 function ProviderAssetMask({ src }: { src: string }): ReactElement {
  const mask = `url("${src}")`;
  return <span className="providerAssetMask" style={{ maskImage: mask, WebkitMaskImage: mask }} aria-hidden="true" />;
@@ -278,6 +287,8 @@ export function ProviderBrandMark({ type }: { type: ProviderType }): ReactElemen
  case 'stepfun-ai':
  case 'stepfun':
  return <ProviderAssetMask src={stepfunBrandMark} />;
+ case 'volcengine-ark':
+ return <ProviderAssetMask src={volcengineBrandMark} />;
  default:
  return <GenericProviderMark />;
  }

packages/cli/src/__tests__/connection-target.test.ts

@@ -4,6 +4,30 @@ import type { LlmConnection } from '@maka/core/llm-connections';
 import { listReadyModelChoices, resolveDefaultSessionTarget } from '../connection-target.js';
 
 describe('default session target resolver', () => {
+ test('resolves Volcengine Ark credentials without rewriting the snapshot model id', async () => {
+ const modelId = 'doubao-seed-2-0-pro-260215';
+ const connection = makeConnection({
+ slug: 'volcengine-ark',
+ name: 'Volcengine Ark (China)',
+ providerType: 'volcengine-ark',
+ defaultModel: modelId,
+ });
+
+ const target = await resolveDefaultSessionTarget({
+ connectionStore: {
+ getDefault: async () => 'volcengine-ark',
+ get: async (slug) => slug === 'volcengine-ark' ? connection : null,
+ },
+ credentialStore: {
+ getSecret: async (_slug, kind) => kind === 'api_key' ? 'ark-test-key' : null,
+ },
+ });
+
+ assert.equal(target.connection.providerType, 'volcengine-ark');
+ assert.equal(target.apiKey, 'ark-test-key');
+ assert.equal(target.model, modelId);
+ });
+
  test('resolves Fireworks credentials without rewriting the exact model path', async () => {
  const connection = makeConnection({
  slug: 'fireworks-ai',

packages/core/src/__tests__/llm-connections.test.ts

@@ -48,6 +48,7 @@ describe('provider compatibility contract', () => {
  'tencent-tokenhub',
  'stepfun',
  'stepfun-ai',
+ 'volcengine-ark',
  'ollama',
  'lm-studio',
  'openai-compatible',
@@ -80,6 +81,7 @@ describe('provider compatibility contract', () => {
  'stepfun',
  'tencent-coding-plan',
  'stepfun-ai',
+ 'volcengine-ark',
  ]);
  assert.deepEqual(CATALOG_PROVIDER_TYPES, [
  'kimi-coding-plan',
@@ -106,6 +108,7 @@ describe('provider compatibility contract', () => {
  'stepfun',
  'tencent-coding-plan',
  'stepfun-ai',
+ 'volcengine-ark',
  ]);
 
  for (const orderField of ['readyOrder', 'catalogOrder', 'recommendedOrder'] as const) {
@@ -371,6 +374,23 @@ describe('provider compatibility contract', () => {
  'step-3.5-flash',
  ]);
  });
+
+ it('owns Volcengine Ark China direct API behavior under the stable volcengine-ark id', () => {
+ const ark = (PROVIDER_REGISTRY as Partial<Record<string, (typeof PROVIDER_REGISTRY)[keyof typeof PROVIDER_REGISTRY]>>)['volcengine-ark'];
+
+ assert.ok(ark, 'Volcengine Ark China direct API must have its own persisted provider id');
+ assert.equal(ark.label, 'Volcengine Ark (China)');
+ assert.equal(ark.baseUrl, 'https://ark.cn-beijing.volces.com/api/v3');
+ assert.equal(ark.authKind, 'api_key');
+ assert.equal(ark.protocol, 'openai');
+ assert.deepEqual(ark.runtimeAdapter, { kind: 'openai-compatible', name: 'provider' });
+ assert.deepEqual(ark.modelDiscovery, { kind: 'fallback' });
+ assert.equal(ark.category, 'domestic');
+ assert.equal(ark.catalogGroup, 'api');
+ assert.equal(ark.signupUrl, 'https://console.volcengine.com/ark/region:ark+cn-beijing/model');
+ assert.equal(ark.modelsDevId, undefined);
+ assert.deepEqual(ark.fallbackModels, ['doubao-seed-2-0-pro-260215']);
+ });
 });
 
 describe('validateConnectionBaseUrl (PR-UI-IPC-1, @kenji msg 35260e29)', () => {

packages/core/src/__tests__/model-catalog.test.ts

@@ -34,6 +34,25 @@ describe('ModelCatalogEntry', () => {
  });
  });
 
+ it('uses the official Volcengine Ark snapshot without inventing live model discovery', () => {
+ const entries = buildConnectionModelCatalogEntries({
+ connection: {
+ slug: 'volcengine-ark',
+ providerType: 'volcengine-ark',
+ defaultModel: 'doubao-seed-2-0-pro-260215',
+ },
+ });
+
+ assert.deepEqual(entries.map((entry) => entry.id), ['doubao-seed-2-0-pro-260215']);
+ assert.equal(entries[0]?.displayName, 'Doubao Seed 2.0 Pro');
+ assert.equal(entries[0]?.source, 'static_catalog');
+ assert.equal(entries[0]?.provenance.modelSource, 'fallback');
+ assert.deepEqual(entries[0]?.capabilities, {
+ reasoning: true,
+ functionCalling: true,
+ });
+ });
+
  it('uses the checked-in StepFun China snapshot until account discovery succeeds', () => {
  const entries = buildConnectionModelCatalogEntries({
  connection: {

packages/core/src/__tests__/provider-auth.test.ts

@@ -48,6 +48,19 @@ describe('ProviderAuth contract', () => {
  expect(contract.actionAvailability.fetch_models).toBe('available');
  });
 
+ test('Volcengine Ark China uses the shared API-key credential and snapshot-model flow', () => {
+ const contract = deriveProviderAuthContract({
+ providerType: 'volcengine-ark',
+ hasSecret: true,
+ });
+
+ expect(contract.providerType).toBe('volcengine-ark');
+ expect(contract.setupMode).toBe('api_key');
+ expect(contract.requiresSecret).toBe(true);
+ expect(contract.actionAvailability.test_credentials).toBe('available');
+ expect(contract.actionAvailability.fetch_models).toBe('hidden');
+ });
+
  test('Together AI uses the shared API-key credential flow under its stable provider id', () => {
  const contract = deriveProviderAuthContract({
  providerType: 'togetherai',

packages/core/src/model-metadata.ts

@@ -118,6 +118,19 @@ const STATIC_MODEL_METADATA: Partial<Record<ProviderType, Record<string, ModelMe
  'tencent-coding-plan': {
  'kimi-k2.5': { capabilities: { vision: false } },
  },
+ 'volcengine-ark': {
+ 'doubao-seed-2-0-pro-260215': {
+ displayName: 'Doubao Seed 2.0 Pro',
+ lifecycle: 'active',
+ docsUrl: 'https://www.volcengine.com/docs/82379',
+ capabilities: { reasoning: true, functionCalling: true },
+ thinkingOptions: {
+ efforts: ['minimal', 'low', 'medium', 'high'],
+ toggle: true,
+ offBehavior: 'volcengine-thinking-disabled',
+ },
+ },
+ },
  deepseek: {
  'deepseek-v4-flash': { thinkingOptions: { efforts: ['high', 'max'], toggle: true } },
  },

packages/core/src/model-thinking.ts

@@ -43,7 +43,8 @@ export function isThinkingLevel(value: unknown): value is ThinkingLevel {
  */
 export type ThinkingOffBehavior =
  | 'anthropic-thinking-disabled'
- | 'google-thinking-budget-zero';
+ | 'google-thinking-budget-zero'
+ | 'volcengine-thinking-disabled';
 
 export interface ThinkingOptions {
  readonly efforts?: readonly string[];

packages/core/src/provider-registry.ts

@@ -580,6 +580,24 @@ const providerRegistry = {
  readyOrder: 24,
  catalogOrder: 24,
  },
+ 'volcengine-ark': {
+ label: 'Volcengine Ark (China)',
+ description: 'Volcengine Ark direct API for reasoning and tool-use agents in China.',
+ baseUrl: 'https://ark.cn-beijing.volces.com/api/v3',
+ authKind: 'api_key',
+ backendKind: 'ai-sdk',
+ fallbackModels: ['doubao-seed-2-0-pro-260215'],
+ status: 'ready',
+ protocol: 'openai',
+ runtimeAdapter: { kind: 'openai-compatible', name: 'provider' },
+ modelDiscovery: { kind: 'fallback' },
+ category: 'domestic',
+ catalogGroup: 'api',
+ catalogBadge: 'API',
+ signupUrl: 'https://console.volcengine.com/ark/region:ark+cn-beijing/model',
+ readyOrder: 25,
+ catalogOrder: 25,
+ },
  ollama: {
  label: 'Ollama',
  description: 'Local models from Ollama on localhost.',

packages/headless/src/__tests__/harbor-cell.test.ts

@@ -2362,6 +2362,33 @@ setTimeout(() => {
  assert.equal(missing.apiKey, '');
  });
 
+ test('resolves Volcengine Ark only from its official direct API credential env', () => {
+ const modelId = 'doubao-seed-2-0-pro-260215';
+ const resolved = resolveHarborCellAiSdkEnv({
+ provider: 'volcengine-ark',
+ model: modelId,
+ env: {
+ ARK_API_KEY: 'ark-key',
+ ARK_BASE_URL: 'https://ark.cn-shanghai.volces.com/api/v3',
+ OPENAI_API_KEY: 'openai-key',
+ },
+ ts: 1,
+ });
+
+ assert.equal(resolved.apiKey, 'ark-key');
+ assert.equal(resolved.connection.providerType, 'volcengine-ark');
+ assert.equal(resolved.connection.defaultModel, modelId);
+ assert.equal(resolved.connection.baseUrl, 'https://ark.cn-shanghai.volces.com/api/v3');
+
+ const missing = resolveHarborCellAiSdkEnv({
+ provider: 'volcengine-ark',
+ model: modelId,
+ env: { OPENAI_API_KEY: 'must-not-cross-provider-boundary' },
+ ts: 1,
+ });
+ assert.equal(missing.apiKey, '');
+ });
+
  test('resolves Cerebras only from Cerebras credential env without rewriting the model id', () => {
  const resolved = resolveHarborCellAiSdkEnv({
  provider: 'cerebras',

packages/headless/src/__tests__/provider-env.test.ts

@@ -94,3 +94,11 @@ test('StepFun Global keeps direct API credentials separate from China and plan i
  baseUrls: ['STEPFUN_AI_BASE_URL'],
  });
 });
+
+test('Volcengine Ark direct API uses its official credential namespace', () => {
+ assert.deepEqual(providerCredentialEnv('volcengine-ark'), {
+ apiKeys: ['ARK_API_KEY'],
+ apiKeyFile: 'ARK_API_KEY_FILE',
+ baseUrls: ['ARK_BASE_URL'],
+ });
+});

packages/headless/src/provider-env.ts

@@ -27,6 +27,7 @@ const PROVIDER_CREDENTIAL_ENV = {
  'tencent-tokenhub': env('TENCENT_TOKENHUB', ['TENCENT_TOKENHUB_BASE_URL']),
  stepfun: env('STEPFUN', ['STEPFUN_BASE_URL']),
  'stepfun-ai': env('STEPFUN_AI', ['STEPFUN_AI_BASE_URL']),
+ 'volcengine-ark': env('ARK', ['ARK_BASE_URL']),
  'openai-compatible': env('OPENAI', ['OPENAI_BASE_URL']),
  'claude-subscription': env('ANTHROPIC'),
 } satisfies Partial<Record<ProviderType, ProviderCredentialEnv>>;

packages/runtime/src/__tests__/model-factory-thinking.test.ts

@@ -71,6 +71,20 @@ describe('buildProviderOptions: thinking level', () => {
  assert.deepEqual(buildProviderOptions(conn('deepseek'), 'deepseek-chat', 'high'), {});
  });
 
+ test('Volcengine Ark sends its official thinking object and optional reasoning effort', () => {
+ const modelId = 'doubao-seed-2-0-pro-260215';
+ assert.deepEqual([...thinkingVariantsForModel('volcengine-ark', modelId)], ['off', 'minimal', 'low', 'medium', 'high']);
+ assert.deepEqual(buildProviderOptions(conn('volcengine-ark'), modelId), {
+ 'volcengine-ark': { thinking: { type: 'enabled' } },
+ });
+ assert.deepEqual(buildProviderOptions(conn('volcengine-ark'), modelId, 'high'), {
+ 'volcengine-ark': { thinking: { type: 'enabled' }, reasoningEffort: 'high' },
+ });
+ assert.deepEqual(buildProviderOptions(conn('volcengine-ark'), modelId, 'off'), {
+ 'volcengine-ark': { thinking: { type: 'disabled' } },
+ });
+ });
+
  test('a level the model does not support is dropped (defensive)', () => {
  assert.deepEqual(buildProviderOptions(conn('openai'), 'gpt-4o', 'high'), { openai: {} });
  assert.deepEqual(buildProviderOptions(conn('anthropic'), 'claude-haiku-4-5', 'max'), { anthropic: {} });
@@ -115,6 +129,7 @@ describe('buildProviderOptions: resolver/options drift guard', () => {
  { providerType: 'google', model: 'gemini-3.5-flash' },
  { providerType: 'deepseek', model: 'deepseek-v4-flash' },
  { providerType: 'zai-coding-plan', model: 'glm-5.2', slug: 'zai-coding-plan' },
+ { providerType: 'volcengine-ark', model: 'doubao-seed-2-0-pro-260215' },
  ];
  for (const { providerType, model, slug } of cases) {
  test(`every effort level for ${providerType}/${model} maps to a non-empty fragment`, () => {

apps/desktop/e2e/providers.spec.ts

@@ -330,6 +330,36 @@ for (const stepfun of [
  await expect(page.getByRole('textbox', { name: '模型密钥' })).toBeVisible();
 });
 
+test('adds Volcengine Ark China with its exact snapshot model, API-key field, and shared official mark', async ({ window: page }) => {
+ await page.getByRole('button', { name: '展开侧边栏' }).click();
+ await page.getByRole('button', { name: '设置' }).click();
+ await page.locator('[aria-label="设置分组"]').getByText('模型', { exact: true }).click();
+ await page.getByRole('button', { name: '添加服务商' }).click();
+
+ await page.getByRole('tab', { name: 'API', exact: true }).click();
+ await page.getByPlaceholder('搜索服务商').fill('Volcengine');
+ const catalogMark = page.locator(
+ '.providerCatalogRow[data-provider="volcengine-ark"] .providerLogo .providerAssetMask',
+ );
+ await expect(catalogMark).toBeVisible();
+ expect(await catalogMark.evaluate(maskRenderContract)).toEqual({ usesAssetMask: true, followsForeground: true });
+ await page.getByRole('button', { name: /添加模型供应商：Volcengine Ark \(China\)/ }).click();
+
+ await expect(page.getByLabel('模型供应商连接标识')).toHaveValue('volcengine-ark');
+ await expect(page.getByLabel('模型供应商服务地址')).toHaveValue('https://ark.cn-beijing.volces.com/api/v3');
+ await expect(page.getByLabel('模型供应商默认模型')).toHaveValue('doubao-seed-2-0-pro-260215');
+ await page.getByRole('button', { name: '保存供应商' }).click();
+
+ await expect(page.getByRole('heading', { name: 'Volcengine Ark (China)', exact: true }).first()).toBeVisible();
+ const detailMark = page.locator(
+ '.providerSubpageHeader .providerLogo[data-provider="volcengine-ark"] .providerAssetMask',
+ );
+ await expect(detailMark).toBeVisible();
+ expect(await detailMark.evaluate(maskRenderContract)).toEqual({ usesAssetMask: true, followsForeground: true });
+ await expect(page.getByText('doubao-seed-2-0-pro-260215', { exact: true }).first()).toBeVisible();
+ await expect(page.getByRole('textbox', { name: '模型密钥' })).toBeVisible();
+});
+
 test('restores keyboard focus across provider child pages', async ({ window: page }) => {
  await page.getByRole('button', { name: '展开侧边栏' }).click();
  await page.getByRole('button', { name: '设置' }).click();

apps/desktop/src/main/__tests__/icon-governance-contract.test.ts

@@ -46,6 +46,7 @@ const NVIDIA_BRAND_MARK_FILE = resolve(REPO_ROOT, 'apps/desktop/src/renderer/ass
 const TENCENT_HUNYUAN_BRAND_MARK_FILE = resolve(REPO_ROOT, 'apps/desktop/src/renderer/assets/provider-brands/hunyuan.svg');
 const TENCENT_CLOUD_BRAND_MARK_FILE = resolve(REPO_ROOT, 'apps/desktop/src/renderer/assets/provider-brands/tencentcloud.svg');
 const STEPFUN_BRAND_MARK_FILE = resolve(REPO_ROOT, 'apps/desktop/src/renderer/assets/provider-brands/stepfun.svg');
+const VOLCENGINE_BRAND_MARK_FILE = resolve(REPO_ROOT, 'apps/desktop/src/renderer/assets/provider-brands/volcengine.svg');
 const DESKTOP_PACKAGE_FILE = resolve(REPO_ROOT, 'apps/desktop/package.json');
 const THIRD_PARTY_NOTICES_FILE = resolve(REPO_ROOT, 'apps/desktop/src/renderer/public/THIRD_PARTY_LICENSES.txt');
 const ONBOARDING_HERO_FILE = resolve(REPO_ROOT, 'apps/desktop/src/renderer/OnboardingHero.tsx');
@@ -430,6 +431,31 @@ describe('icon + typography governance contract', () => {
  assert.match(componentSrc, /case 'stepfun':\s*return <ProviderAssetMask src=\{stepfunBrandMark\} \/>/);
  });
 
+ it('vendors and routes the byte-exact upstream Volcengine mark through the shared asset-mask seam', async () => {
+ const [volcengineMark, componentSrc, notices] = await Promise.all([
+ readFile(VOLCENGINE_BRAND_MARK_FILE),
+ readFile(PROVIDER_BRAND_MARKS_FILE, 'utf8'),
+ readFile(THIRD_PARTY_NOTICES_FILE, 'utf8'),
+ ]);
+
+ assert.equal(
+ createHash('sha256').update(volcengineMark).digest('hex'),
+ 'f29d0bdc284b33d8664ef221add7fbf06a5b370ef92767fa33f6020c914d3d33',
+ 'the vendored Volcengine mark must remain byte-identical to @lobehub/icons-static-svg@1.91.0 volcengine.svg',
+ );
+ assert.match(
+ notices,
+ /apps\/desktop\/src\/renderer\/assets\/provider-brands\/volcengine\.svg[\s\S]*e4302041fbb3039608d25f9f618bd462783b875e[\s\S]*packages\/static-svg\/icons\/volcengine\.svg[\s\S]*f29d0bdc284b33d8664ef221add7fbf06a5b370ef92767fa33f6020c914d3d33/,
+ 'Volcengine must append byte-exact provenance to the existing Lobe Icons notice entry',
+ );
+ assert.match(componentSrc, /import volcengineBrandMark from '\.\.\/assets\/provider-brands\/volcengine\.svg';/);
+ assert.match(
+ componentSrc,
+ /Volcengine mark vendored byte-for-byte from Lobe Icons:[\s\S]*@lobehub\/icons-static-svg@1\.91\.0[\s\S]*e4302041fbb3039608d25f9f618bd462783b875e[\s\S]*packages\/static-svg\/icons\/volcengine\.svg[\s\S]*MIT[\s\S]*f29d0bdc284b33d8664ef221add7fbf06a5b370ef92767fa33f6020c914d3d33/,
+ );
+ assert.match(componentSrc, /case 'volcengine-ark':\s*return <ProviderAssetMask src=\{volcengineBrandMark\} \/>/);
+ });
+
  it('vendors and routes the byte-exact Tencent Cloud mark for Tencent Coding Plan', async () => {
  const [tencentCloudMark, componentSrc, notices] = await Promise.all([
  readFile(TENCENT_CLOUD_BRAND_MARK_FILE),

apps/desktop/src/renderer/public/THIRD_PARTY_LICENSES.txt

@@ -53,6 +53,10 @@ This file records notices for third-party source assets vendored into the Maka d
  - Upstream commit: `e4302041fbb3039608d25f9f618bd462783b875e`
  - Upstream path: `packages/static-svg/icons/stepfun.svg`
  - SHA-256: `f46fbd1eee00a3dc7874395484bcc3e25a803e9eb4b79f07b7eec377a1e2f25c`
+ - `apps/desktop/src/renderer/assets/provider-brands/volcengine.svg`
+ - Upstream commit: `e4302041fbb3039608d25f9f618bd462783b875e`
+ - Upstream path: `packages/static-svg/icons/volcengine.svg`
+ - SHA-256: `f29d0bdc284b33d8664ef221add7fbf06a5b370ef92767fa33f6020c914d3d33`
 
 MIT License
 

apps/desktop/src/renderer/settings/provider-brand-marks.tsx

@@ -25,6 +25,7 @@ import mistralBrandMark from '../assets/provider-brands/mistral.svg';
 import togetherBrandMark from '../assets/provider-brands/together.svg';
 import nvidiaMarkUrl from '../assets/provider-brands/nvidia.svg';
 import stepfunBrandMark from '../assets/provider-brands/stepfun.svg';
+import volcengineBrandMark from '../assets/provider-brands/volcengine.svg';
 import xaiMarkUrl from '../assets/provider-brands/xai.svg';
 
 // Real xAI/Grok mark vendored byte-for-byte from Lobe Icons:
@@ -92,6 +93,14 @@ function XAI(): ReactElement {
 // - license: MIT (repository LICENSE)
 // - SHA-256: f46fbd1eee00a3dc7874395484bcc3e25a803e9eb4b79f07b7eec377a1e2f25c
 
+// Volcengine mark vendored byte-for-byte from Lobe Icons:
+// - repository: https://github.com/lobehub/lobe-icons
+// - package/version: @lobehub/icons-static-svg@1.91.0
+// - commit: e4302041fbb3039608d25f9f618bd462783b875e
+// - path: packages/static-svg/icons/volcengine.svg
+// - license: MIT (repository LICENSE)
+// - SHA-256: f29d0bdc284b33d8664ef221add7fbf06a5b370ef92767fa33f6020c914d3d33
+
 function ProviderAssetMask({ src }: { src: string }): ReactElement {
  const mask = `url("${src}")`;
  return <span className="providerAssetMask" style={{ maskImage: mask, WebkitMaskImage: mask }} aria-hidden="true" />;
@@ -278,6 +287,8 @@ export function ProviderBrandMark({ type }: { type: ProviderType }): ReactElemen
  case 'stepfun-ai':
  case 'stepfun':
  return <ProviderAssetMask src={stepfunBrandMark} />;
+ case 'volcengine-ark':
+ return <ProviderAssetMask src={volcengineBrandMark} />;
  default:
  return <GenericProviderMark />;
  }

packages/cli/src/__tests__/connection-target.test.ts

@@ -4,6 +4,30 @@ import type { LlmConnection } from '@maka/core/llm-connections';
 import { listReadyModelChoices, resolveDefaultSessionTarget } from '../connection-target.js';
 
 describe('default session target resolver', () => {
+ test('resolves Volcengine Ark credentials without rewriting the snapshot model id', async () => {
+ const modelId = 'doubao-seed-2-0-pro-260215';
+ const connection = makeConnection({
+ slug: 'volcengine-ark',
+ name: 'Volcengine Ark (China)',
+ providerType: 'volcengine-ark',
+ defaultModel: modelId,
+ });
+
+ const target = await resolveDefaultSessionTarget({
+ connectionStore: {
+ getDefault: async () => 'volcengine-ark',
+ get: async (slug) => slug === 'volcengine-ark' ? connection : null,
+ },
+ credentialStore: {
+ getSecret: async (_slug, kind) => kind === 'api_key' ? 'ark-test-key' : null,
+ },
+ });
+
+ assert.equal(target.connection.providerType, 'volcengine-ark');
+ assert.equal(target.apiKey, 'ark-test-key');
+ assert.equal(target.model, modelId);
+ });
+
  test('resolves Fireworks credentials without rewriting the exact model path', async () => {
  const connection = makeConnection({
  slug: 'fireworks-ai',

packages/core/src/__tests__/llm-connections.test.ts

@@ -48,6 +48,7 @@ describe('provider compatibility contract', () => {
  'tencent-tokenhub',
  'stepfun',
  'stepfun-ai',
+ 'volcengine-ark',
  'ollama',
  'lm-studio',
  'openai-compatible',
@@ -80,6 +81,7 @@ describe('provider compatibility contract', () => {
  'stepfun',
  'tencent-coding-plan',
  'stepfun-ai',
+ 'volcengine-ark',
  ]);
  assert.deepEqual(CATALOG_PROVIDER_TYPES, [
  'kimi-coding-plan',
@@ -106,6 +108,7 @@ describe('provider compatibility contract', () => {
  'stepfun',
  'tencent-coding-plan',
  'stepfun-ai',
+ 'volcengine-ark',
  ]);
 
  for (const orderField of ['readyOrder', 'catalogOrder', 'recommendedOrder'] as const) {
@@ -371,6 +374,23 @@ describe('provider compatibility contract', () => {
  'step-3.5-flash',
  ]);
  });
+
+ it('owns Volcengine Ark China direct API behavior under the stable volcengine-ark id', () => {
+ const ark = (PROVIDER_REGISTRY as Partial<Record<string, (typeof PROVIDER_REGISTRY)[keyof typeof PROVIDER_REGISTRY]>>)['volcengine-ark'];
+
+ assert.ok(ark, 'Volcengine Ark China direct API must have its own persisted provider id');
+ assert.equal(ark.label, 'Volcengine Ark (China)');
+ assert.equal(ark.baseUrl, 'https://ark.cn-beijing.volces.com/api/v3');
+ assert.equal(ark.authKind, 'api_key');
+ assert.equal(ark.protocol, 'openai');
+ assert.deepEqual(ark.runtimeAdapter, { kind: 'openai-compatible', name: 'provider' });
+ assert.deepEqual(ark.modelDiscovery, { kind: 'fallback' });
+ assert.equal(ark.category, 'domestic');
+ assert.equal(ark.catalogGroup, 'api');
+ assert.equal(ark.signupUrl, 'https://console.volcengine.com/ark/region:ark+cn-beijing/model');
+ assert.equal(ark.modelsDevId, undefined);
+ assert.deepEqual(ark.fallbackModels, ['doubao-seed-2-0-pro-260215']);
+ });
 });
 
 describe('validateConnectionBaseUrl (PR-UI-IPC-1, @kenji msg 35260e29)', () => {

packages/core/src/__tests__/model-catalog.test.ts

@@ -34,6 +34,25 @@ describe('ModelCatalogEntry', () => {
  });
  });
 
+ it('uses the official Volcengine Ark snapshot without inventing live model discovery', () => {
+ const entries = buildConnectionModelCatalogEntries({
+ connection: {
+ slug: 'volcengine-ark',
+ providerType: 'volcengine-ark',
+ defaultModel: 'doubao-seed-2-0-pro-260215',
+ },
+ });
+
+ assert.deepEqual(entries.map((entry) => entry.id), ['doubao-seed-2-0-pro-260215']);
+ assert.equal(entries[0]?.displayName, 'Doubao Seed 2.0 Pro');
+ assert.equal(entries[0]?.source, 'static_catalog');
+ assert.equal(entries[0]?.provenance.modelSource, 'fallback');
+ assert.deepEqual(entries[0]?.capabilities, {
+ reasoning: true,
+ functionCalling: true,
+ });
+ });
+
  it('uses the checked-in StepFun China snapshot until account discovery succeeds', () => {
  const entries = buildConnectionModelCatalogEntries({
  connection: {

packages/core/src/__tests__/provider-auth.test.ts

@@ -48,6 +48,19 @@ describe('ProviderAuth contract', () => {
  expect(contract.actionAvailability.fetch_models).toBe('available');
  });
 
+ test('Volcengine Ark China uses the shared API-key credential and snapshot-model flow', () => {
+ const contract = deriveProviderAuthContract({
+ providerType: 'volcengine-ark',
+ hasSecret: true,
+ });
+
+ expect(contract.providerType).toBe('volcengine-ark');
+ expect(contract.setupMode).toBe('api_key');
+ expect(contract.requiresSecret).toBe(true);
+ expect(contract.actionAvailability.test_credentials).toBe('available');
+ expect(contract.actionAvailability.fetch_models).toBe('hidden');
+ });
+
  test('Together AI uses the shared API-key credential flow under its stable provider id', () => {
  const contract = deriveProviderAuthContract({
  providerType: 'togetherai',

packages/core/src/model-metadata.ts

@@ -118,6 +118,19 @@ const STATIC_MODEL_METADATA: Partial<Record<ProviderType, Record<string, ModelMe
  'tencent-coding-plan': {
  'kimi-k2.5': { capabilities: { vision: false } },
  },
+ 'volcengine-ark': {
+ 'doubao-seed-2-0-pro-260215': {
+ displayName: 'Doubao Seed 2.0 Pro',
+ lifecycle: 'active',
+ docsUrl: 'https://www.volcengine.com/docs/82379',
+ capabilities: { reasoning: true, functionCalling: true },
+ thinkingOptions: {
+ efforts: ['minimal', 'low', 'medium', 'high'],
+ toggle: true,
+ offBehavior: 'volcengine-thinking-disabled',
+ },
+ },
+ },
  deepseek: {
  'deepseek-v4-flash': { thinkingOptions: { efforts: ['high', 'max'], toggle: true } },
  },

packages/core/src/model-thinking.ts

@@ -43,7 +43,8 @@ export function isThinkingLevel(value: unknown): value is ThinkingLevel {
  */
 export type ThinkingOffBehavior =
  | 'anthropic-thinking-disabled'
- | 'google-thinking-budget-zero';
+ | 'google-thinking-budget-zero'
+ | 'volcengine-thinking-disabled';
 
 export interface ThinkingOptions {
  readonly efforts?: readonly string[];

packages/core/src/provider-registry.ts

@@ -580,6 +580,24 @@ const providerRegistry = {
  readyOrder: 24,
  catalogOrder: 24,
  },
+ 'volcengine-ark': {
+ label: 'Volcengine Ark (China)',
+ description: 'Volcengine Ark direct API for reasoning and tool-use agents in China.',
+ baseUrl: 'https://ark.cn-beijing.volces.com/api/v3',
+ authKind: 'api_key',
+ backendKind: 'ai-sdk',
+ fallbackModels: ['doubao-seed-2-0-pro-260215'],
+ status: 'ready',
+ protocol: 'openai',
+ runtimeAdapter: { kind: 'openai-compatible', name: 'provider' },
+ modelDiscovery: { kind: 'fallback' },
+ category: 'domestic',
+ catalogGroup: 'api',
+ catalogBadge: 'API',
+ signupUrl: 'https://console.volcengine.com/ark/region:ark+cn-beijing/model',
+ readyOrder: 25,
+ catalogOrder: 25,
+ },
  ollama: {
  label: 'Ollama',
  description: 'Local models from Ollama on localhost.',

packages/headless/src/__tests__/harbor-cell.test.ts

@@ -2362,6 +2362,33 @@ setTimeout(() => {
  assert.equal(missing.apiKey, '');
  });
 
+ test('resolves Volcengine Ark only from its official direct API credential env', () => {
+ const modelId = 'doubao-seed-2-0-pro-260215';
+ const resolved = resolveHarborCellAiSdkEnv({
+ provider: 'volcengine-ark',
+ model: modelId,
+ env: {
+ ARK_API_KEY: 'ark-key',
+ ARK_BASE_URL: 'https://ark.cn-shanghai.volces.com/api/v3',
+ OPENAI_API_KEY: 'openai-key',
+ },
+ ts: 1,
+ });
+
+ assert.equal(resolved.apiKey, 'ark-key');
+ assert.equal(resolved.connection.providerType, 'volcengine-ark');
+ assert.equal(resolved.connection.defaultModel, modelId);
+ assert.equal(resolved.connection.baseUrl, 'https://ark.cn-shanghai.volces.com/api/v3');
+
+ const missing = resolveHarborCellAiSdkEnv({
+ provider: 'volcengine-ark',
+ model: modelId,
+ env: { OPENAI_API_KEY: 'must-not-cross-provider-boundary' },
+ ts: 1,
+ });
+ assert.equal(missing.apiKey, '');
+ });
+
  test('resolves Cerebras only from Cerebras credential env without rewriting the model id', () => {
  const resolved = resolveHarborCellAiSdkEnv({
  provider: 'cerebras',

packages/headless/src/__tests__/provider-env.test.ts

@@ -94,3 +94,11 @@ test('StepFun Global keeps direct API credentials separate from China and plan i
  baseUrls: ['STEPFUN_AI_BASE_URL'],
  });
 });
+
+test('Volcengine Ark direct API uses its official credential namespace', () => {
+ assert.deepEqual(providerCredentialEnv('volcengine-ark'), {
+ apiKeys: ['ARK_API_KEY'],
+ apiKeyFile: 'ARK_API_KEY_FILE',
+ baseUrls: ['ARK_BASE_URL'],
+ });
+});

packages/headless/src/provider-env.ts

@@ -27,6 +27,7 @@ const PROVIDER_CREDENTIAL_ENV = {
  'tencent-tokenhub': env('TENCENT_TOKENHUB', ['TENCENT_TOKENHUB_BASE_URL']),
  stepfun: env('STEPFUN', ['STEPFUN_BASE_URL']),
  'stepfun-ai': env('STEPFUN_AI', ['STEPFUN_AI_BASE_URL']),
+ 'volcengine-ark': env('ARK', ['ARK_BASE_URL']),
  'openai-compatible': env('OPENAI', ['OPENAI_BASE_URL']),
  'claude-subscription': env('ANTHROPIC'),
 } satisfies Partial<Record<ProviderType, ProviderCredentialEnv>>;

packages/runtime/src/__tests__/model-factory-thinking.test.ts

@@ -71,6 +71,20 @@ describe('buildProviderOptions: thinking level', () => {
  assert.deepEqual(buildProviderOptions(conn('deepseek'), 'deepseek-chat', 'high'), {});
  });
 
+ test('Volcengine Ark sends its official thinking object and optional reasoning effort', () => {
+ const modelId = 'doubao-seed-2-0-pro-260215';
+ assert.deepEqual([...thinkingVariantsForModel('volcengine-ark', modelId)], ['off', 'minimal', 'low', 'medium', 'high']);
+ assert.deepEqual(buildProviderOptions(conn('volcengine-ark'), modelId), {
+ 'volcengine-ark': { thinking: { type: 'enabled' } },
+ });
+ assert.deepEqual(buildProviderOptions(conn('volcengine-ark'), modelId, 'high'), {
+ 'volcengine-ark': { thinking: { type: 'enabled' }, reasoningEffort: 'high' },
+ });
+ assert.deepEqual(buildProviderOptions(conn('volcengine-ark'), modelId, 'off'), {
+ 'volcengine-ark': { thinking: { type: 'disabled' } },
+ });
+ });
+
  test('a level the model does not support is dropped (defensive)', () => {
  assert.deepEqual(buildProviderOptions(conn('openai'), 'gpt-4o', 'high'), { openai: {} });
  assert.deepEqual(buildProviderOptions(conn('anthropic'), 'claude-haiku-4-5', 'max'), { anthropic: {} });
@@ -115,6 +129,7 @@ describe('buildProviderOptions: resolver/options drift guard', () => {
  { providerType: 'google', model: 'gemini-3.5-flash' },
  { providerType: 'deepseek', model: 'deepseek-v4-flash' },
  { providerType: 'zai-coding-plan', model: 'glm-5.2', slug: 'zai-coding-plan' },
+ { providerType: 'volcengine-ark', model: 'doubao-seed-2-0-pro-260215' },
  ];
  for (const { providerType, model, slug } of cases) {
  test(`every effort level for ${providerType}/${model} maps to a non-empty fragment`, () => {

apps/desktop/e2e/providers.spec.ts

@@ -330,6 +330,36 @@ for (const stepfun of [
  await expect(page.getByRole('textbox', { name: '模型密钥' })).toBeVisible();
 });
 
+test('adds Volcengine Ark China with its exact snapshot model, API-key field, and shared official mark', async ({ window: page }) => {
+ await page.getByRole('button', { name: '展开侧边栏' }).click();
+ await page.getByRole('button', { name: '设置' }).click();
+ await page.locator('[aria-label="设置分组"]').getByText('模型', { exact: true }).click();
+ await page.getByRole('button', { name: '添加服务商' }).click();
+
+ await page.getByRole('tab', { name: 'API', exact: true }).click();
+ await page.getByPlaceholder('搜索服务商').fill('Volcengine');
+ const catalogMark = page.locator(
+ '.providerCatalogRow[data-provider="volcengine-ark"] .providerLogo .providerAssetMask',
+ );
+ await expect(catalogMark).toBeVisible();
+ expect(await catalogMark.evaluate(maskRenderContract)).toEqual({ usesAssetMask: true, followsForeground: true });
+ await page.getByRole('button', { name: /添加模型供应商：Volcengine Ark \(China\)/ }).click();
+
+ await expect(page.getByLabel('模型供应商连接标识')).toHaveValue('volcengine-ark');
+ await expect(page.getByLabel('模型供应商服务地址')).toHaveValue('https://ark.cn-beijing.volces.com/api/v3');
+ await expect(page.getByLabel('模型供应商默认模型')).toHaveValue('doubao-seed-2-0-pro-260215');
+ await page.getByRole('button', { name: '保存供应商' }).click();
+
+ await expect(page.getByRole('heading', { name: 'Volcengine Ark (China)', exact: true }).first()).toBeVisible();
+ const detailMark = page.locator(
+ '.providerSubpageHeader .providerLogo[data-provider="volcengine-ark"] .providerAssetMask',
+ );
+ await expect(detailMark).toBeVisible();
+ expect(await detailMark.evaluate(maskRenderContract)).toEqual({ usesAssetMask: true, followsForeground: true });
+ await expect(page.getByText('doubao-seed-2-0-pro-260215', { exact: true }).first()).toBeVisible();
+ await expect(page.getByRole('textbox', { name: '模型密钥' })).toBeVisible();
+});
+
 test('restores keyboard focus across provider child pages', async ({ window: page }) => {
  await page.getByRole('button', { name: '展开侧边栏' }).click();
  await page.getByRole('button', { name: '设置' }).click();

apps/desktop/src/main/__tests__/icon-governance-contract.test.ts

@@ -46,6 +46,7 @@ const NVIDIA_BRAND_MARK_FILE = resolve(REPO_ROOT, 'apps/desktop/src/renderer/ass
 const TENCENT_HUNYUAN_BRAND_MARK_FILE = resolve(REPO_ROOT, 'apps/desktop/src/renderer/assets/provider-brands/hunyuan.svg');
 const TENCENT_CLOUD_BRAND_MARK_FILE = resolve(REPO_ROOT, 'apps/desktop/src/renderer/assets/provider-brands/tencentcloud.svg');
 const STEPFUN_BRAND_MARK_FILE = resolve(REPO_ROOT, 'apps/desktop/src/renderer/assets/provider-brands/stepfun.svg');
+const VOLCENGINE_BRAND_MARK_FILE = resolve(REPO_ROOT, 'apps/desktop/src/renderer/assets/provider-brands/volcengine.svg');
 const DESKTOP_PACKAGE_FILE = resolve(REPO_ROOT, 'apps/desktop/package.json');
 const THIRD_PARTY_NOTICES_FILE = resolve(REPO_ROOT, 'apps/desktop/src/renderer/public/THIRD_PARTY_LICENSES.txt');
 const ONBOARDING_HERO_FILE = resolve(REPO_ROOT, 'apps/desktop/src/renderer/OnboardingHero.tsx');
@@ -430,6 +431,31 @@ describe('icon + typography governance contract', () => {
  assert.match(componentSrc, /case 'stepfun':\s*return <ProviderAssetMask src=\{stepfunBrandMark\} \/>/);
  });
 
+ it('vendors and routes the byte-exact upstream Volcengine mark through the shared asset-mask seam', async () => {
+ const [volcengineMark, componentSrc, notices] = await Promise.all([
+ readFile(VOLCENGINE_BRAND_MARK_FILE),
+ readFile(PROVIDER_BRAND_MARKS_FILE, 'utf8'),
+ readFile(THIRD_PARTY_NOTICES_FILE, 'utf8'),
+ ]);
+
+ assert.equal(
+ createHash('sha256').update(volcengineMark).digest('hex'),
+ 'f29d0bdc284b33d8664ef221add7fbf06a5b370ef92767fa33f6020c914d3d33',
+ 'the vendored Volcengine mark must remain byte-identical to @lobehub/icons-static-svg@1.91.0 volcengine.svg',
+ );
+ assert.match(
+ notices,
+ /apps\/desktop\/src\/renderer\/assets\/provider-brands\/volcengine\.svg[\s\S]*e4302041fbb3039608d25f9f618bd462783b875e[\s\S]*packages\/static-svg\/icons\/volcengine\.svg[\s\S]*f29d0bdc284b33d8664ef221add7fbf06a5b370ef92767fa33f6020c914d3d33/,
+ 'Volcengine must append byte-exact provenance to the existing Lobe Icons notice entry',
+ );
+ assert.match(componentSrc, /import volcengineBrandMark from '\.\.\/assets\/provider-brands\/volcengine\.svg';/);
+ assert.match(
+ componentSrc,
+ /Volcengine mark vendored byte-for-byte from Lobe Icons:[\s\S]*@lobehub\/icons-static-svg@1\.91\.0[\s\S]*e4302041fbb3039608d25f9f618bd462783b875e[\s\S]*packages\/static-svg\/icons\/volcengine\.svg[\s\S]*MIT[\s\S]*f29d0bdc284b33d8664ef221add7fbf06a5b370ef92767fa33f6020c914d3d33/,
+ );
+ assert.match(componentSrc, /case 'volcengine-ark':\s*return <ProviderAssetMask src=\{volcengineBrandMark\} \/>/);
+ });
+
  it('vendors and routes the byte-exact Tencent Cloud mark for Tencent Coding Plan', async () => {
  const [tencentCloudMark, componentSrc, notices] = await Promise.all([
  readFile(TENCENT_CLOUD_BRAND_MARK_FILE),

apps/desktop/src/renderer/public/THIRD_PARTY_LICENSES.txt

@@ -53,6 +53,10 @@ This file records notices for third-party source assets vendored into the Maka d
  - Upstream commit: `e4302041fbb3039608d25f9f618bd462783b875e`
  - Upstream path: `packages/static-svg/icons/stepfun.svg`
  - SHA-256: `f46fbd1eee00a3dc7874395484bcc3e25a803e9eb4b79f07b7eec377a1e2f25c`
+ - `apps/desktop/src/renderer/assets/provider-brands/volcengine.svg`
+ - Upstream commit: `e4302041fbb3039608d25f9f618bd462783b875e`
+ - Upstream path: `packages/static-svg/icons/volcengine.svg`
+ - SHA-256: `f29d0bdc284b33d8664ef221add7fbf06a5b370ef92767fa33f6020c914d3d33`
 
 MIT License
 

apps/desktop/src/renderer/settings/provider-brand-marks.tsx

@@ -25,6 +25,7 @@ import mistralBrandMark from '../assets/provider-brands/mistral.svg';
 import togetherBrandMark from '../assets/provider-brands/together.svg';
 import nvidiaMarkUrl from '../assets/provider-brands/nvidia.svg';
 import stepfunBrandMark from '../assets/provider-brands/stepfun.svg';
+import volcengineBrandMark from '../assets/provider-brands/volcengine.svg';
 import xaiMarkUrl from '../assets/provider-brands/xai.svg';
 
 // Real xAI/Grok mark vendored byte-for-byte from Lobe Icons:
@@ -92,6 +93,14 @@ function XAI(): ReactElement {
 // - license: MIT (repository LICENSE)
 // - SHA-256: f46fbd1eee00a3dc7874395484bcc3e25a803e9eb4b79f07b7eec377a1e2f25c
 
+// Volcengine mark vendored byte-for-byte from Lobe Icons:
+// - repository: https://github.com/lobehub/lobe-icons
+// - package/version: @lobehub/icons-static-svg@1.91.0
+// - commit: e4302041fbb3039608d25f9f618bd462783b875e
+// - path: packages/static-svg/icons/volcengine.svg
+// - license: MIT (repository LICENSE)
+// - SHA-256: f29d0bdc284b33d8664ef221add7fbf06a5b370ef92767fa33f6020c914d3d33
+
 function ProviderAssetMask({ src }: { src: string }): ReactElement {
  const mask = `url("${src}")`;
  return <span className="providerAssetMask" style={{ maskImage: mask, WebkitMaskImage: mask }} aria-hidden="true" />;
@@ -278,6 +287,8 @@ export function ProviderBrandMark({ type }: { type: ProviderType }): ReactElemen
  case 'stepfun-ai':
  case 'stepfun':
  return <ProviderAssetMask src={stepfunBrandMark} />;
+ case 'volcengine-ark':
+ return <ProviderAssetMask src={volcengineBrandMark} />;
  default:
  return <GenericProviderMark />;
  }

packages/cli/src/__tests__/connection-target.test.ts

@@ -4,6 +4,30 @@ import type { LlmConnection } from '@maka/core/llm-connections';
 import { listReadyModelChoices, resolveDefaultSessionTarget } from '../connection-target.js';
 
 describe('default session target resolver', () => {
+ test('resolves Volcengine Ark credentials without rewriting the snapshot model id', async () => {
+ const modelId = 'doubao-seed-2-0-pro-260215';
+ const connection = makeConnection({
+ slug: 'volcengine-ark',
+ name: 'Volcengine Ark (China)',
+ providerType: 'volcengine-ark',
+ defaultModel: modelId,
+ });
+
+ const target = await resolveDefaultSessionTarget({
+ connectionStore: {
+ getDefault: async () => 'volcengine-ark',
+ get: async (slug) => slug === 'volcengine-ark' ? connection : null,
+ },
+ credentialStore: {
+ getSecret: async (_slug, kind) => kind === 'api_key' ? 'ark-test-key' : null,
+ },
+ });
+
+ assert.equal(target.connection.providerType, 'volcengine-ark');
+ assert.equal(target.apiKey, 'ark-test-key');
+ assert.equal(target.model, modelId);
+ });
+
  test('resolves Fireworks credentials without rewriting the exact model path', async () => {
  const connection = makeConnection({
  slug: 'fireworks-ai',

packages/core/src/__tests__/llm-connections.test.ts

@@ -48,6 +48,7 @@ describe('provider compatibility contract', () => {
  'tencent-tokenhub',
  'stepfun',
  'stepfun-ai',
+ 'volcengine-ark',
  'ollama',
  'lm-studio',
  'openai-compatible',
@@ -80,6 +81,7 @@ describe('provider compatibility contract', () => {
  'stepfun',
  'tencent-coding-plan',
  'stepfun-ai',
+ 'volcengine-ark',
  ]);
  assert.deepEqual(CATALOG_PROVIDER_TYPES, [
  'kimi-coding-plan',
@@ -106,6 +108,7 @@ describe('provider compatibility contract', () => {
  'stepfun',
  'tencent-coding-plan',
  'stepfun-ai',
+ 'volcengine-ark',
  ]);
 
  for (const orderField of ['readyOrder', 'catalogOrder', 'recommendedOrder'] as const) {
@@ -371,6 +374,23 @@ describe('provider compatibility contract', () => {
  'step-3.5-flash',
  ]);
  });
+
+ it('owns Volcengine Ark China direct API behavior under the stable volcengine-ark id', () => {
+ const ark = (PROVIDER_REGISTRY as Partial<Record<string, (typeof PROVIDER_REGISTRY)[keyof typeof PROVIDER_REGISTRY]>>)['volcengine-ark'];
+
+ assert.ok(ark, 'Volcengine Ark China direct API must have its own persisted provider id');
+ assert.equal(ark.label, 'Volcengine Ark (China)');
+ assert.equal(ark.baseUrl, 'https://ark.cn-beijing.volces.com/api/v3');
+ assert.equal(ark.authKind, 'api_key');
+ assert.equal(ark.protocol, 'openai');
+ assert.deepEqual(ark.runtimeAdapter, { kind: 'openai-compatible', name: 'provider' });
+ assert.deepEqual(ark.modelDiscovery, { kind: 'fallback' });
+ assert.equal(ark.category, 'domestic');
+ assert.equal(ark.catalogGroup, 'api');
+ assert.equal(ark.signupUrl, 'https://console.volcengine.com/ark/region:ark+cn-beijing/model');
+ assert.equal(ark.modelsDevId, undefined);
+ assert.deepEqual(ark.fallbackModels, ['doubao-seed-2-0-pro-260215']);
+ });
 });
 
 describe('validateConnectionBaseUrl (PR-UI-IPC-1, @kenji msg 35260e29)', () => {

packages/core/src/__tests__/model-catalog.test.ts

@@ -34,6 +34,25 @@ describe('ModelCatalogEntry', () => {
  });
  });
 
+ it('uses the official Volcengine Ark snapshot without inventing live model discovery', () => {
+ const entries = buildConnectionModelCatalogEntries({
+ connection: {
+ slug: 'volcengine-ark',
+ providerType: 'volcengine-ark',
+ defaultModel: 'doubao-seed-2-0-pro-260215',
+ },
+ });
+
+ assert.deepEqual(entries.map((entry) => entry.id), ['doubao-seed-2-0-pro-260215']);
+ assert.equal(entries[0]?.displayName, 'Doubao Seed 2.0 Pro');
+ assert.equal(entries[0]?.source, 'static_catalog');
+ assert.equal(entries[0]?.provenance.modelSource, 'fallback');
+ assert.deepEqual(entries[0]?.capabilities, {
+ reasoning: true,
+ functionCalling: true,
+ });
+ });
+
  it('uses the checked-in StepFun China snapshot until account discovery succeeds', () => {
  const entries = buildConnectionModelCatalogEntries({
  connection: {

packages/core/src/__tests__/provider-auth.test.ts

@@ -48,6 +48,19 @@ describe('ProviderAuth contract', () => {
  expect(contract.actionAvailability.fetch_models).toBe('available');
  });
 
+ test('Volcengine Ark China uses the shared API-key credential and snapshot-model flow', () => {
+ const contract = deriveProviderAuthContract({
+ providerType: 'volcengine-ark',
+ hasSecret: true,
+ });
+
+ expect(contract.providerType).toBe('volcengine-ark');
+ expect(contract.setupMode).toBe('api_key');
+ expect(contract.requiresSecret).toBe(true);
+ expect(contract.actionAvailability.test_credentials).toBe('available');
+ expect(contract.actionAvailability.fetch_models).toBe('hidden');
+ });
+
  test('Together AI uses the shared API-key credential flow under its stable provider id', () => {
  const contract = deriveProviderAuthContract({
  providerType: 'togetherai',

packages/core/src/model-metadata.ts

@@ -118,6 +118,19 @@ const STATIC_MODEL_METADATA: Partial<Record<ProviderType, Record<string, ModelMe
  'tencent-coding-plan': {
  'kimi-k2.5': { capabilities: { vision: false } },
  },
+ 'volcengine-ark': {
+ 'doubao-seed-2-0-pro-260215': {
+ displayName: 'Doubao Seed 2.0 Pro',
+ lifecycle: 'active',
+ docsUrl: 'https://www.volcengine.com/docs/82379',
+ capabilities: { reasoning: true, functionCalling: true },
+ thinkingOptions: {
+ efforts: ['minimal', 'low', 'medium', 'high'],
+ toggle: true,
+ offBehavior: 'volcengine-thinking-disabled',
+ },
+ },
+ },
  deepseek: {
  'deepseek-v4-flash': { thinkingOptions: { efforts: ['high', 'max'], toggle: true } },
  },

packages/core/src/model-thinking.ts

@@ -43,7 +43,8 @@ export function isThinkingLevel(value: unknown): value is ThinkingLevel {
  */
 export type ThinkingOffBehavior =
  | 'anthropic-thinking-disabled'
- | 'google-thinking-budget-zero';
+ | 'google-thinking-budget-zero'
+ | 'volcengine-thinking-disabled';
 
 export interface ThinkingOptions {
  readonly efforts?: readonly string[];

packages/core/src/provider-registry.ts

@@ -580,6 +580,24 @@ const providerRegistry = {
  readyOrder: 24,
  catalogOrder: 24,
  },
+ 'volcengine-ark': {
+ label: 'Volcengine Ark (China)',
+ description: 'Volcengine Ark direct API for reasoning and tool-use agents in China.',
+ baseUrl: 'https://ark.cn-beijing.volces.com/api/v3',
+ authKind: 'api_key',
+ backendKind: 'ai-sdk',
+ fallbackModels: ['doubao-seed-2-0-pro-260215'],
+ status: 'ready',
+ protocol: 'openai',
+ runtimeAdapter: { kind: 'openai-compatible', name: 'provider' },
+ modelDiscovery: { kind: 'fallback' },
+ category: 'domestic',
+ catalogGroup: 'api',
+ catalogBadge: 'API',
+ signupUrl: 'https://console.volcengine.com/ark/region:ark+cn-beijing/model',
+ readyOrder: 25,
+ catalogOrder: 25,
+ },
  ollama: {
  label: 'Ollama',
  description: 'Local models from Ollama on localhost.',

packages/headless/src/__tests__/harbor-cell.test.ts

@@ -2362,6 +2362,33 @@ setTimeout(() => {
  assert.equal(missing.apiKey, '');
  });
 
+ test('resolves Volcengine Ark only from its official direct API credential env', () => {
+ const modelId = 'doubao-seed-2-0-pro-260215';
+ const resolved = resolveHarborCellAiSdkEnv({
+ provider: 'volcengine-ark',
+ model: modelId,
+ env: {
+ ARK_API_KEY: 'ark-key',
+ ARK_BASE_URL: 'https://ark.cn-shanghai.volces.com/api/v3',
+ OPENAI_API_KEY: 'openai-key',
+ },
+ ts: 1,
+ });
+
+ assert.equal(resolved.apiKey, 'ark-key');
+ assert.equal(resolved.connection.providerType, 'volcengine-ark');
+ assert.equal(resolved.connection.defaultModel, modelId);
+ assert.equal(resolved.connection.baseUrl, 'https://ark.cn-shanghai.volces.com/api/v3');
+
+ const missing = resolveHarborCellAiSdkEnv({
+ provider: 'volcengine-ark',
+ model: modelId,
+ env: { OPENAI_API_KEY: 'must-not-cross-provider-boundary' },
+ ts: 1,
+ });
+ assert.equal(missing.apiKey, '');
+ });
+
  test('resolves Cerebras only from Cerebras credential env without rewriting the model id', () => {
  const resolved = resolveHarborCellAiSdkEnv({
  provider: 'cerebras',

packages/headless/src/__tests__/provider-env.test.ts

@@ -94,3 +94,11 @@ test('StepFun Global keeps direct API credentials separate from China and plan i
  baseUrls: ['STEPFUN_AI_BASE_URL'],
  });
 });
+
+test('Volcengine Ark direct API uses its official credential namespace', () => {
+ assert.deepEqual(providerCredentialEnv('volcengine-ark'), {
+ apiKeys: ['ARK_API_KEY'],
+ apiKeyFile: 'ARK_API_KEY_FILE',
+ baseUrls: ['ARK_BASE_URL'],
+ });
+});

packages/headless/src/provider-env.ts

@@ -27,6 +27,7 @@ const PROVIDER_CREDENTIAL_ENV = {
  'tencent-tokenhub': env('TENCENT_TOKENHUB', ['TENCENT_TOKENHUB_BASE_URL']),
  stepfun: env('STEPFUN', ['STEPFUN_BASE_URL']),
  'stepfun-ai': env('STEPFUN_AI', ['STEPFUN_AI_BASE_URL']),
+ 'volcengine-ark': env('ARK', ['ARK_BASE_URL']),
  'openai-compatible': env('OPENAI', ['OPENAI_BASE_URL']),
  'claude-subscription': env('ANTHROPIC'),
 } satisfies Partial<Record<ProviderType, ProviderCredentialEnv>>;

packages/runtime/src/__tests__/model-factory-thinking.test.ts

@@ -71,6 +71,20 @@ describe('buildProviderOptions: thinking level', () => {
  assert.deepEqual(buildProviderOptions(conn('deepseek'), 'deepseek-chat', 'high'), {});
  });
 
+ test('Volcengine Ark sends its official thinking object and optional reasoning effort', () => {
+ const modelId = 'doubao-seed-2-0-pro-260215';
+ assert.deepEqual([...thinkingVariantsForModel('volcengine-ark', modelId)], ['off', 'minimal', 'low', 'medium', 'high']);
+ assert.deepEqual(buildProviderOptions(conn('volcengine-ark'), modelId), {
+ 'volcengine-ark': { thinking: { type: 'enabled' } },
+ });
+ assert.deepEqual(buildProviderOptions(conn('volcengine-ark'), modelId, 'high'), {
+ 'volcengine-ark': { thinking: { type: 'enabled' }, reasoningEffort: 'high' },
+ });
+ assert.deepEqual(buildProviderOptions(conn('volcengine-ark'), modelId, 'off'), {
+ 'volcengine-ark': { thinking: { type: 'disabled' } },
+ });
+ });
+
  test('a level the model does not support is dropped (defensive)', () => {
  assert.deepEqual(buildProviderOptions(conn('openai'), 'gpt-4o', 'high'), { openai: {} });
  assert.deepEqual(buildProviderOptions(conn('anthropic'), 'claude-haiku-4-5', 'max'), { anthropic: {} });
@@ -115,6 +129,7 @@ describe('buildProviderOptions: resolver/options drift guard', () => {
  { providerType: 'google', model: 'gemini-3.5-flash' },
  { providerType: 'deepseek', model: 'deepseek-v4-flash' },
  { providerType: 'zai-coding-plan', model: 'glm-5.2', slug: 'zai-coding-plan' },
+ { providerType: 'volcengine-ark', model: 'doubao-seed-2-0-pro-260215' },
  ];
  for (const { providerType, model, slug } of cases) {
  test(`every effort level for ${providerType}/${model} maps to a non-empty fragment`, () => {

apps/desktop/e2e/providers.spec.ts

@@ -330,6 +330,36 @@ for (const stepfun of [
  await expect(page.getByRole('textbox', { name: '模型密钥' })).toBeVisible();
 });
 
+test('adds Volcengine Ark China with its exact snapshot model, API-key field, and shared official mark', async ({ window: page }) => {
+ await page.getByRole('button', { name: '展开侧边栏' }).click();
+ await page.getByRole('button', { name: '设置' }).click();
+ await page.locator('[aria-label="设置分组"]').getByText('模型', { exact: true }).click();
+ await page.getByRole('button', { name: '添加服务商' }).click();
+
+ await page.getByRole('tab', { name: 'API', exact: true }).click();
+ await page.getByPlaceholder('搜索服务商').fill('Volcengine');
+ const catalogMark = page.locator(
+ '.providerCatalogRow[data-provider="volcengine-ark"] .providerLogo .providerAssetMask',
+ );
+ await expect(catalogMark).toBeVisible();
+ expect(await catalogMark.evaluate(maskRenderContract)).toEqual({ usesAssetMask: true, followsForeground: true });
+ await page.getByRole('button', { name: /添加模型供应商：Volcengine Ark \(China\)/ }).click();
+
+ await expect(page.getByLabel('模型供应商连接标识')).toHaveValue('volcengine-ark');
+ await expect(page.getByLabel('模型供应商服务地址')).toHaveValue('https://ark.cn-beijing.volces.com/api/v3');
+ await expect(page.getByLabel('模型供应商默认模型')).toHaveValue('doubao-seed-2-0-pro-260215');
+ await page.getByRole('button', { name: '保存供应商' }).click();
+
+ await expect(page.getByRole('heading', { name: 'Volcengine Ark (China)', exact: true }).first()).toBeVisible();
+ const detailMark = page.locator(
+ '.providerSubpageHeader .providerLogo[data-provider="volcengine-ark"] .providerAssetMask',
+ );
+ await expect(detailMark).toBeVisible();
+ expect(await detailMark.evaluate(maskRenderContract)).toEqual({ usesAssetMask: true, followsForeground: true });
+ await expect(page.getByText('doubao-seed-2-0-pro-260215', { exact: true }).first()).toBeVisible();
+ await expect(page.getByRole('textbox', { name: '模型密钥' })).toBeVisible();
+});
+
 test('restores keyboard focus across provider child pages', async ({ window: page }) => {
  await page.getByRole('button', { name: '展开侧边栏' }).click();
  await page.getByRole('button', { name: '设置' }).click();

apps/desktop/src/main/__tests__/icon-governance-contract.test.ts

@@ -46,6 +46,7 @@ const NVIDIA_BRAND_MARK_FILE = resolve(REPO_ROOT, 'apps/desktop/src/renderer/ass
 const TENCENT_HUNYUAN_BRAND_MARK_FILE = resolve(REPO_ROOT, 'apps/desktop/src/renderer/assets/provider-brands/hunyuan.svg');
 const TENCENT_CLOUD_BRAND_MARK_FILE = resolve(REPO_ROOT, 'apps/desktop/src/renderer/assets/provider-brands/tencentcloud.svg');
 const STEPFUN_BRAND_MARK_FILE = resolve(REPO_ROOT, 'apps/desktop/src/renderer/assets/provider-brands/stepfun.svg');
+const VOLCENGINE_BRAND_MARK_FILE = resolve(REPO_ROOT, 'apps/desktop/src/renderer/assets/provider-brands/volcengine.svg');
 const DESKTOP_PACKAGE_FILE = resolve(REPO_ROOT, 'apps/desktop/package.json');
 const THIRD_PARTY_NOTICES_FILE = resolve(REPO_ROOT, 'apps/desktop/src/renderer/public/THIRD_PARTY_LICENSES.txt');
 const ONBOARDING_HERO_FILE = resolve(REPO_ROOT, 'apps/desktop/src/renderer/OnboardingHero.tsx');
@@ -430,6 +431,31 @@ describe('icon + typography governance contract', () => {
  assert.match(componentSrc, /case 'stepfun':\s*return <ProviderAssetMask src=\{stepfunBrandMark\} \/>/);
  });
 
+ it('vendors and routes the byte-exact upstream Volcengine mark through the shared asset-mask seam', async () => {
+ const [volcengineMark, componentSrc, notices] = await Promise.all([
+ readFile(VOLCENGINE_BRAND_MARK_FILE),
+ readFile(PROVIDER_BRAND_MARKS_FILE, 'utf8'),
+ readFile(THIRD_PARTY_NOTICES_FILE, 'utf8'),
+ ]);
+
+ assert.equal(
+ createHash('sha256').update(volcengineMark).digest('hex'),
+ 'f29d0bdc284b33d8664ef221add7fbf06a5b370ef92767fa33f6020c914d3d33',
+ 'the vendored Volcengine mark must remain byte-identical to @lobehub/icons-static-svg@1.91.0 volcengine.svg',
+ );
+ assert.match(
+ notices,
+ /apps\/desktop\/src\/renderer\/assets\/provider-brands\/volcengine\.svg[\s\S]*e4302041fbb3039608d25f9f618bd462783b875e[\s\S]*packages\/static-svg\/icons\/volcengine\.svg[\s\S]*f29d0bdc284b33d8664ef221add7fbf06a5b370ef92767fa33f6020c914d3d33/,
+ 'Volcengine must append byte-exact provenance to the existing Lobe Icons notice entry',
+ );
+ assert.match(componentSrc, /import volcengineBrandMark from '\.\.\/assets\/provider-brands\/volcengine\.svg';/);
+ assert.match(
+ componentSrc,
+ /Volcengine mark vendored byte-for-byte from Lobe Icons:[\s\S]*@lobehub\/icons-static-svg@1\.91\.0[\s\S]*e4302041fbb3039608d25f9f618bd462783b875e[\s\S]*packages\/static-svg\/icons\/volcengine\.svg[\s\S]*MIT[\s\S]*f29d0bdc284b33d8664ef221add7fbf06a5b370ef92767fa33f6020c914d3d33/,
+ );
+ assert.match(componentSrc, /case 'volcengine-ark':\s*return <ProviderAssetMask src=\{volcengineBrandMark\} \/>/);
+ });
+
  it('vendors and routes the byte-exact Tencent Cloud mark for Tencent Coding Plan', async () => {
  const [tencentCloudMark, componentSrc, notices] = await Promise.all([
  readFile(TENCENT_CLOUD_BRAND_MARK_FILE),

apps/desktop/src/renderer/public/THIRD_PARTY_LICENSES.txt

@@ -53,6 +53,10 @@ This file records notices for third-party source assets vendored into the Maka d
  - Upstream commit: `e4302041fbb3039608d25f9f618bd462783b875e`
  - Upstream path: `packages/static-svg/icons/stepfun.svg`
  - SHA-256: `f46fbd1eee00a3dc7874395484bcc3e25a803e9eb4b79f07b7eec377a1e2f25c`
+ - `apps/desktop/src/renderer/assets/provider-brands/volcengine.svg`
+ - Upstream commit: `e4302041fbb3039608d25f9f618bd462783b875e`
+ - Upstream path: `packages/static-svg/icons/volcengine.svg`
+ - SHA-256: `f29d0bdc284b33d8664ef221add7fbf06a5b370ef92767fa33f6020c914d3d33`
 
 MIT License
 

apps/desktop/src/renderer/settings/provider-brand-marks.tsx

@@ -25,6 +25,7 @@ import mistralBrandMark from '../assets/provider-brands/mistral.svg';
 import togetherBrandMark from '../assets/provider-brands/together.svg';
 import nvidiaMarkUrl from '../assets/provider-brands/nvidia.svg';
 import stepfunBrandMark from '../assets/provider-brands/stepfun.svg';
+import volcengineBrandMark from '../assets/provider-brands/volcengine.svg';
 import xaiMarkUrl from '../assets/provider-brands/xai.svg';
 
 // Real xAI/Grok mark vendored byte-for-byte from Lobe Icons:
@@ -92,6 +93,14 @@ function XAI(): ReactElement {
 // - license: MIT (repository LICENSE)
 // - SHA-256: f46fbd1eee00a3dc7874395484bcc3e25a803e9eb4b79f07b7eec377a1e2f25c
 
+// Volcengine mark vendored byte-for-byte from Lobe Icons:
+// - repository: https://github.com/lobehub/lobe-icons
+// - package/version: @lobehub/icons-static-svg@1.91.0
+// - commit: e4302041fbb3039608d25f9f618bd462783b875e
+// - path: packages/static-svg/icons/volcengine.svg
+// - license: MIT (repository LICENSE)
+// - SHA-256: f29d0bdc284b33d8664ef221add7fbf06a5b370ef92767fa33f6020c914d3d33
+
 function ProviderAssetMask({ src }: { src: string }): ReactElement {
  const mask = `url("${src}")`;
  return <span className="providerAssetMask" style={{ maskImage: mask, WebkitMaskImage: mask }} aria-hidden="true" />;
@@ -278,6 +287,8 @@ export function ProviderBrandMark({ type }: { type: ProviderType }): ReactElemen
  case 'stepfun-ai':
  case 'stepfun':
  return <ProviderAssetMask src={stepfunBrandMark} />;
+ case 'volcengine-ark':
+ return <ProviderAssetMask src={volcengineBrandMark} />;
  default:
  return <GenericProviderMark />;
  }

packages/cli/src/__tests__/connection-target.test.ts

@@ -4,6 +4,30 @@ import type { LlmConnection } from '@maka/core/llm-connections';
 import { listReadyModelChoices, resolveDefaultSessionTarget } from '../connection-target.js';
 
 describe('default session target resolver', () => {
+ test('resolves Volcengine Ark credentials without rewriting the snapshot model id', async () => {
+ const modelId = 'doubao-seed-2-0-pro-260215';
+ const connection = makeConnection({
+ slug: 'volcengine-ark',
+ name: 'Volcengine Ark (China)',
+ providerType: 'volcengine-ark',
+ defaultModel: modelId,
+ });
+
+ const target = await resolveDefaultSessionTarget({
+ connectionStore: {
+ getDefault: async () => 'volcengine-ark',
+ get: async (slug) => slug === 'volcengine-ark' ? connection : null,
+ },
+ credentialStore: {
+ getSecret: async (_slug, kind) => kind === 'api_key' ? 'ark-test-key' : null,
+ },
+ });
+
+ assert.equal(target.connection.providerType, 'volcengine-ark');
+ assert.equal(target.apiKey, 'ark-test-key');
+ assert.equal(target.model, modelId);
+ });
+
  test('resolves Fireworks credentials without rewriting the exact model path', async () => {
  const connection = makeConnection({
  slug: 'fireworks-ai',

packages/core/src/__tests__/llm-connections.test.ts

@@ -48,6 +48,7 @@ describe('provider compatibility contract', () => {
  'tencent-tokenhub',
  'stepfun',
  'stepfun-ai',
+ 'volcengine-ark',
  'ollama',
  'lm-studio',
  'openai-compatible',
@@ -80,6 +81,7 @@ describe('provider compatibility contract', () => {
  'stepfun',
  'tencent-coding-plan',
  'stepfun-ai',
+ 'volcengine-ark',
  ]);
  assert.deepEqual(CATALOG_PROVIDER_TYPES, [
  'kimi-coding-plan',
@@ -106,6 +108,7 @@ describe('provider compatibility contract', () => {
  'stepfun',
  'tencent-coding-plan',
  'stepfun-ai',
+ 'volcengine-ark',
  ]);
 
  for (const orderField of ['readyOrder', 'catalogOrder', 'recommendedOrder'] as const) {
@@ -371,6 +374,23 @@ describe('provider compatibility contract', () => {
  'step-3.5-flash',
  ]);
  });
+
+ it('owns Volcengine Ark China direct API behavior under the stable volcengine-ark id', () => {
+ const ark = (PROVIDER_REGISTRY as Partial<Record<string, (typeof PROVIDER_REGISTRY)[keyof typeof PROVIDER_REGISTRY]>>)['volcengine-ark'];
+
+ assert.ok(ark, 'Volcengine Ark China direct API must have its own persisted provider id');
+ assert.equal(ark.label, 'Volcengine Ark (China)');
+ assert.equal(ark.baseUrl, 'https://ark.cn-beijing.volces.com/api/v3');
+ assert.equal(ark.authKind, 'api_key');
+ assert.equal(ark.protocol, 'openai');
+ assert.deepEqual(ark.runtimeAdapter, { kind: 'openai-compatible', name: 'provider' });
+ assert.deepEqual(ark.modelDiscovery, { kind: 'fallback' });
+ assert.equal(ark.category, 'domestic');
+ assert.equal(ark.catalogGroup, 'api');
+ assert.equal(ark.signupUrl, 'https://console.volcengine.com/ark/region:ark+cn-beijing/model');
+ assert.equal(ark.modelsDevId, undefined);
+ assert.deepEqual(ark.fallbackModels, ['doubao-seed-2-0-pro-260215']);
+ });
 });
 
 describe('validateConnectionBaseUrl (PR-UI-IPC-1, @kenji msg 35260e29)', () => {

packages/core/src/__tests__/model-catalog.test.ts

@@ -34,6 +34,25 @@ describe('ModelCatalogEntry', () => {
  });
  });
 
+ it('uses the official Volcengine Ark snapshot without inventing live model discovery', () => {
+ const entries = buildConnectionModelCatalogEntries({
+ connection: {
+ slug: 'volcengine-ark',
+ providerType: 'volcengine-ark',
+ defaultModel: 'doubao-seed-2-0-pro-260215',
+ },
+ });
+
+ assert.deepEqual(entries.map((entry) => entry.id), ['doubao-seed-2-0-pro-260215']);
+ assert.equal(entries[0]?.displayName, 'Doubao Seed 2.0 Pro');
+ assert.equal(entries[0]?.source, 'static_catalog');
+ assert.equal(entries[0]?.provenance.modelSource, 'fallback');
+ assert.deepEqual(entries[0]?.capabilities, {
+ reasoning: true,
+ functionCalling: true,
+ });
+ });
+
  it('uses the checked-in StepFun China snapshot until account discovery succeeds', () => {
  const entries = buildConnectionModelCatalogEntries({
  connection: {

packages/core/src/__tests__/provider-auth.test.ts

@@ -48,6 +48,19 @@ describe('ProviderAuth contract', () => {
  expect(contract.actionAvailability.fetch_models).toBe('available');
  });
 
+ test('Volcengine Ark China uses the shared API-key credential and snapshot-model flow', () => {
+ const contract = deriveProviderAuthContract({
+ providerType: 'volcengine-ark',
+ hasSecret: true,
+ });
+
+ expect(contract.providerType).toBe('volcengine-ark');
+ expect(contract.setupMode).toBe('api_key');
+ expect(contract.requiresSecret).toBe(true);
+ expect(contract.actionAvailability.test_credentials).toBe('available');
+ expect(contract.actionAvailability.fetch_models).toBe('hidden');
+ });
+
  test('Together AI uses the shared API-key credential flow under its stable provider id', () => {
  const contract = deriveProviderAuthContract({
  providerType: 'togetherai',

packages/core/src/model-metadata.ts

@@ -118,6 +118,19 @@ const STATIC_MODEL_METADATA: Partial<Record<ProviderType, Record<string, ModelMe
  'tencent-coding-plan': {
  'kimi-k2.5': { capabilities: { vision: false } },
  },
+ 'volcengine-ark': {
+ 'doubao-seed-2-0-pro-260215': {
+ displayName: 'Doubao Seed 2.0 Pro',
+ lifecycle: 'active',
+ docsUrl: 'https://www.volcengine.com/docs/82379',
+ capabilities: { reasoning: true, functionCalling: true },
+ thinkingOptions: {
+ efforts: ['minimal', 'low', 'medium', 'high'],
+ toggle: true,
+ offBehavior: 'volcengine-thinking-disabled',
+ },
+ },
+ },
  deepseek: {
  'deepseek-v4-flash': { thinkingOptions: { efforts: ['high', 'max'], toggle: true } },
  },

packages/core/src/model-thinking.ts

@@ -43,7 +43,8 @@ export function isThinkingLevel(value: unknown): value is ThinkingLevel {
  */
 export type ThinkingOffBehavior =
  | 'anthropic-thinking-disabled'
- | 'google-thinking-budget-zero';
+ | 'google-thinking-budget-zero'
+ | 'volcengine-thinking-disabled';
 
 export interface ThinkingOptions {
  readonly efforts?: readonly string[];

packages/core/src/provider-registry.ts

@@ -580,6 +580,24 @@ const providerRegistry = {
  readyOrder: 24,
  catalogOrder: 24,
  },
+ 'volcengine-ark': {
+ label: 'Volcengine Ark (China)',
+ description: 'Volcengine Ark direct API for reasoning and tool-use agents in China.',
+ baseUrl: 'https://ark.cn-beijing.volces.com/api/v3',
+ authKind: 'api_key',
+ backendKind: 'ai-sdk',
+ fallbackModels: ['doubao-seed-2-0-pro-260215'],
+ status: 'ready',
+ protocol: 'openai',
+ runtimeAdapter: { kind: 'openai-compatible', name: 'provider' },
+ modelDiscovery: { kind: 'fallback' },
+ category: 'domestic',
+ catalogGroup: 'api',
+ catalogBadge: 'API',
+ signupUrl: 'https://console.volcengine.com/ark/region:ark+cn-beijing/model',
+ readyOrder: 25,
+ catalogOrder: 25,
+ },
  ollama: {
  label: 'Ollama',
  description: 'Local models from Ollama on localhost.',

packages/headless/src/__tests__/harbor-cell.test.ts

@@ -2362,6 +2362,33 @@ setTimeout(() => {
  assert.equal(missing.apiKey, '');
  });
 
+ test('resolves Volcengine Ark only from its official direct API credential env', () => {
+ const modelId = 'doubao-seed-2-0-pro-260215';
+ const resolved = resolveHarborCellAiSdkEnv({
+ provider: 'volcengine-ark',
+ model: modelId,
+ env: {
+ ARK_API_KEY: 'ark-key',
+ ARK_BASE_URL: 'https://ark.cn-shanghai.volces.com/api/v3',
+ OPENAI_API_KEY: 'openai-key',
+ },
+ ts: 1,
+ });
+
+ assert.equal(resolved.apiKey, 'ark-key');
+ assert.equal(resolved.connection.providerType, 'volcengine-ark');
+ assert.equal(resolved.connection.defaultModel, modelId);
+ assert.equal(resolved.connection.baseUrl, 'https://ark.cn-shanghai.volces.com/api/v3');
+
+ const missing = resolveHarborCellAiSdkEnv({
+ provider: 'volcengine-ark',
+ model: modelId,
+ env: { OPENAI_API_KEY: 'must-not-cross-provider-boundary' },
+ ts: 1,
+ });
+ assert.equal(missing.apiKey, '');
+ });
+
  test('resolves Cerebras only from Cerebras credential env without rewriting the model id', () => {
  const resolved = resolveHarborCellAiSdkEnv({
  provider: 'cerebras',

packages/headless/src/__tests__/provider-env.test.ts

@@ -94,3 +94,11 @@ test('StepFun Global keeps direct API credentials separate from China and plan i
  baseUrls: ['STEPFUN_AI_BASE_URL'],
  });
 });
+
+test('Volcengine Ark direct API uses its official credential namespace', () => {
+ assert.deepEqual(providerCredentialEnv('volcengine-ark'), {
+ apiKeys: ['ARK_API_KEY'],
+ apiKeyFile: 'ARK_API_KEY_FILE',
+ baseUrls: ['ARK_BASE_URL'],
+ });
+});

packages/headless/src/provider-env.ts

@@ -27,6 +27,7 @@ const PROVIDER_CREDENTIAL_ENV = {
  'tencent-tokenhub': env('TENCENT_TOKENHUB', ['TENCENT_TOKENHUB_BASE_URL']),
  stepfun: env('STEPFUN', ['STEPFUN_BASE_URL']),
  'stepfun-ai': env('STEPFUN_AI', ['STEPFUN_AI_BASE_URL']),
+ 'volcengine-ark': env('ARK', ['ARK_BASE_URL']),
  'openai-compatible': env('OPENAI', ['OPENAI_BASE_URL']),
  'claude-subscription': env('ANTHROPIC'),
 } satisfies Partial<Record<ProviderType, ProviderCredentialEnv>>;

packages/runtime/src/__tests__/model-factory-thinking.test.ts

@@ -71,6 +71,20 @@ describe('buildProviderOptions: thinking level', () => {
  assert.deepEqual(buildProviderOptions(conn('deepseek'), 'deepseek-chat', 'high'), {});
  });
 
+ test('Volcengine Ark sends its official thinking object and optional reasoning effort', () => {
+ const modelId = 'doubao-seed-2-0-pro-260215';
+ assert.deepEqual([...thinkingVariantsForModel('volcengine-ark', modelId)], ['off', 'minimal', 'low', 'medium', 'high']);
+ assert.deepEqual(buildProviderOptions(conn('volcengine-ark'), modelId), {
+ 'volcengine-ark': { thinking: { type: 'enabled' } },
+ });
+ assert.deepEqual(buildProviderOptions(conn('volcengine-ark'), modelId, 'high'), {
+ 'volcengine-ark': { thinking: { type: 'enabled' }, reasoningEffort: 'high' },
+ });
+ assert.deepEqual(buildProviderOptions(conn('volcengine-ark'), modelId, 'off'), {
+ 'volcengine-ark': { thinking: { type: 'disabled' } },
+ });
+ });
+
  test('a level the model does not support is dropped (defensive)', () => {
  assert.deepEqual(buildProviderOptions(conn('openai'), 'gpt-4o', 'high'), { openai: {} });
  assert.deepEqual(buildProviderOptions(conn('anthropic'), 'claude-haiku-4-5', 'max'), { anthropic: {} });
@@ -115,6 +129,7 @@ describe('buildProviderOptions: resolver/options drift guard', () => {
  { providerType: 'google', model: 'gemini-3.5-flash' },
  { providerType: 'deepseek', model: 'deepseek-v4-flash' },
  { providerType: 'zai-coding-plan', model: 'glm-5.2', slug: 'zai-coding-plan' },
+ { providerType: 'volcengine-ark', model: 'doubao-seed-2-0-pro-260215' },
  ];
  for (const { providerType, model, slug } of cases) {
  test(`every effort level for ${providerType}/${model} maps to a non-empty fragment`, () => {

apps/desktop/e2e/providers.spec.ts

@@ -330,6 +330,36 @@ for (const stepfun of [
  await expect(page.getByRole('textbox', { name: '模型密钥' })).toBeVisible();
 });
 
+test('adds Volcengine Ark China with its exact snapshot model, API-key field, and shared official mark', async ({ window: page }) => {
+ await page.getByRole('button', { name: '展开侧边栏' }).click();
+ await page.getByRole('button', { name: '设置' }).click();
+ await page.locator('[aria-label="设置分组"]').getByText('模型', { exact: true }).click();
+ await page.getByRole('button', { name: '添加服务商' }).click();
+
+ await page.getByRole('tab', { name: 'API', exact: true }).click();
+ await page.getByPlaceholder('搜索服务商').fill('Volcengine');
+ const catalogMark = page.locator(
+ '.providerCatalogRow[data-provider="volcengine-ark"] .providerLogo .providerAssetMask',
+ );
+ await expect(catalogMark).toBeVisible();
+ expect(await catalogMark.evaluate(maskRenderContract)).toEqual({ usesAssetMask: true, followsForeground: true });
+ await page.getByRole('button', { name: /添加模型供应商：Volcengine Ark \(China\)/ }).click();
+
+ await expect(page.getByLabel('模型供应商连接标识')).toHaveValue('volcengine-ark');
+ await expect(page.getByLabel('模型供应商服务地址')).toHaveValue('https://ark.cn-beijing.volces.com/api/v3');
+ await expect(page.getByLabel('模型供应商默认模型')).toHaveValue('doubao-seed-2-0-pro-260215');
+ await page.getByRole('button', { name: '保存供应商' }).click();
+
+ await expect(page.getByRole('heading', { name: 'Volcengine Ark (China)', exact: true }).first()).toBeVisible();
+ const detailMark = page.locator(
+ '.providerSubpageHeader .providerLogo[data-provider="volcengine-ark"] .providerAssetMask',
+ );
+ await expect(detailMark).toBeVisible();
+ expect(await detailMark.evaluate(maskRenderContract)).toEqual({ usesAssetMask: true, followsForeground: true });
+ await expect(page.getByText('doubao-seed-2-0-pro-260215', { exact: true }).first()).toBeVisible();
+ await expect(page.getByRole('textbox', { name: '模型密钥' })).toBeVisible();
+});
+
 test('restores keyboard focus across provider child pages', async ({ window: page }) => {
  await page.getByRole('button', { name: '展开侧边栏' }).click();
  await page.getByRole('button', { name: '设置' }).click();

apps/desktop/src/main/__tests__/icon-governance-contract.test.ts

@@ -46,6 +46,7 @@ const NVIDIA_BRAND_MARK_FILE = resolve(REPO_ROOT, 'apps/desktop/src/renderer/ass
 const TENCENT_HUNYUAN_BRAND_MARK_FILE = resolve(REPO_ROOT, 'apps/desktop/src/renderer/assets/provider-brands/hunyuan.svg');
 const TENCENT_CLOUD_BRAND_MARK_FILE = resolve(REPO_ROOT, 'apps/desktop/src/renderer/assets/provider-brands/tencentcloud.svg');
 const STEPFUN_BRAND_MARK_FILE = resolve(REPO_ROOT, 'apps/desktop/src/renderer/assets/provider-brands/stepfun.svg');
+const VOLCENGINE_BRAND_MARK_FILE = resolve(REPO_ROOT, 'apps/desktop/src/renderer/assets/provider-brands/volcengine.svg');
 const DESKTOP_PACKAGE_FILE = resolve(REPO_ROOT, 'apps/desktop/package.json');
 const THIRD_PARTY_NOTICES_FILE = resolve(REPO_ROOT, 'apps/desktop/src/renderer/public/THIRD_PARTY_LICENSES.txt');
 const ONBOARDING_HERO_FILE = resolve(REPO_ROOT, 'apps/desktop/src/renderer/OnboardingHero.tsx');
@@ -430,6 +431,31 @@ describe('icon + typography governance contract', () => {
  assert.match(componentSrc, /case 'stepfun':\s*return <ProviderAssetMask src=\{stepfunBrandMark\} \/>/);
  });
 
+ it('vendors and routes the byte-exact upstream Volcengine mark through the shared asset-mask seam', async () => {
+ const [volcengineMark, componentSrc, notices] = await Promise.all([
+ readFile(VOLCENGINE_BRAND_MARK_FILE),
+ readFile(PROVIDER_BRAND_MARKS_FILE, 'utf8'),
+ readFile(THIRD_PARTY_NOTICES_FILE, 'utf8'),
+ ]);
+
+ assert.equal(
+ createHash('sha256').update(volcengineMark).digest('hex'),
+ 'f29d0bdc284b33d8664ef221add7fbf06a5b370ef92767fa33f6020c914d3d33',
+ 'the vendored Volcengine mark must remain byte-identical to @lobehub/icons-static-svg@1.91.0 volcengine.svg',
+ );
+ assert.match(
+ notices,
+ /apps\/desktop\/src\/renderer\/assets\/provider-brands\/volcengine\.svg[\s\S]*e4302041fbb3039608d25f9f618bd462783b875e[\s\S]*packages\/static-svg\/icons\/volcengine\.svg[\s\S]*f29d0bdc284b33d8664ef221add7fbf06a5b370ef92767fa33f6020c914d3d33/,
+ 'Volcengine must append byte-exact provenance to the existing Lobe Icons notice entry',
+ );
+ assert.match(componentSrc, /import volcengineBrandMark from '\.\.\/assets\/provider-brands\/volcengine\.svg';/);
+ assert.match(
+ componentSrc,
+ /Volcengine mark vendored byte-for-byte from Lobe Icons:[\s\S]*@lobehub\/icons-static-svg@1\.91\.0[\s\S]*e4302041fbb3039608d25f9f618bd462783b875e[\s\S]*packages\/static-svg\/icons\/volcengine\.svg[\s\S]*MIT[\s\S]*f29d0bdc284b33d8664ef221add7fbf06a5b370ef92767fa33f6020c914d3d33/,
+ );
+ assert.match(componentSrc, /case 'volcengine-ark':\s*return <ProviderAssetMask src=\{volcengineBrandMark\} \/>/);
+ });
+
  it('vendors and routes the byte-exact Tencent Cloud mark for Tencent Coding Plan', async () => {
  const [tencentCloudMark, componentSrc, notices] = await Promise.all([
  readFile(TENCENT_CLOUD_BRAND_MARK_FILE),

apps/desktop/src/renderer/public/THIRD_PARTY_LICENSES.txt

@@ -53,6 +53,10 @@ This file records notices for third-party source assets vendored into the Maka d
  - Upstream commit: `e4302041fbb3039608d25f9f618bd462783b875e`
  - Upstream path: `packages/static-svg/icons/stepfun.svg`
  - SHA-256: `f46fbd1eee00a3dc7874395484bcc3e25a803e9eb4b79f07b7eec377a1e2f25c`
+ - `apps/desktop/src/renderer/assets/provider-brands/volcengine.svg`
+ - Upstream commit: `e4302041fbb3039608d25f9f618bd462783b875e`
+ - Upstream path: `packages/static-svg/icons/volcengine.svg`
+ - SHA-256: `f29d0bdc284b33d8664ef221add7fbf06a5b370ef92767fa33f6020c914d3d33`
 
 MIT License
 

apps/desktop/src/renderer/settings/provider-brand-marks.tsx

@@ -25,6 +25,7 @@ import mistralBrandMark from '../assets/provider-brands/mistral.svg';
 import togetherBrandMark from '../assets/provider-brands/together.svg';
 import nvidiaMarkUrl from '../assets/provider-brands/nvidia.svg';
 import stepfunBrandMark from '../assets/provider-brands/stepfun.svg';
+import volcengineBrandMark from '../assets/provider-brands/volcengine.svg';
 import xaiMarkUrl from '../assets/provider-brands/xai.svg';
 
 // Real xAI/Grok mark vendored byte-for-byte from Lobe Icons:
@@ -92,6 +93,14 @@ function XAI(): ReactElement {
 // - license: MIT (repository LICENSE)
 // - SHA-256: f46fbd1eee00a3dc7874395484bcc3e25a803e9eb4b79f07b7eec377a1e2f25c
 
+// Volcengine mark vendored byte-for-byte from Lobe Icons:
+// - repository: https://github.com/lobehub/lobe-icons
+// - package/version: @lobehub/icons-static-svg@1.91.0
+// - commit: e4302041fbb3039608d25f9f618bd462783b875e
+// - path: packages/static-svg/icons/volcengine.svg
+// - license: MIT (repository LICENSE)
+// - SHA-256: f29d0bdc284b33d8664ef221add7fbf06a5b370ef92767fa33f6020c914d3d33
+
 function ProviderAssetMask({ src }: { src: string }): ReactElement {
  const mask = `url("${src}")`;
  return <span className="providerAssetMask" style={{ maskImage: mask, WebkitMaskImage: mask }} aria-hidden="true" />;
@@ -278,6 +287,8 @@ export function ProviderBrandMark({ type }: { type: ProviderType }): ReactElemen
  case 'stepfun-ai':
  case 'stepfun':
  return <ProviderAssetMask src={stepfunBrandMark} />;
+ case 'volcengine-ark':
+ return <ProviderAssetMask src={volcengineBrandMark} />;
  default:
  return <GenericProviderMark />;
  }

packages/cli/src/__tests__/connection-target.test.ts

@@ -4,6 +4,30 @@ import type { LlmConnection } from '@maka/core/llm-connections';
 import { listReadyModelChoices, resolveDefaultSessionTarget } from '../connection-target.js';
 
 describe('default session target resolver', () => {
+ test('resolves Volcengine Ark credentials without rewriting the snapshot model id', async () => {
+ const modelId = 'doubao-seed-2-0-pro-260215';
+ const connection = makeConnection({
+ slug: 'volcengine-ark',
+ name: 'Volcengine Ark (China)',
+ providerType: 'volcengine-ark',
+ defaultModel: modelId,
+ });
+
+ const target = await resolveDefaultSessionTarget({
+ connectionStore: {
+ getDefault: async () => 'volcengine-ark',
+ get: async (slug) => slug === 'volcengine-ark' ? connection : null,
+ },
+ credentialStore: {
+ getSecret: async (_slug, kind) => kind === 'api_key' ? 'ark-test-key' : null,
+ },
+ });
+
+ assert.equal(target.connection.providerType, 'volcengine-ark');
+ assert.equal(target.apiKey, 'ark-test-key');
+ assert.equal(target.model, modelId);
+ });
+
  test('resolves Fireworks credentials without rewriting the exact model path', async () => {
  const connection = makeConnection({
  slug: 'fireworks-ai',

packages/core/src/__tests__/llm-connections.test.ts

@@ -48,6 +48,7 @@ describe('provider compatibility contract', () => {
  'tencent-tokenhub',
  'stepfun',
  'stepfun-ai',
+ 'volcengine-ark',
  'ollama',
  'lm-studio',
  'openai-compatible',
@@ -80,6 +81,7 @@ describe('provider compatibility contract', () => {
  'stepfun',
  'tencent-coding-plan',
  'stepfun-ai',
+ 'volcengine-ark',
  ]);
  assert.deepEqual(CATALOG_PROVIDER_TYPES, [
  'kimi-coding-plan',
@@ -106,6 +108,7 @@ describe('provider compatibility contract', () => {
  'stepfun',
  'tencent-coding-plan',
  'stepfun-ai',
+ 'volcengine-ark',
  ]);
 
  for (const orderField of ['readyOrder', 'catalogOrder', 'recommendedOrder'] as const) {
@@ -371,6 +374,23 @@ describe('provider compatibility contract', () => {
  'step-3.5-flash',
  ]);
  });
+
+ it('owns Volcengine Ark China direct API behavior under the stable volcengine-ark id', () => {
+ const ark = (PROVIDER_REGISTRY as Partial<Record<string, (typeof PROVIDER_REGISTRY)[keyof typeof PROVIDER_REGISTRY]>>)['volcengine-ark'];
+
+ assert.ok(ark, 'Volcengine Ark China direct API must have its own persisted provider id');
+ assert.equal(ark.label, 'Volcengine Ark (China)');
+ assert.equal(ark.baseUrl, 'https://ark.cn-beijing.volces.com/api/v3');
+ assert.equal(ark.authKind, 'api_key');
+ assert.equal(ark.protocol, 'openai');
+ assert.deepEqual(ark.runtimeAdapter, { kind: 'openai-compatible', name: 'provider' });
+ assert.deepEqual(ark.modelDiscovery, { kind: 'fallback' });
+ assert.equal(ark.category, 'domestic');
+ assert.equal(ark.catalogGroup, 'api');
+ assert.equal(ark.signupUrl, 'https://console.volcengine.com/ark/region:ark+cn-beijing/model');
+ assert.equal(ark.modelsDevId, undefined);
+ assert.deepEqual(ark.fallbackModels, ['doubao-seed-2-0-pro-260215']);
+ });
 });
 
 describe('validateConnectionBaseUrl (PR-UI-IPC-1, @kenji msg 35260e29)', () => {

packages/core/src/__tests__/model-catalog.test.ts

@@ -34,6 +34,25 @@ describe('ModelCatalogEntry', () => {
  });
  });
 
+ it('uses the official Volcengine Ark snapshot without inventing live model discovery', () => {
+ const entries = buildConnectionModelCatalogEntries({
+ connection: {
+ slug: 'volcengine-ark',
+ providerType: 'volcengine-ark',
+ defaultModel: 'doubao-seed-2-0-pro-260215',
+ },
+ });
+
+ assert.deepEqual(entries.map((entry) => entry.id), ['doubao-seed-2-0-pro-260215']);
+ assert.equal(entries[0]?.displayName, 'Doubao Seed 2.0 Pro');
+ assert.equal(entries[0]?.source, 'static_catalog');
+ assert.equal(entries[0]?.provenance.modelSource, 'fallback');
+ assert.deepEqual(entries[0]?.capabilities, {
+ reasoning: true,
+ functionCalling: true,
+ });
+ });
+
  it('uses the checked-in StepFun China snapshot until account discovery succeeds', () => {
  const entries = buildConnectionModelCatalogEntries({
  connection: {

packages/core/src/__tests__/provider-auth.test.ts

@@ -48,6 +48,19 @@ describe('ProviderAuth contract', () => {
  expect(contract.actionAvailability.fetch_models).toBe('available');
  });
 
+ test('Volcengine Ark China uses the shared API-key credential and snapshot-model flow', () => {
+ const contract = deriveProviderAuthContract({
+ providerType: 'volcengine-ark',
+ hasSecret: true,
+ });
+
+ expect(contract.providerType).toBe('volcengine-ark');
+ expect(contract.setupMode).toBe('api_key');
+ expect(contract.requiresSecret).toBe(true);
+ expect(contract.actionAvailability.test_credentials).toBe('available');
+ expect(contract.actionAvailability.fetch_models).toBe('hidden');
+ });
+
  test('Together AI uses the shared API-key credential flow under its stable provider id', () => {
  const contract = deriveProviderAuthContract({
  providerType: 'togetherai',

packages/core/src/model-metadata.ts

@@ -118,6 +118,19 @@ const STATIC_MODEL_METADATA: Partial<Record<ProviderType, Record<string, ModelMe
  'tencent-coding-plan': {
  'kimi-k2.5': { capabilities: { vision: false } },
  },
+ 'volcengine-ark': {
+ 'doubao-seed-2-0-pro-260215': {
+ displayName: 'Doubao Seed 2.0 Pro',
+ lifecycle: 'active',
+ docsUrl: 'https://www.volcengine.com/docs/82379',
+ capabilities: { reasoning: true, functionCalling: true },
+ thinkingOptions: {
+ efforts: ['minimal', 'low', 'medium', 'high'],
+ toggle: true,
+ offBehavior: 'volcengine-thinking-disabled',
+ },
+ },
+ },
  deepseek: {
  'deepseek-v4-flash': { thinkingOptions: { efforts: ['high', 'max'], toggle: true } },
  },

packages/core/src/model-thinking.ts

@@ -43,7 +43,8 @@ export function isThinkingLevel(value: unknown): value is ThinkingLevel {
  */
 export type ThinkingOffBehavior =
  | 'anthropic-thinking-disabled'
- | 'google-thinking-budget-zero';
+ | 'google-thinking-budget-zero'
+ | 'volcengine-thinking-disabled';
 
 export interface ThinkingOptions {
  readonly efforts?: readonly string[];

packages/core/src/provider-registry.ts

@@ -580,6 +580,24 @@ const providerRegistry = {
  readyOrder: 24,
  catalogOrder: 24,
  },
+ 'volcengine-ark': {
+ label: 'Volcengine Ark (China)',
+ description: 'Volcengine Ark direct API for reasoning and tool-use agents in China.',
+ baseUrl: 'https://ark.cn-beijing.volces.com/api/v3',
+ authKind: 'api_key',
+ backendKind: 'ai-sdk',
+ fallbackModels: ['doubao-seed-2-0-pro-260215'],
+ status: 'ready',
+ protocol: 'openai',
+ runtimeAdapter: { kind: 'openai-compatible', name: 'provider' },
+ modelDiscovery: { kind: 'fallback' },
+ category: 'domestic',
+ catalogGroup: 'api',
+ catalogBadge: 'API',
+ signupUrl: 'https://console.volcengine.com/ark/region:ark+cn-beijing/model',
+ readyOrder: 25,
+ catalogOrder: 25,
+ },
  ollama: {
  label: 'Ollama',
  description: 'Local models from Ollama on localhost.',

packages/headless/src/__tests__/harbor-cell.test.ts

@@ -2362,6 +2362,33 @@ setTimeout(() => {
  assert.equal(missing.apiKey, '');
  });
 
+ test('resolves Volcengine Ark only from its official direct API credential env', () => {
+ const modelId = 'doubao-seed-2-0-pro-260215';
+ const resolved = resolveHarborCellAiSdkEnv({
+ provider: 'volcengine-ark',
+ model: modelId,
+ env: {
+ ARK_API_KEY: 'ark-key',
+ ARK_BASE_URL: 'https://ark.cn-shanghai.volces.com/api/v3',
+ OPENAI_API_KEY: 'openai-key',
+ },
+ ts: 1,
+ });
+
+ assert.equal(resolved.apiKey, 'ark-key');
+ assert.equal(resolved.connection.providerType, 'volcengine-ark');
+ assert.equal(resolved.connection.defaultModel, modelId);
+ assert.equal(resolved.connection.baseUrl, 'https://ark.cn-shanghai.volces.com/api/v3');
+
+ const missing = resolveHarborCellAiSdkEnv({
+ provider: 'volcengine-ark',
+ model: modelId,
+ env: { OPENAI_API_KEY: 'must-not-cross-provider-boundary' },
+ ts: 1,
+ });
+ assert.equal(missing.apiKey, '');
+ });
+
  test('resolves Cerebras only from Cerebras credential env without rewriting the model id', () => {
  const resolved = resolveHarborCellAiSdkEnv({
  provider: 'cerebras',

packages/headless/src/__tests__/provider-env.test.ts

@@ -94,3 +94,11 @@ test('StepFun Global keeps direct API credentials separate from China and plan i
  baseUrls: ['STEPFUN_AI_BASE_URL'],
  });
 });
+
+test('Volcengine Ark direct API uses its official credential namespace', () => {
+ assert.deepEqual(providerCredentialEnv('volcengine-ark'), {
+ apiKeys: ['ARK_API_KEY'],
+ apiKeyFile: 'ARK_API_KEY_FILE',
+ baseUrls: ['ARK_BASE_URL'],
+ });
+});

packages/headless/src/provider-env.ts

@@ -27,6 +27,7 @@ const PROVIDER_CREDENTIAL_ENV = {
  'tencent-tokenhub': env('TENCENT_TOKENHUB', ['TENCENT_TOKENHUB_BASE_URL']),
  stepfun: env('STEPFUN', ['STEPFUN_BASE_URL']),
  'stepfun-ai': env('STEPFUN_AI', ['STEPFUN_AI_BASE_URL']),
+ 'volcengine-ark': env('ARK', ['ARK_BASE_URL']),
  'openai-compatible': env('OPENAI', ['OPENAI_BASE_URL']),
  'claude-subscription': env('ANTHROPIC'),
 } satisfies Partial<Record<ProviderType, ProviderCredentialEnv>>;

packages/runtime/src/__tests__/model-factory-thinking.test.ts

@@ -71,6 +71,20 @@ describe('buildProviderOptions: thinking level', () => {
  assert.deepEqual(buildProviderOptions(conn('deepseek'), 'deepseek-chat', 'high'), {});
  });
 
+ test('Volcengine Ark sends its official thinking object and optional reasoning effort', () => {
+ const modelId = 'doubao-seed-2-0-pro-260215';
+ assert.deepEqual([...thinkingVariantsForModel('volcengine-ark', modelId)], ['off', 'minimal', 'low', 'medium', 'high']);
+ assert.deepEqual(buildProviderOptions(conn('volcengine-ark'), modelId), {
+ 'volcengine-ark': { thinking: { type: 'enabled' } },
+ });
+ assert.deepEqual(buildProviderOptions(conn('volcengine-ark'), modelId, 'high'), {
+ 'volcengine-ark': { thinking: { type: 'enabled' }, reasoningEffort: 'high' },
+ });
+ assert.deepEqual(buildProviderOptions(conn('volcengine-ark'), modelId, 'off'), {
+ 'volcengine-ark': { thinking: { type: 'disabled' } },
+ });
+ });
+
  test('a level the model does not support is dropped (defensive)', () => {
  assert.deepEqual(buildProviderOptions(conn('openai'), 'gpt-4o', 'high'), { openai: {} });
  assert.deepEqual(buildProviderOptions(conn('anthropic'), 'claude-haiku-4-5', 'max'), { anthropic: {} });
@@ -115,6 +129,7 @@ describe('buildProviderOptions: resolver/options drift guard', () => {
  { providerType: 'google', model: 'gemini-3.5-flash' },
  { providerType: 'deepseek', model: 'deepseek-v4-flash' },
  { providerType: 'zai-coding-plan', model: 'glm-5.2', slug: 'zai-coding-plan' },
+ { providerType: 'volcengine-ark', model: 'doubao-seed-2-0-pro-260215' },
  ];
  for (const { providerType, model, slug } of cases) {
  test(`every effort level for ${providerType}/${model} maps to a non-empty fragment`, () => {

apps/desktop/e2e/providers.spec.ts

@@ -330,6 +330,36 @@ for (const stepfun of [
  await expect(page.getByRole('textbox', { name: '模型密钥' })).toBeVisible();
 });
 
+test('adds Volcengine Ark China with its exact snapshot model, API-key field, and shared official mark', async ({ window: page }) => {
+ await page.getByRole('button', { name: '展开侧边栏' }).click();
+ await page.getByRole('button', { name: '设置' }).click();
+ await page.locator('[aria-label="设置分组"]').getByText('模型', { exact: true }).click();
+ await page.getByRole('button', { name: '添加服务商' }).click();
+
+ await page.getByRole('tab', { name: 'API', exact: true }).click();
+ await page.getByPlaceholder('搜索服务商').fill('Volcengine');
+ const catalogMark = page.locator(
+ '.providerCatalogRow[data-provider="volcengine-ark"] .providerLogo .providerAssetMask',
+ );
+ await expect(catalogMark).toBeVisible();
+ expect(await catalogMark.evaluate(maskRenderContract)).toEqual({ usesAssetMask: true, followsForeground: true });
+ await page.getByRole('button', { name: /添加模型供应商：Volcengine Ark \(China\)/ }).click();
+
+ await expect(page.getByLabel('模型供应商连接标识')).toHaveValue('volcengine-ark');
+ await expect(page.getByLabel('模型供应商服务地址')).toHaveValue('https://ark.cn-beijing.volces.com/api/v3');
+ await expect(page.getByLabel('模型供应商默认模型')).toHaveValue('doubao-seed-2-0-pro-260215');
+ await page.getByRole('button', { name: '保存供应商' }).click();
+
+ await expect(page.getByRole('heading', { name: 'Volcengine Ark (China)', exact: true }).first()).toBeVisible();
+ const detailMark = page.locator(
+ '.providerSubpageHeader .providerLogo[data-provider="volcengine-ark"] .providerAssetMask',
+ );
+ await expect(detailMark).toBeVisible();
+ expect(await detailMark.evaluate(maskRenderContract)).toEqual({ usesAssetMask: true, followsForeground: true });
+ await expect(page.getByText('doubao-seed-2-0-pro-260215', { exact: true }).first()).toBeVisible();
+ await expect(page.getByRole('textbox', { name: '模型密钥' })).toBeVisible();
+});
+
 test('restores keyboard focus across provider child pages', async ({ window: page }) => {
  await page.getByRole('button', { name: '展开侧边栏' }).click();
  await page.getByRole('button', { name: '设置' }).click();

apps/desktop/src/main/__tests__/icon-governance-contract.test.ts

@@ -46,6 +46,7 @@ const NVIDIA_BRAND_MARK_FILE = resolve(REPO_ROOT, 'apps/desktop/src/renderer/ass
 const TENCENT_HUNYUAN_BRAND_MARK_FILE = resolve(REPO_ROOT, 'apps/desktop/src/renderer/assets/provider-brands/hunyuan.svg');
 const TENCENT_CLOUD_BRAND_MARK_FILE = resolve(REPO_ROOT, 'apps/desktop/src/renderer/assets/provider-brands/tencentcloud.svg');
 const STEPFUN_BRAND_MARK_FILE = resolve(REPO_ROOT, 'apps/desktop/src/renderer/assets/provider-brands/stepfun.svg');
+const VOLCENGINE_BRAND_MARK_FILE = resolve(REPO_ROOT, 'apps/desktop/src/renderer/assets/provider-brands/volcengine.svg');
 const DESKTOP_PACKAGE_FILE = resolve(REPO_ROOT, 'apps/desktop/package.json');
 const THIRD_PARTY_NOTICES_FILE = resolve(REPO_ROOT, 'apps/desktop/src/renderer/public/THIRD_PARTY_LICENSES.txt');
 const ONBOARDING_HERO_FILE = resolve(REPO_ROOT, 'apps/desktop/src/renderer/OnboardingHero.tsx');
@@ -430,6 +431,31 @@ describe('icon + typography governance contract', () => {
  assert.match(componentSrc, /case 'stepfun':\s*return <ProviderAssetMask src=\{stepfunBrandMark\} \/>/);
  });
 
+ it('vendors and routes the byte-exact upstream Volcengine mark through the shared asset-mask seam', async () => {
+ const [volcengineMark, componentSrc, notices] = await Promise.all([
+ readFile(VOLCENGINE_BRAND_MARK_FILE),
+ readFile(PROVIDER_BRAND_MARKS_FILE, 'utf8'),
+ readFile(THIRD_PARTY_NOTICES_FILE, 'utf8'),
+ ]);
+
+ assert.equal(
+ createHash('sha256').update(volcengineMark).digest('hex'),
+ 'f29d0bdc284b33d8664ef221add7fbf06a5b370ef92767fa33f6020c914d3d33',
+ 'the vendored Volcengine mark must remain byte-identical to @lobehub/icons-static-svg@1.91.0 volcengine.svg',
+ );
+ assert.match(
+ notices,
+ /apps\/desktop\/src\/renderer\/assets\/provider-brands\/volcengine\.svg[\s\S]*e4302041fbb3039608d25f9f618bd462783b875e[\s\S]*packages\/static-svg\/icons\/volcengine\.svg[\s\S]*f29d0bdc284b33d8664ef221add7fbf06a5b370ef92767fa33f6020c914d3d33/,
+ 'Volcengine must append byte-exact provenance to the existing Lobe Icons notice entry',
+ );
+ assert.match(componentSrc, /import volcengineBrandMark from '\.\.\/assets\/provider-brands\/volcengine\.svg';/);
+ assert.match(
+ componentSrc,
+ /Volcengine mark vendored byte-for-byte from Lobe Icons:[\s\S]*@lobehub\/icons-static-svg@1\.91\.0[\s\S]*e4302041fbb3039608d25f9f618bd462783b875e[\s\S]*packages\/static-svg\/icons\/volcengine\.svg[\s\S]*MIT[\s\S]*f29d0bdc284b33d8664ef221add7fbf06a5b370ef92767fa33f6020c914d3d33/,
+ );
+ assert.match(componentSrc, /case 'volcengine-ark':\s*return <ProviderAssetMask src=\{volcengineBrandMark\} \/>/);
+ });
+
  it('vendors and routes the byte-exact Tencent Cloud mark for Tencent Coding Plan', async () => {
  const [tencentCloudMark, componentSrc, notices] = await Promise.all([
  readFile(TENCENT_CLOUD_BRAND_MARK_FILE),

apps/desktop/src/renderer/public/THIRD_PARTY_LICENSES.txt

@@ -53,6 +53,10 @@ This file records notices for third-party source assets vendored into the Maka d
  - Upstream commit: `e4302041fbb3039608d25f9f618bd462783b875e`
  - Upstream path: `packages/static-svg/icons/stepfun.svg`
  - SHA-256: `f46fbd1eee00a3dc7874395484bcc3e25a803e9eb4b79f07b7eec377a1e2f25c`
+ - `apps/desktop/src/renderer/assets/provider-brands/volcengine.svg`
+ - Upstream commit: `e4302041fbb3039608d25f9f618bd462783b875e`
+ - Upstream path: `packages/static-svg/icons/volcengine.svg`
+ - SHA-256: `f29d0bdc284b33d8664ef221add7fbf06a5b370ef92767fa33f6020c914d3d33`
 
 MIT License
 

apps/desktop/src/renderer/settings/provider-brand-marks.tsx

@@ -25,6 +25,7 @@ import mistralBrandMark from '../assets/provider-brands/mistral.svg';
 import togetherBrandMark from '../assets/provider-brands/together.svg';
 import nvidiaMarkUrl from '../assets/provider-brands/nvidia.svg';
 import stepfunBrandMark from '../assets/provider-brands/stepfun.svg';
+import volcengineBrandMark from '../assets/provider-brands/volcengine.svg';
 import xaiMarkUrl from '../assets/provider-brands/xai.svg';
 
 // Real xAI/Grok mark vendored byte-for-byte from Lobe Icons:
@@ -92,6 +93,14 @@ function XAI(): ReactElement {
 // - license: MIT (repository LICENSE)
 // - SHA-256: f46fbd1eee00a3dc7874395484bcc3e25a803e9eb4b79f07b7eec377a1e2f25c
 
+// Volcengine mark vendored byte-for-byte from Lobe Icons:
+// - repository: https://github.com/lobehub/lobe-icons
+// - package/version: @lobehub/icons-static-svg@1.91.0
+// - commit: e4302041fbb3039608d25f9f618bd462783b875e
+// - path: packages/static-svg/icons/volcengine.svg
+// - license: MIT (repository LICENSE)
+// - SHA-256: f29d0bdc284b33d8664ef221add7fbf06a5b370ef92767fa33f6020c914d3d33
+
 function ProviderAssetMask({ src }: { src: string }): ReactElement {
  const mask = `url("${src}")`;
  return <span className="providerAssetMask" style={{ maskImage: mask, WebkitMaskImage: mask }} aria-hidden="true" />;
@@ -278,6 +287,8 @@ export function ProviderBrandMark({ type }: { type: ProviderType }): ReactElemen
  case 'stepfun-ai':
  case 'stepfun':
  return <ProviderAssetMask src={stepfunBrandMark} />;
+ case 'volcengine-ark':
+ return <ProviderAssetMask src={volcengineBrandMark} />;
  default:
  return <GenericProviderMark />;
  }

packages/cli/src/__tests__/connection-target.test.ts

@@ -4,6 +4,30 @@ import type { LlmConnection } from '@maka/core/llm-connections';
 import { listReadyModelChoices, resolveDefaultSessionTarget } from '../connection-target.js';
 
 describe('default session target resolver', () => {
+ test('resolves Volcengine Ark credentials without rewriting the snapshot model id', async () => {
+ const modelId = 'doubao-seed-2-0-pro-260215';
+ const connection = makeConnection({
+ slug: 'volcengine-ark',
+ name: 'Volcengine Ark (China)',
+ providerType: 'volcengine-ark',
+ defaultModel: modelId,
+ });
+
+ const target = await resolveDefaultSessionTarget({
+ connectionStore: {
+ getDefault: async () => 'volcengine-ark',
+ get: async (slug) => slug === 'volcengine-ark' ? connection : null,
+ },
+ credentialStore: {
+ getSecret: async (_slug, kind) => kind === 'api_key' ? 'ark-test-key' : null,
+ },
+ });
+
+ assert.equal(target.connection.providerType, 'volcengine-ark');
+ assert.equal(target.apiKey, 'ark-test-key');
+ assert.equal(target.model, modelId);
+ });
+
  test('resolves Fireworks credentials without rewriting the exact model path', async () => {
  const connection = makeConnection({
  slug: 'fireworks-ai',

packages/core/src/__tests__/llm-connections.test.ts

@@ -48,6 +48,7 @@ describe('provider compatibility contract', () => {
  'tencent-tokenhub',
  'stepfun',
  'stepfun-ai',
+ 'volcengine-ark',
  'ollama',
  'lm-studio',
  'openai-compatible',
@@ -80,6 +81,7 @@ describe('provider compatibility contract', () => {
  'stepfun',
  'tencent-coding-plan',
  'stepfun-ai',
+ 'volcengine-ark',
  ]);
  assert.deepEqual(CATALOG_PROVIDER_TYPES, [
  'kimi-coding-plan',
@@ -106,6 +108,7 @@ describe('provider compatibility contract', () => {
  'stepfun',
  'tencent-coding-plan',
  'stepfun-ai',
+ 'volcengine-ark',
  ]);
 
  for (const orderField of ['readyOrder', 'catalogOrder', 'recommendedOrder'] as const) {
@@ -371,6 +374,23 @@ describe('provider compatibility contract', () => {
  'step-3.5-flash',
  ]);
  });
+
+ it('owns Volcengine Ark China direct API behavior under the stable volcengine-ark id', () => {
+ const ark = (PROVIDER_REGISTRY as Partial<Record<string, (typeof PROVIDER_REGISTRY)[keyof typeof PROVIDER_REGISTRY]>>)['volcengine-ark'];
+
+ assert.ok(ark, 'Volcengine Ark China direct API must have its own persisted provider id');
+ assert.equal(ark.label, 'Volcengine Ark (China)');
+ assert.equal(ark.baseUrl, 'https://ark.cn-beijing.volces.com/api/v3');
+ assert.equal(ark.authKind, 'api_key');
+ assert.equal(ark.protocol, 'openai');
+ assert.deepEqual(ark.runtimeAdapter, { kind: 'openai-compatible', name: 'provider' });
+ assert.deepEqual(ark.modelDiscovery, { kind: 'fallback' });
+ assert.equal(ark.category, 'domestic');
+ assert.equal(ark.catalogGroup, 'api');
+ assert.equal(ark.signupUrl, 'https://console.volcengine.com/ark/region:ark+cn-beijing/model');
+ assert.equal(ark.modelsDevId, undefined);
+ assert.deepEqual(ark.fallbackModels, ['doubao-seed-2-0-pro-260215']);
+ });
 });
 
 describe('validateConnectionBaseUrl (PR-UI-IPC-1, @kenji msg 35260e29)', () => {

packages/core/src/__tests__/model-catalog.test.ts

@@ -34,6 +34,25 @@ describe('ModelCatalogEntry', () => {
  });
  });
 
+ it('uses the official Volcengine Ark snapshot without inventing live model discovery', () => {
+ const entries = buildConnectionModelCatalogEntries({
+ connection: {
+ slug: 'volcengine-ark',
+ providerType: 'volcengine-ark',
+ defaultModel: 'doubao-seed-2-0-pro-260215',
+ },
+ });
+
+ assert.deepEqual(entries.map((entry) => entry.id), ['doubao-seed-2-0-pro-260215']);
+ assert.equal(entries[0]?.displayName, 'Doubao Seed 2.0 Pro');
+ assert.equal(entries[0]?.source, 'static_catalog');
+ assert.equal(entries[0]?.provenance.modelSource, 'fallback');
+ assert.deepEqual(entries[0]?.capabilities, {
+ reasoning: true,
+ functionCalling: true,
+ });
+ });
+
  it('uses the checked-in StepFun China snapshot until account discovery succeeds', () => {
  const entries = buildConnectionModelCatalogEntries({
  connection: {

packages/core/src/__tests__/provider-auth.test.ts

@@ -48,6 +48,19 @@ describe('ProviderAuth contract', () => {
  expect(contract.actionAvailability.fetch_models).toBe('available');
  });
 
+ test('Volcengine Ark China uses the shared API-key credential and snapshot-model flow', () => {
+ const contract = deriveProviderAuthContract({
+ providerType: 'volcengine-ark',
+ hasSecret: true,
+ });
+
+ expect(contract.providerType).toBe('volcengine-ark');
+ expect(contract.setupMode).toBe('api_key');
+ expect(contract.requiresSecret).toBe(true);
+ expect(contract.actionAvailability.test_credentials).toBe('available');
+ expect(contract.actionAvailability.fetch_models).toBe('hidden');
+ });
+
  test('Together AI uses the shared API-key credential flow under its stable provider id', () => {
  const contract = deriveProviderAuthContract({
  providerType: 'togetherai',

packages/core/src/model-metadata.ts

@@ -118,6 +118,19 @@ const STATIC_MODEL_METADATA: Partial<Record<ProviderType, Record<string, ModelMe
  'tencent-coding-plan': {
  'kimi-k2.5': { capabilities: { vision: false } },
  },
+ 'volcengine-ark': {
+ 'doubao-seed-2-0-pro-260215': {
+ displayName: 'Doubao Seed 2.0 Pro',
+ lifecycle: 'active',
+ docsUrl: 'https://www.volcengine.com/docs/82379',
+ capabilities: { reasoning: true, functionCalling: true },
+ thinkingOptions: {
+ efforts: ['minimal', 'low', 'medium', 'high'],
+ toggle: true,
+ offBehavior: 'volcengine-thinking-disabled',
+ },
+ },
+ },
  deepseek: {
  'deepseek-v4-flash': { thinkingOptions: { efforts: ['high', 'max'], toggle: true } },
  },

packages/core/src/model-thinking.ts

@@ -43,7 +43,8 @@ export function isThinkingLevel(value: unknown): value is ThinkingLevel {
  */
 export type ThinkingOffBehavior =
  | 'anthropic-thinking-disabled'
- | 'google-thinking-budget-zero';
+ | 'google-thinking-budget-zero'
+ | 'volcengine-thinking-disabled';
 
 export interface ThinkingOptions {
  readonly efforts?: readonly string[];

packages/core/src/provider-registry.ts

@@ -580,6 +580,24 @@ const providerRegistry = {
  readyOrder: 24,
  catalogOrder: 24,
  },
+ 'volcengine-ark': {
+ label: 'Volcengine Ark (China)',
+ description: 'Volcengine Ark direct API for reasoning and tool-use agents in China.',
+ baseUrl: 'https://ark.cn-beijing.volces.com/api/v3',
+ authKind: 'api_key',
+ backendKind: 'ai-sdk',
+ fallbackModels: ['doubao-seed-2-0-pro-260215'],
+ status: 'ready',
+ protocol: 'openai',
+ runtimeAdapter: { kind: 'openai-compatible', name: 'provider' },
+ modelDiscovery: { kind: 'fallback' },
+ category: 'domestic',
+ catalogGroup: 'api',
+ catalogBadge: 'API',
+ signupUrl: 'https://console.volcengine.com/ark/region:ark+cn-beijing/model',
+ readyOrder: 25,
+ catalogOrder: 25,
+ },
  ollama: {
  label: 'Ollama',
  description: 'Local models from Ollama on localhost.',

packages/headless/src/__tests__/harbor-cell.test.ts

@@ -2362,6 +2362,33 @@ setTimeout(() => {
  assert.equal(missing.apiKey, '');
  });
 
+ test('resolves Volcengine Ark only from its official direct API credential env', () => {
+ const modelId = 'doubao-seed-2-0-pro-260215';
+ const resolved = resolveHarborCellAiSdkEnv({
+ provider: 'volcengine-ark',
+ model: modelId,
+ env: {
+ ARK_API_KEY: 'ark-key',
+ ARK_BASE_URL: 'https://ark.cn-shanghai.volces.com/api/v3',
+ OPENAI_API_KEY: 'openai-key',
+ },
+ ts: 1,
+ });
+
+ assert.equal(resolved.apiKey, 'ark-key');
+ assert.equal(resolved.connection.providerType, 'volcengine-ark');
+ assert.equal(resolved.connection.defaultModel, modelId);
+ assert.equal(resolved.connection.baseUrl, 'https://ark.cn-shanghai.volces.com/api/v3');
+
+ const missing = resolveHarborCellAiSdkEnv({
+ provider: 'volcengine-ark',
+ model: modelId,
+ env: { OPENAI_API_KEY: 'must-not-cross-provider-boundary' },
+ ts: 1,
+ });
+ assert.equal(missing.apiKey, '');
+ });
+
  test('resolves Cerebras only from Cerebras credential env without rewriting the model id', () => {
  const resolved = resolveHarborCellAiSdkEnv({
  provider: 'cerebras',

packages/headless/src/__tests__/provider-env.test.ts

@@ -94,3 +94,11 @@ test('StepFun Global keeps direct API credentials separate from China and plan i
  baseUrls: ['STEPFUN_AI_BASE_URL'],
  });
 });
+
+test('Volcengine Ark direct API uses its official credential namespace', () => {
+ assert.deepEqual(providerCredentialEnv('volcengine-ark'), {
+ apiKeys: ['ARK_API_KEY'],
+ apiKeyFile: 'ARK_API_KEY_FILE',
+ baseUrls: ['ARK_BASE_URL'],
+ });
+});

packages/headless/src/provider-env.ts

@@ -27,6 +27,7 @@ const PROVIDER_CREDENTIAL_ENV = {
  'tencent-tokenhub': env('TENCENT_TOKENHUB', ['TENCENT_TOKENHUB_BASE_URL']),
  stepfun: env('STEPFUN', ['STEPFUN_BASE_URL']),
  'stepfun-ai': env('STEPFUN_AI', ['STEPFUN_AI_BASE_URL']),
+ 'volcengine-ark': env('ARK', ['ARK_BASE_URL']),
  'openai-compatible': env('OPENAI', ['OPENAI_BASE_URL']),
  'claude-subscription': env('ANTHROPIC'),
 } satisfies Partial<Record<ProviderType, ProviderCredentialEnv>>;

packages/runtime/src/__tests__/model-factory-thinking.test.ts

@@ -71,6 +71,20 @@ describe('buildProviderOptions: thinking level', () => {
  assert.deepEqual(buildProviderOptions(conn('deepseek'), 'deepseek-chat', 'high'), {});
  });
 
+ test('Volcengine Ark sends its official thinking object and optional reasoning effort', () => {
+ const modelId = 'doubao-seed-2-0-pro-260215';
+ assert.deepEqual([...thinkingVariantsForModel('volcengine-ark', modelId)], ['off', 'minimal', 'low', 'medium', 'high']);
+ assert.deepEqual(buildProviderOptions(conn('volcengine-ark'), modelId), {
+ 'volcengine-ark': { thinking: { type: 'enabled' } },
+ });
+ assert.deepEqual(buildProviderOptions(conn('volcengine-ark'), modelId, 'high'), {
+ 'volcengine-ark': { thinking: { type: 'enabled' }, reasoningEffort: 'high' },
+ });
+ assert.deepEqual(buildProviderOptions(conn('volcengine-ark'), modelId, 'off'), {
+ 'volcengine-ark': { thinking: { type: 'disabled' } },
+ });
+ });
+
  test('a level the model does not support is dropped (defensive)', () => {
  assert.deepEqual(buildProviderOptions(conn('openai'), 'gpt-4o', 'high'), { openai: {} });
  assert.deepEqual(buildProviderOptions(conn('anthropic'), 'claude-haiku-4-5', 'max'), { anthropic: {} });
@@ -115,6 +129,7 @@ describe('buildProviderOptions: resolver/options drift guard', () => {
  { providerType: 'google', model: 'gemini-3.5-flash' },
  { providerType: 'deepseek', model: 'deepseek-v4-flash' },
  { providerType: 'zai-coding-plan', model: 'glm-5.2', slug: 'zai-coding-plan' },
+ { providerType: 'volcengine-ark', model: 'doubao-seed-2-0-pro-260215' },
  ];
  for (const { providerType, model, slug } of cases) {
  test(`every effort level for ${providerType}/${model} maps to a non-empty fragment`, () => {

apps/desktop/e2e/providers.spec.ts

@@ -330,6 +330,36 @@ for (const stepfun of [
  await expect(page.getByRole('textbox', { name: '模型密钥' })).toBeVisible();
 });
 
+test('adds Volcengine Ark China with its exact snapshot model, API-key field, and shared official mark', async ({ window: page }) => {
+ await page.getByRole('button', { name: '展开侧边栏' }).click();
+ await page.getByRole('button', { name: '设置' }).click();
+ await page.locator('[aria-label="设置分组"]').getByText('模型', { exact: true }).click();
+ await page.getByRole('button', { name: '添加服务商' }).click();
+
+ await page.getByRole('tab', { name: 'API', exact: true }).click();
+ await page.getByPlaceholder('搜索服务商').fill('Volcengine');
+ const catalogMark = page.locator(
+ '.providerCatalogRow[data-provider="volcengine-ark"] .providerLogo .providerAssetMask',
+ );
+ await expect(catalogMark).toBeVisible();
+ expect(await catalogMark.evaluate(maskRenderContract)).toEqual({ usesAssetMask: true, followsForeground: true });
+ await page.getByRole('button', { name: /添加模型供应商：Volcengine Ark \(China\)/ }).click();
+
+ await expect(page.getByLabel('模型供应商连接标识')).toHaveValue('volcengine-ark');
+ await expect(page.getByLabel('模型供应商服务地址')).toHaveValue('https://ark.cn-beijing.volces.com/api/v3');
+ await expect(page.getByLabel('模型供应商默认模型')).toHaveValue('doubao-seed-2-0-pro-260215');
+ await page.getByRole('button', { name: '保存供应商' }).click();
+
+ await expect(page.getByRole('heading', { name: 'Volcengine Ark (China)', exact: true }).first()).toBeVisible();
+ const detailMark = page.locator(
+ '.providerSubpageHeader .providerLogo[data-provider="volcengine-ark"] .providerAssetMask',
+ );
+ await expect(detailMark).toBeVisible();
+ expect(await detailMark.evaluate(maskRenderContract)).toEqual({ usesAssetMask: true, followsForeground: true });
+ await expect(page.getByText('doubao-seed-2-0-pro-260215', { exact: true }).first()).toBeVisible();
+ await expect(page.getByRole('textbox', { name: '模型密钥' })).toBeVisible();
+});
+
 test('restores keyboard focus across provider child pages', async ({ window: page }) => {
  await page.getByRole('button', { name: '展开侧边栏' }).click();
  await page.getByRole('button', { name: '设置' }).click();

apps/desktop/src/main/__tests__/icon-governance-contract.test.ts

@@ -46,6 +46,7 @@ const NVIDIA_BRAND_MARK_FILE = resolve(REPO_ROOT, 'apps/desktop/src/renderer/ass
 const TENCENT_HUNYUAN_BRAND_MARK_FILE = resolve(REPO_ROOT, 'apps/desktop/src/renderer/assets/provider-brands/hunyuan.svg');
 const TENCENT_CLOUD_BRAND_MARK_FILE = resolve(REPO_ROOT, 'apps/desktop/src/renderer/assets/provider-brands/tencentcloud.svg');
 const STEPFUN_BRAND_MARK_FILE = resolve(REPO_ROOT, 'apps/desktop/src/renderer/assets/provider-brands/stepfun.svg');
+const VOLCENGINE_BRAND_MARK_FILE = resolve(REPO_ROOT, 'apps/desktop/src/renderer/assets/provider-brands/volcengine.svg');
 const DESKTOP_PACKAGE_FILE = resolve(REPO_ROOT, 'apps/desktop/package.json');
 const THIRD_PARTY_NOTICES_FILE = resolve(REPO_ROOT, 'apps/desktop/src/renderer/public/THIRD_PARTY_LICENSES.txt');
 const ONBOARDING_HERO_FILE = resolve(REPO_ROOT, 'apps/desktop/src/renderer/OnboardingHero.tsx');
@@ -430,6 +431,31 @@ describe('icon + typography governance contract', () => {
  assert.match(componentSrc, /case 'stepfun':\s*return <ProviderAssetMask src=\{stepfunBrandMark\} \/>/);
  });
 
+ it('vendors and routes the byte-exact upstream Volcengine mark through the shared asset-mask seam', async () => {
+ const [volcengineMark, componentSrc, notices] = await Promise.all([
+ readFile(VOLCENGINE_BRAND_MARK_FILE),
+ readFile(PROVIDER_BRAND_MARKS_FILE, 'utf8'),
+ readFile(THIRD_PARTY_NOTICES_FILE, 'utf8'),
+ ]);
+
+ assert.equal(
+ createHash('sha256').update(volcengineMark).digest('hex'),
+ 'f29d0bdc284b33d8664ef221add7fbf06a5b370ef92767fa33f6020c914d3d33',
+ 'the vendored Volcengine mark must remain byte-identical to @lobehub/icons-static-svg@1.91.0 volcengine.svg',
+ );
+ assert.match(
+ notices,
+ /apps\/desktop\/src\/renderer\/assets\/provider-brands\/volcengine\.svg[\s\S]*e4302041fbb3039608d25f9f618bd462783b875e[\s\S]*packages\/static-svg\/icons\/volcengine\.svg[\s\S]*f29d0bdc284b33d8664ef221add7fbf06a5b370ef92767fa33f6020c914d3d33/,
+ 'Volcengine must append byte-exact provenance to the existing Lobe Icons notice entry',
+ );
+ assert.match(componentSrc, /import volcengineBrandMark from '\.\.\/assets\/provider-brands\/volcengine\.svg';/);
+ assert.match(
+ componentSrc,
+ /Volcengine mark vendored byte-for-byte from Lobe Icons:[\s\S]*@lobehub\/icons-static-svg@1\.91\.0[\s\S]*e4302041fbb3039608d25f9f618bd462783b875e[\s\S]*packages\/static-svg\/icons\/volcengine\.svg[\s\S]*MIT[\s\S]*f29d0bdc284b33d8664ef221add7fbf06a5b370ef92767fa33f6020c914d3d33/,
+ );
+ assert.match(componentSrc, /case 'volcengine-ark':\s*return <ProviderAssetMask src=\{volcengineBrandMark\} \/>/);
+ });
+
  it('vendors and routes the byte-exact Tencent Cloud mark for Tencent Coding Plan', async () => {
  const [tencentCloudMark, componentSrc, notices] = await Promise.all([
  readFile(TENCENT_CLOUD_BRAND_MARK_FILE),

apps/desktop/src/renderer/public/THIRD_PARTY_LICENSES.txt

@@ -53,6 +53,10 @@ This file records notices for third-party source assets vendored into the Maka d
  - Upstream commit: `e4302041fbb3039608d25f9f618bd462783b875e`
  - Upstream path: `packages/static-svg/icons/stepfun.svg`
  - SHA-256: `f46fbd1eee00a3dc7874395484bcc3e25a803e9eb4b79f07b7eec377a1e2f25c`
+ - `apps/desktop/src/renderer/assets/provider-brands/volcengine.svg`
+ - Upstream commit: `e4302041fbb3039608d25f9f618bd462783b875e`
+ - Upstream path: `packages/static-svg/icons/volcengine.svg`
+ - SHA-256: `f29d0bdc284b33d8664ef221add7fbf06a5b370ef92767fa33f6020c914d3d33`
 
 MIT License
 

apps/desktop/src/renderer/settings/provider-brand-marks.tsx

@@ -25,6 +25,7 @@ import mistralBrandMark from '../assets/provider-brands/mistral.svg';
 import togetherBrandMark from '../assets/provider-brands/together.svg';
 import nvidiaMarkUrl from '../assets/provider-brands/nvidia.svg';
 import stepfunBrandMark from '../assets/provider-brands/stepfun.svg';
+import volcengineBrandMark from '../assets/provider-brands/volcengine.svg';
 import xaiMarkUrl from '../assets/provider-brands/xai.svg';
 
 // Real xAI/Grok mark vendored byte-for-byte from Lobe Icons:
@@ -92,6 +93,14 @@ function XAI(): ReactElement {
 // - license: MIT (repository LICENSE)
 // - SHA-256: f46fbd1eee00a3dc7874395484bcc3e25a803e9eb4b79f07b7eec377a1e2f25c
 
+// Volcengine mark vendored byte-for-byte from Lobe Icons:
+// - repository: https://github.com/lobehub/lobe-icons
+// - package/version: @lobehub/icons-static-svg@1.91.0
+// - commit: e4302041fbb3039608d25f9f618bd462783b875e
+// - path: packages/static-svg/icons/volcengine.svg
+// - license: MIT (repository LICENSE)
+// - SHA-256: f29d0bdc284b33d8664ef221add7fbf06a5b370ef92767fa33f6020c914d3d33
+
 function ProviderAssetMask({ src }: { src: string }): ReactElement {
  const mask = `url("${src}")`;
  return <span className="providerAssetMask" style={{ maskImage: mask, WebkitMaskImage: mask }} aria-hidden="true" />;
@@ -278,6 +287,8 @@ export function ProviderBrandMark({ type }: { type: ProviderType }): ReactElemen
  case 'stepfun-ai':
  case 'stepfun':
  return <ProviderAssetMask src={stepfunBrandMark} />;
+ case 'volcengine-ark':
+ return <ProviderAssetMask src={volcengineBrandMark} />;
  default:
  return <GenericProviderMark />;
  }

packages/cli/src/__tests__/connection-target.test.ts

@@ -4,6 +4,30 @@ import type { LlmConnection } from '@maka/core/llm-connections';
 import { listReadyModelChoices, resolveDefaultSessionTarget } from '../connection-target.js';
 
 describe('default session target resolver', () => {
+ test('resolves Volcengine Ark credentials without rewriting the snapshot model id', async () => {
+ const modelId = 'doubao-seed-2-0-pro-260215';
+ const connection = makeConnection({
+ slug: 'volcengine-ark',
+ name: 'Volcengine Ark (China)',
+ providerType: 'volcengine-ark',
+ defaultModel: modelId,
+ });
+
+ const target = await resolveDefaultSessionTarget({
+ connectionStore: {
+ getDefault: async () => 'volcengine-ark',
+ get: async (slug) => slug === 'volcengine-ark' ? connection : null,
+ },
+ credentialStore: {
+ getSecret: async (_slug, kind) => kind === 'api_key' ? 'ark-test-key' : null,
+ },
+ });
+
+ assert.equal(target.connection.providerType, 'volcengine-ark');
+ assert.equal(target.apiKey, 'ark-test-key');
+ assert.equal(target.model, modelId);
+ });
+
  test('resolves Fireworks credentials without rewriting the exact model path', async () => {
  const connection = makeConnection({
  slug: 'fireworks-ai',

packages/core/src/__tests__/llm-connections.test.ts

@@ -48,6 +48,7 @@ describe('provider compatibility contract', () => {
  'tencent-tokenhub',
  'stepfun',
  'stepfun-ai',
+ 'volcengine-ark',
  'ollama',
  'lm-studio',
  'openai-compatible',
@@ -80,6 +81,7 @@ describe('provider compatibility contract', () => {
  'stepfun',
  'tencent-coding-plan',
  'stepfun-ai',
+ 'volcengine-ark',
  ]);
  assert.deepEqual(CATALOG_PROVIDER_TYPES, [
  'kimi-coding-plan',
@@ -106,6 +108,7 @@ describe('provider compatibility contract', () => {
  'stepfun',
  'tencent-coding-plan',
  'stepfun-ai',
+ 'volcengine-ark',
  ]);
 
  for (const orderField of ['readyOrder', 'catalogOrder', 'recommendedOrder'] as const) {
@@ -371,6 +374,23 @@ describe('provider compatibility contract', () => {
  'step-3.5-flash',
  ]);
  });
+
+ it('owns Volcengine Ark China direct API behavior under the stable volcengine-ark id', () => {
+ const ark = (PROVIDER_REGISTRY as Partial<Record<string, (typeof PROVIDER_REGISTRY)[keyof typeof PROVIDER_REGISTRY]>>)['volcengine-ark'];
+
+ assert.ok(ark, 'Volcengine Ark China direct API must have its own persisted provider id');
+ assert.equal(ark.label, 'Volcengine Ark (China)');
+ assert.equal(ark.baseUrl, 'https://ark.cn-beijing.volces.com/api/v3');
+ assert.equal(ark.authKind, 'api_key');
+ assert.equal(ark.protocol, 'openai');
+ assert.deepEqual(ark.runtimeAdapter, { kind: 'openai-compatible', name: 'provider' });
+ assert.deepEqual(ark.modelDiscovery, { kind: 'fallback' });
+ assert.equal(ark.category, 'domestic');
+ assert.equal(ark.catalogGroup, 'api');
+ assert.equal(ark.signupUrl, 'https://console.volcengine.com/ark/region:ark+cn-beijing/model');
+ assert.equal(ark.modelsDevId, undefined);
+ assert.deepEqual(ark.fallbackModels, ['doubao-seed-2-0-pro-260215']);
+ });
 });
 
 describe('validateConnectionBaseUrl (PR-UI-IPC-1, @kenji msg 35260e29)', () => {

packages/core/src/__tests__/model-catalog.test.ts

@@ -34,6 +34,25 @@ describe('ModelCatalogEntry', () => {
  });
  });
 
+ it('uses the official Volcengine Ark snapshot without inventing live model discovery', () => {
+ const entries = buildConnectionModelCatalogEntries({
+ connection: {
+ slug: 'volcengine-ark',
+ providerType: 'volcengine-ark',
+ defaultModel: 'doubao-seed-2-0-pro-260215',
+ },
+ });
+
+ assert.deepEqual(entries.map((entry) => entry.id), ['doubao-seed-2-0-pro-260215']);
+ assert.equal(entries[0]?.displayName, 'Doubao Seed 2.0 Pro');
+ assert.equal(entries[0]?.source, 'static_catalog');
+ assert.equal(entries[0]?.provenance.modelSource, 'fallback');
+ assert.deepEqual(entries[0]?.capabilities, {
+ reasoning: true,
+ functionCalling: true,
+ });
+ });
+
  it('uses the checked-in StepFun China snapshot until account discovery succeeds', () => {
  const entries = buildConnectionModelCatalogEntries({
  connection: {

packages/core/src/__tests__/provider-auth.test.ts

@@ -48,6 +48,19 @@ describe('ProviderAuth contract', () => {
  expect(contract.actionAvailability.fetch_models).toBe('available');
  });
 
+ test('Volcengine Ark China uses the shared API-key credential and snapshot-model flow', () => {
+ const contract = deriveProviderAuthContract({
+ providerType: 'volcengine-ark',
+ hasSecret: true,
+ });
+
+ expect(contract.providerType).toBe('volcengine-ark');
+ expect(contract.setupMode).toBe('api_key');
+ expect(contract.requiresSecret).toBe(true);
+ expect(contract.actionAvailability.test_credentials).toBe('available');
+ expect(contract.actionAvailability.fetch_models).toBe('hidden');
+ });
+
  test('Together AI uses the shared API-key credential flow under its stable provider id', () => {
  const contract = deriveProviderAuthContract({
  providerType: 'togetherai',

packages/core/src/model-metadata.ts

@@ -118,6 +118,19 @@ const STATIC_MODEL_METADATA: Partial<Record<ProviderType, Record<string, ModelMe
  'tencent-coding-plan': {
  'kimi-k2.5': { capabilities: { vision: false } },
  },
+ 'volcengine-ark': {
+ 'doubao-seed-2-0-pro-260215': {
+ displayName: 'Doubao Seed 2.0 Pro',
+ lifecycle: 'active',
+ docsUrl: 'https://www.volcengine.com/docs/82379',
+ capabilities: { reasoning: true, functionCalling: true },
+ thinkingOptions: {
+ efforts: ['minimal', 'low', 'medium', 'high'],
+ toggle: true,
+ offBehavior: 'volcengine-thinking-disabled',
+ },
+ },
+ },
  deepseek: {
  'deepseek-v4-flash': { thinkingOptions: { efforts: ['high', 'max'], toggle: true } },
  },

packages/core/src/model-thinking.ts

@@ -43,7 +43,8 @@ export function isThinkingLevel(value: unknown): value is ThinkingLevel {
  */
 export type ThinkingOffBehavior =
  | 'anthropic-thinking-disabled'
- | 'google-thinking-budget-zero';
+ | 'google-thinking-budget-zero'
+ | 'volcengine-thinking-disabled';
 
 export interface ThinkingOptions {
  readonly efforts?: readonly string[];

packages/core/src/provider-registry.ts

@@ -580,6 +580,24 @@ const providerRegistry = {
  readyOrder: 24,
  catalogOrder: 24,
  },
+ 'volcengine-ark': {
+ label: 'Volcengine Ark (China)',
+ description: 'Volcengine Ark direct API for reasoning and tool-use agents in China.',
+ baseUrl: 'https://ark.cn-beijing.volces.com/api/v3',
+ authKind: 'api_key',
+ backendKind: 'ai-sdk',
+ fallbackModels: ['doubao-seed-2-0-pro-260215'],
+ status: 'ready',
+ protocol: 'openai',
+ runtimeAdapter: { kind: 'openai-compatible', name: 'provider' },
+ modelDiscovery: { kind: 'fallback' },
+ category: 'domestic',
+ catalogGroup: 'api',
+ catalogBadge: 'API',
+ signupUrl: 'https://console.volcengine.com/ark/region:ark+cn-beijing/model',
+ readyOrder: 25,
+ catalogOrder: 25,
+ },
  ollama: {
  label: 'Ollama',
  description: 'Local models from Ollama on localhost.',

packages/headless/src/__tests__/harbor-cell.test.ts

@@ -2362,6 +2362,33 @@ setTimeout(() => {
  assert.equal(missing.apiKey, '');
  });
 
+ test('resolves Volcengine Ark only from its official direct API credential env', () => {
+ const modelId = 'doubao-seed-2-0-pro-260215';
+ const resolved = resolveHarborCellAiSdkEnv({
+ provider: 'volcengine-ark',
+ model: modelId,
+ env: {
+ ARK_API_KEY: 'ark-key',
+ ARK_BASE_URL: 'https://ark.cn-shanghai.volces.com/api/v3',
+ OPENAI_API_KEY: 'openai-key',
+ },
+ ts: 1,
+ });
+
+ assert.equal(resolved.apiKey, 'ark-key');
+ assert.equal(resolved.connection.providerType, 'volcengine-ark');
+ assert.equal(resolved.connection.defaultModel, modelId);
+ assert.equal(resolved.connection.baseUrl, 'https://ark.cn-shanghai.volces.com/api/v3');
+
+ const missing = resolveHarborCellAiSdkEnv({
+ provider: 'volcengine-ark',
+ model: modelId,
+ env: { OPENAI_API_KEY: 'must-not-cross-provider-boundary' },
+ ts: 1,
+ });
+ assert.equal(missing.apiKey, '');
+ });
+
  test('resolves Cerebras only from Cerebras credential env without rewriting the model id', () => {
  const resolved = resolveHarborCellAiSdkEnv({
  provider: 'cerebras',

packages/headless/src/__tests__/provider-env.test.ts

@@ -94,3 +94,11 @@ test('StepFun Global keeps direct API credentials separate from China and plan i
  baseUrls: ['STEPFUN_AI_BASE_URL'],
  });
 });
+
+test('Volcengine Ark direct API uses its official credential namespace', () => {
+ assert.deepEqual(providerCredentialEnv('volcengine-ark'), {
+ apiKeys: ['ARK_API_KEY'],
+ apiKeyFile: 'ARK_API_KEY_FILE',
+ baseUrls: ['ARK_BASE_URL'],
+ });
+});

packages/headless/src/provider-env.ts

@@ -27,6 +27,7 @@ const PROVIDER_CREDENTIAL_ENV = {
  'tencent-tokenhub': env('TENCENT_TOKENHUB', ['TENCENT_TOKENHUB_BASE_URL']),
  stepfun: env('STEPFUN', ['STEPFUN_BASE_URL']),
  'stepfun-ai': env('STEPFUN_AI', ['STEPFUN_AI_BASE_URL']),
+ 'volcengine-ark': env('ARK', ['ARK_BASE_URL']),
  'openai-compatible': env('OPENAI', ['OPENAI_BASE_URL']),
  'claude-subscription': env('ANTHROPIC'),
 } satisfies Partial<Record<ProviderType, ProviderCredentialEnv>>;

packages/runtime/src/__tests__/model-factory-thinking.test.ts

@@ -71,6 +71,20 @@ describe('buildProviderOptions: thinking level', () => {
  assert.deepEqual(buildProviderOptions(conn('deepseek'), 'deepseek-chat', 'high'), {});
  });
 
+ test('Volcengine Ark sends its official thinking object and optional reasoning effort', () => {
+ const modelId = 'doubao-seed-2-0-pro-260215';
+ assert.deepEqual([...thinkingVariantsForModel('volcengine-ark', modelId)], ['off', 'minimal', 'low', 'medium', 'high']);
+ assert.deepEqual(buildProviderOptions(conn('volcengine-ark'), modelId), {
+ 'volcengine-ark': { thinking: { type: 'enabled' } },
+ });
+ assert.deepEqual(buildProviderOptions(conn('volcengine-ark'), modelId, 'high'), {
+ 'volcengine-ark': { thinking: { type: 'enabled' }, reasoningEffort: 'high' },
+ });
+ assert.deepEqual(buildProviderOptions(conn('volcengine-ark'), modelId, 'off'), {
+ 'volcengine-ark': { thinking: { type: 'disabled' } },
+ });
+ });
+
  test('a level the model does not support is dropped (defensive)', () => {
  assert.deepEqual(buildProviderOptions(conn('openai'), 'gpt-4o', 'high'), { openai: {} });
  assert.deepEqual(buildProviderOptions(conn('anthropic'), 'claude-haiku-4-5', 'max'), { anthropic: {} });
@@ -115,6 +129,7 @@ describe('buildProviderOptions: resolver/options drift guard', () => {
  { providerType: 'google', model: 'gemini-3.5-flash' },
  { providerType: 'deepseek', model: 'deepseek-v4-flash' },
  { providerType: 'zai-coding-plan', model: 'glm-5.2', slug: 'zai-coding-plan' },
+ { providerType: 'volcengine-ark', model: 'doubao-seed-2-0-pro-260215' },
  ];
  for (const { providerType, model, slug } of cases) {
  test(`every effort level for ${providerType}/${model} maps to a non-empty fragment`, () => {