yingclaw 2.5.1 → 2.5.3

package/README.md

@@ -47,8 +47,11 @@ claw code
 接入 Claude 桌面应用：
 ```bash
 claw desktop
+claw gateway
 ```
-将配置写入 Claude Desktop 第三方推理本地配置。macOS 会自动重启 Claude Desktop；Windows 需手动重新打开。
+`claw desktop` 会把 Claude Desktop 指向 yingclaw 本机 Gateway，并只暴露 `claude-sonnet-4-6`、`claude-opus-4-7`、`claude-haiku-4-5` 这类 Claude Desktop 可接受的模型名。真实第三方模型仍按 `claw config` 保存的主模型和快速模型转发。
+
+使用 Claude Desktop 时需要保持 `claw gateway` 运行。
 
 ## 支持的厂商
 
@@ -71,6 +74,8 @@ claw                 # 交互菜单（无参数时自动进入）
 claw config          # 配置 API 连接
 claw code            # 接入 Claude Code 终端
 claw desktop         # 接入 Claude 桌面应用
+claw gateway         # 启动 Claude 桌面应用本机 Gateway
+claw desktop --direct # 高级：直连写入厂商 Gateway URL
 claw switch          # 快速切换厂商或模型
 claw status          # 查看当前配置，验证 Key 是否有效
 claw update          # 检查并升级到最新版本
@@ -105,12 +110,14 @@ CLAUDE_CODE_SUBAGENT_MODEL
 CLAUDE_CODE_EFFORT_LEVEL
 ```
 
-**桌面接入**（`claw desktop`）写入 Claude Desktop 第三方推理配置：
+**桌面接入**（`claw desktop`）默认写入本机 Gateway：
 
-- macOS：`~/Library/Application Support/Claude-3p/configLibrary/`
-- Windows：`%APPDATA%\Claude-3p\configLibrary\`
+- macOS / Windows：写入 `Claude-3p/configLibrary/` 中的 yingclaw entry
+- Claude Desktop 访问 `http://127.0.0.1:18080/yingclaw`
+- Gateway 再转发到当前保存的 Anthropic 兼容接口
+- 终端接入仍直接使用 `ANTHROPIC_*` 环境变量，不受桌面 Gateway 影响
 
-使用 `inferenceProvider=gateway`、`inferenceGatewayAuthScheme=bearer`，将 Gateway Base URL 指向对应厂商的 Anthropic 兼容接口。桌面接入要求 Base URL 使用 HTTPS。
+使用 `inferenceProvider=gateway`、`inferenceGatewayAuthScheme=bearer`，将 Gateway Base URL 指向 yingclaw 本机 Gateway。高级用户可用 `claw desktop --direct` 保留旧式直连写入，但新版 Claude Desktop 可能拒绝非 Claude 模型名。
 
 **自定义接口**需支持 Anthropic `/v1/messages` 格式；工具会根据 Base URL 自动尝试获取模型列表，失败则手动输入。
 

package/bin/cli.js

@@ -23,6 +23,14 @@ const pkg = require('../package.json');
 const { buildMenuStatusLines, buildStatusView } = require('../lib/panel');
 const { buildClaudeInstallCommand, checkNodeEnv, getNodeInstallGuide, getInstallFailureHints } = require('../lib/install');
 const { clearClaudeDesktopConfig, isDesktopConfigured, openClaudeDesktop, writeClaudeDesktopConfig } = require('../lib/desktop');
+const {
+  DEFAULT_DESKTOP_GATEWAY_PORT,
+  YINGCLAW_GATEWAY_PREFIX,
+  buildDesktopGatewayMappingRows,
+  checkDesktopGatewayStatus,
+  createGatewayServer,
+  ensureDesktopGatewayConfig,
+} = require('../lib/gateway');
 const { runDoctorChecks, summarize, STATUS_OK, STATUS_FAIL, STATUS_WARN, STATUS_INFO } = require('../lib/doctor');
 
 const program = new Command();
@@ -232,6 +240,7 @@ async function showStatus() {
   const view = buildStatusView(config, {
     apiStatus: valid,
     claudeInstalled: isClaudeInstalled(),
+    desktopGatewayStatus: await checkDesktopGatewayStatus(config),
     env: process.env,
   });
 
@@ -242,7 +251,9 @@ async function showStatus() {
         ? chalk.yellow(value)
         : label === 'Base URL'
           ? chalk.cyan(value)
-          : label === '当前终端' && value === '未生效'
+        : label === 'Desktop Gateway'
+          ? value.includes('已运行') ? chalk.green(value) : chalk.yellow(value)
+        : label === '当前终端' && value === '未生效'
             ? chalk.yellow(value)
             : value;
     return `${chalk.dim(label + ':')} ${coloredValue}`;
@@ -662,10 +673,54 @@ program
   .description('查看当前配置和 Key 有效性')
   .action(showStatus);
 
+program
+  .command('gateway')
+  .description('启动 Claude 桌面应用本机 Gateway')
+  .option('-p, --port <port>', '监听端口')
+  .action(async (options) => {
+    const chalk = (await import('chalk')).default;
+    const boxen = (await import('boxen')).default;
+
+    let config = loadConfig();
+    if (!config) {
+      console.log(chalk.red('\n未配置 API 连接，请先运行: claw config\n'));
+      return;
+    }
+    const configProblem = getConfigValidationMessage(config);
+    if (configProblem) {
+      console.log(chalk.red(`\n配置无效：${configProblem}`));
+      console.log(chalk.dim('请运行 claw config 重新配置。\n'));
+      return;
+    }
+
+    const ensuredConfig = ensureDesktopGatewayConfig(config);
+    if (ensuredConfig.desktopGatewayKey !== config.desktopGatewayKey || ensuredConfig.desktopGatewayPort !== config.desktopGatewayPort) {
+      saveConfig(ensuredConfig);
+      config = ensuredConfig;
+    }
+
+    const port = Number.parseInt(options.port || config.desktopGatewayPort || DEFAULT_DESKTOP_GATEWAY_PORT, 10);
+    const server = createGatewayServer();
+    server.listen(port, '127.0.0.1', () => {
+      console.log(boxen(
+        chalk.bold('yingclaw Desktop Gateway 已启动\n\n') +
+        chalk.dim('URL   ') + chalk.cyan(`http://127.0.0.1:${port}${YINGCLAW_GATEWAY_PREFIX}`) + '\n' +
+        chalk.dim('模型  ') + chalk.yellow(config.model) + '\n\n' +
+        chalk.dim('保持此终端打开，Claude Desktop 才能访问第三方模型。'),
+        { padding: { top: 0, bottom: 0, left: 2, right: 2 }, borderStyle: 'round', borderColor: 'green', margin: { top: 1, bottom: 1 } }
+      ));
+    });
+    server.on('error', (error) => {
+      console.error(chalk.red(`Gateway 启动失败: ${error.message}`));
+      process.exitCode = 1;
+    });
+  });
+
 program
   .command('desktop')
   .description('接入 Claude 桌面应用使用当前模型')
-  .action(async () => {
+  .option('--direct', '高级：直接写入当前厂商 Gateway URL，不启用本机模型映射')
+  .action(async (options) => {
     const chalk = (await import('chalk')).default;
     const ora = (await import('ora')).default;
     const boxen = (await import('boxen')).default;
@@ -689,10 +744,18 @@ program
       return;
     }
 
+    let desktopConfig = config;
+    if (!options.direct) {
+      desktopConfig = ensureDesktopGatewayConfig(config);
+      if (desktopConfig.desktopGatewayKey !== config.desktopGatewayKey || desktopConfig.desktopGatewayPort !== config.desktopGatewayPort) {
+        saveConfig(desktopConfig);
+      }
+    }
+
     const spinner = ora('写入 Claude 桌面应用配置...').start();
     let result;
     try {
-      result = writeClaudeDesktopConfig(config);
+      result = writeClaudeDesktopConfig(desktopConfig, { direct: options.direct });
       if (result.result === 'unsupported') {
         spinner.warn(chalk.yellow('当前系统暂不支持自动配置 Claude 桌面应用'));
         return;
@@ -703,13 +766,25 @@ program
       return;
     }
 
+    const gatewayUrl = `http://127.0.0.1:${desktopConfig.desktopGatewayPort}${YINGCLAW_GATEWAY_PREFIX}`;
+    const modeLines = options.direct
+      ? chalk.dim('Base URL  ') + chalk.cyan(desktopConfig.baseUrl) + '\n' +
+        chalk.dim('模型      ') + chalk.yellow(desktopConfig.model) + '\n' +
+        chalk.yellow('直连模式可能被新版 Claude Desktop 拒绝非 Claude 模型名。')
+      : chalk.dim('Gateway  ') + chalk.cyan(gatewayUrl) + '\n' +
+        chalk.dim('主模型    ') + chalk.yellow(desktopConfig.model) + '\n' +
+        chalk.dim('快速模型  ') + chalk.yellow(desktopConfig.fastModel || desktopConfig.model) + '\n' +
+        chalk.dim('菜单映射  ') + buildDesktopGatewayMappingRows(desktopConfig)
+          .map((row) => `${chalk.white(row.desktopLabel)} ${chalk.dim('→')} ${chalk.yellow(row.upstreamModel)}`)
+          .join('\n' + chalk.dim('          ')) + '\n\n' +
+        chalk.cyan('使用前请运行: claw gateway');
+
     console.log(boxen(
-      chalk.bold('Claude 桌面应用已配置为 Gateway 模式\n\n') +
-      chalk.dim('Base URL  ') + chalk.cyan(config.baseUrl) + '\n' +
-      chalk.dim('模型      ') + chalk.yellow(config.model) + '\n' +
+      chalk.bold(options.direct ? 'Claude 桌面应用已配置为直连 Gateway 模式\n\n' : 'Claude 桌面应用已配置为本机 Gateway 模式\n\n') +
+      modeLines + '\n' +
       chalk.dim('认证方式  ') + chalk.cyan('bearer') + '\n\n' +
       chalk.yellow(getDesktopOpenHint()) + '\n' +
-      chalk.dim('要求：网关必须支持 Anthropic POST /v1/messages，且 Base URL 必须是 HTTPS。'),
+      chalk.dim(options.direct ? '要求：网关必须支持 Anthropic POST /v1/messages，且 Base URL 必须是 HTTPS。' : '要求：保持 claw gateway 运行，Claude Desktop 才能访问第三方模型。'),
       { padding: { top: 0, bottom: 0, left: 2, right: 2 }, borderStyle: 'round', borderColor: 'cyan', margin: { top: 1, bottom: 1 } }
     ));
 
@@ -965,6 +1040,7 @@ async function renderStatusBar(apiStatus) {
     const view = buildStatusView(config, {
       apiStatus,
       claudeInstalled,
+      desktopGatewayStatus: await checkDesktopGatewayStatus(config, { timeoutMs: 250 }),
       env: process.env,
     });
     const statusLines = buildMenuStatusLines(view, { apiStatus, claudeInstalled, platform: process.platform });
@@ -972,6 +1048,8 @@ async function renderStatusBar(apiStatus) {
       if (index === 0) return line.replace('API 正常', chalk.green('API 正常')).replace('API Key 无效', chalk.red('API Key 无效')).replace('网络/服务异常', chalk.yellow('网络/服务异常'));
       if (line.startsWith('环境变量未生效')) return chalk.yellow(line);
       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('主模型')) return line.replace(view.mainModel, chalk.yellow(view.mainModel)).replace(view.fastModel, chalk.yellow(view.fastModel));
       return line;
     }).join('\n  ');

package/index.js

@@ -1,6 +1,7 @@
 module.exports = {
   ...require('./lib/config'),
   ...require('./lib/desktop'),
+  ...require('./lib/gateway'),
   ...require('./lib/install'),
   ...require('./lib/panel'),
 };

package/lib/desktop.js

@@ -4,9 +4,15 @@ const os = require('os');
 const path = require('path');
 const { spawnSync } = require('child_process');
 const { normalizeAnthropicBaseUrl } = require('./config');
+const {
+  YINGCLAW_GATEWAY_PREFIX,
+  buildDesktopGatewayRoutes,
+  ensureDesktopGatewayConfig,
+} = require('./gateway');
 
 const CLAUDE_DESKTOP_LABEL = 'Claude 桌面应用配置';
 const YINGCLAW_ENTRY_NAME = 'yingclaw';
+const MAC_POLICY_BUNDLE = 'com.anthropic.claudefordesktop';
 const DESKTOP_GATEWAY_KEYS = [
   'inferenceProvider',
   'inferenceGatewayBaseUrl',
@@ -17,6 +23,15 @@ const DESKTOP_GATEWAY_KEYS = [
   'deploymentOrganizationUuid',
 ];
 
+function buildRuntimeEnterpriseConfig(entry) {
+  return {
+    ...entry,
+    inferenceGatewayHeaders: [],
+    isClaudeCodeForDesktopEnabled: true,
+    coworkEgressAllowedHosts: ['*'],
+  };
+}
+
 // Claude Desktop 主进程从 Claude-3p/ 目录读取 deploymentMode 和 enterpriseConfig
 function getClaudeDesktopDataDir(options = {}) {
   const platform = options.platform || process.platform;
@@ -60,16 +75,66 @@ function toDesktopModelId(model) {
   return model.startsWith('claude-') ? model : `claude-${model}`;
 }
 
-function collectModels(config) {
+function collectDirectModels(config) {
   const list = Array.isArray(config.availableModels) && config.availableModels.length > 0
     ? [config.model, config.fastModel, ...config.availableModels]
     : [config.model, config.fastModel];
   return [...new Set(list.filter(Boolean).map(toDesktopModelId))];
 }
 
-// 按官方 schema：所有值必须是字符串（包括布尔、数组都序列化）
+function buildGatewayBaseUrl(config) {
+  const port = config.desktopGatewayPort || 18080;
+  return `http://127.0.0.1:${port}${YINGCLAW_GATEWAY_PREFIX}`;
+}
+
+function serializeGatewayModels(config) {
+  return buildDesktopGatewayRoutes(config).map((route) => {
+    const item = { name: route.id, displayName: route.displayName };
+    if (route.supports1m) item.supports1m = true;
+    return item;
+  });
+}
+
+function buildClaudeDesktopMacDefaultsCommands(entry) {
+  const runtime = buildRuntimeEnterpriseConfig(entry);
+  return [
+    { command: 'defaults', args: ['write', MAC_POLICY_BUNDLE, 'inferenceProvider', '-string', runtime.inferenceProvider] },
+    { command: 'defaults', args: ['write', MAC_POLICY_BUNDLE, 'inferenceGatewayBaseUrl', '-string', runtime.inferenceGatewayBaseUrl] },
+    { command: 'defaults', args: ['write', MAC_POLICY_BUNDLE, 'inferenceGatewayApiKey', '-string', runtime.inferenceGatewayApiKey] },
+    { command: 'defaults', args: ['write', MAC_POLICY_BUNDLE, 'inferenceGatewayAuthScheme', '-string', runtime.inferenceGatewayAuthScheme] },
+    { command: 'defaults', args: ['write', MAC_POLICY_BUNDLE, 'inferenceGatewayHeaders', '-string', JSON.stringify(runtime.inferenceGatewayHeaders)] },
+    { command: 'defaults', args: ['write', MAC_POLICY_BUNDLE, 'inferenceModels', '-string', JSON.stringify(runtime.inferenceModels)] },
+    { command: 'defaults', args: ['write', MAC_POLICY_BUNDLE, 'isClaudeCodeForDesktopEnabled', '-int', '1'] },
+    { command: 'defaults', args: ['write', MAC_POLICY_BUNDLE, 'coworkEgressAllowedHosts', '-string', JSON.stringify(runtime.coworkEgressAllowedHosts)] },
+  ];
+}
+
+function writeClaudeDesktopMacDefaults(entry) {
+  for (const { command, args } of buildClaudeDesktopMacDefaultsCommands(entry)) {
+    const result = spawnSync(command, args, { encoding: 'utf8' });
+    if (result.status !== 0) {
+      throw new Error(`macOS policy 写入失败: ${args[2] || command}`);
+    }
+  }
+}
+
 function buildClaudeDesktopEnterpriseConfig(config, options = {}) {
-  const models = collectModels(config);
+  const gatewayConfig = ensureDesktopGatewayConfig(config, options);
+  const models = serializeGatewayModels(gatewayConfig);
+  return {
+    inferenceProvider: 'gateway',
+    inferenceGatewayBaseUrl: buildGatewayBaseUrl(gatewayConfig),
+    inferenceGatewayApiKey: gatewayConfig.desktopGatewayKey,
+    inferenceGatewayAuthScheme: options.authScheme || 'bearer',
+    inferenceModels: JSON.stringify(models),
+    disableDeploymentModeChooser: 'true',
+    deploymentOrganizationUuid: options.uuid || crypto.randomUUID(),
+  };
+}
+
+// 兼容旧版直连模式：写入真实 provider Gateway URL 和真实 Key。
+function buildClaudeDesktopDirectEnterpriseConfig(config, options = {}) {
+  const models = collectDirectModels(config);
   const baseUrl = normalizeAnthropicBaseUrl(config.baseUrl);
   if (!baseUrl.startsWith('https://')) {
     throw new Error('Claude 桌面应用要求 Gateway Base URL 使用 HTTPS');
@@ -131,10 +196,9 @@ function clearClaudeDesktopConfigLibrary(options = {}) {
 
 // 写入 Claude-3p/configLibrary/ 下的 enterprise config 条目（主进程从此处读取）
 function writeClaudeDesktopConfig(config, options = {}) {
-  const baseUrl = normalizeAnthropicBaseUrl(config.baseUrl);
-  if (!baseUrl.startsWith('https://')) {
-    throw new Error('Claude 桌面应用要求 Gateway Base URL 使用 HTTPS');
-  }
+  const effectiveConfig = options.direct
+    ? config
+    : ensureDesktopGatewayConfig(config, options);
 
   const dataDir = options.dataDir || getClaudeDesktopDataDir(options);
   if (!dataDir) {
@@ -149,17 +213,23 @@ function writeClaudeDesktopConfig(config, options = {}) {
   const existingYingclaw = existingEntries.find((entry) => entry && entry.name === YINGCLAW_ENTRY_NAME);
   const uuid = existingYingclaw?.id || options.uuid || crypto.randomUUID();
 
-  const models = collectModels(config);
+  const models = options.direct
+    ? collectDirectModels(effectiveConfig)
+    : serializeGatewayModels(effectiveConfig);
+  const enterprise = options.direct
+    ? buildClaudeDesktopDirectEnterpriseConfig(effectiveConfig, { ...options, uuid })
+    : buildClaudeDesktopEnterpriseConfig(effectiveConfig, { ...options, uuid });
 
   const entry = {
-    inferenceProvider: 'gateway',
-    inferenceGatewayBaseUrl: baseUrl,
-    inferenceGatewayApiKey: config.apiKey,
-    inferenceGatewayAuthScheme: options.authScheme || 'bearer',
+    inferenceProvider: enterprise.inferenceProvider,
+    inferenceGatewayBaseUrl: enterprise.inferenceGatewayBaseUrl,
+    inferenceGatewayApiKey: enterprise.inferenceGatewayApiKey,
+    inferenceGatewayAuthScheme: enterprise.inferenceGatewayAuthScheme,
     inferenceModels: models,
     disableDeploymentModeChooser: true,
     deploymentOrganizationUuid: uuid,
   };
+  const runtimeEntry = buildRuntimeEnterpriseConfig(entry);
 
   const otherEntries = existingEntries.filter((entry) => entry && entry.name !== YINGCLAW_ENTRY_NAME);
   const meta = {
@@ -180,11 +250,29 @@ function writeClaudeDesktopConfig(config, options = {}) {
 
   const file = options.configFile || path.join(dataDir, 'claude_desktop_config.json');
   const current = readJsonFile(file);
-  const next = { ...current, deploymentMode: '3p' };
+  const currentEnterprise = current.enterpriseConfig && typeof current.enterpriseConfig === 'object'
+    ? current.enterpriseConfig
+    : {};
+  const next = {
+    ...current,
+    deploymentMode: '3p',
+    enterpriseConfig: {
+      ...currentEnterprise,
+      ...runtimeEntry,
+    },
+  };
   fs.mkdirSync(path.dirname(file), { recursive: true });
   fs.writeFileSync(file, JSON.stringify(next, null, 2) + '\n');
 
-  return { result: beforeEntry === entryBody ? 'unchanged' : 'updated', file };
+  const shouldWritePlatformPolicy = (options.platform || process.platform) === 'darwin'
+    && !options.dataDir
+    && !options.configFile
+    && options.writePlatformPolicy !== false;
+  if (shouldWritePlatformPolicy) {
+    writeClaudeDesktopMacDefaults(entry);
+  }
+
+  return { result: beforeEntry === entryBody ? 'unchanged' : 'updated', file, config: effectiveConfig };
 }
 
 function clearClaudeDesktopConfig(options = {}) {
@@ -293,8 +381,11 @@ async function openClaudeDesktop(options = {}) {
 
 module.exports = {
   buildClaudeDesktopEnterpriseConfig,
+  buildClaudeDesktopDirectEnterpriseConfig,
+  buildClaudeDesktopMacDefaultsCommands,
   buildClaudeDesktopOpenCommands,
   clearClaudeDesktopConfig,
+  getClaudeDesktopConfigLibraryDir,
   getClaudeDesktopConfigPath,
   getClaudeDesktopDataDir,
   isDesktopConfigured,

package/lib/gateway.js

@@ -0,0 +1,275 @@
+const crypto = require('crypto');
+const http = require('http');
+const { loadConfig: defaultLoadConfig, normalizeAnthropicBaseUrl } = require('./config');
+
+const DEFAULT_DESKTOP_GATEWAY_PORT = 18080;
+const YINGCLAW_GATEWAY_PREFIX = '/yingclaw';
+const DESKTOP_ROUTE_SPECS = [
+  { id: 'claude-sonnet-4-6', displayName: 'Sonnet', upstreamKey: 'model' },
+  { id: 'claude-haiku-4-5', displayName: 'Haiku', upstreamKey: 'fastModel' },
+];
+const ONE_M_CONTEXT_SUFFIX = ' [1M]';
+
+function createGatewayKey() {
+  return `ygw-${crypto.randomUUID()}`;
+}
+
+function ensureDesktopGatewayConfig(config, options = {}) {
+  const keyFactory = options.keyFactory || createGatewayKey;
+  return {
+    ...config,
+    desktopGatewayPort: config.desktopGatewayPort || DEFAULT_DESKTOP_GATEWAY_PORT,
+    desktopGatewayKey: config.desktopGatewayKey || keyFactory(),
+  };
+}
+
+function modelSupports1m(model) {
+  return /\[1m\]/i.test(String(model || ''));
+}
+
+function stripOneMContextSuffix(model) {
+  const value = String(model || '').trim();
+  return value.replace(/\s*\[1m\]\s*$/i, '');
+}
+
+function desktopRouteId(routeId, supports1m) {
+  const base = stripOneMContextSuffix(routeId);
+  return supports1m ? `${base}${ONE_M_CONTEXT_SUFFIX}` : base;
+}
+
+function desktopRouteLabel(routeId) {
+  const raw = String(routeId || '').trim();
+  const is1m = /\[1m\]\s*$/i.test(raw);
+  const base = stripOneMContextSuffix(raw).replace(/^anthropic\//i, '').replace(/^claude-/i, '');
+  const parts = base.split('-').filter(Boolean);
+  const family = parts.shift() || base;
+  const version = parts.join('.');
+  const label = `${family.charAt(0).toUpperCase()}${family.slice(1)}${version ? ` ${version}` : ''}`;
+  return is1m ? `${label} 1M` : label;
+}
+
+function buildDesktopGatewayRoutes(config) {
+  const fastModel = config.fastModel || config.model;
+  const source = { model: config.model, fastModel };
+  return DESKTOP_ROUTE_SPECS
+    .map((spec) => {
+      const upstreamModel = source[spec.upstreamKey];
+      const supports1m = modelSupports1m(upstreamModel);
+      return upstreamModel ? {
+        id: desktopRouteId(spec.id, supports1m),
+        displayName: spec.displayName,
+        upstreamModel,
+        supports1m,
+      } : null;
+    })
+    .filter(Boolean);
+}
+
+function buildDesktopGatewayMappingRows(config) {
+  return buildDesktopGatewayRoutes(config).map((route) => ({
+    routeId: route.id,
+    desktopLabel: desktopRouteLabel(route.id),
+    upstreamModel: route.upstreamModel,
+  }));
+}
+
+function mapDesktopRouteToUpstream(config, routeId) {
+  const requested = stripOneMContextSuffix(routeId);
+  const route = buildDesktopGatewayRoutes(config).find((item) => stripOneMContextSuffix(item.id) === requested);
+  if (!route) {
+    throw new Error(`未配置的 Claude Desktop 模型路由: ${routeId}`);
+  }
+  return route.upstreamModel;
+}
+
+function buildGatewayModelsResponse(config) {
+  const data = buildDesktopGatewayRoutes(config).map((route) => {
+    const item = {
+      type: 'model',
+      id: route.id,
+      display_name: route.displayName,
+      created_at: '2024-01-01T00:00:00Z',
+    };
+    if (route.supports1m) item.supports1m = true;
+    return item;
+  });
+  return {
+    data,
+    has_more: false,
+    first_id: data[0]?.id || null,
+    last_id: data.at(-1)?.id || null,
+  };
+}
+
+function sendJson(res, status, body) {
+  res.writeHead(status, { 'content-type': 'application/json' });
+  res.end(JSON.stringify(body));
+}
+
+function readRequestBody(req) {
+  return new Promise((resolve, reject) => {
+    let raw = '';
+    req.setEncoding('utf8');
+    req.on('data', chunk => { raw += chunk; });
+    req.on('end', () => resolve(raw));
+    req.on('error', reject);
+  });
+}
+
+function isAuthorized(req, config) {
+  const key = config.desktopGatewayKey;
+  if (!key) return false;
+  const auth = String(req.headers.authorization || '');
+  const bearer = auth.replace(/^bearer\s+/i, '').trim();
+  const apiKey = String(req.headers['x-api-key'] || '').trim();
+  return bearer === key || apiKey === key;
+}
+
+function providerMessagesUrl(config) {
+  return `${normalizeAnthropicBaseUrl(config.baseUrl)}/v1/messages`;
+}
+
+function buildDesktopGatewayUrl(config = {}) {
+  const port = Number.parseInt(config.desktopGatewayPort || DEFAULT_DESKTOP_GATEWAY_PORT, 10);
+  return {
+    port,
+    url: `http://127.0.0.1:${port}${YINGCLAW_GATEWAY_PREFIX}`,
+  };
+}
+
+async function checkDesktopGatewayStatus(config = {}, options = {}) {
+  const { port, url } = buildDesktopGatewayUrl(config);
+  const fetchImpl = options.fetch || fetch;
+  const configured = !!config.desktopGatewayKey;
+
+  if (!configured) {
+    return { configured: false, running: false, port, url, error: null };
+  }
+
+  try {
+    const response = await fetchImpl(`${url}/health`, {
+      signal: AbortSignal.timeout(options.timeoutMs || 800),
+    });
+    return {
+      configured: true,
+      running: response.ok,
+      port,
+      url,
+      error: response.ok ? null : `HTTP ${response.status}`,
+    };
+  } catch (error) {
+    return {
+      configured: true,
+      running: false,
+      port,
+      url,
+      error: error.message,
+    };
+  }
+}
+
+async function proxyMessages(req, res, config) {
+  const raw = await readRequestBody(req);
+  let body;
+  try {
+    body = raw ? JSON.parse(raw) : {};
+  } catch {
+    sendJson(res, 400, { error: { message: '请求体不是有效 JSON' } });
+    return;
+  }
+
+  try {
+    body.model = mapDesktopRouteToUpstream(config, body.model);
+  } catch (error) {
+    sendJson(res, 400, { error: { message: error.message } });
+    return;
+  }
+
+  const upstream = await fetch(providerMessagesUrl(config), {
+    method: 'POST',
+    headers: {
+      'content-type': 'application/json',
+      accept: body.stream ? 'text/event-stream' : 'application/json',
+      authorization: `Bearer ${config.apiKey}`,
+      'x-api-key': config.apiKey,
+      'anthropic-version': '2023-06-01',
+    },
+    body: JSON.stringify(body),
+  });
+
+  res.writeHead(upstream.status, {
+    'content-type': upstream.headers.get('content-type') || (body.stream ? 'text/event-stream' : 'application/json'),
+    'cache-control': upstream.headers.get('cache-control') || 'no-cache',
+  });
+
+  if (!upstream.body) {
+    res.end();
+    return;
+  }
+  for await (const chunk of upstream.body) {
+    res.write(chunk);
+  }
+  res.end();
+}
+
+function createGatewayServer(options = {}) {
+  const loadConfig = options.loadConfig || defaultLoadConfig;
+  return http.createServer(async (req, res) => {
+    try {
+      const url = new URL(req.url, 'http://127.0.0.1');
+      const config = loadConfig();
+
+      if (url.pathname === `${YINGCLAW_GATEWAY_PREFIX}/health`) {
+        sendJson(res, 200, { status: 'ok' });
+        return;
+      }
+
+      if (!config) {
+        sendJson(res, 503, { error: { message: 'yingclaw 尚未配置 API 连接' } });
+        return;
+      }
+
+      if (url.pathname === `${YINGCLAW_GATEWAY_PREFIX}/v1/models` && req.method === 'GET') {
+        if (!isAuthorized(req, config)) {
+          sendJson(res, 401, { error: { message: 'Invalid gateway API key' } });
+          return;
+        }
+        sendJson(res, 200, buildGatewayModelsResponse(config));
+        return;
+      }
+
+      if (url.pathname === `${YINGCLAW_GATEWAY_PREFIX}/v1/messages` && req.method === 'POST') {
+        if (!isAuthorized(req, config)) {
+          sendJson(res, 401, { error: { message: 'Invalid gateway API key' } });
+          return;
+        }
+        await proxyMessages(req, res, config);
+        return;
+      }
+
+      sendJson(res, 404, { error: { message: 'Not found' } });
+    } catch (error) {
+      sendJson(res, 500, { error: { message: error.message } });
+    }
+  });
+}
+
+module.exports = {
+  DEFAULT_DESKTOP_GATEWAY_PORT,
+  YINGCLAW_GATEWAY_PREFIX,
+  DESKTOP_ROUTE_SPECS,
+  ONE_M_CONTEXT_SUFFIX,
+  createGatewayKey,
+  ensureDesktopGatewayConfig,
+  modelSupports1m,
+  stripOneMContextSuffix,
+  desktopRouteId,
+  desktopRouteLabel,
+  buildDesktopGatewayRoutes,
+  buildDesktopGatewayMappingRows,
+  mapDesktopRouteToUpstream,
+  buildGatewayModelsResponse,
+  buildDesktopGatewayUrl,
+  checkDesktopGatewayStatus,
+  createGatewayServer,
+};

package/lib/panel.js

@@ -12,6 +12,13 @@ function isEnvActive(config, env) {
   return Object.entries(expected).every(([key, value]) => env[key] === value);
 }
 
+function desktopGatewayStatusText(status) {
+  if (!status) return null;
+  if (!status.configured) return '未配置';
+  if (status.running) return `已运行 · 127.0.0.1:${status.port}`;
+  return '未运行：执行 claw gateway';
+}
+
 function buildStatusView(config, options = {}) {
   const provider = PROVIDERS[config.provider];
   const providerName = config.providerName || provider?.name || config.provider;
@@ -21,6 +28,8 @@ function buildStatusView(config, options = {}) {
   const mainModel = expectedEnv.ANTHROPIC_MODEL;
   const fastModel = expectedEnv.CLAUDE_CODE_SUBAGENT_MODEL;
   const envActive = isEnvActive(config, env);
+  const desktopGatewayStatus = options.desktopGatewayStatus;
+  const desktopGatewayText = desktopGatewayStatusText(desktopGatewayStatus);
   const warnings = [];
 
   if (config.provider === 'deepseek' && (
@@ -31,7 +40,7 @@ function buildStatusView(config, options = {}) {
     warnings.push('检测到旧 DeepSeek 模型名，建议运行 claw switch 更新到 [1m] 长上下文版本');
   }
 
-  return {
+  const view = {
     providerName,
     mainModel,
     fastModel,
@@ -45,9 +54,14 @@ function buildStatusView(config, options = {}) {
       { label: 'API 状态', value: apiStatusText(options.apiStatus) },
       { label: 'Claude Code', value: claudeInstalled ? '已安装' : '未检测到' },
       { label: '当前终端', value: envActive ? '已生效' : '未生效' },
+      ...(desktopGatewayText ? [{ label: 'Desktop Gateway', value: desktopGatewayText }] : []),
       { label: 'Base URL', value: config.baseUrl },
     ],
   };
+  if (desktopGatewayStatus) {
+    view.desktopGatewayStatus = desktopGatewayStatus;
+  }
+  return view;
 }
 
 function buildMenuStatusLines(view, options = {}) {
@@ -66,6 +80,11 @@ function buildMenuStatusLines(view, options = {}) {
 
   lines.push(`主模型 ${view.mainModel} · 快速模型 ${view.fastModel}`);
 
+  const desktopGatewayText = desktopGatewayStatusText(view.desktopGatewayStatus || options.desktopGatewayStatus);
+  if (desktopGatewayText && desktopGatewayText !== '未配置') {
+    lines.push(`Desktop Gateway ${desktopGatewayText}`);
+  }
+
   if (view.warnings.some((warning) => warning.includes('旧 DeepSeek 模型名'))) {
     lines.push('旧模型名：选择下方"切换厂商或模型"更新到 [1m]');
   }
@@ -73,4 +92,4 @@ function buildMenuStatusLines(view, options = {}) {
   return lines;
 }
 
-module.exports = { buildMenuStatusLines, buildStatusView, apiStatusText, isEnvActive };
+module.exports = { buildMenuStatusLines, buildStatusView, apiStatusText, desktopGatewayStatusText, isEnvActive };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "yingclaw",
-  "version": "2.5.1",
+  "version": "2.5.3",
   "description": "Claude Code × 国产大模型一键接入：DeepSeek、Kimi、Qwen、MiniMax、GLM、MiMo",
   "main": "index.js",
   "bin": {