更新记录

1.1.0（2026-09-29）

修改说明

1.0.9（2026-09-29）

• 修复裁剪默认剪切框不居中：App 端 image @load 返回的 e.detail.width/height 是原图像素尺寸，直接当渲染坐标导致框偏移到图片外；改为以裁剪舞台容器 boundingClientRect 的真实渲染宽高作为显示坐标系，默认框居中、可正常拖拽，输出仍按原图像素 1:1 换算

平台兼容性

uni-app(3.8.4)

图片全能处理工具 Pro（mj-image-toolkit-pro）

纯 JS 像素级图片处理组件，Android / iOS / 鸿蒙三端通用，不依赖 canvas 输出，处理结果尺寸精确可控。

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

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

功能

技术特点

• 纯 JS 像素处理：内置 PNG（UPNG）与 JPEG（jpeg-js）编解码器，图片解码 → 像素运算 → 重新编码，全程不经过 canvas 输出
• 尺寸精确：输出宽高由像素数组决定，与屏幕像素密度 / canvas 渲染尺寸完全无关，杜绝"压缩变正方形"等问题
• 三端通用：Android / iOS / 鸿蒙 App 均为 JS 引擎，同一份代码即可运行
• 本地处理：全部处理在设备本地完成，无任何网络请求，不采集任何数据

使用方式

1. 安装

将 uni_modules/mj-image-toolkit-pro 目录复制到项目的 uni_modules 目录下（或使用 HBuilderX 插件市场一键导入）。

2. 引入组件

在 pages.json 的对应页面 easycom 规则自动生效（uni_modules 组件无需手动注册），页面中使用：

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

3. 运行环境

• HBuilderX 4.x 及以上
• uni-app vue3 项目
• App 端（Android / iOS / 鸿蒙）：本地像素处理，无需配置原生环境

注意事项

• 本组件面向 App 三端；Web / 小程序端请使用配套插件 mj-image-toolkit（web 版）
• 文字水印在 App 端使用离屏画布渲染文字位图后读取像素，仅用于文字栅格化，主图处理与输出仍为纯像素方案
• 处理过程在设备本地完成，无网络请求、不采集任何数据

更新日志

• v1.0.0：首个版本，支持全部 8 项功能