更新记录

1.0.2(2026-11-16)

发版

1.0.1(2026-11-16)

发版

1.0.0(2026-11-16)

发版

查看更多

平台兼容性

云端兼容性

支付宝云 腾讯云 阿里云
√ √ √

uni-app(5.31)

Vue2 Vue3 Chrome Safari app-vue app-nvue Android iOS 鸿蒙
× √ √ √ - - - - -
微信小程序 支付宝小程序 抖音小程序 百度小程序 快手小程序 京东小程序 鸿蒙元服务 QQ小程序 飞书小程序 小红书小程序 快应用-华为 快应用-联盟
√ × - - - - - - - - - -

uni-app x(5.25)

Chrome Safari Android iOS 鸿蒙 微信小程序
- - - - - -

证件照制作 · 微信小程序

手机拍一张,三步出证件照。选规格 → 拍照/相册上传 → 换底色换正装,本地 Canvas 智能抠图,300 DPI 排版图直接送冲印。 无需注册登录,照片全程本地处理,不出设备。

uni-app + Vue3(Composition API)· Pinia · Canvas 2D · Vite CLI · 微信小程序 / H5 双端

小程序码
微信扫码直接体验


线上数据

微信小程序数据助手截图
微信小程序数据助手 · 运营数据截图(2026-10-30)


界面速览

首页
首页 · 拍照 / 相册 / 快捷功能 / 常用尺寸
规格选择
规格选择 · 分类 Tab + 实时搜索
排版打印
排版打印 · 6寸/5寸/A4 · 300 DPI
小程序码
小程序码 · 微信扫码直接体验

功能一览

模块 能力
首页 拍照制作 / 相册上传两大入口,换底色、换服装、排版打印、规格检测快捷功能,常用尺寸直达,最近作品
规格库 本地 specs.json 证件规格数据库:常用 / 证件类 / 考试类 / 签证类 / 其他,实时搜索;每种规格含物理尺寸、像素尺寸、背景要求与适用场景
拍摄 相机实时取景 + 人像参考线,前后摄切换;相册导入
编辑 换底色(预置纯色 + 自定义拾色 + 容差 / 羽化调节)、换正装(男女童 13 套透明 PNG 素材,缩放位移微调)、比例裁剪、亮度 / 对比度 / 饱和度调整
抠图 本地泛洪填充抠图:感知色差公式 + 容差控制 + 边缘羽化,纯前端完成,保护白色衣服与五官不被误伤
手动修复 橡皮擦 / 恢复笔画笔,半径可调,撤销 / 重做全流程支持
规格检测 本地像素尺寸、宽高比、背景色均匀度、人像参考线、清晰度方差五项合规检测
排版打印 6寸(4×6)/ 5寸(3.5×5)/ A4 三种相纸,真实 300 DPI 像素级排版(6寸 = 1200×1800),裁切虚线 + 十字角标,多种布局可选
我的作品 本地历史记录,按规格 / 分类筛选,预览、重新编辑、删除
我的 制作教程、常见问题、隐私说明、清理缓存

核心亮点

  • 隐私优先:无需注册登录、无任何第三方 SDK;抠图全流程在设备本地完成,照片不出设备。
  • 本地智能抠图:泛洪填充 + 感知色差 + 边缘羽化,零延迟可用,头发丝与轮廓在不同底色间自然过渡。
  • 金额级精度排版:排版不是预览图拉伸,而是按 300 DPI 在全像素 Canvas 上真实绘制,冲印不糊。
  • 本地持久化:微信 FileSystemManager(USER_DATA_PATH)+ Storage,作品永久保存在本机沙盒。
  • 一键换正装:13 套透明正装 PNG(男西装 / 衬衫、女装 / 衬衫、儿童),支持缩放与位移微调。

技术架构

小程序端(uni-app / Vue3 / Vite CLI)
  src/
    pages/             11 个页面:index 首页 / specs 规格 / photo 拍摄
                       editor 编辑 / clothes 换装 / check 检测
                       print 排版 / result 完成 / works 作品 / mine 我的
    components/        BottomTabbar / AppHeader / AppIcon / BrushTool /
                       CheckItem / ClothingPanel / ColorPicker /
                       Cropper / PhotoPreview / SpecCard
    stores/photo.js    Pinia 单例:当前规格、底色、抠图参数、服装图层、排版配置
    utils/             纯本地工具层
      background.js      泛洪抠图、感知色差、羽化、底色合成
      canvas.js          Canvas 2D 适配层(微信 / H5 双端)
      clothing.js        正装图层定位与合成
      crop.js            裁剪比例计算与参考线定位
      print.js           300 DPI 纸张排版网格与裁切线绘制
      specCheck.js       规格比对与锐度方差检测
      export.js          相册权限检查与图片保存
      storage.js         本地文件沙盒持久化与缓存清理
      image.js           图像信息读取、RGB / Hex 互转
      localFile.js       本地文件读写封装
    static/data/       specs.json 本地证件规格数据库
    static/clothes/    13 套透明正装 PNG 素材
    styles/            variables.scss(#2679F5 蓝白主题)/ common.scss

uniCloud-alipay/    预留云开发目录(数据库 schema 预留)

数据与安全边界:照片与作品只存设备本地沙盒,全部处理在设备本地完成,不发起任何图片上传。manifest.json 仅申请相机与相册两个权限。


快速开始

1. 安装依赖

npm install --legacy-peer-deps

2. 开发调试(热重载)

npm run dev:mp-weixin
# 产物在 dist/dev/mp-weixin/,微信开发者工具导入该目录,AppID 用测试号或自己的

3. 生产构建

npm run build:mp-weixin   # 产物在 dist/build/mp-weixin/,直接导入微信开发者工具上传
npm run build:h5          # 产物在 dist/build/h5/,任意静态服务器可托管

微信开发者工具:导入 → 项目目录选 dist/build/mp-weixin(或 dist/dev/mp-weixin)→ 确定,即可在模拟器体验完整流程。


配置说明

配置项 位置 说明
小程序 AppID src/manifest.json → mp-weixin.appid 当前为 wxcc14aa2c2b8e8ea3,替换为自己的 AppID
应用 AppID src/manifest.json → appid uni-app 应用标识 __UNI__DA0DF46
相机 / 相册权限 src/manifest.json → mp-weixin.permission 已配置用途描述,微信审核需与实际功能一致
界面截图 CDN https://codesuccess.online/zhengjianzhao-assets/shots/ 43 服务器 /usr/local/nginx/html/zhengjianzhao-assets/shots/,README 在线引用
证件规格库 src/static/data/specs.json 纯 JSON,可自由增删规格,无需改代码
主题色 src/styles/variables.scss #2679F5 蓝白风格
tabBar src/pages.json 原生底部栏:首页 / 规格 / 作品 / 我的

目录结构

├── package.json           项目元信息与构建脚本(Vite CLI)
├── vite.config.js         Vite + @dcloudio/vite-plugin-uni
├── src/                   小程序源码(pages / components / stores / utils / static / styles)
├── dist/                  构建产物(build / dev)
├── uniCloud-alipay/       预留 uniCloud 云开发目录
├── output/                本地接口与模型测试记录
├── docs/preview/          界面截图(本地副本;在线地址 codesuccess.online/zhengjianzhao-assets/shots/)
└── ui/                    设计参考素材

文档

文档 内容
src/static/data/specs.json 本地证件规格数据库(可自由扩展)

项目状态

  • 已上架微信小程序并稳定运营(运营数据见上方截图),微信端 + H5 双端构建通过。
  • 全部页面、组件、规格库、排版算法、本地抠图均已实现,纯前端可独立运行。
  • 上线/二开前需完成:替换 src/manifest.json 中的小程序 AppID 即可。

隐私、权限声明

1. 本插件需要申请的系统权限列表:

相机(实时拍摄证件照);相册(上传人像照片、保存成品照与排版图)。

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

仅采集业务必需数据:相机拍摄或相册上传的人像照片(用于证件照抠图与合成)。抠图默认在设备本地 Canvas 完成;启用云端 AI 抠图时,照片仅上传至使用方自建服务器(RMBG-1.4 推理服务)处理后即用即删,不向任何第三方共享,不用于用户画像,不含广告。

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

无

暂无用户评论。