# @ai-ecoverse/wasm-imagemagick 中文文档

规范地址：https://npmcn.com/package/%40ai-ecoverse/wasm-imagemagick/

版本：7\.1\.2-34-9\.8
npm 元数据更新时间：2026-11-02T17:53:11.881Z
中文译文更新时间：2026-11-06T13:12:44.821Z
软件包许可：ImageMagick AND GPL-2\.0-only WITH Font-exception-2\.0

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

原始 npm 页面：https://www.npmjs.com/package/%40ai-ecoverse/wasm-imagemagick
原文对照：https://npmcn.com/package/%40ai-ecoverse/wasm-imagemagick/?lang=original
项目主页：https://github.com/ai-ecoverse/homescoop/tree/main/packages/imagemagick
源码仓库：https://github.com/ai-ecoverse/homescoop

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

- 包体积（解压后）：9 MB，48 个文件
- TypeScript 类型：未声明
- 运行依赖：0 个
- 首次发布：2026-09-25T12:40:09.778Z
- 最新版本发布：2026-11-02T17:53:11.470Z
- 近 30 天下载量：3155（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：24（近 12 个月 24 个）

## 中文简介

用 ImageMagick 创建、转换和编辑命令行中的图像:magick、转换、识别和摩擦.

## 安装

```sh
npm install @ai-ecoverse/wasm-imagemagick
```

也可以使用：`pnpm add @ai-ecoverse/wasm-imagemagick`、`yarn add @ai-ecoverse/wasm-imagemagick`、`bun add @ai-ecoverse/wasm-imagemagick`

## README

# `@ai-ecoverse/wasm-imagemagick`

[图像映射](https://imagemagick.org/) 7.1.2-34 (中文(简体) ) `magick` CLI 用于 [块状](https://github.com/ai-ecoverse/slicc)这是原地. `convert`, (中文(简体) ), `identify`,以及 `mogrify` 是同一二进制的 argv0 化名.

对于HEIC/HEIF/AVIF,使用 `@ai-ecoverse/wasm-imagemagick-heif` 相反( 可选的) : 它包含一个HEVC解码器。 两者都具有相同的命令,所以安装两个命令中的一个.

代表作有:zlib,jpeg,png,tiff,webp,openjpeg,lcms2,自由型,libxml2.

自7.1.2-32-4以来,所有这些设施都相互连接;7.1.2-32-3和较老的建筑物没有连接 网络p, 自由类型和 libxml2( 无网络P, 无) `-annotate`/TTF,没有 MSL 或内部 SVG渲染器),虽然此列表命名了它们. 没有字体配置 。 自兹 7.1.2-34-9.2 该软件包有一个默认字体URW Nimbus Sans(Helvetica, 从gsfonts in到gsfonts `etc/fonts`),这样 `label:`, (中文(简体) ), `caption:` 财务报告和审定财务报表 `-annotate` 无工作 `-font`。需要其他字体 `-font path/to/font.ttf` (或1型) `.pfb`) (中文(简体) ). 在下方配置 XMLs 飞船 `etc/ImageMagick-7/`; 块状的显示器 `MAGICK_CONFIGURE_PATH` 这样 `colors.xml` 编号 : `policy.xml` 决心. SVG通过内部的MSVG渲染器: `delegates.xml` 没有 inkscape或rsvg-convert 条目,因为两个程序都不存在于 slic.

网络程序无损失( E)`-define webp:lossless=true`) 放弃完全透明的 RGB 像素, 如 libwebp 默认的; 添加 `-define webp:exact=true` 留着它.

WebP最多持有一面16383px. 拒绝扩大图像范围(`width or height exceeds limit`, rc 1) 在输出打开之前, 因此存在 `.webp`,输入到位置 `magick a.webp -resize 200% a.webp` 包含,原为(homescoop#585;直到7.1.2-34-2 被截断了). 将大小调整为最多16383 px,或写出另一种格式.

在现有文件上写入( I)`magick … out.png`, (中文(简体) ), `mogrify`编码为 a 临时文件,仅在图像完成后才替换目标,所以 失败的编码保存文件 。 临时文件放在旁边 目标; 当目录无法写时( 文件您可以在 您可能不会在目录中, 它在第一个 `$MAGICK_TEMPORARY_PATH`, (中文(简体) ), `$TMPDIR` 财务报告和审定财务报表 `/tmp` 并复制到 (homescoop#1656; 7.1.2-34-9.6) 仅尝试了其中第一个 页:1 当无法在任何地方创建临时文件时, 写入被拒绝 与它尝试的目录(`unable to create temporary file 'f.png': tried /nonexistent (No such file or directory), /tmp (Permission denied)`, (中文(简体) ), rc 1),文件保留原样(homescoop#1608;直到7.1.2-34-9.5它) 被写在原地,一个失败的编码切换了它).

`mogrify` 超过几个文件 其余的,当一个失败(丢失, 无法解码、 编码失败或拒绝写入), 报告每次失败以及 出站 1; 失败的文件保留原样( homescoop# 1655; 直到 7.1.2-34-9.6 作为上游,第一次失败之后的每一个文件都默默地 页:1.

```bash
pnpm add -g @ai-ecoverse/wasm-imagemagick
magick -version
convert logo: out.png
```

## 切换

`@ai-ecoverse/wasm-imagemagick` 财务报告和审定财务报表 `@ai-ecoverse/wasm-imagemagick-heif` 为: 具有相同命令的落地选项( e)`magick`, (中文(简体) ), `convert`, (中文(简体) ), `identify`, (中文(简体) ), `mogrify`, (中文(简体) ), `magick-open`) (中文(简体) ). 安装其中之一。 要切换, 删除第一个 :

```bash
pnpm remove -g @ai-ecoverse/wasm-imagemagick-heif
pnpm add -g @ai-ecoverse/wasm-imagemagick
magick -version   # "Delegates (built-in):" lists heic only for wasm-imagemagick-heif
```

在两个软件包都安装后,一个软件包提供共享命令,另一个则提供 被忽略了,没有警告。 原图像放大-heif 宣告 `"slicc": { "replaces": ["@ai-ecoverse/wasm-imagemagick"] }`: 与 硅核1.94.0或以后两者安装后自动取胜 (例如,两者都是全球性的)。 在旧内核上,这个软件包获胜,所以删除 先说.

## 资源限制

默认 `etc/ImageMagick-7/policy.xml` 用于浏览器标签的大小,其中 在2 GiB 时, 运行的配置可以冻结标签 :

| 资源 | 限制 | 为什么 |
| --- | --- | --- |
| 宽度, 高度 | 64000 px (帮助) | 只有荒谬的大小; 区域限制一个图像的成本, 所以18,000x3000全景的作品 |
| 区域 | 64 MP (英语) | a 48 MP 手机相片(8064x6048)或54 MP全景相合 (18000x3000) ; 一个 30000x30000 请求一次失败而不是分配 |
| 内存 | 1536 米贝 | a 48 MP RGB在Q16HDRI中的图像大约为580 MiB;再大小控制源和结果 |
| 地图 | 256 米贝 | 内存标记的缓存也是堆积:内存+地图是1.75 GiB,在建筑的2 GiB最大下 |
| 磁盘 | 0 个 | 磁盘上没有像素缓存 : 在溢出到存储的浏览器中, 48 MP 调整大小需要几分钟; 任何内存一次失败 |

磁盘为 0, MPC( 将像素缓存持续到磁盘文件) 是 政策拒绝:使用 `magick-open` 页:1 `.mpc`. JPEG 2000以上 16名议员 被编码为1024x1024瓦,因此48MP的图像符合堆积.

超过极限, magirk 退出 1 与 `width or height exceeds limit` 或者说 `cache resources exhausted`,用于 `identify -format`,用于解码 图像( 平面) `identify` 财务报告和审定财务报表 `identify -ping` 只读标题). `-limit` 只能降低这些。 直到7.1.2-34-1 宽度和高度为 16,000 px,它拒绝了比它宽的全景(homescoop#445). 为了抬起他们, 使用情况 `magick-open` (同一二进制带有上游的) `policy-open.xml` 从 `etc/ImageMagick-7-open`),或设置 `MAGICK_CONFIGURE_PATH` 转到该目录 (单位:千美元)`magick -list policy` 显示软件包安装地点:

```bash
magick-open -size 70000x500 xc:white long.png   # wider than 64000 px
MAGICK_CONFIGURE_PATH=/path/to/package/etc/ImageMagick-7-open magick ...
```

标签仍然可以毫无限制地耗尽内存.

## 写入 HEIC / AVIF

这个软件包根本没有HEIC、HEIF或AVIF支持;即: `@ai-ecoverse/wasm-imagemagick-heif`它只读它们。 上游 ImageMagick 写作时不会失败 : `magick in.png out.heic` (或 `.heif`, (中文(简体) ), `.avif`)指纹 `no encode delegate for this image format 'HEIC'` 作为 **警告**,写下 输入格式 (PNG) 下 `.heic` 名称和退出 **0 个** (homescoop#940) (英语). 只有内置源如 `gradient:` 以 rc 1 失败. 检查结果为 `identify out.heic`,或写出PNG,JPEG,WebP或TIFF.

## 许可证

`LICENSE` 是图像Magick的. `THIRD-PARTY-NOTICES.md` 持有下列许可证: 图书馆 `bin/magick.wasm` 静态链接,包括GNU libiconv 1.19 (LGPL-2.1-或-后,通过libxml2)和Emscripten的运行时间.

默认字体在 `etc/fonts`Gsfonts 8.11的URW Nimbus Sans, 属于 带有 gsfonts 字体例外的 GNU GPL: 您可以将这些字体放入自己的字体 非 GPL 文档. `etc/fonts/COPYING` 是GPL(第2版),并且 `etc/fonts/README` 是gsfonts的 README, 它声明例外。 这个 `license` 字段名称为 `GPL-2.0-only WITH Font-exception-2.0`,则 最近的 SPDX 表达式; README 的措辞是赠款 .

## 重新连接( LGPL)

`bin/magick.wasm` 将其图书馆静态链接。 重联包,你 需要链接 `magick` 再次反对自己的GNU libiconv(LGPL-2.1-后期, 通过 libxml2 或其任何其它库,是该程序上的一个单独的软件包 同一登记册: [`@ai-ecoverse/wasm-imagemagick-relink`](https://github.com/ai-ecoverse/homescoop/tree/main/packages/imagemagick-relink), (中文(简体) ), 与本软件包的版本相同。 内容 `share/imagemagick/relink/` 持有 magirk的物件,链接的每个静态库,链接的旗帜和 `relink.sh`。 。 。 . 标注4.0.23:

```bash
npm pack @ai-ecoverse/wasm-imagemagick-relink@<this version> && tar xzf ai-ecoverse-wasm-imagemagick-relink-*.tgz
bash package/share/imagemagick/relink/relink.sh /tmp/relinked /path/to/dir/with/your/libs
cp /tmp/relinked/magick /tmp/relinked/magick.wasm node_modules/@ai-ecoverse/wasm-imagemagick/bin/
```

工具箱住在这个软件包外面,以便运行时间下载保持小 (homescoop#593; 7.1.2-34-2至-34-4将其运入) `share/`) (中文(简体) ). 整个来源 构建是 [`packages/imagemagick/build.sh`](https://github.com/ai-ecoverse/homescoop/tree/main/packages/imagemagick) 及其食谱.

## 常见问题

### @ai-ecoverse/wasm-imagemagick 是什么？

用 ImageMagick 创建、转换和编辑命令行中的图像:magick、转换、识别和摩擦\.

### 如何安装 @ai-ecoverse/wasm-imagemagick？

在项目目录运行 npm install @ai-ecoverse/wasm-imagemagick，或使用 pnpm add / yarn add / bun add。

### @ai-ecoverse/wasm-imagemagick 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/ai-ecoverse\_\_wasm-imagemagick 是否存在。

### @ai-ecoverse/wasm-imagemagick 可以商用吗？

@ai-ecoverse/wasm-imagemagick 使用 ImageMagick AND GPL-2\.0-only WITH Font-exception-2\.0 许可。声明的许可为 ImageMagick AND GPL-2\.0-only WITH Font-exception-2\.0，请阅读许可原文确认使用条件。以上为概括，不构成法律意见，请以许可原文为准。

### @ai-ecoverse/wasm-imagemagick 的下载量有多少？

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

### @ai-ecoverse/wasm-imagemagick 还在维护吗？

最新版本 7\.1\.2-34-9\.8 发布于 2026/11/03（5 天前）；至今共发布 24 个版本，其中过去 12 个月发布了 24 个；首次发布于 2026/09/25。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。