更新记录

1.0.2（2026-09-29）

修改说明

1.0.1（2026-09-29）

修改说明

1.0.0（2026-09-29）

初次发布

平台兼容性

uni-app(3.8.4)

其他

mj-image-toolkit 图片全能处理工具

一站式图片处理插件：压缩 / 裁剪 / 九宫格 / 圆角 / 滤镜 / 拼图 / 水印

• 纯 JavaScript + Canvas 实现，零原生依赖、零网络请求，图片仅在设备本地处理
• 三端通：App（iOS / Android）、H5、小程序，鸿蒙（uni-app 适配）同样可用
• 标准基座直接运行，无需自定义基座、无原生打包烦恼
• 提供开箱即用的可视化组件 + 可编程调用 API，两种用法任选

配套插件（三端互通跳转）

三个插件功能一致，分别适配 Web / App / 小程序，按运行平台选用，点击插件名即可互相跳转。

功能清单

快速使用（组件方式）

在页面中直接引入组件：

<template>
  <mj-image-toolkit />
</template>

<script setup>
import MjImageToolkit from '@/uni_modules/mj-image-toolkit/components/mj-image-toolkit/mj-image-toolkit.vue'
</script>

快速使用（API 方式）

import { compress, cutNine, addTextWatermark, saveToAlbum } from '@/uni_modules/mj-image-toolkit/utils/image-tools.js'

// 压缩
const dataUrl = await compress(src, { quality: 70, maxWidth: 1080 })

// 切九宫格
const nine = await cutNine(src) // [{index, row, col, dataUrl}...]

// 文字水印
const out = await addTextWatermark(src, { text: '2026-09-28', position: 'br', opacity: 0.6 })

// 保存到相册（App/小程序）或下载（H5）
await saveToAlbum(out, 'result.jpg')

API 一览

position 取值：tl / tc / tr / ml / mc / mr / bl / bc / br（九宫格位置）

保存相册权限

• App(Android)：manifest 勾选「读写手机存储」权限
• App(iOS)：manifest 勾选「相册」权限（NSPhotoLibraryAddUsageDescription）
• H5：直接触发浏览器下载，无需权限
• 小程序：需用户授权相册保存

兼容性

• HBuilderX 4.0+ / uni-app vue3（Vite）
• App 端依赖 webview Canvas 2D（uni.createOffscreenCanvas）
• 小程序依赖基础库 2.7.0+（offscreen canvas 2d）