lake-cimg 1.0.2 → 1.1.0

package/bin/cimg.js

@@ -298,7 +298,7 @@ program
   .command("scan [input]")
   .description("扫描图片并给出优化建议（不修改文件）")
   .option("-r, --recursive", "递归处理子目录")
-  .option("--json", "以 JSON 格式输出（适合 AI/脚本消费）")
+  .option("--json", "以 JSON 格式输出（适合脚本与工具消费）")
   .action(async function scanAction(input, opts) {
     if (!input || input.trim() === "") {
       this.outputHelp();

package/lib/compress.js

@@ -17,6 +17,9 @@ import {
   encodeJpegBuffer,
 } from "./sharpHelpers.js";
 
+/** 小于此体积跳过压缩 */
+const THRESHOLD_SKIP_FOR_AGENT = 10 * 1024;
+
 /** Max concurrent tasks for processing images */
 const MAX_CONCURRENCY = Math.max(1, cpus().length);
 
@@ -104,7 +107,9 @@ export async function collectFiles(inputPath, recursive = false) {
  *   originalHeight: number | null,
  *   width: number | null,
  *   height: number | null,
- *   format: string | null
+ *   format: string | null,
+ *   skipped?: true,
+ *   reason?: "small" | "larger"
  * }>}
  */
 export async function processOne(inputPath, options = {}) {
@@ -119,6 +124,21 @@ export async function processOne(inputPath, options = {}) {
 
   const inputBuffer = await readFile(inputPath);
   const sizeBefore = inputBuffer.length;
+  if (sizeBefore < THRESHOLD_SKIP_FOR_AGENT) {
+    return {
+      outPath,
+      sizeBefore,
+      sizeAfter: sizeBefore,
+      originalWidth: null,
+      originalHeight: null,
+      width: null,
+      height: null,
+      format: null,
+      skipped: true,
+      reason: "small",
+    };
+  }
+
   let pipeline = sharp(inputBuffer, { animated: true });
   const inputMeta = await pipeline.metadata();
 
@@ -128,8 +148,23 @@ export async function processOne(inputPath, options = {}) {
     ? await encodeWebpBuffer(pipeline, quality, { lossless: false })
     : await toFormatBuffer(pipeline, ext, quality);
 
-  const outputMeta = await sharp(outputBuffer).metadata();
   const sizeAfter = outputBuffer.length;
+  if (sizeAfter > sizeBefore) {
+    return {
+      outPath,
+      sizeBefore,
+      sizeAfter,
+      originalWidth: inputMeta.width ?? null,
+      originalHeight: inputMeta.height ?? null,
+      width: null,
+      height: null,
+      format: null,
+      skipped: true,
+      reason: "larger",
+    };
+  }
+
+  const outputMeta = await sharp(outputBuffer).metadata();
   await mkdir(outBase, { recursive: true });
   await writeFile(outPath, outputBuffer);
   return {
@@ -166,7 +201,7 @@ async function toFormatBuffer(pipeline, ext, quality) {
 /**
  * Run batch compression.
  * @param {{ inputPath: string, outDir?: string | null, size?: number | null, quality?: number, recursive?: boolean }} options
- * @returns {Promise<{ success: number, failed: number }>} success/failed counts; throws if input invalid
+ * @returns {Promise<{ success: number, failed: number, skipped: number }>} counts; throws if input invalid
  */
 export async function run(options) {
   const {
@@ -208,13 +243,30 @@ export async function run(options) {
 
   let success = 0;
   let failed = 0;
+  let skipped = 0;
   let totalBefore = 0;
   let totalAfter = 0;
   for (let i = 0; i < files.length; i++) {
     const r = results[i];
     const fp = files[i];
     if (r.status === "fulfilled") {
-      const { outPath, sizeBefore, sizeAfter } = r.value;
+      const v = r.value;
+      if (v.skipped) {
+        skipped++;
+        if (v.reason === "small") {
+          console.log(`  ⏭  ${fp}`);
+          console.log(
+            `     不处理：原图 ${formatSize(v.sizeBefore)} 小于 10KB（无需压缩）`
+          );
+        } else {
+          console.log(`  ⏭  ${fp}`);
+          console.log(
+            `     不处理：压缩后 ${formatSize(v.sizeAfter)} 大于原图 ${formatSize(v.sizeBefore)}（已保留原图、未写出新文件）`
+          );
+        }
+        continue;
+      }
+      const { outPath, sizeBefore, sizeAfter } = v;
       totalBefore += sizeBefore;
       totalAfter += sizeAfter;
       console.log(`  ✅ ${fp} → ${basename(outPath)}`);
@@ -225,9 +277,10 @@ export async function run(options) {
       failed++;
     }
   }
-  console.log(`\n完成：成功 ${success}，失败 ${failed}。`);
+  const skipPart = skipped > 0 ? `，跳过 ${skipped}（<10KB 或压缩后更大）` : "";
+  console.log(`\n完成：成功 ${success}，失败 ${failed}${skipPart}。`);
   if (success > 0 && totalBefore > 0) {
     console.log(`合计：${formatCompare(totalBefore, totalAfter)}`);
   }
-  return { success, failed };
+  return { success, failed, skipped };
 }

package/lib/scan.js

@@ -7,6 +7,8 @@ import sharp from "sharp";
 import { collectFiles } from "./compress.js";
 
 const KB = 1024;
+/** 小于此体积一般无压缩收益，建议标记为不处理 */
+const THRESHOLD_SKIP_FOR_AGENT = 10 * KB;
 const THRESHOLD_LARGE_NON_WEBP = 100 * KB;
 const THRESHOLD_LARGE_WEBP = 500 * KB;
 const MAX_EDGE = 1920;
@@ -25,6 +27,9 @@ function formatSize(bytes) {
  * @returns {string}
  */
 function computeSuggestion(sizeBytes, format, width, height) {
+  if (sizeBytes < THRESHOLD_SKIP_FOR_AGENT) {
+    return "不处理：原图 <10KB（体积过小，无需压缩）";
+  }
   const fmt = (format ?? "").toLowerCase();
   if (fmt !== "webp" && sizeBytes > THRESHOLD_LARGE_NON_WEBP) {
     return "convert to webp";

package/lib/scanCodeReferences.js

@@ -895,7 +895,7 @@ export async function scanCodeReferences(rootDir, options = {}) {
       fmt
     ) {
       issues.push("suggest_modern_format");
-      hints.push("可考虑 WebP/AVIF 或 cimg picture 子命令生成多格式 <picture>");
+      hints.push("可考虑 WebP 格式");
     }
 
     const row = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lake-cimg",
-  "version": "1.0.2",
+  "version": "1.1.0",
   "description": "Batch image compression to WebP — CLI with picture stack and scan-code for frontend image audit",
   "keywords": [
     "image",