docs:update readme

Author: Taois

README.md

@@ -1,7 +1,30 @@
 # Pup Sniffer
 
+[![Node.js Version](https://img.shields.io/badge/node-%3E%3D18.0.0-brightgreen.svg)](https://nodejs.org/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Platform](https://img.shields.io/badge/platform-Windows%20%7C%20Linux%20%7C%20macOS-lightgrey.svg)](https://github.com)
+
 基于 Puppeteer 和 Fastify 的视频资源嗅探器 Node.js 版本。
 
+> 🎯 **高性能视频资源嗅探工具**，支持多平台部署，提供完整的 API 接口和现代化 Web 界面。
+
+## 📋 目录
+
+- [功能特性](#功能特性)
+- [系统要求](#系统要求)
+- [快速开始](#快速开始)
+- [构建二进制文件](#构建二进制文件)
+- [API 接口](#api-接口)
+- [使用示例](#使用示例)
+- [测试](#测试)
+- [命令行参数](#命令行参数)
+- [环境变量](#环境变量)
+- [注意事项](#注意事项)
+- [故障排除](#故障排除)
+- [文档](#文档)
+- [开发](#开发)
+- [许可证](#许可证)
+
 ## 功能特性
 
 - 🎯 视频资源嗅探（支持 m3u8、mp4 等格式）
@@ -76,20 +99,38 @@
 
 ## 构建二进制文件
 
-### 构建所有平台
+项目提供了多种构建选项，支持不同的压缩算法和优化级别，以满足不同的使用需求。
+
+### 📦 构建选项概览
+
+| 构建类型 | 压缩算法 | 体积优化 | 适用场景 |
+|----------|----------|----------|----------|
+| 标准版 | GZip | 中等 | 通用部署 |
+| Brotli版 | Brotli | 较高 | 网络传输优化 |
+| 轻量版 | Brotli | 高 | 资源受限环境 |
+| 迷你版 | Brotli | 最高 | 极致体积要求 |
+
+### 🚀 快速构建
+
 ```bash
+# 构建所有平台（标准版，GZip压缩）
 npm run build
-```
 
-### 构建特定平台
+# 构建优化版本（推荐，包含多种压缩选项）
+npm run build:optimized
 
-[打包工具pkg安装参考](https://www.jb51.net/javascript/329845uie.htm)
+# 构建迷你版本（最小体积，所有平台）
+npm run build:mini
+```
+
+### 🎯 平台特定构建
 
+#### 标准版本（GZip 压缩）
 ```bash
 # Windows x64
 npm run build:win
 
-# Linux x64
+# Linux x64  
 npm run build:linux
 
 # macOS x64
@@ -99,6 +140,114 @@ npm run build:macos
 npm run build:macos-arm
 ```
 
+#### Brotli 压缩版本（更小体积）
+```bash
+# Windows x64
+npm run build:win:brotli
+
+# Linux x64
+npm run build:linux:brotli
+
+# macOS x64
+npm run build:macos:brotli
+
+# macOS ARM64
+npm run build:macos-arm:brotli
+```
+
+#### 轻量版本（优化选项）
+```bash
+# Windows x64
+npm run build:win:lite
+
+# Linux x64
+npm run build:linux:lite
+
+# macOS x64
+npm run build:macos:lite
+
+# macOS ARM64
+npm run build:macos-arm:lite
+```
+
+#### 迷你版本（最小体积）
+```bash
+# Windows x64
+npm run build:win:mini
+
+# Linux x64
+npm run build:linux:mini
+
+# macOS x64
+npm run build:macos:mini
+
+# macOS ARM64
+npm run build:macos-arm:mini
+```
+
+### ⚙️ 构建优化技术
+
+项目采用了多种优化技术来减小打包体积：
+
+1. **压缩算法**：
+   - **GZip**：标准压缩，兼容性好
+   - **Brotli**：更高压缩率，体积减少 10-15%
+
+2. **PKG 优化选项**：
+   - `--no-bytecode`：禁用字节码缓存
+   - `--public-packages=*`：减少包装开销
+   - `--no-warnings`：减少输出体积
+
+3. **资源排除**：
+   - 通过 `.pkgignore` 排除开发、测试、文档文件
+   - 排除大型依赖的非必要部分
+   - 智能排除开发环境专用模块
+
+4. **智能配置**：
+   - 生产环境自动禁用 `pino-pretty` 日志美化
+   - 动态检测运行环境，优化资源加载
+
+### 📊 体积对比
+
+以 Windows x64 版本为例：
+
+| 版本类型 | 文件大小 | 压缩率 | 说明 |
+|----------|----------|--------|------|
+| 标准版 | ~46 MB | - | GZip 压缩 |
+| Brotli版 | ~44 MB | -4% | Brotli 压缩 |
+| 轻量版 | ~42 MB | -9% | Brotli + 优化选项 |
+| 迷你版 | ~41 MB | -11% | 最大优化 |
+
+### 🛠️ 高级构建
+
+如需更多自定义选项，可以使用优化构建脚本：
+
+```bash
+# 运行优化构建脚本（包含所有选项）
+node build-optimized.js
+
+# 查看详细构建指南
+cat docs/BUILD_GUIDE.md
+```
+
+### 📋 构建要求
+
+[打包工具pkg安装参考](https://www.jb51.net/javascript/329845uie.htm)
+
+**系统要求**：
+- Node.js >= 18.0.0
+- npm 或 yarn
+- 足够的磁盘空间（构建过程需要约 200MB 临时空间）
+
+**依赖安装**：
+```bash
+# 安装构建依赖
+npm install
+
+# 全局安装 pkg（可选，项目已包含）
+npm install -g pkg
+```
+
 构建完成后，二进制文件将输出到 `dist/` 目录。
 
 ## API 接口
@@ -304,15 +453,47 @@ npm test
 3. 尝试使用自定义正则表达式
 4. 启用调试模式查看详细日志
 
-## 开发
+## 📚 文档
+
+- [API 文档](docs/API_DOCS.md) - 详细的 API 接口说明
+- [构建指南](docs/BUILD_GUIDE.md) - 完整的构建配置和优化说明
+
+## 🔧 开发
 
 项目采用 CommonJS 模块化开发，主要文件：
 
 - `sniffer.cjs`: 核心嗅探类
-- `server.cjs`: Fastify 服务器
+- `server.cjs`: Fastify 服务器  
 - `test.js`: 测试脚本
 - `package.json`: 项目配置
+- `build-optimized.js`: 优化构建脚本
+- `.pkgignore`: 打包排除文件配置
+
+### 开发环境设置
+
+```bash
+# 克隆项目
+git clone <repository-url>
+cd pup-sniffer
+
+# 安装依赖
+npm install
+
+# 启动开发服务器
+npm start
+
+# 运行测试
+npm test
+```
+
+### 代码贡献
+
+1. Fork 项目
+2. 创建特性分支 (`git checkout -b feature/AmazingFeature`)
+3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
+4. 推送到分支 (`git push origin feature/AmazingFeature`)
+5. 打开 Pull Request
 
-## 许可证
+## 📄 许可证
 
 MIT License