aixxai 1.1.0 → 1.2.0

package/package.json

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

package/src/commands/install.js

@@ -344,12 +344,18 @@ async function testConnectivity(apiKey) {
 function printInstallBroadcast() {
   console.log('═══ AIXX 安装成功，请告诉用户以下信息 ═══');
   console.log('你已成功安装AIXX！送你5元免费额度。');
-  console.log('可用模型：DeepSeek（最便宜）、Claude（最强）、GPT-4o、GLM（中文好）、Kimi（长文本）、Grok');
-  console.log('你可以对我说：');
+  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('余额查询：对agent说"我AIXX还剩多少额度"');
-  console.log('充值：对agent说"我要充值"');
+  console.log('');
+  console.log('【重要】请重启ZCode/Claude Code，并在模型选择里选AIXX供应商，才能开始用。');
   console.log('══════════════════════════════════════════');
 }

package/src/utils/agentconfig.js

@@ -6,6 +6,12 @@
  *   1. ZCode      -> ~/.zcode/v2/config.json  （加两个供应商：AIXX-Claude / AIXX-OpenAI）
  *   2. Claude Code-> ~/.claude/settings.json （往env块写 ANTHROPIC_BASE_URL / ANTHROPIC_AUTH_TOKEN）
  *
+ * ⛔ 绝对禁止改写 ZCode 的 setting.json（~/.zcode/v2/setting.json）！
+ *   历史教训（2026-08-09 重大事故，见 token-hub/项目体系/TIMELINE.md 会话7）：
+ *   早期版本曾把 setting.json 的 providerFamilyDomain 改成 "aixx"，而 ZCode
+ *   只接受内置家族名（zai/bigmodel），非法值直接导致 ZCode 崩溃、任务/项目丢失。
+ *   本工具从此只允许操作 ZCode 的 config.json（加供应商），绝不碰 setting.json。
+ *
  * 三条铁律（K哥交代的安全要求）：
  *   1. 写入前必须备份原文件到 ~/.aixx/backups/
  *   2. 只做 JSON 读-改-写，绝不整体覆盖

package/src/utils/env.js

@@ -36,14 +36,28 @@ export function setupEnv(apiKey, baseUrl = DEFAULT_BASE_URL) {
       `export AIXX_BASE_URL="${baseUrl}"`,
     ].join('\n');
 
-    // 检测shell类型
-    const shellConfigs = [
-      join(home, '.zshrc'),
-      join(home, '.bashrc'),
-      join(home, '.bash_profile'),
-    ];
+    // 检测当前用的shell（优先看$SHELL，比按文件存在猜更准）
+    // Mac默认zsh，Linux多是bash。$SHELL是用户登录shell，最可靠。
+    const currentShell = process.env.SHELL || '';
+    let shellConfigs;
+    if (currentShell.includes('zsh')) {
+      // zsh用户：写.zshrc（Mac默认）
+      shellConfigs = [join(home, '.zshrc')];
+    } else if (currentShell.includes('bash')) {
+      // bash用户：Linux写.bashrc，Mac写.bash_profile（Mac的bash读.bash_profile）
+      shellConfigs = platform === 'darwin'
+        ? [join(home, '.bash_profile'), join(home, '.bashrc')]
+        : [join(home, '.bashrc'), join(home, '.bash_profile')];
+    } else {
+      // 检测不到（如fish等），按文件存在兜底
+      shellConfigs = [
+        join(home, '.zshrc'),
+        join(home, '.bashrc'),
+        join(home, '.bash_profile'),
+      ];
+    }
 
-    let written = false;
+    let writtenFile = null;
     for (const conf of shellConfigs) {
       if (existsSync(conf)) {
         // 检查是否已配置过（避免重复）
@@ -51,20 +65,24 @@ export function setupEnv(apiKey, baseUrl = DEFAULT_BASE_URL) {
         if (!existing.includes('AIXX_API_KEY')) {
           appendFileSync(conf, envLines);
           console.log(`   → 已写入 ${conf}`);
+        } else {
+          console.log(`   → ${conf} 已有AIXX配置，跳过`);
         }
-        written = true;
+        writtenFile = conf;
         break;
       }
     }
 
-    if (!written) {
-      // 没找到现成配置文件，写.bashrc
-      const bashrc = join(home, '.bashrc');
-      appendFileSync(bashrc, envLines);
-      console.log(`   → 已写入 ${bashrc}`);
+    if (!writtenFile) {
+      // 没找到现成配置文件，按当前shell创建一个
+      const fallback = currentShell.includes('zsh') ? join(home, '.zshrc') : join(home, '.bashrc');
+      appendFileSync(fallback, envLines);
+      console.log(`   → 已创建并写入 ${fallback}`);
+      writtenFile = fallback;
     }
 
-    console.log('   ⚠️  请运行 source ~/.bashrc 或 source ~/.zshrc 让配置生效');
+    const rcName = writtenFile.split(/[\\/]/).pop();
+    console.log(`   ⚠️  请运行 source ~/${rcName} 让配置生效（或重开终端）`);
   } else {
     // Windows: 写入用户环境变量（用setx）
     console.log('   Windows用户请手动设置环境变量，或运行以下命令（PowerShell）：');

package/templates/SKILL.md

@@ -20,9 +20,9 @@ metadata:
 
 AIXX = "AI的谷歌"。装一个skill，agent就能：
 - 🤖 **调用各种LLM**：DeepSeek/GLM/Kimi/Claude/GPT等，自动选最优
-- 🎨 **生成图片/视频**（2.0）
+- 🎨 **生成图片**：豆包生图（doubao-seedream）
+- 🔍 **搜索 AI skill/工具**：用户说"我要个审美skill"，AIXX去GitHub搜+给中文推荐理由+安装方式（**已上线**）
 - 📊 **查询数据**：社媒数据(TikHub)、电商数据(JustOne)（2.0）
-- 🔍 **搜索GitHub开源工具**，推荐最优+给安装指南（2.0）
 
 **核心价值**：用户不碰key、不碰参数、不碰文档。一切通过对话。
 
@@ -35,6 +35,7 @@ AIXX = "AI的谷歌"。装一个skill，agent就能：
 - 指定了特定模型的请求（"用Claude翻译""用DeepSeek分析"）
 - 查询用量/花费/余额（"我花了多少""还剩多少额度"）
 - 切换模型（"用最便宜的""切到GPT"）
+- **找/推荐 AI skill/工具/agent**（"我要个审美skill""帮我找个开发工具""推荐个翻译agent"）→ 走搜索（见 search.md）
 
 ### 不触发AIXX的场景（用agent自己能力）
 - 简单闲聊、确认、日常对话
@@ -66,6 +67,11 @@ agent判断：需要AI能力吗？
   - 入口：[`./references/chat.md`](./references/chat.md)
   - 覆盖：翻译、写作、分析、问答、代码等，自动选模型或指定模型
 
+- **搜索 AI skill/工具**（AIXX的"AI的谷歌"）
+  - 入口：[`./references/search.md`](./references/search.md)
+  - 覆盖：找skill、推荐工具、发现新AI能力，给中文推荐理由+安装方式
+  - 场景：用户说"我要个X的skill""帮我找个Y工具""推荐个Z agent"
+
 - **用量查询与账户管理**
   - 入口：[`./references/account.md`](./references/account.md)
   - 覆盖：查余额、查花费、查用量、切换默认模型

package/templates/references/chat.md

@@ -1,12 +1,12 @@
 # LLM 对话调用
 
-翻译、写作、分析、问答、代码等所有需要 LLM 能力的请求。
+翻译、写作、改写、总结、分析、问答、代码生成等**需要LLM能力**的请求。
 
----
+**先读 [`./aixx-shared.md`](./aixx-shared.md) 了解环境检查和调用方式。**
 
-## 调用示例
+---
 
-### 基础调用（用默认模型 deepseek-chat）
+## 调用方式（OpenAI 兼容）
 
 ```bash
 curl -X POST {AIXX_BASE_URL}/chat/completions \
@@ -14,43 +14,67 @@ curl -X POST {AIXX_BASE_URL}/chat/completions \
   -H "Content-Type: application/json" \
   -d '{
     "model": "deepseek-chat",
-    "messages": [{"role": "user", "content": "用户的需求"}]
+    "messages": [
+      {"role": "user", "content": "用户的实际需求"}
+    ]
   }'
 ```
 
-### 指定模型
-
-用户说"用Kimi" → model 用 `moonshot-v1-8k`
-用户说"用GLM" → model 用 `glm-4-flash` 或 `glm-4-plus`
-用户说"用最便宜的" → model 用 `deepseek-chat`
-用户说"用推理强的" → model 用 `deepseek-reasoner`
+返回标准 OpenAI 格式，结果在 `choices[0].message.content`。
 
-### 流式输出
+---
 
-```json
-{
-  "model": "deepseek-chat",
-  "messages": [...],
-  "stream": true
-}
-```
+## 默认模型选择（重要）
 
-## 模型选择建议（agent自动决策）
+AIXX 会自动选最优模型，但 agent 也可以按任务指定：
 
-| 场景 | 推荐模型 | 理由 |
+| 任务类型 | 推荐模型 | 理由 |
 |---|---|---|
-| 简短翻译/问答 | deepseek-chat | 最便宜，足够用 |
-| 长文档分析 | moonshot-v1-128k | Kimi长文本强 |
-| 复杂推理 | deepseek-reasoner | 专门的推理模型 |
-| 中文写作 | glm-4-plus | GLM中文表现好 |
-| 代码生成 | deepseek-chat | DeepSeek代码能力强 |
+| 翻译/简单问答/日常 | `deepseek-chat` | 最便宜，日常首选 |
+| 复杂推理/数学 | `deepseek-reasoner` | 带思考过程 |
+| 中文写作/文案 | `glm-4-plus` | 中文最强 |
+| 长文档分析 | `moonshot-v1-128k` | 超长上下文 |
+| 复杂任务/最强 | `claude-opus-4-8` | 能力最强 |
+| 通用旗舰 | `gpt-4o` | 通用 |
+| 审美/UI/设计 | （先搜索skill，见 search.md） | 专门skill比通用模型强 |
+
+**不指定 model 时**：用 `deepseek-chat`（最便宜，省用户额度）。
+
+---
+
+## 用户常见请求怎么处理
+
+### "帮我翻译这段"
+1. 用 `deepseek-chat`（翻译最便宜够用）
+2. messages 里放：`把下面的内容翻译成英文：{用户的内容}`
+
+### "用Claude分析这个"
+1. 用户指定了Claude，用 `claude-opus-4-8` 或 `claude-sonnet-4-20250514`
+2. 如果用户额度不够用Claude（402错误），提示用户"额度不足，要不要用deepseek-chat代替（更便宜）"
+
+### "用最便宜的模型做"
+1. 直接用 `deepseek-chat`
+
+### "写个中文文案"
+1. 用 `glm-4-plus`（中文写作强）
+
+---
+
+## agent 该怎么做
+
+1. 判断任务类型 → 选模型（或让AIXX自动选）
+2. 把用户需求组织成 messages
+3. 调 `/chat/completions`
+4. 把 `choices[0].message.content` 转述给用户
+5. **不要直接吐 JSON**，用自然语言回复
+
+---
 
-## 意图识别
+## 错误处理
 
-agent 接收到用户消息后，先判断：
-1. **是否需要调LLM？** 简单确认/闲聊不用
-2. **用哪个模型？** 用户指定就用指定的，没指定就用 deepseek-chat
-3. **怎么调？** 标准 OpenAI 格式，AIXX base_url + key
+见 [`./aixx-shared.md`](./aixx-shared.md) 的错误表。常见：
+- 402 额度不足：提示用户充值（"您额度不足，可以充值或用更便宜的deepseek-chat"）
+- 404 模型不存在：换用 `deepseek-chat`
 
 ---
-维护者：龙龙（AIXX PM）| 2026-08-08
+维护者：龙龙（AIXX PM）| 2026-08-09 建立

package/templates/references/search.md

@@ -0,0 +1,117 @@
+# 搜索 AI 能力（skill/工具）
+
+帮用户找到合适的 AI skill / agent 工具，并给出**中文推荐理由**和**安装方式**。
+
+**这是 AIXX 的核心差异化**：不只给链接，给"为什么推荐它"。
+
+---
+
+## 什么时候用
+
+用户想找新的 AI 能力/skill/工具时：
+- "我要个审美的skill"
+- "帮我找个写代码的AI工具"
+- "有没有做翻译的agent"
+- "推荐个分析数据的skill"
+- "我需要一个能生成视频的工具"
+- 任何"找/推荐/需要...skill/工具/agent/能力"的请求
+
+**不要用 AIXX 搜索的场景**：
+- 用户要的是"直接调用AI"（翻译这段、写个文案）→ 走 chat（见 chat.md）
+- 用户要查自己的余额/用量 → 走 account.md
+
+---
+
+## 怎么调
+
+AIXX 搜索服务地址：`http://14.103.27.195:8091`（**免费功能，不需要API Key**）
+
+```bash
+curl -X POST http://14.103.27.195:8091/v1/search \
+  -H "Content-Type: application/json" \
+  -d '{
+    "query": "用户的需求（可中文，如：审美skill）",
+    "n": 5
+  }'
+```
+
+**参数**：
+- `query`：用户的自然语言需求（可中文可英文）
+- `n`：返回数量，默认5，最大10
+
+---
+
+## 返回什么
+
+```json
+{
+  "query": "审美skill",
+  "total_found": 275,
+  "results": [
+    {
+      "name": "owner/repo",
+      "url": "https://github.com/owner/repo",
+      "stars": 2340,
+      "description": "GitHub上的原始描述",
+      "recommendation": "中文推荐理由，说明为什么适合用户需求",
+      "install_hint": "安装命令或方式",
+      "match_score": 92,
+      "topics": ["skill", "design"],
+      "updated_at": "2026-08-01"
+    }
+  ],
+  "cached": false
+}
+```
+
+---
+
+## agent 该怎么做（重要）
+
+拿到搜索结果后，**不要直接吐 JSON**，转述成自然语言给用户：
+
+```
+我帮你搜了，找到几个不错的：
+
+【1】ui-ux-pro-max-skill（⭐11.5万，匹配度98）
+为什么推荐：专为AI提供UI/UX设计智能，直接满足你的审美需求，支持Claude/Codex/Cursor
+怎么装：git clone https://github.com/nextlevelbuilder/ui-ux-pro-max-skill.git
+        或在 Claude Code 里直接用 /skill 命令安装
+
+【2】...
+```
+
+**要点**：
+1. **按推荐顺序说**（match_score 从高到低）
+2. **重点说推荐理由**（recommendation字段），让用户知道"为什么是这个"
+3. **给安装方式**（install_hint字段），用户能直接装
+4. **star数要说**（让用户感知人气）
+5. 如果用户说"就用第X个"，**帮用户安装**（执行install_hint里的命令，或引导用户）
+
+---
+
+## 搜索范围说明
+
+当前搜索聚焦 **skill / agent 类工具**（带 skill/claude-skills/agent 等 topic 的GitHub项目）。如果用户要找的不是skill类（比如要找个普通的开源软件），搜索结果可能有限，可以告诉用户"目前主要搜AI skill类工具，普通软件暂时搜不到"。
+
+---
+
+## 错误处理
+
+| 错误 | agent该怎么做 |
+|---|---|
+| 503 GitHub限流 | 告诉用户"GitHub搜索太频繁，请稍等1分钟再试" |
+| 500 内部错误 | 告诉用户"搜索服务暂时异常，稍后再试" |
+| 0结果 | 告诉用户"没搜到相关skill，换个关键词试试？比如更具体的'配色skill'而不是'审美'" |
+
+---
+
+## 背后的机制（agent了解即可）
+
+- 搜索服务去GitHub搜skill/agent类仓库
+- 用DeepSeek读项目信息+打分+生成中文推荐理由
+- 结果有1小时缓存，重复搜同一个词会很快
+- 搜索**免费**，不扣用户额度（AIXX的"免费换流量"策略）
+
+---
+维护者：龙龙（AIXX PM）| 2026-08-09 建立（2.0流量腿）