技能介绍

要解决什么问题

前端、文档和运营素材里常有体积偏大的 PNG/JPG：直接上传会拖慢页面或占满对象存储配额，本地用 sharp 等库批量处理又要自己管格式、并发和上传。本技能把压缩交给 NX API 完成，在对话里指定目录、单文件或图片 URL 即可，脚本回传 CDN 地址、原始/压缩后大小和 压缩率，需要落盘时用已有 CDN 链接 curl 到绝对路径即可。

技能如何工作

环境：需要 Node.js ≥ 18；通过项目级或全局安装下的 compress.js 执行（执行前 ls 确认脚本路径）。
认证：从当前工作目录向上查找 .env，兜底 ~/.env；存在 NX_API_KEY 则自动使用，没有 Key 也不拦截，由 API 返回认证结果。
输入规则：目录会整目录扫描；多目标时取最精确目录，其余文件单独追加；仅 URL 时只传 --urls=，不与臆造本地路径混用；本地与 URL 可组合。
参数：默认 --quality=90（1–100）；--output= 可把结果下载到指定目录；--channel= 等见技能文档。
并发与限制：本地文件单文件单请求，并发池为 5；单文件超过 30MB 在扫描阶段标记并跳过。
输出：标准输出为表格（文件名、大小、压缩率、CDN）；code===0 时看 data.items 里的 compressed_url、ratio 等字段。

边界与注意点

压缩在服务端完成，不要在本地再用 sharp 替代；路径统一用正斜杠。
用户未指定本地路径时，不要自动塞入项目目录；下载必须用绝对路径，且应直接 curl 已有 CDN，禁止为下载重复跑 --output= 的压缩命令。
常见失败包括余额不足、设备体验次数用尽、invalid api key、网络错误；超 30MB 需用户自行拆分或换源处理。