@zhaoshijun/compress 1.0.5 → 1.1.0

package/README.md

@@ -115,35 +115,42 @@ import { compressVitePlugin } from "@zhaoshijun/compress";
 export default defineConfig({
   plugins: [
     compressVitePlugin({
-      // 1. 覆盖通用质量
-      quality: 75,
-
-      // 2. 覆盖 PNG 特定选项 (注意：如果覆盖对象，需要提供完整属性，或者插件逻辑里做深度合并)
-      // 根据当前代码实现是浅合并，所以如果只写 palette，compressionLevel 可能会丢失(如果默认值是在loader里处理的)
-      // 实际上 loader.js 做了深度合并，但 vite 插件里的 options 是顶层覆盖。
-      // 建议：如果只改一项，尽量在 compress.config.js 里改。
-      // 如果必须在这里改，传入完整对象：
+      // 1. JPEG 压缩选项
+      jpegOptions: {
+        quality: 75,
+        progressive: true,
+        mozjpeg: true
+      },
+
+      // 2. PNG 压缩选项
       pngOptions: {
-        compressionLevel: 6,
-        palette: false,
+        compressionLevel: 9,
+        palette: true,
+        effort: 7
+      },
+
+      // 3. WebP 压缩选项
+      webpOptions: {
+        quality: 80,
+        effort: 4
       },
 
-      // 3. 甚至可以开启尺寸限制（虽然通常不建议在构建时改变原图尺寸）
+      // 4. 尺寸限制（可选）
       resize: {
         maxWidth: 1024,
       },
 
-      // 4. 控制缓存
-      cache: false,
-
-      // 5. 启用水印
+      // 5. 水印配置
       watermark: {
         text: 'Copyright 2024',
         opacity: 0.5,
         density: 3,
         color: '#ffffff',
         fontSize: 24
-      }
+      },
+
+      // 6. 控制缓存
+      cache: false,
     }),
   ],
 });
@@ -178,14 +185,34 @@ module.exports = {
     // scale: 0.8       // 缩放比例 (0-1)
   },
 
-  // 通用质量参数 (JPEG/WebP)
-  // 范围 1-100，默认 88
-  quality: 88,
+  // JPEG 专属配置
+  jpegOptions: {
+    quality: 88, // 质量 (1-100)，默认 88
+    progressive: false, // 渐进式 JPEG，默认 false
+    mozjpeg: false, // 使用 mozjpeg 编码器，默认 false
+    trellisQuantisation: false, // Trellis 量化，默认 false
+    overshootDeringing: false, // 过冲去环，默认 false
+    optimiseScans: false, // 优化扫描，默认 false
+    optimiseCoding: false // 优化编码，默认 false
+  },
 
   // PNG 专属配置
   pngOptions: {
     compressionLevel: 9, // 压缩等级 0-9，默认 9
     palette: true, // 是否启用调色板量化，默认 true (显著减小体积)
+    adaptiveFiltering: false, // 自适应过滤，默认 false
+    progressive: false, // 渐进式 PNG，默认 false
+    effort: 7 // 压缩努力程度 1-10，默认 7
+  },
+
+  // WebP 专属配置
+  webpOptions: {
+    quality: 88, // 质量 (1-100)，默认 88
+    alphaQuality: 80, // 透明度质量 (0-100)，默认 80
+    lossless: false, // 无损压缩，默认 false
+    nearLossless: false, // 近无损压缩，默认 false
+    smartSubsample: false, // 智能子采样，默认 false
+    effort: 4 // 压缩努力程度 0-6，默认 4
   },
 
   // 输出文件名后缀
@@ -245,3 +272,21 @@ A: 可以。使用 `watermark` 命令可以单独给图片添加水印而不进
 
 **Q: 水印颜色支持哪些格式？**
 A: 水印颜色支持十六进制格式（如 `#ffffff`）和 RGBA 格式（如 `rgba(255,255,255,0.5)`）。
+
+**Q: 如何选择合适的压缩选项？**
+A: 不同格式有不同的压缩策略：
+
+- **JPEG**: 
+  - `quality`: 75-85 是平衡质量和体积的最佳范围
+  - `progressive`: 适合网络传输，可渐进加载
+  - `mozjpeg`: 使用 mozjpeg 编码器可获得更好的压缩率
+
+- **PNG**:
+  - `compressionLevel`: 9 是最大压缩，但处理时间较长
+  - `palette`: 对简单图形（如 logo、图标）启用调色板可大幅减小体积
+  - `effort`: 7 是默认值，可根据需要调整（1-10）
+
+- **WebP**:
+  - `quality`: 80-90 通常能获得很好的压缩效果
+  - `lossless`: 对需要保持透明度的图片可考虑无损模式
+  - `effort`: 4 是默认值，数值越大压缩时间越长但效果更好

package/bin/compress.js

@@ -197,10 +197,19 @@ program
   //   // maxHeight: 1080,
   //   // scale: 0.8
   // },
-  quality: 88,
+  jpegOptions: {
+    quality: 88,
+    progressive: false,
+    mozjpeg: false
+  },
   pngOptions: {
     compressionLevel: 9,
-    palette: true
+    palette: true,
+    effort: 7
+  },
+  webpOptions: {
+    quality: 88,
+    effort: 4
   },
   suffix: '.min',
   backup: false,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhaoshijun/compress",
-  "version": "1.0.5",
+  "version": "1.1.0",
   "description": "Image compression CLI and Vite plugin",
   "type": "module",
   "bin": {

package/src/config/defaults.js

@@ -1,9 +1,29 @@
 export const defaultConfig = {
   output: './compressed',
   quality: 88,
+  jpegOptions: {
+    quality: 88,
+    progressive: false,
+    mozjpeg: false,
+    trellisQuantisation: false,
+    overshootDeringing: false,
+    optimiseScans: false,
+    optimiseCoding: false
+  },
   pngOptions: {
     compressionLevel: 9,
-    palette: true
+    palette: true,
+    adaptiveFiltering: false,
+    progressive: false,
+    effort: 7
+  },
+  webpOptions: {
+    quality: 88,
+    alphaQuality: 80,
+    lossless: false,
+    nearLossless: false,
+    smartSubsample: false,
+    effort: 4
   },
   suffix: '.min',
   backup: false,

package/src/config/loader.js

@@ -22,10 +22,18 @@ export async function loadConfig(configPath) {
       return {
         ...defaultConfig,
         ...userConfig,
+        jpegOptions: {
+          ...defaultConfig.jpegOptions,
+          ...(userConfig.jpegOptions || {})
+        },
         pngOptions: {
           ...defaultConfig.pngOptions,
           ...(userConfig.pngOptions || {})
         },
+        webpOptions: {
+          ...defaultConfig.webpOptions,
+          ...(userConfig.webpOptions || {})
+        },
         watermark: {
           ...defaultConfig.watermark,
           ...(userConfig.watermark || {})

package/src/core/compressor.js

@@ -44,17 +44,13 @@ export async function compressImage(input, options, filePath) {
   switch (format) {
     case 'jpeg':
     case 'jpg':
-      instance = instance.jpeg({ quality: options.quality || 88 });
+      instance = instance.jpeg(options.jpegOptions || { quality: 88 });
       break;
     case 'png':
-      instance = instance.png({
-        compressionLevel: options.pngOptions?.compressionLevel ?? 9,
-        palette: options.pngOptions?.palette ?? true,
-        quality: options.quality
-      });
+      instance = instance.png(options.pngOptions || { compressionLevel: 9, palette: true });
       break;
     case 'webp':
-      instance = instance.webp({ quality: options.quality || 88 });
+      instance = instance.webp(options.webpOptions || { quality: 88 });
       break;
     default:
       if (['jpeg', 'jpg', 'png', 'webp'].includes(format)) {

package/vite/index.js

@@ -32,10 +32,26 @@ export function compressVitePlugin(options = {}) {
         }
       };
       
-      // 特殊处理：如果 options 里有 quality，覆盖 config.quality
-      if (options.quality) config.quality = options.quality;
-      // 如果 options 里有 cache，覆盖 config.vite.cache
-      if (options.cache !== undefined) config.vite.cache = options.cache;
+      // 特殊处理：深度合并各格式的压缩选项
+      if (options.jpegOptions) {
+        config.jpegOptions = {
+          ...fileConfig.jpegOptions,
+          ...options.jpegOptions
+        };
+      }
+      if (options.pngOptions) {
+        config.pngOptions = {
+          ...fileConfig.pngOptions,
+          ...options.pngOptions
+        };
+      }
+      if (options.webpOptions) {
+        config.webpOptions = {
+          ...fileConfig.webpOptions,
+          ...options.webpOptions
+        };
+      }
+      
       // 特殊处理：如果 options 里有 watermark，深度合并
       if (options.watermark) {
         config.watermark = {