@tonyclaw/llm-inspector 1.15.0 → 1.16.0

package/.output/server/{_tanstack-start-manifest_v-C9Wq6YdJ.mjs → _tanstack-start-manifest_v-BYhN7q_z.mjs}

@@ -1,4 +1,4 @@
-const tsrStartManifest = () => ({ "routes": { "__root__": { "filePath": "C:/Users/claw/workspace/llm-inspector/src/routes/__root.tsx", "children": ["/", "/api/config", "/api/health", "/api/logs", "/api/mcp", "/api/models", "/api/providers", "/api/sessions", "/proxy/$"], "preloads": ["/assets/main-BLYgekFx.js"], "assets": [] }, "/": { "filePath": "C:/Users/claw/workspace/llm-inspector/src/routes/index.tsx", "assets": [], "preloads": ["/assets/index-CMuJQyt1.js"] }, "/api/config": { "filePath": "C:/Users/claw/workspace/llm-inspector/src/routes/api/config.ts", "children": ["/api/config/paths"] }, "/api/health": { "filePath": "C:/Users/claw/workspace/llm-inspector/src/routes/api/health.ts" }, "/api/logs": { "filePath": "C:/Users/claw/workspace/llm-inspector/src/routes/api/logs.ts", "children": ["/api/logs/$id", "/api/logs/stream"] }, "/api/mcp": { "filePath": "C:/Users/claw/workspace/llm-inspector/src/routes/api/mcp.ts" }, "/api/models": { "filePath": "C:/Users/claw/workspace/llm-inspector/src/routes/api/models.ts" }, "/api/providers": { "filePath": "C:/Users/claw/workspace/llm-inspector/src/routes/api/providers.ts", "children": ["/api/providers/$providerId", "/api/providers/export", "/api/providers/import", "/api/providers/scan"] }, "/api/sessions": { "filePath": "C:/Users/claw/workspace/llm-inspector/src/routes/api/sessions.ts" }, "/proxy/$": { "filePath": "C:/Users/claw/workspace/llm-inspector/src/routes/proxy/$.ts" }, "/api/config/paths": { "filePath": "C:/Users/claw/workspace/llm-inspector/src/routes/api/config.paths.ts" }, "/api/logs/$id": { "filePath": "C:/Users/claw/workspace/llm-inspector/src/routes/api/logs.$id.ts", "children": ["/api/logs/$id/chunks", "/api/logs/$id/replay"] }, "/api/logs/stream": { "filePath": "C:/Users/claw/workspace/llm-inspector/src/routes/api/logs.stream.ts" }, "/api/providers/$providerId": { "filePath": "C:/Users/claw/workspace/llm-inspector/src/routes/api/providers.$providerId.ts", "children": ["/api/providers/$providerId/test"] }, "/api/providers/export": { "filePath": "C:/Users/claw/workspace/llm-inspector/src/routes/api/providers.export.ts" }, "/api/providers/import": { "filePath": "C:/Users/claw/workspace/llm-inspector/src/routes/api/providers.import.ts" }, "/api/providers/scan": { "filePath": "C:/Users/claw/workspace/llm-inspector/src/routes/api/providers.scan.ts" }, "/api/logs/$id/chunks": { "filePath": "C:/Users/claw/workspace/llm-inspector/src/routes/api/logs.$id.chunks.ts" }, "/api/logs/$id/replay": { "filePath": "C:/Users/claw/workspace/llm-inspector/src/routes/api/logs.$id.replay.ts" }, "/api/providers/$providerId/test": { "filePath": "C:/Users/claw/workspace/llm-inspector/src/routes/api/providers.$providerId.test.ts", "children": ["/api/providers/$providerId/test/log"] }, "/api/providers/$providerId/test/log": { "filePath": "C:/Users/claw/workspace/llm-inspector/src/routes/api/providers.$providerId.test.log.ts" } }, "clientEntry": "/assets/main-BLYgekFx.js" });
+const tsrStartManifest = () => ({ "routes": { "__root__": { "filePath": "C:/Users/claw/workspace/llm-inspector/src/routes/__root.tsx", "children": ["/", "/api/config", "/api/health", "/api/logs", "/api/mcp", "/api/models", "/api/providers", "/api/sessions", "/proxy/$"], "preloads": ["/assets/main-BjnjXVBU.js"], "assets": [] }, "/": { "filePath": "C:/Users/claw/workspace/llm-inspector/src/routes/index.tsx", "assets": [], "preloads": ["/assets/index-BmkN9DxE.js"] }, "/api/config": { "filePath": "C:/Users/claw/workspace/llm-inspector/src/routes/api/config.ts", "children": ["/api/config/paths"] }, "/api/health": { "filePath": "C:/Users/claw/workspace/llm-inspector/src/routes/api/health.ts" }, "/api/logs": { "filePath": "C:/Users/claw/workspace/llm-inspector/src/routes/api/logs.ts", "children": ["/api/logs/$id", "/api/logs/stream"] }, "/api/mcp": { "filePath": "C:/Users/claw/workspace/llm-inspector/src/routes/api/mcp.ts" }, "/api/models": { "filePath": "C:/Users/claw/workspace/llm-inspector/src/routes/api/models.ts" }, "/api/providers": { "filePath": "C:/Users/claw/workspace/llm-inspector/src/routes/api/providers.ts", "children": ["/api/providers/$providerId", "/api/providers/export", "/api/providers/import", "/api/providers/scan"] }, "/api/sessions": { "filePath": "C:/Users/claw/workspace/llm-inspector/src/routes/api/sessions.ts" }, "/proxy/$": { "filePath": "C:/Users/claw/workspace/llm-inspector/src/routes/proxy/$.ts" }, "/api/config/paths": { "filePath": "C:/Users/claw/workspace/llm-inspector/src/routes/api/config.paths.ts" }, "/api/logs/$id": { "filePath": "C:/Users/claw/workspace/llm-inspector/src/routes/api/logs.$id.ts", "children": ["/api/logs/$id/chunks", "/api/logs/$id/replay"] }, "/api/logs/stream": { "filePath": "C:/Users/claw/workspace/llm-inspector/src/routes/api/logs.stream.ts" }, "/api/providers/$providerId": { "filePath": "C:/Users/claw/workspace/llm-inspector/src/routes/api/providers.$providerId.ts", "children": ["/api/providers/$providerId/test"] }, "/api/providers/export": { "filePath": "C:/Users/claw/workspace/llm-inspector/src/routes/api/providers.export.ts" }, "/api/providers/import": { "filePath": "C:/Users/claw/workspace/llm-inspector/src/routes/api/providers.import.ts" }, "/api/providers/scan": { "filePath": "C:/Users/claw/workspace/llm-inspector/src/routes/api/providers.scan.ts" }, "/api/logs/$id/chunks": { "filePath": "C:/Users/claw/workspace/llm-inspector/src/routes/api/logs.$id.chunks.ts" }, "/api/logs/$id/replay": { "filePath": "C:/Users/claw/workspace/llm-inspector/src/routes/api/logs.$id.replay.ts" }, "/api/providers/$providerId/test": { "filePath": "C:/Users/claw/workspace/llm-inspector/src/routes/api/providers.$providerId.test.ts", "children": ["/api/providers/$providerId/test/log"] }, "/api/providers/$providerId/test/log": { "filePath": "C:/Users/claw/workspace/llm-inspector/src/routes/api/providers.$providerId.test.log.ts" } }, "clientEntry": "/assets/main-BjnjXVBU.js" });
 export {
   tsrStartManifest
 };

package/.output/server/index.mjs

@@ -35,54 +35,54 @@ const headers = ((m) => function headersRouteRule(event) {
   }
 });
 const assets = {
-  "/assets/index-DciyfYBk.css": {
-    "type": "text/css; charset=utf-8",
-    "etag": '"15867-TOX1Gddns0p3jKt+7co1NuZS+d8"',
-    "mtime": "2026-06-12T07:17:56.431Z",
-    "size": 88167,
-    "path": "../public/assets/index-DciyfYBk.css"
-  },
   "/assets/alibaba-TTwafVwX.svg": {
     "type": "image/svg+xml",
     "etag": '"171b-6dyV5K8QjiaY35sN9qNprh9zDIs"',
-    "mtime": "2026-06-12T07:17:56.428Z",
+    "mtime": "2026-06-13T05:45:10.081Z",
     "size": 5915,
     "path": "../public/assets/alibaba-TTwafVwX.svg"
   },
-  "/assets/main-BLYgekFx.js": {
+  "/assets/index-DPe3eOih.css": {
+    "type": "text/css; charset=utf-8",
+    "etag": '"15a32-YUlUFJPXe5WrOzMkLVz9gOyERE4"',
+    "mtime": "2026-06-13T05:45:10.081Z",
+    "size": 88626,
+    "path": "../public/assets/index-DPe3eOih.css"
+  },
+  "/assets/qwen-CONDcHqt.png": {
+    "type": "image/png",
+    "etag": '"572c3-cdJAPaHdOvFCGzuaQjagdgOu6XE"',
+    "mtime": "2026-06-13T05:45:10.081Z",
+    "size": 357059,
+    "path": "../public/assets/qwen-CONDcHqt.png"
+  },
+  "/assets/main-BjnjXVBU.js": {
     "type": "text/javascript; charset=utf-8",
-    "etag": '"50599-tks6aTeb/Edw4laR3cdpiWA48mc"',
-    "mtime": "2026-06-12T07:17:56.431Z",
+    "etag": '"50599-TBFFt8m3KX+84o0h5FGqLcw9zvM"',
+    "mtime": "2026-06-13T05:45:10.081Z",
     "size": 329113,
-    "path": "../public/assets/main-BLYgekFx.js"
-  },
-  "/assets/zhipuai-BPNAnxo-.svg": {
-    "type": "image/svg+xml",
-    "etag": '"2bf8-hNaLCTi89nOFCsIIfWpP/jrfo0s"',
-    "mtime": "2026-06-12T07:17:56.431Z",
-    "size": 11256,
-    "path": "../public/assets/zhipuai-BPNAnxo-.svg"
+    "path": "../public/assets/main-BjnjXVBU.js"
   },
   "/assets/minimax-BPMzvuL-.jpeg": {
     "type": "image/jpeg",
     "etag": '"1b06-IwivU89ko5UTMUM1/t7hn4sQK9A"',
-    "mtime": "2026-06-12T07:17:56.431Z",
+    "mtime": "2026-06-13T05:45:10.078Z",
     "size": 6918,
     "path": "../public/assets/minimax-BPMzvuL-.jpeg"
   },
-  "/assets/qwen-CONDcHqt.png": {
-    "type": "image/png",
-    "etag": '"572c3-cdJAPaHdOvFCGzuaQjagdgOu6XE"',
-    "mtime": "2026-06-12T07:17:56.431Z",
-    "size": 357059,
-    "path": "../public/assets/qwen-CONDcHqt.png"
+  "/assets/zhipuai-BPNAnxo-.svg": {
+    "type": "image/svg+xml",
+    "etag": '"2bf8-hNaLCTi89nOFCsIIfWpP/jrfo0s"',
+    "mtime": "2026-06-13T05:45:10.081Z",
+    "size": 11256,
+    "path": "../public/assets/zhipuai-BPNAnxo-.svg"
   },
-  "/assets/index-CMuJQyt1.js": {
+  "/assets/index-BmkN9DxE.js": {
     "type": "text/javascript; charset=utf-8",
-    "etag": '"97f56-eCDTvraNzTc2Un6pdqimYNiZVhw"',
-    "mtime": "2026-06-12T07:17:56.431Z",
-    "size": 622422,
-    "path": "../public/assets/index-CMuJQyt1.js"
+    "etag": '"9ae0c-h7IO5tRUMmZre12bMt7hEiFWLhQ"',
+    "mtime": "2026-06-13T05:45:10.081Z",
+    "size": 634380,
+    "path": "../public/assets/index-BmkN9DxE.js"
   }
 };
 function readAsset(id) {

package/README.md

@@ -1,34 +1,36 @@
 # llm-inspector
 
-> LLM Inspector
+透明捕获、解析和重放 AI 编码工具的 LLM API 流量。
 
-![Proxy Overview](docs/Proxy.png)
+![LLM Inspector](docs/封面v1.15.0.png)
 
-## What is llm-inspector?
+`llm-inspector` 是一个运行在本机的 HTTP 代理和 Web 调试器。将 Claude Code、OpenCode、Cursor、Cody 或其他兼容客户端的 API Base URL 指向它，即可实时查看请求、响应、工具调用、Thinking、SSE chunks 和 Token 用量。
 
-**llm-inspector** 是一个 LLM API 透明代理调试工具，能够捕获 AI 编程工具（Claude Code、OpenCode、Cursor、Cody 等）与 LLM 提供商之间的所有 API 请求和响应，在 Web UI 中实时展示：
+默认地址：
 
-- 系统提示词 (System Prompts)
-- 工具定义 (Tool Definitions)
-- 消息内容 (Messages)
-- SSE 流式数据块 (Streaming Chunks)
-- Token 用量 (Token Usage)
+- Web UI：`http://localhost:25947`
+- 代理入口：`http://localhost:25947/proxy`
+- MCP Server：`http://localhost:25947/api/mcp`
 
-**专为理解 AI 编程工具底层 API 调用行为而设计。帮助开发者看清 LLM API 的"最后一公里"。**
+## 功能
 
-## Key Advantages / 核心优势
+- 同时支持 Anthropic Messages API 和 OpenAI Chat Completions API
+- 分开解析两种协议的请求、响应、Thinking、Answer 和 Tool Call
+- 按请求路径识别协议：
+  - `/proxy/v1/messages` -> Anthropic
+  - `/proxy/v1/chat/completions` -> OpenAI
+- 实时捕获普通响应和 SSE 流式响应
+- 查看原始/处理后的 Headers 和 Request Diff
+- 比较同一会话、同一协议的相邻请求
+- 请求 Replay、日志 ZIP 导出和按会话/模型筛选
+- 会话分组、Turn 边界、缓存 Token 趋势和 Token 汇总
+- 提供商管理、双协议 URL、连接测试、导入与导出
+- 记录客户端 PID、工作目录和项目目录，便于定位请求来源
+- 内置 MCP Server，让 Coding Agent 直接查询日志和管理提供商
 
-| 优势 | 说明 |
-|------|------|
-| **透明代理、零侵入** | 只需设置环境变量即可拦截所有流量，无需修改 AI 编程工具本身 |
-| **结构化 API 可视化** | 交互式 JSON 树查看器，自动解析并渲染 Markdown 文本、思考块、工具调用块 |
-| **完整的 SSE 流式解析** | 捕获并重建每个流式事件，原始事件时间线一目了然 |
-| **Token 用量实时追踪** | 单请求 + 会话级 + 全局级 Token 统计 |
-| **多提供商自动路由** | 支持 Anthropic、OpenAI、DeepSeek、MiniMax、Qwen、ZhipuAI，自动识别格式和认证 |
-| **客户端进程追踪** | 自动关联 PID、工作目录、项目文件夹，区分请求来源 |
-| **持久化存储 + 导出** | 磁盘日志存储 + ZIP 导出，支持离线分析 |
+![Proxy Overview](docs/Proxy.png)
 
-## Quick Start / 快速开始
+## 快速开始
 
 ### npm 安装
 
@@ -37,93 +39,145 @@ npm install -g @tonyclaw/llm-inspector
 llm-inspector
 ```
 
+启动后会自动打开浏览器。也可以使用：
+
+```bash
+llm-inspector --no-open
+llm-inspector --port 3000
+llm-inspector --config-dir ./local-config
+```
+
 ### Docker
 
 ```bash
-cd docker && docker compose up -d
+cd docker
+docker compose up -d
 ```
 
 ### 源码运行
 
+需要安装 [Bun](https://bun.sh/)。
+
 ```bash
 bun install
 bun run dev
 ```
 
-打开浏览器访问 http://localhost:25947 查看实时捕获的请求。
+## 配置提供商
+
+打开 Web UI，进入 **Settings** 添加提供商：
 
-### 配置 AI 编程工具
+1. 填写提供商名称和 API Key。
+2. 添加一个或多个模型名称。代理使用模型名称匹配提供商。
+3. 按实际能力填写协议 URL：
+   - **Anthropic Base URL**：例如 `https://api.anthropic.com`
+   - **OpenAI Base URL**：例如 `https://api.openai.com`
+4. 选择认证方式：`Bearer` 或 `x-api-key`。
+5. 使用 Provider Test 分别验证流式和非流式请求。
 
-配置你的 AI 编程工具，将 API 请求路由到 llm-inspector 代理：
+同一个提供商可以同时配置 Anthropic 和 OpenAI URL。代理会根据客户端请求路径选择协议与上游地址，而不是根据请求 body 猜测格式。
+
+## 接入 AI 编码工具
+
+### Claude Code
+
+macOS / Linux：
 
 ```bash
-# Claude Code
 ANTHROPIC_BASE_URL=http://localhost:25947/proxy claude
+```
 
-# OpenCode
-LLM_BASE_URL=http://localhost:25947/proxy opencode
+Windows PowerShell：
 
-# Cursor, Cody 等
-ANTHROPIC_BASE_URL=http://localhost:25947/proxy <your-tool>
+```powershell
+$env:ANTHROPIC_BASE_URL = "http://localhost:25947/proxy"
+claude
 ```
 
-### 验证代理工作正常
+如果 API Key 已保存在 llm-inspector 的提供商配置中，客户端令牌可以留空：
 
-1. 启动 llm-inspector 后，打开浏览器访问 http://localhost:25947
-2. 配置好环境变量后，向代理发送一个请求
-3. 观察 Web UI 中是否实时显示捕获的请求和响应
+```powershell
+$env:ANTHROPIC_AUTH_TOKEN = ""
+```
 
-![Proxy Hello](docs/Proxy%20Hello.png)
+### OpenCode 和其他客户端
 
----
+不同客户端使用的环境变量名称不同。将其 Anthropic 或 OpenAI Base URL 设置为：
 
-## MCP Server (Coding Agent Integration)
+```text
+http://localhost:25947/proxy
+```
 
-llm-inspector ships with an embedded [Model Context Protocol](https://modelcontextprotocol.io)
-(MCP) server, mounted at `POST http://localhost:25947/api/mcp` on the same port as
-the Web UI. Any MCP-aware Coding Agent running on the same machine can
-discover and invoke 11 `inspector_*` tools to read captured traffic and
-manage provider configuration without a human round-trip.
+例如：
 
-### Tool catalog (11 tools, all prefixed `inspector_`)
+```bash
+LLM_BASE_URL=http://localhost:25947/proxy opencode
+```
+
+对于 Cursor、Cody 等工具，请在其设置中修改 API Base URL。
+
+## 直接发送请求
 
-**Read (6) — cheap discovery of what was just sent**
+请先在 Settings 中配置与 `model` 匹配的提供商。
 
-| Tool | Purpose |
-|------|---------|
-| `inspector_list_logs` | Recent captured logs in reverse-chronological order, with parsed previews of the last user message and the assistant response. Default limit 3, hard-capped at 5. |
-| `inspector_get_log` | Full `CapturedLog` for a single id, including `rawRequestBody` and `responseText` with no truncation. Streaming chunks are NOT included. |
-| `inspector_get_log_chunks` | SSE streaming chunks for a single log, in order received. |
-| `inspector_list_sessions` | All session ids that have been observed in captured logs. |
-| `inspector_list_models` | Distinct model names seen across all logs. |
-| `inspector_list_providers` | All configured providers, including `apiKey` in plaintext. |
+### Anthropic 格式
+
+```bash
+curl http://localhost:25947/proxy/v1/messages \
+  -H "content-type: application/json" \
+  -H "x-api-key: resolved-by-llm-inspector" \
+  -d '{
+    "model": "claude-sonnet-4-6",
+    "max_tokens": 128,
+    "messages": [{"role": "user", "content": "Hello"}]
+  }'
+```
+
+### OpenAI 格式
+
+```bash
+curl http://localhost:25947/proxy/v1/chat/completions \
+  -H "content-type: application/json" \
+  -H "authorization: Bearer resolved-by-llm-inspector" \
+  -d '{
+    "model": "gpt-4o-mini",
+    "max_tokens": 128,
+    "messages": [{"role": "user", "content": "Hello"}]
+  }'
+```
 
-**Action (2)**
+## 使用查看器
 
-| Tool | Purpose |
-|------|---------|
-| `inspector_get_provider` | Full `ProviderConfig` for a single id, `apiKey` in plaintext. |
-| `inspector_replay_log` | Re-send a captured request body to its upstream and return the response summary. |
+### Simple / Full
 
-**Provider write (3) — mutate provider config**
+- **Simple**：聚焦 Request 和解析后的 Response。
+- **Full**：额外显示 Raw Headers、Headers、Raw Request、Raw Response 和 SSE chunks。
 
-| Tool | Purpose |
-|------|---------|
-| `inspector_add_provider` | Persist a new provider to `<dataDir>/providers.json`. |
-| `inspector_update_provider` | Patch-style update of an existing provider. |
-| `inspector_test_provider` | Run the UI's connectivity test against a provider. |
+### Thinking 与 Answer
 
-**Explicitly NOT exposed** (kept UI-only by design):
+查看器按协议分别解析响应：
 
-- `delete_provider` — irreversible.
-- `clear_log_cache` — only clears the in-memory LRU; misleads agents that expect a full wipe.
-- `get_runtime_config` / `set_runtime_config` — runtime policy surface; UI is the source of truth.
+- Anthropic：`content[].type === "thinking"` 与 `content[].type === "text"`
+- OpenAI：`reasoning_content`、`thinking`、`think` 与 `message.content`
 
-### Connecting an MCP client
+Thinking 和最终 Answer 会分区显示。如果响应因 `max_tokens` 提前结束且只返回 Thinking，界面只展示真实存在的 Thinking，不会生成不存在的 Answer。
 
-The server speaks **HTTP Streamable transport** (JSON-RPC over HTTP). The
-simplest way to point a client at it is to register the endpoint URL. For
-example, in Claude Code's `.mcp.json`:
+### Diff 与 Replay
+
+- **Diff with Raw**：比较代理处理前后的 Request 或 Headers。
+- **Diff with Previous**：比较同一会话、同一协议中的相邻请求。
+- **Replay**：使用当前提供商配置重新发送历史请求。
+- **Export**：将捕获日志导出为 ZIP，供离线分析。
+
+## MCP Server
+
+内置 MCP Server 使用 HTTP Streamable transport：
+
+```text
+POST http://localhost:25947/api/mcp
+```
+
+Claude Code `.mcp.json` 示例：
 
 ```json
 {
@@ -136,49 +190,82 @@ example, in Claude Code's `.mcp.json`:
 }
 ```
 
-For raw clients that send JSON-RPC directly:
+提供 11 个 `inspector_*` 工具：
+
+| 类型 | 工具 |
+| --- | --- |
+| 日志查询 | `inspector_list_logs`, `inspector_get_log`, `inspector_get_log_chunks` |
+| 索引查询 | `inspector_list_sessions`, `inspector_list_models` |
+| 提供商查询 | `inspector_list_providers`, `inspector_get_provider` |
+| 操作 | `inspector_replay_log`, `inspector_test_provider` |
+| 提供商写入 | `inspector_add_provider`, `inspector_update_provider` |
+
+完整说明见 [MCP Server 文档](docs/MCP-Server.md)。
+
+> MCP 接口仅应在可信本机环境使用。提供商查询工具会返回明文 API Key，请勿将服务暴露到不可信网络。
+
+## 数据目录与环境变量
+
+默认数据目录：
+
+- Windows：`%USERPROFILE%\.llm-inspector`
+- macOS / Linux：`$HOME/.llm-inspector`
+
+常用环境变量：
+
+| 变量 | 默认值 | 说明 |
+| --- | --- | --- |
+| `PORT` | `25947` | Web UI 和代理端口 |
+| `LLM_INSPECTOR_DATA_DIR` | 系统默认目录 | providers、runtime config 等数据目录 |
+| `LOG_DIR` | `<dataDir>/logs` | 捕获日志和运行日志目录 |
+| `LOG_RETENTION_DAYS` | `7` | 日志保留天数 |
+| `CHUNKS_DIR` | `<dataDir>/chunks` | SSE chunks 存储目录 |
+
+提供商 API Key 以明文 JSON 保存在本机数据目录中。请保护该目录，并避免在共享或不可信主机上运行服务。
+
+## HTTP API
+
+| Endpoint | Method | 说明 |
+| --- | --- | --- |
+| `/api/health` | GET | 健康检查 |
+| `/api/logs` | GET / DELETE | 查询或清空日志 |
+| `/api/logs/:id` | GET | 获取完整日志 |
+| `/api/logs/:id/chunks` | GET | 获取 SSE chunks |
+| `/api/logs/:id/replay` | POST | 重放请求 |
+| `/api/logs/stream` | GET | 实时日志更新 |
+| `/api/sessions` | GET | 会话列表 |
+| `/api/models` | GET | 模型列表 |
+| `/api/providers` | GET / POST | 查询或添加提供商 |
+| `/api/providers/:id` | GET / PUT / DELETE | 管理单个提供商 |
+| `/api/providers/:id/test` | POST | 测试提供商连接 |
+| `/api/mcp` | POST | MCP HTTP Streamable endpoint |
+
+## 开发与验证
+
+```bash
+bun test
+npm run typecheck
+npm run lint
+npm run format:check
+npm run build
+```
+
+涉及代理或 UI 的改动还应启动开发服务器，并使用真实 AI 编码工具通过代理完成端到端验证：
 
 ```bash
-curl -X POST http://localhost:25947/api/mcp \
-  -H 'content-type: application/json' \
-  -H 'accept: application/json, text/event-stream' \
-  -d '{
-    "jsonrpc": "2.0",
-    "id": 1,
-    "method": "initialize",
-    "params": {
-      "protocolVersion": "2025-06-18",
-      "capabilities": {},
-      "clientInfo": { "name": "my-client", "version": "0.0.0" }
-    }
-  }'
+bun run dev
+ANTHROPIC_BASE_URL=http://localhost:25947/proxy claude
 ```
 
-### Posture and limitations
-
-- **Localhost only, no auth.** The MCP endpoint inherits inspector's
-  existing localhost binding. Any process that can call `/api/mcp` can also
-  read `<dataDir>/providers.json` directly. Do not run inspector on a
-  host where untrusted local users can reach it.
-- **Provider API keys are returned in plaintext** by `inspector_list_providers`
-  and `inspector_get_provider`. This is intentional — redacting in MCP but
-  not in the underlying JSON file would be performative security.
-- **Reflexive loop:** `inspector_list_logs` may include the agent's own
-  recent `/proxy` calls. Filter by `clientPid` (your own PID) or by
-  timestamp on the client side. The tool description surfaces this warning.
-- **List limits are hardcoded** at default 3, max 5. Not user-configurable.
-- **Deferred to v1.1** (not in this change): MCP Resources for logs
-  (`mcp://llm-inspector/log/{id}`), notifications/subscriptions for live
-  log push, filtering out reflexive-loop entries server-side, full-text
-  or time-range search, MCP-level auth.
-
----
-
-## Documentation / 文档目录
-
-- [特性 (Features)](docs/Features.md) - 核心功能介绍
-- [安装 (Installation)](docs/Installation.md) - 安装指南
-- [使用 (Usage)](docs/Usage.md) - 详细使用说明
-- [架构 (Architecture)](docs/Architecture.md) - 系统架构
-- [开发 (Development)](docs/Development.md) - 开发指南
-- [MCP Server](docs/MCP-Server.md) - 把 llm-inspector 当作 MCP 工具接入 Coding Agent
+## 更多文档
+
+- [功能介绍](docs/Features.md)
+- [安装指南](docs/Installation.md)
+- [使用说明](docs/Usage.md)
+- [架构说明](docs/Architecture.md)
+- [开发指南](docs/Development.md)
+- [MCP Server](docs/MCP-Server.md)
+
+## License
+
+MIT

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tonyclaw/llm-inspector",
-  "version": "1.15.0",
+  "version": "1.16.0",
   "type": "module",
   "description": "LLM API proxy inspector — captures and displays requests/responses from AI coding tools in a web UI",
   "license": "MIT",

package/src/cli.ts

@@ -126,6 +126,7 @@ 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(`   MiMo Code:    OPENAI_BASE_URL=${url}/proxy mimo`);
 console.log(`   Direct HTTP:  curl ${url}/proxy/v1/messages -d '{"model":"...","messages":[...]}'`);
 console.log(``);
 console.log(`Routing environment variables:`);