更新记录

1.0.0（2026-04-19）

v1.0.0 (2026-04-19) - 首次发布 新增功能： ✅ OCR文字识别 支持中/英/日/韩/法/德/俄 7种语言识别 普通精度和高精度双模式 识别结果一键复制 ✅ 证件照制作 AI智能人像抠图 6种标准证件照尺寸（一寸/二寸/护照等） 5种预设背景色 + 自定义颜色 拍照/相册双输入方式 ✅ 图片压缩 本地压缩，不上传服务器 质量滑块实时调节（10-100） 支持jpeg/png/webp格式输出 压缩前后对比展示 技术特性： 基于百度智能云AI服务 uniCloud云函数架构 全平台兼容（iOS/Android/鸿蒙/小程序/H5） 零广告纯净体验 系统要求： HBuilderX 4.45+ uniCloud云服务空间（阿里云或腾讯云） 百度AI API配置

平台兼容性

uni-app(4.51)

AI智能工具箱 - 插件使用说明

插件概述

uni-ai-toolbox 是一款基于百度AI的一站式图片处理工具箱，包含证件照制作、OCR文字识别、图片压缩三大核心功能。支持iOS、Android、鸿蒙、微信小程序、H5等全平台。

一、环境准备

1.1 uniCloud配置

本插件依赖 uniCloud云函数，使用前需完成以下配置：

1. 在HBuilderX中创建uniCloud项目（选择阿里云或腾讯云）
2. 右键项目根目录 → 关联云服务空间 → 选择或创建云服务空间
3. 上传云函数：
   • 右键 uni_modules/uni-ai-toolbox/uniCloud/cloudfunctions/ai-ocr → 上传部署
   • 右键 uni_modules/uni-ai-toolbox/uniCloud/cloudfunctions/ai-id-photo → 上传部署

1.2 百度AI API配置

本插件使用百度智能云AI服务，需配置以下环境变量：

配置步骤：

1. 登录百度智能云控制台
2. 进入「文字识别」或「人像分割」服务
3. 创建应用，获取 API Key 和 Secret Key
4. 在uniCloud云函数中配置环境变量：
   • 云服务空间 → 云函数 → ai-ocr → 详情 → 环境变量
   • 添加 BAIDU_API_KEY 和 BAIDU_SECRET_KEY

免费额度说明：

• OCR文字识别：每月1000次免费调用
• 人像分割：每月500次免费调用
• 超出后按次计费，详情见百度智能云官网

二、组件使用说明

2.1 OCR文字识别组件 <ai-ocr>

功能： 将图片中的文字提取为可编辑文本

基础用法：

<template>
  <ai-ocr 
    @result="onOcrResult"
    @error="onOcrError"
  />
</template>

<script>
export default {
  methods: {
    onOcrResult(data) {
      console.log('识别结果:', data.text)
      console.log('详细数据:', data.words)
    },
    onOcrError(err) {
      console.error('识别失败:', err)
    }
  }
}
</script>

Props属性：

Events事件：

支持语言：

• 中文（CHN_ENG）
• 英文（ENG）
• 日语（JAP）
• 韩语（KOR）
• 法语（FRE）
• 德语（GER）
• 俄语（RUS）

高精度模式说明：

• 普通模式：速度快，适合清晰文档
• 高精度模式：识别率更高，适合模糊图片或复杂排版

2.2 证件照制作组件 <ai-id-photo>

功能： AI智能抠图，一键生成标准证件照

基础用法：

<template>
  <ai-id-photo 
    :bg-colors="['#FFFFFF', '#438EDB', '#FF0000']"
    :default-width="295"
    :default-height="413"
    @success="onPhotoSuccess"
    @error="onPhotoError"
  />
</template>

<script>
export default {
  methods: {
    onPhotoSuccess(data) {
      console.log('证件照URL:', data.imageUrl)
      console.log('云存储ID:', data.fileID)
    },
    onPhotoError(err) {
      console.error('处理失败:', err)
    }
  }
}
</script>

Props属性：

Events事件：

内置尺寸规格：

背景色推荐：

• 白色（#FFFFFF）：通用证件照
• 蓝色（#438EDB）：学历证书、简历
• 红色（#FF0000）：保险单、结婚证

2.3 图片压缩组件 <ai-compress>

功能： 本地图片压缩，支持质量调节和格式转换

基础用法：

<template>
  <ai-compress 
    :default-quality="80"
    :default-max-size="1024"
    :default-format="jpeg"
    @compressed="onCompressed"
    @error="onError"
  />
</template>

<script>
export default {
  methods: {
    onCompressed(data) {
      console.log('压缩后路径:', data.path)
      console.log('压缩率:', data.ratio + '%')
    },
    onError(err) {
      console.error('压缩失败:', err)
    }
  }
}
</script>

Props属性：

Events事件：

技术说明：

• 压缩过程在本地完成，不上传服务器
• 使用 uni.compressImage API实现
• iOS/Android支持所有格式
• 小程序部分格式有限制

三、云平台兼容性

3.1 支持的云服务商

3.2 各平台兼容性说明

3.3 小程序域名白名单配置

使用OCR和证件照功能需在微信公众平台配置域名白名单：

1. 登录微信公众平台 → 开发 → 开发管理
2. 服务器域名 → request合法域名
3. 添加：https://aip.baidubce.com
4. download域名需添加你的uniCloud域名

四、常见问题

Q1: OCR识别返回错误怎么办？

检查以下配置：

1. 云函数是否正确上传部署
2. 百度API Key/Secret Key是否配置
3. 百度AI服务是否开通
4. 云服务空间是否有余额（如使用付费版）

Q2: 证件照生成失败？

常见原因：

1. 图片中未检测到人脸
2. 图片质量太差/模糊
3. 百度人像分割服务额度用尽

Q3: 小程序调用失败？

需配置域名白名单：

1. request域名：https://aip.baidubce.com
2. download域名：你的uniCloud域名

Q4: 压缩后图片质量不满意？

可调节压缩质量参数（quality），建议：

• 高质量图片：80-100
• 普通图片：60-80
• 极限压缩：40-60

Q5: 如何获取百度AI免费额度？

1. 注册百度智能云账号
2. 进入文字识别/人像分割控制台
3. 创建应用即可获得免费额度
4. 每月自动刷新额度

五、技术支持

• 问题反馈：通过DCloud插件市场留言
• 更新通知：关注插件市场更新日志
• 功能建议：欢迎提出新功能需求

版本：1.0.0
更新日期：2026-04-19
兼容版本：HBuilderX 4.45+