yingclaw 2.5.27 → 2.5.38

package/README.md

@@ -2,7 +2,7 @@
 
 Claude Code × 国产大模型，一键接入。
 
-支持 DeepSeek、Kimi、火山方舟 Coding Plan、阿里云百炼（Qwen）、MiniMax、智谱 GLM、小米 MiMo、B.AI、OpenCode Zen/Go，也支持自定义 Anthropic 兼容接口和自定义 OpenAI 兼容接口，无需梯子即可使用 Claude Code。
+支持 DeepSeek、Kimi、火山方舟 Coding Plan、阿里云百炼（Qwen）、MiniMax、智谱 GLM、小米 MiMo、B.AI、OpenCode Zen/Go，也支持自定义 Anthropic、OpenAI、Google/Gemini 兼容接口，无需梯子即可使用 Claude Code。
 
 ![yingclaw 交互菜单](https://raw.githubusercontent.com/DengShiyingA/yingclaw/main/screenshot.png)
 
@@ -56,8 +56,34 @@ claw desktop
 ```
 `claw desktop` 会把 Claude Desktop 指向 yingclaw 本机 Gateway，并只暴露 `claude-sonnet-4-6`、`claude-opus-4-7`、`claude-haiku-4-5` 这类 Claude Desktop 可接受的模型名。真实第三方模型仍按 `claw config` 保存的主模型和快速模型转发。
 
+`claw desktop` 默认只接入 Claude 桌面应用的 Cowork / Gateway，不写入 Claude Code 共享设置，因此不会自动接入 Claude Code 终端。交互面板会询问是否同时接入 Claude 桌面 Code 模式，默认选 No；选择 Yes 时才会写入 Claude Code 共享设置。
+
+如果你需要同时接入 Claude Desktop 的 Code 模式，再显式运行：
+
+```bash
+claw desktop --with-code
+```
+
+`--with-code` 会写入 `~/.claude/settings.json`，这个文件也会被 Claude Code CLI / VS Code Claude Code 读取。只想用桌面 Cowork 时不要加这个参数。
+
 `claw desktop` 会设置 Gateway 登录自动运行；如果自动启动失败，可以手动运行 `claw gateway`。
 
+出现问题时先运行：
+
+```bash
+claw doctor
+claw support -o yingclaw-support.json
+```
+
+Windows 桌面应用 / Gateway 问题建议运行：
+
+```bash
+claw doctor --windows
+claw support --windows -o yingclaw-support.json
+```
+
+`support` 生成的是脱敏排障包，不包含 API Key / Gateway Key 明文。
+
 ## 支持的厂商
 
 | 厂商 | 主模型 | 快速模型 |
@@ -75,6 +101,7 @@ claw desktop
 | OpenRouter | deepseek/deepseek-r1-0528 | deepseek/deepseek-chat-v3-0324 |
 | 自定义 Anthropic 兼容接口 | 自动获取或手动输入 | 手动选择 |
 | 自定义 OpenAI 兼容接口 | 自动获取或手动输入 | 手动选择 |
+| 自定义 Google/Gemini 兼容接口 | 自动获取或手动输入 | 手动选择 |
 
 DeepSeek 的 `[1m]` 后缀是真实 API 模型 ID，表示 100 万 token 上下文窗口（[官方说明](https://api-docs.deepseek.com/zh-cn/quick_start/agent_integrations/claude_code)）。
 
@@ -89,10 +116,15 @@ claw code            # 接入 Claude Code 终端
 claw vscode          # 接入 VS Code Claude Code 扩展
 claw vscode-reset    # 恢复 VS Code Claude Code 扩展默认配置
 claw desktop         # 接入 Claude 桌面应用
+claw desktop --with-code # 同时接入 Claude Desktop Code 模式，会写 Claude Code 共享设置
 claw gateway         # 启动 Claude 桌面应用本机 Gateway
 claw desktop --direct # 高级：直连写入厂商 Gateway URL
 claw switch          # 快速切换厂商或模型
 claw status          # 查看当前配置，验证 Key 是否有效
+claw doctor          # 自检终端、VS Code、桌面、Gateway 和 API
+claw doctor --windows # 追加 Windows 桌面/Gateway 专项检查
+claw support         # 生成脱敏排障包
+claw support --windows -o yingclaw-support.json
 claw update          # 检查并升级到最新版本
 
 claw code-reset      # 恢复 Claude Code 终端默认配置
@@ -132,9 +164,11 @@ CLAUDE_CODE_EFFORT_LEVEL
 - macOS / Windows：写入 `Claude-3p/configLibrary/` 中的 yingclaw entry
 - Claude Desktop 访问 `http://127.0.0.1:18080/yingclaw`
 - Gateway 再转发到当前保存的 Anthropic 兼容接口；如当前为 Kimi 或 OpenAI 兼容接口，则自动转换为 `/v1/chat/completions`
+- Google/Gemini 兼容接口会通过 Gateway 转换为 Gemini `generateContent` / `streamGenerateContent`
 - macOS 使用 LaunchAgent 登录启动 Gateway，Windows 使用 Startup 目录脚本登录启动 Gateway
 - Windows 会同时写入 Roaming / Local 两个 Claude-3p 位置，以兼容不同 Claude Desktop 安装方式
-- Anthropic 兼容接口的终端接入仍直接使用 `ANTHROPIC_*` 环境变量；Kimi 和 OpenAI 兼容接口的终端/VS Code/桌面会通过本机 Gateway 转换协议
+- Anthropic 兼容接口的终端接入仍直接使用 `ANTHROPIC_*` 环境变量；Kimi、OpenAI 兼容接口和 Google/Gemini 兼容接口会通过本机 Gateway 转换协议
+- 默认不会写入 `~/.claude/settings.json`，避免影响 Claude Code 终端或 VS Code 扩展；面板中选择同时接入 Code，或使用 `claw desktop --with-code` 时才写入
 
 使用 `inferenceProvider=gateway`、`inferenceGatewayAuthScheme=bearer`，将 Gateway Base URL 指向 yingclaw 本机 Gateway。高级用户可用 `claw desktop --direct` 保留旧式直连写入，但新版 Claude Desktop 可能拒绝非 Claude 模型名。
 
@@ -149,6 +183,66 @@ CLAUDE_CODE_EFFORT_LEVEL
 - 扩展与 CLI 共享 Claude Code 设置；如果 VS Code 已打开，需重载窗口或重启后生效
 - 如需恢复默认，运行 `claw vscode-reset`，只移除 yingclaw 写入的 Claude Code env 和 VS Code Claude Code 扩展项，保留其它用户设置
 
+## 排障
+
+### Gateway 未运行或端口被占用
+
+Claude Desktop 报 `Can't reach 127.0.0.1:18080` 时，先确认 Gateway：
+
+```bash
+claw gateway
+```
+
+如果端口被占用，`claw gateway` 会提示占用进程和 PID。可以关闭旧进程，或换端口后重新接入：
+
+```bash
+claw gateway --port 18081
+claw desktop
+```
+
+### Windows 桌面应用不生效
+
+Windows 只关闭窗口可能不会退出 Claude 进程，配置也可能被 Roaming / Local 两个目录读取差异影响。建议运行：
+
+```bash
+claw doctor --windows
+```
+
+它会检查：
+
+- Gateway 端口是否监听
+- Gateway 登录启动脚本是否存在
+- `%APPDATA%\Claude-3p` 和 `%LOCALAPPDATA%\Claude-3p` 配置是否一致
+- 是否仍有 Claude 进程在后台运行
+
+如果提示配置未生效，请从系统托盘退出 Claude，或在任务管理器结束所有 Claude 进程后重新打开。
+
+### OpenAI / Kimi / Gemini 为什么要 Gateway
+
+Claude Code 和 Claude Desktop 原生期望 Anthropic Messages 协议。OpenAI 兼容接口使用 `/v1/chat/completions`，Gemini 使用 `generateContent`。yingclaw 会在本机 Gateway 中做协议转换，所以这类接口需要保持 Gateway 运行。
+
+### 上游错误说明
+
+Gateway 会把常见上游错误转换为中文说明：
+
+| 类型 | 含义 | 建议 |
+|------|------|------|
+| 401 / 403 | Key 无效、过期或无权限 | 运行 `claw config` 重新输入 Key |
+| 404 | 模型不存在或账号不可见 | 运行 `claw switch` 重新选择模型 |
+| 408 / 504 / timeout | 上游响应超时 | 检查网络/VPN，或换快速模型 |
+| subscription / quota | 套餐、余额或权限不足 | 到厂商控制台确认套餐和模型权限 |
+| 429 | 请求限流 | 稍后重试或更换 Key / 模型 |
+
+### 生成排障包
+
+需要反馈问题时运行：
+
+```bash
+claw support --windows -o yingclaw-support.json
+```
+
+排障包会包含当前配置摘要、doctor 检查、Gateway 状态、Desktop Code 状态和 Windows 专项检查，并脱敏 API Key / Gateway Key。公开发送前仍建议快速看一眼 Base URL 是否包含私有域名。
+
 ## 卸载
  
 ```bash

package/bin/cli.js

@@ -39,17 +39,30 @@ const {
   getNodeInstallGuide,
   getInstallFailureHints,
 } = require('../lib/install');
-const { clearClaudeDesktopConfig, isDesktopConfigured, openClaudeDesktop, writeClaudeDesktopConfig } = require('../lib/desktop');
+const {
+  buildClaudeDesktopCodeEnv,
+  checkClaudeDesktopCodeSettingsEnv,
+  clearClaudeDesktopCodeSettings,
+  clearClaudeDesktopConfig,
+  isDesktopConfigured,
+  openClaudeDesktop,
+  shouldPromptClaudeDesktopCodeSettings,
+  shouldWriteClaudeDesktopCodeSettings,
+  writeClaudeDesktopCodeSettings,
+  writeClaudeDesktopConfig,
+} = require('../lib/desktop');
 const {
   DEFAULT_DESKTOP_GATEWAY_PORT,
   YINGCLAW_GATEWAY_PREFIX,
   buildDesktopGatewayMappingRows,
   checkDesktopGatewayStatus,
+  checkGatewayPortOwner,
   createGatewayServer,
   ensureDesktopGatewayConfig,
+  explainGatewayListenError,
   isDesktopChatModel,
 } = require('../lib/gateway');
-const { runDoctorChecks, summarize, STATUS_OK, STATUS_FAIL, STATUS_WARN, STATUS_INFO } = require('../lib/doctor');
+const { buildDiagnosticReport, buildSupportBundle, runDoctorChecks, summarize, writeDiagnosticReport, STATUS_OK, STATUS_FAIL, STATUS_WARN, STATUS_INFO } = require('../lib/doctor');
 const { normalizeOpenAiBaseUrl } = require('../lib/openai');
 
 const program = new Command();
@@ -141,7 +154,8 @@ async function offerDesktopSync(chalk, ora, config) {
   if (!syncDesktop) return;
   const spinner = ora('同步 Claude 桌面应用配置...').start();
   try {
-    writeClaudeDesktopConfig(config);
+    const desktopConfig = ensureDesktopGatewayConfig(config);
+    writeClaudeDesktopConfig(desktopConfig);
     spinner.succeed(chalk.green('Claude 桌面应用配置已同步'));
   } catch (e) {
     spinner.fail(chalk.red(`桌面配置同步失败: ${e.message}`));
@@ -338,8 +352,13 @@ function isOpenAiCompatibleConfig(config) {
   return getProviderProtocol(config) === 'openai';
 }
 
+function needsLocalGateway(config) {
+  const p = getProviderProtocol(config);
+  return p === 'openai' || p === 'google';
+}
+
 function ensureGatewayForOpenAiConfig(config) {
-  return isOpenAiCompatibleConfig(config) ? ensureDesktopGatewayConfig(config) : config;
+  return needsLocalGateway(config) ? ensureDesktopGatewayConfig(config) : config;
 }
 
 function writeClaudeCodeEnv(config) {
@@ -352,15 +371,26 @@ function writeClaudeCodeEnv(config) {
   );
 }
 
+function customBaseUrlPrompt(protocol) {
+  if (protocol === 'openai') return 'OpenAI Base URL';
+  if (protocol === 'google') return 'Google / Gemini Base URL';
+  return 'Anthropic Base URL';
+}
+
+function normalizeCustomBaseUrl(protocol, baseUrl) {
+  if (protocol === 'openai') return normalizeOpenAiBaseUrl(baseUrl);
+  return normalizeAnthropicBaseUrl(baseUrl);
+}
+
 async function configureCustomProvider({ chalk, ora, existingConfig, providerKey = 'custom' }) {
   const provider = PROVIDERS[providerKey];
   const protocol = provider.protocol || 'anthropic';
   const sameProvider = existingConfig?.provider === providerKey;
   const baseUrl = await input({
-    message: chalk.cyan(protocol === 'openai' ? 'OpenAI Base URL' : 'Anthropic Base URL'),
+    message: chalk.cyan(customBaseUrlPrompt(protocol)),
     default: sameProvider ? existingConfig.baseUrl : undefined,
     validate: (v) => v.trim().length > 0 && isValidUrl(v.trim()) ? true : '请输入有效 URL',
-  }).then(v => protocol === 'openai' ? normalizeOpenAiBaseUrl(v.trim()) : normalizeAnthropicBaseUrl(v.trim()));
+  }).then(v => normalizeCustomBaseUrl(protocol, v.trim()));
 
   let apiKey = sameProvider ? existingConfig.apiKey : '';
   if (apiKey) {
@@ -449,6 +479,7 @@ async function showStatus() {
     claudeInstalled: isClaudeInstalled(),
     desktopGatewayStatus: await checkDesktopGatewayStatus(config),
     desktopGatewayAutostartStatus: getGatewayAutostartStatus(),
+    desktopCodeStatus: checkClaudeDesktopCodeSettingsEnv(config),
     env: process.env,
   });
 
@@ -461,6 +492,8 @@ async function showStatus() {
           ? chalk.cyan(value)
         : label === 'Desktop Gateway'
           ? value.includes('已运行') ? chalk.green(value) : chalk.yellow(value)
+        : label === 'Desktop Code'
+          ? value.includes('已配置') ? chalk.green(value) : chalk.yellow(value)
         : label === '当前终端' && value === '未生效'
             ? chalk.yellow(value)
             : value;
@@ -737,7 +770,7 @@ program
     console.log(chalk.dim(getStorageHint(file)));
     const displayedConfig = effectiveConfig;
     const needsGatewayHint = process.platform !== 'darwin' && process.platform !== 'win32'
-      && isOpenAiCompatibleConfig(effectiveConfig);
+      && needsLocalGateway(effectiveConfig);
     console.log(boxen(
       chalk.bold('Claude Code 终端已接入\n\n') +
       chalk.dim('Base URL  ') + chalk.cyan(buildClaudeEnv(displayedConfig).ANTHROPIC_BASE_URL) + '\n' +
@@ -854,7 +887,7 @@ program
     }
 
     const vscodeNeedsGatewayHint = process.platform !== 'darwin' && process.platform !== 'win32'
-      && isOpenAiCompatibleConfig(effectiveConfig);
+      && needsLocalGateway(effectiveConfig);
     console.log(boxen(
       chalk.bold('VS Code Claude Code 扩展已配置\n\n') +
       chalk.dim('共享设置  ') + chalk.cyan(result.claudeSettings.file) + '\n' +
@@ -1045,7 +1078,8 @@ program
       ));
     });
     server.on('error', (error) => {
-      console.error(chalk.red(`Gateway 启动失败: ${error.message}`));
+      const owner = checkGatewayPortOwner(port);
+      console.error(chalk.red(explainGatewayListenError(error, owner)));
       process.exitCode = 1;
     });
   });
@@ -1054,6 +1088,7 @@ program
   .command('desktop')
   .description('接入 Claude 桌面应用使用当前模型')
   .option('--direct', '高级：直接写入当前厂商 Gateway URL，不启用本机模型映射')
+  .option('--with-code', '同时接入 Claude Desktop 的 Code 模式（会写入 Claude Code 共享设置）')
   .action(async (options) => {
     const chalk = (await import('chalk')).default;
     const ora = (await import('ora')).default;
@@ -1098,16 +1133,27 @@ program
         saveConfig({ ...desktopConfig, desktopModels: selectedModels });
         desktopConfig = { ...desktopConfig, availableModels: selectedModels };
       }
+
+      if (shouldPromptClaudeDesktopCodeSettings(options)) {
+        options.withCode = await confirm({
+          message: '是否同时接入 Claude 桌面 Code 模式？（会写入 Claude Code 共享设置）',
+          default: false,
+        });
+      }
     }
 
     const spinner = ora('写入 Claude 桌面应用配置...').start();
     let result;
+    let codeSettingsResult = null;
     try {
       result = writeClaudeDesktopConfig(desktopConfig, { direct: options.direct });
       if (result.result === 'unsupported') {
         spinner.warn(chalk.yellow('当前系统暂不支持自动配置 Claude 桌面应用'));
         return;
       }
+      if (shouldWriteClaudeDesktopCodeSettings(options)) {
+        codeSettingsResult = writeClaudeDesktopCodeSettings(desktopConfig);
+      }
       const extraFiles = Array.isArray(result.files) && result.files.length > 1
         ? chalk.dim(`（已同步 ${result.files.length} 个配置位置）`)
         : '';
@@ -1137,6 +1183,9 @@ program
       : chalk.dim('Gateway  ') + chalk.cyan(gatewayUrl) + '\n' +
         chalk.dim('主模型    ') + chalk.yellow(desktopConfig.model) + '\n' +
         chalk.dim('快速模型  ') + chalk.yellow(desktopConfig.fastModel || desktopConfig.model) + '\n' +
+        (codeSettingsResult
+          ? chalk.dim('Code 模式 ') + chalk.cyan(codeSettingsResult.file) + chalk.dim('（已写入 Claude Code 共享设置）') + '\n'
+          : chalk.dim('Code 模式 ') + chalk.dim('未接入；下次运行 claw desktop 时选择 Yes，或使用 claw desktop --with-code') + '\n') +
         chalk.dim('菜单映射  ') + buildDesktopGatewayMappingRows(desktopConfig)
           .map((row) => `${chalk.white(row.desktopLabel)} ${chalk.dim('→')} ${chalk.yellow(row.upstreamModel)}`)
           .join('\n' + chalk.dim('          ')) + '\n\n' +
@@ -1156,7 +1205,7 @@ program
       if (shouldOpen) {
         const openSpinner = ora('正在重启 Claude 桌面应用...').start();
         try {
-          await openClaudeDesktop();
+          await openClaudeDesktop(shouldWriteClaudeDesktopCodeSettings(options) ? { injectEnv: buildClaudeDesktopCodeEnv(desktopConfig) } : {});
           openSpinner.succeed(chalk.green('Claude 桌面应用已重新打开（旧实例已退出，新配置生效）'));
         } catch (e) {
           openSpinner.fail(chalk.red(`自动重启失败: ${e.message}`));
@@ -1201,10 +1250,14 @@ program
 
     const spinner = ora('正在恢复 Claude 桌面应用默认配置...').start();
     const result = clearClaudeDesktopConfig();
+    const codeSettingsResult = clearClaudeDesktopCodeSettings();
 
-    if (result.result === 'updated') {
+    if (result.result === 'updated' || codeSettingsResult.result === 'updated') {
       spinner.succeed(chalk.green('Claude 桌面应用已恢复默认'));
-      const cleared = desktopConfigClearedPaths(result);
+      const cleared = [
+        ...desktopConfigClearedPaths(result),
+        ...(codeSettingsResult.result === 'updated' ? [codeSettingsResult.file] : []),
+      ];
       console.log(boxen(
         chalk.bold('已清除 Claude 桌面应用第三方推理配置：\n\n') +
         cleared.map(f => chalk.cyan('  • ' + f)).join('\n'),
@@ -1291,7 +1344,9 @@ program
 program
   .command('doctor')
   .description('诊断当前环境，列出所有问题和修复建议')
-  .action(async () => {
+  .option('--export [file]', '导出脱敏诊断报告 JSON')
+  .option('--windows', '包含 Windows 专项诊断')
+  .action(async (options) => {
     const chalk = (await import('chalk')).default;
     const ora = (await import('ora')).default;
     const boxen = (await import('boxen')).default;
@@ -1299,7 +1354,7 @@ program
     console.log(await getBanner());
 
     const spinner = ora('运行诊断检查...').start();
-    const checks = await runDoctorChecks();
+    const checks = await runDoctorChecks({ windows: options.windows });
     spinner.stop();
 
     const icons = {
@@ -1332,6 +1387,53 @@ program
         margin: { top: 1, bottom: 1 },
       }
     ));
+
+    if (options.export !== undefined) {
+      const config = loadConfig();
+      const stamp = new Date().toISOString().replace(/[:.]/g, '-');
+      const file = typeof options.export === 'string'
+        ? options.export
+        : `yingclaw-diagnostic-${stamp}.json`;
+      const report = buildDiagnosticReport({
+        packageVersion: pkg.version,
+        config,
+        checks,
+        env: process.env,
+        expectedEnv: config ? buildClaudeEnv(config) : {},
+        desktopCodeStatus: config ? checkClaudeDesktopCodeSettingsEnv(config) : null,
+      });
+      writeDiagnosticReport(file, report);
+      console.log(chalk.green(`诊断报告已导出：${file}`));
+    }
+  });
+
+program
+  .command('support')
+  .description('生成脱敏排障包，便于反馈 Windows / Desktop / Gateway 问题')
+  .option('-o, --output <file>', '输出文件', `yingclaw-support-${new Date().toISOString().replace(/[:.]/g, '-')}.json`)
+  .option('--windows', '包含 Windows 专项诊断')
+  .action(async (options) => {
+    const chalk = (await import('chalk')).default;
+    const ora = (await import('ora')).default;
+
+    console.log(await getBanner());
+
+    const config = loadConfig();
+    const spinner = ora('生成脱敏排障包...').start();
+    const checks = await runDoctorChecks({ windows: options.windows });
+    const gatewayStatus = config ? await checkDesktopGatewayStatus(config, { timeoutMs: 600 }) : null;
+    const bundle = buildSupportBundle({
+      packageVersion: pkg.version,
+      config,
+      checks,
+      env: process.env,
+      expectedEnv: config ? buildClaudeEnv(config) : {},
+      gatewayStatus,
+      desktopCodeStatus: config ? checkClaudeDesktopCodeSettingsEnv(config) : null,
+    });
+    writeDiagnosticReport(options.output, bundle);
+    spinner.succeed(chalk.green(`排障包已生成：${options.output}`));
+    console.log(chalk.dim('已脱敏 API Key / Gateway Key；公开发送前仍建议快速看一眼 Base URL 是否含私有信息。'));
   });
 
 program
@@ -1430,6 +1532,7 @@ async function renderStatusBar(apiStatus, config) {
       claudeInstalled,
       desktopGatewayStatus: await checkDesktopGatewayStatus(config, { timeoutMs: 250 }),
       desktopGatewayAutostartStatus: getGatewayAutostartStatus(),
+      desktopCodeStatus: checkClaudeDesktopCodeSettingsEnv(config),
       env: process.env,
     });
     const statusLines = buildMenuStatusLines(view, { apiStatus, claudeInstalled, platform: process.platform });
@@ -1440,6 +1543,7 @@ async function renderStatusBar(apiStatus, config) {
       if (line.startsWith('快速模型跨系列')) return chalk.yellow(line);
       if (line.startsWith('Desktop Gateway 未运行')) return chalk.yellow(line);
       if (line.startsWith('Desktop Gateway 已运行')) return chalk.green(line);
+      if (line.startsWith('Desktop Code 未配置')) return chalk.yellow(line);
       if (line.startsWith('模型')) return line.replace(view.mainModel, chalk.yellow(view.mainModel)).replace(view.fastModel, chalk.yellow(view.fastModel));
       return line;
     }).join('\n  ');

package/index.js

@@ -4,6 +4,7 @@ module.exports = {
   ...require('./lib/desktop'),
   ...require('./lib/gateway'),
   ...require('./lib/install'),
+  ...require('./lib/google'),
   ...require('./lib/openai'),
   ...require('./lib/panel'),
   ...require('./lib/vscode'),

package/lib/config.js

@@ -3,6 +3,7 @@ const path = require('path');
 const os = require('os');
 const { spawnSync } = require('child_process');
 const { normalizeOpenAiBaseUrl, openAiChatCompletionsUrl } = require('./openai');
+const { googleGenerateContentUrl, normalizeGoogleBaseUrl } = require('./google');
 
 const CONFIG_FILE = path.join(os.homedir(), '.clawai.json');
 const WINDOWS_ENV_LABEL = 'Windows 用户环境变量';
@@ -25,6 +26,7 @@ const VSCODE_CLAUDE_ENV_KEYS = [
 ];
 const LEGACY_CLAUDE_ENV_KEYS = [
   'ANTHROPIC_API_KEY',
+  'CLAUDE_CODE_SIMPLE',
 ];
 const CLEAR_CLAUDE_ENV_KEYS = [...new Set([...CLAUDE_ENV_KEYS, ...VSCODE_CLAUDE_ENV_KEYS, ...LEGACY_CLAUDE_ENV_KEYS])];
 
@@ -181,10 +183,16 @@ const PROVIDERS = {
     protocol: 'openai',
     models: [],
   },
+  custom_google: {
+    name: '自定义 Google 兼容接口',
+    custom: true,
+    protocol: 'google',
+    models: [],
+  },
 };
 
 const PREFERRED_MODEL_IDS = {
-  qwen: ['qwen3-max', 'qwen3-plus', 'qwen3.5-plus'],
+qwen: ['qwen3-max', 'qwen3-plus', 'qwen3.5-plus'],
   minimax: ['MiniMax-M2.7', 'MiniMax-M2.7-Turbo', 'MiniMax-M2.5'],
   glm: ['GLM-4.7', 'GLM-5.1', 'GLM-5-Turbo', 'GLM-4.5-Air'],
   mimo: ['mimo-v2.5-pro', 'mimo-v2.5', 'mimo-v2-flash'],
@@ -250,6 +258,16 @@ function parseModelIdsResponse(providerKey, data) {
   if (providerKey === 'bai') {
     return normalizeModelIds(providerKey, ids.filter(id => !id.includes('/')));
   }
+  if (providerKey === 'custom_google') {
+    const chatList = list.filter((m) =>
+      !Array.isArray(m.supportedGenerationMethods) || m.supportedGenerationMethods.includes('generateContent'),
+    );
+    const googleIds = chatList
+      .map((m) => (m.id || m.model || m.name || '').replace(/^models\//, ''))
+      .filter(Boolean)
+      .filter(isChatModelId);
+    return normalizeModelIds(providerKey, googleIds);
+  }
   return normalizeModelIds(providerKey, ids);
 }
 
@@ -288,6 +306,14 @@ function buildModelUrlCandidates(baseUrl) {
     add(`${withoutAnthropic}/v1/models`);
   }
 
+  // Google Gemini: /v1beta/models
+  const v1betaIdx = pathname.indexOf('/v1beta');
+  if (v1betaIdx !== -1) {
+    add(`${pathname.slice(0, v1betaIdx + '/v1beta'.length)}/models`);
+  } else {
+    add(`${pathname}/v1beta/models`);
+  }
+
   add('/v1/models');
 
   return [...new Set(candidates)];
@@ -391,8 +417,12 @@ function getProviderProtocol(config = {}) {
 }
 
 function buildProviderAuthHeaders(providerKey, apiKey) {
+  const protocol = getProviderProtocol({ provider: providerKey });
+  if (protocol === 'google') {
+    return { 'x-goog-api-key': apiKey };
+  }
   const headers = { authorization: `Bearer ${apiKey}` };
-  if (getProviderProtocol({ provider: providerKey }) !== 'openai') {
+  if (protocol !== 'openai') {
     headers['api-key'] = apiKey; // MiMo 用这个 header
   }
   return headers;
@@ -430,7 +460,8 @@ function buildGatewayBaseUrlForEnv(config) {
 function buildClaudeEnv(config) {
   const { provider, baseUrl, apiKey, model, fastModel } = config;
   const resolvedFastModel = fastModel || resolveFastModel(PROVIDERS[provider], model);
-  const useLocalGateway = getProviderProtocol(config) === 'openai' && config.desktopGatewayKey;
+  const protocol = getProviderProtocol(config);
+  const useLocalGateway = (protocol === 'openai' || protocol === 'google') && config.desktopGatewayKey;
   return {
     ANTHROPIC_BASE_URL: useLocalGateway ? buildGatewayBaseUrlForEnv(config) : baseUrl,
     ANTHROPIC_AUTH_TOKEN: useLocalGateway ? config.desktopGatewayKey : apiKey,
@@ -478,9 +509,13 @@ async function validateKey(config, options = {}) {
   const protocol = getProviderProtocol(config);
   let url;
   try {
-    url = protocol === 'openai'
-      ? openAiChatCompletionsUrl(config.baseUrl)
-      : `${normalizeAnthropicBaseUrl(config.baseUrl)}/v1/messages`;
+    if (protocol === 'openai') {
+      url = openAiChatCompletionsUrl(config.baseUrl);
+    } else if (protocol === 'google') {
+      url = googleGenerateContentUrl(config.baseUrl, config.model, false);
+    } else {
+      url = `${normalizeAnthropicBaseUrl(config.baseUrl)}/v1/messages`;
+    }
     new URL(url);
   } catch {
     return null;
@@ -497,11 +532,9 @@ async function validateKey(config, options = {}) {
         ...buildProviderAuthHeaders(config.provider, config.apiKey),
         ...(protocol === 'anthropic' ? { 'x-api-key': config.apiKey, 'anthropic-version': '2023-06-01' } : {}),
       },
-      body: JSON.stringify({
-        model: config.model,
-        max_tokens: 16,
-        messages: [{ role: 'user', content: 'hi' }],
-      }),
+      body: JSON.stringify(protocol === 'google'
+        ? { contents: [{ role: 'user', parts: [{ text: 'hi' }] }], generationConfig: { maxOutputTokens: 16 } }
+        : { model: config.model, max_tokens: 16, messages: [{ role: 'user', content: 'hi' }] }),
     });
     return classifyValidationStatus(res.status);
   } catch {