@blazediff/cli

中文文档
6.0.0发布于 2026/11/05MITTypeScriptESM + CJS构建来源已验证近 30 天下载 2598

Blazediff 图像比较库的命令行界面

中文使用文档
文档目录15 节
  1. 安装
  2. 使用量
  3. 图标
  4. core-native - 原生二进制比较(默认)
  5. core 财务报告和审定财务报表 core-wasm - JavaScript 和 Web Assembly 像素比较
  6. gmsd - 渐变相相近
  7. ssim - 结构相似性指数
  8. msssim - 多比例结构相似性指数
  9. hitchhikers-ssim - 快一点
  10. interpret - 事情变了,不只是在什么地方
  11. 实例
  12. 解码器(用于 core , (中文(简体) ), gmsd , (中文(简体) ), ssim , (中文(简体) )…
  13. 退出代码
  14. 核心本地/核心模式
  15. GMSD、SSIM、MS-SSIM模式

@blazediff/cli (英语)

npm bundle size NPM Downloads

BlazeDiff图像比较库的命令行界面.

安装

npm install -g @blazediff/cli

使用量

blazediff-cli <command> <image1> <image2> [options]

图标

BlazeDiff支持多个比较算法,每个算法对不同的使用大小写进行了优化:

core-native - 原生二进制比较(默认)

最快的选择 使用原生的 Rust 二进制并有 SIMD 优化,以达到最大性能.

blazediff-cli image1.png image2.png -o diff.png [options]
# Or explicitly:
blazediff-cli core-native image1.png image2.png -o diff.png [options]

core-native, (中文(简体) ), core 财务报告和审定财务报表 core-wasm 带上与"玫瑰"相同的旗帜 blazediff CLI: 爱丽丝

  • -o, --output <path> - diff图像输出路径
  • -t, --threshold <num> - 匹配阈值(0比1,默认:0.1)
  • --no-antialiasing - 将反异名像素计为差异(默认检测正在进行)
  • --metric <name> - 颜色度量: yiq( 默认) 或 oklab( 像素匹配 8)
  • --mask <path> - 图像中的非黑色像素被跳过
  • --window <n> - 同时报告差异最大的nxn窗口
  • -a, --alpha <num> - diff中原始图像的不透明度(默认:0.1)
  • --diff-color <r,g,b> - 不同像素的颜色( 默认: 255, 0, 0)
  • --diff-color-alt <r,g,b> - 变暗像素的颜色( 默认: diff 颜色)
  • --aa-color <r,g,b> - 反异名像素的颜色( 默认值: 255, 255, 0)
  • --background <faded|transparent> - diff图像显示在 diff (默认:已淡出) 下的内容
  • --json - 将结果对象打印为JSON

core-native 还要 --compression <0-9> 财务报告和审定财务报表 --quality <1-100>。 。 。 . core 财务报告和审定财务报表 core-wasm 还带 --codec <pngjs|sharp|jsquash-png>。 。 。 .

出站代码:0同,1相片不同或尺寸不相匹配,出站错误2个.

core 财务报告和审定财务报表 core-wasm - JavaScript 和 Web Assembly 像素比较

无土生属地. core-wasm 运行与 Rust 算法相同的 core-native。 。 。 .

blazediff-cli core image1.png image2.png [options]
blazediff-cli core-wasm image1.png image2.png [options]

gmsd - 渐变相相近

基于梯度相似性的概念质量度量.

blazediff-cli gmsd image1.png image2.png [options]

选项 :

  • -o, --output <path> - GMS相似度图输出路径
  • --downsample <0|1> - 下采样因子(0=满分,1=2x,默认:0)
  • --gmsd-c <num> - 稳定常数(违约:170)
  • --codec <name> - 指定要使用的编码器(pngjs, 锐口, jsquash- png)
  • -h, --help - 显示帮助消息

ssim - 结构相似性指数

衡量结构相似性的工业标准衡量标准.

blazediff-cli ssim image1.png image2.png [options]

选项 :

  • -o, --output <path> - SSIM地图可视化输出路径
  • --codec <name> - 指定要使用的编码器(pngjs, 锐口, jsquash- png)
  • -h, --help - 显示帮助消息

msssim - 多比例结构相似性指数

增强的SSIM在多个图像尺度下运行.

blazediff-cli msssim image1.png image2.png [options]

选项 :

  • -o, --output <path> - MS-SSIM地图可视化输出路径
  • --codec <name> - 指定要使用的编码器(pngjs, 锐口, jsquash- png)
  • -h, --help - 显示帮助消息

hitchhikers-ssim - 快一点

基于图像的综合 SSIM 执行,以更快的计算.

blazediff-cli hitchhikers-ssim image1.png image2.png [options]

interpret - 事情变了,不只是在什么地方

结构化区域分析:每个变化都得到类型、形状、位置和 背后的统计数据。 其它命令的答案 地点 像素不同或 怎么样相似 两个图像是;这个图像描述了变化.

blazediff-cli interpret image1.png image2.png [output] [options]

output 由 pixel 仅来源——计量来源和 --regions 没有 diff 可视化可写入, 而通过一个是一个错误 而不是默默忽略的道路.

选项 :

  • --source <name> - 如何确定地区: pixel (违约), ssim, (中文(简体) ), ms-ssim, (中文(简体) ), hitchhikers-ssim
  • -t, --threshold <num> - 颜色差阈值(0比1,默认:0.1). pixel 仅限
  • -a, --antialiasing - 排除反异名像素. pixel 仅限
  • -c, --compression <num> - PNG压缩级(0-9,默认:0)
  • --window-size <num> - 度量源的本地窗口大小(默认:11)
  • --region-floor <num> - 窗口得分,该得分按变化计算(默认:0.99)
  • --regions <json> - 跳过搜索并分类这些框
  • --json - 把结果全部打印成JSON
  • -h, --help - 显示帮助消息

参数源通过阈值 相似度图来定位区域,所以它们的盒子 和地图的网格一样粗糙 数字不是: 每个盒子都是精细的 先是源像素,所以像素计数为每个像素.

当无法操作时退出 0, 当它发生时退出 1, 在错误时退出 2 .

实例

# Native binary diff (default, fastest)
blazediff-cli image1.png image2.png diff.png
blazediff-cli core-native image1.png image2.png diff.png -t 0.05 -a

# JavaScript pixel diff (more options)
blazediff-cli core image1.png image2.png -o diff.png -t 0.05

# GMSD similarity metric
blazediff-cli gmsd image1.png image2.png
blazediff-cli gmsd image1.png image2.png -o gms-map.png

# Describe what changed
blazediff-cli interpret image1.png image2.png
blazediff-cli interpret image1.png image2.png --source ms-ssim
blazediff-cli interpret image1.png image2.png --json

# SSIM structural similarity
blazediff-cli ssim image1.png image2.png
blazediff-cli ssim image1.png image2.png -o ssim-map.png

# MS-SSIM multi-scale similarity
blazediff-cli msssim image1.png image2.png
blazediff-cli msssim image1.png image2.png -o msssim-map.png

# Use Sharp codec for better performance (core/gmsd/ssim)
blazediff-cli core image1.jpg image2.jpg --codec sharp

解码器(用于 core, (中文(简体) ), gmsd, (中文(简体) ), ssim, (中文(简体) ), msssim(中文(简体) )

  • 弹簧 (默认) - 纯JavaScript,到处工作. 仅支持PNG.
  • 锐口 - 原生束缚,明显更快。 支持PNG和JPEG.
  • j -基于WASM,零原生道具。 比pngjs还快。 仅限PNG.

退出代码

核心本地/核心模式

  • 0 - 图像是相同的
  • 1 - 图像有差异
  • 2 - 出错(文件未找到,格式无效等)

GMSD、SSIM、MS-SSIM模式

  • 0 - 图像高度相似(分数为0.95)
  • 1 - 图像有明显差异(分数 < 0.95)或出错

版本与发布记录

@blazediff/cli 共发布 34 个版本,首次发布于 2025/12/16;过去 12 个月发布了 34 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
6.0.0latest2026/11/053 天前
5.0.52026/10/2612 天前
5.0.42026/08/292 个月前
5.0.32026/08/272 个月前
5.0.22026/08/182 个月前
5.0.12026/08/182 个月前

关于 @blazediff/cli 的常见问题

@blazediff/cli 是什么?

Blazediff 图像比较库的命令行界面

如何安装 @blazediff/cli?

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

@blazediff/cli 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@blazediff/cli 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@blazediff/cli 可以商用吗?

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

@blazediff/cli 的下载量有多少?

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

@blazediff/cli 还在维护吗?

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