axon-code 2.4.0

package/dist/wizard/onboarding.js

@@ -0,0 +1,196 @@
+/**
+ * 首次启动引导向导
+ * 使用 Node.js 内置 readline 实现交互式配置
+ */
+import * as readline from 'readline';
+import * as fs from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+import chalk from 'chalk';
+import { configManager } from '../config/index.js';
+/**
+ * 创建 readline 接口
+ */
+function createInterface() {
+    return readline.createInterface({
+        input: process.stdin,
+        output: process.stdout,
+    });
+}
+/**
+ * 询问用户一个问题
+ * @param rl readline 接口
+ * @param question 问题文本
+ * @returns 用户输入
+ */
+function ask(rl, question) {
+    return new Promise((resolve) => {
+        rl.question(question, (answer) => {
+            resolve(answer.trim());
+        });
+    });
+}
+/**
+ * 显示欢迎页
+ */
+function showWelcome() {
+    console.clear();
+    console.log(chalk.cyan.bold('\n╔══════════════════════════════════════════════╗'));
+    console.log(chalk.cyan.bold('║                                              ║'));
+    console.log(chalk.cyan.bold('║       Welcome to Axon!                       ║'));
+    console.log(chalk.cyan.bold('║                                              ║'));
+    console.log(chalk.cyan.bold('╚══════════════════════════════════════════════╝\n'));
+    console.log(chalk.gray('Let\'s set up your environment...\n'));
+}
+/**
+ * 询问 API Key
+ * @param rl readline 接口
+ * @returns API Key 或 null（如果用户选择跳过）
+ */
+async function askApiKey(rl) {
+    console.log(chalk.yellow('\n📝 Step 1: API Key Configuration'));
+    console.log(chalk.gray('─'.repeat(50)));
+    const hasKey = await ask(rl, chalk.white('Do you have an Anthropic API key? (y/n): '));
+    if (hasKey.toLowerCase() === 'y' || hasKey.toLowerCase() === 'yes') {
+        console.log(chalk.gray('\nYou can get your API key from:'));
+        console.log(chalk.blue('https://console.anthropic.com/settings/keys\n'));
+        let apiKey = '';
+        let attempts = 0;
+        const maxAttempts = 3;
+        while (attempts < maxAttempts) {
+            apiKey = await ask(rl, chalk.white('Enter your API key: '));
+            if (!apiKey) {
+                console.log(chalk.red('API key cannot be empty.'));
+                attempts++;
+                continue;
+            }
+            // 简单验证格式
+            if (!apiKey.startsWith('sk-ant-')) {
+                console.log(chalk.yellow('Warning: API key should start with "sk-ant-"'));
+                const confirm = await ask(rl, chalk.white('Continue anyway? (y/n): '));
+                if (confirm.toLowerCase() !== 'y' && confirm.toLowerCase() !== 'yes') {
+                    attempts++;
+                    continue;
+                }
+            }
+            // 验证 API key（调用 API）
+            console.log(chalk.gray('\nValidating API key...'));
+            try {
+                const { ClaudeClient } = await import('../core/client.js');
+                const client = new ClaudeClient({
+                    model: 'claude-sonnet-4-5-20250929',
+                    apiKey: apiKey,
+                });
+                // 发送一个简单的测试请求
+                await client.createMessage([{ role: 'user', content: 'Hi' }], [], 'You are a helpful assistant.', {});
+                console.log(chalk.green('✓ API key is valid!\n'));
+                return apiKey;
+            }
+            catch (error) {
+                console.log(chalk.red(`✗ API key validation failed: ${error.message}`));
+                attempts++;
+                if (attempts < maxAttempts) {
+                    console.log(chalk.gray(`Please try again (${maxAttempts - attempts} attempts left)`));
+                }
+            }
+        }
+        console.log(chalk.yellow('\nSkipping API key configuration...'));
+        return null;
+    }
+    else {
+        console.log(chalk.gray('\nNo problem! You can use the built-in proxy (limited features).'));
+        console.log(chalk.gray('You can add your API key later in ~/.axon/settings.json\n'));
+        return null;
+    }
+}
+/**
+ * 询问默认模型
+ * @param rl readline 接口
+ * @returns 模型名称
+ */
+async function askModel(rl) {
+    console.log(chalk.yellow('\n🤖 Step 2: Default Model'));
+    console.log(chalk.gray('─'.repeat(50)));
+    console.log(chalk.white('\nChoose your default model:'));
+    console.log(chalk.cyan('  1) Sonnet (Recommended) - Balance of speed and quality'));
+    console.log(chalk.gray('  2) Opus - Most capable, slower'));
+    console.log(chalk.gray('  3) Haiku - Fastest, for simple tasks\n'));
+    while (true) {
+        const choice = await ask(rl, chalk.white('Enter your choice (1-3) [1]: '));
+        if (!choice || choice === '1') {
+            return 'sonnet';
+        }
+        else if (choice === '2') {
+            return 'opus';
+        }
+        else if (choice === '3') {
+            return 'haiku';
+        }
+        else {
+            console.log(chalk.red('Invalid choice. Please enter 1, 2, or 3.'));
+        }
+    }
+}
+/**
+ * 显示完成页
+ * @param config 配置摘要
+ */
+function showCompletion(config) {
+    console.log(chalk.green.bold('\n✨ Setup Complete!\n'));
+    console.log(chalk.gray('─'.repeat(50)));
+    console.log(chalk.white('\nConfiguration Summary:'));
+    console.log(chalk.gray(`  API Key: ${config.apiKey ? '✓ Configured' : '✗ Not configured (using proxy)'}`));
+    console.log(chalk.gray(`  Default Model: ${config.model}`));
+    console.log(chalk.gray('\n─'.repeat(50)));
+    console.log(chalk.white('\nNext Steps:'));
+    console.log(chalk.cyan('  • Type /help to see available commands'));
+    console.log(chalk.cyan('  • Type /skill to manage skills'));
+    console.log(chalk.cyan('  • Start chatting to use Axon!\n'));
+    console.log(chalk.gray('Configuration saved to: ~/.axon/settings.json\n'));
+}
+/**
+ * 运行首次启动向导
+ */
+export async function runOnboardingWizard() {
+    const rl = createInterface();
+    try {
+        showWelcome();
+        // Step 1: API Key
+        const apiKey = await askApiKey(rl);
+        // Step 2: Model
+        const model = await askModel(rl);
+        // 保存配置
+        if (apiKey) {
+            configManager.set('apiKey', apiKey);
+        }
+        configManager.set('model', model);
+        // 显示完成页
+        showCompletion({ apiKey, model });
+        // 创建 .onboarded 标志文件
+        const claudeDir = path.join(os.homedir(), '.axon');
+        const onboardedFile = path.join(claudeDir, '.onboarded');
+        if (!fs.existsSync(claudeDir)) {
+            fs.mkdirSync(claudeDir, { recursive: true });
+        }
+        fs.writeFileSync(onboardedFile, new Date().toISOString());
+    }
+    catch (error) {
+        if (error.message === 'interrupted') {
+            console.log(chalk.yellow('\n\nSetup cancelled. You can run "claude onboard" later to configure.\n'));
+        }
+        else {
+            console.error(chalk.red('\n\nSetup failed:'), error);
+        }
+    }
+    finally {
+        rl.close();
+    }
+}
+/**
+ * 检查是否已完成首次设置
+ */
+export function isOnboarded() {
+    const onboardedFile = path.join(os.homedir(), '.axon', '.onboarded');
+    return fs.existsSync(onboardedFile);
+}
+//# sourceMappingURL=onboarding.js.map

package/dist/wizard/onboarding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"onboarding.js","sourceRoot":"","sources":["../../src/wizard/onboarding.ts"],"names":[],"mappings":"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"}

package/electron/README.md

@@ -0,0 +1,41 @@
+# Axon Desktop - 使用说明
+
+## 快速开始
+
+1. 解压 `axon-portable.zip` 到任意目录
+2. 双击 `Axon.exe` 启动应用
+3. 应用会自动启动 Web 服务器并打开浏览器窗口
+
+## 系统要求
+
+- Windows 10/11 (64位)
+- 至少 2GB 可用内存
+- 至少 1GB 磁盘空间
+
+## 配置
+
+首次启动需要配置 API Key：
+- 在应用中点击设置
+- 输入你的 Anthropic API Key
+- 配置文件保存在 `%USERPROFILE%\.axon\settings.json`
+
+## 功能特性
+
+- ✅ Web IDE 界面
+- ✅ 多代理协作系统
+- ✅ MCP 工具集成
+- ✅ 代码分析和生成
+- ✅ 项目蓝图生成
+
+## 故障排除
+
+### 应用无法启动
+- 检查是否有杀毒软件拦截
+- 尝试以管理员身份运行
+
+### 端口冲突
+- 默认端口 3456，如被占用会自动切换
+
+## 更新
+
+访问 https://github.com/kill136/axon/releases 获取最新版本

package/electron/main.cjs

@@ -0,0 +1,341 @@
+/**
+ * Axon Desktop - Electron Main Process
+ *
+ * 架构：Electron 做浏览器窗口壳，内嵌标准 Node.js 运行 Web 服务器。
+ * - Electron 进程：只管窗口，不运行业务代码
+ * - Node.js 子进程：用内嵌的 node.exe 运行 dist/web-cli.js
+ * - 两者通过 HTTP 通信（localhost:3456）
+ *
+ * 为什么不用 Electron 内置 Node.js？
+ * 1. native module (better-sqlite3 等) 的 NODE_MODULE_VERSION 和 Electron 不匹配
+ * 2. fork() 的 ELECTRON_RUN_AS_NODE 模式有各种兼容性坑
+ * 3. Electron GUI 没有 stdout，pipe 输出会 EPIPE 崩溃
+ */
+
+const { app, BrowserWindow, ipcMain } = require('electron');
+const path = require('path');
+const { spawn } = require('child_process');
+const fs = require('fs');
+
+let mainWindow;
+let serverProcess;
+const SERVER_PORT = 3456;
+
+/** 向渲染进程发送启动日志 */
+function sendLog(msg) {
+  if (mainWindow && !mainWindow.isDestroyed()) {
+    mainWindow.webContents.send('boot-log', msg);
+  }
+}
+
+/**
+ * 查找内嵌的 node 二进制
+ * 开发模式下用系统 node
+ */
+function findNodeExe() {
+  const appRoot = path.join(__dirname, '..');
+  const isWin = process.platform === 'win32';
+  const nodeBin = isWin ? 'node.exe' : 'node';
+
+  // 候选路径（按平台不同）
+  const candidates = [
+    // Windows: <installDir>/node/node.exe
+    //   appRoot = <installDir>/resources/app → ../../node/node.exe
+    path.join(appRoot, '..', '..', 'node', nodeBin),
+    // macOS / Linux AppImage: Contents/Resources/app (or usr/share/axon/app) → ../node/node
+    path.join(appRoot, '..', 'node', nodeBin),
+  ];
+
+  for (const candidate of candidates) {
+    if (fs.existsSync(candidate)) {
+      return candidate;
+    }
+  }
+
+  // 开发模式：用系统 node
+  return 'node';
+}
+
+/**
+ * 启动 Web 服务器子进程
+ */
+function startServer() {
+  const appRoot = path.join(__dirname, '..');
+  const nodeExe = findNodeExe();
+  const serverScript = path.join(appRoot, 'dist', 'web-cli.js');
+
+  // 日志文件（写到用户目录，便于排错）
+  const logDir = path.join(app.getPath('userData'), 'logs');
+  if (!fs.existsSync(logDir)) {
+    fs.mkdirSync(logDir, { recursive: true });
+  }
+  const logFile = path.join(logDir, 'server.log');
+  const logStream = fs.createWriteStream(logFile, { flags: 'a' });
+
+  const startTime = `${new Date().toISOString()}`;
+  logStream.write(`\n=== Axon Server Start: ${startTime} ===\n`);
+  logStream.write(`Node: ${nodeExe}\n`);
+  logStream.write(`Script: ${serverScript}\n`);
+  logStream.write(`CWD: ${appRoot}\n\n`);
+
+  sendLog(`[${startTime}] Axon Server starting...`);
+  sendLog(`Node: ${nodeExe}`);
+  sendLog(`Script: ${serverScript}`);
+
+  serverProcess = spawn(
+    nodeExe,
+    [serverScript, '--port', String(SERVER_PORT), '--no-open', '--host', '127.0.0.1'],
+    {
+      cwd: appRoot,
+      env: {
+        ...process.env,
+        ELECTRON_MODE: '1',
+        NODE_ENV: 'production',
+      },
+      // Windows 上隐藏控制台窗口（macOS/Linux 无影响）
+      windowsHide: true,
+      stdio: ['ignore', 'pipe', 'pipe'],
+    }
+  );
+
+  // 日志写文件 + 推送到 loading 页面
+  serverProcess.stdout.on('data', (data) => {
+    logStream.write(data);
+    const text = data.toString().trim();
+    if (text) sendLog(text);
+  });
+  serverProcess.stderr.on('data', (data) => {
+    logStream.write(data);
+    const text = data.toString().trim();
+    if (text) sendLog(`[stderr] ${text}`);
+  });
+
+  serverProcess.on('error', (err) => {
+    logStream.write(`[ERROR] Failed to start: ${err.message}\n`);
+    sendLog(`[ERROR] ${err.message}`);
+  });
+
+  serverProcess.on('exit', (code, signal) => {
+    logStream.write(`[EXIT] code=${code} signal=${signal}\n`);
+    sendLog(`[EXIT] code=${code} signal=${signal}`);
+    serverProcess = null;
+  });
+}
+
+/**
+ * 轮询检测服务器是否就绪
+ * 同时尝试 HTTPS 和 HTTP（服务器可能用自签名证书）
+ * 返回可用的 URL
+ */
+async function waitForServer(maxRetries = 60, interval = 1000) {
+  const http = require('http');
+  const https = require('https');
+
+  function tryConnect(proto) {
+    const mod = proto === 'https' ? https : http;
+    const url = `${proto}://127.0.0.1:${SERVER_PORT}`;
+    return new Promise((resolve, reject) => {
+      const req = mod.get(url, { rejectUnauthorized: false }, (res) => {
+        res.resume();
+        resolve(url);
+      });
+      req.on('error', reject);
+      req.setTimeout(2000, () => {
+        req.destroy();
+        reject(new Error('timeout'));
+      });
+    });
+  }
+
+  for (let i = 0; i < maxRetries; i++) {
+    // 同时尝试 HTTPS 和 HTTP，谁先通谁赢
+    try {
+      const url = await Promise.any([
+        tryConnect('https'),
+        tryConnect('http'),
+      ]);
+      sendLog(`Server ready at ${url}`);
+      return url;
+    } catch (e) {
+      if (i > 0 && i % 5 === 0) {
+        sendLog(`Waiting for server... (${i}s)`);
+      }
+      await new Promise(r => setTimeout(r, interval));
+    }
+  }
+  sendLog('[ERROR] Server did not respond within 60 seconds');
+  return null; // 超时
+}
+
+function createWindow() {
+  mainWindow = new BrowserWindow({
+    width: 1400,
+    height: 900,
+    title: 'Axon',
+    frame: false,       // 无边框窗口，去掉系统标题栏和菜单
+    titleBarStyle: 'hidden', // macOS 上隐藏标题栏但保留红绿灯（可选）
+    webPreferences: {
+      nodeIntegration: false,
+      contextIsolation: true,
+      preload: path.join(__dirname, 'preload.cjs'),
+    },
+    icon: path.join(__dirname, 'icon.png'),
+    show: false, // 先隐藏，等内容加载好再显示
+  });
+
+  // 显示 loading 页（含实时进度日志）
+  mainWindow.loadURL(`data:text/html;charset=utf-8,${encodeURIComponent(`<!DOCTYPE html>
+<html>
+<head>
+<meta charset="utf-8">
+<style>
+  * { box-sizing: border-box; }
+  body { margin: 0; background: #0a0a0a; color: #e0e0e0; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif; display: flex; flex-direction: column; align-items: center; justify-content: center; height: 100vh; -webkit-app-region: drag; user-select: none; }
+  .loader { text-align: center; }
+  .loader h1 { font-size: 36px; margin-bottom: 8px; color: #fff; letter-spacing: 2px; }
+  .status { font-size: 13px; color: #888; margin-bottom: 16px; }
+  .spinner { width: 36px; height: 36px; border: 3px solid #222; border-top-color: #6c63ff; border-radius: 50%; animation: spin 1s linear infinite; margin: 0 auto 20px; }
+  @keyframes spin { to { transform: rotate(360deg); } }
+  .log-box { width: 520px; max-height: 180px; background: #111; border: 1px solid #222; border-radius: 6px; overflow-y: auto; padding: 10px 14px; font-family: 'Cascadia Code', 'Fira Code', 'Consolas', monospace; font-size: 11.5px; line-height: 1.6; color: #777; text-align: left; -webkit-app-region: no-drag; }
+  .log-box::-webkit-scrollbar { width: 4px; }
+  .log-box::-webkit-scrollbar-thumb { background: #333; border-radius: 2px; }
+  .log-line { white-space: pre-wrap; word-break: break-all; }
+  .log-line.error { color: #ff6b6b; }
+  .log-line.ready { color: #51cf66; }
+  .dots { display: inline-block; width: 18px; text-align: left; }
+</style>
+</head>
+<body>
+  <div class="loader">
+    <h1>Axon</h1>
+    <div class="spinner"></div>
+    <p class="status">Initializing<span class="dots" id="dots"></span></p>
+  </div>
+  <div class="log-box" id="logs"></div>
+  <script>
+    const logsEl = document.getElementById('logs');
+    const dotsEl = document.getElementById('dots');
+    const statusEl = document.querySelector('.status');
+    let dotCount = 0;
+    setInterval(() => { dotCount = (dotCount + 1) % 4; dotsEl.textContent = '.'.repeat(dotCount); }, 400);
+
+    if (window.electronAPI && window.electronAPI.onBootLog) {
+      window.electronAPI.onBootLog((msg) => {
+        const line = document.createElement('div');
+        line.className = 'log-line';
+        if (msg.includes('[ERROR]') || msg.includes('[stderr]')) line.classList.add('error');
+        if (msg.includes('ready') || msg.includes('Ready') || msg.includes('listening')) line.classList.add('ready');
+        line.textContent = msg;
+        logsEl.appendChild(line);
+        logsEl.scrollTop = logsEl.scrollHeight;
+        // 更新顶部状态文字
+        if (msg.includes('Server ready')) { statusEl.textContent = 'Connected!'; }
+        else if (msg.includes('Waiting for server')) { statusEl.innerHTML = 'Waiting for server<span class="dots" id="dots"></span>'; }
+      });
+    }
+  </script>
+</body>
+</html>`)}`);
+
+  mainWindow.once('ready-to-show', () => {
+    mainWindow.show();
+  });
+
+  mainWindow.on('closed', () => {
+    mainWindow = null;
+  });
+}
+
+function showError(message) {
+  if (!mainWindow) return;
+  mainWindow.loadURL(`data:text/html;charset=utf-8,${encodeURIComponent(`<!DOCTYPE html>
+<html>
+<head>
+<meta charset="utf-8">
+<style>
+  body { margin: 0; background: #0a0a0a; color: #e0e0e0; font-family: sans-serif; display: flex; align-items: center; justify-content: center; height: 100vh; }
+  .error { text-align: center; max-width: 500px; }
+  .error h1 { color: #ff6b6b; font-size: 24px; }
+  .error p { color: #888; line-height: 1.6; }
+  .error code { background: #1a1a1a; padding: 2px 6px; border-radius: 3px; font-size: 13px; }
+</style>
+</head>
+<body>
+  <div class="error">
+    <h1>Failed to Start</h1>
+    <p>${message}</p>
+    <p>Check logs at: <code>${process.platform === 'win32' ? '%APPDATA%' : process.platform === 'darwin' ? '~/Library/Application Support' : '~/.config'}/axon/logs/server.log</code></p>
+  </div>
+</body>
+</html>`)}`);
+}
+
+// ============================================================
+// App Lifecycle
+// ============================================================
+
+// 窗口控制 IPC 处理
+ipcMain.on('window-minimize', () => {
+  mainWindow?.minimize();
+});
+ipcMain.on('window-maximize', () => {
+  if (mainWindow?.isMaximized()) {
+    mainWindow.unmaximize();
+  } else {
+    mainWindow?.maximize();
+  }
+});
+ipcMain.on('window-close', () => {
+  mainWindow?.close();
+});
+
+app.whenReady().then(async () => {
+  createWindow();
+  startServer();
+
+  const serverUrl = await waitForServer();
+  if (serverUrl && mainWindow) {
+    mainWindow.loadURL(serverUrl);
+  } else {
+    showError('The server did not respond within 60 seconds.');
+  }
+});
+
+app.on('window-all-closed', () => {
+  // macOS 上关闭窗口不退出应用（标准 macOS 行为）
+  if (process.platform !== 'darwin') {
+    killServer();
+    app.quit();
+  }
+});
+
+// macOS: 点击 dock 图标重新打开窗口
+app.on('activate', () => {
+  if (!mainWindow) {
+    createWindow();
+    if (serverProcess) {
+      // 服务器还在跑，直接加载
+      waitForServer(5, 500).then(url => {
+        if (url && mainWindow) mainWindow.loadURL(url);
+      });
+    } else {
+      startServer();
+      waitForServer().then(url => {
+        if (url && mainWindow) mainWindow.loadURL(url);
+        else showError('The server did not respond within 60 seconds.');
+      });
+    }
+  }
+});
+
+app.on('before-quit', killServer);
+process.on('exit', killServer);
+
+function killServer() {
+  if (serverProcess) {
+    try {
+      serverProcess.kill();
+    } catch (e) {}
+    serverProcess = null;
+  }
+}