yingclaw 2.1.0 → 2.1.3

package/README.md

@@ -10,11 +10,17 @@ Claude Code × 国产大模型，一键接入。
 npm install -g yingclaw
 ```
 
-安装后会注册一个 `claw` 命令。
+安装后注册 `claw` 命令。
 
-## 使用步骤
+## 快速开始
 
-> 支持 macOS / Linux / Windows / WSL。macOS、Linux、WSL 会写入 zsh/bash 配置文件；Windows 会写入用户级环境变量，重新打开 PowerShell / CMD 后生效。
+```bash
+claw
+```
+
+直接运行 `claw` 进入交互菜单，按步骤操作：安装 Claude Code → 配置 API 连接 → 接入终端或桌面应用。
+
+也可以直接运行子命令：
 
 **第一步：安装 Claude Code**
 ```bash
@@ -26,109 +32,92 @@ claw install-claude
 ```bash
 claw config
 ```
-选择厂商 → 输入 API Key → 选择模型。这个步骤只保存 API 连接，不会修改终端环境变量，也不会修改 Claude 桌面应用配置。
+选择厂商 → 输入 API Key → 选择模型。只保存连接信息，不修改终端环境变量，也不修改 Claude 桌面配置。
 
-**第三步：选择接入目标**
+**第三步：接入**
 
 接入 Claude Code 终端：
 ```bash
 claw code
 ```
-写入 Claude Code 所需的环境变量。配置完成后不会自动启动 Claude Code，需要时可在主菜单选择“启动 Claude Code”或直接运行 `claude`。
+写入 Claude Code 所需的环境变量，之后运行 `claude` 即可。
 
 接入 Claude 桌面应用：
 ```bash
 claw desktop
 ```
-将当前模型配置写入 Claude Desktop 的第三方推理（Cowork on 3P）本地配置。macOS 会自动重启并打开 Claude 桌面应用；Windows 需要手动重新打开。如果配置未生效，请完全退出 Claude Desktop 后重新打开。
+将配置写入 Claude Desktop 第三方推理本地配置。macOS 会自动重启 Claude Desktop；Windows 需手动重新打开。
 
-恢复 Claude Code 终端默认配置：
-```bash
-claw code-reset
-```
-只清除 Claude Code 终端环境变量，不影响 API 连接和 Claude 桌面配置。
+## 支持的厂商
 
-恢复 Claude 桌面应用默认配置：
-```bash
-claw desktop-reset
-```
-只清除 Claude Desktop 第三方推理配置，不影响终端里的 API Key 和模型配置。
+| 厂商 | 主模型 | 快速模型 |
+|------|--------|---------|
+| DeepSeek | deepseek-v4-pro[1m] | deepseek-v4-flash[1m] |
+| Kimi / Moonshot | kimi-k2.5 | kimi-k2.5 |
+| 阿里云百炼 | qwen3-max | qwen3.5-plus |
+| MiniMax | MiniMax-M2.7 | MiniMax-M2.7-Turbo |
+| 智谱 GLM | glm-4.7 | glm-5-turbo |
+| 小米 MiMo | mimo-vl-v2.5-pro | mimo-vl-v2.5-pro |
+| 自定义接口 | 自动获取或手动输入 | — |
+
+DeepSeek 的 `[1m]` 后缀是真实 API 模型 ID，表示 100 万 token 上下文窗口（[官方说明](https://api-docs.deepseek.com/zh-cn/quick_start/agent_integrations/claude_code)）。
+
+## 命令列表
 
-兼容旧命令：
 ```bash
-claw setup
+claw                 # 交互菜单（无参数时自动进入）
+claw config          # 配置 API 连接
+claw code            # 接入 Claude Code 终端
+claw desktop         # 接入 Claude 桌面应用
+claw switch          # 快速切换厂商或模型
+claw status          # 查看当前配置，验证 Key 是否有效
+claw update          # 检查并升级到最新版本
+
+claw code-reset      # 恢复 Claude Code 终端默认配置
+claw desktop-reset   # 恢复 Claude 桌面应用默认配置
+claw reset           # 清除所有 yingclaw 配置
+
+claw install-claude  # 安装 Claude Code
+claw setup           # 兼容旧命令：config + code
 ```
-等价于 `claw config` + `claw code`，用于一键配置 API 并接入 Claude Code 终端。
 
-选择“自定义 Anthropic 兼容接口”时，需要输入：
+## 平台支持
 
-- `ANTHROPIC_BASE_URL`
-- API Key
+| 平台 | 终端接入 | 桌面接入 |
+|------|---------|---------|
+| macOS | ✅ 写入 `~/.zshrc` | ✅ 自动重启 Claude Desktop |
+| Linux / WSL | ✅ 写入 `~/.zshrc` / `~/.bashrc` | — |
+| Windows | ✅ 写入用户级环境变量（需重开终端） | ✅ 写入 `%APPDATA%\Claude-3p\` |
 
-工具会根据 Base URL 自动尝试获取模型列表；如果获取失败，则手动输入主模型和快速模型。
+## 原理
 
-注意：模型列表能获取不代表一定可用于 Claude Code 或 Claude 桌面应用。自定义接口还必须支持 Anthropic `/v1/messages`，否则请求会被网关拒绝。Claude 桌面应用的 Gateway Base URL 还必须使用 HTTPS。
+**终端接入**（`claw code`）写入 shell 配置文件或 Windows 用户环境变量：
 
-**以后直接用**
-```bash
-claude
+```
+ANTHROPIC_BASE_URL
+ANTHROPIC_AUTH_TOKEN / ANTHROPIC_API_KEY
+ANTHROPIC_MODEL
+ANTHROPIC_DEFAULT_OPUS_MODEL / SONNET_MODEL / HAIKU_MODEL
+CLAUDE_CODE_SUBAGENT_MODEL
+CLAUDE_CODE_EFFORT_LEVEL
 ```
 
-## 支持的厂商
+**桌面接入**（`claw desktop`）写入 Claude Desktop 第三方推理配置：
 
-| 厂商 | 模型 |
-|------|------|
-| DeepSeek | V4 Flash、V4 Pro |
-| Kimi / Moonshot | Kimi K2.5 |
-| 阿里云百炼 | Qwen3 Max、Plus、Flash |
-| MiniMax | M2.7、M2.7 Turbo、M2.5 |
-| 智谱 GLM | GLM-4.7、GLM-5.1、GLM-5 Turbo、GLM-4.5 Air |
-| 小米 MiMo | MiMo V2.5 Pro |
-| 自定义接口 | 自动获取或手动输入 |
+- macOS：`~/Library/Application Support/Claude-3p/configLibrary/`
+- Windows：`%APPDATA%\Claude-3p\configLibrary\`
 
-## 其他命令
+使用 `inferenceProvider=gateway`、`inferenceGatewayAuthScheme=bearer`，将 Gateway Base URL 指向对应厂商的 Anthropic 兼容接口。桌面接入要求 Base URL 使用 HTTPS。
 
-```bash
-claw config        # 配置 API 连接，不修改终端或桌面
-claw code          # 接入 Claude Code 终端
-claw code-reset    # 恢复 Claude Code 终端默认配置
-claw switch        # 快速切换模型（只更新 API 连接）
-claw desktop       # 接入 Claude 桌面应用第三方推理
-claw desktop-reset # 恢复 Claude 桌面应用默认配置
-claw setup         # 兼容旧命令：config + code
-claw status        # 查看当前配置，验证 Key 是否有效
-claw reset         # 清除 API 连接、终端环境变量和桌面配置
-```
+**自定义接口**需支持 Anthropic `/v1/messages` 格式；工具会根据 Base URL 自动尝试获取模型列表，失败则手动输入。
 
 ## 卸载
 
 ```bash
 npm uninstall -g yingclaw
+claw reset           # 可选：清除已写入的环境变量和桌面配置
 ```
 
-## 原理
-
-各厂商均原生支持 Anthropic API 格式。`claw config` 只保存 API 连接；`claw code` 才会写入 Claude Code 所需的环境变量。macOS / Linux / WSL 写入 shell 配置文件，Windows 写入用户级环境变量，包括：
-
-- `ANTHROPIC_BASE_URL`
-- `ANTHROPIC_AUTH_TOKEN`
-- `ANTHROPIC_API_KEY`
-- `ANTHROPIC_MODEL`
-- `ANTHROPIC_DEFAULT_OPUS_MODEL`
-- `ANTHROPIC_DEFAULT_SONNET_MODEL`
-- `ANTHROPIC_DEFAULT_HAIKU_MODEL`
-- `CLAUDE_CODE_SUBAGENT_MODEL`
-- `CLAUDE_CODE_EFFORT_LEVEL`
-
-以 DeepSeek 为例，主模型默认使用 `deepseek-v4-pro[1m]`，Haiku/Subagent 快速模型使用 `deepseek-v4-flash`。如果在线模型列表获取失败，会回退到内置默认列表。
-
-`claw desktop` 会额外写入 Claude Desktop 第三方推理配置：
-
-- macOS：`~/Library/Application Support/Claude-3p/claude_desktop_config.json`
-- Windows：`%APPDATA%\Claude-3p\claude_desktop_config.json`
-
-写入的 `enterpriseConfig` 使用 `inferenceProvider=gateway`、`inferenceGatewayAuthScheme=bearer`，并按旧版方式把当前厂商模型写入 `inferenceModels`。如果本机存在新版 `configLibrary` 本地配置，`claw desktop` 会同步移除，避免 Claude 优先读取旧的错误配置。DeepSeek 的 Claude Code 终端模型仍使用 `deepseek-v4-pro[1m]`；Claude 桌面应用会写入 `deepseek-v4-pro` 和 `deepseek-v4-flash`。
-
 ## License
 
 MIT

package/bin/cli.js

@@ -825,6 +825,56 @@ program
     }
   });
 
+program
+  .command('update')
+  .description('检查并更新 yingclaw 到最新版本')
+  .action(async () => {
+    const chalk = (await import('chalk')).default;
+    const ora = (await import('ora')).default;
+    const boxen = (await import('boxen')).default;
+
+    console.log(await getBanner());
+
+    const spinner = ora('检查最新版本...').start();
+    const latest = await checkForUpdate();
+
+    if (!latest) {
+      spinner.warn(chalk.yellow('无法获取版本信息，请检查网络'));
+      return;
+    }
+
+    const current = pkg.version;
+    if (compareVersions(latest, current) <= 0) {
+      spinner.succeed(chalk.green(`已是最新版本 v${current}`));
+      return;
+    }
+
+    spinner.succeed(chalk.green(`发现新版本 v${latest}（当前 v${current}）`));
+
+    const yes = await confirm({ message: `升级到 v${latest}？`, default: true });
+    if (!yes) {
+      console.log(chalk.dim('已取消'));
+      return;
+    }
+
+    const installCmd = buildClaudeInstallCommand('vpn');
+    const upgradeCmd = { command: installCmd.command, args: [...installCmd.args.slice(0, -1), 'yingclaw@latest'] };
+
+    console.log(chalk.dim('\n升级中...\n'));
+    const result = spawnSync(upgradeCmd.command, upgradeCmd.args, { stdio: 'inherit' });
+
+    if (result.status === 0) {
+      console.log(boxen(
+        chalk.bold(`yingclaw 已升级到 v${latest}\n\n`) +
+        chalk.dim('重新运行 ') + chalk.cyan('claw') + chalk.dim(' 使新版本生效'),
+        { padding: { top: 0, bottom: 0, left: 2, right: 2 }, borderStyle: 'round', borderColor: 'green', margin: { top: 1, bottom: 1 } }
+      ));
+    } else {
+      console.log(chalk.red('\n升级失败，请手动运行：'));
+      console.log(chalk.cyan('npm install -g yingclaw@latest'));
+    }
+  });
+
 async function renderStatusBar(apiStatus) {
   const chalk = (await import('chalk')).default;
   const config = loadConfig();
@@ -855,6 +905,30 @@ async function renderStatusBar(apiStatus) {
   return config ? `  ${cfgPart}` : `  ${claudeIcon} ${claudeText}    ${cfgPart}`;
 }
 
+async function checkForUpdate() {
+  try {
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), 5000);
+    const res = await fetch(`https://registry.npmjs.org/yingclaw/latest`, { signal: controller.signal });
+    clearTimeout(timeout);
+    if (!res.ok) return null;
+    const data = await res.json();
+    return data.version || null;
+  } catch {
+    return null;
+  }
+}
+
+function compareVersions(a, b) {
+  const pa = a.split('.').map(Number);
+  const pb = b.split('.').map(Number);
+  for (let i = 0; i < 3; i++) {
+    if ((pa[i] || 0) > (pb[i] || 0)) return 1;
+    if ((pa[i] || 0) < (pb[i] || 0)) return -1;
+  }
+  return 0;
+}
+
 // 缓存上次校验的 config 哈希和结果，避免每次回菜单都重检
 let lastCheckedHash = null;
 let lastCheckResult; // undefined / true / false / null
@@ -885,6 +959,7 @@ async function runAdvancedMenu(chalk, hasConfig) {
       { name: '↩️  恢复 Claude Code 终端默认', value: 'code-reset' },
       { name: '↩️  恢复 Claude 桌面默认', value: 'desktop-reset' },
       { name: '🗑  清除所有 yingclaw 配置', value: 'reset' },
+      { name: '⬆️  检查更新', value: 'update' },
       { name: chalk.dim('↩  返回主菜单'), value: '__BACK__' },
     ],
   });
@@ -986,6 +1061,7 @@ async function runMenu() {
       'desktop-reset': 'desktop-reset',
       status: 'status',
       reset: 'reset',
+      update: 'update',
     };
 
     // 执行子命令（用 spawn 隔离，避免 commander 对 program 的副作用）

package/lib/config.js

@@ -42,6 +42,7 @@ const PROVIDERS = {
     baseUrl: 'https://dashscope.aliyuncs.com/apps/anthropic',
     modelsUrl: 'https://dashscope.aliyuncs.com/compatible-mode/v1/models',
     fastModel: 'qwen3.5-plus',
+    noDesktopPrefix: true,
     models: [
       { name: 'Qwen3 Max（强力）',   value: 'qwen3-max' },
       { name: 'Qwen3 Plus（均衡）',  value: 'qwen3-plus' },
@@ -52,6 +53,7 @@ const PROVIDERS = {
     name: 'MiniMax',
     baseUrl: 'https://api.minimaxi.com/anthropic',
     modelsUrl: 'https://api.minimaxi.com/v1/models',
+    noDesktopPrefix: true,
     models: [
       { name: 'MiniMax M2.7（旗舰）',       value: 'MiniMax-M2.7' },
       { name: 'MiniMax M2.7 Turbo（快速）', value: 'MiniMax-M2.7-Turbo' },
@@ -62,6 +64,7 @@ const PROVIDERS = {
     name: '智谱 GLM',
     baseUrl: 'https://open.bigmodel.cn/api/anthropic',
     modelsUrl: 'https://open.bigmodel.cn/api/paas/v4/models',
+    noDesktopPrefix: true,
     models: [
       { name: 'GLM-4.7（旗舰）',     value: 'GLM-4.7' },
       { name: 'GLM-5.1（强力）',     value: 'GLM-5.1' },
@@ -73,6 +76,7 @@ const PROVIDERS = {
     name: '小米 MiMo',
     baseUrl: 'https://api.xiaomimimo.com/anthropic',
     modelsUrl: 'https://api.xiaomimimo.com/v1/models',
+    noDesktopPrefix: true,
     models: [
       { name: 'MiMo V2.5 Pro（旗舰）', value: 'mimo-v2.5-pro' },
     ],

package/lib/desktop.js

@@ -3,7 +3,7 @@ const fs = require('fs');
 const os = require('os');
 const path = require('path');
 const { spawnSync } = require('child_process');
-const { normalizeAnthropicBaseUrl } = require('./config');
+const { normalizeAnthropicBaseUrl, PROVIDERS } = require('./config');
 
 const CLAUDE_DESKTOP_LABEL = 'Claude 桌面应用配置';
 const DESKTOP_GATEWAY_KEYS = [
@@ -63,7 +63,8 @@ function collectModels(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))];
+  const noPrefix = PROVIDERS[config.provider]?.noDesktopPrefix;
+  return [...new Set(list.filter(Boolean).map(m => noPrefix ? m : toDesktopModelId(m)))];
 }
 
 // 按官方 schema：所有值必须是字符串（包括布尔、数组都序列化）

package/package.json

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