@343dev/optimizt

中文文档
13.0.0发布于 2026/06/27MITES Module构建来源已验证近 30 天下载 1.3万

CLI 图像优化工具

中文使用文档
文档目录19 节
  1. 理由
  2. 使用量
  3. 命令行标记
  4. 用法实例
  5. 损失和无损失之间的差异
  6. 损失( 过失)
  7. 无损失 ( --lossless 旗帜)
  8. 配置
  9. 解决问题
  10. 错误如“sprawn guetzli ENOENT”.
  11. 发展
  12. 夹克
  13. 预建图像
  14. 手动构建
  15. 运行容器
  16. 一体化
  17. 文章
  18. 贷项
  19. 其他项目

@ 343dev/优化

Optimizt logo: OK hand sign with Mona Lisa image between the fingers

NPM Downloads npm Docker

优化 是一个命令行工具,有助于为网络准备图像.

它可以压缩PNG,JPEG,GIF,和SVG的失落或无损失,并为光栅图像创建AVIF和WebP版本.

理由

作为前端开发者,我们必须关注图片:压缩PNG和JPEG,去掉SVG的无用部分,为现代浏览器创建AVIF和WebP等. 有一天,我们厌倦了使用一堆应用软件来达到这个目的,并创造了一个工具来做我们想要的一切.

使用量

安装 :

npm install -g @343dev/optimizt

优化!

optimizt path/to/picture.jpg

命令行标记

  • --avif ——创建图像的AVIF版本.
  • --webp ——创建图像的WebP版本.
  • -f, --force ——即使AVIF和WebP版本已经存在,也要重新创建.
  • -l, --lossless ——优化无损失取而代之.
  • -v, --verbose ——显示详细的输出(例如跳过的文件).
  • -c, --config ——使用自定义配置文件而不是默认.
  • -o, --output ——将结果写入指定的目录.
  • -p, --prefix ——在优化文件名后添加前缀.
  • -s, --suffix ——为优化文件名添加后缀.
  • -V, --version ——显示工具版本.
  • -h, --help - 显示帮助信息.

用法实例

# optimize a single image
optimizt path/to/picture.jpg

# optimize multiple images losslessly
optimizt --lossless path/to/picture.jpg path/to/another/picture.png

# recursively create AVIF and WebP versions for all images in a directory
optimizt --avif --webp path/to/directory

# recursively optimize JPEG files in the current directory
find . -iname \*.jpg -exec optimizt {} +

损失和无损失之间的差异

损失( 过失)

提供文件大小缩小和最小视觉质量损失的最佳平衡.

无损失 (--lossless 旗帜)

  • AVIF/网页:使用无损压缩.
  • PNG/JPEG/全球投资框架: 以更大的文件大小为代价,使图像质量最大化.
  • 特别工作组:两种模式的设置相同.

配置

图像处理杠杆 :

[注] 在 JPEG 的无损失模式中, 盖茨利 已使用。 重复优化可能会降低视觉质量.

默认设置在 .优化cjs,包括所有支持的参数。 设置为 false。 。 。 .

使用时 --config path/to/.optimiztrc.cjs,将使用指定的配置文件。 如果没有 --config ,从当前目录向上递回查找 .optimiztrc.cjs。如果找不到,则适用默认值.

解决问题

错误如“sprawn guetzli ENOENT”.

确保 忽略标注 npm 选项已禁用 . 细节 : 音箱/优化/问题/9。 。 。 .

发展

复制寄存器后, 启用 Git 钩子一次 :

npm run enable-git-hooks

此配置 Git 以使用来自 {\fn方正黑体简体\fs18\b1\bord1\shad1\3ch2f2f2f}美国海军陆战队 目录.

夹克

预建图像

# pull latest
docker pull 343dev/optimizt

# pull specific version
docker pull 343dev/optimizt:9.0.2

手动构建

# clone repository
git clone https://github.com/343dev/optimizt.git
cd optimizt

# build image
docker build --tag 343dev/optimizt .

或者:

# build directly from GitHub
# ignores .dockerignore (see: https://github.com/docker/cli/issues/2827)
docker build --tag 343dev/optimizt https://github.com/343dev/optimizt.git

运行容器

# mount current directory to /src in the container
docker run --rm --volume $(pwd):/src 343dev/optimizt --webp ./image.png

一体化

优化工作与:

文章

贷项

项目的可爱图片由下列人士制作: 伊戈尔·加里巴尔迪。 。 。 .

其他项目

  • 📦 哈罗德 ——比较前端工程捆绑大小的 CLI 工具
  • 🐳 囚犯 - 安装自动文件系统路径的多克容器包装器
  • 📝 马克-下行 ——基于Pretier,Remark,和Typograf的Markdown代码样式linter
  • 🔤 语言工具-节点 由语言工具驱动的 CLI 拼写和语法检查器

版本与发布记录

@343dev/optimizt 共发布 18 个版本,首次发布于 2023/07/10;过去 12 个月发布了 4 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
13.0.0latest2026/06/274 个月前
12.1.12026/01/0210 个月前
12.1.02025/12/2410 个月前
12.0.02025/12/2310 个月前
11.0.02025/05/041.5 年前
10.0.02024/10/282 年前

关于 @343dev/optimizt 的常见问题

@343dev/optimizt 是什么?

CLI 图像优化工具

如何安装 @343dev/optimizt?

在项目目录运行 npm install @343dev/optimizt,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 optimizt,可以用 npx optimizt 直接运行。

@343dev/optimizt 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/343dev__optimizt 是否存在。

@343dev/optimizt 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@343dev/optimizt 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=22.22.1。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@343dev/optimizt 可以商用吗?

@343dev/optimizt 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@343dev/optimizt 的下载量有多少?

根据 npm 官方下载统计,@343dev/optimizt 在 2026/10/05 – 2026/11/03 这 30 天内被下载 12,586 次,日均约 420 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@343dev/optimizt 还在维护吗?

最新版本 13.0.0 发布于 2026/06/27(4 个月前);至今共发布 18 个版本,其中过去 12 个月发布了 4 个;首次发布于 2023/07/10。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。