更新记录

1.0.0（2026-11-05） 下载此版本

1.0.0

• 首个版本：compress（质量阶梯逼近目标体积）、batchCompress（并发池+进度）、watermark（九宫格布局纯函数）、convertFormat、thumbnail
• 压缩结果比原图大时如实回退原图（kept:'original'），绝不交出更差的产物

平台兼容性

pk-image 图片套件

图片压缩、批量并发、目标体积逼近、文字水印九宫格、格式转换、缩略图。压缩无效自动回退原图，绝不交出更差的产物。

5 分钟接入

import imgkit from '@/uni_modules/pk-image/js_sdk/index.js';

// 基础压缩（质量 80，长边限 1080）
const r = await imgkit.compress({ src: tempFilePath, quality: 80, maxSide: 1080 });
// → { ok, path, bytes, originalBytes, ratio: 35, kept:'compressed', human:{before:'3.2MB', after:'1.1MB'} }

// 目标体积逼近：自动质量阶梯迭代到 ≤200KB
await imgkit.compress({ src, targetKB: 200, maxSide: 1600 });

// 批量并发（并发 3，进度回调）
await imgkit.batchCompress(paths, {
  concurrency: 3,
  onProgress: (done, total, r) => console.log(`${done}/${total}`, r.ratio + '%')
});

// 缩略图（语义糖：maxSide 200 / quality 70 / targetKB 50）
await imgkit.thumbnail({ src });

// 文字水印（九宫格布局，canvas 合成）
const wm = await imgkit.watermark({ src, text: '@我的水印', position: 'bottom-right' });
// 返回 layout.draw(ctx) 供页面 canvas 执行（见 demo 页）

API 全表

compress 返回

watermark 返回

layout: { anchor:{x,y}, fontSize, color, draw(ctx) }——在页面 canvas 上下文里执行 layout.draw(ctx) 即完成绘制（demo 页有完整示例）。

压缩策略（core.js 纯函数，可单测）

1. fitSize：contain 等比缩放，只缩不放
2. nextQuality：目标体积未达 → 质量 −15 重试（下限 40，≤3 轮）；远低于目标 → +10 回升
3. compareResult：产物 ≥ 原图 → 回退原图

错误码

FAQ

Q: 压缩后画质很差？ 默认 quality 80 + 只缩不放；要控体积用 targetKB 让阶梯自动找平衡点，避免一次打到低质量。

Q: 小程序上 compressedWidth 不生效？ 部分端版本差异，SDK 会回退 canvas 重采样；demo 页标注了各端实测矩阵。

Q: 大图会 OOM 吗？ App/小程序走原生 compressImage 不占 JS 内存；canvas 通道先降采样再绘制。