aicodeswitch 1.0.0

package/README.md

@@ -0,0 +1,176 @@
+# AI Code Switch
+
+## 简介
+
+AI Code Switch 是帮助你在本地管理 AI 编程工具接入大模型的工具。
+它可以让你的 Claude Code、Codex 等工具不再局限于官方模型。
+
+**而且它尽可能简单的帮你解决这件事。**
+
+## 安装
+
+```
+npm install -g aicodeswitch
+```
+
+## 使用方法
+
+**启动服务**
+
+```
+aicos start
+```
+
+**进入管理界面**
+
+```
+http://127.0.0.1:4567
+```
+
+**配置供应商**
+
+- 什么是供应商？
+- 供应商配置有什么用？
+
+具体请看下方文档。
+
+**路由配置**
+
+- 什么是路由？
+- 什么是路由规则？
+
+具体请看下方文档。
+
+**覆盖配置文件**
+
+在aicodeswitch中，点击“写入Claude Code配置”按钮，它会修改Claude Code的配置文件，让Claude Code开始使用aicocdeswitch提供的模型API，而非直接连到官网的模型API。
+
+你不用太担心，你可以在写入后，点击“恢复Claude Code配置”按钮，将Claude Code的配置文件恢复到原始状态。
+
+Codex的配置覆盖逻辑一模一样。
+
+**设置**
+
+你可以在设置页面，对aicodedeswitch进行配置。
+
+也可以导出配置数据，转移到其他电脑上导入。
+
+## 配置供应商
+
+### 什么是供应商？
+
+所谓供应商，就是提供AI服务的上游服务商。可以是OpenAI、Claude、DeepSeek、GLM 官方服务，也可以是其他中转服务商。
+
+### 供应商配置有什么用？
+
+通过将你所有的AI服务商统一起来管理，可以帮你：
+
+1. 避免频繁修改配置文件，通过aicodeswitch，可以一键切换到不同的供应商的AI服务API
+2. 通过aicodeswitch，将不同供应商的接口数据，转换为工具可以正确使用的接口数据格式，也就是说，你可以将Claude Code接入遵循openai的接口数据协议的其他接口
+3. 避免你忘记曾经注册过那些供应商
+4. 充分榨干不怎么用的供应商的服务，避免充值后不怎么用浪费了
+
+### 什么事API服务的“源类型”
+
+供应商接口返回的数据格式标准类型，目前支持以下几种：
+- OpenAI Chat
+- OpenAI Code
+- OpenAI Responses
+- Claude Chat
+- Claude Code
+- DeepSeek Chat
+
+**有什么用？**
+
+aicodeswitch内部，会根据“源类型”来转换数据。例如，你的供应商API服务接口是OpenAI Chat的数据格式，而你在路由中配置的“路由对象“是Claude Code，那么就意味着，这个供应商API的数据，需要经过转换之后才能被Claude Code正确使用。
+
+## 路由管理
+
+### 什么是路由？
+
+路由是aicodeswitch的核心功能，它负责将不同的对象（目前指Claude Code和Codex）的请求，路由到不同的供应商API服务上。
+
+### 什么是“路由对象”？
+
+目前指Claude Code或Codex。
+
+### 什么是“路由规则”？
+
+以Claude Code为例，它的请求实际上并非铁板一块，可以被分为多种。比如它的深度思考、长文对话、图片理解等等，都是可以独立对待的。
+
+路由规则的目的，就是让你的工具发出的请求，可以根据这个区分，发送给不同的服务商来处理。例如，你默认使用glm-4.7作为写代码的模型，但是，你可以把图片识别的请求发给doubao-code来进行，因为doubao-code的图片识别平均价格可以更低。同样的道理，不同目标的请求可以通过不同的规则来处理，以提升编程的质量和效果。
+
+目前，我仅提供了几个比较容易区分的规则，以后，还会添加更多的规则。
+
+### 激活路由
+
+我们可以为Claude Code添加多个路由，但是，我们必须激活一个路由，才能开始使用。
+而且，所有以Claude Code为对象的路由，在同一时间，只有一个可以被激活。
+
+### 切换路由
+
+你可以根据你的实际情况来实时切换路由，比如，你可以在发现自己的某个服务商处的余额较少时，立即切换到另外一个服务商。
+
+另外，我还在考虑增加一些自动化切换到逻辑，比如，当上游服务商接口报错时，立即切换到另外一个服务商。
+
+### 3. 请求日志
+
+在**请求日志**页面，您可以查看：
+
+- **请求日志**：所有 API 请求的详细记录
+  - 请求来源和目标
+  - 请求内容和响应
+  - 耗时和状态码
+  - 错误信息（如有）
+
+- **访问日志**：系统访问记录
+  - 访问时间
+  - 请求路径
+  - HTTP 方法
+
+- **错误日志**：错误和异常记录
+  - 错误类型
+  - 错误详情
+  - 发生时间
+
+**日志筛选**
+
+根据提供的选项进行筛选。
+
+## 配置文件
+
+作为 CLI 工具，你可以在 ~/.aicodeswitch/ 目录下找到工具的相关文件。里面有一个 aicodeswitch.conf 文件，可以进行配置。
+目前仅支持以下配置：
+
+```
+# aicodeswitch的服务IP
+HOST=127.0.0.1
+# aicodeswitch的服务端口
+PORT=4567
+
+# 如果提供AUTH，你无法直接登录用户界面，必须输入AUTH的值才能进入，相当于是一个登陆鉴权
+# 如果你在自己的服务器上使用，通过远程接入接口时，就必须提供这个值
+# AUTH=
+```
+
+## 常见问题
+
+### 1. 如何切换供应商？
+
+在路由管理页面修改规则的目标供应商，或调整优先级即可。
+
+### 2. 如何查看失败的请求？
+
+在请求日志页面，筛选状态码不为 200 的记录。
+
+### 3. 如何备份配置？
+
+在系统设置页面使用**导出配置**功能，然后将提供的数据保存到本地文件中。
+
+### 4. 如何设置日志保留时间？
+
+在系统设置页面修改**日志保留天数**配置。
+
+## 技术支持
+
+如有问题或建议，请访问项目 [GitHub 仓库](https://github.com/tangshuang/aicodeswitch/issues)提交 Issue。

package/bin/cli.js

@@ -0,0 +1,29 @@
+#!/usr/bin/env node
+
+const args = process.argv.slice(2);
+const command = args[0];
+
+const commands = {
+  start: () => require('./start'),
+  stop: () => require('./stop'),
+  restart: () => require('./restart'),
+};
+
+if (!command || !commands[command]) {
+  console.log(`
+Usage: aicos <command>
+
+Commands:
+  start      Start the AI Code Switch server
+  stop       Stop the AI Code Switch server
+  restart    Restart the AI Code Switch server
+
+Example:
+  aicos start
+  aicos stop
+  aicos restart
+  `);
+  process.exit(1);
+}
+
+commands[command]();

package/bin/restart.js

@@ -0,0 +1,232 @@
+const { spawn } = require('child_process');
+const path = require('path');
+const fs = require('fs');
+const os = require('os');
+const chalk = require('chalk');
+const boxen = require('boxen');
+const ora = require('ora');
+
+const PID_FILE = path.join(os.homedir(), '.aicodeswitch', 'server.pid');
+const LOG_FILE = path.join(os.homedir(), '.aicodeswitch', 'server.log');
+
+// 确保目录存在
+const ensureDir = (filePath) => {
+  const dir = path.dirname(filePath);
+  if (!fs.existsSync(dir)) {
+    fs.mkdirSync(dir, { recursive: true });
+  }
+};
+
+const isServerRunning = () => {
+  if (!fs.existsSync(PID_FILE)) {
+    return false;
+  }
+
+  try {
+    const pid = parseInt(fs.readFileSync(PID_FILE, 'utf-8'), 10);
+    // 检查进程是否存在
+    process.kill(pid, 0);
+    return true;
+  } catch (err) {
+    // 进程不存在,删除过期的 PID 文件
+    fs.unlinkSync(PID_FILE);
+    return false;
+  }
+};
+
+const getServerInfo = () => {
+  // 尝试多个可能的配置文件位置
+  const possiblePaths = [
+    path.join(os.homedir(), '.aicodeswitch', '.env'),
+    path.join(os.homedir(), '.aicodeswitch', 'aicodeswitch.conf')
+  ];
+
+  let host = '127.0.0.1';
+  let port = 4567;
+
+  for (const dotenvPath of possiblePaths) {
+    if (fs.existsSync(dotenvPath)) {
+      const content = fs.readFileSync(dotenvPath, 'utf-8');
+      const hostMatch = content.match(/HOST=(.+)/);
+      const portMatch = content.match(/PORT=(.+)/);
+
+      if (hostMatch) host = hostMatch[1].trim();
+      if (portMatch) port = parseInt(portMatch[1].trim(), 10);
+      break;
+    }
+  }
+
+  return { host, port };
+};
+
+const stopServer = async () => {
+  if (!fs.existsSync(PID_FILE)) {
+    return true; // 服务未运行,视为停止成功
+  }
+
+  const spinner = ora({
+    text: chalk.cyan('Stopping server...'),
+    color: 'cyan'
+  }).start();
+
+  try {
+    const pid = parseInt(fs.readFileSync(PID_FILE, 'utf-8'), 10);
+
+    try {
+      process.kill(pid, 'SIGTERM');
+
+      // 等待进程停止
+      let attempts = 0;
+      const maxAttempts = 10;
+
+      await new Promise((resolve) => {
+        const checkStopped = setInterval(() => {
+          attempts++;
+          try {
+            process.kill(pid, 0);
+            if (attempts >= maxAttempts) {
+              clearInterval(checkStopped);
+              // 强制终止
+              try {
+                process.kill(pid, 'SIGKILL');
+              } catch (e) {
+                // 进程可能已经停止
+              }
+              resolve();
+            }
+          } catch (err) {
+            // 进程已停止
+            clearInterval(checkStopped);
+            resolve();
+          }
+        }, 200);
+      });
+
+      spinner.succeed(chalk.green('Server stopped'));
+      fs.unlinkSync(PID_FILE);
+      return true;
+    } catch (err) {
+      // 进程不存在
+      spinner.succeed(chalk.green('Server stopped'));
+      fs.unlinkSync(PID_FILE);
+      return true;
+    }
+  } catch (err) {
+    spinner.fail(chalk.red('Failed to stop server'));
+    return false;
+  }
+};
+
+const startServer = async () => {
+  const spinner = ora({
+    text: chalk.cyan('Starting server...'),
+    color: 'cyan'
+  }).start();
+
+  ensureDir(PID_FILE);
+  ensureDir(LOG_FILE);
+
+  // 找到 main.js 的路径
+  const serverPath = path.join(__dirname, '..', 'dist', 'server', 'main.js');
+
+  if (!fs.existsSync(serverPath)) {
+    spinner.fail(chalk.red('Server file not found!'));
+    console.log(chalk.yellow(`\nPlease run ${chalk.cyan('npm run build')} first.\n`));
+    return false;
+  }
+
+  // 启动服务器进程 - 完全分离
+  // 打开日志文件用于输出
+  const logFd = fs.openSync(LOG_FILE, 'a');
+
+  const serverProcess = spawn('node', [serverPath], {
+    detached: true,
+    stdio: ['ignore', logFd, logFd]  // 使用文件描述符
+  });
+
+  // 关闭文件描述符(子进程会保持打开)
+  fs.closeSync(logFd);
+
+  // 保存 PID
+  fs.writeFileSync(PID_FILE, serverProcess.pid.toString());
+
+  // 分离进程,让父进程可以退出
+  serverProcess.unref();
+
+  // 等待服务器启动
+  await new Promise(resolve => setTimeout(resolve, 2000));
+
+  // 检查服务器是否成功启动
+  if (fs.existsSync(PID_FILE)) {
+    try {
+      const pid = parseInt(fs.readFileSync(PID_FILE, 'utf-8'), 10);
+      process.kill(pid, 0);
+      spinner.succeed(chalk.green('Server started'));
+      return true;
+    } catch (err) {
+      spinner.fail(chalk.red('Failed to start server'));
+      return false;
+    }
+  } else {
+    spinner.fail(chalk.red('Failed to start server'));
+    return false;
+  }
+};
+
+const restart = async () => {
+  console.log('\n');
+
+  const wasRunning = isServerRunning();
+
+  if (wasRunning) {
+    console.log(chalk.cyan('🔄 Restarting AI Code Switch server...\n'));
+
+    // 停止服务器
+    const stopped = await stopServer();
+    if (!stopped) {
+      console.log(chalk.red('\nFailed to stop server. Restart aborted.\n'));
+      process.exit(1);
+    }
+
+    // 等待一下确保端口释放
+    await new Promise(resolve => setTimeout(resolve, 500));
+  } else {
+    console.log(chalk.cyan('Starting AI Code Switch server...\n'));
+  }
+
+  // 启动服务器
+  const started = await startServer();
+
+  if (!started) {
+    console.log(chalk.yellow(`\nCheck logs: ${chalk.cyan(LOG_FILE)}\n`));
+    process.exit(1);
+  }
+
+  const { host, port } = getServerInfo();
+  const url = `http://${host}:${port}`;
+
+  // 显示漂亮的启动信息
+  console.log(boxen(
+    chalk.green.bold('🚀 AI Code Switch Server\n\n') +
+    chalk.white('Status:  ') + chalk.green.bold('● Running\n') +
+    chalk.white('URL:     ') + chalk.cyan.bold(url) + '\n' +
+    chalk.white('Logs:    ') + chalk.gray(LOG_FILE) + '\n\n' +
+    chalk.gray('Server has been ' + (wasRunning ? 'restarted' : 'started') + ' successfully'),
+    {
+      padding: 1,
+      margin: 1,
+      borderStyle: 'double',
+      borderColor: 'green'
+    }
+  ));
+
+  console.log(chalk.cyan('💡 Tips:\n'));
+  console.log(chalk.white('  • Open browser: ') + chalk.cyan(url));
+  console.log(chalk.white('  • View logs:    ') + chalk.gray(`tail -f ${LOG_FILE}`));
+  console.log(chalk.white('  • Stop server:  ') + chalk.yellow('aicos stop'));
+  console.log('\n');
+
+  process.exit(0);
+};
+
+module.exports = restart();

package/bin/start.js

@@ -0,0 +1,166 @@
+const { spawn } = require('child_process');
+const path = require('path');
+const fs = require('fs');
+const os = require('os');
+const chalk = require('chalk');
+const boxen = require('boxen');
+const ora = require('ora');
+
+const PID_FILE = path.join(os.homedir(), '.aicodeswitch', 'server.pid');
+const LOG_FILE = path.join(os.homedir(), '.aicodeswitch', 'server.log');
+
+// 确保目录存在
+const ensureDir = (filePath) => {
+  const dir = path.dirname(filePath);
+  if (!fs.existsSync(dir)) {
+    fs.mkdirSync(dir, { recursive: true });
+  }
+};
+
+const isServerRunning = () => {
+  if (!fs.existsSync(PID_FILE)) {
+    return false;
+  }
+
+  try {
+    const pid = parseInt(fs.readFileSync(PID_FILE, 'utf-8'), 10);
+    // 检查进程是否存在
+    process.kill(pid, 0);
+    return true;
+  } catch (err) {
+    // 进程不存在,删除过期的 PID 文件
+    fs.unlinkSync(PID_FILE);
+    return false;
+  }
+};
+
+const getServerInfo = () => {
+  // 尝试多个可能的配置文件位置
+  const possiblePaths = [
+    path.join(os.homedir(), '.aicodeswitch', '.env'),
+    path.join(os.homedir(), '.aicodeswitch', 'aicodeswitch.conf')
+  ];
+
+  let host = '127.0.0.1';
+  let port = 4567;
+
+  for (const dotenvPath of possiblePaths) {
+    if (fs.existsSync(dotenvPath)) {
+      const content = fs.readFileSync(dotenvPath, 'utf-8');
+      const hostMatch = content.match(/HOST=(.+)/);
+      const portMatch = content.match(/PORT=(.+)/);
+
+      if (hostMatch) host = hostMatch[1].trim();
+      if (portMatch) port = parseInt(portMatch[1].trim(), 10);
+      break;
+    }
+  }
+
+  return { host, port };
+};
+
+const start = async () => {
+  console.log('\n');
+
+  // 检查是否已经运行
+  if (isServerRunning()) {
+    const { host, port } = getServerInfo();
+    console.log(boxen(
+      chalk.yellow.bold('⚠ Server is already running!\n\n') +
+      chalk.white(`URL: `) + chalk.cyan.bold(`http://${host}:${port}`),
+      {
+        padding: 1,
+        margin: 1,
+        borderStyle: 'round',
+        borderColor: 'yellow'
+      }
+    ));
+    console.log('');
+    process.exit(0);
+  }
+
+  const spinner = ora({
+    text: chalk.cyan('Starting AI Code Switch server...'),
+    color: 'cyan'
+  }).start();
+
+  ensureDir(PID_FILE);
+  ensureDir(LOG_FILE);
+
+  // 找到 main.js 的路径
+  const serverPath = path.join(__dirname, '..', 'dist', 'server', 'main.js');
+
+  if (!fs.existsSync(serverPath)) {
+    spinner.fail(chalk.red('Server file not found!'));
+    console.log(chalk.yellow(`\nPlease run ${chalk.cyan('npm run build')} first.\n`));
+    process.exit(1);
+  }
+
+  // 启动服务器进程 - 完全分离
+  // 打开日志文件用于输出
+  const logFd = fs.openSync(LOG_FILE, 'a');
+
+  const serverProcess = spawn('node', [serverPath], {
+    detached: true,
+    stdio: ['ignore', logFd, logFd]  // 使用文件描述符
+  });
+
+  // 关闭文件描述符(子进程会保持打开)
+  fs.closeSync(logFd);
+
+  // 保存 PID
+  fs.writeFileSync(PID_FILE, serverProcess.pid.toString());
+
+  // 分离进程,让父进程可以退出
+  serverProcess.unref();
+
+  // 等待服务器启动
+  await new Promise(resolve => setTimeout(resolve, 2000));
+
+  // 检查服务器是否成功启动
+  if (fs.existsSync(PID_FILE)) {
+    try {
+      const pid = parseInt(fs.readFileSync(PID_FILE, 'utf-8'), 10);
+      process.kill(pid, 0);
+      spinner.succeed(chalk.green('Server started successfully!'));
+
+      const { host, port } = getServerInfo();
+      const url = `http://${host}:${port}`;
+
+      // 显示漂亮的启动信息
+      console.log(boxen(
+        chalk.green.bold('🚀 AI Code Switch Server\n\n') +
+        chalk.white('Status:  ') + chalk.green.bold('● Running\n') +
+        chalk.white('URL:     ') + chalk.cyan.bold(url) + '\n' +
+        chalk.white('PID:     ') + chalk.yellow(pid) + '\n' +
+        chalk.white('Logs:    ') + chalk.gray(LOG_FILE) + '\n\n' +
+        chalk.gray('Open the URL in your browser to access the dashboard'),
+        {
+          padding: 1,
+          margin: 1,
+          borderStyle: 'double',
+          borderColor: 'green'
+        }
+      ));
+
+      console.log(chalk.cyan('💡 Tips:\n'));
+      console.log(chalk.white('  • Open browser: ') + chalk.cyan(url));
+      console.log(chalk.white('  • View logs:    ') + chalk.gray(`tail -f ${LOG_FILE}`));
+      console.log(chalk.white('  • Stop server:  ') + chalk.yellow('aicos stop'));
+      console.log('\n');
+
+      // 立即退出,返回控制台
+      process.exit(0);
+    } catch (err) {
+      spinner.fail(chalk.red('Failed to start server!'));
+      console.log(chalk.yellow(`\nCheck logs: ${chalk.cyan(LOG_FILE)}\n`));
+      process.exit(1);
+    }
+  } else {
+    spinner.fail(chalk.red('Failed to start server!'));
+    console.log(chalk.yellow(`\nCheck logs: ${chalk.cyan(LOG_FILE)}\n`));
+    process.exit(1);
+  }
+};
+
+module.exports = start();

package/bin/stop.js

@@ -0,0 +1,90 @@
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+const chalk = require('chalk');
+const boxen = require('boxen');
+const ora = require('ora');
+
+const PID_FILE = path.join(os.homedir(), '.aicodeswitch', 'server.pid');
+
+const stop = () => {
+  console.log('\n');
+
+  if (!fs.existsSync(PID_FILE)) {
+    console.log(boxen(
+      chalk.yellow.bold('⚠ Server is not running'),
+      {
+        padding: 1,
+        margin: 1,
+        borderStyle: 'round',
+        borderColor: 'yellow'
+      }
+    ));
+    console.log('\n');
+    return;
+  }
+
+  const spinner = ora({
+    text: chalk.cyan('Stopping server...'),
+    color: 'cyan'
+  }).start();
+
+  try {
+    const pid = parseInt(fs.readFileSync(PID_FILE, 'utf-8'), 10);
+
+    // 尝试终止进程
+    try {
+      process.kill(pid, 'SIGTERM');
+
+      // 等待进程停止
+      let attempts = 0;
+      const maxAttempts = 10;
+
+      const checkStopped = setInterval(() => {
+        attempts++;
+        try {
+          process.kill(pid, 0);
+          if (attempts >= maxAttempts) {
+            clearInterval(checkStopped);
+            // 强制终止
+            process.kill(pid, 'SIGKILL');
+            spinner.warn(chalk.yellow('Server forcefully stopped'));
+            fs.unlinkSync(PID_FILE);
+            showStoppedMessage();
+          }
+        } catch (err) {
+          // 进程已停止
+          clearInterval(checkStopped);
+          spinner.succeed(chalk.green('Server stopped successfully'));
+          fs.unlinkSync(PID_FILE);
+          showStoppedMessage();
+        }
+      }, 200);
+
+    } catch (err) {
+      // 进程不存在
+      spinner.warn(chalk.yellow('Process not found'));
+      fs.unlinkSync(PID_FILE);
+      showStoppedMessage();
+    }
+  } catch (err) {
+    spinner.fail(chalk.red('Failed to stop server'));
+    console.log(chalk.red(`\nError: ${err.message}\n`));
+  }
+};
+
+const showStoppedMessage = () => {
+  console.log(boxen(
+    chalk.gray('AI Code Switch Server\n\n') +
+    chalk.white('Status: ') + chalk.red('● Stopped'),
+    {
+      padding: 1,
+      margin: 1,
+      borderStyle: 'round',
+      borderColor: 'gray'
+    }
+  ));
+  console.log(chalk.white('Use ') + chalk.cyan('aicos start') + chalk.white(' to start the server again.\n'));
+};
+
+module.exports = stop();