aixxai 1.4.2 → 1.4.4

package/src/utils/env.js

@@ -1,136 +1,136 @@
-/**
- * 环境变量配置工具
- *
- * 把AIXX_API_KEY和AIXX_BASE_URL写入用户的shell配置
- * 支持 bash/zsh (Linux/macOS) 和 PowerShell (Windows)
- */
-
-import { existsSync, readFileSync, writeFileSync, mkdirSync, appendFileSync } from 'fs';
-import { homedir } from 'os';
-import { join } from 'path';
-import { exec } from 'child_process';
-
-// ⚠️ 安全警告：当前用HTTP明文传输API Key（http://），存在凭据被嗅探风险。
-// TODO（安全）：后端配置好HTTPS证书后，把下面的 URL 改为 'https://14.103.27.195:8080/v1'。
-const DEFAULT_BASE_URL = 'http://14.103.27.195:8080/v1';
-
-/**
- * key脱敏：显示为 前6后4 格式（如 sk-NOj3...5Vfe）。
- * 所有命令的输出里，key一律用这个函数处理，绝不打印完整key。
- */
-export function maskKey(key) {
-  if (!key || typeof key !== 'string') return '';
-  if (key.length <= 10) return key.slice(0, 6) + '...';
-  return `${key.slice(0, 6)}...${key.slice(-4)}`;
-}
-
-/**
- * 统一配置读取链（所有子命令共用，别各自为政）：
- *   环境变量 AIXX_API_KEY → ~/.aixx/config.json → ~/.aixx/account.json
- * 返回 key 字符串，找不到返回 null。
- */
-export function loadApiKey() {
-  if (process.env.AIXX_API_KEY) return process.env.AIXX_API_KEY;
-  const home = homedir();
-  for (const file of [join(home, '.aixx', 'config.json'), join(home, '.aixx', 'account.json')]) {
-    if (!existsSync(file)) continue;
-    try {
-      const conf = JSON.parse(readFileSync(file, 'utf-8'));
-      if (conf.AIXX_API_KEY || conf.apiKey) return conf.AIXX_API_KEY || conf.apiKey;
-    } catch (e) {
-      // 单个文件解析失败就试下一个
-    }
-  }
-  return null;
-}
-
-export async function setupEnv(apiKey, baseUrl = DEFAULT_BASE_URL) {
-  const platform = process.platform;
-  const home = homedir();
-
-  // 1. 写入AIXX本地配置文件（所有平台通用）
-  const aixxDir = join(home, '.aixx');
-  if (!existsSync(aixxDir)) mkdirSync(aixxDir, { recursive: true });
-  const configFile = join(aixxDir, 'config.json');
-  writeFileSync(configFile, JSON.stringify({
-    AIXX_API_KEY: apiKey,
-    AIXX_BASE_URL: baseUrl,
-    configuredAt: new Date().toISOString()
-  }, null, 2));
-
-  // 2. 写入shell配置（Linux/macOS）
-  if (platform !== 'win32') {
-    const envLines = [
-      ``,
-      `# AIXX 配置 (由 aixxai 添加)`,
-      `export AIXX_API_KEY="${apiKey}"`,
-      `export AIXX_BASE_URL="${baseUrl}"`,
-    ].join('\n');
-
-    // 检测当前用的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 writtenFile = null;
-    for (const conf of shellConfigs) {
-      if (existsSync(conf)) {
-        // 检查是否已配置过（避免重复）
-        const existing = readFileSync(conf, 'utf-8');
-        if (!existing.includes('AIXX_API_KEY')) {
-          appendFileSync(conf, envLines);
-          console.log(`   → 已写入 ${conf}`);
-        } else {
-          console.log(`   → ${conf} 已有AIXX配置，跳过`);
-        }
-        writtenFile = conf;
-        break;
-      }
-    }
-
-    if (!writtenFile) {
-      // 没找到现成配置文件，按当前shell创建一个
-      const fallback = currentShell.includes('zsh') ? join(home, '.zshrc') : join(home, '.bashrc');
-      appendFileSync(fallback, envLines);
-      console.log(`   → 已创建并写入 ${fallback}`);
-      writtenFile = fallback;
-    }
-
-    const rcName = writtenFile.split(/[\\/]/).pop();
-    console.log(`   ⚠️  请运行 source ~/${rcName} 让配置生效（或重开终端）`);
-    return true;
-  } else {
-    // Windows: 用 setx 真写入用户环境变量（对新开的终端生效）。
-    // setx 有 1024 字符限制，AIXX key 很短，没问题。
-    // 注意：第1步的 ~/.aixx/config.json 已经写好了（所有平台兜底），
-    // 环境变量只是锦上添花——setx 失败不影响任何功能。
-    try {
-      const setx = (name, value) =>
-        new Promise((resolve, reject) => {
-          exec(`setx ${name} "${value}"`, (err) => (err ? reject(err) : resolve()));
-        });
-      await Promise.all([setx('AIXX_API_KEY', apiKey), setx('AIXX_BASE_URL', baseUrl)]);
-      console.log('✅ 已写入Windows用户环境变量（setx，重开终端后生效）');
-      return true;
-    } catch (e) {
-      console.log('⚠️  未写入环境变量，但已写入 ~/.aixx/config.json，功能不受影响');
-      return false;
-    }
-  }
-}
+/**
+ * 环境变量配置工具
+ *
+ * 把AIXX_API_KEY和AIXX_BASE_URL写入用户的shell配置
+ * 支持 bash/zsh (Linux/macOS) 和 PowerShell (Windows)
+ */
+
+import { existsSync, readFileSync, writeFileSync, mkdirSync, appendFileSync } from 'fs';
+import { homedir } from 'os';
+import { join } from 'path';
+import { exec } from 'child_process';
+
+// ⚠️ 安全警告：当前用HTTP明文传输API Key（http://），存在凭据被嗅探风险。
+// TODO（安全）：后端配置好HTTPS证书后，把下面的 URL 改为 'https://14.103.27.195:8080/v1'。
+const DEFAULT_BASE_URL = 'http://14.103.27.195:8080/v1';
+
+/**
+ * key脱敏：显示为 前6后4 格式（如 sk-NOj3...5Vfe）。
+ * 所有命令的输出里，key一律用这个函数处理，绝不打印完整key。
+ */
+export function maskKey(key) {
+  if (!key || typeof key !== 'string') return '';
+  if (key.length <= 10) return key.slice(0, 6) + '...';
+  return `${key.slice(0, 6)}...${key.slice(-4)}`;
+}
+
+/**
+ * 统一配置读取链（所有子命令共用，别各自为政）：
+ *   环境变量 AIXX_API_KEY → ~/.aixx/config.json → ~/.aixx/account.json
+ * 返回 key 字符串，找不到返回 null。
+ */
+export function loadApiKey() {
+  if (process.env.AIXX_API_KEY) return process.env.AIXX_API_KEY;
+  const home = homedir();
+  for (const file of [join(home, '.aixx', 'config.json'), join(home, '.aixx', 'account.json')]) {
+    if (!existsSync(file)) continue;
+    try {
+      const conf = JSON.parse(readFileSync(file, 'utf-8'));
+      if (conf.AIXX_API_KEY || conf.apiKey) return conf.AIXX_API_KEY || conf.apiKey;
+    } catch (e) {
+      // 单个文件解析失败就试下一个
+    }
+  }
+  return null;
+}
+
+export async function setupEnv(apiKey, baseUrl = DEFAULT_BASE_URL) {
+  const platform = process.platform;
+  const home = homedir();
+
+  // 1. 写入AIXX本地配置文件（所有平台通用）
+  const aixxDir = join(home, '.aixx');
+  if (!existsSync(aixxDir)) mkdirSync(aixxDir, { recursive: true });
+  const configFile = join(aixxDir, 'config.json');
+  writeFileSync(configFile, JSON.stringify({
+    AIXX_API_KEY: apiKey,
+    AIXX_BASE_URL: baseUrl,
+    configuredAt: new Date().toISOString()
+  }, null, 2));
+
+  // 2. 写入shell配置（Linux/macOS）
+  if (platform !== 'win32') {
+    const envLines = [
+      ``,
+      `# AIXX 配置 (由 aixxai 添加)`,
+      `export AIXX_API_KEY="${apiKey}"`,
+      `export AIXX_BASE_URL="${baseUrl}"`,
+    ].join('\n');
+
+    // 检测当前用的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 writtenFile = null;
+    for (const conf of shellConfigs) {
+      if (existsSync(conf)) {
+        // 检查是否已配置过（避免重复）
+        const existing = readFileSync(conf, 'utf-8');
+        if (!existing.includes('AIXX_API_KEY')) {
+          appendFileSync(conf, envLines);
+          console.log(`   → 已写入 ${conf}`);
+        } else {
+          console.log(`   → ${conf} 已有AIXX配置，跳过`);
+        }
+        writtenFile = conf;
+        break;
+      }
+    }
+
+    if (!writtenFile) {
+      // 没找到现成配置文件，按当前shell创建一个
+      const fallback = currentShell.includes('zsh') ? join(home, '.zshrc') : join(home, '.bashrc');
+      appendFileSync(fallback, envLines);
+      console.log(`   → 已创建并写入 ${fallback}`);
+      writtenFile = fallback;
+    }
+
+    const rcName = writtenFile.split(/[\\/]/).pop();
+    console.log(`   ⚠️  请运行 source ~/${rcName} 让配置生效（或重开终端）`);
+    return true;
+  } else {
+    // Windows: 用 setx 真写入用户环境变量（对新开的终端生效）。
+    // setx 有 1024 字符限制，AIXX key 很短，没问题。
+    // 注意：第1步的 ~/.aixx/config.json 已经写好了（所有平台兜底），
+    // 环境变量只是锦上添花——setx 失败不影响任何功能。
+    try {
+      const setx = (name, value) =>
+        new Promise((resolve, reject) => {
+          exec(`setx ${name} "${value}"`, (err) => (err ? reject(err) : resolve()));
+        });
+      await Promise.all([setx('AIXX_API_KEY', apiKey), setx('AIXX_BASE_URL', baseUrl)]);
+      console.log('✅ 已写入Windows用户环境变量（setx，重开终端后生效）');
+      return true;
+    } catch (e) {
+      console.log('⚠️  未写入环境变量，但已写入 ~/.aixx/config.json，功能不受影响');
+      return false;
+    }
+  }
+}

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 说一句：
-> "帮我用 deepseek-chat 翻译：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="http://14.103.27.195:8080/v1"
-)
-
-response = client.chat.completions.create(
-    model="deepseek-chat",
-    messages=[{"role": "user", "content": "你好"}]
-)
-print(response.choices[0].message.content)
-```
-
-```javascript
-import OpenAI from "openai";
-
-const client = new OpenAI({
-  apiKey: "sk-你的key",
-  baseURL: "http://14.103.27.195:8080/v1",
-});
-
-const response = await client.chat.completions.create({
-  model: "deepseek-chat",
-  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: 该模型未配置价格，联系管理员或换用 deepseek-chat。
-
-**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 说一句：
+> "帮我用 deepseek-chat 翻译：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="http://14.103.27.195:8080/v1"
+)
+
+response = client.chat.completions.create(
+    model="deepseek-chat",
+    messages=[{"role": "user", "content": "你好"}]
+)
+print(response.choices[0].message.content)
+```
+
+```javascript
+import OpenAI from "openai";
+
+const client = new OpenAI({
+  apiKey: "sk-你的key",
+  baseURL: "http://14.103.27.195:8080/v1",
+});
+
+const response = await client.chat.completions.create({
+  model: "deepseek-chat",
+  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: 该模型未配置价格，联系管理员或换用 deepseek-chat。
+
+**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）