更新记录
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 即可。

收藏人数:
购买源码授权版(
导入插件并试用
赞赏(0)



下载 15
赞赏 0
下载 35302
赞赏 159
赞赏
京公网安备:11010802035340号