aixxai 1.5.4 → 1.5.6

package/README.md

@@ -19,8 +19,13 @@ npx aixxai install zhangsan
 | 命令 | 说明 |
 |---|---|
 | `aixx install [推荐码]` | 安装AIXX skill到本地agent |
+| `aixx search <关键词>` | 搜索AIXX能力库（数据/技能，免key） |
+| `aixx installed` | 查看安装状态（skill/账号/版本） |
 | `aixx config` | 查看当前配置 |
 | `aixx test` | 测试AIXX连通性+调用模型 |
+| `aixx balance` | 查询账户余额（还剩多少钱） |
+| `aixx models` | 列出可用模型（国产/海外分组） |
+| `aixx recharge [金额]` | 充值引导（默认$5） |
 | `aixx --version` | 查看版本 |
 | `aixx --help` | 帮助 |
 

package/bin/aixx.js

@@ -6,6 +6,9 @@
  *
  * 用法：
  *   npx aixxai install [推荐码]    安装AIXX skill到本地agent（含零配置）
+ *   npx aixxai install --yes       非交互安装（脚本/CI用，跳过确认）
+ *   npx aixxai search <关键词>     搜索AIXX能力库（数据/技能，免key）
+ *   npx aixxai installed           查看安装状态（skill/账号/版本）
  *   npx aixxai config               配置/查看AIXX
  *   npx aixxai test                 测试AIXX是否可用
  *   npx aixxai balance              查询账户余额
@@ -18,6 +21,8 @@ import { readFileSync } from 'fs';
 import { fileURLToPath } from 'url';
 import { dirname, join } from 'path';
 import { install } from '../src/commands/install.js';
+import { search } from '../src/commands/search.js';
+import { installed } from '../src/commands/installed.js';
 import { config } from '../src/commands/config.js';
 import { test } from '../src/commands/test.js';
 import { balance } from '../src/commands/balance.js';
@@ -35,38 +40,57 @@ const VERSION = JSON.parse(readFileSync(join(__dirname, '..', 'package.json'), '
 // 改完后请全局搜索 "安全警告" 同步更新 env.js 与 templates/QUICKSTART.md 中的同名地址。
 export const DEFAULT_BASE_URL = 'https://baodan.run/v1';
 
+// 命令表：所有子命令的单一来源（新增命令在这里加一行即可）。
+// 未知命令的"你想用的是不是"近似匹配也从这张表取已知命令名，不另写一份。
+const COMMANDS = [
+  { name: 'install', aliases: ['i'], run: install },
+  { name: 'search', run: search },
+  { name: 'installed', run: installed },
+  { name: 'config', aliases: ['c'], run: config },
+  { name: 'test', aliases: ['t'], run: test },
+  { name: 'balance', aliases: ['b'], run: balance },
+  { name: 'models', aliases: ['m'], run: models },
+  { name: 'recharge', aliases: ['r'], run: recharge },
+];
+
+// help/version 不吃子参数（走 flag/无参分支），但命令名仍参与下面的近似匹配
+const BUILTIN_NAMES = ['help', 'version'];
+
+// 零依赖近似匹配的兜底：a 是否按顺序出现在 b 里（允许跳字，serch 也能对上 search）
+function isSubsequence(a, b) {
+  let i = 0;
+  for (const ch of b) {
+    if (ch === a[i]) i++;
+  }
+  return i === a.length;
+}
+
+// 未知命令 → 猜用户想输什么。小写比较；规则：前缀相同 / 互相包含 / 子序列。最多返回3个。
+function didYouMean(input) {
+  const s = input.toLowerCase();
+  return [...COMMANDS.map(c => c.name), ...BUILTIN_NAMES]
+    .filter(n => {
+      const t = n.toLowerCase();
+      return t.startsWith(s) || s.startsWith(t) || t.includes(s) || s.includes(t) || isSubsequence(s, t);
+    })
+    .slice(0, 3);
+}
+
 async function main() {
   const args = process.argv.slice(2);
   const command = args[0];
   const subArgs = args.slice(1);
 
+  const entry = COMMANDS.find(c => c.name === command || c.aliases?.includes(command));
+  if (entry) {
+    await entry.run(subArgs);
+    return;
+  }
+
   switch (command) {
-    case 'install':
-    case 'i':
-      await install(subArgs);
-      break;
-    case 'config':
-    case 'c':
-      await config(subArgs);
-      break;
-    case 'test':
-    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':
+    case 'version':
       showVersion(VERSION);
       break;
     case '--help':
@@ -75,10 +99,16 @@ async function main() {
     case undefined:
       showHelp(VERSION);
       break;
-    default:
+    default: {
       console.error(`未知命令: ${command}`);
-      console.error('运行 aixx --help 查看可用命令');
+      const guesses = didYouMean(command);
+      if (guesses.length > 0) {
+        console.error(`你想用的是不是: ${guesses.join(', ')}`);
+      } else {
+        console.error('运行 aixx help 查看全部命令');
+      }
       process.exit(1);
+    }
   }
 }
 

package/package.json

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

package/src/commands/help.js

@@ -12,6 +12,8 @@ export function showHelp(version) {
 用法：
   aixx install [推荐码]    安装AIXX skill到本地agent（含零配置）
   aixx install --yes       非交互安装（脚本/CI用，跳过确认）
+  aixx search <关键词>     搜索AIXX能力库（数据/技能，免key）
+  aixx installed           查看安装状态（skill/账号/版本）
   aixx config              配置或查看AIXX设置
   aixx test                测试AIXX是否可用
   aixx balance             查询账户余额（还剩多少钱）

package/src/commands/install.js

@@ -20,8 +20,8 @@ import { downloadSkill } from '../utils/download.js';
 import { setupEnv, maskKey } from '../utils/env.js';
 import { configureAgents } from '../utils/agentconfig.js';
 
-// skill目录检测
-function detectSkillDirs() {
+// skill目录检测（installed/search 命令也会复用，所以 export）
+export function detectSkillDirs() {
   const home = homedir();
   const candidates = [
     join(home, '.zcode', 'skills'),
@@ -32,6 +32,13 @@ function detectSkillDirs() {
   return candidates.filter(p => existsSync(p));
 }
 
+// 已实际装上AIXX skill的目录（候选目录里有 aixx/ 子目录才算装了），返回 aixx skill 的完整路径
+export function detectAixxSkillDirs() {
+  return detectSkillDirs()
+    .filter(d => existsSync(join(d, 'aixx')))
+    .map(d => join(d, 'aixx'));
+}
+
 async function ask(question) {
   const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
   return new Promise(resolve => rl.question(question, ans => { rl.close(); resolve(ans.trim()); }));
@@ -187,6 +194,18 @@ async function autoRegister(baseUrl, refCode) {
   return `sk-${apiKey}`;
 }
 
+/**
+ * 安装动作清单：在自动注册发生前告诉用户将要执行的三步。
+ * 仅在"即将自动注册"的路径打印（已有key的老用户不打印）。
+ */
+function printInstallPlan() {
+  console.log('本次安装将执行：');
+  console.log('  ① 注册AIXX账号（免费，含试用额度）');
+  console.log('  ② 创建API Key并保存到 ~/.aixx/account.json');
+  console.log('  ③ 安装AIXX技能到检测到的skill目录');
+  console.log('');
+}
+
 export async function install(subArgs) {
   console.log('╔══════════════════════════════════════════╗');
   console.log('║      AIXX 安装程序                        ║');
@@ -243,6 +262,9 @@ export async function install(subArgs) {
 
     if (choice === '') {
       // 自动注册
+      // 动作清单：让用户在注册发生前知道将要执行的三步（透明感=信任）。
+      // 放在确认之后：贴已有key的老用户不该看到"①注册账号"这种误导项。
+      printInstallPlan();
       try {
         apiKey = await autoRegister(DEFAULT_BASE_URL, refCode);
         keySource = 'registered';
@@ -271,7 +293,7 @@ export async function install(subArgs) {
           console.error('❌ 未提供有效Key，安装中断。');
           process.exit(1);
         }
-        process.exit(1);
+        // 有效key已拿到（apiKey/keySource 已赋值），不再退出，继续走后面的安装流程
       }
     } else if (choice.startsWith('sk-')) {
       // 用户输入已有key
@@ -355,9 +377,24 @@ export async function install(subArgs) {
   console.log('\n╔══════════════════════════════════════════╗');
   console.log('║      🎉 安装完成！                        ║');
   console.log('╚══════════════════════════════════════════╝\n');
+  printQuickStart(apiKey);
   printInstallBroadcast();
 }
 
+/**
+ * 安装完成后的 QuickStart——给用户一段"复制就能跑"的代码。
+ * 目标：让新用户在30秒内成功调通第一个模型，建立正反馈。
+ */
+function printQuickStart(apiKey) {
+  const key = apiKey || '你的API_KEY';
+  console.log('⚡ 30秒验证（复制粘贴到终端跑一下）：\n');
+  console.log('curl -s https://baodan.run/v1/chat/completions \\');
+  console.log('  -H "Authorization: Bearer ' + key + '" \\');
+  console.log('  -H "Content-Type: application/json" \\');
+  console.log('  -d \'{"model":"deepseek-chat","messages":[{"role":"user","content":"你好"}],"max_tokens":50}\'');
+  console.log('\n   跑通了你就会看到 AI 回复你"你好"。\n');
+}
+
 async function testConnectivity(apiKey) {
   // 用 /v1/models（带key）测试真实可用性，而不是 /api/status（管理接口，域名下404）
   const url = DEFAULT_BASE_URL + '/models';

package/src/commands/installed.js

@@ -0,0 +1,62 @@
+/**
+ * AIXX CLI - installed 命令
+ *
+ * 纯本地查询（不发任何网络请求），报告三件事：
+ *   ① AIXX skill 是否已装（复用 install.js 的目录检测）
+ *   ② 账号状态（~/.aixx/account.json）
+ *   ③ CLI 自身版本（package.json 的 version，单一来源）
+ */
+
+import { existsSync, readFileSync } from 'fs';
+import { homedir } from 'os';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+import { detectSkillDirs, detectAixxSkillDirs } from './install.js';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const VERSION = JSON.parse(readFileSync(join(__dirname, '..', '..', 'package.json'), 'utf-8')).version;
+
+export async function installed() {
+  console.log('╔══════════════════════════════════════════╗');
+  console.log('║      AIXX 安装状态                         ║');
+  console.log('╚══════════════════════════════════════════╝\n');
+
+  // ① skill 安装状态
+  const skillDirs = detectAixxSkillDirs();
+  if (skillDirs.length > 0) {
+    console.log('① skill: ✅ 已安装');
+    skillDirs.forEach(d => console.log(`   ${d}`));
+  } else {
+    console.log('① skill: ❌ 未安装');
+    const candidateDirs = detectSkillDirs();
+    candidateDirs.forEach(d => console.log(`   检测到skill目录但没有aixx: ${d}`));
+    console.log('   运行 npx aixxai install 一键开通');
+  }
+
+  // ② 账号状态（~/.aixx/account.json）
+  const accountFile = join(homedir(), '.aixx', 'account.json');
+  let account = null;
+  let accountBroken = false;
+  if (existsSync(accountFile)) {
+    try {
+      account = JSON.parse(readFileSync(accountFile, 'utf-8'));
+    } catch (e) {
+      accountBroken = true;
+    }
+  }
+  if (account?.username) {
+    console.log(`② 账号: ✅ 已注册（${account.username}）`);
+  } else if (accountBroken) {
+    console.log(`② 账号: ⚠️  账号文件存在但读取失败（${accountFile}）`);
+  } else {
+    console.log('② 账号: 未注册');
+  }
+
+  // ③ CLI 自身版本
+  console.log(`③ CLI版本: v${VERSION}`);
+
+  // 已装给一句话用法
+  if (skillDirs.length > 0) {
+    console.log('\n用法：对<<你的AI>>说"用AIXX查余额/生图/搜数据"即可');
+  }
+}

package/src/commands/search.js

@@ -0,0 +1,96 @@
+/**
+ * AIXX CLI - search 命令
+ *
+ * 搜索AIXX能力库（数据/技能）。免key接口，未注册也能搜——
+ * 目的：让用户先看到"有什么、多少钱"，再决定要不要装。
+ *
+ * 接口：POST {DEFAULT_BASE_URL}/capability   body: {need: 关键词}
+ * 响应：{matched, capabilities:[{id,name,description,pricing:{per_use,weekly,monthly,free_quota},
+ *        match_score,estimated_time}]}，可能带 compliance_blocked（合规拦截，服务端会给message）
+ *
+ * 注意：搜到的能力不是装到本地的，装好AIXX技能后AI直接说需求即可调用。
+ */
+
+import { DEFAULT_BASE_URL } from '../../bin/aixx.js';
+import { detectAixxSkillDirs } from './install.js';
+
+// 与 install/balance 同款：统一 15 秒超时 + 网络/超时异常转友好提示
+const FETCH_TIMEOUT = 15000;
+function friendlyNetErr(err) {
+  return err?.name === 'TimeoutError' || err?.name === 'AbortError'
+    ? '连接超时，请检查网络'
+    : err?.message || String(err);
+}
+
+// 描述压成一句话并截断（≤60字）
+function oneLine(text, max = 60) {
+  const line = String(text || '').replace(/\s+/g, ' ').trim();
+  return line.length > max ? line.slice(0, max) + '…' : line;
+}
+
+export async function search(subArgs) {
+  const keyword = subArgs.filter(a => a && !a.startsWith('-')).join(' ').trim();
+
+  // 无关键词：给用法示例，别让用户干瞪眼
+  if (!keyword) {
+    console.log('用法: aixx search <关键词>\n');
+    console.log('示例:');
+    console.log('  aixx search 抖音数据    查抖音相关的数据能力');
+    console.log('  aixx search UI设计      查设计相关的技能');
+    return;
+  }
+
+  console.log(`🔍 搜索AIXX能力: ${keyword}\n`);
+
+  // 免key接口，不加任何认证头
+  const baseUrl = process.env.AIXX_BASE_URL || DEFAULT_BASE_URL;
+  let data;
+  try {
+    const resp = await fetch(`${baseUrl}/capability`, {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({ need: keyword }),
+      signal: AbortSignal.timeout(FETCH_TIMEOUT),
+    });
+    if (!resp.ok) throw new Error(`HTTP ${resp.status}`);
+    data = await resp.json();
+  } catch (err) {
+    console.error(`❌ 搜索失败: ${friendlyNetErr(err)}`);
+    console.error('   也可以直接到官网浏览全部能力: https://baodan.run/aixx/');
+    process.exit(1);
+  }
+
+  // 合规拦截：如实转达服务端说法
+  if (data?.compliance_blocked) {
+    console.log(`⛔ ${data.message || '该关键词被合规策略拦截，换个说法试试'}`);
+    return;
+  }
+
+  const caps = Array.isArray(data?.capabilities) ? data.capabilities : [];
+  if (!data?.matched || caps.length === 0) {
+    console.log(`没有找到与"${keyword}"相关的能力。`);
+    console.log('建议换个关键词再试试，比如：抖音数据、小红书、UI设计、视频脚本。');
+    return;
+  }
+
+  caps.forEach((cap, i) => {
+    // data-*前缀的id是数据接口，其余是技能
+    const type = cap.id?.startsWith('data-') ? '数据' : '技能';
+    console.log(`${i + 1}. ${cap.name || '未命名'} [${type}]`);
+    console.log(`   ${oneLine(cap.description)}`);
+    const tags = [];
+    if (cap.pricing?.per_use !== undefined && cap.pricing?.per_use !== null) {
+      tags.push(`${cap.pricing.per_use} 元/次`);
+    }
+    if ((cap.pricing?.free_quota || 0) > 0) {
+      tags.push(`🆓 有${cap.pricing.free_quota}次免费试用`);
+    }
+    tags.push(`ID: ${cap.id}`);
+    console.log(`   ${tags.join(' · ')}`);
+  });
+
+  console.log('\n以上能力无需单独安装——安装AIXX技能后，你的AI直接说需求即可调用（能力ID给AI看就行）');
+  if (detectAixxSkillDirs().length === 0) {
+    console.log('还没安装AIXX技能？运行 npx aixxai install 一键开通');
+  }
+}