欢迎使用Markdown编辑器本文详细介绍如何在微信小程序中实现一个完整的AI颜值分析工具,涵盖技术选型、人脸检测与468关键点定位、面部对称性与三庭五眼比例分析算法、轻量级肤质评估模型部署、隐私保护设计及性能优化全流程。文中方案已落地为微信小程序「形象分析助手」,所有推理在端侧完成,不上传任何用户照片,可作为微信生态内隐私合规的AI图像应用开发参考。

一、引子:为什么要在小程序里做端侧AI颜值分析
当前市面上多数颜值测试工具依赖云API,用户照片需要上传至服务器。这带来两个问题:一是隐私风险——用户无法确定照片是否被存储或滥用;二是延迟高、成本不可控。

形象分析助手这款小程序的核心差异点在于:所有计算均在微信客户端本地完成,照片不出设备,分析后自动释放,不存储、不上传、不用于训练。 技术上,这需要将深度学习模型部署在小程序的WebGL后端,并优化到能在低端机型上流畅运行。

本文将从0到1拆解实现方案,无论你是想复刻一个类似功能,还是单纯想了解端侧推理在微信生态里的落地细节,这篇文章都能给你一些参考。文末提供小程序体验入口。

二、整体架构与技术选型
开发环境:

微信小程序原生框架

微信开发者工具 Stable Build

tfjs-wechat 插件(微信官方适配的TensorFlow.js小程序版)

部署模型:BlazeFace + face-landmarks-detection(468关键点)+ 自训练肤质分析CNN

技术架构图(简略版):

text
[用户拍照/选图]
→ [图片预处理(缩放+方向校正)]
→ [BlazeFace人脸检测]
→ [468点关键点定位]
→ [多维度分析:对称性/比例/肤质]
→ [生成描述式报告]
→ [报告渲染 + 自动清理临时图片]
选型考量
方案 优势 劣势 是否采用
云API(百度/腾讯) 开发快,精度高 照片上传服务器,隐私风险高,调用成本累积 ❌
TFLite模型 + tfjs-wechat 全程本地推理,隐私安全,无调用成本 模型需量化,兼容性需适配 ✅
微信原生Vision Kit 无需额外插件 关键点仅提供106点,维度不足,不支持自定义分析逻辑 ❌
最终选择TFLite模型 + tfjs-wechat,关键模型全部转化为INT8量化版本,在精度损失可控的前提下大幅降低计算时间和内存开销。

三、核心步骤一:图片采集与预处理
3.1 照片获取
利用微信小程序的 组件或 wx.chooseImage API:

javascript
// 拍摄模式

// 相册选取
wx.chooseImage({
count: 1,
sizeType: [‘compressed’],
sourceType: [‘album’],
success(res) {
const tempFilePath = res.tempFilePaths[0];
preprocessImage(tempFilePath);
}
});
3.2 EXIF方向问题——第一个坑
部分安卓机拍照后在Canvas绘制时方向不正确。必须根据EXIF的Orientation值旋转图片。

javascript
function fixOrientation(imagePath) {
return new Promise((resolve) => {
wx.getImageInfo({
src: imagePath,
success(info) {
const canvas = wx.createOffscreenCanvas({
width: info.width,
height: info.height,
type: ‘2d’
});
const ctx = canvas.getContext(‘2d’);
// 根据 orientation 调整绘制
const orientation = info.orientation || ‘up’;
switch (orientation) {
case ‘right’: ctx.rotate(90 * Math.PI / 180); break;
case ‘left’: ctx.rotate(-90 * Math.PI / 180); break;
case ‘down’: ctx.rotate(180 * Math.PI / 180); break;
default: break;
}
ctx.drawImage(imagePath, 0, 0);
canvas.toDataURL({ success: (res) => resolve(res.data) });
}
});
});
}
3.3 尺寸压缩与亮度检测
模型输入固定为256×256或320×320,所以需要将用户图片等比缩放后中心裁剪:

javascript
function resizeAndCrop(imageData, targetSize = 320) {
const canvas = wx.createOffscreenCanvas({ width: targetSize, height: targetSize, type: ‘2d’ });
const ctx = canvas.getContext(‘2d’);
const scale = Math.max(targetSize / imageData.width, targetSize / imageData.height);
const sw = targetSize / scale, sh = targetSize / scale;
const sx = (imageData.width - sw) / 2, sy = (imageData.height - sh) / 2;
ctx.drawImage(imageData, sx, sy, sw, sh, 0, 0, targetSize, targetSize);
return canvas;
}
同时检测平均亮度,若Y通道均值低于40,直接提示“光线不足,建议在自然光下拍摄”,避免低质量输入影响后续分析。

四、核心步骤二:人脸检测与468关键点定位
4.1 加载量化模型
将官方BlazeFace和face-landmarks-detection的SavedModel转换为TFLite格式并INT8量化,体积从2.3MB压缩至780KB。通过CDN托管:

javascript
import * as tflite from ‘tfjs-tflite’;

let detectModel, landmarkModel;

async function loadModels() {
detectModel = await tflite.loadTFLiteModel(
‘https://your-cdn.com/blazeface_int8.tflite’
);
landmarkModel = await tflite.loadTFLiteModel(
‘https://your-cdn.com/face_landmark_468_int8.tflite’
);
}
模型加载时机:在App.onLaunch中提前预加载,进入拍照页时模型已就绪。

4.2 推理获取人脸框与关键点
javascript
async function detectFaceAndLandmarks(canvas) {
const ctx = canvas.getContext(‘2d’);
const imageData = ctx.getImageData(0, 0, canvas.width, canvas.height);

// 人脸检测
const faceResult = await detectModel.predict(preprocessForBlaze(imageData));
const { boxes, scores } = parseFaceResult(faceResult);
if (scores[0] < 0.7) throw new Error(‘未检测到清晰人脸’);

// 扩展人脸框(包含更多面部区域)
const box = expandBox(boxes[0], 1.3);

// 裁剪人脸区域并送入关键点模型
const faceCanvas = cropFace(canvas, box);
const landmarkResult = await landmarkModel.predict(preprocessForLandmark(faceCanvas));

// 解析出468个(x,y,z)点
const landmarks = parseLandmarks(landmarkResult);
return landmarks;
}
性能提示:每次推理后必须手动释放tensor,否则连续使用会OOM:

javascript
imageTensor.dispose();
resultTensor.dispose();
五、核心步骤三:多维度分析算法实现
得到468个关键点后,便能计算各项面部特征。

5.1 面部对称性量化
通过计算左右对称点对的欧氏距离偏差(镜像对称):

javascript
function calculateSymmetry(landmarks) {
const symmetryPairs = [
[33, 263], [133, 362], [61, 291], // 眼角
[40, 270], [78, 308], // 眉峰
[57, 287], [48, 278] // 嘴角
];

let totalDeviation = 0;
const midX = (landmarks[168].x + landmarks[9].x) / 2; // 眉心与鼻尖中线

for (const [leftIdx, rightIdx] of symmetryPairs) {
const left = landmarks[leftIdx];
const right = landmarks[rightIdx];
const mirrorRightX = 2 * midX - right.x;
const dist = Math.sqrt((left.x - mirrorRightX) ** 2 + (left.y - right.y) ** 2);
totalDeviation += dist;
}

const avgDev = totalDeviation / symmetryPairs.length;
// 归一化映射到0~1的对称性分数(偏差越小分数越高)
const symmetryScore = Math.max(0, 1 - avgDev * 2.5);
return symmetryScore.toFixed(2);
}
注意:这里归一化系数2.5是经验值,可根据实际图像尺寸调整。实际项目中我们用左右内眼角距离作为基准归一化,以消除不同人脸尺寸的影响。

5.2 三庭五眼比例分析
利用特定关键点定位发际线、眉心、鼻底、下巴(需结合面部姿态估计校正,这里简化为正脸假设):

上庭高:发际线(10) → 眉心(151) 垂直像素距离

中庭高:眉心(151) → 鼻底(94)

下庭高:鼻底(94) → 下巴(152)

javascript
function getVerticalDistance(p1, p2) {
return Math.abs(p1.y - p2.y);
}

const upper = getVerticalDistance(landmarks[10], landmarks[151]);
const middle = getVerticalDistance(landmarks[151], landmarks[94]);
const lower = getVerticalDistance(landmarks[94], landmarks[152]);
const faceTotal = upper + middle + lower;

const upperRatio = (upper / faceTotal).toFixed(2);
const middleRatio = (middle / faceTotal).toFixed(2);
const lowerRatio = (lower / faceTotal).toFixed(2);
与标准1/3比较,偏差越小比例越均衡。报告中呈现为“上庭稍短”、“中庭标准”等自然语言描述,而非冰冷数字。

5.3 肤质分析(独立轻量CNN)
在468个关键点定位出的额头区域(点10、151、107、336围成)和面颊区域(左右分别取)进行裁剪,输入一个三分类MobileNetV2轻量模型,预测:

粗糙度(0平滑~1极度粗糙)

光泽度(0哑光~1高光)

均匀度(0均匀~1色斑/痘印明显)

该模型使用自建数据集(约2万张,覆盖多种肤色和光照)训练,INT8量化后仅340KB。推理时间约80ms。

javascript
async function analyzeSkin(landmarks, faceCanvas) {
const foreheadROI = extractROI(faceCanvas, landmarks[10], landmarks[151],
landmarks[107], landmarks[336]);
const cheekLROI = extractROI(faceCanvas, landmarks[234], landmarks[118],
landmarks[347], landmarks[101]);
const cheekRROI = extractROI(faceCanvas, landmarks[454], landmarks[347],
landmarks[118], landmarks[330]);

const skinModel = await loadSkinModel();
const result = await skinModel.predict(preprocessBatch([foreheadROI, cheekLROI, cheekRROI]));
return avgSkinResult(result);
}
六、报告生成:为什么用“描述”而不是“打分”
拿到的各个维度的数值,在呈现时进行定性化转换。例如对称性分数0.92 → 86分,但文案写:“您面部左右对称性非常好,尤其眼周区域非常平衡。” 这比一个冷冰冰的86分更能让用户感受到“认识自己”而非“被评判”。

报告的尾部固定声明:“分析过程仅在本地完成,照片不会被存储或上传。结果由AI生成,仅供娱乐与参考。”

七、隐私保护:本地推理才是硬道理
形象分析助手在技术上保证:

无任何上传图片的网络请求(可抓包验证)。

分析完成后立即调用 wx.removeSavedFile 或 fs.unlink 清除临时文件。

localStorage 中的分析报告可手动删除,“删除”即不可恢复。

隐私政策中写明“照片三不原则”——不存储、不上传、不用于模型训练。

这几点打出来不是为了PR,而是技术上真的能做到。一个只靠云API的产品永远没法给出这个承诺。

八、性能优化手册
从初版到上线,经历了三次性能迭代,关键数据如下:

优化点 优化前 优化后 手段
模型下载时间 5.2s 0.8s INT8量化 + CDN预热 + 分包预下载
首次推理耗时 550ms 180ms 输入降分辨率320×320 + WebGL预热
内存占用峰值 210MB 92MB 即时dispose tensor + 模型按需加载
冷启动到出报告 9s 3.4s 模型预加载 + 图片处理并行化
包体积 4.8MB 1.9MB 分包架构,模型托管CDN
核心经验:

能量化的模型一律INT8,精度损失不超过2%,速度提升50%以上。

Tensor生命周期严格管理,内存泄漏是端侧推理的头号杀手。

低端机降级:对RAM<2GB的设备,降低输入分辨率至192×192,并跳过耗时的肤质分析(给出“基础分析模式”)。

九、避坑指南(附解决方案)
iOS WKWebView中WebGL上下文丢失——监听 wx.onMemoryWarning 并在内存告警时释放所有tensor,重试推理。

安卓部分机型Canvas不支持SVG滤镜——统一使用2D API进行绘制,不依赖CSS滤镜。

tfjs-wechat插件初始加载超时——设置15秒超时并给出友好提示“模型加载中,请稍候”,而非白屏。

用户摘眼镜后识别率骤降——在模型训练数据中增加眼镜/无眼镜混合样本,提升鲁棒性。

十、写在最后
AI不应该成为制造容貌焦虑的工具。形象分析助手从设计之初就坚持“描述事实,而非制造标准”,让用户通过数据了解自己的面部特征,而不是被一个评分数字束缚。技术上,端侧AI推理让隐私得到真正保障,这也是我个人最自豪的一点。

如果你对实现细节感兴趣,欢迎搜索微信小程序「形象分析助手」体验,也期待在评论区交流技术问题——包括但不限于模型选型、量化技巧、端侧部署踩坑等,我会逐一回复。

你好! 这是你第一次使用 Markdown编辑器 所展示的欢迎页。如果你想学习如何使用Markdown编辑器, 可以仔细阅读这篇文章,了解一下Markdown的基本语法知识。

新的改变

我们对Markdown编辑器进行了一些功能拓展与语法支持,除了标准的Markdown编辑器功能,我们增加了如下几点新功能,帮助你用它写博客:

  1. 全新的界面设计 ,将会带来全新的写作体验;
  2. 在创作中心设置你喜爱的代码高亮样式,Markdown 将代码片显示选择的高亮样式 进行展示;
  3. 增加了 图片拖拽 功能,你可以将本地的图片直接拖拽到编辑区域直接展示;
  4. 全新的 KaTeX数学公式 语法;
  5. 增加了支持甘特图的mermaid语法1 功能;
  6. 增加了 多屏幕编辑 Markdown文章功能;
  7. 增加了 焦点写作模式、预览模式、简洁写作模式、左右区域同步滚轮设置 等功能,功能按钮位于编辑区域与预览区域中间;
  8. 增加了 检查列表 功能。

功能快捷键

撤销:Ctrl/Command + Z
重做:Ctrl/Command + Y
加粗:Ctrl/Command + B
斜体:Ctrl/Command + I
标题:Ctrl/Command + Shift + H
无序列表:Ctrl/Command + Shift + U
有序列表:Ctrl/Command + Shift + O
检查列表:Ctrl/Command + Shift + C
插入代码:Ctrl/Command + Shift + K
插入链接:Ctrl/Command + Shift + L
插入图片:Ctrl/Command + Shift + G
查找:Ctrl/Command + F
替换:Ctrl/Command + G

合理的创建标题,有助于目录的生成

直接输入1次#,并按下space后,将生成1级标题。
输入2次#,并按下space后,将生成2级标题。
以此类推,我们支持6级标题。有助于使用TOC语法后生成一个完美的目录。

如何改变文本的样式

强调文本 强调文本

加粗文本 加粗文本

标记文本

删除文本

引用文本

H2O is是液体。

210 运算结果是 1024.

插入链接与图片

链接: link.

图片: Alt

带尺寸的图片: Alt

居中的图片: Alt

居中并且带尺寸的图片: Alt

当然,我们为了让用户更加便捷,我们增加了图片拖拽功能。

如何插入一段漂亮的代码片

博客设置页面,选择一款你喜欢的代码片高亮样式,下面展示同样高亮的 代码片.

// An highlighted block
var foo = 'bar';

生成一个适合你的列表

  • 项目
    • 项目
      • 项目
  1. 项目1
  2. 项目2
  3. 项目3
  • 计划任务
  • 完成任务

创建一个表格

一个简单的表格是这么创建的:

项目 Value
电脑 $1600
手机 $12
导管 $1

设定内容居中、居左、居右

使用:---------:居中
使用:----------居左
使用----------:居右

第一列 第二列 第三列
第一列文本居中 第二列文本居右 第三列文本居左

SmartyPants

SmartyPants 是一个文本转换工具,主要功能是将普通的 ASCII 标点符号自动转换为更美观的印刷体标点符号。例如:

原始符号 转换后 说明
"引号" “引号” 直引号变弯引号
'单引号' ‘单引号’ 直单引号变弯单引号
-- 两个连字符变短破折号
--- 三个连字符变长破折号
... 三个点变省略号

创建一个自定义列表

Markdown
Text-to- HTML conversion tool
Authors
John
Luke

如何创建一个注脚

一个具有注脚的文本。2

注释也是必不可少的

Markdown将文本转换为 HTML

KaTeX数学公式

您可以使用渲染LaTeX数学表达式 KaTeX:

Gamma公式展示 Γ ( n ) = ( n − 1 ) ! ∀ n ∈ N \Gamma(n) = (n-1)!\quad\forall n\in\mathbb N Γ(n)=(n1)!nN 是通过欧拉积分

Γ ( z ) = ∫ 0 ∞ t z − 1 e − t d t   . \Gamma(z) = \int_0^\infty t^{z-1}e^{-t}dt\,. Γ(z)=0tz1etdt.

你可以找到更多关于的信息 LaTeX 数学表达式here.

新的甘特图功能,丰富你的文章

2014-01-07 2014-01-09 2014-01-11 2014-01-13 2014-01-15 2014-01-17 2014-01-19 2014-01-21 已完成 进行中 计划一 计划二 现有任务 Adding GANTT diagram functionality to mermaid
  • 关于 甘特图 语法,参考 这儿,

UML图表

可以使用UML图表进行渲染,例如下面产生的一个序列图:

王五 李四 张三 王五 李四 张三 李四想了很长时间, 文字太长了 不适合放在一行. 你好!李四, 最近怎么样? 你最近怎么样,王五? 我很好,谢谢! 我很好,谢谢! 打量着王五... 很好... 王五, 你怎么样?
  • 关于 UML图表 语法,参考 这儿,

流程图

链接

长方形

圆角长方形

菱形

  • 关于 Mermaid 语法,参考 这儿,

FLowchart流程图

我们依旧会支持flowchart.js的流程图语法:

Created with Raphaël 2.3.0 开始 我的操作 确认? 结束 yes no
  • 关于 Flowchart流程图 语法,参考 这儿.

导出与导入

导出

如果你想尝试使用此编辑器, 你可以在此篇文章任意编辑。当你完成了一篇文章的写作, 在上方工具栏找到 文章导出 ,生成一个.md文件或者.html文件进行本地保存。

导入

如果你想加载一篇你写过的.md文件,在上方工具栏可以选择导入功能进行对应扩展名的文件导入,
继续你的创作。


  1. mermaid语法说明 ↩︎

  2. 注脚的解释 ↩︎

Logo

AtomGit 是由开放原子开源基金会联合 CSDN 等生态伙伴共同推出的新一代开源与人工智能协作平台。平台坚持“开放、中立、公益”的理念,把代码托管、模型共享、数据集托管、智能体开发体验和算力服务整合在一起,为开发者提供从开发、训练到部署的一站式体验。

更多推荐