# @blazediff/cli 中文文档

规范地址：https://npmcn.com/package/%40blazediff/cli/

版本：6\.0\.0
npm 元数据更新时间：2026-11-05T04:23:41.075Z
中文译文更新时间：2026-11-08T06:31:38.885Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40blazediff/cli
原文对照：https://npmcn.com/package/%40blazediff/cli/?lang=original
项目主页：https://blazediff.dev/
源码仓库：https://github.com/teimurjan/blazediff

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：2.8 MB，15 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：9 个
- 首次发布：2025-12-16T10:49:02.661Z
- 最新版本发布：2026-11-05T04:23:40.734Z
- 近 30 天下载量：2598（2026-10-09 至 2026-11-07，npm 官方下载统计）
- 已发布版本数：34（近 12 个月 34 个）

## 中文简介

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

## 安装

```sh
npm install @blazediff/cli
```

也可以使用：`pnpm add @blazediff/cli`、`yarn add @blazediff/cli`、`bun add @blazediff/cli`

## README

# @blazediff/cli (英语)

[![npm bundle size](https://img.shields.io/npm/unpacked-size/%40blazediff%2Fcli?style=for-the-badge)](https://www.npmjs.com/package/@blazediff/cli) [![NPM Downloads](https://img.shields.io/npm/dy/%40blazediff%2Fcli?style=for-the-badge)](https://www.npmjs.com/package/@blazediff/cli)

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

## 安装

```bash
npm install -g @blazediff/cli
```

## 使用量

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

## 图标

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

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

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

```bash
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`。 。 。 .

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

### `gmsd` - 渐变相相近

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

```bash
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` - 结构相似性指数

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

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

**选项 :**

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

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

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

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

**选项 :**

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

### `hitchhikers-ssim` - 快一点

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

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

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

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

```bash
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 .

## 实例

```bash
# 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 是什么？

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 和提交记录判断。