@mt0926/node-network-devtools 0.3.0 → 0.3.10

package/README.md

@@ -2,11 +2,11 @@
 
 # 🔍 Node Network DevTools
 
-**Monitor Node.js network requests with Chrome DevTools integration and built-in Web GUI**
+**A powerful, zero-config network debugging companion for Node.js.**  
+*Monitor all outgoing HTTP, HTTPS, and Fetch/Undici requests in a sleek, real-time Web GUI that feels just like Chrome DevTools.*
 
-[![npm version](https://img.shields.io/npm/v/node-network-devtools.svg)](https://www.npmjs.com/package/@mt0926/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.zh-CN.md)
 
@@ -14,174 +14,104 @@
 
 ---
 
-## ⚠️ Development Tool Only
+## 🚀 Why Node Network DevTools?
 
-**This tool is designed for development environments only. Do NOT use in production!**
-
-- Uses Puppeteer to launch a minimal browser window for the GUI
-- Intercepts all network requests which may impact performance
-- Stores request/response data in memory
-- Not suitable for production workloads
-
-### Disabling in Production
-
-```javascript
-// Conditional installation
-if (process.env.NODE_ENV === 'development') {
-  await install();
-}
-```
-
-Or use environment variables:
-
-```bash
-# Disable GUI and auto-open
-NND_GUI_ENABLED=false NND_AUTO_OPEN=false node your-app.js
-```
+Tired of `console.log`ing every request and response? **Node Network DevTools** brings the familiarity of the browser's "Network" tab to your Node.js backend. Whether you're debugging external API calls, microservices, or Next.js server actions, you can now inspect every detail in real-time.
 
 ## ✨ Features
 
-- 🔍 **Dual Interception** - Supports both `http/https` modules and `undici/fetch` API
-- 🎯 **Zero Intrusion** - Auto-inject via `-r` or `--import`, no code changes needed
-- 🖥️ **Minimal Browser Window** - Puppeteer-powered compact GUI window (800x600)
-- 📊 **Built-in Web GUI** - Chrome DevTools-like interface with real-time updates
-- 🔗 **Request Tracing** - AsyncLocalStorage-based request correlation
-- 🛡️ **Security** - Auto-redact sensitive headers (Authorization, Cookie, etc.)
-- ⚡ **Next.js Compatible** - Preserves `next.revalidate`, `next.tags` options
-- 📦 **TypeScript** - Full TypeScript support with type definitions
+- 💎 **DevTools-like Experience** - A familiar, responsive Web GUI for inspecting headers, payloads, and responses.
+- 🔌 **Universal Interception** - Native support for `http/https` modules and modern `fetch/undici` (Node.js 18+).
+- 🛠️ **Zero Code Intrusion** - Plug it into your project with a single line of code or a simple CLI flag.
+- 🖥️ **Minimal Browser Window** - Automatically launches a compact, app-mode GUI window (using your system's Chrome, Edge, or Chromium).
+- 🔗 **Smart Request Tracing** - Automatically correlate related requests in a single business flow using `AsyncLocalStorage`.
+- 🛡️ **Built-in Redaction** - Keeps your secrets safe by auto-redacting sensitive headers like `Authorization` and `Cookie`.
+- ⚡ **Framework Ready** - Seamless integration with Next.js, Express, Fastify, and more.
+- 📦 **Dual Module Support** - Works out of the box with both **ESM** and **CommonJS**.
 
 ## 📸 Screenshots
 
 ### Web GUI Interface
 ![Web GUI](https://via.placeholder.com/800x450?text=Web+GUI+Screenshot)
 
-### Chrome DevTools Integration
-![Chrome DevTools](https://via.placeholder.com/800x450?text=Chrome+DevTools+Screenshot)
-
 ## 🚀 Quick Start
 
-### Installation
+### 1. Installation
 
 ```bash
-npm install node-network-devtools puppeteer
+npm install @mt0926/node-network-devtools
 # or
-pnpm add node-network-devtools puppeteer
-# or
-yarn add node-network-devtools puppeteer
+pnpm add @mt0926/node-network-devtools
 ```
 
-**Note**: 
-- Puppeteer is required for the GUI browser window. If not installed, you'll see a friendly error message with installation instructions.
-- This package supports both **ESM** and **CommonJS** module systems. See [Module System Support](#module-system-support) for details.
+> **Note**: No extra dependencies like Puppeteer are required! It uses your system's existing browser.
 
-### Usage
+### 2. Usage (Recommended)
 
-#### Method 1: CLI (Recommended)
-
-```bash
-npx node-network-devtools your-script.js
-# or use the short alias
-npx nnd your-script.js
-```
-
-The CLI automatically injects the interceptor and opens the GUI.
-
-#### Method 2: Using `-r` flag
-
-**ESM:**
-```bash
-node --import node-network-devtools/register your-script.js
-```
-
-**CommonJS:**
-```bash
-node -r node-network-devtools/register your-script.js
-```
-
-#### Method 3: Programmatic
+Just call `install()` at the very beginning of your application entry point.
 
 **ESM:**
 ```typescript
-import { install } from 'node-network-devtools';
-
-await install();
+import { install } from '@mt0926/node-network-devtools';
 
-// Your application code
-import express from 'express';
-const app = express();
-// ...
+await install(); // Call before any other imports that make network requests
 ```
 
 **CommonJS:**
 ```javascript
-const { install } = require('node-network-devtools');
+const { install } = require('@mt0926/node-network-devtools');
 
 (async () => {
   await install();
-
-  // Your application code
-  const express = require('express');
-  const app = express();
-  // ...
 })();
 ```
 
-### Viewing Requests
-
-After starting your application:
+### 3. Advanced: Zero-Code Injection
 
-- **Web GUI** (Default): A minimal browser window will automatically open showing the GUI
-  - Compact window size (800x600 by default)
-  - Customizable window size and title
-  - No browser chrome or toolbars (app mode)
+If you don't want to modify your source code, you can use Node.js CLI arguments to inject the tool.
 
-To manually access the GUI, look for the URL in the console output:
+**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
 
-The built-in Web GUI provides a Chrome DevTools-like experience for monitoring network requests.
-
-### Minimal Browser Window
-
-The GUI opens in a minimal Puppeteer-controlled browser window:
-
-- **Compact Size**: Default 800x600, customizable via environment variables
-- **App Mode**: No browser chrome, toolbars, or address bar
-- **Custom Title**: Shows "Node Network DevTools" by default
-- **Fast Launch**: Opens in under 3 seconds
+Once started, a minimal browser window will automatically open showing the real-time request list.
 
-### Features
+- **Compact size** (800x600) for side-by-side debugging.
+- **Search & Filter** by URL, method, or status.
+- **Details Panel** for headers, payload, and response.
+- **Dark/Light** theme support.
 
-- 📋 **Request List** - Real-time display of all network requests
-- 🔍 **Search & Filter** - Filter by URL, method, status code, and type
-- 📝 **Details Panel** - View headers, payload, response, and timing
-- 🎨 **Theme Toggle** - Dark/Light theme support
-- ⏸️ **Pause/Resume** - Pause request capture for analysis
-- 🔄 **Real-time Updates** - WebSocket-based live updates
+If you need to access it manually, check the console output for the URL:
+`🚀 Node Network DevTools GUI started at http://localhost:9229`
 
 ### GUI Configuration
 
 ```bash
 # Customize window size
-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
 
 # Customize window title
-NND_BROWSER_TITLE="My App Network Monitor" npx nnd your-script.js
+NND_BROWSER_TITLE="My App Network Monitor" node --import @mt0926/node-network-devtools/register your-script.js
 
 # Specify GUI port
-NND_GUI_PORT=9230 npx nnd your-script.js
+NND_GUI_PORT=9230 node --import @mt0926/node-network-devtools/register your-script.js
 
 # Specify WebSocket port
-NND_WS_PORT=9231 npx nnd your-script.js
+NND_WS_PORT=9231 node --import @mt0926/node-network-devtools/register your-script.js
 
 # Disable GUI
-NND_GUI_ENABLED=false npx nnd your-script.js
+NND_GUI_ENABLED=false node --import @mt0926/node-network-devtools/register your-script.js
 
 # Disable auto-open browser
-NND_AUTO_OPEN=false npx nnd your-script.js
+NND_AUTO_OPEN=false node --import @mt0926/node-network-devtools/register your-script.js
 ```
 
 ## 🔧 Configuration
@@ -213,7 +143,7 @@ NND_AUTO_OPEN=false npx nnd your-script.js
 ### Programmatic Configuration
 
 ```typescript
-import { setConfig } from 'node-network-devtools';
+import { setConfig } from '@mt0926/node-network-devtools';
 
 setConfig({
   maxRequests: 500,
@@ -233,7 +163,7 @@ setConfig({
 ```typescript
 // Conditional installation based on environment
 if (process.env.NODE_ENV === 'development') {
-  const { install } = await import('node-network-devtools');
+  const { install } = await import('@mt0926/node-network-devtools');
   await install();
 }
 ```
@@ -283,7 +213,7 @@ Or configure in `package.json`:
 **ESM:**
 ```typescript
 import express from 'express';
-import { install } from 'node-network-devtools';
+import { install } from '@mt0926/node-network-devtools';
 
 await install();
 
@@ -294,7 +224,7 @@ const app = express();
 **CommonJS:**
 ```javascript
 const express = require('express');
-const { install } = require('node-network-devtools');
+const { install } = require('@mt0926/node-network-devtools');
 
 (async () => {
   await install();
@@ -317,8 +247,8 @@ This package supports both **ESM (ECMAScript Modules)** and **CommonJS** module
 Use `import` statements in projects with `"type": "module"` in package.json or `.mjs` files:
 
 ```typescript
-import { install, getRequestStore } from 'node-network-devtools';
-import 'node-network-devtools/register';
+import { install, getRequestStore } from '@mt0926/node-network-devtools';
+import '@mt0926/node-network-devtools/register';
 
 await install();
 const store = getRequestStore();
@@ -329,8 +259,8 @@ const store = getRequestStore();
 Use `require()` statements in traditional Node.js projects or `.cjs` files:
 
 ```javascript
-const { install, getRequestStore } = require('node-network-devtools');
-require('node-network-devtools/register');
+const { install, getRequestStore } = require('@mt0926/node-network-devtools');
+require('@mt0926/node-network-devtools/register');
 
 (async () => {
   await install();
@@ -343,8 +273,8 @@ require('node-network-devtools/register');
 Full TypeScript support with type definitions for both module systems:
 
 ```typescript
-import type { Config, IRequestStore } from 'node-network-devtools';
-import { install, getRequestStore } from 'node-network-devtools';
+import type { Config, IRequestStore } from '@mt0926/node-network-devtools';
+import { install, getRequestStore } from '@mt0926/node-network-devtools';
 
 const config: Config = {
   maxRequests: 500,
@@ -371,23 +301,23 @@ No configuration needed - it just works! 🎉
 
 ```typescript
 // Quick install
-import { install, startGUI, stopGUI } from 'node-network-devtools';
+import { install, startGUI, stopGUI } from '@mt0926/node-network-devtools';
 
 // Configuration
-import { getConfig, setConfig, resetConfig } from 'node-network-devtools';
+import { getConfig, setConfig, resetConfig } from '@mt0926/node-network-devtools';
 
 // Request store
-import { getRequestStore } from 'node-network-devtools';
+import { getRequestStore } from '@mt0926/node-network-devtools';
 
 // Context tracing
 import { 
   runWithTrace, 
   getCurrentTraceId,
   generateTraceId 
-} from 'node-network-devtools';
+} from '@mt0926/node-network-devtools';
 
 // Interceptors
-import { HttpPatcher, UndiciPatcher } from 'node-network-devtools';
+import { HttpPatcher, UndiciPatcher } from '@mt0926/node-network-devtools';
 ```
 
 ### Request Tracing
@@ -395,7 +325,7 @@ import { HttpPatcher, UndiciPatcher } from 'node-network-devtools';
 Correlate multiple requests in the same business flow:
 
 ```typescript
-import { runWithTrace, getRequestStore } from 'node-network-devtools';
+import { runWithTrace, getRequestStore } from '@mt0926/node-network-devtools';
 
 await runWithTrace('user-login', async () => {
   // These requests will be correlated with the same traceId
@@ -426,7 +356,7 @@ Check the [examples](./examples) directory for more usage examples:
 2. **Undici Interception**: Uses `Agent.compose()` to register interceptors for fetch requests
 3. **Context Propagation**: Uses `AsyncLocalStorage` to pass TraceID through async call chains
 4. **Event Bridge**: Forwards intercepted requests to WebSocket clients for real-time GUI updates
-5. **Minimal Browser**: Uses Puppeteer to launch a compact browser window in app mode
+5. **Native Browser Launch**: Detects and launches your system's browser (Chrome/Edge/Chromium) in a dedicated app-mode window.
 
 ## 🤝 Contributing
 
@@ -464,7 +394,7 @@ MIT © [ddddd](https://github.com/dong0926)
 
 - 🐛 [Report Issues](https://github.com/dong0926/node-network-devtools/issues)
 - 💬 [Discussions](https://github.com/dong0926/node-network-devtools/discussions)
-- 📧 Email: your.email@example.com
+- 📧 Email: xx630133368@gmail.com
 
 ---
 

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
 
 ---