@343dev/guetzli

中文文档
1.3.0发布于 2026/06/25Apache-2.0ES Module零依赖近 30 天下载 1.3万

guetzli 二进制包装器

中文使用文档
文档目录4 节
  1. 导言
  2. 使用量
  3. 命令行旗
  4. 页:1

@ 343dev/guetzli (英语)

Guetzli avatar: A graphic representation of a round biscuit with a scalloped edge, yellow in color, and topped with three evenly spaced red circles.

npm

谷歌/格兹利语 节点.js 二进制包装

获得支持:

  • 操作系统平台 : darwin, (中文(简体) ), linux, (中文(简体) ), win32。 。 。 .
  • CPU 架构 : arm64, (中文(简体) ), x64。 。 。 .

导言

Guetzli是一款JPEG编码器,目的是在高视觉质量下达到优秀的压缩密度. 盖茨利所生成的图像一般比libjpeg所生成的质量相当的图像要小20-30%. 盖茨利只产生相继(非进步)的JPEG,因为它们提供的减压速度更快.

使用量

安装 :

npm i -g @343dev/guetzli

压缩 :

guetzli [flags] input_filename output_filename
# or
cat image.jpg | guetzli - - > result.jpg

命令行旗

  • --verbose ——打印出所有标准输出尝试的动词痕迹.
  • --quality Q - 视觉质量,以JPEG质量值(单位等同libjpeg质量)表示.
  • --memlimit M ——MB内存限制. 盖兹利若不能停留于限下会失败. 默认为 6,000 MB .
  • --nomemlimit ——不限制内存使用.

页:1

盖兹利使用大量的记忆. 您应该提供每输入图像 1 MPix 的 300MB 内存 .

盖茨利使用了大量的CPU时间. 您应该使用约 1 分钟的 CPU 每 1 MPix 输入图像 .

Guetzli 假设输入在 sRGB 简介 带有 伽马为 2.2. Guetzli 将忽略图像中任何色彩标注元数据.

盖茨利被设计用于高品质的图像上. 您应该总是倾向于提供未压缩的输入图像(例如,还没有用包括Guetzli在内的任何JPEG编码器压缩过). 虽然它也会对其他图像产生影响,但结果会更差。 你可以尝试压缩一个封闭的样本 高质量的图像.

JPEG 图像不支持α通道(透明). 如果输入是带有α通道的PNG,则在编码前会覆盖在黑色背景上.

版本与发布记录

@343dev/guetzli 共发布 5 个版本,首次发布于 2024/10/22;过去 12 个月发布了 2 个版本。

版本发布日期距今
1.3.0latest2026/06/254 个月前
1.2.02026/01/0210 个月前
1.1.02025/04/101.6 年前
1.0.12024/10/222 年前
1.0.02024/10/222 年前

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

@343dev/guetzli 是什么?

guetzli 二进制包装器

如何安装 @343dev/guetzli?

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

@343dev/guetzli 支持 TypeScript 吗?

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

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

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

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

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

@343dev/guetzli 可以商用吗?

@343dev/guetzli 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

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

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

@343dev/guetzli 还在维护吗?

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