aicodeswitch 5.2.9 → 5.2.10

package/README.md

@@ -35,50 +35,26 @@ AI Code Switch 是帮助你在本地管理 AI 编程工具接入大模型的工
 * 数据完全本地，自主可控
 * 特殊语法：在发送的提示词最前面添加`[!]`来直接切换为高智商模型服务（`[x]`关闭），简单快捷
 
+![](public/aicodeswitch-flow.svg)
+
 ## 桌面客户端
 
 [进入下载](https://github.com/tangshuang/aicodeswitch/releases)
 
 ## 命令行工具
 
-### 安装
-
 ```
+# 安装
 npm install -g aicodeswitch
-```
-
-### 使用方法
-
-**启动服务**
-
-```
+# 启动服务
 aicos start
-```
-
-或者直接运行
-
-```
+# http://127.0.0.1:4567
+# 启动服务并打开管理界面
 aicos ui
-```
-
-**停止服务**
-
-```
+# 停止服务
 aicos stop
 ```
 
-**进入管理界面**
-
-```
-# 自动启动服务和打开界面
-aicos ui
-```
-
-```
-# 手动在浏览器打开管理界面
-http://127.0.0.1:4567
-```
-
 ## 管理界面
 
 **配置供应商**
@@ -257,6 +233,7 @@ PORT=4567
 ## 关联资源
 
 * [Claude Code 深度教程](https://claudecode.tangshuang.net): 100%免费的Claude Code入门到精通教程
+* [AICodingBus](https://aicodingbus.24x7.to): AI Tokens 交换平台
 
 ## 支持我
 

package/bin/cli.js

@@ -7,6 +7,7 @@ const commands = {
   start: require('./start'),
   stop: require('./stop'),
   restart: require('./restart'),
+  status: require('./status'),
   upgrade: require('./upgrade'),
   restore: require('./restore'),
   version: require('./version'),
@@ -21,6 +22,7 @@ Commands:
   start      Start the AI Code Switch server
   stop       Stop the AI Code Switch server
   restart    Restart the AI Code Switch server
+  status     Show server status, running address and port
   ui         Open the web UI in browser (starts server if needed)
   upgrade    Upgrade to the latest version and restart
   restore    Restore original configuration files
@@ -30,6 +32,7 @@ Example:
   aicos start
   aicos stop
   aicos restart
+  aicos status
   aicos ui
   aicos upgrade
   aicos restore

package/bin/status.js

@@ -0,0 +1,84 @@
+const path = require('path');
+const fs = require('fs');
+const os = require('os');
+const chalk = require('chalk');
+const boxen = require('boxen');
+const { isServerRunning, getServerInfo } = require('./utils/get-server');
+const { findPidByPort, getProcessInfo } = require('./utils/port-utils');
+
+const PID_FILE = path.join(os.homedir(), '.aicodeswitch', 'server.pid');
+const LOG_FILE = path.join(os.homedir(), '.aicodeswitch', 'server.log');
+
+const status = async () => {
+  console.log('\n');
+
+  // 读取配置的 host/port
+  const { host, port } = getServerInfo();
+  const url = `http://${host}:${port}`;
+
+  // 优先通过 PID 文件判断
+  let pidFromFile = null;
+  if (fs.existsSync(PID_FILE)) {
+    try {
+      pidFromFile = parseInt(fs.readFileSync(PID_FILE, 'utf-8'), 10);
+    } catch (err) {
+      pidFromFile = null;
+    }
+  }
+
+  const runningByPidFile = isServerRunning();
+  // 通过端口检测（兜底：PID 文件丢失但服务仍在监听的情况）
+  const pidByPort = await findPidByPort(port);
+  const isRunning = runningByPidFile || !!pidByPort;
+
+  if (isRunning) {
+    // PID 优先使用 PID 文件记录的，其次使用端口检测到的
+    const pid = runningByPidFile ? pidFromFile : pidByPort;
+    const processInfo = await getProcessInfo(pid);
+
+    console.log(boxen(
+      chalk.green.bold('🟢 AI Code Switch Server\n\n') +
+      chalk.white('Status:  ') + chalk.green.bold('● Running\n') +
+      chalk.white('Host:    ') + chalk.cyan(host) + '\n' +
+      chalk.white('Port:    ') + chalk.cyan.bold(port) + '\n' +
+      chalk.white('URL:     ') + chalk.cyan.bold(url) + '\n' +
+      chalk.white('PID:     ') + chalk.yellow(pid) + '\n' +
+      chalk.white('Process: ') + chalk.gray(processInfo) + '\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(chalk.white('  • Restart:      ') + chalk.yellow('aicos restart'));
+    console.log('\n');
+  } else {
+    console.log(boxen(
+      chalk.gray('AI Code Switch Server\n\n') +
+      chalk.white('Status: ') + chalk.red('● Stopped\n\n') +
+      chalk.white('Host:   ') + chalk.gray(host) + '\n' +
+      chalk.white('Port:   ') + chalk.gray(port) + '\n' +
+      chalk.white('URL:    ') + chalk.gray(url) + ' ' + chalk.gray('(not listening)'),
+      {
+        padding: 1,
+        margin: 1,
+        borderStyle: 'round',
+        borderColor: 'gray'
+      }
+    ));
+
+    console.log(chalk.white('Use ') + chalk.cyan('aicos start') + chalk.white(' to start the server.\n'));
+  }
+
+  process.exit(0);
+};
+
+module.exports = status;

package/dist/server/main.js

@@ -3288,21 +3288,23 @@ ${instruction}
         }
     }
 });
+// listen 就绪标志：区分"启动阶段"与"运行阶段"，启动期致命异常应让进程退出
+let listenReady = false;
 const start = () => __awaiter(void 0, void 0, void 0, function* () {
     fs_1.default.mkdirSync(dataDir, { recursive: true });
     // 自动检测数据库类型并执行迁移（如果需要）
-    console.log('[Server] Initializing database...');
+    console.time('[Server] step "database-init"');
     const dbManager = yield database_factory_1.DatabaseFactory.createAuto(dataDir, legacyDataDir);
-    console.log('[Server] Database initialized successfully');
+    console.timeEnd('[Server] step "database-init"');
     // 服务启动时自动同步配置文件（适用于 CLI 和 dev:server）
-    console.log('[Server] Syncing tool configs with global settings...');
+    console.time('[Server] step "sync-configs"');
     try {
         yield syncConfigsOnServerStartup(dbManager);
-        console.log('[Server] Tool config sync completed');
     }
     catch (error) {
         console.error('[Server] Tool config sync failed:', error);
     }
+    console.timeEnd('[Server] step "sync-configs"');
     // 清理旧的迁移临时文件
     try {
         (0, session_launcher_1.cleanupOldTempFiles)();
@@ -3328,8 +3330,10 @@ const start = () => __awaiter(void 0, void 0, void 0, function* () {
     // Initialize proxy server and register proxy routes last
     proxyServer.initialize();
     // Register admin routes first
+    console.time('[Server] step "register-routes"');
     yield registerRoutes(dbManager, proxyServer);
     yield proxyServer.registerProxyRoutes();
+    console.timeEnd('[Server] step "register-routes"');
     app.use(express_1.default.static(path_1.default.resolve(__dirname, '../ui')));
     // 404 处理程序 - 确保返回 JSON 而不是 HTML（放在所有路由和静态文件之后）
     app.use((_req, res) => {
@@ -3347,14 +3351,28 @@ const start = () => __awaiter(void 0, void 0, void 0, function* () {
         console.error(`端口 ${port} 已被占用，无法启动服务。请执行 aicos stop 后重启。`);
         process.exit(1);
     }
+    console.time('[Server] step "listen"');
     const server = app.listen(port, host, () => {
+        listenReady = true;
         console.log(`Admin server running on http://${host}:${port}`);
+        console.timeEnd('[Server] step "listen"');
         // 启动后异步执行延迟维护任务（分片校验/修复、日志清理、会话索引构建）
         // 不阻塞服务启动，后台静默执行
         dbManager.deferredMaintenance().catch(err => {
             console.error('[Server] Deferred maintenance error:', err);
         });
     });
+    // 显式处理 listen 错误（EADDRINUSE/权限不足等），打印明确日志并退出，
+    // 避免被全局 uncaughtException 静默吞掉导致"进程在但不 listen"
+    server.on('error', (err) => {
+        if (err.code === 'EADDRINUSE') {
+            console.error(`[Server] 端口 ${port} 已被占用（EADDRINUSE）。请执行 aicos stop 后重启，或更换端口（PORT 环境变量）。`);
+        }
+        else {
+            console.error('[Server] 监听失败:', err);
+        }
+        setImmediate(() => process.exit(1));
+    });
     // 创建 WebSocket 服务器用于工具安装
     const toolInstallWss = (0, websocket_service_1.createToolInstallationWSServer)();
     // 设置黑名单检查函数，用于在规则状态同步时检查黑名单是否已过期
@@ -3435,11 +3453,19 @@ const start = () => __awaiter(void 0, void 0, void 0, function* () {
 process.on('uncaughtException', (error) => {
     console.error('[Uncaught Exception] 服务遇到未捕获的异常:', error);
     console.error('[Uncaught Exception] 堆栈信息:', error.stack);
-    // 不退出进程，继续运行
+    // 启动阶段（listen 之前）的异常通常是致命的（依赖加载失败、初始化崩溃等），
+    // 静默吞掉会导致"进程在但不 listen"，Tauri 只能干等超时；此时退出让上层重新探测/诊断。
+    if (!listenReady) {
+        console.error('[Uncaught Exception] 发生在服务监听之前，退出进程');
+        process.exit(1);
+    }
 });
 process.on('unhandledRejection', (reason) => {
     console.error('[Unhandled Rejection] 服务遇到未处理的 Promise 拒绝:', reason);
-    // 不退出进程，继续运行
+    if (!listenReady) {
+        console.error('[Unhandled Rejection] 发生在服务监听之前，退出进程');
+        process.exit(1);
+    }
 });
 start().catch((error) => {
     console.error('Failed to start server:', error);

package/dist/server/session-launcher.js

@@ -22,7 +22,7 @@ const os_1 = require("os");
 function which(cmd) {
     try {
         const command = process.platform === 'win32' ? `where ${cmd}` : `which ${cmd}`;
-        (0, child_process_1.execSync)(command, { stdio: 'ignore' });
+        (0, child_process_1.execSync)(command, { stdio: 'ignore', windowsHide: true }); // 隐藏 Windows 命令行窗口，避免检测时闪窗
         return true;
     }
     catch (_a) {

package/dist/server/tools-service.js

@@ -29,6 +29,7 @@ function checkToolInstalled(toolName) {
             const child = (0, child_process_1.spawn)(command, ['--version'], {
                 shell: true,
                 stdio: ['ignore', 'pipe', 'pipe'],
+                windowsHide: true, // 隐藏 Windows 命令行窗口，避免检测时闪窗
             });
             let stdout = '';
             let stderr = '';

package/dist/server/utils.js

@@ -9,13 +9,27 @@ Object.defineProperty(exports, "isLastMessageCompact", { enumerable: true, get:
 Object.defineProperty(exports, "isCodexCompactRequest", { enumerable: true, get: function () { return compact_1.isCodexCompactRequest; } });
 function checkPortUsable(port) {
     return new Promise((resolve) => {
+        let settled = false;
         const server = net.createConnection({ port });
-        server.on('connect', () => {
-            server.end();
-            resolve(false);
-        });
-        server.on('error', () => {
-            resolve(true);
+        const finish = (val) => {
+            if (settled)
+                return;
+            settled = true;
+            try {
+                server.destroy();
+            }
+            catch ( /* ignore */_a) { /* ignore */ }
+            resolve(val);
+        };
+        // 正常：连得上 = 端口被占；连不上(ECONNREFUSED) = 端口可用
+        server.on('connect', () => finish(false));
+        server.on('error', () => finish(true));
+        // 兜底：网络栈异常（防火墙/杀软 hook）时 connect/error 可能都不触发，
+        // 1.5s 后强制按可用处理，避免 start() 永久卡死。误判由 app.listen 的 EADDRINUSE 兜底。
+        server.setTimeout(1500);
+        server.once('timeout', () => {
+            console.warn(`[checkPortUsable] 探测端口 ${port} 超时(1.5s)，按可用处理`);
+            finish(true);
         });
     });
 }

package/dist/ui/aicodeswitch-flow.svg

@@ -0,0 +1,360 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1400 860" font-family="ui-sans-serif, system-ui, -apple-system, 'Segoe UI', 'PingFang SC', 'Microsoft YaHei', sans-serif" text-rendering="geometricPrecision">
+  <title>AICodeSwitch 转流架构图</title>
+  <desc>展示 AI 编程工具（Claude Code / Codex / Cursor 等）的请求，经 AICodeSwitch 本地代理完成鉴权、路由、规则匹配、格式转换后，转流到上游 LLM 服务商（Anthropic / OpenAI / Gemini / DeepSeek 等），响应原路回流。</desc>
+
+  <defs>
+    <linearGradient id="bgGrad" x1="0" y1="0" x2="0" y2="1">
+      <stop offset="0" stop-color="#0c1326"/>
+      <stop offset=".5" stop-color="#111c3a"/>
+      <stop offset="1" stop-color="#090f1f"/>
+    </linearGradient>
+    <radialGradient id="bgGlow" cx=".5" cy=".06" r=".78">
+      <stop offset="0" stop-color="#22d3ee" stop-opacity=".18"/>
+      <stop offset=".45" stop-color="#7c3aed" stop-opacity=".10"/>
+      <stop offset="1" stop-color="#090f1f" stop-opacity="0"/>
+    </radialGradient>
+    <linearGradient id="titleGrad" x1="0" y1="0" x2="1" y2="0">
+      <stop offset="0" stop-color="#5eead4"/>
+      <stop offset=".45" stop-color="#22d3ee"/>
+      <stop offset=".75" stop-color="#a855f7"/>
+      <stop offset="1" stop-color="#ec4899"/>
+    </linearGradient>
+    <linearGradient id="coreStroke" x1="0" y1="0" x2="1" y2="1">
+      <stop offset="0" stop-color="#22d3ee"/>
+      <stop offset=".5" stop-color="#a855f7"/>
+      <stop offset="1" stop-color="#ec4899"/>
+    </linearGradient>
+    <linearGradient id="coreFill" x1="0" y1="0" x2="0" y2="1">
+      <stop offset="0" stop-color="#0f1830" stop-opacity=".92"/>
+      <stop offset="1" stop-color="#0b1124" stop-opacity=".92"/>
+    </linearGradient>
+    <linearGradient id="panelFill" x1="0" y1="0" x2="1" y2="0">
+      <stop offset="0" stop-color="#16234c" stop-opacity=".78"/>
+      <stop offset="1" stop-color="#101935" stop-opacity=".78"/>
+    </linearGradient>
+    <radialGradient id="dotCyan">
+      <stop offset="0" stop-color="#cffafe"/>
+      <stop offset=".45" stop-color="#22d3ee"/>
+      <stop offset="1" stop-color="#22d3ee" stop-opacity="0"/>
+    </radialGradient>
+    <radialGradient id="dotPurple">
+      <stop offset="0" stop-color="#f3e8ff"/>
+      <stop offset=".45" stop-color="#c084fc"/>
+      <stop offset="1" stop-color="#a855f7" stop-opacity="0"/>
+    </radialGradient>
+    <marker id="arrowCyan" viewBox="0 0 10 10" refX="8.5" refY="5" markerWidth="7" markerHeight="7" orient="auto-start-reverse">
+      <path d="M0,1 L9,5 L0,9 z" fill="#22d3ee"/>
+    </marker>
+    <marker id="arrowPurple" viewBox="0 0 10 10" refX="8.5" refY="5" markerWidth="7" markerHeight="7" orient="auto-start-reverse">
+      <path d="M0,1 L9,5 L0,9 z" fill="#c084fc"/>
+    </marker>
+    <style>
+      @media (prefers-reduced-motion: reduce){
+        animate,animateTransform,animateMotion{display:none}
+      }
+    </style>
+  </defs>
+
+  <!-- ============ background ============ -->
+  <rect width="1400" height="860" fill="url(#bgGrad)"/>
+  <rect width="1400" height="860" fill="url(#bgGlow)"/>
+
+  <!-- ============ title ============ -->
+  <text x="700" y="60" text-anchor="middle" font-size="32" font-weight="800" fill="url(#titleGrad)" letter-spacing="0.5">AICodeSwitch · 转流架构</text>
+  <text x="700" y="89" text-anchor="middle" font-size="14.5" fill="#8c9bc4">本地代理 · 把 AI 编程工具的请求智能路由并转换格式，转流到任意模型 API</text>
+
+  <!-- column captions -->
+  <text x="169" y="196" text-anchor="middle" font-size="12" font-weight="700" fill="#6f7da6" letter-spacing="2">客户端 · AI 编程工具</text>
+  <text x="1231" y="158" text-anchor="middle" font-size="12" font-weight="700" fill="#6f7da6" letter-spacing="2">上游 · LLM 服务商</text>
+
+  <!-- ============ LEFT column · clients ============ -->
+  <!-- Claude Code -->
+  <g>
+    <rect x="64" y="220" width="210" height="118" rx="16" fill="#111a33" stroke="#243156"/>
+    <rect x="66" y="238" width="4" height="82" rx="2" fill="#a855f7"/>
+    <circle cx="108" cy="264" r="22" fill="#a855f7" fill-opacity=".16" stroke="#a855f7" stroke-width="1.5"/>
+    <text x="108" y="271" text-anchor="middle" font-size="18" font-weight="800" fill="#d8b4fe">C</text>
+    <text x="142" y="258" font-size="16.5" font-weight="700" fill="#e6edf7">Claude Code</text>
+    <text x="142" y="280" font-size="12" fill="#8c9bc4">/v1/messages</text>
+    <g transform="translate(82,298)">
+      <rect width="118" height="24" rx="12" fill="#a855f7" fill-opacity=".12" stroke="#a855f7" stroke-opacity=".5"/>
+      <text x="59" y="16" text-anchor="middle" font-size="11" fill="#d8b4fe">Anthropic 协议</text>
+    </g>
+  </g>
+
+  <!-- Codex -->
+  <g>
+    <rect x="64" y="372" width="210" height="118" rx="16" fill="#111a33" stroke="#243156"/>
+    <rect x="66" y="390" width="4" height="82" rx="2" fill="#10b981"/>
+    <circle cx="108" cy="416" r="22" fill="#10b981" fill-opacity=".16" stroke="#10b981" stroke-width="1.5"/>
+    <text x="108" y="423" text-anchor="middle" font-size="15" font-weight="800" fill="#a7f3d0">Cx</text>
+    <text x="142" y="410" font-size="16.5" font-weight="700" fill="#e6edf7">Codex</text>
+    <text x="142" y="432" font-size="12" fill="#8c9bc4">/v1/responses</text>
+    <g transform="translate(82,450)">
+      <rect width="118" height="24" rx="12" fill="#10b981" fill-opacity=".12" stroke="#10b981" stroke-opacity=".5"/>
+      <text x="59" y="16" text-anchor="middle" font-size="11" fill="#a7f3d0">OpenAI 协议</text>
+    </g>
+  </g>
+
+  <!-- Cursor / others -->
+  <g>
+    <rect x="64" y="524" width="210" height="118" rx="16" fill="#111a33" stroke="#243156"/>
+    <rect x="66" y="542" width="4" height="82" rx="2" fill="#22d3ee"/>
+    <circle cx="108" cy="568" r="22" fill="#22d3ee" fill-opacity=".16" stroke="#22d3ee" stroke-width="1.5"/>
+    <text x="108" y="576" text-anchor="middle" font-size="20" font-weight="800" fill="#a5f3fc">+</text>
+    <text x="142" y="562" font-size="16.5" font-weight="700" fill="#e6edf7">Cursor · 其他</text>
+    <text x="142" y="584" font-size="12" fill="#8c9bc4">/v1/chat/completions</text>
+    <g transform="translate(82,602)">
+      <rect width="132" height="24" rx="12" fill="#22d3ee" fill-opacity=".12" stroke="#22d3ee" stroke-opacity=".5"/>
+      <text x="66" y="16" text-anchor="middle" font-size="11" fill="#a5f3fc">OpenAI 兼容</text>
+    </g>
+  </g>
+
+  <!-- ============ CENTER · core engine ============ -->
+  <g>
+    <rect x="360" y="150" width="680" height="550" rx="22" fill="url(#coreFill)" stroke="url(#coreStroke)" stroke-width="1.6">
+      <animate attributeName="stroke-opacity" values="0.55;0.95;0.55" dur="4.5s" repeatCount="indefinite"/>
+    </rect>
+    <!-- top highlight -->
+    <path d="M382,150 H1018 a22,22 0 0 1 22,22 V192 H360 V172 a22,22 0 0 1 22,-22 z" fill="#ffffff" fill-opacity=".035"/>
+    <!-- header -->
+    <rect x="386" y="166" width="16" height="16" rx="4" fill="url(#coreStroke)"/>
+    <text x="410" y="180" font-size="17" font-weight="800" fill="#e6edf7">AICodeSwitch Proxy Core</text>
+    <text x="1014" y="180" text-anchor="end" font-size="11.5" fill="#6f7da6">localhost · 中转引擎</text>
+
+    <!-- ── M1 Auth ── -->
+    <g>
+      <rect x="380" y="210" width="640" height="86" rx="14" fill="url(#panelFill)" stroke="#1f2c52"/>
+      <circle cx="416" cy="253" r="18" fill="#22d3ee" fill-opacity=".14" stroke="#22d3ee" stroke-width="1.4"/>
+      <g transform="translate(408,243)" stroke="#67e8f9" stroke-width="1.6" fill="none" stroke-linecap="round">
+        <rect x="2" y="7" width="12" height="9" rx="2"/>
+        <path d="M5,7 V5 a3,3 0 0 1 6,0 V7"/>
+      </g>
+      <text x="446" y="244" font-size="15.5" font-weight="700" fill="#e6edf7">① 鉴权 Auth</text>
+      <text x="446" y="266" font-size="12" fill="#8c9bc4">API Key 解析 · sk_ 池密钥 / skr_ 路由密钥 · JWT</text>
+      <g transform="translate(818,242)">
+        <rect width="202" height="22" rx="11" fill="#22d3ee" fill-opacity=".10" stroke="#22d3ee" stroke-opacity=".4"/>
+        <text x="101" y="15" text-anchor="middle" font-size="10" fill="#67e8f9">Authorization · x-api-key · x-goog-api-key</text>
+      </g>
+    </g>
+
+    <!-- ── M2 Route + Rules ── -->
+    <g>
+      <rect x="380" y="308" width="640" height="148" rx="14" fill="url(#panelFill)" stroke="#1f2c52"/>
+      <circle cx="416" cy="338" r="18" fill="#a855f7" fill-opacity=".14" stroke="#a855f7" stroke-width="1.4"/>
+      <g transform="translate(407,329)" stroke="#d8b4fe" stroke-width="1.4" fill="none" stroke-linecap="round" stroke-linejoin="round">
+        <circle cx="9" cy="9" r="7"/>
+        <path d="M9,4 L11,9 L9,14 L7,9 z" fill="#d8b4fe" stroke="none"/>
+      </g>
+      <text x="446" y="334" font-size="15.5" font-weight="700" fill="#e6edf7">② 路由 &amp; 规则 Route · Rules</text>
+      <text x="446" y="356" font-size="12" fill="#8c9bc4">按内容类型分发到候选上游池，失败自动回退（fallback）</text>
+
+      <!-- content-type pills -->
+      <g font-size="11" font-weight="600">
+        <g transform="translate(396,378)">
+          <rect width="68" height="24" rx="12" fill="#94a3b8" fill-opacity=".10" stroke="#94a3b8" stroke-opacity=".5"/>
+          <text x="34" y="16" text-anchor="middle" fill="#cbd5e1">default</text>
+        </g>
+        <g transform="translate(472,378)">
+          <rect width="72" height="24" rx="12" fill="#a855f7" fill-opacity=".12" stroke="#a855f7" stroke-opacity=".55"/>
+          <text x="36" y="16" text-anchor="middle" fill="#d8b4fe">thinking</text>
+        </g>
+        <g transform="translate(554,378)">
+          <rect width="100" height="24" rx="12" fill="#3b82f6" fill-opacity=".12" stroke="#3b82f6" stroke-opacity=".55"/>
+          <text x="50" y="16" text-anchor="middle" fill="#bfdbfe">long-context</text>
+        </g>
+        <g transform="translate(396,410)">
+          <rect width="140" height="24" rx="12" fill="#ec4899" fill-opacity=".12" stroke="#ec4899" stroke-opacity=".55"/>
+          <text x="70" y="16" text-anchor="middle" fill="#f9a8d4">image-understanding</text>
+        </g>
+        <g transform="translate(544,410)">
+          <rect width="86" height="24" rx="12" fill="#06b6d4" fill-opacity=".12" stroke="#06b6d4" stroke-opacity=".55"/>
+          <text x="43" y="16" text-anchor="middle" fill="#a5f3fc">background</text>
+        </g>
+        <g transform="translate(638,410)">
+          <rect width="66" height="24" rx="12" fill="#f59e0b" fill-opacity=".12" stroke="#f59e0b" stroke-opacity=".55"/>
+          <text x="33" y="16" text-anchor="middle" fill="#fcd34d">high-iq</text>
+        </g>
+      </g>
+    </g>
+
+    <!-- ── M3 Transformers ── -->
+    <g>
+      <rect x="380" y="468" width="640" height="104" rx="14" fill="url(#panelFill)" stroke="#1f2c52"/>
+      <circle cx="416" cy="500" r="18" fill="#ec4899" fill-opacity=".14" stroke="#ec4899" stroke-width="1.4"/>
+      <g transform="translate(407,491)" stroke="#f9a8d4" stroke-width="1.5" fill="none" stroke-linecap="round" stroke-linejoin="round">
+        <path d="M3,5 H15 M12,2 L15,5 L12,8"/>
+        <path d="M15,13 H3 M6,10 L3,13 L6,16"/>
+      </g>
+      <text x="446" y="498" font-size="15.5" font-weight="700" fill="#e6edf7">③ 格式转换 Transformers</text>
+      <text x="446" y="520" font-size="12" fill="#8c9bc4">Claude ↔ OpenAI ↔ Gemini ↔ DeepSeek · 双向转换 · SSE 流式</text>
+      <g transform="translate(446,536)" font-size="10.5" font-weight="700">
+        <rect x="0" y="0" width="56" height="22" rx="6" fill="#a855f7" fill-opacity=".16" stroke="#a855f7" stroke-opacity=".5"/>
+        <text x="28" y="15" text-anchor="middle" fill="#d8b4fe">Claude</text>
+        <text x="64" y="15" fill="#6f7da6">↔</text>
+        <rect x="78" y="0" width="58" height="22" rx="6" fill="#10b981" fill-opacity=".16" stroke="#10b981" stroke-opacity=".5"/>
+        <text x="107" y="15" text-anchor="middle" fill="#a7f3d0">OpenAI</text>
+        <text x="144" y="15" fill="#6f7da6">↔</text>
+        <rect x="158" y="0" width="58" height="22" rx="6" fill="#3b82f6" fill-opacity=".16" stroke="#3b82f6" stroke-opacity=".5"/>
+        <text x="187" y="15" text-anchor="middle" fill="#bfdbfe">Gemini</text>
+        <text x="224" y="15" fill="#6f7da6">↔</text>
+        <rect x="238" y="0" width="68" height="22" rx="6" fill="#8b5cf6" fill-opacity=".16" stroke="#8b5cf6" stroke-opacity=".5"/>
+        <text x="272" y="15" text-anchor="middle" fill="#c4b5fd">DeepSeek</text>
+      </g>
+      <g transform="translate(912,490)">
+        <rect width="96" height="22" rx="11" fill="#ec4899" fill-opacity=".12" stroke="#ec4899" stroke-opacity=".45"/>
+        <text x="48" y="15" text-anchor="middle" font-size="10.5" fill="#f9a8d4">SSE 流式</text>
+      </g>
+    </g>
+
+    <!-- ── M4 Logging ── -->
+    <g>
+      <rect x="380" y="584" width="640" height="92" rx="14" fill="url(#panelFill)" stroke="#1f2c52"/>
+      <circle cx="416" cy="616" r="18" fill="#10b981" fill-opacity=".14" stroke="#10b981" stroke-width="1.4"/>
+      <g transform="translate(407,607)" stroke="#6ee7b7" stroke-width="1.4" fill="none" stroke-linecap="round">
+        <path d="M3,15 H17"/>
+        <rect x="5" y="9" width="3" height="6" fill="#6ee7b7" stroke="none"/>
+        <rect x="10" y="5" width="3" height="10" fill="#6ee7b7" stroke="none"/>
+        <rect x="15" y="11" width="3" height="4" fill="#6ee7b7" stroke="none"/>
+      </g>
+      <text x="446" y="614" font-size="15.5" font-weight="700" fill="#e6edf7">④ 日志 / 会话 / 配额 Logging</text>
+      <text x="446" y="636" font-size="12" fill="#8c9bc4">请求日志 · 会话追踪 · 多维配额（Token / RPM / 并发）</text>
+      <g transform="translate(842,606)">
+        <rect width="78" height="22" rx="11" fill="#10b981" fill-opacity=".10" stroke="#10b981" stroke-opacity=".4"/>
+        <text x="39" y="15" text-anchor="middle" font-size="10.5" fill="#6ee7b7">Token 计费</text>
+      </g>
+      <g transform="translate(928,606)">
+        <rect width="78" height="22" rx="11" fill="#10b981" fill-opacity=".10" stroke="#10b981" stroke-opacity=".4"/>
+        <text x="39" y="15" text-anchor="middle" font-size="10.5" fill="#6ee7b7">配额限速</text>
+      </g>
+    </g>
+  </g>
+
+  <!-- ============ RIGHT column · upstream ============ -->
+  <!-- Anthropic -->
+  <g>
+    <rect x="1126" y="180" width="210" height="92" rx="14" fill="#111a33" stroke="#243156"/>
+    <rect x="1330" y="200" width="4" height="52" rx="2" fill="#f59e0b"/>
+    <circle cx="1158" cy="226" r="18" fill="#f59e0b" fill-opacity=".16" stroke="#f59e0b" stroke-width="1.5"/>
+    <text x="1158" y="232" text-anchor="middle" font-size="15" font-weight="800" fill="#fcd34d">A</text>
+    <text x="1188" y="221" font-size="14.5" font-weight="700" fill="#e6edf7">Anthropic</text>
+    <text x="1188" y="240" font-size="11.5" fill="#8c9bc4">Claude · claude-*</text>
+  </g>
+  <!-- OpenAI -->
+  <g>
+    <rect x="1126" y="288" width="210" height="92" rx="14" fill="#111a33" stroke="#243156"/>
+    <rect x="1330" y="308" width="4" height="52" rx="2" fill="#10b981"/>
+    <circle cx="1158" cy="334" r="18" fill="#10b981" fill-opacity=".16" stroke="#10b981" stroke-width="1.5"/>
+    <text x="1158" y="340" text-anchor="middle" font-size="15" font-weight="800" fill="#a7f3d0">O</text>
+    <text x="1188" y="329" font-size="14.5" font-weight="700" fill="#e6edf7">OpenAI</text>
+    <text x="1188" y="348" font-size="11.5" fill="#8c9bc4">GPT · o-*</text>
+  </g>
+  <!-- Gemini -->
+  <g>
+    <rect x="1126" y="396" width="210" height="92" rx="14" fill="#111a33" stroke="#243156"/>
+    <rect x="1330" y="416" width="4" height="52" rx="2" fill="#3b82f6"/>
+    <circle cx="1158" cy="442" r="18" fill="#3b82f6" fill-opacity=".16" stroke="#3b82f6" stroke-width="1.5"/>
+    <text x="1158" y="448" text-anchor="middle" font-size="15" font-weight="800" fill="#bfdbfe">G</text>
+    <text x="1188" y="437" font-size="14.5" font-weight="700" fill="#e6edf7">Google</text>
+    <text x="1188" y="456" font-size="11.5" fill="#8c9bc4">Gemini · gemini-*</text>
+  </g>
+  <!-- DeepSeek -->
+  <g>
+    <rect x="1126" y="504" width="210" height="92" rx="14" fill="#111a33" stroke="#243156"/>
+    <rect x="1330" y="524" width="4" height="52" rx="2" fill="#8b5cf6"/>
+    <circle cx="1158" cy="550" r="18" fill="#8b5cf6" fill-opacity=".16" stroke="#8b5cf6" stroke-width="1.5"/>
+    <text x="1158" y="556" text-anchor="middle" font-size="15" font-weight="800" fill="#c4b5fd">D</text>
+    <text x="1188" y="545" font-size="14.5" font-weight="700" fill="#e6edf7">DeepSeek</text>
+    <text x="1188" y="564" font-size="11.5" fill="#8c9bc4">deepseek-*</text>
+  </g>
+  <!-- Qwen / others -->
+  <g>
+    <rect x="1126" y="612" width="210" height="92" rx="14" fill="#111a33" stroke="#243156"/>
+    <rect x="1330" y="632" width="4" height="52" rx="2" fill="#06b6d4"/>
+    <circle cx="1158" cy="658" r="18" fill="#06b6d4" fill-opacity=".16" stroke="#06b6d4" stroke-width="1.5"/>
+    <text x="1158" y="664" text-anchor="middle" font-size="15" font-weight="800" fill="#a5f3fc">Q</text>
+    <text x="1188" y="653" font-size="14.5" font-weight="700" fill="#e6edf7">Qwen · Kimi 等</text>
+    <text x="1188" y="672" font-size="11.5" fill="#8c9bc4">兼容 OpenAI 协议</text>
+  </g>
+
+  <!-- ============ flow lines · LEFT (clients → core) ============ -->
+  <g fill="none">
+    <!-- L1 -->
+    <path d="M274,279 C314,279 322,375 360,375" stroke="#1c284f" stroke-width="2.2"/>
+    <path d="M274,279 C314,279 322,375 360,375" stroke="#22d3ee" stroke-width="2" stroke-linecap="round" stroke-dasharray="5 9" marker-end="url(#arrowCyan)" opacity=".92">
+      <animate attributeName="stroke-dashoffset" from="14" to="0" dur="1.1s" repeatCount="indefinite"/>
+    </path>
+    <circle r="3.8" fill="url(#dotCyan)">
+      <animateMotion dur="2.4s" repeatCount="indefinite" path="M274,279 C314,279 322,375 360,375"/>
+    </circle>
+    <!-- L2 -->
+    <path d="M274,431 C320,431 322,375 360,375" stroke="#1c284f" stroke-width="2.2"/>
+    <path d="M274,431 C320,431 322,375 360,375" stroke="#22d3ee" stroke-width="2" stroke-linecap="round" stroke-dasharray="5 9" marker-end="url(#arrowCyan)" opacity=".92">
+      <animate attributeName="stroke-dashoffset" from="14" to="0" dur="1.1s" begin="0.35s" repeatCount="indefinite"/>
+    </path>
+    <circle r="3.8" fill="url(#dotCyan)">
+      <animateMotion dur="2.4s" begin="0.8s" repeatCount="indefinite" path="M274,431 C320,431 322,375 360,375"/>
+    </circle>
+    <!-- L3 -->
+    <path d="M274,583 C326,583 324,375 360,375" stroke="#1c284f" stroke-width="2.2"/>
+    <path d="M274,583 C326,583 324,375 360,375" stroke="#22d3ee" stroke-width="2" stroke-linecap="round" stroke-dasharray="5 9" marker-end="url(#arrowCyan)" opacity=".92">
+      <animate attributeName="stroke-dashoffset" from="14" to="0" dur="1.1s" begin="0.7s" repeatCount="indefinite"/>
+    </path>
+    <circle r="3.8" fill="url(#dotCyan)">
+      <animateMotion dur="2.4s" begin="1.6s" repeatCount="indefinite" path="M274,583 C326,583 324,375 360,375"/>
+    </circle>
+  </g>
+
+  <!-- ============ flow lines · RIGHT (core → upstream) ============ -->
+  <g fill="none">
+    <!-- R1 -->
+    <path d="M1040,430 C1082,430 1088,226 1126,226" stroke="#1c284f" stroke-width="2.2"/>
+    <path d="M1040,430 C1082,430 1088,226 1126,226" stroke="#c084fc" stroke-width="2" stroke-linecap="round" stroke-dasharray="5 9" marker-end="url(#arrowPurple)" opacity=".92">
+      <animate attributeName="stroke-dashoffset" from="14" to="0" dur="1.2s" repeatCount="indefinite"/>
+    </path>
+    <circle r="3.8" fill="url(#dotPurple)">
+      <animateMotion dur="2.8s" repeatCount="indefinite" path="M1040,430 C1082,430 1088,226 1126,226"/>
+    </circle>
+    <!-- R2 -->
+    <path d="M1040,430 C1082,430 1088,334 1126,334" stroke="#1c284f" stroke-width="2.2"/>
+    <path d="M1040,430 C1082,430 1088,334 1126,334" stroke="#c084fc" stroke-width="2" stroke-linecap="round" stroke-dasharray="5 9" marker-end="url(#arrowPurple)" opacity=".92">
+      <animate attributeName="stroke-dashoffset" from="14" to="0" dur="1.2s" begin="0.3s" repeatCount="indefinite"/>
+    </path>
+    <circle r="3.8" fill="url(#dotPurple)">
+      <animateMotion dur="2.8s" begin="0.56s" repeatCount="indefinite" path="M1040,430 C1082,430 1088,334 1126,334"/>
+    </circle>
+    <!-- R3 -->
+    <path d="M1040,430 C1082,430 1088,442 1126,442" stroke="#1c284f" stroke-width="2.2"/>
+    <path d="M1040,430 C1082,430 1088,442 1126,442" stroke="#c084fc" stroke-width="2" stroke-linecap="round" stroke-dasharray="5 9" marker-end="url(#arrowPurple)" opacity=".92">
+      <animate attributeName="stroke-dashoffset" from="14" to="0" dur="1.2s" begin="0.6s" repeatCount="indefinite"/>
+    </path>
+    <circle r="3.8" fill="url(#dotPurple)">
+      <animateMotion dur="2.8s" begin="1.12s" repeatCount="indefinite" path="M1040,430 C1082,430 1088,442 1126,442"/>
+    </circle>
+    <!-- R4 -->
+    <path d="M1040,430 C1084,430 1088,550 1126,550" stroke="#1c284f" stroke-width="2.2"/>
+    <path d="M1040,430 C1084,430 1088,550 1126,550" stroke="#c084fc" stroke-width="2" stroke-linecap="round" stroke-dasharray="5 9" marker-end="url(#arrowPurple)" opacity=".92">
+      <animate attributeName="stroke-dashoffset" from="14" to="0" dur="1.2s" begin="0.9s" repeatCount="indefinite"/>
+    </path>
+    <circle r="3.8" fill="url(#dotPurple)">
+      <animateMotion dur="2.8s" begin="1.68s" repeatCount="indefinite" path="M1040,430 C1084,430 1088,550 1126,550"/>
+    </circle>
+    <!-- R5 -->
+    <path d="M1040,430 C1086,430 1088,658 1126,658" stroke="#1c284f" stroke-width="2.2"/>
+    <path d="M1040,430 C1086,430 1088,658 1126,658" stroke="#c084fc" stroke-width="2" stroke-linecap="round" stroke-dasharray="5 9" marker-end="url(#arrowPurple)" opacity=".92">
+      <animate attributeName="stroke-dashoffset" from="14" to="0" dur="1.2s" begin="1.2s" repeatCount="indefinite"/>
+    </path>
+    <circle r="3.8" fill="url(#dotPurple)">
+      <animateMotion dur="2.8s" begin="2.24s" repeatCount="indefinite" path="M1040,430 C1086,430 1088,658 1126,658"/>
+    </circle>
+  </g>
+
+  <!-- ============ footer caption + legend ============ -->
+  <text x="700" y="778" text-anchor="middle" font-size="12.5" fill="#7c89ab">流向：客户端发起请求 → 鉴权 → 路由 / 规则匹配 → 格式转换 → 上游模型；响应原路回流</text>
+  <g transform="translate(592,800)" font-size="11" fill="#8c9bc4">
+    <line x1="0" y1="0" x2="34" y2="0" stroke="#22d3ee" stroke-width="2" stroke-dasharray="5 9"/>
+    <text x="42" y="4">请求汇聚</text>
+    <line x1="130" y1="0" x2="164" y2="0" stroke="#c084fc" stroke-width="2" stroke-dasharray="5 9"/>
+    <text x="172" y="4">分发上游</text>
+  </g>
+</svg>

package/dist/ui/assets/{index-BKBriExY.js → index-NlzYhf99.js}

@@ -176,50 +176,26 @@ AI Code Switch 是帮助你在本地管理 AI 编程工具接入大模型的工
 * 数据完全本地，自主可控
 * 特殊语法：在发送的提示词最前面添加\`[!]\`来直接切换为高智商模型服务（\`[x]\`关闭），简单快捷
 
+![](public/aicodeswitch-flow.svg)
+
 ## 桌面客户端
 
 [进入下载](https://github.com/tangshuang/aicodeswitch/releases)
 
 ## 命令行工具
 
-### 安装
-
 \`\`\`
+# 安装
 npm install -g aicodeswitch
-\`\`\`
-
-### 使用方法
-
-**启动服务**
-
-\`\`\`
+# 启动服务
 aicos start
-\`\`\`
-
-或者直接运行
-
-\`\`\`
+# http://127.0.0.1:4567
+# 启动服务并打开管理界面
 aicos ui
-\`\`\`
-
-**停止服务**
-
-\`\`\`
+# 停止服务
 aicos stop
 \`\`\`
 
-**进入管理界面**
-
-\`\`\`
-# 自动启动服务和打开界面
-aicos ui
-\`\`\`
-
-\`\`\`
-# 手动在浏览器打开管理界面
-http://127.0.0.1:4567
-\`\`\`
-
 ## 管理界面
 
 **配置供应商**
@@ -398,6 +374,7 @@ PORT=4567
 ## 关联资源
 
 * [Claude Code 深度教程](https://claudecode.tangshuang.net): 100%免费的Claude Code入门到精通教程
+* [AICodingBus](https://aicodingbus.24x7.to): AI Tokens 交换平台
 
 ## 支持我
 

package/dist/ui/index.html

@@ -4,7 +4,7 @@
     <meta charset="UTF-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
     <title>AI Code Switch</title>
-    <script type="module" crossorigin src="./assets/index-BKBriExY.js"></script>
+    <script type="module" crossorigin src="./assets/index-NlzYhf99.js"></script>
     <link rel="stylesheet" crossorigin href="./assets/index-MjMlew6J.css">
   </head>
   <body>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aicodeswitch",
-  "version": "5.2.9",
+  "version": "5.2.10",
   "description": "A tool to help you manage AI programming tools to access large language models locally. It allows your Claude Code, Codex and other tools to no longer be limited to official models.",
   "author": "tangshuang",
   "license": "GPL-3.0",