构建第一个完整图像 Pipeline
一个生产图像 Pipeline 不只是连续调用几个图像方法。它需要在读取像素之前限制输入，在输出之后验证事实，并把语言绑定（binding）版本、耗时和失败阶段留给日志与监控。
| 阶段 | 需要决定什么 | 最小输出 |
|---|---|---|
| 1. 接收 | 允许的来源、大小和超时 | 输入标识与字节数 |
| 2. 探测 | 格式、尺寸、页数、方向、色彩信息 | 规范化元数据 |
| 3. 归一化 | EXIF Orientation、Alpha、工作色彩空间 | 可预测的内部图像 |
| 4. 变换 | resize/crop 顺序、是否放大、背景策略 | 目标画布 |
| 5. 编码 | 格式、质量、元数据和 Profile 策略 | 原始输出文件 |
| 6. 验证 | 格式、尺寸、页数、文件大小与可重读性 | 验证结果清单 |
前面的 Quickstart 已经跑通其中最小的一条路径：读取测试 JPEG，用 govips 生成不放大的 WebP 缩略图，并核对尺寸、格式、文件大小与工具版本。
这组结果展示了基础缩略图路径；要投入生产环境，还需要补齐下文的不可信输入限制、方向归一化和失败阶段观测。
先探测，再决定
Section titled “先探测，再决定”不要仅根据文件扩展名选择加载器（Loader）。探测得到的格式、尺寸和页数应与业务限制比较；超限输入要在昂贵的完整解码前尽早拒绝。对于动画和多页输入，还要明确处理全部页面、只取第一页，还是直接拒绝。
归一化不是固定模板
Section titled “归一化不是固定模板”在读取得到图像对象（如 govips 的 ImageRef）之后，进入几何变换前，生产实现还要显式决定：
- EXIF Orientation 是否在裁剪前应用；
- 透明像素在缩放或合成前是否需要预乘（premultiply）；
- CMYK 或带 ICC 的输入要转换到哪个目标色彩空间；
- 是否允许放大，以及裁剪超出边界时是报错还是扩展画布。
输出必须可以被验证
Section titled “输出必须可以被验证”写出文件后重新读取文件头（Header），至少核对格式、宽高、通道、页数和文件大小，并确认输出能被再次解码。各语言绑定对编码参数（质量、插值、色彩空间）的默认值可能不同，因此生产环境应针对所使用的入口显式指定关键参数，而不是假设不同入口产生相同结果。
观测失败阶段
Section titled “观测失败阶段”错误日志应区分 probe、load、normalize、transform、encode 和 verify。同时记录语言绑定版本和实际 libvips 版本，避免把 Codec 缺失、输入损坏与参数错误混为一类。
- 先运行15 分钟 Quickstart。
- 用Reader/Writer 流式 I/O查看顺序读取、取消和错误传播。
- 用生产环境里的 govips 生命周期检查启动、关闭和
Close()。 - 用缩放：fit、cover 与裁剪位置确定画布策略。
- 用Bands、Alpha 与透明度补上透明图像的风险模型。