测试方法

证据层级

• 自动化证据：单元测试、集成测试、TypeScript 检查、Lint 和 Astro 生产构建。
• 可复现内容证据：使用项目实际编码器版本处理确定性样本，并在 JSON 中记录准确输出字节数。
• 人工证据：浏览器交互、视觉输出、跨浏览器行为，以及自动化无法完整证明时的网络请求检查。
• 外部事实：引用官方平台文档，并在引用旁记录查询日期和限制。

压缩测试流程

在仓库根目录运行 `corepack pnpm --filter @batchmint/local-engine benchmark:content`。脚本会重新生成两个确定性合成样本，使用项目编码器生成全部输出，并更新公开与源码中的 JSON 报告。

• 不透明样本：1600×1200、JPEG 质量 95 源文件，对比 JPEG 质量 82 和 WebP 质量 82。
• 透明样本：1200×1200、未优化 PNG 源文件，对比 OxiPNG level 2 和保留 Alpha 的 WebP 质量 82。
• 报告测量编码后的文件字节数和相对源文件的体积变化，不测量速度或感知质量。

• 查看实测结果

  可下载源文件和全部输出文件。

• 查看机器可读 JSON

  由同一条基准命令生成。

2026 年 7 月 17 日记录的编码器版本

• JPEG：@jsquash/jpeg 1.5.0，使用 MozJPEG。
• PNG：@jsquash/png 3.1.1 与 @jsquash/oxipng 2.3.0。
• WebP：@jsquash/webp 1.5.0，使用 libwebp。

网络隐私验证

隐私测试会检查工作台构建，并在选择、处理和导出本地测试文件时查看浏览器网络活动。BatchMint 应用请求不得包含所选图片字节、文件名或水印文字，工作台也不得包含 AdSense 站点脚本。HTML、JavaScript、CSS、字体、Service Worker 和编码器资源请求属于预期行为，不代表图片上传。

• 查看隐私模型

  说明哪些数据保留在本地，以及仍可能存在的网络请求。

边界与解释

• 合成样本能让字节结果重复，但不能代表所有照片、插画或电商图片。
• 不同编码器的相同质量数字不代表完全相同的视觉质量，因此不能把它当作通用质量对比。
• 目标体积只能在编码器能力范围内搜索，不能保证每个源文件都达到。
• 平台规则和浏览器能力会变化，正式使用前应重新核对官方要求和当前浏览器。