1.0.14 • Published 7 months ago
image-util v1.0.14
Image Utilities Tool
专业的图片处理命令行工具，提供图片压缩和未使用文件检测两大核心功能。
功能特性
🖼️ 图片压缩
- 支持格式：
webp/jpeg/png/gif - 质量调节（1-99）
- 格式转换
- 压缩率统计
- 安全模式（指定输出目录避免覆盖）
🧹 未使用文件检测
- 递归目录扫描
- 内容引用检测
- 交互式删除确认
- 排除目录支持
- 空间释放统计
安装
npm install -g image-util使用说明
图片压缩
ci --target [目录路径] [选项]
# 示例
ci -t ./images -q 80 -f webp -d ./output| 选项 | 简写 | 描述 | 默认值 |
|---|---|---|---|
| --target | -t | 目标目录（必填） | - |
| --quality | -q | 压缩质量（1-99） | 99 |
| --format | -f | 输出格式（webp/jpeg/png） | 原格式 |
| --dir | -d | 输出目录 | 原地替换 |
| --list | -l | 显示文件列表 | false |
未使用文件检测
su --target [目录路径] [选项]
# 示例
su -t ./assets -e test_data temp_files| 选项 | 简写 | 描述 | 默认值 |
|---|---|---|---|
| --target | -t | 扫描目录（必填） | - |
| --exclude | -e | 排除目录/文件 | node_modules/.git |
| --list | -l | 显示文件列表 | false |
使用示例
压缩案例
$ ci -t ./src/images -q 75 -f webp -d ./dist
📝 使用 -q/--quality 指定质量参数（1-99），默认使用99
💾 输出目录：./dist
压缩质量分数: 75
压缩前大小: 24.8 MB
压缩后大小: 8.2 MB
压缩率: 66.94%
✅ 成功压缩 42 个文件清理案例
$ su -t ./public -e temp_files
? 是否删除文件 /project/public/banner-old.jpg (Y/n) y
? 是否删除文件 /project/public/obsolete-logo.png (Y/n) n
已释放空间: 1.7 MB开发指南
本地测试
npm link
ci --help # 测试压缩命令
su --help # 测试清理命令构建发布
npm version patch -m "发布版本 %s"
npm publish --access=public注意事项
- 使用原地替换模式（不指定-d参数）前建议备份
- 质量参数超过99会自动限制到最大值
- 排除目录支持glob模式（如
*.tmp） - Windows系统安装时需确保已安装Visual C++运行库