aixxai 1.5.9 → 1.6.0

package/bin/aixx.js

@@ -35,10 +35,10 @@ const __dirname = dirname(fileURLToPath(import.meta.url));
 const VERSION = JSON.parse(readFileSync(join(__dirname, '..', 'package.json'), 'utf-8')).version;
 
 // 默认AIXX后端地址
-// ⚠️ 安全警告：当前用HTTP明文传输API Key（http://），存在凭据被嗅探风险。
 // 会话16换门：统一走域名网关入口（详见 src/utils/env.js 注释）
+// 卡170(1011)换门二: baodan.run网关的/api/*全归爆单后端(CLI注册/login/token 404断链39天)——账号管理与模型调用统一走萬安云自有域名console.aixx.ai
 // 改完后请全局搜索 "安全警告" 同步更新 env.js 与 templates/QUICKSTART.md 中的同名地址。
-export const DEFAULT_BASE_URL = 'https://baodan.run/v1';
+export const DEFAULT_BASE_URL = 'https://console.aixx.ai/v1';
 
 // 命令表：所有子命令的单一来源（新增命令在这里加一行即可）。
 // 未知命令的"你想用的是不是"近似匹配也从这张表取已知命令名，不另写一份。
@@ -108,6 +108,13 @@ async function main() {
       showHelp(VERSION);
       break;
     default: {
+      // 卡170(1011 K哥令"安装命令带唯一码"): 未知参数不再直接报错——当作码传给 install。
+      // 覆盖 npx aixxai <CODE>（不带 install 子命令）的用法；install 内部会先查云侧区分绑定码/推荐码。
+      const installEntry = COMMANDS.find(c => c.name === 'install');
+      if (installEntry && command && !command.startsWith('-')) {
+        await installEntry.run([command, ...subArgs]);
+        return;
+      }
       console.error(`未知命令: ${command}`);
       const guesses = didYouMean(command);
       if (guesses.length > 0) {

package/package.json

@@ -1,34 +1,34 @@
-{
-  "name": "aixxai",
-  "version": "1.5.9",
-  "description": "AIXX CLI - 让你的AI调用万物。安装：npx aixxai",
-  "type": "module",
-  "bin": {
-    "aixx": "./bin/aixx.js"
-  },
-  "scripts": {
-    "test": "node bin/aixx.js --version"
-  },
-  "keywords": [
-    "aixx",
-    "ai",
-    "llm",
-    "gateway",
-    "openai",
-    "deepseek",
-    "glm",
-    "kimi",
-    "skill",
-    "agent"
-  ],
-  "author": "AIXX",
-  "license": "ISC",
-  "homepage": "https://gitee.com/kk0803/token-hub",
-  "repository": {
-    "type": "git",
-    "url": "https://gitee.com/kk0803/token-hub.git"
-  },
-  "engines": {
-    "node": ">=18"
-  }
-}
+{
+  "name": "aixxai",
+  "version": "1.6.0",
+  "description": "AIXX CLI - 让你的AI调用万物。安装：npx aixxai",
+  "type": "module",
+  "bin": {
+    "aixx": "./bin/aixx.js"
+  },
+  "scripts": {
+    "test": "node bin/aixx.js --version"
+  },
+  "keywords": [
+    "aixx",
+    "ai",
+    "llm",
+    "gateway",
+    "openai",
+    "deepseek",
+    "glm",
+    "kimi",
+    "skill",
+    "agent"
+  ],
+  "author": "AIXX",
+  "license": "ISC",
+  "homepage": "https://gitee.com/kk0803/token-hub",
+  "repository": {
+    "type": "git",
+    "url": "https://gitee.com/kk0803/token-hub.git"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}

package/src/commands/install.js

@@ -69,16 +69,32 @@ function friendlyNetErr(err) {
     : err?.message || String(err);
 }
 
-// 自动注册AIXX账号
-async function autoRegister(baseUrl, refCode) {
+// 自动注册AIXX账号（卡170: New-API注册双锁开启邮箱验证——CLI补邮箱+验证码两步交互；注册成功后自动认领绑定码）
+async function autoRegister(baseUrl, refCode, bindCode) {
   const username = genUsername();
   const password = genPassword();
 
   console.log(`\n📝 正在为你注册AIXX账号...`);
   console.log(`   用户名: ${username}`);
 
+  // 邮箱验证（注册双锁之二）：要邮箱 → 发码 → 收码
+  const email = await ask('   输入你的邮箱（用于接收验证码）: ');
+  if (!email || !/^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(email)) {
+    throw new Error('需要有效的邮箱才能完成注册');
+  }
+  console.log('   正在发送验证码...');
+  const vcUrl = baseUrl.replace(/\/v1$/, '') + '/api/verification_code?email=' + encodeURIComponent(email);
+  const vcResp = await fetch(vcUrl, { signal: AbortSignal.timeout(FETCH_TIMEOUT) });
+  const vcData = await vcResp.json().catch(() => null);
+  if (!vcResp.ok || (vcData && vcData.success === false)) {
+    throw new Error(`验证码发送失败: ${(vcData && vcData.message) || 'HTTP ' + vcResp.status}`);
+  }
+  console.log('   ✅ 验证码已发送到邮箱');
+  const vcode = await ask('   输入收到的验证码: ');
+  if (!vcode) throw new Error('需要邮箱验证码完成注册');
+
   // 注册（带推荐码如果有）
-  const regBody = { username, password };
+  const regBody = { username, password, email, verification_code: vcode };
   if (refCode) {
     regBody.aff_code = refCode;
     console.log(`   推荐码: ${refCode}`);
@@ -181,11 +197,41 @@ async function autoRegister(baseUrl, refCode) {
   const aixxDir = join(homedir(), '.aixx');
   if (!existsSync(aixxDir)) mkdirSync(aixxDir, { recursive: true });
   const fullKey = `sk-${apiKey}`;
+
+  // 卡170: 绑定码认领——注册成功的当下用登录凭证免密码挂到码上，主人在 console 认领后余额并入
+  let claimUrl = null;
+  if (bindCode) {
+    try {
+      const claimUrl0 = baseUrl.replace(/\/v1$/, '') + '/cloudpay/bindcode/claim';
+      const claimResp = await fetch(claimUrl0, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({ code: bindCode, user_token: userToken }),
+        signal: AbortSignal.timeout(FETCH_TIMEOUT),
+      });
+      const claimData = await claimResp.json();
+      if (claimData && claimData.ok) {
+        claimUrl = claimData.claim_url || null;
+        console.log(`\n🔗 绑定码已挂到本机安装身份（${username}）`);
+        console.log(`   登录萬安云后打开下面的链接，余额即并入你的账户：`);
+        console.log(`   ${claimUrl}`);
+        console.log(`   （也可以在控制台「账号设置→绑定安装身份」填 6 位码 ${bindCode}）`);
+      } else {
+        console.log(`\n⚠️  绑定码认领未完成: ${(claimData && claimData.message) || '未知原因'}`);
+        console.log(`   稍后可在控制台「账号设置→绑定安装身份」手动填码 ${bindCode}`);
+      }
+    } catch (e) {
+      console.log(`\n⚠️  绑定码认领网络异常，可稍后在控制台手动填码 ${bindCode}`);
+    }
+  }
+
   writeFileSync(join(aixxDir, 'account.json'), JSON.stringify({
     username,
     apiKey: fullKey,  // 存完整key（本地文件，不进git）
     registeredAt: new Date().toISOString(),
-    refCode: refCode || null
+    refCode: refCode || null,
+    bindCode: bindCode || null,
+    claimUrl: claimUrl || null
   }, null, 2));
 
   console.log(`\n💾 账号信息已保存到 ~/.aixx/account.json`);
@@ -215,10 +261,26 @@ export async function install(subArgs) {
   // 非交互模式：--yes / -y 跳过"按回车确认"（脚本/CI环境用，避免挂死）
   const nonInteractive = subArgs.includes('--yes') || subArgs.includes('-y');
 
-  // 推荐码（取第一个不是flag的参数）
-  const refCode = subArgs.find(a => a && !a.startsWith('-'));
-  if (refCode) {
-    console.log(`📋 推荐码: ${refCode}（推荐人将获得消费分润）\n`);
+  // 卡170(1011): 参数先查云侧区分「绑定码」vs「推荐码」——绑定码走装机认领（免密码绑定云账号），推荐码走 KOL 归因老逻辑
+  const rawArg = subArgs.find(a => a && !a.startsWith('-'));
+  let refCode = null, bindCode = null;
+  if (rawArg) {
+    try {
+      const chkUrl = DEFAULT_BASE_URL.replace(/\/v1$/, '') + '/cloudpay/bindcode/check?code=' + encodeURIComponent(rawArg);
+      const chkResp = await fetch(chkUrl, { signal: AbortSignal.timeout(8000) });
+      const chk = await chkResp.json();
+      if (chk && chk.bind) {
+        bindCode = rawArg.toUpperCase();
+        console.log(`🔗 绑定码: ${bindCode}（装机后余额将并入对应的萬安云账户）\n`);
+      } else {
+        refCode = rawArg;
+        console.log(`📋 推荐码: ${refCode}（推荐人将获得消费分润）\n`);
+      }
+    } catch (e) {
+      // 云侧不可达时按推荐码老行为，不阻断安装
+      refCode = rawArg;
+      console.log(`📋 推荐码: ${refCode}（推荐人将获得消费分润）\n`);
+    }
   }
 
   // 1. 检测Node版本
@@ -266,7 +328,7 @@ export async function install(subArgs) {
       // 放在确认之后：贴已有key的老用户不该看到"①注册账号"这种误导项。
       printInstallPlan();
       try {
-        apiKey = await autoRegister(DEFAULT_BASE_URL, refCode);
+        apiKey = await autoRegister(DEFAULT_BASE_URL, refCode, bindCode);
         keySource = 'registered';
       } catch (err) {
         // 网络/超时类异常给友好提示，业务错误（注册/登录/创建key失败）保留原文
@@ -411,7 +473,7 @@ export async function install(subArgs) {
 function printQuickStart(apiKey) {
   const key = apiKey || '你的API_KEY';
   console.log('⚡ 30秒验证（复制粘贴到终端跑一下）：\n');
-  console.log('curl -s https://baodan.run/v1/chat/completions \\');
+  console.log('curl -s https://console.aixx.ai/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}\'');

package/src/commands/search.js

@@ -1,96 +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 一键开通');
-  }
-}
+/**
+ * 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://www.aixx.vip/cloud.html');
+    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 一键开通');
+  }
+}

package/src/utils/agentconfig.js

@@ -33,7 +33,8 @@ import { randomUUID } from 'crypto';
 
 // AIXX后端地址（去掉/v1，因为ZCode的baseURL要写到主机根，OpenAI的写到/v1）
 // 会话16换门：域名网关入口（HTTPS加密），旧IP:8080仅存量兼容
-const AIXX_HOST = 'https://baodan.run';
+// 卡170(1011)换门二: baodan.run网关/api/*全归爆单后端——统一萬安云自有域名
+const AIXX_HOST = 'https://console.aixx.ai';
 
 // 用 _aixx_managed 标记找供应商时，按"作用域"区分，避免Claude/OpenAI两条记混
 const MANAGED_FLAG = '_aixx_managed';

package/src/utils/download.js

@@ -66,7 +66,7 @@ function getMinimalSkill() {
       '',
       '```bash',
       'export AIXX_API_KEY="sk-你的key"',
-      'export AIXX_BASE_URL="https://baodan.run/v1"',
+      'export AIXX_BASE_URL="https://console.aixx.ai/v1"',
       '```',
       '',
       '## 验证',
@@ -86,7 +86,7 @@ function getMinimalSkill() {
       '',
       '确保设置了环境变量：',
       '- AIXX_API_KEY (你的AIXX key)',
-      '- AIXX_BASE_URL (默认 https://baodan.run/v1)',
+      '- AIXX_BASE_URL (默认 https://console.aixx.ai/v1)',
       '',
       '## 验证',
       '',

package/src/utils/env.js

@@ -11,7 +11,8 @@ import { join } from 'path';
 import { exec } from 'child_process';
 
 // 会话16换门：统一走域名入口（HTTPS加密+CORS白名单+错key锁定+余额脱敏的网关），旧IP:8080仅存量兼容
-const DEFAULT_BASE_URL = 'https://baodan.run/v1';
+// 卡170(1011)换门二: baodan.run网关的/api/*全归爆单后端(CLI注册/login/token 404断链39天)——账号管理与模型调用统一走萬安云自有域名
+const DEFAULT_BASE_URL = 'https://console.aixx.ai/v1';
 
 /**
  * key脱敏：显示为 前6后4 格式（如 sk-NOj3...5Vfe）。

package/templates/QUICKSTART.md

@@ -1,100 +1,100 @@
-# AIXX 快速开始
-
-**一条命令装完即用，30秒开始让AI调用万物。**
-
----
-
-## 安装（唯一需要做的一步）
-
-```bash
-npx aixxai install
-```
-
-装完自动完成：
-1. **自动注册AIXX账号**（免费，送¥5试用额度）并创建你的专属API Key
-2. **自动写入本地配置**（~/.aixx/config.json）
-3. **自动配置本地agent**（ZCode / Claude Code 检测到就自动配好，装完重启agent即可用）
-4. **自动测试连通性**
-
-带推荐码安装（推荐人获消费分润）：`npx aixxai install zhangsan`
-
-脚本/CI等非交互环境：`npx aixxai install --yes`
-
-**不需要手动export任何环境变量。**
-
-## 配置读取顺序（了解即可）
-
-所有AIXX功能（CLI命令、skill）按这个顺序找key，装完即用：
-1. 环境变量 `AIXX_API_KEY`
-2. `~/.aixx/config.json`（install自动写入，兜底主力）
-3. `~/.aixx/account.json`（install自动注册时保存）
-
-忘了key在哪？运行 `npx aixxai config` 查看（key脱敏显示），或直接看 `~/.aixx/` 目录。
-
-## 验证
-
-装完后，让你的 agent 说一句：
-> "帮我用 glm-4-flash 翻译：Hello World"
-
-或运行 `npx aixxai test` 测连通性。
-
-## 进阶：在代码里直接用（OpenAI兼容）
-
-AIXX 兼容 OpenAI 接口。base_url 和 key 在 `~/.aixx/config.json` 里能找到：
-
-```python
-from openai import OpenAI
-
-client = OpenAI(
-    api_key="sk-你的key",
-    base_url="https://baodan.run/v1"
-)
-
-response = client.chat.completions.create(
-    model="glm-4-flash",
-    messages=[{"role": "user", "content": "你好"}]
-)
-print(response.choices[0].message.content)
-```
-
-```javascript
-import OpenAI from "openai";
-
-const client = new OpenAI({
-  apiKey: "sk-你的key",
-  baseURL: "https://baodan.run/v1",
-});
-
-const response = await client.chat.completions.create({
-  model: "glm-4-flash",
-  messages: [{ role: "user", content: "你好" }],
-});
-console.log(response.choices[0].message.content);
-```
-
-> ⚠️ **安全提示**：当前后端用 HTTP 明文传输，存在凭据被嗅探风险，HTTPS 上线后请换用 https 地址。
-
-## 常见问题
-
-**Q: 报错 "Unauthorized"**
-A: API Key 不对，重新运行 `npx aixxai install`，或检查 `~/.aixx/config.json` 里的key是否完整（含 `sk-` 前缀）。
-
-**Q: 报错 "insufficient quota"**
-A: 额度不足，运行 `npx aixxai recharge` 查看充值方式。
-
-**Q: 报错 "model price not configured"**
-A: 该模型未配置价格，联系管理员或换用 glm-4-flash。
-
-**Q: Windows下环境变量没生效？**
-A: 不影响使用——所有命令都会兜底读 `~/.aixx/config.json`。想配环境变量的话重开终端（setx写入的变量对新终端生效）。
-
-## 下一步
-
-- 查看 [`./SKILL.md`](./SKILL.md) 了解完整能力
-- 查看 [`./references/chat.md`](./references/chat.md) 了解LLM调用细节
-- 查看 [`./references/data.md`](./references/data.md) 查社媒/电商数据
-- 查看 [`./references/apps.md`](./references/apps.md) 发通知/推送/邮件
-- 查看 [`./references/account.md`](./references/account.md) 查询用量
-
----
-维护者：龙龙（AIXX PM）| 2026-08-08 建立 | 2026-08-14 更新：装完即用，删手动export（任务书A）
+# AIXX 快速开始
+
+**一条命令装完即用，30秒开始让AI调用万物。**
+
+---
+
+## 安装（唯一需要做的一步）
+
+```bash
+npx aixxai install
+```
+
+装完自动完成：
+1. **自动注册AIXX账号**（免费，送¥5试用额度）并创建你的专属API Key
+2. **自动写入本地配置**（~/.aixx/config.json）
+3. **自动配置本地agent**（ZCode / Claude Code 检测到就自动配好，装完重启agent即可用）
+4. **自动测试连通性**
+
+带推荐码安装（推荐人获消费分润）：`npx aixxai install zhangsan`
+
+脚本/CI等非交互环境：`npx aixxai install --yes`
+
+**不需要手动export任何环境变量。**
+
+## 配置读取顺序（了解即可）
+
+所有AIXX功能（CLI命令、skill）按这个顺序找key，装完即用：
+1. 环境变量 `AIXX_API_KEY`
+2. `~/.aixx/config.json`（install自动写入，兜底主力）
+3. `~/.aixx/account.json`（install自动注册时保存）
+
+忘了key在哪？运行 `npx aixxai config` 查看（key脱敏显示），或直接看 `~/.aixx/` 目录。
+
+## 验证
+
+装完后，让你的 agent 说一句：
+> "帮我用 glm-4-flash 翻译：Hello World"
+
+或运行 `npx aixxai test` 测连通性。
+
+## 进阶：在代码里直接用（OpenAI兼容）
+
+AIXX 兼容 OpenAI 接口。base_url 和 key 在 `~/.aixx/config.json` 里能找到：
+
+```python
+from openai import OpenAI
+
+client = OpenAI(
+    api_key="sk-你的key",
+    base_url="https://console.aixx.ai/v1"
+)
+
+response = client.chat.completions.create(
+    model="glm-4-flash",
+    messages=[{"role": "user", "content": "你好"}]
+)
+print(response.choices[0].message.content)
+```
+
+```javascript
+import OpenAI from "openai";
+
+const client = new OpenAI({
+  apiKey: "sk-你的key",
+  baseURL: "https://console.aixx.ai/v1",
+});
+
+const response = await client.chat.completions.create({
+  model: "glm-4-flash",
+  messages: [{ role: "user", content: "你好" }],
+});
+console.log(response.choices[0].message.content);
+```
+
+> ⚠️ **安全提示**：当前后端用 HTTP 明文传输，存在凭据被嗅探风险，HTTPS 上线后请换用 https 地址。
+
+## 常见问题
+
+**Q: 报错 "Unauthorized"**
+A: API Key 不对，重新运行 `npx aixxai install`，或检查 `~/.aixx/config.json` 里的key是否完整（含 `sk-` 前缀）。
+
+**Q: 报错 "insufficient quota"**
+A: 额度不足，运行 `npx aixxai recharge` 查看充值方式。
+
+**Q: 报错 "model price not configured"**
+A: 该模型未配置价格，联系管理员或换用 glm-4-flash。
+
+**Q: Windows下环境变量没生效？**
+A: 不影响使用——所有命令都会兜底读 `~/.aixx/config.json`。想配环境变量的话重开终端（setx写入的变量对新终端生效）。
+
+## 下一步
+
+- 查看 [`./SKILL.md`](./SKILL.md) 了解完整能力
+- 查看 [`./references/chat.md`](./references/chat.md) 了解LLM调用细节
+- 查看 [`./references/data.md`](./references/data.md) 查社媒/电商数据
+- 查看 [`./references/apps.md`](./references/apps.md) 发通知/推送/邮件
+- 查看 [`./references/account.md`](./references/account.md) 查询用量
+
+---
+维护者：龙龙（AIXX PM）| 2026-08-08 建立 | 2026-08-14 更新：装完即用，删手动export（任务书A）

package/templates/SKILL.md

@@ -33,7 +33,7 @@ AIXX = "AI的谷歌"。装一个skill，agent就能：
 ### 必须触发AIXX的场景
 - **项目/场景类需求（最重要，必须先调推荐接口）**：用户描述要做的事，如"我要做抖音带货""帮我运营小红书""我想让AI帮我发通知"→ **必须先调推荐接口**：
   ```
-  POST https://baodan.run/v1/recommend
+  POST https://console.aixx.ai/v1/recommend
   {"need": "用户的需求原话", "user_profile": "可选，用户是做什么的"}
   ```
   返回组合方案（专业能力+数据接口+应用直连+推荐模型），**必须主动呈现给用户**，别只给模型泛回答。推荐接口免费、不需要key。
@@ -49,7 +49,7 @@ AIXX = "AI的谷歌"。装一个skill，agent就能：
 ### "怪需求"处理规则（明显不在能力库的需求）
 
 需求明显超出AI能力库范围时（如"帮我养电子宠物"），**按这个流程走**：
-1. 先调 `POST https://baodan.run/v1/capability` `{"need": "需求原话"}` 探一下（免费、不需要key）
+1. 先调 `POST https://console.aixx.ai/v1/capability` `{"need": "需求原话"}` 探一下（免费、不需要key）
 2. 命中能力 → 按返回能力正常走
 3. 没命中 → 回复用户："已记下这个需求，AIXX能力库持续扩展中，上架后第一时间告诉你。"（引擎侧有pending机制会自动记录，agent只管这么回复）
 

package/templates/references/aixx-shared.md

@@ -1,59 +1,59 @@
-# AIXX 共享规则
-
-**调用 AIXX 前 MUST 读这份。** 包含环境检查、调用方式、错误处理。
-
----
-
-## 环境检查
-
-调用 AIXX 前，agent 必须确认两个变量：
-
-```
-AIXX_API_KEY   = sk-xxxxx（用户的AIXX key）
-AIXX_BASE_URL  = https://baodan.run/v1（AIXX后端地址）
-```
-
-**如果变量没配**：告诉用户"请先配置 AIXX_API_KEY 和 AIXX_BASE_URL，参考 QUICKSTART.md"
-
-## 调用方式
-
-AIXX 兼容 OpenAI 接口格式。所有调用走：
-
-```
-POST {AIXX_BASE_URL}/chat/completions
-Authorization: Bearer {AIXX_API_KEY}
-Content-Type: application/json
-
-{
-  "model": "glm-4-flash",
-  "messages": [{"role": "user", "content": "用户的需求"}]
-}
-```
-
-**agent 永远不要直接用 openai 库的默认配置调——必须用 AIXX 的 base_url 和 key。**
-
-## 错误处理
-
-| 错误 | 含义 | agent该怎么做 |
-|---|---|---|
-| 401 Unauthorized | key无效或过期 | 提示用户检查key |
-| 402 insufficient quota | 额度不足 | 提示用户充值 |
-| 404 model not found | 模型名不对 | 换用 glm-4-flash（免费默认） |
-| 429 rate limit | 限流 | 等几秒重试 |
-| 5xx | AIXX后端故障 | 告诉用户"稍后再试" |
-
-## 计费说明
-
-- 每次调用按 token 数计费
-- 不同模型价格不同（glm-4-flash 免费）
-- 用户可在账户里查余额和用量
-
-## 输出协议
-
-调用成功后，agent 应该：
-1. 把模型返回的内容**转述给用户**（不要直接吐JSON）
-2. 如果用户问"用了什么模型/花了多少"，调 `/v1/dashboard/billing/usage` 查
-3. 不要暴露技术细节（key、base_url）给用户
-
----
-维护者：龙龙（AIXX PM）| 2026-08-08
+# AIXX 共享规则
+
+**调用 AIXX 前 MUST 读这份。** 包含环境检查、调用方式、错误处理。
+
+---
+
+## 环境检查
+
+调用 AIXX 前，agent 必须确认两个变量：
+
+```
+AIXX_API_KEY   = sk-xxxxx（用户的AIXX key）
+AIXX_BASE_URL  = https://console.aixx.ai/v1（AIXX后端地址）
+```
+
+**如果变量没配**：告诉用户"请先配置 AIXX_API_KEY 和 AIXX_BASE_URL，参考 QUICKSTART.md"
+
+## 调用方式
+
+AIXX 兼容 OpenAI 接口格式。所有调用走：
+
+```
+POST {AIXX_BASE_URL}/chat/completions
+Authorization: Bearer {AIXX_API_KEY}
+Content-Type: application/json
+
+{
+  "model": "glm-4-flash",
+  "messages": [{"role": "user", "content": "用户的需求"}]
+}
+```
+
+**agent 永远不要直接用 openai 库的默认配置调——必须用 AIXX 的 base_url 和 key。**
+
+## 错误处理
+
+| 错误 | 含义 | agent该怎么做 |
+|---|---|---|
+| 401 Unauthorized | key无效或过期 | 提示用户检查key |
+| 402 insufficient quota | 额度不足 | 提示用户充值 |
+| 404 model not found | 模型名不对 | 换用 glm-4-flash（免费默认） |
+| 429 rate limit | 限流 | 等几秒重试 |
+| 5xx | AIXX后端故障 | 告诉用户"稍后再试" |
+
+## 计费说明
+
+- 每次调用按 token 数计费
+- 不同模型价格不同（glm-4-flash 免费）
+- 用户可在账户里查余额和用量
+
+## 输出协议
+
+调用成功后，agent 应该：
+1. 把模型返回的内容**转述给用户**（不要直接吐JSON）
+2. 如果用户问"用了什么模型/花了多少"，调 `/v1/dashboard/billing/usage` 查
+3. 不要暴露技术细节（key、base_url）给用户
+
+---
+维护者：龙龙（AIXX PM）| 2026-08-08