@mt0926/node-network-devtools 0.2.0 → 0.3.10

package/README.zh-CN.md

@@ -2,11 +2,11 @@
 
 # 🔍 Node Network DevTools
 
-**Node.js 网络请求监控工具，集成 Chrome DevTools 和内置 Web GUI**
+**Node.js 强大的零配置网络调试助手。**  
+*实时监控所有 HTTP、HTTPS 和 Fetch/Undici 请求，提供类似 Chrome DevTools 的极简 Web GUI 体验。*
 
-[![npm version](https://img.shields.io/npm/v/node-network-devtools.svg)](https://www.npmjs.com/package/node-network-devtools)
+[![npm version](https://img.shields.io/npm/v/@mt0926/node-network-devtools.svg)](https://www.npmjs.com/package/@mt0926/node-network-devtools)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-[![Node.js Version](https://img.shields.io/node/v/node-network-devtools.svg)](https://nodejs.org)
 
 [English](./README.md) | [中文文档](#)
 
@@ -14,151 +14,105 @@
 
 ---
 
-## ⚠️ 仅限开发环境使用
+## 🚀 为什么选择 Node Network DevTools?
 
-**本工具仅用于开发环境，请勿在生产环境中使用！**
-
-- 使用 Puppeteer 启动极简浏览器窗口显示 GUI
-- 拦截所有网络请求可能影响性能
-- 在内存中存储请求/响应数据
-- 不适合生产环境工作负载
-
-### 在生产环境中禁用
-
-```javascript
-// 条件安装
-if (process.env.NODE_ENV === 'development') {
-  await install();
-}
-```
-
-或使用环境变量：
-
-```bash
-# 禁用 GUI 和自动打开
-NND_GUI_ENABLED=false NND_AUTO_OPEN=false node your-app.js
-```
+还在用 `console.log` 打印每一个请求和响应吗？**Node Network DevTools** 将浏览器“网络”面板的熟悉体验带到了 Node.js 后端。无论是在调试外部 API 调用、微服务还是 Next.js Server Actions，你都可以实时查看每一个细节。
 
 ## ✨ 特性
 
-- 🔍 **双重拦截** - 同时支持 `http/https` 模块和 `undici/fetch` API
-- 🎯 **零侵入** - 通过 `-r` 或 `--import` 自动注入，无需修改代码
-- 🖥️ **极简浏览器窗口** - Puppeteer 驱动的紧凑 GUI 窗口（800x600）
-- 📊 **内置 Web GUI** - 类似 Chrome DevTools 的界面，实时更新
-- 🔗 **请求追踪** - 基于 AsyncLocalStorage 的请求关联
-- 🛡️ **安全性** - 自动脱敏敏感请求头（Authorization、Cookie 等）
-- ⚡ **Next.js 兼容** - 保留 `next.revalidate`、`next.tags` 等选项
-- 📦 **TypeScript** - 完整的 TypeScript 支持和类型定义
+- 💎 **类似 DevTools 的体验** - 熟悉的响应式 Web GUI，用于检查 Header、Payload 和 Response。
+- 🔌 **全能拦截** - 原生支持 `http/https` 模块以及现代的 `fetch/undici` (Node.js 18+)。
+- 🛠️ **零侵入开发** - 只需一行代码或一个简单的 CLI 标志即可接入项目。
+- 🖥️ **极简浏览器窗口** - 自动启动基于系统原生浏览器 (Chrome, Edge, 或 Chromium) 的紧凑 App 模式窗口。
+- 🔗 **智能请求追踪** - 利用 `AsyncLocalStorage` 自动关联同一业务流中的多个异步请求。
+- 🛡️ **内置脱敏** - 自动隐藏 `Authorization` 和 `Cookie` 等敏感信息，保障安全。
+- ⚡ **框架友好** - 无缝集成 Next.js, Express, Fastify 等主流框架。
+- 📦 **双模块支持** - 完美兼容 **ESM** 和 **CommonJS**。
 
 ## 📸 截图
 
 ### Web GUI 界面
 ![Web GUI](https://via.placeholder.com/800x450?text=Web+GUI+Screenshot)
 
-### Chrome DevTools 集成
-![Chrome DevTools](https://via.placeholder.com/800x450?text=Chrome+DevTools+Screenshot)
-
 ## 🚀 快速开始
 
-### 安装
+### 1. 安装
 
 ```bash
-npm install node-network-devtools puppeteer
-# 或
-pnpm add node-network-devtools puppeteer
+npm install @mt0926/node-network-devtools
 # 或
-yarn add node-network-devtools puppeteer
+pnpm add @mt0926/node-network-devtools
 ```
 
-**注意**：Puppeteer 是 GUI 浏览器窗口所必需的。如果未安装，您会看到友好的错误消息和安装指引。
-
-### 使用
-
-#### 方式一：CLI（推荐）
+> **注意**: 无需安装 Puppeteer 等额外依赖！工具会自动检测并使用系统中已有的浏览器。
 
-```bash
-npx node-network-devtools your-script.js
-# 或使用短别名
-npx nnd your-script.js
-```
+### 2. 使用方式 (推荐)
 
-CLI 会自动注入拦截器并打开 GUI。
+在应用入口文件的最顶部调用 `install()`。
 
-#### 方式二：使用 `-r` 标志
+**ESM:**
+```typescript
+import { install } from '@mt0926/node-network-devtools';
 
-```bash
-node -r node-network-devtools/register your-script.js
+await install(); // 确保在发送任何网络请求的 import 之前调用
 ```
 
-#### 方式三：编程方式
-
-```typescript
-import { install } from 'node-network-devtools';
-
-await install();
+**CommonJS:**
+```javascript
+const { install } = require('@mt0926/node-network-devtools');
 
-// 你的应用代码
-import express from 'express';
-const app = express();
-// ...
+(async () => {
+  await install();
+})();
 ```
 
-### 查看请求
+### 3. 高级方案：零代码注入
 
-启动应用后：
+如果你不想修改源代码，可以使用 Node.js 的命令行参数来注入工具。
 
-- **Web GUI**（默认）：极简浏览器窗口会自动打开显示 GUI
-  - 紧凑的窗口大小（默认 800x600）
-  - 可自定义窗口大小和标题
-  - 无浏览器工具栏或地址栏（app 模式）
-
-要手动访问 GUI，请查看控制台输出中的 URL：
+**ESM:**
+```bash
+node --import @mt0926/node-network-devtools/register your-script.js
 ```
-🚀 Node Network DevTools GUI started at http://localhost:9229
+
+**CommonJS:**
+```bash
+node -r @mt0926/node-network-devtools/register your-script.js
 ```
 
 ## 🖥️ Web GUI
 
-内置的 Web GUI 提供类似 Chrome DevTools 的网络请求监控体验。
-
-### 极简浏览器窗口
-
-GUI 在极简的 Puppeteer 控制的浏览器窗口中打开：
+启动后，一个极简的浏览器窗口会自动打开并显示实时请求列表。
 
-- **紧凑尺寸**：默认 800x600，可通过环境变量自定义
-- **App 模式**：无浏览器工具栏、地址栏或其他界面元素
-- **自定义标题**：默认显示 "Node Network DevTools"
-- **快速启动**：3 秒内打开
+- **紧凑尺寸** (800x600)，方便分屏调试。
+- **搜索与过滤** - 按 URL、方法或状态码筛选。
+- **详情面板** - 查看 Header、Payload 和 Response。
+- **深色/浅色模式**支持。
 
-### 功能特性
+如果需要手动访问，请在控制台输出中查找 URL：
+`🚀 Node Network DevTools GUI started at http://localhost:9229`
 
-- 📋 **请求列表** - 实时显示所有网络请求
-- 🔍 **搜索过滤** - 按 URL、方法、状态码和类型过滤
-- 📝 **详情面板** - 查看请求头、请求体、响应和时序信息
-- 🎨 **主题切换** - 支持深色/浅色主题
-- ⏸️ **暂停/恢复** - 暂停请求捕获以便分析
-- 🔄 **实时更新** - 基于 WebSocket 的实时更新
 
 ### GUI 配置
 
 ```bash
 # 自定义窗口大小
-NND_BROWSER_WIDTH=1024 NND_BROWSER_HEIGHT=768 npx nnd your-script.js
+NND_BROWSER_WIDTH=1024 NND_BROWSER_HEIGHT=768 node --import @mt0926/node-network-devtools/register your-script.js
 
 # 自定义窗口标题
-NND_BROWSER_TITLE="我的应用网络监控" npx nnd your-script.js
+NND_BROWSER_TITLE="我的应用网络监控" node --import @mt0926/node-network-devtools/register your-script.js
 
 # 指定 GUI 端口
-NND_GUI_PORT=9230 npx nnd your-script.js
+NND_GUI_PORT=9230 node --import @mt0926/node-network-devtools/register your-script.js
 
 # 指定 WebSocket 端口
-NND_WS_PORT=9231 npx nnd your-script.js
+NND_WS_PORT=9231 node --import @mt0926/node-network-devtools/register your-script.js
 
 # 禁用 GUI
-NND_GUI_ENABLED=false npx nnd your-script.js
+NND_GUI_ENABLED=false node --import @mt0926/node-network-devtools/register your-script.js
 
 # 禁用自动打开浏览器
-NND_AUTO_OPEN=false npx nnd your-script.js
+NND_AUTO_OPEN=false node --import @mt0926/node-network-devtools/register your-script.js
 ```
 
 ## 🔧 配置
@@ -190,7 +144,7 @@ NND_AUTO_OPEN=false npx nnd your-script.js
 ### 编程配置
 
 ```typescript
-import { setConfig } from 'node-network-devtools';
+import { setConfig } from '@mt0926/node-network-devtools';
 
 setConfig({
   maxRequests: 500,
@@ -210,7 +164,7 @@ setConfig({
 ```typescript
 // 根据环境条件安装
 if (process.env.NODE_ENV === 'development') {
-  const { install } = await import('node-network-devtools');
+  const { install } = await import('@mt0926/node-network-devtools');
   await install();
 }
 ```
@@ -259,7 +213,7 @@ npm run dev
 
 ```typescript
 import express from 'express';
-import { install } from 'node-network-devtools';
+import { install } from '@mt0926/node-network-devtools';
 
 await install();
 
@@ -277,23 +231,23 @@ const app = express();
 
 ```typescript
 // 快速安装
-import { install, startGUI, stopGUI } from 'node-network-devtools';
+import { install, startGUI, stopGUI } from '@mt0926/node-network-devtools';
 
 // 配置
-import { getConfig, setConfig, resetConfig } from 'node-network-devtools';
+import { getConfig, setConfig, resetConfig } from '@mt0926/node-network-devtools';
 
 // 请求存储
-import { getRequestStore } from 'node-network-devtools';
+import { getRequestStore } from '@mt0926/node-network-devtools';
 
 // 上下文追踪
 import { 
   runWithTrace, 
   getCurrentTraceId,
   generateTraceId 
-} from 'node-network-devtools';
+} from '@mt0926/node-network-devtools';
 
 // 拦截器
-import { HttpPatcher, UndiciPatcher } from 'node-network-devtools';
+import { HttpPatcher, UndiciPatcher } from '@mt0926/node-network-devtools';
 ```
 
 ### 请求追踪
@@ -301,7 +255,7 @@ import { HttpPatcher, UndiciPatcher } from 'node-network-devtools';
 关联同一业务流程中的多个请求：
 
 ```typescript
-import { runWithTrace, getRequestStore } from 'node-network-devtools';
+import { runWithTrace, getRequestStore } from '@mt0926/node-network-devtools';
 
 await runWithTrace('user-login', async () => {
   // 这些请求会被关联到同一个 traceId
@@ -331,7 +285,7 @@ const requests = store.getByTraceId('user-login');
 2. **Undici 拦截**：使用 `Agent.compose()` 注册拦截器捕获 fetch 请求
 3. **上下文传递**：使用 `AsyncLocalStorage` 在异步调用链中传递 TraceID
 4. **事件桥接**：将拦截的请求转发到 WebSocket 客户端以实现 GUI 实时更新
-5. **极简浏览器**：使用 Puppeteer 在 app 模式下启动紧凑的浏览器窗口
+5. **原生浏览器启动**：自动检测并启动系统中的浏览器 (Chrome/Edge/Chromium)，并以专用的 App 模式窗口运行。
 
 ## 🤝 贡献
 
@@ -369,7 +323,7 @@ MIT © [ddddd](https://github.com/dong0926)
 
 - 🐛 [报告问题](https://github.com/dong0926/node-network-devtools/issues)
 - 💬 [讨论](https://github.com/dong0926/node-network-devtools/discussions)
-- 📧 邮箱：your.email@example.com
+- 📧 邮箱：xx630133368@gmail.com
 
 ---
 

package/dist/cjs/adapters/axios.js

@@ -0,0 +1,2 @@
+"use strict";
+//# sourceMappingURL=axios.js.map

package/dist/cjs/adapters/axios.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"axios.js","sourceRoot":"","sources":["../../../src/adapters/axios.ts"],"names":[],"mappings":""}

package/dist/cjs/adapters/nextjs.js

@@ -0,0 +1,133 @@
+"use strict";
+/**
+ * Next.js 框架适配器
+ *
+ * 确保与 Next.js 的 Data Cache 和 Request Memoization 兼容
+ * 保留 next.revalidate、next.tags 等选项
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NextJsAdapter = void 0;
+exports.isNextJsEnvironment = isNextJsEnvironment;
+exports.getCurrentRoute = getCurrentRoute;
+exports.runWithRoute = runWithRoute;
+exports.runWithRouteAsync = runWithRouteAsync;
+exports.extractNextJsOptions = extractNextJsOptions;
+exports.extractNextJsMetadata = extractNextJsMetadata;
+exports.createInstrumentationConfig = createInstrumentationConfig;
+const node_async_hooks_1 = require("node:async_hooks");
+// 用于存储当前路由信息的 AsyncLocalStorage
+const routeStorage = new node_async_hooks_1.AsyncLocalStorage();
+/**
+ * 检测是否在 Next.js 环境中
+ */
+function isNextJsEnvironment() {
+    // 检查 Next.js 特有的环境变量
+    return !!(process.env.NEXT_RUNTIME ||
+        process.env.__NEXT_PRIVATE_PREBUNDLED_REACT ||
+        process.env.NEXT_DEPLOYMENT_ID);
+}
+/**
+ * 获取当前路由信息
+ */
+function getCurrentRoute() {
+    return routeStorage.getStore();
+}
+/**
+ * 在指定路由上下文中运行函数
+ */
+function runWithRoute(route, type, fn) {
+    return routeStorage.run({ route, type }, fn);
+}
+/**
+ * 异步版本的 runWithRoute
+ */
+async function runWithRouteAsync(route, type, fn) {
+    return routeStorage.run({ route, type }, fn);
+}
+/**
+ * 提取 Next.js fetch 选项
+ */
+function extractNextJsOptions(init) {
+    if (!init)
+        return undefined;
+    const options = {};
+    // 提取 next 选项
+    if ('next' in init && init.next) {
+        const nextOpts = init.next;
+        options.next = {
+            revalidate: nextOpts.revalidate,
+            tags: nextOpts.tags,
+        };
+    }
+    // 提取 cache 选项
+    if ('cache' in init && init.cache) {
+        options.cache = init.cache;
+    }
+    return Object.keys(options).length > 0 ? options : undefined;
+}
+/**
+ * 从请求中提取 Next.js 元数据
+ */
+function extractNextJsMetadata(init, responseHeaders) {
+    const metadata = {};
+    // 获取当前路由
+    const routeInfo = getCurrentRoute();
+    if (routeInfo) {
+        metadata.route = routeInfo.route;
+        metadata.requestType = routeInfo.type;
+    }
+    // 提取 fetch 选项
+    const nextOptions = extractNextJsOptions(init);
+    if (nextOptions?.next) {
+        metadata.revalidate = nextOptions.next.revalidate;
+        metadata.tags = nextOptions.next.tags;
+    }
+    // 从响应头提取缓存状态
+    if (responseHeaders) {
+        const cacheStatus = getHeader(responseHeaders, 'x-nextjs-cache');
+        if (cacheStatus) {
+            metadata.cacheStatus = cacheStatus;
+        }
+    }
+    return metadata;
+}
+/**
+ * 辅助函数：获取响应头
+ */
+function getHeader(headers, name) {
+    if (headers instanceof Headers) {
+        return headers.get(name) ?? undefined;
+    }
+    return headers[name] || headers[name.toLowerCase()];
+}
+/**
+ * 创建 Next.js instrumentation 配置
+ */
+function createInstrumentationConfig() {
+    return `// instrumentation.ts
+// 将此文件放在 Next.js 项目根目录
+
+export async function register() {
+  // 仅在服务端运行
+  if (process.env.NEXT_RUNTIME === 'nodejs') {
+    // 动态导入以避免客户端打包
+    const { install } = await import('node-network-devtools');
+    await install();
+    console.log('[node-network-devtools] 已在 Next.js 服务端初始化');
+  }
+}
+`;
+}
+/**
+ * Next.js 适配器对象
+ */
+exports.NextJsAdapter = {
+    isNextJsEnvironment,
+    getCurrentRoute,
+    runWithRoute,
+    runWithRouteAsync,
+    extractNextJsOptions,
+    extractNextJsMetadata,
+    createInstrumentationConfig,
+};
+//# sourceMappingURL=nextjs.js.map

package/dist/cjs/adapters/nextjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nextjs.js","sourceRoot":"","sources":["../../../src/adapters/nextjs.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AA0CH,kDAOC;AAKD,0CAEC;AAKD,oCAEC;AAKD,8CAMC;AAMD,oDAoBC;AAKD,sDA6BC;AAkBD,kEAcC;AApKD,uDAAqD;AAkCrD,gCAAgC;AAChC,MAAM,YAAY,GAAG,IAAI,oCAAiB,EAAmC,CAAC;AAE9E;;GAEG;AACH,SAAgB,mBAAmB;IACjC,qBAAqB;IACrB,OAAO,CAAC,CAAC,CACP,OAAO,CAAC,GAAG,CAAC,YAAY;QACxB,OAAO,CAAC,GAAG,CAAC,+BAA+B;QAC3C,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAC/B,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAgB,eAAe;IAC7B,OAAO,YAAY,CAAC,QAAQ,EAAE,CAAC;AACjC,CAAC;AAED;;GAEG;AACH,SAAgB,YAAY,CAAI,KAAa,EAAE,IAAY,EAAE,EAAW;IACtE,OAAO,YAAY,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;AAC/C,CAAC;AAED;;GAEG;AACI,KAAK,UAAU,iBAAiB,CACrC,KAAa,EACb,IAAY,EACZ,EAAoB;IAEpB,OAAO,YAAY,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;AAC/C,CAAC;AAGD;;GAEG;AACH,SAAgB,oBAAoB,CAAC,IAAkB;IACrD,IAAI,CAAC,IAAI;QAAE,OAAO,SAAS,CAAC;IAE5B,MAAM,OAAO,GAAuB,EAAE,CAAC;IAEvC,aAAa;IACb,IAAI,MAAM,IAAI,IAAI,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QAChC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAwD,CAAC;QAC/E,OAAO,CAAC,IAAI,GAAG;YACb,UAAU,EAAE,QAAQ,CAAC,UAAU;YAC/B,IAAI,EAAE,QAAQ,CAAC,IAAI;SACpB,CAAC;IACJ,CAAC;IAED,cAAc;IACd,IAAI,OAAO,IAAI,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QAClC,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,KAAkB,CAAC;IAC1C,CAAC;IAED,OAAO,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;AAC/D,CAAC;AAED;;GAEG;AACH,SAAgB,qBAAqB,CACnC,IAAkB,EAClB,eAAkD;IAElD,MAAM,QAAQ,GAAmB,EAAE,CAAC;IAEpC,SAAS;IACT,MAAM,SAAS,GAAG,eAAe,EAAE,CAAC;IACpC,IAAI,SAAS,EAAE,CAAC;QACd,QAAQ,CAAC,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC;QACjC,QAAQ,CAAC,WAAW,GAAG,SAAS,CAAC,IAAqC,CAAC;IACzE,CAAC;IAED,cAAc;IACd,MAAM,WAAW,GAAG,oBAAoB,CAAC,IAAI,CAAC,CAAC;IAC/C,IAAI,WAAW,EAAE,IAAI,EAAE,CAAC;QACtB,QAAQ,CAAC,UAAU,GAAG,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC;QAClD,QAAQ,CAAC,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC;IACxC,CAAC;IAED,aAAa;IACb,IAAI,eAAe,EAAE,CAAC;QACpB,MAAM,WAAW,GAAG,SAAS,CAAC,eAAe,EAAE,gBAAgB,CAAC,CAAC;QACjE,IAAI,WAAW,EAAE,CAAC;YAChB,QAAQ,CAAC,WAAW,GAAG,WAA4C,CAAC;QACtE,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;GAEG;AACH,SAAS,SAAS,CAChB,OAAyC,EACzC,IAAY;IAEZ,IAAI,OAAO,YAAY,OAAO,EAAE,CAAC;QAC/B,OAAO,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,SAAS,CAAC;IACxC,CAAC;IACD,OAAO,OAAO,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;AACtD,CAAC;AAED;;GAEG;AACH,SAAgB,2BAA2B;IACzC,OAAO;;;;;;;;;;;;CAYR,CAAC;AACF,CAAC;AAED;;GAEG;AACU,QAAA,aAAa,GAAG;IAC3B,mBAAmB;IACnB,eAAe;IACf,YAAY;IACZ,iBAAiB;IACjB,oBAAoB;IACpB,qBAAqB;IACrB,2BAA2B;CAC5B,CAAC"}

package/dist/cjs/config.js

@@ -0,0 +1,150 @@
+"use strict";
+/**
+ * 配置管理模块
+ *
+ * 支持通过环境变量和编程方式配置工具行为
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getConfig = getConfig;
+exports.setConfig = setConfig;
+exports.resetConfig = resetConfig;
+exports.getDefaultConfig = getDefaultConfig;
+/**
+ * 默认配置
+ */
+const defaultConfig = {
+    maxRequests: 1000,
+    maxBodySize: 1024 * 1024, // 1MB
+    interceptHttp: true,
+    interceptUndici: true,
+    ignoreUrls: [],
+    redactHeaders: ['authorization', 'cookie'],
+    disableBodyCapture: false,
+    // GUI 配置默认值
+    guiEnabled: true,
+    guiPort: 'auto',
+    wsPort: 'auto',
+    guiHost: '127.0.0.1',
+    autoOpen: true,
+    // 浏览器窗口默认配置
+    browserWindowSize: {
+        width: 800,
+        height: 600,
+    },
+    browserWindowTitle: 'Node Network DevTools',
+    browserPath: undefined,
+};
+/**
+ * 当前配置（合并后的结果）
+ */
+let currentConfig = { ...defaultConfig };
+/**
+ * 从环境变量解析布尔值
+ */
+function parseEnvBoolean(value, defaultValue) {
+    if (value === undefined)
+        return defaultValue;
+    const lower = value.toLowerCase();
+    if (lower === 'true' || lower === '1' || lower === 'yes')
+        return true;
+    if (lower === 'false' || lower === '0' || lower === 'no')
+        return false;
+    return defaultValue;
+}
+/**
+ * 从环境变量解析数字
+ */
+function parseEnvNumber(value, defaultValue) {
+    if (value === undefined)
+        return defaultValue;
+    const num = parseInt(value, 10);
+    return isNaN(num) ? defaultValue : num;
+}
+/**
+ * 从环境变量解析字符串数组（逗号分隔）
+ */
+function parseEnvStringArray(value, defaultValue) {
+    if (value === undefined || value.trim() === '')
+        return defaultValue;
+    return value.split(',').map(s => s.trim().toLowerCase()).filter(s => s.length > 0);
+}
+/**
+ * 从环境变量解析端口（支持 'auto' 或数字）
+ */
+function parseEnvPort(value, defaultValue) {
+    if (value === undefined)
+        return defaultValue;
+    if (value.toLowerCase() === 'auto')
+        return 'auto';
+    const num = parseInt(value, 10);
+    return isNaN(num) ? defaultValue : num;
+}
+/**
+ * 从环境变量加载配置
+ */
+function loadFromEnv() {
+    const env = process.env;
+    return {
+        maxRequests: parseEnvNumber(env.NND_MAX_REQUESTS, defaultConfig.maxRequests),
+        maxBodySize: parseEnvNumber(env.NND_MAX_BODY_SIZE, defaultConfig.maxBodySize),
+        interceptHttp: parseEnvBoolean(env.NND_INTERCEPT_HTTP, defaultConfig.interceptHttp),
+        interceptUndici: parseEnvBoolean(env.NND_INTERCEPT_UNDICI, defaultConfig.interceptUndici),
+        redactHeaders: parseEnvStringArray(env.NND_REDACT_HEADERS, defaultConfig.redactHeaders),
+        disableBodyCapture: parseEnvBoolean(env.NND_DISABLE_BODY_CAPTURE, defaultConfig.disableBodyCapture),
+        // GUI 配置
+        guiEnabled: parseEnvBoolean(env.NND_GUI_ENABLED, defaultConfig.guiEnabled),
+        guiPort: parseEnvPort(env.NND_GUI_PORT, defaultConfig.guiPort),
+        wsPort: parseEnvPort(env.NND_WS_PORT, defaultConfig.wsPort),
+        guiHost: env.NND_GUI_HOST || defaultConfig.guiHost,
+        autoOpen: parseEnvBoolean(env.NND_AUTO_OPEN, defaultConfig.autoOpen),
+        // 浏览器窗口配置
+        browserWindowSize: {
+            width: parseEnvNumber(env.NND_BROWSER_WIDTH, defaultConfig.browserWindowSize?.width ?? 800),
+            height: parseEnvNumber(env.NND_BROWSER_HEIGHT, defaultConfig.browserWindowSize?.height ?? 600),
+        },
+        browserWindowTitle: env.NND_BROWSER_TITLE || defaultConfig.browserWindowTitle,
+        browserPath: env.NND_BROWSER_PATH,
+    };
+}
+/**
+ * 初始化配置（合并默认值和环境变量）
+ */
+function initConfig() {
+    const envConfig = loadFromEnv();
+    return {
+        ...defaultConfig,
+        ...envConfig,
+        // ignoreUrls 需要特殊处理，环境变量不支持正则
+        ignoreUrls: defaultConfig.ignoreUrls,
+    };
+}
+// 初始化时加载配置
+currentConfig = initConfig();
+/**
+ * 获取当前配置
+ */
+function getConfig() {
+    return currentConfig;
+}
+/**
+ * 设置配置（合并到当前配置）
+ */
+function setConfig(config) {
+    currentConfig = {
+        ...currentConfig,
+        ...config,
+    };
+}
+/**
+ * 重置配置为默认值
+ */
+function resetConfig() {
+    currentConfig = initConfig();
+}
+/**
+ * 获取默认配置（用于测试）
+ */
+function getDefaultConfig() {
+    return defaultConfig;
+}
+//# sourceMappingURL=config.js.map

package/dist/cjs/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":"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"}