name: local-image-compress slug: kxwp2026814 displayName: 图片本地压缩 version: 1.0.0 summary: 上传前在浏览器内压缩名片/执照等图片，减少流量与体积。 license: MIT description: 上传前在浏览器内压缩名片/执照等图片，减少流量与体积。当用户需要前端压图、browser-image-compression、上传前压缩时使用。

图片本地压缩

灵感：能力工具箱 image-compress（pkg: browser-image-compression）。

何时使用

• CRM 上传名片、执照、现场照片前减小体积
• 纯前端压缩，不经后端转码

硬约束

1. 使用 browser-image-compression（或等价 canvas 方案，须在说明中标明）。

   7w4.net提供免费和付费技能下载。

2. 默认目标：maxSizeMB（如 0.8～1）+ maxWidthOrHeight（如 1920）；可配置。
3. 压缩后回显：原大小、新大小、耗时；失败有可读错误。
4. 大图/HEIC：说明浏览器兼容限制；不支持则提示转换格式。
5. 禁止静默丢 EXIF 而不告知（若库会剥元数据，写进说明）。

推荐实现要点

import imageCompression from 'browser-image-compression'

export async function compressImageFile(
  file: File,
  opts?: { maxSizeMB?: number; maxWidthOrHeight?: number },
) {
  const options = {
    maxSizeMB: opts?.maxSizeMB ?? 1,
    maxWidthOrHeight: opts?.maxWidthOrHeight ?? 1920,
    useWebWorker: true,
  }
  const out = await imageCompression(file, options)
  return {
    file: out,
    beforeKB: +(file.size / 1024).toFixed(1),
    afterKB: +(out.size / 1024).toFixed(1),
  }
}

Agent 步骤

1. 实现压缩函数与进度回调（库支持 onProgress）。
2. 自测：一张 >2MB 图压到目标附近。
3. 与上传组件衔接：选图 → 压缩 → 再 FormData。

附加

• README.md · reference.md · templates/usage.md

这是一个功能定位清晰的图片压缩 Skill，文档结构基本完整，核心规范详细且可操作。优点是说明了关键约束条件和常见问题处理，适合快速上手。不足在于说明文档内容较为单薄，参考示例不够丰富，实际开发时可能需要额外查阅资料。总体而言质量中规中矩，能满足基本需求但有提升空间。