aixxai 1.6.0 → 1.6.2

package/src/commands/test.js

@@ -1,91 +1,91 @@
-/**
- * AIXX CLI - test 命令
- * 测试AIXX是否可用
- */
-
-import { DEFAULT_BASE_URL } from '../../bin/aixx.js';
-import { loadApiKey, maskKey } from '../utils/env.js';
-
-export async function test(subArgs) {
-  console.log('╔══════════════════════════════════════════╗');
-  console.log('║      AIXX 连通性测试                       ║');
-  console.log('╚══════════════════════════════════════════╝\n');
-
-  // 统一配置链：环境变量 → ~/.aixx/config.json → ~/.aixx/account.json
-  const apiKey = loadApiKey();
-  const baseUrl = process.env.AIXX_BASE_URL || DEFAULT_BASE_URL;
-
-  if (!apiKey) {
-    console.error('❌ 未找到AIXX API Key');
-    console.error('   运行 npx aixxai install 配置，或设置环境变量 AIXX_API_KEY');
-    process.exit(1);
-  }
-
-  console.log(`测试地址: ${baseUrl}`);
-  console.log(`使用Key: ${maskKey(apiKey)}\n`);
-
-  // 1. 测试模型列表（带key调 /v1/models，这才是真实的可用性验证）
-  let modelCount = 0;
-  console.log('1️⃣  获取可用模型列表...');
-  try {
-    const resp = await fetch(`${baseUrl}/models`, {
-      headers: { 'Authorization': `Bearer ${apiKey}` }
-    });
-    if (resp.ok) {
-      const data = await resp.json();
-      const models = data.data || data.models || [];
-      modelCount = models.length;
-      console.log(`   ✅ 可用模型 (${models.length}个):`);
-      models.slice(0, 10).forEach(m => {
-        const id = typeof m === 'string' ? m : m.id;
-        console.log(`      • ${id}`);
-      });
-      if (models.length > 10) console.log(`      ... 还有 ${models.length - 10} 个`);
-    } else if (resp.status === 401) {
-      console.error('   ❌ API Key 无效（401）');
-      process.exit(1);
-    } else if (resp.status === 404) {
-      console.error(`   ❌ 接口404，检查 AIXX_BASE_URL 是否正确（当前: ${baseUrl}）`);
-      process.exit(1);
-    } else {
-      console.error(`   ❌ 返回 ${resp.status}`);
-      process.exit(1);
-    }
-  } catch (err) {
-    console.error(`   ❌ 失败: ${err.message}`);
-    process.exit(1);
-  }
-
-  // 2. 测试实际调用
-  console.log('\n2️⃣  测试调用 deepseek-chat...');
-  try {
-    const resp = await fetch(`${baseUrl}/chat/completions`, {
-      method: 'POST',
-      headers: {
-        'Authorization': `Bearer ${apiKey}`,
-        'Content-Type': 'application/json'
-      },
-      body: JSON.stringify({
-        model: 'deepseek-chat',
-        messages: [{ role: 'user', content: '说"测试成功"三个字' }],
-        max_tokens: 20
-      })
-    });
-    if (resp.ok) {
-      const data = await resp.json();
-      const reply = data.choices?.[0]?.message?.content || '(空回复)';
-      const usage = data.usage || {};
-      console.log(`   ✅ 调用成功！`);
-      console.log(`   模型回复: ${reply}`);
-      console.log(`   Token用量: ${usage.total_tokens || '?'}`);
-    } else {
-      const errData = await resp.json().catch(() => ({}));
-      console.error(`   ❌ 调用失败 (${resp.status}): ${errData.error?.message || resp.statusText}`);
-      if (resp.status === 402) console.error('   提示: 额度不足，请充值');
-    }
-  } catch (err) {
-    console.error(`   ❌ 网络错误: ${err.message}`);
-  }
-
-  console.log('\n测试完成。\n');
-}
+/**
+ * AIXX CLI - test 命令
+ * 测试AIXX是否可用
+ */
+
+import { DEFAULT_BASE_URL } from '../../bin/aixx.js';
+import { loadApiKey, maskKey } from '../utils/env.js';
+
+export async function test(subArgs) {
+  console.log('╔══════════════════════════════════════════╗');
+  console.log('║      AIXX 连通性测试                       ║');
+  console.log('╚══════════════════════════════════════════╝\n');
+
+  // 统一配置链：环境变量 → ~/.aixx/config.json → ~/.aixx/account.json
+  const apiKey = loadApiKey();
+  const baseUrl = process.env.AIXX_BASE_URL || DEFAULT_BASE_URL;
+
+  if (!apiKey) {
+    console.error('❌ 未找到AIXX API Key');
+    console.error('   运行 npx aixxai install 配置，或设置环境变量 AIXX_API_KEY');
+    process.exit(1);
+  }
+
+  console.log(`测试地址: ${baseUrl}`);
+  console.log(`使用Key: ${maskKey(apiKey)}\n`);
+
+  // 1. 测试模型列表（带key调 /v1/models，这才是真实的可用性验证）
+  let modelCount = 0;
+  console.log('1️⃣  获取可用模型列表...');
+  try {
+    const resp = await fetch(`${baseUrl}/models`, {
+      headers: { 'Authorization': `Bearer ${apiKey}` }
+    });
+    if (resp.ok) {
+      const data = await resp.json();
+      const models = data.data || data.models || [];
+      modelCount = models.length;
+      console.log(`   ✅ 可用模型 (${models.length}个):`);
+      models.slice(0, 10).forEach(m => {
+        const id = typeof m === 'string' ? m : m.id;
+        console.log(`      • ${id}`);
+      });
+      if (models.length > 10) console.log(`      ... 还有 ${models.length - 10} 个`);
+    } else if (resp.status === 401) {
+      console.error('   ❌ API Key 无效（401）');
+      process.exit(1);
+    } else if (resp.status === 404) {
+      console.error(`   ❌ 接口404，检查 AIXX_BASE_URL 是否正确（当前: ${baseUrl}）`);
+      process.exit(1);
+    } else {
+      console.error(`   ❌ 返回 ${resp.status}`);
+      process.exit(1);
+    }
+  } catch (err) {
+    console.error(`   ❌ 失败: ${err.message}`);
+    process.exit(1);
+  }
+
+  // 2. 测试实际调用
+  console.log('\n2️⃣  测试调用 deepseek-chat...');
+  try {
+    const resp = await fetch(`${baseUrl}/chat/completions`, {
+      method: 'POST',
+      headers: {
+        'Authorization': `Bearer ${apiKey}`,
+        'Content-Type': 'application/json'
+      },
+      body: JSON.stringify({
+        model: 'deepseek-chat',
+        messages: [{ role: 'user', content: '说"测试成功"三个字' }],
+        max_tokens: 20
+      })
+    });
+    if (resp.ok) {
+      const data = await resp.json();
+      const reply = data.choices?.[0]?.message?.content || '(空回复)';
+      const usage = data.usage || {};
+      console.log(`   ✅ 调用成功！`);
+      console.log(`   模型回复: ${reply}`);
+      console.log(`   Token用量: ${usage.total_tokens || '?'}`);
+    } else {
+      const errData = await resp.json().catch(() => ({}));
+      console.error(`   ❌ 调用失败 (${resp.status}): ${errData.error?.message || resp.statusText}`);
+      if (resp.status === 402) console.error('   提示: 额度不足，请充值');
+    }
+  } catch (err) {
+    console.error(`   ❌ 网络错误: ${err.message}`);
+  }
+
+  console.log('\n测试完成。\n');
+}

package/templates/QUICKSTART.md

@@ -11,7 +11,7 @@ npx aixxai install
 ```
 
 装完自动完成：
-1. **自动注册AIXX账号**（免费，送¥5试用额度）并创建你的专属API Key
+1. **自动注册AIXX账号**（免费，送$0.5试用额度）并创建你的专属API Key
 2. **自动写入本地配置**（~/.aixx/config.json）
 3. **自动配置本地agent**（ZCode / Claude Code 检测到就自动配好，装完重启agent即可用）
 4. **自动测试连通性**

package/templates/references/account.md

@@ -6,6 +6,16 @@
 
 ## 查余额
 
+**首选（真实美元余额，直接报给用户）**：
+
+```bash
+curl "https://console.aixx.ai/cloudpay/balance?api_key=$AIXX_API_KEY"
+```
+
+返回 `{"ok":true,"balance_usd":162.52,...}` → 告诉用户"余额 $162.52"。
+
+备选（只查额度上限）：
+
 ```bash
 curl {AIXX_BASE_URL}/dashboard/billing/subscription \
   -H "Authorization: Bearer {AIXX_API_KEY}"
@@ -48,15 +58,15 @@ agent 应该：
 
 ### 方式1：信用卡/ApplePay（推荐）
 引导用户运行命令：`npx aixxai recharge`，会生成支付链接。
-或直接告诉用户登录后台充值：`http://14.103.27.195:8080`（网页后台，暂用旧地址）
+或让用户打开个人中心充值：**https://console.aixx.ai/console-app.html**
 
 ### 方式2：USDT（加密货币）
-引导用户访问 `http://14.103.27.195:8000` （AIXX的USDT充值页面），按提示操作。
+同样引导到个人中心：**https://console.aixx.ai/console-app.html**（充值页内按提示操作）。
 
 ### agent该怎么说
 "你可以用这两种方式充值：
-1. 信用卡/ApplePay：运行 \`npx aixxai recharge\`，或登录 http://14.103.27.195:8080（网页后台）
-2. USDT加密货币：访问 http://14.103.27.195:8000
+1. 信用卡/ApplePay：运行 \`npx aixxai recharge\`，或打开 https://console.aixx.ai/console-app.html
+2. USDT加密货币：同样在个人中心充值页按提示操作
 
 充完后对我说'充好了'，我帮你查到账没。"
 

package/templates/references/apps.md

@@ -9,9 +9,11 @@
 ## 订阅制（统一价格）
 
 - **¥2.99/月，全部10个应用不限次使用**（不是每个应用单独买）
+
+> 📌 和用户说清楚：应用直连是**独立订阅**（¥2.99/月全应用包月），与技能商店的**买断制**（$1.99/个永久）是两套产品，用户混淆时先讲清区别再推荐。
 - 购买：调下单接口，`plan` 固定传 `app_monthly`：
   ```bash
-  curl -X POST http://14.103.27.195/v1/capability/{id}/purchase \
+  curl -X POST https://aixx.ai/v1/capability/{id}/purchase \
     -H "Content-Type: application/json" \
     -d '{"plan": "app_monthly", "user_compute_key": "sk-用户的key"}'
   ```
@@ -20,7 +22,7 @@
 ## 执行（所有应用统一格式）
 
 ```bash
-curl -X POST http://14.103.27.195/v1/capability/{id}/execute \
+curl -X POST https://aixx.ai/v1/capability/{id}/execute \
   -H "Content-Type: application/json" \
   -d '{
     "params": { "参数": "值" },
@@ -28,7 +30,7 @@ curl -X POST http://14.103.27.195/v1/capability/{id}/execute \
   }'
 ```
 
-能力层地址：`http://14.103.27.195/v1`（和LLM对话的 `{AIXX_BASE_URL}` 不是同一个入口）。
+能力层地址：`https://aixx.ai/v1`（和LLM对话的 `{AIXX_BASE_URL}` 不是同一个入口）。
 
 ---
 

package/templates/references/chat.md

@@ -1,135 +1,137 @@
-# LLM 对话调用
-
-翻译、写作、改写、总结、分析、问答、代码生成等**需要LLM能力**的请求。
-
-**先读 [`./aixx-shared.md`](./aixx-shared.md) 了解环境检查和调用方式。**
-
----
-
-## 调用方式（OpenAI 兼容）
-
-```bash
-curl -X POST {AIXX_BASE_URL}/chat/completions \
-  -H "Authorization: Bearer {AIXX_API_KEY}" \
-  -H "Content-Type: application/json" \
-  -d '{
-    "model": "glm-4-flash",
-    "messages": [
-      {"role": "user", "content": "用户的实际需求"}
-    ]
-  }'
-```
-
-返回标准 OpenAI 格式，结果在 `choices[0].message.content`。
-
----
-
-## 默认模型选择（重要）
-
-AIXX 会自动选最优模型，但 agent 也可以按任务指定。
-
-> **模型列表持续更新，调 `GET /v1/models` 获取最新，下表仅场景参考。**
-
-| 任务类型 | 推荐模型 | 理由 |
-|---|---|---|
-| 翻译/简单问答/日常 | `glm-4-flash` | 免费，日常首选 |
-| 复杂推理/数学 | `kimi-k2.6` | 带思考过程（deepseek-reasoner 已下架） |
-| 中文写作/文案 | `glm-4-plus` | GLM旗舰，中文质量档 |
-| 长文档分析 | `moonshot-v1-128k` | 超长上下文 |
-| 复杂任务/最强 | `claude-opus-4-8` | 能力最强 |
-| 通用旗舰 | `gpt-5.5` | 通用 |
-| 审美/UI/设计 | （先搜索skill，见 search.md） | 专门skill比通用模型强 |
-| agent/工具调用 | `deepseek-chat` | 支持 function calling（glm-4-flash 不支持） |
-
-> ⚠️ **推理类模型（kimi-k2.6 / claude系思考模型等）**：max_tokens 要给足（≥2000）。思考token计入max_tokens预算，给小了会返回空内容。
-
-**不指定 model 时**：用 `glm-4-flash`（免费，省用户额度）；需工具调用的 agent 场景用 `deepseek-chat`。
-
----
-
-## 用户常见请求怎么处理
-
-### "帮我翻译这段"
-1. 用 `glm-4-flash`（翻译免费够用）
-2. messages 里放：`把下面的内容翻译成英文：{用户的内容}`
-
-### "用Claude分析这个"
-1. 用户指定了Claude，用 `claude-opus-4-8` 或 `claude-sonnet-4-20250514`
-2. 如果用户额度不够用Claude（402错误），提示用户"额度不足，要不要用glm-4-flash代替（免费）"
-
-### "用最便宜的模型做"
-1. 直接用 `deepseek-chat`
-
-### "写个中文文案"
-1. 用 `deepseek-chat`（中文能力够用且便宜；glm渠道维护中，恢复后可用 `glm-4-plus`）
-
----
-
-## agent 该怎么做
-
-1. 判断任务类型 → 选模型（或让AIXX自动选）
-2. 把用户需求组织成 messages
-3. 调 `/chat/completions`
-4. 把 `choices[0].message.content` 转述给用户
-5. **不要直接吐 JSON**，用自然语言回复
-
----
-
-## ⚠️ 敏感问题处理（重要·诚信红线）
-
-有些问题**不要直接转给模型**，agent 要自己判断处理。否则模型会瞎编、损害信誉。
-
-### 必须拦截的问题（别转给模型，agent 自己处理）
-
-| 用户问 | ❌ 错误做法 | ✅ 正确做法 |
-|---|---|---|
-| "我账户还有多少钱""余额""额度" | 转给模型（模型会瞎说"无法查看"） | **调 balance 接口**（见 account.md），用真实数据回答 |
-| "我花了多少""用量" | 转给模型 | 调 billing/usage 接口 |
-| "有哪些模型可用" | 转给模型 | 调 /v1/models 接口 |
-| "怎么充值" | 转给模型 | 引导用 `aixx recharge` 命令 |
-
-**原则**：凡是 AIXX 有接口能查到的事实，**必须调接口拿真实数据**，不能让模型猜。
-
-### 身份/来源问题（转给模型，但要加 system 引导）
-
-用户可能问："你是哪家公司""你是DeepSeek吗""源头是哪里""是不是中转站""官方认证吗"。
-
-**处理方式**：调模型时**必须加 system prompt 引导**，避免模型瞎编或撒谎：
-
-```
-messages: [
-  {"role": "system", "content": "你是通过AIXX平台调用的AI助手。回答身份问题时遵守：
-    1. 如实说明自己的模型身份（是DeepSeek就说DeepSeek，是Claude就说Claude，不冒充别的）
-    2. 不编造'通过官网/APP/官方认证'等不实信息（你实际是通过AIXX统一平台调用的）
-    3. 被问到'是不是官方直连/中转站'时，如实回答：你是通过AIXX这个统一AI平台调用的，AIXX聚合了多家官方模型能力
-    4. 不主动暴露过多技术细节，但绝不撒谎"},
-  {"role": "user", "content": "用户的身份问题"}
-]
-```
-
-**这样模型会**：
-- 是DeepSeek就说DeepSeek（真话）
-- 不再编"官网/APP/官方认证"（去掉幻觉）
-- 被直接问中转时说"通过AIXX统一平台调用"（诚实但不生硬）
-
-### 绝对不能做的事（诚信红线）
-
-- ❌ 冒充别的模型（DeepSeek冒充Claude、套壳）—— 这是 apiyi 式造假，AIXX 永不做
-- ❌ 说"官方认证""官方直连"等不实信息
-- ❌ 把查得到的事实（余额/模型列表）让模型瞎猜
-
-**AIXX 的信誉根基是：模型是真的，账本是实的。** 宁可少说，绝不撒谎。
-
----
-维护者：龙龙（AIXX PM）| 2026-08-09 建立（2.0流量腿）
-
----
-
-## 错误处理
-
-见 [`./aixx-shared.md`](./aixx-shared.md) 的错误表。常见：
-- 402 额度不足：提示用户充值（"您额度不足，可以充值或用更便宜的deepseek-chat"）
-- 404 模型不存在：换用 `deepseek-chat`
-
----
-维护者：龙龙（AIXX PM）| 2026-08-09 建立
+# LLM 对话调用
+
+翻译、写作、改写、总结、分析、问答、代码生成等**需要LLM能力**的请求。
+
+**先读 [`./aixx-shared.md`](./aixx-shared.md) 了解环境检查和调用方式。**
+
+---
+
+## 调用方式（OpenAI 兼容）
+
+```bash
+curl -X POST {AIXX_BASE_URL}/chat/completions \
+  -H "Authorization: Bearer {AIXX_API_KEY}" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "model": "glm-4-flash",
+    "messages": [
+      {"role": "user", "content": "用户的实际需求"}
+    ]
+  }'
+```
+
+返回标准 OpenAI 格式，结果在 `choices[0].message.content`。
+
+---
+
+## 默认模型选择（重要）
+
+AIXX 会自动选最优模型，但 agent 也可以按任务指定。
+
+> **模型列表持续更新，调 `GET /v1/models` 获取最新，下表仅场景参考。**
+
+| 任务类型 | 推荐模型 | 理由 |
+|---|---|---|
+| 翻译/简单问答/日常 | `glm-4-flash` | 免费，日常首选 |
+| 复杂推理/数学 | `kimi-k2.6` | 带思考过程（deepseek-reasoner 已下架） |
+| 中文写作/文案 | `glm-4-plus` | GLM旗舰，中文质量档 |
+| 长文档分析 | `moonshot-v1-128k` | 超长上下文 |
+| 复杂任务/最强 | `claude-opus-4-7` | 能力最强（调前先过 /v1/models 确认） |
+| 通用旗舰 | `gpt-5` | 通用 |
+| 审美/UI/设计 | （先搜索skill，见 search.md） | 专门skill比通用模型强 |
+| agent/工具调用 | `deepseek-chat` | 支持 function calling（glm-4-flash 不支持） |
+
+> ⚠️ **铁律：任何模型名先过 GET /v1/models 确认再调——渠道会上下架，下表只是参考（2026-10-12教训：文档推荐的 claude-sonnet-4-20250514 已无渠道）。**
+> ⚠️ **推理类模型（kimi-k2.6 / claude系思考模型等）**：max_tokens 要给足（≥2000）。思考token计入max_tokens预算，给小了会返回空内容。
+
+**不指定 model 时**：用 `glm-4-flash`（免费，省用户额度）；需工具调用的 agent 场景用 `deepseek-chat`。
+
+---
+
+## 用户常见请求怎么处理
+
+### "帮我翻译这段"
+1. 用 `glm-4-flash`（翻译免费够用）
+2. messages 里放：`把下面的内容翻译成英文：{用户的内容}`
+
+### "用Claude分析这个"
+1. 用户指定了Claude，用 `claude-sonnet-4-6` 或 `claude-opus-4-7`（模型名以 GET /v1/models 实时列表为准；调不通就自动降级 glm-4-flash 并如实告知用户）
+2. 如果用户额度不够用Claude（402错误），提示用户"额度不足，要不要用glm-4-flash代替（免费）"
+
+### "用最便宜的模型做"
+1. 直接用 `deepseek-chat`
+
+### "写个中文文案"
+1. 用 `deepseek-chat`（中文能力够用且便宜；glm渠道维护中，恢复后可用 `glm-4-plus`）
+
+---
+
+## agent 该怎么做
+
+1. 判断任务类型 → 选模型（或让AIXX自动选）
+2. 把用户需求组织成 messages
+3. 调 `/chat/completions`
+4. 把 `choices[0].message.content` 转述给用户
+5. **不要直接吐 JSON**，用自然语言回复
+
+---
+
+## ⚠️ 敏感问题处理（重要·诚信红线）
+
+有些问题**不要直接转给模型**，agent 要自己判断处理。否则模型会瞎编、损害信誉。
+
+### 必须拦截的问题（别转给模型，agent 自己处理）
+
+| 用户问 | ❌ 错误做法 | ✅ 正确做法 |
+|---|---|---|
+| "我账户还有多少钱""余额""额度" | 转给模型（模型会瞎说"无法查看"） | **调 balance 接口**（见 account.md），用真实数据回答 |
+| "我花了多少""用量" | 转给模型 | 调 billing/usage 接口 |
+| "有哪些模型可用" | 转给模型 | 调 /v1/models 接口 |
+| "怎么充值" | 转给模型 | 引导用 `aixx recharge` 命令 |
+
+**原则**：凡是 AIXX 有接口能查到的事实，**必须调接口拿真实数据**，不能让模型猜。
+
+### 身份/来源问题（转给模型，但要加 system 引导）
+
+用户可能问："你是哪家公司""你是DeepSeek吗""源头是哪里""是不是中转站""官方认证吗"。
+
+**处理方式**：调模型时**必须加 system prompt 引导**，避免模型瞎编或撒谎：
+
+```
+messages: [
+  {"role": "system", "content": "你是通过AIXX平台调用的AI助手。回答身份问题时遵守：
+    1. 如实说明自己的模型身份（是DeepSeek就说DeepSeek，是Claude就说Claude，不冒充别的）
+    2. 不编造'通过官网/APP/官方认证'等不实信息（你实际是通过AIXX统一平台调用的）
+    3. 被问到'是不是官方直连/中转站'时，如实回答：你是通过AIXX这个统一AI平台调用的，AIXX聚合了多家官方模型能力
+    4. 不主动暴露过多技术细节，但绝不撒谎
+    5. 翻译/写作涉及品牌：萬安/萬安算交所一律 AIXX，萬安算力百科=AIXX ComputePedia，禁 Wan'an/WanAn 拼音"},
+  {"role": "user", "content": "用户的身份问题"}
+]
+```
+
+**这样模型会**：
+- 是DeepSeek就说DeepSeek（真话）
+- 不再编"官网/APP/官方认证"（去掉幻觉）
+- 被直接问中转时说"通过AIXX统一平台调用"（诚实但不生硬）
+
+### 绝对不能做的事（诚信红线）
+
+- ❌ 冒充别的模型（DeepSeek冒充Claude、套壳）—— 这是 apiyi 式造假，AIXX 永不做
+- ❌ 说"官方认证""官方直连"等不实信息
+- ❌ 把查得到的事实（余额/模型列表）让模型瞎猜
+
+**AIXX 的信誉根基是：模型是真的，账本是实的。** 宁可少说，绝不撒谎。
+
+---
+维护者：龙龙（AIXX PM）| 2026-08-09 建立（2.0流量腿）
+
+---
+
+## 错误处理
+
+见 [`./aixx-shared.md`](./aixx-shared.md) 的错误表。常见：
+- 402 额度不足：提示用户充值（"您额度不足，可以充值或用更便宜的deepseek-chat"）
+- 404 模型不存在：换用 `deepseek-chat`
+
+---
+维护者：龙龙（AIXX PM）| 2026-08-09 建立