@tonyclaw/llm-inspector 1.6.0 → 1.6.2

package/.output/cli.js

@@ -0,0 +1,119 @@
+#!/usr/bin/env node
+
+// src/cli.ts
+import { spawn } from "node:child_process";
+import { fileURLToPath } from "node:url";
+import { dirname, join } from "node:path";
+import { existsSync } from "node:fs";
+var __filename = fileURLToPath(import.meta.url);
+var __dirname = dirname(__filename);
+var DEFAULT_PORT = 25947;
+var findBun = () => {
+  const pathEnv = process.env.PATH ?? "";
+  const pathDirs = pathEnv.split(process.platform === "win32" ? ";" : ":");
+  for (const dir of pathDirs) {
+    const bunPath2 = join(dir, process.platform === "win32" ? "bun.exe" : "bun");
+    if (existsSync(bunPath2)) {
+      if (process.platform === "win32" && !bunPath2.endsWith(".exe")) {
+        const actualPath = join(dir, "node_modules", "bun", "bin", "bun.exe");
+        if (existsSync(actualPath)) {
+          return actualPath;
+        }
+      }
+      return bunPath2;
+    }
+  }
+  if (process.platform === "win32") {
+    const localAppData = process.env.LOCALAPPDATA ?? "";
+    const appData = process.env.APPDATA ?? "";
+    const userProfile = process.env.USERPROFILE ?? "";
+    const commonPaths = [
+      join(localAppData, "bun", "bin", "bun.exe"),
+      join(appData, "bun", "bin", "bun.exe"),
+      join(userProfile, "AppData", "Local", "bun", "bin", "bun.exe"),
+      join(userProfile, "AppData", "Roaming", "npm", "node_modules", "bun", "bin", "bun.exe"),
+      join(userProfile, "AppData", "Roaming", "npm", "bun")
+    ];
+    for (const bunPath2 of commonPaths) {
+      if (existsSync(bunPath2)) {
+        return bunPath2;
+      }
+    }
+  }
+  return null;
+};
+var envPort = process.env["PORT"];
+var portDefault = envPort !== void 0 ? Number(envPort) : DEFAULT_PORT;
+var args = process.argv.slice(2);
+var port = portDefault;
+var open = true;
+for (let i = 0; i < args.length; i++) {
+  const arg = args[i] ?? "";
+  switch (arg) {
+    case "--port":
+    case "-p":
+      port = Number(args[i + 1]);
+      i++;
+      break;
+    case "--no-open":
+      open = false;
+      break;
+    case "--open":
+      open = true;
+      break;
+    default:
+      break;
+  }
+}
+process.env["PORT"] = String(port);
+var url = `http://localhost:${port}`;
+console.log(`Server running at ${url}`);
+console.log(`   Proxy: ${url}/proxy`);
+console.log(``);
+console.log(`Route AI coding tools through the proxy:`);
+console.log(`   Claude Code:  ANTHROPIC_BASE_URL=${url}/proxy claude`);
+console.log(`   OpenCode:     LLM_BASE_URL=${url}/proxy opencode`);
+console.log(`   Direct HTTP:  curl ${url}/proxy/v1/messages -d '{"model":"...","messages":[...]}'`);
+console.log(``);
+console.log(`Routing environment variables:`);
+console.log(`   ROUTES            JSON map of model prefix -> upstream URL`);
+console.log(`   DEFAULT_UPSTREAM  Fallback upstream for unmatched models`);
+console.log(
+  `   Example: ROUTES='{"claude-":"https://api.anthropic.com","MiniMax":"https://api.minimaxi.com/anthropic"}'`
+);
+var openBrowser = (targetUrl) => {
+  let command;
+  switch (process.platform) {
+    case "darwin":
+      command = ["open", targetUrl];
+      break;
+    case "linux":
+      command = ["xdg-open", targetUrl];
+      break;
+    case "win32":
+      command = ["cmd", "/c", "start", targetUrl];
+      break;
+    default:
+      break;
+  }
+  if (command === void 0) return;
+  const [bin, ...cmdArgs] = command;
+  if (bin === void 0) return;
+  spawn(bin, cmdArgs, { stdio: "ignore", detached: true });
+};
+if (open) {
+  openBrowser(url);
+}
+var bunPath = findBun();
+if (bunPath === null) {
+  console.error("\nError: bun is not installed or not in PATH.");
+  console.error("Please install bun from https://bun.sh");
+  process.exit(1);
+}
+var outputDir = __dirname;
+var serverPath = join(outputDir, "../.output/server/index.mjs");
+var serverProcess = spawn(bunPath, [serverPath], {
+  stdio: ["ignore", "inherit", "inherit"],
+  detached: true
+});
+serverProcess.unref();

package/.output/nitro.json

@@ -1,5 +1,5 @@
 {
-  "date": "2026-06-03T06:11:16.990Z",
+  "date": "2026-06-03T07:56:05.905Z",
   "preset": "bun",
   "framework": {
     "name": "nitro",

package/.output/server/index.mjs

@@ -96,49 +96,49 @@ const assets = {
   "/assets/alibaba-TTwafVwX.svg": {
     "type": "image/svg+xml",
     "etag": '"171b-6dyV5K8QjiaY35sN9qNprh9zDIs"',
-    "mtime": "2026-06-03T06:11:11.193Z",
+    "mtime": "2026-06-03T07:55:59.581Z",
     "size": 5915,
     "path": "../public/assets/alibaba-TTwafVwX.svg"
   },
   "/assets/index-B3RwBPLW.css": {
     "type": "text/css; charset=utf-8",
     "etag": '"10c74-aXacU4DRFVsUwcC5jHnjoPRSlTA"',
-    "mtime": "2026-06-03T06:11:11.195Z",
+    "mtime": "2026-06-03T07:55:59.583Z",
     "size": 68724,
     "path": "../public/assets/index-B3RwBPLW.css"
   },
-  "/assets/minimax-BPMzvuL-.jpeg": {
-    "type": "image/jpeg",
-    "etag": '"1b06-IwivU89ko5UTMUM1/t7hn4sQK9A"',
-    "mtime": "2026-06-03T06:11:11.192Z",
-    "size": 6918,
-    "path": "../public/assets/minimax-BPMzvuL-.jpeg"
-  },
-  "/assets/zhipuai-BPNAnxo-.svg": {
-    "type": "image/svg+xml",
-    "etag": '"2bf8-hNaLCTi89nOFCsIIfWpP/jrfo0s"',
-    "mtime": "2026-06-03T06:11:11.193Z",
-    "size": 11256,
-    "path": "../public/assets/zhipuai-BPNAnxo-.svg"
-  },
   "/assets/main-Cp8AM0Pa.js": {
     "type": "text/javascript; charset=utf-8",
     "etag": '"4db57-FpqlPRLq9OHoaAFCL2NIXtZbW5c"',
-    "mtime": "2026-06-03T06:11:11.193Z",
+    "mtime": "2026-06-03T07:55:59.583Z",
     "size": 318295,
     "path": "../public/assets/main-Cp8AM0Pa.js"
   },
   "/assets/qwen-CONDcHqt.png": {
     "type": "image/png",
     "etag": '"572c3-cdJAPaHdOvFCGzuaQjagdgOu6XE"',
-    "mtime": "2026-06-03T06:11:11.193Z",
+    "mtime": "2026-06-03T07:55:59.581Z",
     "size": 357059,
     "path": "../public/assets/qwen-CONDcHqt.png"
   },
+  "/assets/minimax-BPMzvuL-.jpeg": {
+    "type": "image/jpeg",
+    "etag": '"1b06-IwivU89ko5UTMUM1/t7hn4sQK9A"',
+    "mtime": "2026-06-03T07:55:59.580Z",
+    "size": 6918,
+    "path": "../public/assets/minimax-BPMzvuL-.jpeg"
+  },
+  "/assets/zhipuai-BPNAnxo-.svg": {
+    "type": "image/svg+xml",
+    "etag": '"2bf8-hNaLCTi89nOFCsIIfWpP/jrfo0s"',
+    "mtime": "2026-06-03T07:55:59.581Z",
+    "size": 11256,
+    "path": "../public/assets/zhipuai-BPNAnxo-.svg"
+  },
   "/assets/index-s4lwsWvq.js": {
     "type": "text/javascript; charset=utf-8",
     "etag": '"828c8-LEW/XL92J2/5lU4VKALlH7aVpaA"',
-    "mtime": "2026-06-03T06:11:11.193Z",
+    "mtime": "2026-06-03T07:55:59.583Z",
     "size": 534728,
     "path": "../public/assets/index-s4lwsWvq.js"
   }

package/README.md

@@ -12,6 +12,20 @@ llm-inspector 是一个 LLM API 透明代理，能够捕获 AI 编程工具（Cl
 
 ## 核心特性 / Features
 
+### 请求重放调试 / Request Replay
+
+![Replay](docs/Replay.png)
+
+回放任意历史请求，快速复现问题。支持流式/非流式两种模式。
+
+### 实时 SSE 流更新 / Real-Time SSE Streaming
+
+SSE 流式响应实时推送，无需轮询，即时查看每个数据块。
+
+### 健康检查 / Health Check
+
+`GET /api/health` 端点，支持 Docker Compose 健康检查和容器编排。
+
 ### 支持多种 AI 编程工具 / Multiple AI Coding Tools
 
 ```bash
@@ -47,6 +61,23 @@ ANTHROPIC_BASE_URL=http://localhost:25947/proxy <your-tool>
 
 ## 快速开始 / Quick Start
 
+### npm 安装（推荐）
+
+```bash
+npm install -g @tonyclaw/llm-inspector
+
+# 启动
+llm-inspector
+```
+
+### Docker
+
+```bash
+docker-compose up -d
+```
+
+### 源码运行
+
 ```bash
 # 安装依赖
 bun install
@@ -71,6 +102,23 @@ LLM_BASE_URL=http://localhost:25947/proxy opencode
 
 ---
 
+## Docker 部署 / Docker Deployment
+
+```bash
+# 构建并启动
+docker-compose up -d
+
+# 查看日志
+docker-compose logs -f
+
+# 停止
+docker-compose down
+```
+
+容器默认暴露 `25947` 端口，包含健康检查，可直接接入 Docker Compose 或 Kubernetes。
+
+---
+
 ## 实时仪表盘 / Real-Time Dashboard
 
 ### 日志列表 / Log List
@@ -132,7 +180,9 @@ AI Coding Tool  →  llm-inspector (:25947/proxy/*)  →  LLM Provider
 ## 命令行 / CLI
 
 ```bash
-llm-inspector [--port <端口>] [--open|--no-open]
+llm-inspector                    # 启动服务
+llm-inspector --port 3000       # 指定端口
+llm-inspector --no-open         # 禁止自动打开浏览器
 ```
 
 | 参数 | 默认值 | 说明 |
@@ -192,5 +242,7 @@ git tag v<version>
 git push origin main --tags
 
 # 3. 发布到 npm
-npm publish --access public --provenance
+npm publish --access public
 ```
+
+包名：`@tonyclaw/llm-inspector`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tonyclaw/llm-inspector",
-  "version": "1.6.0",
+  "version": "1.6.2",
   "type": "module",
   "description": "LLM API proxy inspector — captures and displays requests/responses from AI coding tools in a web UI",
   "license": "MIT",
@@ -18,7 +18,7 @@
     "ai-coding-tools"
   ],
   "bin": {
-    "llm-inspector": "src/cli.ts"
+    "llm-inspector": ".output/cli.js"
   },
   "files": [
     "src",
@@ -31,9 +31,10 @@
   ],
   "scripts": {
     "dev": "vite dev",
-    "start": "bun src/cli.ts",
-    "build": "vite build",
-    "prepublishOnly": "bun run build",
+    "start": "node .output/cli.js",
+    "build": "vite build && bun build:cli",
+    "build:cli": "npx esbuild src/cli.ts --bundle --platform=node --target=node18 --format=esm --outfile=.output/cli.js",
+    "prepublishOnly": "npm run build",
     "typecheck": "tsc --noEmit",
     "lint": "eslint .",
     "format": "biome format --write .",
@@ -52,7 +53,6 @@
     "@tanstack/react-start": "^1.161.0",
     "@tanstack/react-virtual": "^3.13.26",
     "class-variance-authority": "^0.7.1",
-    "cleye": "^2.2.1",
     "clsx": "^2.1.1",
     "conf": "^15.1.0",
     "jszip": "^3.10.1",
@@ -76,6 +76,7 @@
     "@typescript-eslint/eslint-plugin": "^8.55.0",
     "@typescript-eslint/parser": "^8.55.0",
     "@vitejs/plugin-react": "^5.1.4",
+    "esbuild": "^0.25.0",
     "eslint": "^9.32.0",
     "eslint-plugin-eslint-comments": "^3.2.0",
     "eslint-plugin-functional": "^9.0.2",

package/src/cli.ts

@@ -1,31 +1,88 @@
-#!/usr/bin/env bun
-import { cli } from "cleye";
+#!/usr/bin/env node
+import { spawn } from "node:child_process";
+import { fileURLToPath } from "node:url";
+import { dirname, join } from "node:path";
+import { existsSync } from "node:fs";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
 
 const DEFAULT_PORT = 25947;
 
+// Find bun executable
+const findBun = (): string | null => {
+  // Check if bun is in PATH
+  const pathEnv = process.env.PATH ?? "";
+  const pathDirs = pathEnv.split(process.platform === "win32" ? ";" : ":");
+
+  for (const dir of pathDirs) {
+    const bunPath = join(dir, process.platform === "win32" ? "bun.exe" : "bun");
+    if (existsSync(bunPath)) {
+      // On Windows, npm shim is a script, not the actual exe
+      if (process.platform === "win32" && !bunPath.endsWith(".exe")) {
+        // Check if it's the npm shim and find the actual exe
+        const actualPath = join(dir, "node_modules", "bun", "bin", "bun.exe");
+        if (existsSync(actualPath)) {
+          return actualPath;
+        }
+      }
+      return bunPath;
+    }
+  }
+
+  // Common Windows paths
+  if (process.platform === "win32") {
+    const localAppData = process.env.LOCALAPPDATA ?? "";
+    const appData = process.env.APPDATA ?? "";
+    const userProfile = process.env.USERPROFILE ?? "";
+
+    const commonPaths = [
+      join(localAppData, "bun", "bin", "bun.exe"),
+      join(appData, "bun", "bin", "bun.exe"),
+      join(userProfile, "AppData", "Local", "bun", "bin", "bun.exe"),
+      join(userProfile, "AppData", "Roaming", "npm", "node_modules", "bun", "bin", "bun.exe"),
+      join(userProfile, "AppData", "Roaming", "npm", "bun"),
+    ];
+    for (const bunPath of commonPaths) {
+      if (existsSync(bunPath)) {
+        return bunPath;
+      }
+    }
+  }
+
+  return null;
+};
+
 const envPort = process.env["PORT"];
 const portDefault = envPort !== undefined ? Number(envPort) : DEFAULT_PORT;
 
-const argv = cli({
-  name: "llm-inspector",
-  flags: {
-    port: {
-      type: Number,
-      alias: "p",
-      default: portDefault,
-      description: "Port to listen on (env: PORT)",
-    },
-    open: {
-      type: Boolean,
-      default: true,
-      description: "Open the browser on start (use --no-open to disable)",
-    },
-  },
-});
+// Simple argument parsing
+const args = process.argv.slice(2);
+let port = portDefault;
+let open = true;
 
-process.env["PORT"] = String(argv.flags.port);
+for (let i = 0; i < args.length; i++) {
+  const arg = args[i] ?? "";
+  switch (arg) {
+    case "--port":
+    case "-p":
+      port = Number(args[i + 1]);
+      i++;
+      break;
+    case "--no-open":
+      open = false;
+      break;
+    case "--open":
+      open = true;
+      break;
+    default:
+      break;
+  }
+}
+
+process.env["PORT"] = String(port);
 
-const url = `http://localhost:${argv.flags.port}`;
+const url = `http://localhost:${port}`;
 
 console.log(`Server running at ${url}`);
 console.log(`   Proxy: ${url}/proxy`);
@@ -43,26 +100,48 @@ console.log(
 );
 
 const openBrowser = (targetUrl: string): void => {
-  const commandByPlatform: Record<string, string[]> = {
-    darwin: ["open", targetUrl],
-    linux: ["xdg-open", targetUrl],
-    win32: ["cmd", "/c", "start", targetUrl],
-  };
-  const command = commandByPlatform[process.platform];
+  let command: string[] | undefined;
+  // eslint-disable-next-line @typescript-eslint/switch-exhaustiveness-check
+  switch (process.platform) {
+    case "darwin":
+      command = ["open", targetUrl];
+      break;
+    case "linux":
+      command = ["xdg-open", targetUrl];
+      break;
+    case "win32":
+      command = ["cmd", "/c", "start", targetUrl];
+      break;
+    default:
+      // Unsupported platform - do nothing
+      break;
+  }
   if (command === undefined) return;
-  const [bin, ...args] = command;
+  const [bin, ...cmdArgs] = command;
   if (bin === undefined) return;
-  Bun.spawn([bin, ...args], { stdio: ["ignore", "ignore", "ignore"] });
+  spawn(bin, cmdArgs, { stdio: "ignore", detached: true });
 };
 
-if (argv.flags.open) {
+if (open) {
   openBrowser(url);
 }
 
-const { initLogger } = await import("./proxy/logger.js");
-await initLogger();
-const { rebuildIndex } = await import("./proxy/logIndex.js");
-await rebuildIndex();
-const { loadLogsIntoMemory } = await import("./proxy/store.js");
-await loadLogsIntoMemory();
-await import("../.output/server/index.mjs");
+// Find bun and start server
+const bunPath = findBun();
+if (bunPath === null) {
+  console.error("\nError: bun is not installed or not in PATH.");
+  console.error("Please install bun from https://bun.sh");
+  process.exit(1);
+}
+
+// Compute server path
+const outputDir = __dirname;
+const serverPath = join(outputDir, "../.output/server/index.mjs");
+
+// Start server with bun
+const serverProcess = spawn(bunPath, [serverPath], {
+  stdio: ["ignore", "inherit", "inherit"],
+  detached: true,
+});
+
+serverProcess.unref();