@tonyclaw/llm-inspector 1.18.0 → 1.18.2

package/.output/server/_ssr/{router-711KpGkz.mjs → router-DVixpJO-.mjs}

@@ -47,8 +47,8 @@ import "../_libs/debounce-fn.mjs";
 import "../_libs/mimic-function.mjs";
 import "../_libs/semver.mjs";
 import "../_libs/uint8array-extras.mjs";
-const appCss = "/assets/index-DoGvsnbA.css";
-const Route$k = createRootRoute({
+const appCss = "/assets/index-BRvz6-L6.css";
+const Route$l = createRootRoute({
   head: () => ({
     meta: [
       { charSet: "utf-8" },
@@ -71,9 +71,58 @@ function RootDocument({ children }) {
     ] })
   ] });
 }
-const $$splitComponentImporter = () => import("./index-C7I_Qgt0.mjs").then((n) => n.t);
-const Route$j = createFileRoute("/")({
-  component: lazyRouteComponent($$splitComponentImporter, "component")
+const $$splitComponentImporter$1 = () => import("./index-BHG6vOnr.mjs");
+const Route$k = createFileRoute("/")({
+  component: lazyRouteComponent($$splitComponentImporter$1, "component")
+});
+const B64URL_RE = /^[A-Za-z0-9_-]+$/;
+function bytesToBinary(bytes) {
+  let binary = "";
+  for (const byte of bytes) {
+    binary += String.fromCharCode(byte);
+  }
+  return binary;
+}
+function binaryToBytes(binary) {
+  const bytes = new Uint8Array(binary.length);
+  for (let i = 0; i < binary.length; i++) {
+    bytes[i] = binary.charCodeAt(i);
+  }
+  return bytes;
+}
+function encodeSessionIdForPath(sessionId) {
+  const bytes = new TextEncoder().encode(sessionId);
+  const base64 = btoa(bytesToBinary(bytes));
+  return base64.replace(/\+/g, "-").replace(/\//g, "_").replace(/=+$/, "");
+}
+function decodeSessionIdFromPath(encoded) {
+  if (encoded.startsWith("%")) {
+    return decodeURIComponent(encoded);
+  }
+  if (!B64URL_RE.test(encoded)) {
+    return encoded;
+  }
+  try {
+    const padded = encoded.padEnd(Math.ceil(encoded.length / 4) * 4, "=");
+    const base64 = padded.replace(/-/g, "+").replace(/_/g, "/");
+    const binary = atob(base64);
+    return new TextDecoder().decode(binaryToBytes(binary));
+  } catch {
+    return encoded;
+  }
+}
+function getSessionPath(sessionId) {
+  return `/session/${encodeSessionIdForPath(sessionId)}`;
+}
+const $$splitComponentImporter = () => import("../_sessionId-DhKJIdQC.mjs");
+const Route$j = createFileRoute("/session/$sessionId")({
+  component: lazyRouteComponent($$splitComponentImporter, "component"),
+  parseParams: (params) => ({
+    sessionId: decodeSessionIdFromPath(params.sessionId)
+  }),
+  stringifyParams: (params) => ({
+    sessionId: encodeSessionIdForPath(params.sessionId)
+  })
 });
 const LOG_DIR_ENV = process.env["LOG_DIR"];
 const RETENTION_DAYS = Number(process.env["LOG_RETENTION_DAYS"] ?? "7");
@@ -5412,50 +5461,55 @@ const Route = createFileRoute("/api/providers/$providerId/test/log")({
     }
   }
 });
-const IndexRoute = Route$j.update({
+const IndexRoute = Route$k.update({
   id: "/",
   path: "/",
-  getParentRoute: () => Route$k
+  getParentRoute: () => Route$l
+});
+const SessionSessionIdRoute = Route$j.update({
+  id: "/session/$sessionId",
+  path: "/session/$sessionId",
+  getParentRoute: () => Route$l
 });
 const ProxySplatRoute = Route$i.update({
   id: "/proxy/$",
   path: "/proxy/$",
-  getParentRoute: () => Route$k
+  getParentRoute: () => Route$l
 });
 const ApiSessionsRoute = Route$h.update({
   id: "/api/sessions",
   path: "/api/sessions",
-  getParentRoute: () => Route$k
+  getParentRoute: () => Route$l
 });
 const ApiProvidersRoute = Route$g.update({
   id: "/api/providers",
   path: "/api/providers",
-  getParentRoute: () => Route$k
+  getParentRoute: () => Route$l
 });
 const ApiModelsRoute = Route$f.update({
   id: "/api/models",
   path: "/api/models",
-  getParentRoute: () => Route$k
+  getParentRoute: () => Route$l
 });
 const ApiMcpRoute = Route$e.update({
   id: "/api/mcp",
   path: "/api/mcp",
-  getParentRoute: () => Route$k
+  getParentRoute: () => Route$l
 });
 const ApiLogsRoute = Route$d.update({
   id: "/api/logs",
   path: "/api/logs",
-  getParentRoute: () => Route$k
+  getParentRoute: () => Route$l
 });
 const ApiHealthRoute = Route$c.update({
   id: "/api/health",
   path: "/api/health",
-  getParentRoute: () => Route$k
+  getParentRoute: () => Route$l
 });
 const ApiConfigRoute = Route$b.update({
   id: "/api/config",
   path: "/api/config",
-  getParentRoute: () => Route$k
+  getParentRoute: () => Route$l
 });
 const ApiProvidersScanRoute = Route$a.update({
   id: "/scan",
@@ -5560,9 +5614,10 @@ const rootRouteChildren = {
   ApiModelsRoute,
   ApiProvidersRoute: ApiProvidersRouteWithChildren,
   ApiSessionsRoute,
-  ProxySplatRoute
+  ProxySplatRoute,
+  SessionSessionIdRoute
 };
-const routeTree = Route$k._addFileChildren(rootRouteChildren)._addFileTypes();
+const routeTree = Route$l._addFileChildren(rootRouteChildren)._addFileTypes();
 function getRouter() {
   const router2 = createRouter({
     routeTree,
@@ -5581,12 +5636,14 @@ export {
   MAX_SLOW_RESPONSE_THRESHOLD_SECONDS as M,
   OpenAIRequestSchema as O,
   ProviderTestResultsSchema as P,
-  RuntimeConfigSchema as R,
-  AnthropicRequestSchema as a,
-  createFailedProviderTestResults as b,
+  Route$j as R,
+  RuntimeConfigSchema as a,
+  AnthropicRequestSchema as b,
   createPendingProviderTestResults as c,
-  ProviderConfigSchema as d,
-  router as e,
+  createFailedProviderTestResults as d,
+  ProviderConfigSchema as e,
+  router as f,
+  getSessionPath as g,
   parseOpenAIResponse as p,
   requestFormatForPath as r,
   stripClaudeCodeBillingHeader as s

package/.output/server/_tanstack-start-manifest_v-BbvWUF4v.mjs

@@ -0,0 +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/$", "/session/$sessionId"], "preloads": ["/assets/main-Be2qqUUW.js"], "assets": [] }, "/": { "filePath": "C:/Users/claw/workspace/llm-inspector/src/routes/index.tsx", "assets": [], "preloads": ["/assets/index-Btw8ec7-.js", "/assets/ProxyViewerContainer-WRenRpeh.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" }, "/session/$sessionId": { "filePath": "C:/Users/claw/workspace/llm-inspector/src/routes/session/$sessionId.tsx", "assets": [], "preloads": ["/assets/_sessionId-BO47oA3Z.js", "/assets/ProxyViewerContainer-WRenRpeh.js"] }, "/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-Be2qqUUW.js" });
+export {
+  tsrStartManifest
+};

package/.output/server/index.mjs

@@ -38,93 +38,107 @@ const assets = {
   "/assets/alibaba-TTwafVwX.svg": {
     "type": "image/svg+xml",
     "etag": '"171b-6dyV5K8QjiaY35sN9qNprh9zDIs"',
-    "mtime": "2026-06-17T03:16:09.841Z",
+    "mtime": "2026-06-17T09:08:04.357Z",
     "size": 5915,
     "path": "../public/assets/alibaba-TTwafVwX.svg"
   },
-  "/assets/index-DoGvsnbA.css": {
+  "/assets/index-Btw8ec7-.js": {
+    "type": "text/javascript; charset=utf-8",
+    "etag": '"74-Si+LSldyx0r6eyhCKLBrfEnEPe8"',
+    "mtime": "2026-06-17T09:08:04.357Z",
+    "size": 116,
+    "path": "../public/assets/index-Btw8ec7-.js"
+  },
+  "/assets/index-BRvz6-L6.css": {
     "type": "text/css; charset=utf-8",
-    "etag": '"16d26-qw65JIM4oxztXa/jhWYD9PPuvfA"',
-    "mtime": "2026-06-17T03:16:09.841Z",
-    "size": 93478,
-    "path": "../public/assets/index-DoGvsnbA.css"
+    "etag": '"17492-JL6LQ7LktE+Z13FtWdf220LM1h4"',
+    "mtime": "2026-06-17T09:08:04.357Z",
+    "size": 95378,
+    "path": "../public/assets/index-BRvz6-L6.css"
   },
-  "/assets/json-viewer-D-z1r1Pp.js": {
+  "/assets/CompareDrawer-C-4ypEWs.js": {
     "type": "text/javascript; charset=utf-8",
-    "etag": '"1e60c-b+Su3KxY/1YyCIOXy/kCh7EVJWA"',
-    "mtime": "2026-06-17T03:16:09.843Z",
-    "size": 124428,
-    "path": "../public/assets/json-viewer-D-z1r1Pp.js"
+    "etag": '"4a1f-MtCtIuSEWViO+k9O7NiG+WdWW/s"',
+    "mtime": "2026-06-17T09:08:04.357Z",
+    "size": 18975,
+    "path": "../public/assets/CompareDrawer-C-4ypEWs.js"
   },
-  "/assets/CompareDrawer-BpwZCB6M.js": {
-    "type": "text/javascript; charset=utf-8",
-    "etag": '"4a10-Mv9zkKfYXObP08//mt6T/CvprxM"',
-    "mtime": "2026-06-17T03:16:09.843Z",
-    "size": 18960,
-    "path": "../public/assets/CompareDrawer-BpwZCB6M.js"
+  "/assets/minimax-BPMzvuL-.jpeg": {
+    "type": "image/jpeg",
+    "etag": '"1b06-IwivU89ko5UTMUM1/t7hn4sQK9A"',
+    "mtime": "2026-06-17T09:08:04.357Z",
+    "size": 6918,
+    "path": "../public/assets/minimax-BPMzvuL-.jpeg"
   },
-  "/assets/ResponseView-CJqxo-EN.js": {
+  "/assets/json-viewer-BicGakI5.js": {
     "type": "text/javascript; charset=utf-8",
-    "etag": '"6e82-6eo0MjJytLP7tyoCDUCMVX+Imqs"',
-    "mtime": "2026-06-17T03:16:09.843Z",
-    "size": 28290,
-    "path": "../public/assets/ResponseView-CJqxo-EN.js"
+    "etag": '"1e61b-F0iLQvxKPSiAcJXtFh3kbxWdyCs"',
+    "mtime": "2026-06-17T09:08:04.359Z",
+    "size": 124443,
+    "path": "../public/assets/json-viewer-BicGakI5.js"
   },
-  "/assets/RequestAnatomy-EtiX0r_G.js": {
+  "/assets/ReplayDialog-CyBKOgba.js": {
     "type": "text/javascript; charset=utf-8",
-    "etag": '"141b-XyuVMPaOmzNpTd/Yosdaset1y/Q"',
-    "mtime": "2026-06-17T03:16:09.843Z",
-    "size": 5147,
-    "path": "../public/assets/RequestAnatomy-EtiX0r_G.js"
+    "etag": '"11c0-aqeGa8euE3ZZm68Zocdr8a5lyog"',
+    "mtime": "2026-06-17T09:08:04.357Z",
+    "size": 4544,
+    "path": "../public/assets/ReplayDialog-CyBKOgba.js"
   },
-  "/assets/ReplayDialog-Clratkzl.js": {
+  "/assets/ResponseView-MogToC4i.js": {
     "type": "text/javascript; charset=utf-8",
-    "etag": '"11b1-d+cNxLktG4hY5CiGmJvG2zg1hgE"',
-    "mtime": "2026-06-17T03:16:09.843Z",
-    "size": 4529,
-    "path": "../public/assets/ReplayDialog-Clratkzl.js"
+    "etag": '"6e91-aH2PTafY1YSqsEz1haJsISbe08w"',
+    "mtime": "2026-06-17T09:08:04.359Z",
+    "size": 28305,
+    "path": "../public/assets/ResponseView-MogToC4i.js"
   },
-  "/assets/StreamingChunkSequence-BIbRqQiV.js": {
+  "/assets/RequestAnatomy-C0IrVQ3q.js": {
     "type": "text/javascript; charset=utf-8",
-    "etag": '"d72-t3qm896NP0azRIGukgZdUpqJo4U"',
-    "mtime": "2026-06-17T03:16:09.843Z",
-    "size": 3442,
-    "path": "../public/assets/StreamingChunkSequence-BIbRqQiV.js"
-  },
-  "/assets/minimax-BPMzvuL-.jpeg": {
-    "type": "image/jpeg",
-    "etag": '"1b06-IwivU89ko5UTMUM1/t7hn4sQK9A"',
-    "mtime": "2026-06-17T03:16:09.841Z",
-    "size": 6918,
-    "path": "../public/assets/minimax-BPMzvuL-.jpeg"
+    "etag": '"142a-4J4inWZKnQA9eVxJUqhgY7bNixY"',
+    "mtime": "2026-06-17T09:08:04.357Z",
+    "size": 5162,
+    "path": "../public/assets/RequestAnatomy-C0IrVQ3q.js"
   },
-  "/assets/index-B-0F9n1w.js": {
+  "/assets/StreamingChunkSequence-ClhUhT-s.js": {
     "type": "text/javascript; charset=utf-8",
-    "etag": '"743e9-3qHa5OB4CA7Rxh5qKe3GN7HIf8w"',
-    "mtime": "2026-06-17T03:16:09.843Z",
-    "size": 476137,
-    "path": "../public/assets/index-B-0F9n1w.js"
+    "etag": '"d81-H1su5BwFCKxXCFEbJtAP8Dh2syA"',
+    "mtime": "2026-06-17T09:08:04.359Z",
+    "size": 3457,
+    "path": "../public/assets/StreamingChunkSequence-ClhUhT-s.js"
   },
   "/assets/zhipuai-BPNAnxo-.svg": {
     "type": "image/svg+xml",
     "etag": '"2bf8-hNaLCTi89nOFCsIIfWpP/jrfo0s"',
-    "mtime": "2026-06-17T03:16:09.841Z",
+    "mtime": "2026-06-17T09:08:04.357Z",
     "size": 11256,
     "path": "../public/assets/zhipuai-BPNAnxo-.svg"
   },
+  "/assets/_sessionId-BO47oA3Z.js": {
+    "type": "text/javascript; charset=utf-8",
+    "etag": '"d2-LQ4ORv9iRuNjtfE30EnrZcfuGdI"',
+    "mtime": "2026-06-17T09:08:04.357Z",
+    "size": 210,
+    "path": "../public/assets/_sessionId-BO47oA3Z.js"
+  },
+  "/assets/main-Be2qqUUW.js": {
+    "type": "text/javascript; charset=utf-8",
+    "etag": '"50a37-B3xzwOmQqzg0FvrYhReSzxCAqgg"',
+    "mtime": "2026-06-17T09:08:04.357Z",
+    "size": 330295,
+    "path": "../public/assets/main-Be2qqUUW.js"
+  },
   "/assets/qwen-CONDcHqt.png": {
     "type": "image/png",
     "etag": '"572c3-cdJAPaHdOvFCGzuaQjagdgOu6XE"',
-    "mtime": "2026-06-17T03:16:09.843Z",
+    "mtime": "2026-06-17T09:08:04.357Z",
     "size": 357059,
     "path": "../public/assets/qwen-CONDcHqt.png"
   },
-  "/assets/main-CZJ63sQh.js": {
+  "/assets/ProxyViewerContainer-WRenRpeh.js": {
     "type": "text/javascript; charset=utf-8",
-    "etag": '"505ae-5KYVtgQMJj49Xmb8K+9UosNpz6U"',
-    "mtime": "2026-06-17T03:16:09.843Z",
-    "size": 329134,
-    "path": "../public/assets/main-CZJ63sQh.js"
+    "etag": '"769e0-3XxRCK3xMutpa2X2uOf3cazcy88"',
+    "mtime": "2026-06-17T09:08:04.357Z",
+    "size": 485856,
+    "path": "../public/assets/ProxyViewerContainer-WRenRpeh.js"
   }
 };
 function readAsset(id) {

package/README.md

@@ -1,32 +1,41 @@
 # llm-inspector
 
-透明捕获、解析和重放 AI 编码工具的 LLM API 流量。
+透明捕获、解析、重放和治理 AI 编码工具的 LLM API 流量。
 
 ![LLM Inspector](docs/封面v1.15.0.png)
 
-`llm-inspector` 是一个运行在本机的 HTTP 代理和 Web 调试器。将 Claude Code、OpenCode、Cursor、Cody 或其他兼容客户端的 API Base URL 指向它，即可实时查看请求、响应、工具调用、Thinking、SSE chunks 和 Token 用量。
+`llm-inspector` 是一个运行在本机的 LLM API 代理调试台，同时提供 **Web UI + Proxy + MCP Server**。把 Claude Code、OpenCode、Cursor、Cody、MiMo Code 或其他兼容客户端的 API Base URL 指向它，就可以在 Web UI 中实时观察请求、响应、SSE 流式事件、工具调用、Thinking/Reasoning、Token 用量、缓存 Token、请求来源和提供商路由结果；也可以让 Coding Agent 通过 MCP 主动读取日志、复盘会话和重放请求。
 
-默认地址：
+它的定位不是一个单纯的抓包工具，而是面向 AI 编码场景的“可观察代理层”：
 
-- Web UI：`http://localhost:25947`
-- 代理入口：`http://localhost:25947/proxy`
-- MCP Server：`http://localhost:25947/api/mcp`
+- 调试 Agent：看清系统提示词、工具定义、消息、响应、错误和慢请求。
+- 治理 Provider：按模型路由到不同 LLM 提供商，集中管理 API Key、模型、协议 URL 和连接测试。
+- 复现问题：重放历史请求，对比代理处理前后的请求差异，排查客户端、代理和上游之间的问题。
+- 辅助 Agent 自诊断：内置 MCP Server，让 Coding Agent 可以直接查询最近日志、会话、模型、Provider 和重放结果。
 
-## 功能
+默认入口：
 
-- 同时支持 Anthropic Messages API 和 OpenAI Chat Completions API
-- 分开解析两种协议的请求、响应、Thinking、Answer 和 Tool Call
-- 按请求路径识别协议：
+- **Web UI**：`http://localhost:25947`
+- **Proxy**：`http://localhost:25947/proxy`
+- **MCP Server**：`http://localhost:25947/api/mcp`
+
+## 核心能力
+
+- **双协议代理**：支持 Anthropic Messages API 与 OpenAI Chat Completions API。
+- **路径识别协议**：根据 endpoint 选择协议，而不是猜测 body。
   - `/proxy/v1/messages` -> Anthropic
   - `/proxy/v1/chat/completions` -> OpenAI
-- 实时捕获普通响应和 SSE 流式响应
-- 查看原始/处理后的 Headers 和 Request Diff
-- 比较同一会话、同一协议的相邻请求
-- 请求 Replay、日志 ZIP 导出和按会话/模型筛选
-- 会话分组、Turn 边界、缓存 Token 趋势和 Token 汇总
-- 提供商管理、双协议 URL、连接测试、导入与导出
-- 记录客户端 PID、工作目录和项目目录，便于定位请求来源
-- 内置 MCP Server，让 Coding Agent 直接查询日志和管理提供商
+  - `/proxy/chat/completions` -> OpenAI 兼容路径
+- **多模型 Provider 路由**：一个 Provider 可以配置多个模型，同时保存 Anthropic/OpenAI 两套 Base URL。
+- **AI 编码工具适配**：覆盖 Claude Code、OpenCode、Cursor、Cody、MiMo Code 等可配置 Base URL 的工具。
+- **实时日志与 SSE 捕获**：普通响应和流式响应都会被记录，SSE chunks 支持按需加载。
+- **结构化查看器**：按协议解析 Request、Response、Thinking/Reasoning、Answer、Tool Call、Token 和 Cache Token。
+- **会话与 Turn 视图**：按 session 分组，展示多轮对话边界、模型、协议、状态、耗时和 Token 汇总。
+- **请求 Diff 与 Replay**：比较 Raw/Processed Request，也可以比较同会话相邻请求，并用当前 Provider 配置重放。
+- **Provider 迁移与导入**：支持导入/导出 Provider，并可扫描外部工具配置辅助迁移。
+- **运行时代理开关**：通过 Settings 或 `/api/config` 调整代理行为，无需重启。
+- **MCP 原生调试入口**：提供 `inspector_*` 工具，让 Agent 直接读取日志、重放请求、测试 Provider 和管理 Provider。
+- **本地数据持久化**：Provider、运行时配置、日志与 SSE chunks 存在本机数据目录，适合离线排查。
 
 ![Proxy Overview](docs/Proxy.png)
 
@@ -39,12 +48,13 @@ npm install -g @tonyclaw/llm-inspector
 llm-inspector
 ```
 
-启动后会自动打开浏览器。也可以使用：
+启动后会自动打开浏览器。常用参数：
 
 ```bash
 llm-inspector --no-open
 llm-inspector --port 3000
 llm-inspector --config-dir ./local-config
+llm-inspector --providers '[{"name":"OpenAI","apiKey":"sk-...","models":["gpt-4o-mini"],"openaiBaseUrl":"https://api.openai.com/v1","authHeader":"bearer","createdAt":"2026-01-01T00:00:00.000Z","updatedAt":"2026-01-01T00:00:00.000Z","id":"demo"}]'
 ```
 
 ### Docker
@@ -63,19 +73,26 @@ bun install
 bun run dev
 ```
 
-## 配置提供商
+## 配置 Provider
 
-打开 Web UI，进入 **Settings** 添加提供商：
+打开 Web UI，进入 **Settings** 添加 Provider：
 
-1. 填写提供商名称和 API Key。
-2. 添加一个或多个模型名称。代理使用模型名称匹配提供商。
-3. 按实际能力填写协议 URL：
+1. 填写 Provider 名称和 API Key。
+2. 添加一个或多个模型名称。代理优先用请求体中的 `model` 匹配 Provider。
+3. 按 Provider 能力填写协议 URL：
    - **Anthropic Base URL**：例如 `https://api.anthropic.com`
-   - **OpenAI Base URL**：例如 `https://api.openai.com`
+   - **OpenAI Base URL**：例如 `https://api.openai.com/v1`
 4. 选择认证方式：`Bearer` 或 `x-api-key`。
-5. 使用 Provider Test 分别验证流式和非流式请求。
+5. 使用 Provider Test 验证非流式和流式请求。
+
+同一个 Provider 可以同时配置 Anthropic 和 OpenAI URL。代理会根据客户端请求路径选择协议和上游地址；模型匹配用于决定走哪个 Provider。
 
-同一个提供商可以同时配置 Anthropic 和 OpenAI URL。代理会根据客户端请求路径选择协议与上游地址，而不是根据请求 body 猜测格式。
+Provider 配置支持：
+
+- 多模型合并：同一 API Key 和 URL 组合会合并模型列表。
+- 导入/导出：可备份和迁移配置，导出时可选择是否包含 API Key。
+- 外部扫描：从支持的外部工具配置中扫描可迁移的 Provider。
+- 来源标记：区分个人或公司 Provider，便于列表管理。
 
 ## 接入 AI 编码工具
 
@@ -94,31 +111,33 @@ $env:ANTHROPIC_BASE_URL = "http://localhost:25947/proxy"
 claude
 ```
 
-如果 API Key 已保存在 llm-inspector 的提供商配置中，客户端令牌可以留空：
+如果 API Key 已保存在 llm-inspector 的 Provider 配置中，客户端令牌可以留空：
 
 ```powershell
 $env:ANTHROPIC_AUTH_TOKEN = ""
 ```
 
-### OpenCode 和其他客户端
-
-不同客户端使用的环境变量名称不同。将其 Anthropic 或 OpenAI Base URL 设置为：
+### OpenCode
 
-```text
-http://localhost:25947/proxy
+```bash
+LLM_BASE_URL=http://localhost:25947/proxy opencode
 ```
 
-例如：
+### MiMo Code / OpenAI 兼容客户端
 
 ```bash
-LLM_BASE_URL=http://localhost:25947/proxy opencode
+OPENAI_BASE_URL=http://localhost:25947/proxy mimo
 ```
 
-对于 Cursor、Cody 等工具，请在其设置中修改 API Base URL。
+对于 Cursor、Cody 等工具，请在其设置中将 Anthropic 或 OpenAI Base URL 改为：
+
+```text
+http://localhost:25947/proxy
+```
 
 ## 直接发送请求
 
-请先在 Settings 中配置与 `model` 匹配的提供商。
+请先在 Settings 中配置与 `model` 匹配的 Provider。
 
 ### Anthropic 格式
 
@@ -150,27 +169,48 @@ curl http://localhost:25947/proxy/v1/chat/completions \
 
 ### Simple / Full
 
-- **Simple**：聚焦 Request 和解析后的 Response。
+- **Simple**：聚焦请求、解析后的响应、工具调用、Thinking/Reasoning 和 Token。
 - **Full**：额外显示 Raw Headers、Headers、Raw Request、Raw Response 和 SSE chunks。
 
-### Thinking 与 Answer
+### Thinking / Reasoning / Answer
 
 查看器按协议分别解析响应：
 
-- Anthropic：`content[].type === "thinking"` 与 `content[].type === "text"`
-- OpenAI：`reasoning_content`、`thinking`、`think` 与 `message.content`
+- Anthropic：解析 `content[].type === "thinking"`、`text`、`tool_use` 等内容块。
+- OpenAI：解析 `reasoning_content`、`thinking`、`think`、`message.content` 和函数/工具调用。
+
+如果响应因为 `max_tokens` 提前结束且只返回 Thinking，界面只展示真实存在的内容，不会生成不存在的 Answer。
+
+### 会话、Turn 与来源
 
-Thinking 和最终 Answer 会分区显示。如果响应因 `max_tokens` 提前结束且只返回 Thinking，界面只展示真实存在的 Thinking，不会生成不存在的 Answer。
+日志会记录：
 
-### Diff 与 Replay
+- `sessionId`、模型、Provider、API format、状态码和耗时。
+- 输入/输出 Token、cache creation/read Token。
+- 客户端端口、PID、工作目录和项目目录。
+- 流式响应的 SSE chunk 索引、类型和数据。
+
+这些信息用于定位“哪一个工具、哪个项目、哪一轮对话、哪个 Provider”产生了问题。
+
+### Diff、Replay 与 Export
 
 - **Diff with Raw**：比较代理处理前后的 Request 或 Headers。
 - **Diff with Previous**：比较同一会话、同一协议中的相邻请求。
-- **Replay**：使用当前提供商配置重新发送历史请求。
-- **Export**：将捕获日志导出为 ZIP，供离线分析。
+- **Replay**：使用当前 Provider 配置重新发送历史请求。
+- **Export**：将捕获日志导出为 ZIP，供离线分析或问题复盘。
 
 ## MCP Server
 
+MCP 是 llm-inspector 的一等能力。它让 Agent 不只是在 UI 外部“被观察”，还可以主动查询自己刚刚产生的请求链路，完成自诊断和复盘。
+
+典型场景：
+
+- **最近请求自查**：Agent 可以读取最近几条日志，确认模型、Provider、状态码、Token、SSE chunks 和错误信息。
+- **会话复盘**：按 `sessionId` 找到一次编码任务的请求序列，定位是哪一轮、哪个工具调用或哪个上游响应异常。
+- **Provider 调试**：列出 Provider、查看配置、触发连接测试，并把测试结果写回日志视图。
+- **请求重放**：对历史请求执行 replay，验证问题是否来自客户端、代理配置或上游 Provider。
+- **上下文压缩排查**：读取 last user message preview、response preview、cache token 等摘要，辅助判断 Agent 行为变化。
+
 内置 MCP Server 使用 HTTP Streamable transport：
 
 ```text
@@ -196,13 +236,13 @@ Claude Code `.mcp.json` 示例：
 | --- | --- |
 | 日志查询 | `inspector_list_logs`, `inspector_get_log`, `inspector_get_log_chunks` |
 | 索引查询 | `inspector_list_sessions`, `inspector_list_models` |
-| 提供商查询 | `inspector_list_providers`, `inspector_get_provider` |
+| Provider 查询 | `inspector_list_providers`, `inspector_get_provider` |
 | 操作 | `inspector_replay_log`, `inspector_test_provider` |
-| 提供商写入 | `inspector_add_provider`, `inspector_update_provider` |
+| Provider 写入 | `inspector_add_provider`, `inspector_update_provider` |
 
 完整说明见 [MCP Server 文档](docs/MCP-Server.md)。
 
-> MCP 接口仅应在可信本机环境使用。提供商查询工具会返回明文 API Key，请勿将服务暴露到不可信网络。
+> MCP 接口仅应在可信本机环境使用。Provider 查询工具会返回明文 API Key，请勿将服务暴露到不可信网络。
 
 ## 数据目录与环境变量
 
@@ -215,39 +255,49 @@ Claude Code `.mcp.json` 示例：
 
 | 变量 | 默认值 | 说明 |
 | --- | --- | --- |
-| `PORT` | `25947` | Web UI 和代理端口 |
-| `LLM_INSPECTOR_DATA_DIR` | 系统默认目录 | providers、runtime config 等数据目录 |
+| `PORT` | `25947` | Web UI、代理和 MCP 端口 |
+| `LLM_INSPECTOR_DATA_DIR` | 系统默认目录 | providers、runtime config、logs、chunks 等数据目录 |
+| `LLM_INSPECTOR_CONFIG_PATH` | `<dataDir>/providers.json` | Provider 配置文件路径 |
+| `LLM_INSPECTOR_PROVIDERS_JSON` | 无 | 启动时注入 Provider JSON |
+| `LLM_INSPECTOR_STRIP_CLAUDE_CODE_BILLING_HEADER` | `0` | 初始是否移除 Claude Code billing header 文本块 |
 | `LOG_DIR` | `<dataDir>/logs` | 捕获日志和运行日志目录 |
 | `LOG_RETENTION_DAYS` | `7` | 日志保留天数 |
 | `CHUNKS_DIR` | `<dataDir>/chunks` | SSE chunks 存储目录 |
+| `PROXY_IDENTITY` | `inspector9527@Tony` | 转发请求使用的代理身份标识 |
 
-提供商 API Key 以明文 JSON 保存在本机数据目录中。请保护该目录，并避免在共享或不可信主机上运行服务。
+Provider API Key 以明文 JSON 保存在本机数据目录中。请保护该目录，并避免在共享或不可信主机上运行服务。
 
 ## HTTP API
 
 | Endpoint | Method | 说明 |
 | --- | --- | --- |
 | `/api/health` | GET | 健康检查 |
-| `/api/logs` | GET / DELETE | 查询或清空日志 |
+| `/api/config` | GET / PATCH | 查询或更新运行时代理配置 |
+| `/api/config/paths` | GET | 查看配置文件路径 |
+| `/api/logs` | GET / DELETE | 查询、分页筛选或清空日志；DELETE 可按 id 清理 |
 | `/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/providers` | GET / POST | 查询或添加 Provider |
+| `/api/providers/:id` | GET / PUT / DELETE | 管理单个 Provider |
+| `/api/providers/:id/test` | POST | 测试 Provider 连接 |
+| `/api/providers/:id/test/log` | POST | 写入 Provider 测试日志 |
+| `/api/providers/export` | GET | 导出 Provider 配置 |
+| `/api/providers/import` | POST | 导入 Provider 配置 |
+| `/api/providers/scan` | GET | 扫描外部 Provider 配置 |
 | `/api/mcp` | POST | MCP HTTP Streamable endpoint |
 
 ## 开发与验证
 
 ```bash
 bun test
-npm run typecheck
-npm run lint
-npm run format:check
-npm run build
+bun run typecheck
+bun run lint
+bun run format:check
+bun run build
 ```
 
 涉及代理或 UI 的改动还应启动开发服务器，并使用真实 AI 编码工具通过代理完成端到端验证：

package/package.json

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