aixxai 1.0.0 → 1.2.0

package/bin/aixx.js

@@ -5,15 +5,21 @@
  * 让你的AI调用万物。
  *
  * 用法：
- *   npx aixx-cli install [推荐码]    安装AIXX skill到本地agent
- *   npx aixx-cli config               配置/查看AIXX
- *   npx aixx-cli test                 测试AIXX是否可用
- *   npx aixx-cli --version            查看版本
+ *   npx aixxai install [推荐码]    安装AIXX skill到本地agent（含零配置）
+ *   npx aixxai config               配置/查看AIXX
+ *   npx aixxai test                 测试AIXX是否可用
+ *   npx aixxai balance              查询账户余额
+ *   npx aixxai models               列出可用模型（分组）
+ *   npx aixxai recharge [金额]      充值引导
+ *   npx aixxai --version            查看版本
  */
 
 import { install } from '../src/commands/install.js';
 import { config } from '../src/commands/config.js';
 import { test } from '../src/commands/test.js';
+import { balance } from '../src/commands/balance.js';
+import { models } from '../src/commands/models.js';
+import { recharge } from '../src/commands/recharge.js';
 import { showHelp, showVersion } from '../src/commands/help.js';
 
 const VERSION = '0.1.0';
@@ -42,6 +48,18 @@ async function main() {
     case 't':
       await test(subArgs);
       break;
+    case 'balance':
+    case 'b':
+      await balance(subArgs);
+      break;
+    case 'models':
+    case 'm':
+      await models(subArgs);
+      break;
+    case 'recharge':
+    case 'r':
+      await recharge(subArgs);
+      break;
     case '--version':
     case '-v':
       showVersion(VERSION);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aixxai",
-  "version": "1.0.0",
+  "version": "1.2.0",
   "description": "AIXX CLI - 让你的AI调用万物。安装：npx aixxai install",
   "type": "module",
   "bin": {

package/src/commands/balance.js

@@ -0,0 +1,159 @@
+/**
+ * AIXX CLI - balance 命令
+ *
+ * 查询当前账户余额、已用额度。
+ *
+ * 数据来源（New-API兼容接口）：
+ *   1. GET /v1/dashboard/billing/subscription  → hard_limit_usd（总额度，美元）
+ *   2. GET /v1/dashboard/billing/usage         → 已用量（可能多种格式，做兜底）
+ *
+ * 展示时换算成人民币（按 1 USD ≈ 7 元，只是给用户一个直观感受）。
+ * "还剩约N次对话"：按每次对话约 ¥0.01 估算（最便宜的deepseek-chat单次几厘到几分）。
+ */
+
+import { existsSync, readFileSync } from 'fs';
+import { homedir } from 'os';
+import { join } from 'path';
+import { DEFAULT_BASE_URL } from '../../bin/aixx.js';
+
+// 美元→人民币换算（仅用于展示，给用户一个直观感受）
+const USD_TO_CNY = 7;
+// 估算单次对话成本（元），用于"还能聊多少次"
+const COST_PER_CHAT_CNY = 0.01;
+// 所有对外请求统一 15 秒超时
+const FETCH_TIMEOUT = 15000;
+// 网络/超时异常统一成友好提示
+function friendlyNetErr(err) {
+  return err?.name === 'TimeoutError' || err?.name === 'AbortError'
+    ? '连接超时，请检查网络'
+    : err?.message || String(err);
+}
+
+/**
+ * 从环境变量或本地账号文件读取 apiKey。
+ * 优先级：环境变量 > ~/.aixx/account.json
+ */
+function loadApiKey() {
+  if (process.env.AIXX_API_KEY) return process.env.AIXX_API_KEY;
+  const accountFile = join(homedir(), '.aixx', 'account.json');
+  if (existsSync(accountFile)) {
+    try {
+      const acc = JSON.parse(readFileSync(accountFile, 'utf-8'));
+      if (acc.apiKey) return acc.apiKey;
+    } catch (e) {
+      // 忽略，下面报错
+    }
+  }
+  return null;
+}
+
+export async function balance(subArgs) {
+  console.log('╔══════════════════════════════════════════╗');
+  console.log('║      AIXX 账户余额                         ║');
+  console.log('╚══════════════════════════════════════════╝\n');
+
+  const apiKey = loadApiKey();
+  const baseUrl = process.env.AIXX_BASE_URL || DEFAULT_BASE_URL;
+
+  if (!apiKey) {
+    console.error('❌ 未找到AIXX API Key');
+    console.error('   请先运行 aixx install，或设置环境变量 AIXX_API_KEY');
+    process.exit(1);
+  }
+
+  console.log(`使用Key: ${apiKey.slice(0, 12)}...${apiKey.slice(-4)}`);
+  console.log(`后端地址: ${baseUrl}\n`);
+
+  // 1. 查总额度（subscription）
+  let hardLimitUsd = 0;
+  try {
+    const resp = await fetch(`${baseUrl}/dashboard/billing/subscription`, {
+      headers: { Authorization: `Bearer ${apiKey}` },
+      signal: AbortSignal.timeout(FETCH_TIMEOUT),
+    });
+    if (!resp.ok) {
+      if (resp.status === 401) {
+        console.error('❌ API Key 无效（401），请重新 install 或检查 key');
+        process.exit(1);
+      }
+      console.error(`❌ 查询余额失败: HTTP ${resp.status}`);
+      process.exit(1);
+    }
+    const data = await resp.json();
+    // New-API/OpenAI兼容：hard_limit_usd 是总额度
+    hardLimitUsd =
+      data.hard_limit_usd ??
+      data.hard_limit ??
+      data.data?.hard_limit_usd ??
+      0;
+  } catch (err) {
+    console.error(`❌ ${friendlyNetErr(err)}`);
+    process.exit(1);
+  }
+
+  // 2. 查已用量（usage）
+  // 不同后端字段不一样，尽量兜底
+  let usedUsd = 0;
+  try {
+    // 用一个宽日期范围，确保能查到所有用量
+    const today = new Date();
+    const start = `${today.getFullYear()}-01-01`;
+    const end = `${today.getFullYear()}-12-31`;
+    const resp = await fetch(
+      `${baseUrl}/dashboard/billing/usage?start_date=${start}&end_date=${end}`,
+      {
+        headers: { Authorization: `Bearer ${apiKey}` },
+        signal: AbortSignal.timeout(FETCH_TIMEOUT),
+      }
+    );
+    if (resp.ok) {
+      const data = await resp.json();
+      // 常见字段优先级
+      usedUsd =
+        data.total_usage ??
+        data.total_cost ??
+        data.data?.total_usage ??
+        data.cumulative_usage ??
+        0;
+      // New-API 的 total_usage 单位有时是"分(美元)"，要除以100
+      // 这里做个粗判断：如果usedUsd比hardLimit还大100倍，多半是没除100
+      if (usedUsd > 0 && hardLimitUsd > 0 && usedUsd > hardLimitUsd * 50) {
+        usedUsd = usedUsd / 100;
+      }
+    } else {
+      // usage 接口挂了不影响主流程，总额度照常显示
+      console.log('   (用量接口未返回数据，仅显示总额度)\n');
+    }
+  } catch (err) {
+    console.log('   (用量查询失败，仅显示总额度)\n');
+  }
+
+  // 3. 计算并展示
+  // New-API 的"无限额度"哨兵：hard_limit_usd >= 100000000（1亿）表示这个token不限额。
+  // 直接显示真实数字（¥7亿）会吓到用户，所以单独走"无限额度"分支。
+  const UNLIMITED_SENTINEL = 100000000;
+  const isUnlimited = hardLimitUsd >= UNLIMITED_SENTINEL;
+  const usedCny = usedUsd * USD_TO_CNY;
+
+  console.log('────────────────────────────────────');
+  if (isUnlimited) {
+    // 无限额度（一般是管理员key或赠送的不限量key）
+    console.log(`💰 当前余额：♾️  无限额度（不限量）`);
+    console.log(`📊 已用额度：¥${usedCny.toFixed(2)}`);
+    console.log(`💳 账户类型：无限量`);
+  } else {
+    // 正常有限额度
+    const remainingUsd = Math.max(0, hardLimitUsd - usedUsd);
+    const totalCny = hardLimitUsd * USD_TO_CNY;
+    const remainingCny = remainingUsd * USD_TO_CNY;
+    const approxChats = Math.floor(remainingCny / COST_PER_CHAT_CNY);
+    console.log(`💰 当前余额：¥${remainingCny.toFixed(2)}（还剩约 ${approxChats.toLocaleString()} 次对话）`);
+    console.log(`📊 已用额度：¥${usedCny.toFixed(2)}`);
+    console.log(`💳 账户总额度：¥${totalCny.toFixed(2)}（$${hardLimitUsd.toFixed(2)}）`);
+  }
+  console.log('────────────────────────────────────');
+  console.log('\n💡 提示：');
+  console.log('   - 新用户注册送 ¥5 免费额度');
+  console.log('   - deepseek-chat 最便宜，省着用能聊很久');
+  console.log('   - 余额不足时运行 aixx recharge 查看充值方式\n');
+}

package/src/commands/help.js

@@ -10,16 +10,25 @@ export function showHelp(version) {
 ╚══════════════════════════════════════════╝
 
 用法：
-  aixx install [推荐码]    安装AIXX skill到本地agent
+  aixx install [推荐码]    安装AIXX skill到本地agent（含零配置）
   aixx config              配置或查看AIXX设置
   aixx test                测试AIXX是否可用
+  aixx balance             查询账户余额（还剩多少钱）
+  aixx models              列出可用模型（国产/海外分组）
+  aixx recharge [金额]     充值引导（默认$5）
   aixx --version           查看版本
   aixx --help              显示此帮助
 
 安装示例：
-  npx aixxai install              普通安装
+  npx aixxai install              普通安装（自动注册，送¥5额度）
   npx aixxai install zhangsan     通过张三的推荐码安装（张三获分润）
 
+账户示例：
+  aixx balance                    查看余额
+  aixx balance 20                 （金额参数对balance无效，仅recharge用）
+  aixx models                     看有哪些模型可调
+  aixx recharge 10                充 $10
+
 关于AIXX：
   AIXX = "AI的谷歌"。装一个skill，agent就能调用全世界的AI能力。
   永远不用碰key、参数、文档，一切通过对话。

package/src/commands/install.js

@@ -18,6 +18,7 @@ import { randomInt } from 'crypto';
 import { DEFAULT_BASE_URL } from '../../bin/aixx.js';
 import { downloadSkill } from '../utils/download.js';
 import { setupEnv } from '../utils/env.js';
+import { configureAgents } from '../utils/agentconfig.js';
 
 // skill目录检测
 function detectSkillDirs() {
@@ -52,6 +53,15 @@ function genPassword() {
   return pwd;
 }
 
+// 所有对外请求统一 15 秒超时（AbortSignal.timeout 在 Node 17.3+ 可用，本 CLI 要求 18+）
+const FETCH_TIMEOUT = 15000;
+// 把网络/超时异常的报错信息统一成友好提示
+function friendlyNetErr(err) {
+  return err?.name === 'TimeoutError' || err?.name === 'AbortError'
+    ? '连接超时，请检查网络'
+    : err?.message || String(err);
+}
+
 // 自动注册AIXX账号
 async function autoRegister(baseUrl, refCode) {
   const username = genUsername();
@@ -71,7 +81,8 @@ async function autoRegister(baseUrl, refCode) {
   const regResp = await fetch(regUrl, {
     method: 'POST',
     headers: { 'Content-Type': 'application/json' },
-    body: JSON.stringify(regBody)
+    body: JSON.stringify(regBody),
+    signal: AbortSignal.timeout(FETCH_TIMEOUT),
   });
   const regData = await regResp.json();
 
@@ -86,7 +97,8 @@ async function autoRegister(baseUrl, refCode) {
   const loginResp = await fetch(loginUrl, {
     method: 'POST',
     headers: { 'Content-Type': 'application/json' },
-    body: JSON.stringify({ username, password })
+    body: JSON.stringify({ username, password }),
+    signal: AbortSignal.timeout(FETCH_TIMEOUT),
   });
   const loginData = await loginResp.json();
 
@@ -109,7 +121,8 @@ async function autoRegister(baseUrl, refCode) {
       name: 'default',
       remain_quota: -1,
       unlimited_quota: true
-    })
+    }),
+    signal: AbortSignal.timeout(FETCH_TIMEOUT),
   });
   const tokenData = await tokenResp.json();
 
@@ -121,7 +134,8 @@ async function autoRegister(baseUrl, refCode) {
   // 正确做法：先查列表拿 token id，再调 POST /api/token/:id/key 取未脱敏的完整 key。
   const apiBase = baseUrl.replace(/\/v1$/, '');
   const listResp = await fetch(`${apiBase}/api/token/?p=0&page_size=1`, {
-    headers: { 'Authorization': `Bearer ${userToken}` }
+    headers: { 'Authorization': `Bearer ${userToken}` },
+    signal: AbortSignal.timeout(FETCH_TIMEOUT),
   });
   const listData = await listResp.json();
   const list = listData.data;
@@ -135,7 +149,8 @@ async function autoRegister(baseUrl, refCode) {
   // 取未脱敏的完整 key（GET 列表会脱敏，必须用这个专用接口）
   const keyResp = await fetch(`${apiBase}/api/token/${tokenId}/key`, {
     method: 'POST',
-    headers: { 'Authorization': `Bearer ${userToken}` }
+    headers: { 'Authorization': `Bearer ${userToken}` },
+    signal: AbortSignal.timeout(FETCH_TIMEOUT),
   });
   const keyData = await keyResp.json();
   const apiKey = keyData?.data?.key;
@@ -147,12 +162,13 @@ async function autoRegister(baseUrl, refCode) {
   console.log(`✅ API Key已创建: sk-${apiKey.slice(0, 8)}...${apiKey.slice(-4)}`);
 
   // 保存账号信息到本地（方便用户找回）
+  // 安全：不存明文密码。注册时密码只用于首次登录拿token，之后用apiKey就够了。
+  // 丢了账号可以重新注册（免费），所以不需要保留密码。
   const aixxDir = join(homedir(), '.aixx');
   if (!existsSync(aixxDir)) mkdirSync(aixxDir, { recursive: true });
   const fullKey = `sk-${apiKey}`;
   writeFileSync(join(aixxDir, 'account.json'), JSON.stringify({
     username,
-    password,
     apiKey: fullKey,  // 存完整key（本地文件，不进git）
     registeredAt: new Date().toISOString(),
     refCode: refCode || null
@@ -187,7 +203,9 @@ export async function install(subArgs) {
   console.log(`✅ 操作系统: ${process.platform}`);
 
   // 2. 获取或创建API Key
+  // 记录key来源，用于后面给出正确的提示（环境变量 / 本地账号）
   let apiKey = process.env.AIXX_API_KEY;
+  let keySource = apiKey ? 'env' : null;
 
   if (!apiKey) {
     // 检查本地是否有已保存的账号
@@ -196,6 +214,7 @@ export async function install(subArgs) {
       try {
         const account = JSON.parse(readFileSync(accountFile, 'utf-8'));
         apiKey = account.apiKey;
+        keySource = 'account';
         console.log(`\n✅ 发现已保存的账号: ${account.username}`);
         console.log(`   使用已保存的API Key`);
       } catch (e) {
@@ -213,21 +232,32 @@ export async function install(subArgs) {
       // 自动注册
       try {
         apiKey = await autoRegister(DEFAULT_BASE_URL, refCode);
+        keySource = 'registered';
       } catch (err) {
-        console.error(`\n❌ 自动注册失败: ${err.message}`);
+        // 网络/超时类异常给友好提示，业务错误（注册/登录/创建key失败）保留原文
+        const msg = /timeout|abort|fetch|network|ECONN|ETIMEDOUT|getaddrinfo/i.test(err.message)
+          ? friendlyNetErr(err)
+          : err.message;
+        console.error(`\n❌ 自动注册失败: ${msg}`);
         console.error('   你可以手动到 AIXX 平台注册后，用已有key重新运行 install。');
         process.exit(1);
       }
     } else if (choice.startsWith('sk-')) {
       // 用户输入已有key
       apiKey = choice;
+      keySource = 'manual';
       console.log('✅ 使用你提供的API Key');
     } else {
       console.error('❌ 无效的输入');
       process.exit(1);
     }
   } else {
-    console.log('\n✅ 已检测到 AIXX_API_KEY 环境变量');
+    // 区分来源：环境变量 vs 本地账号文件
+    if (keySource === 'env') {
+      console.log('\n✅ 已检测到 AIXX_API_KEY 环境变量');
+    } else {
+      console.log('\n✅ 已检测到本地账号文件（~/.aixx/account.json）');
+    }
   }
 
   // 3. 检测/创建skill目录
@@ -264,7 +294,17 @@ export async function install(subArgs) {
     console.log('✅ 环境变量配置完成');
   }
 
-  // 6. 测试连通性
+  // 6. 零配置：自动写本地agent配置（ZCode / Claude Code）
+  // 这是"零配置核心"——让用户安装完就能直接在agent里选到AIXX，不用手动填key。
+  if (apiKey) {
+    try {
+      configureAgents(apiKey);
+    } catch (err) {
+      console.log(`⚠️  agent配置写入异常（不影响安装）: ${err.message}`);
+    }
+  }
+
+  // 7. 测试连通性
   if (apiKey) {
     console.log('\n🔌 测试AIXX连通性...');
     try {
@@ -276,19 +316,46 @@ export async function install(subArgs) {
     }
   }
 
-  // 完成
+  // 8. 安装完成 + 播报（给agent看，让龙龙主动告诉用户装好了）
   console.log('\n╔══════════════════════════════════════════╗');
   console.log('║      🎉 安装完成！                        ║');
   console.log('╚══════════════════════════════════════════╝\n');
-  console.log('现在你可以对自己的agent说：');
-  console.log('  "帮我用deepseek-chat翻译：Hello World"\n');
-  console.log('查询余额：');
-  console.log('  "我AIXX还剩多少额度？"\n');
-  console.log('文档：https://gitee.com/kk0803/token-hub\n');
+  printInstallBroadcast();
 }
 
 async function testConnectivity(apiKey) {
   const url = DEFAULT_BASE_URL.replace(/\/v1$/, '') + '/api/status';
-  const resp = await fetch(url);
-  if (!resp.ok) throw new Error(`HTTP ${resp.status}`);
+  try {
+    const resp = await fetch(url, { signal: AbortSignal.timeout(FETCH_TIMEOUT) });
+    if (!resp.ok) throw new Error(`HTTP ${resp.status}`);
+  } catch (err) {
+    // 网络超时/中断给友好提示，而不是裸的 abort message
+    throw new Error(friendlyNetErr(err));
+  }
+}
+
+/**
+ * 安装完成后的"播报"。
+ * 这段输出是给 agent（龙龙）看的，让 agent 主动转告用户：
+ *   你装好了，送了5元，能调这些模型，可以这样用。
+ *
+ * 格式严格按需求1的模板，方便 agent 识别和转述。
+ */
+function printInstallBroadcast() {
+  console.log('═══ AIXX 安装成功，请告诉用户以下信息 ═══');
+  console.log('你已成功安装AIXX！送你5元免费额度。');
+  console.log('');
+  console.log('【能用什么】');
+  console.log('  调各种AI模型：DeepSeek（最便宜）、Claude（最强）、GPT、GLM（中文好）、Kimi（长文本）、Grok');
+  console.log('  生成图片：对agent说"帮我用豆包画个猫"');
+  console.log('  🔍 搜索AI skill：对agent说"我要个审美skill""帮我找个开发工具"（AIXX帮你搜GitHub+给推荐）');
+  console.log('');
+  console.log('【怎么用】对agent说话就行，比如：');
+  console.log('  - "帮我用Claude翻译这段"');
+  console.log('  - "用最便宜的模型写个文案"');
+  console.log('  - "我要个写代码的skill"（搜索AI工具）');
+  console.log('  - "我还剩多少额度？"');
+  console.log('');
+  console.log('【重要】请重启ZCode/Claude Code，并在模型选择里选AIXX供应商，才能开始用。');
+  console.log('══════════════════════════════════════════');
 }

package/src/commands/models.js

@@ -0,0 +1,152 @@
+/**
+ * AIXX CLI - models 命令
+ *
+ * 列出AIXX支持的所有模型，按"国产/海外"分组展示。
+ *
+ * 数据来源：GET /v1/models
+ * 后端返回的模型列表是动态的，但分组规则是固定的（按模型名前缀分类）。
+ */
+
+import { existsSync, readFileSync } from 'fs';
+import { homedir } from 'os';
+import { join } from 'path';
+import { DEFAULT_BASE_URL } from '../../bin/aixx.js';
+
+// 所有对外请求统一 15 秒超时
+const FETCH_TIMEOUT = 15000;
+// 网络/超时异常统一成友好提示
+function friendlyNetErr(err) {
+  return err?.name === 'TimeoutError' || err?.name === 'AbortError'
+    ? '连接超时，请检查网络'
+    : err?.message || String(err);
+}
+
+/**
+ * 从环境变量或本地账号文件读取 apiKey。
+ */
+function loadApiKey() {
+  if (process.env.AIXX_API_KEY) return process.env.AIXX_API_KEY;
+  const accountFile = join(homedir(), '.aixx', 'account.json');
+  if (existsSync(accountFile)) {
+    try {
+      const acc = JSON.parse(readFileSync(accountFile, 'utf-8'));
+      if (acc.apiKey) return acc.apiKey;
+    } catch (e) {}
+  }
+  return null;
+}
+
+// 给每个模型加一句人话说明，让用户知道怎么选
+const MODEL_DESC = {
+  'deepseek-chat': '最便宜，¥0.001/千token，日常首选',
+  'deepseek-reasoner': '推理增强（带思考过程）',
+  'glm-4-flash': '智谱免费档，速度快',
+  'glm-4-plus': '中文写作强',
+  'glm-4': '智谱通用',
+  'moonshot-v1-8k': 'Kimi，短上下文',
+  'moonshot-v1-32k': 'Kimi，中等上下文',
+  'moonshot-v1-128k': 'Kimi，超长文本（读整本书）',
+  'claude-sonnet-4-20250514': '日常主力，平衡性价比',
+  'claude-haiku-4-5-20251001': '便宜快速，简单任务',
+  'claude-opus-4-8': '最强，复杂任务',
+  'claude-3-5-sonnet': 'Claude 3.5 经典款',
+  'gpt-4o': 'OpenAI通用旗舰',
+  'gpt-4o-mini': 'OpenAI便宜款',
+  'gpt-4': 'GPT-4 经典',
+  'gpt-3.5-turbo': 'GPT-3.5，老牌便宜',
+  'grok-2-latest': 'xAI Grok，最新版',
+  'grok-beta': 'xAI Grok 测试版',
+};
+
+// 模型分组规则：返回 'cn'（国产）或 'overseas'（海外）
+function classifyModel(id) {
+  const domestic = ['deepseek', 'glm', 'moonshot', 'qwen', 'ernie', 'spark', 'hunyuan', 'baichuan', 'yi-', 'step'];
+  const lower = id.toLowerCase();
+  if (domestic.some((p) => lower.startsWith(p))) return 'cn';
+  return 'overseas';
+}
+
+function descOf(id) {
+  return MODEL_DESC[id] || '';
+}
+
+export async function models(subArgs) {
+  console.log('╔══════════════════════════════════════════╗');
+  console.log('║      AIXX 可用模型                         ║');
+  console.log('╚══════════════════════════════════════════╝\n');
+
+  const apiKey = loadApiKey();
+  const baseUrl = process.env.AIXX_BASE_URL || DEFAULT_BASE_URL;
+
+  if (!apiKey) {
+    console.error('❌ 未找到AIXX API Key');
+    console.error('   请先运行 aixx install，或设置环境变量 AIXX_API_KEY');
+    process.exit(1);
+  }
+
+  // 拉模型列表
+  let modelIds = [];
+  try {
+    const resp = await fetch(`${baseUrl}/models`, {
+      headers: { Authorization: `Bearer ${apiKey}` },
+      signal: AbortSignal.timeout(FETCH_TIMEOUT),
+    });
+    if (!resp.ok) {
+      if (resp.status === 401) {
+        console.error('❌ API Key 无效（401），请重新 install 或检查 key');
+        process.exit(1);
+      }
+      console.error(`❌ 获取模型列表失败: HTTP ${resp.status}`);
+      process.exit(1);
+    }
+    const data = await resp.json();
+    const arr = data.data || data.models || [];
+    modelIds = arr
+      .map((m) => (typeof m === 'string' ? m : m.id))
+      .filter(Boolean)
+      .sort();
+  } catch (err) {
+    console.error(`❌ ${friendlyNetErr(err)}`);
+    process.exit(1);
+  }
+
+  if (modelIds.length === 0) {
+    console.log('⚠️  后端未返回任何模型，可能是账户没有可用模型权限。');
+    return;
+  }
+
+  // 分组
+  const cn = modelIds.filter((id) => classifyModel(id) === 'cn');
+  const overseas = modelIds.filter((id) => classifyModel(id) === 'overseas');
+
+  // 国产组
+  console.log('🇨🇳 国产模型（便宜）：');
+  if (cn.length > 0) {
+    cn.forEach((id) => {
+      const desc = descOf(id);
+      console.log(`   • ${id}${desc ? '  —— ' + desc : ''}`);
+    });
+  } else {
+    console.log('   （暂无）');
+  }
+
+  // 海外组
+  console.log('\n🚀 海外模型（强）：');
+  if (overseas.length > 0) {
+    overseas.forEach((id) => {
+      const desc = descOf(id);
+      console.log(`   • ${id}${desc ? '  —— ' + desc : ''}`);
+    });
+  } else {
+    console.log('   （暂无）');
+  }
+
+  console.log(`\n📊 共 ${modelIds.length} 个模型\n`);
+
+  console.log('💡 选模型小抄：');
+  console.log('   - 最便宜日常任务 → deepseek-chat');
+  console.log('   - 写中文文案/邮件 → glm-4-plus');
+  console.log('   - 读超长文档/书籍 → moonshot-v1-128k');
+  console.log('   - 复杂推理/代码 → deepseek-reasoner 或 claude-opus-4-8');
+  console.log('   - 通用旗舰 → gpt-4o 或 claude-sonnet-4\n');
+}