xsl/juzi

Files

T

接入本地实时识别和自动三连拍，调整报告裁切、商品跳转、分享标题及居中页眉；完善游客会话、后台渠道隔离、部署脚本与回归测试。

2026-11-04 15:07:51 +08:00

73 KiB

Raw Blame History

2026-11-04 未登录首页重复标题的动态清理

用户反馈未登录登录页出现两个标题。此前仅 JSON defaultTitle=零宽空格，尚未在生命周期调用 setNavigationBar，不能证明首页平台标题已在真机隐藏。本轮在公共页眉包装器的 onLoad／onShow／onReady 调用 my.setNavigationBar({title:零宽空格})，不修改导航背景及返回／胶囊；保留原页面生命周期、Promise 返回值与业务登录流程。回调用独立序号及可见性隔离，离页及旧回调不能更改现页标题状态。

登录页额外启用 nativeTitleFallback：若平台明确拒绝清理（fail、抛错或 Promise reject），隐藏自定义标题文字，保留平台原生标题，避免叠加；该降级情况下不能承诺原生标题居中。非登录页沿用现有居中标题。保留背景品牌图片和登录按钮。新增页面进入／返回时的原生清理、旧回调隔离、拒绝／异常不阻断业务测试，相关回归通过。真机是否实际接受标题清理仍待新预览验证，未将模拟器结果等同真机。

2026-11-04 全部业务页白色页眉标题水平居中

用户要求所有页面顶部标题左右居中。官方 app.json window 与 setNavigationBar 文档未提供标题对齐参数，未使用猜测的 titleAlign 等字段。改为保留原生透明导航及其返回／分享／关闭控件，将原生 defaultTitle 设置为零宽空格，使用公共 components/brand-header.axml + app.acss 显示 1'me肌肤状态检测；标题容器左右对称预留 76px，按全屏中心对齐，白底黑字。

utils/page-header.js 包装业务页注册，保留并调用原生命周期，onLoad／onResize 根据 statusBarHeight（或 safeArea.top）及 titleBarHeight 计算页眉安全区。六页正文／取景根节点避让页眉；档案表单高度收缩使用扣除页眉后的高度，相机初始蒙版尺寸同样扣除页眉，最终仍由已挂载 .cam 真实尺寸校正。分享文字和页眉标题共用同一常量，避免原生空标题影响分享。

完整回归及共享 H5 校验通过，新增实际模板／样式的 320/375/414 三屏宽、20/59px 状态栏检查，覆盖全屏中心、安全区及生命周期保留。淘宝 IDE 编译完成，模拟器实际登录页确认白色页眉标题居中、系统时间和原生右侧胶囊保留且不重叠。截图 deliverables/centered-header-20261104/login-centered.png 为真实 IDE 模拟器运行截图，明确非真机；手机刘海／动态岛安全区效果仍需实测。

官方参考：https://developer.alibaba.com/docs/doc.htm?articleId=117457&docType=1&treeId=785

2026-11-04 分享卡片大标题显式统一

用户确认不带撇号出现在分享卡片大标题。原 app.js 全局 onShareAppMessage 已返回 1'me肌肤状态检测，不能将问题简单归因为源码漏字或断言全局钩子不受支持。官方文档 articleId=118909 明确支持 Page 分享及 App 全局回退。为明确各页输出，六个业务页面均新增页面级 onShareAppMessage，共用 utils/share.js，title 和 desc 均为 1'me肌肤状态检测，path 固定 pages/login/login，不携带报告／照片／档案／会话信息；App 全局钩子也共用此函数。

138 项前端、会话商品、页面交互、拍照测试通过，包括逐页检查分享配置与登录页标题一致、分享对象无私人参数及每次返回独立对象。此次修改不涉及开放平台登记的小程序名称。真机分享卡片最终标题仍需从新预览版本重新分享验证，不能根据代码测试直接声称客户端已修好。

2026-11-04 倒计时锁定，不再因识别变化取消

用户反馈稍动仍取消倒计时，要求移除这项判断。此前 countdownReady 仍检查单脸、源帧边界、分数与新鲜度，本轮移除倒计时阶段的全部姿态／位置／清晰度／人脸数复查。正式 native-face 启动倒计时前保持原检测和稳定门槛；开始后暂停新推理，在途结果不能改变倒计时，到零补光结束直接 takePhoto，不再进入 nativeCaptureWait。离页、切换镜头、身份状态变化、相机停止／故障仍通过会话与序号取消拍摄。移除已不用的 countdownReady 元数据。

专项回归覆盖无新识别结果仍拍摄、角度／位置／置信度／人脸消失不打断倒计时、在途结果不取消，以及离页／切换／故障取消。完整测试及共享 H5 校验通过。H5／备用 AR 判定未改动；手机效果仍需扫码实测。

2026-11-04 推荐商品切换直播间链接

用户提供新链接 https://e.tb.cn/h.jhEroZP98ha4Res，短链页面中的目标 item.taobao.com/item.htm 明确返回 id=1090510453077。更新 config.productItemId 及 productItemIds 三档统一目标，商品为用户提供的“【李佳琦直播间】1'me以我自在有势挺括双仓精华抗皱”。保留推荐评分、文案与 tb.openDetail 交互。106 项会话／商品／拍照适配测试通过，覆盖三档相同商品、重复点击、返回报告及游客直接进入商品。实际手机商品详情打开效果尚未实测。

2026-11-03 两处侧脸缩略图填充缩小 10%

用户要求轮廓／皱纹下面的两张小图脸部缩小。sideThumbnailStyle 的图片缩放由 cover2.8 调整为 cover2.52（原宽高的 90%），未读取尺寸时的 .side-img 兜底 transform 同步为 2.52；画框尺寸、纵向锚点及左右顺序不变。两处共用同一份 sides 数据及样式，原照片与皱纹标注同步缩放。大图仍为 cover*1.12、居中下移图片高度 5%，不受小图调整影响。64 项相关测试通过，缩略图覆盖横／竖／方照片与三个屏幕宽度，并验证相对原填充为 90%。

2026-11-03 侧脸大图缩小 20%，下移调整为 5%

用户要求减小主体：轮廓／皱纹侧脸大图原填充尺寸宽高均乘 0.8（原 cover1.4 改为 cover1.12），保持居中，再下移缩放后图片高度的 5%。大图窗口大小不变，原照片和标注同步使用该矩形；缩略图及拍照流程不变。64 项相关测试通过，包含尺寸为原 80%、5% 下移、跨图片比例及屏幕宽度检查。

2026-11-03 两处侧脸大图统一居中后下移 10%

用户要求皱纹页卡也采用居中裁切，并统一将大图填充区域向下移动图片高度的 10%。轮廓／皱纹侧脸大图共用 rectangle：left=(画框宽-缩放图片宽)/2，top=(画框高-缩放图片高)/2+缩放图片高*0.1。10% 取图片显示高度，不取画框高度；原照片和对应标注共用位置。保留倍率、缩略图和拍照逻辑。64 项相关测试通过，覆盖三种图片比例及三个屏幕宽度、实际 canvas 位移、标注对齐与回调隔离。

2026-11-03 轮廓侧脸放大改为图片居中

用户最新明确要求轮廓小图放大直接截图片中间，替代此前 H5 纵向偏移规则。轮廓大图使用 centerCrop，横纵位置均为（画框尺寸－缩放后图片尺寸）/2，取消向上部取样的偏移；保留原缩放倍率和等比展示。仅轮廓侧脸大图生效，缩略图、皱纹大图及拍照流程不变。新增横／竖／方图居中断言与实际轮廓 canvas 绘制中心验证，64 项报告相关回归通过。手机效果仍待重新编译后确认。

2026-11-03 侧脸放大改用独立位图

用户真机仍反馈轮廓侧脸大图只剩脑门和鼻子；此前浏览器几何一致不能证明淘宝原生组件显示一致，不能据此声称已修复真机问题。本轮按 H5 reportZoomSource 的绘制路径生成独立 JPEG：新增 utils/report-side-zoom.js 和报告专用离屏 canvas（与拍照 canvas 隔离），源照片／该侧标注使用相同矩形绘制；放大层只对生成图片 aspectFit，不再执行原生 overflow 图片裁切。读取尺寸优先 getImageInfo，回退原照片已知尺寸，导出图片的 onLoad 尺寸不能覆盖原图缓存。

生成期间或 API 不支持／导出失败，显示完整原照片 aspectFit，不再回退旧的激进原生裁切。导出有互斥、generation／账号／可见性守卫；旧结果不能重新打开大图。63 项相关测试通过，包括 H5 九种尺寸矩形对照、实际绘制命令与照片／标注对齐、关闭后的回调隔离。截图脚本改为执行实际 bake 模块绘制命令，输出仍明确为浏览器预览，不是真机截图。相机启动和识别本轮未修改；原生显示仍需用户重新编译后实测。

2026-11-03 倒计时后允许正常移动

用户要求取消倒计时后轻微移动导致无法拍摄的规则。正式 native-face 流程开始倒计时前仍按原角度／居中／距离与稳定帧判定；倒计时、补光、快门等待期间改用 countdownReady，只检查清晰的单人面部及其源画面边界，不再因角度、居中或距离偏离原阈值重新计时。新鲜帧 1.5 秒、性能故障停止、离页／切换镜头取消、账号隔离及原生拍照互斥均保留。

新增回归：启动后转头仍完成一次原生拍照、人脸消失取消；保留旧帧与在途识别等待测试。相机／质量／前端相关 97 项测试通过，共享 H5 文件校验通过。修改仅限小程序原生识别链路，未改共享 H5 判定或备用 AR 流程；手机实际效果仍待预览确认。

2026-11-03 扫描品牌黄与侧脸大图原生布局

用户确认相机目前恢复；本轮未修改识别、启动、角度或抓拍逻辑。实时扫描带 RGB 改为品牌黄 245/240/120，动画时序不变。

用户继续反馈侧脸大图裁切靠上。轮廓／皱纹大图改为最终屏幕尺寸的裁切窗口，图片和标注使用相同百分比定位，不再依赖小尺寸 overflow 容器整体 transform 放大。保留 H5 reportZoomSource 的 .5 fillScale 与 .25 contentDown 规则。新增浏览器几何对照覆盖 320/375/414 三宽及竖／横／方形照片九种组合，与 H5 drawImage 矩形误差小于 .15 CSS px；60 项相关测试及共享校验通过。浏览器截图已更新，淘宝真机裁切效果仍需核验，尚不能断言原生 transform 是唯一根因。

2026-11-03 侧脸小图点开后大图比例修正

用户反馈轮廓／皱纹侧脸大图扁平。检查发现原大图在 getImageInfo 不可用或失败时默认 3:4，而 image 使用 scaleToFill；当实际照片比例不同，会产生拉伸。实际手机是否命中此失败分支尚未采到日志，不据此断言全部真机根因。

现小图缓存自然宽高，放大优先复用；尺寸未知时显示 aspectFit，不再猜测 3:4，真实图片 onLoad 后补齐 H5 1.4 倍居中裁切及 .25 高度下移几何。大图基础照片始终等比；原照片与其标注层、左右顺序保持关联。尺寸回调带源图片及 zoom generation／账号校验，关闭或离页后不能重开。59 项相关测试及 H5 共享校验通过。

输出 deliverables/report-side-zoom-20261103/，以项目 contour-demo/left.jpg 和真实 AXML/ACSS／控制器数据生成浏览器投影，并用线上 reportZoomSource 函数生成 H5 对照；明确标记非淘宝真机截图。相机用户补充为恢复按钮常驻且点击也无法拍摄，需继续依据其错误提示定位，不能只归因于测试入口。

轮廓／皱纹侧脸小图裁切还原

已重新读取线上 /state/css/ui-20261012.css 和 /state/js/app.js。H5 两张侧脸缩略图使用居中 cover、translateY(-25%) scale(2.8)，图框 104.35u×92.25u。此前小程序虽使用相同变换字符串，仍依赖原生 image 的 aspectFill/transform 执行效果，用户反馈实际不一致；尚不能确定具体原生差异机制。

现按照片自然尺寸显式计算 cover 后 2.8 倍的宽高，left=(208.7-imageWidth)/2，top=184.5/4-imageHeight/2（rpx），原生 image 使用 scaleToFill 和 transform:none。照片与侧脸皱纹图层共享同一 photoStyle；图片加载和 getImageInfo 均能更新自然尺寸，异步皱纹刷新保留已知几何，离页／旧照片／账号切换的回调不能写入。左右反向顺序、主图、放大图和拍照逻辑保持当前实现。

57 项相关测试通过，包含以真实 H5 CSS 在 Chromium 中计算 cover/transform 作为对照，320/375/414px 屏宽与竖图／横图／方图共 9 组显示几何误差均小于 0.15 CSS px（布局取整差异）。共享 H5 校验通过；淘宝真机实际效果仍待新版普通预览确认。

平台首屏性能检测（任务 20406447）

用户提供版本 0.0.1、2026-11-02 19:53:33 的平台报告：华为 P30/Android，得分 85，明确不通过项为首屏渲染 4565ms（标准 <2000ms）；包体约 1099KiB，RSS 67MB、vmSize 242MB、FPS/CPU 指标均在报告阈值内。仅凭总耗时无法确定唯一瓶颈，不能将相机识别或语音确定为根因。

本轮只优化首屏：登录背景、品牌和游客图标三张 H5 原图以原始字节复制到 taobao/assets/startup（总 131632 字节），登录改用本地相对路径；App.onLaunch 移除无首屏用途的语音播放器创建，voice.play 的现有按需创建逻辑保留。没有修改相机代码、页面样式、登录校验或云环境。公网图片本机抽测约 0.29–0.37 秒，不代表平台 P30 网络性能。

新增回归验证首屏素材与 H5 字节一致、启动不加载语音模块/创建播放器；完整 node test/*.test.cjs 及共享 H5 校验通过。需要重新上传新的开发版本并重跑平台性能检测，尚无优化后真实首屏成绩，不能声称已达到 2000ms。

语音真机定位续查（16:46）

用户再次确认正式拍照仍无语音，拍照正常。IDE Console 仅存 VOICE-20261102-02 的 UNAVAILABLE/category=domain；不能据此断言域名白名单拒绝。VOICE-20261102-04 增加固定 operation 和受限 errorType，将 create、listen_ended/error/play/canplay、set_source、play 分开定位，不记录原始错误或 URL。补充 SDK appxDomain TypeError 回归测试；语音与拍照适配共 78 项测试通过。未修改相机、UI、交互；未声称声音已恢复。

IDE 已生成真机调试码版本 0.1.2611021646.10，待手机重新扫码进入正式拍照页，读取新版本错误日志后继续修复。服务器 MP3 MIME/Range 先前已修复，不再次修改云端设置。

H5 → 淘宝小程序适配实施记录（2026-11-02）

报告返回手势、顶部安全区及列表核对

按用户要求，报告详情页配置 gestureBack:"NO"，保留原生左上角返回；同时开启报告／列表二级页原生导航栏 navigationBarForceEnable:true、transparentTitle:"none"。报告内容顶部原 56rpx 增至 72rpx，并以系统安全区为下限；历史列表保留 H5 的 56rpx 顶距并增加安全区下限。页卡横向手势及页面纵向滚动保持，不用全页 touchmove 拦截来禁用返回。需真机确认宿主执行手势设置及标题位置。

列表页对照 H5 的 history-content、account-status-history、history-count、identity-note、history-item、history-detail、history-retry 源码，主要布局和尺寸一致；淘宝身份和游客仅本次查看提示为既定渠道差异。当前不以“听到咔嚓”认定引导语音通过。用户另反馈调试版相机停在“开启实时相机”，已询问点击后的结果，尚不能判为相机功能回归。

真机 Console 已出现 VOICE-20261102-02 的 error/category=domain。此分类来自筛选后的错误文字，不能单独断言平台域名白名单问题；版本 VOICE-20261102-03 进一步区分 APPX_DOMAIN_CONTEXT、DOMAIN_REJECTED、JS_CONTEXT_ERROR 等安全错误指纹，需后续日志确定。播放器发声仍待验证。

真机仍无声：音频原生就绪事件与资源服务修正

用户已确认正式流程仍完全无声，手机媒体音量和静音模式已排除；此前的代码单测不能代替真机发声确认。核对安装的淘宝 SDK，音频上下文具有 onCanPlay/onCanplay 与 onPlay 事件。按淘宝购物小程序音频规范，移除淘宝不支持的 obeyMuteSwitch 属性设置；监听可播放事件后再调用 play，两个大小写版本均兼容，重复／迟到的就绪事件不能重播旧音频。继续使用每条新实例和单通道队列。

新增 VOICE-20261102-02 开发日志，区分 loading、canplay、play_requested、playing、error，记录公开语音 ID 和经筛选的错误代码／类别；不打印错误原对象、URL、照片或账号信息。不增加业务 UI 控件。播放器诊断可通过 voice.diagnostics() 获取安全快照。

已确认原 HTTPS MP3 返回 application/octet-stream，Range 请求也返回整文件 200。部署 deploy/taobao-voice-media.py 修正仅 /state/assets/voice/ 静态路径，公开目录 /var/www/juzi-voice-20261102/ 仅包含清单内 14 个 MP3 和 manifest.json，Nginx 负责 audio/mpeg、206 与 Range。配置备份 /etc/nginx/sites-available/juzi.voice-20261102.bak；已通过 nginx -t 并 reload，H5／小红书／淘宝业务服务进程均未重启。14 条音频分段请求均返回 206 和正确类型，原主页 200、后台 401、数据路径 404，保护规则不变。源 server.js 同步补充 MP3／AAC MIME，未部署整份 H5 业务代码。

完整 244 项回归通过，共享规则校验通过；同时补齐了 WebGL 离线测试包中新增亮度取样模块的显式允许列表。IDE 正在生成本次代码的真机调试码，待手机扫码后核对原生播放事件与实际声音，不把这些改动表述成真机已修复。

主流程人脸亮度检测

检查发现 H5 的光线规则已复用，但此前普通相机识别结果不含亮度，正式调用也未传入 luma，因此只有固定“光线充足”引导，实时明暗提示未生效。现复用本地人脸识别已复制、转换好的小尺寸 RGB 帧，在首个人脸框内以 16×16 网格取样，使用 H5 的 .299R + .587G + .114B 均值；不新增 Canvas、Tensor、整帧复制或网络上传。

识别结果携带仅一个聚合 luma 值，质量适配器接入 H5 既有规则，侧脸放宽判定也保留此值：低于 110 提示“建议到光线明亮处拍摄”，高于 220 提示“光线过强，建议避开强光”，成功姿态时按 H5 附加“保持不动即可拍摄”。明暗均为建议，不作为拍摄否决条件；单人、完整取景、角度和新鲜度限制不变。缺失／无脸／无效输入保持未知，不伪装为亮度 0。只评估人脸画面明暗，不代表物理照度、逆光或光照均匀度检测。

96 项相关回归通过，覆盖不同背景、人脸 ROI、RGB 权重、通道格式归一、真实模型亮度输出、前／侧脸提示，以及过暗／过亮时仍可自动取图；需重编译预览后确认手机实际提示。此次不调整界面布局或已有语音文件。

正式拍照语音排查与恢复

用户反馈拍照没有语音。线上 step1-front、step2-rightface、countdown-321 三个 MP3 均可通过 HTTPS 读取，返回 200；手机实际无声原因仍需新版真机确认。代码检查发现普通相机及 AR 姿态结果未接入 VOICE.hint，现按 H5 映射补齐正对、左右转头、距离及保持不动提示；同提示不逐帧重复播放，换步／倒计时清理过期提示。正式三步引导、拍摄完成、分析与失败语音保留。倒计时先等步骤引导收尾，最长等待 3 秒后继续，保留三秒视觉计时与取图逻辑；等待期间继续识别真实帧，姿态失效取消等待，旧回调不重启拍摄，语音不可用时不阻断流程。

播放器不再每次先 stop 同一个实例再复用。改为单通道、每条播放结束或打断后释放实例，下一条重新创建；旧实例迟到的 ended/error 不可清除新语音队列，同步回调错误不再导致空对象异常。可写属性设置播放音量，支持时关闭遵循静音开关，平台不支持的属性失败不会阻断拍照。测试页继续遵守此前的静音、无上传规则，不把专项测试页当作正式语音验收。

新增播放器和主流程语音回归，验证无 stop-before-first-play、停止后不复用、迟到回调隔离、排队／去重、异常资源释放及正式转头提示触发；未调整 UI 或语音文件内容。

本轮完整 236 项回归及共享 H5 校验通过，IDE 自动编译完成；手机实际听音仍待重新编译预览后的正式流程确认。

H5 排版与交互还原

已通过只读 HTTPS 获取线上 /state/ 的 index.html、style.css、ui-20261012.css、swipe-track.js；统一 CRLF/LF 后与本地内容一致。以这些源码为基准修正此前遗漏，不改变评分、报告文案、照片处理或推荐规则。

报告三组详情卡原先仅渲染当前面板、只能点击标签。改为全部面板挂载的横向轨道，检测图区域支持跟手拖动、短滑回弹、快划切换、边界回弹及标签联动，竖向手势仍用于阅读页面；文字区不绑定横滑。滑动中保持卡片高度，结束后按当前面板实测高度调整；侧脸标注异步完成后重新测量，避免裁切文案。
检测图和侧脸图新增与 H5 一样的点按放大／再次点击关闭。放大保留当前裁切、标记和图层；滑动释放不误触放大。离页、切换账号或缩放尺寸时取消未完成的手势／图片回调，避免私有图片重新弹出。
档案肤质轮播从“松手才跳页”补为 H5 跟手轨道，箭头、圆点同步，取消／纵向／多指手势不误选。
正常主页、登录和拍照页不再展示开发工具入口；需要专项验收时，开发环境显式启用 cameraDebug:true 可显示入口。主页游客状态恢复“游客模式”，去掉额外的游客操作按钮，保留 H5 的开始检测／我的报告；游客可从历史页进入淘宝登录，关闭小程序后不保存本次会话。报告页去掉 H5 没有的附加历史／结束体验按钮，历史入口统一从主页进入。

完整 227 项测试通过，新增 8 项针对手势、页卡高度、图层状态、放大与身份切换的行为回归。只读浏览器投影预览覆盖 320／375／414px 的主页、档案、报告布局，未见页面横向溢出，页卡宽高与当前面板吻合；预览脚本与截图保存在 temp/check-h5-ui-layout.cjs、temp/h5-ui-restoration-20261102/，使用项目测试样本，不能替代淘宝真机渲染／手势验收。共享 H5 校验通过。需重编译预览后核对真机横滑及放大体验。

正式主流程接入与回归

主流程沿用登录 → 启动页授权 → 档案 → 普通前置相机自动三连拍 → 压缩／上传 → 报告，入口为不带 debug 参数的 /pages/camera/camera。原页面与操作保持不变。首次进入、相机授权状态尚未确定时，自动衔接平台相机授权再开始取景；已明确拒绝时不反复请求，仍使用原权限提示与相册入口。

补充游客和淘宝账号两条多页面集成回归：运行实际登录、档案、拍照、上传客户端及报告页面代码，仅相机帧／JPEG、传输服务响应与平台 API 使用固定测试替身。验证游客不请求账号授权、不持久化档案／会话，正式账号保存自己的档案，普通业务三连拍完成后按 front／left／right 上传，只提交一个 request_id，渲染三组七项报告并打开 1088839442533；退出游客清除本次报告。完整 219 项回归通过，共享 H5 与本地模型产物校验通过；没有发起真实付费检测。云网关到真实服务和手机报告结果仍待验收。

当前状态：用户确认自动三连拍通过

用户已反馈“自动三连拍已经好了”，将最近交付的前置相机三步自动抓拍标记为当前手机真机通过；不推广为所有机型、后置或 AR 路线已通过。正式业务配置从临时上传优先恢复为 photoInputMode:'camera'，沿用同一普通相机识别与拍照实现；相册入口保留，页面布局和交互不变。正式业务离线回归使用实际配置验证三张照片只触发一次报告请求。

本轮再次确认远端 juzi-taobao 为 active，18081 /api/health 返回正常；这不代表小程序云网关已通。下一项仍是游客云服务访问、三图上传和手机真实报告，尚未完成端到端验收。

前置相机第二、第三张方向校准（LOCAL-FACE-20261102-09）

用户真机确认第二、第三张的角度方向相反：提示向左转头时，实际接受的是向右转头。普通前置相机的本地姿态判定现传入 mirrored:true，翻转 yaw 符号，等价于对调两个侧脸步骤接受的原始角度方向。步骤仍是正脸／右脸／左脸，原 UI、转头提示、遮罩、照片标签及提交顺序不变；后置相机仍用原映射，AR 对照及共享 H5 文件不变。保留 08 的放宽阈值，不以取消方向检查来放行。

相关 71 项测试通过，覆盖前置左右方向互换、错误方向提示、后置方向保留、小角度自动三连拍及照片输出顺序。随后用户已确认自动三连拍可用。

性别选择控件对齐 H5

档案页原先使用系统 picker mode=selector，现改为页面内底部弹层的单列 picker-view，复用已有出生年月／地区弹层容器。对照 h5/js/app.js 的 genderPicker 与 h5/css/style.css 的 mobile-select 样式：标题“性别”，选项“女／男”，左右“取消／确定”，50px 标题栏、220px 滚轮、44px 淡黄色选中框、90% 内容宽度及安全区留白。触发框沿用原样，滚动仅更新草稿，确定后更新性别，取消不更改字段；再次打开定位已保存选项。出生年月与地区的原实现保持不变。需重新编译预览后确认手机实际观感。

最新约束：保持原有 UI 和交互，优先完成上传与报告

用户要求 UI 和交互与原来保持一致。本次撤回此前新增的上传面板、登录协议样式、动态按钮文案、入口版本标签和额外提示弹窗；恢复原相册／快门／切换镜头控制条、取景引导和步骤提示。保留接口修复及同步异常后解除按钮锁定的逻辑，不因排障新增业务页面或改变页面布局。

游客入口真机错误已确认为 FAIL BIZ TARGET SERVICE_ERROR:.访问目标服务异常。淘宝专用 Node 健康，最近日志未见对应新请求，仍需核对云应用、私网 CLB 和 SAE Java 转发服务；尚未确认云端根因，也未完成手机端报告验收。用户可通过此前提供的阿里云 SAE 控制台链接登录；代开浏览器的系统命令被自动权限检查拒绝，未绕过。

用户已调整优先级：实时抓拍继续保留，先验收三图上传闭环。photoInputMode:'upload' 在正式业务页跳过尚未通过真机验收的 GPU 初始化，沿用原相册图标选图、快门调用系统相机和三步引导，不显示独立上传面板。复用压缩、分片上传、同一 request_id 重试及报告跳转；游客身份与本次会话规则保持不变。开发版实时识别入口独立保留。

本轮联合测试 209 项通过；后续文案微调的相机回归 60 项通过，共享 H5 规则校验通过。已将匹配的 server.js、lib/.js、js/.js 更新到淘宝专用 /home/ubuntu/juzi-tb/h5，服务 juzi-taobao、端口 18081。备份为 /home/ubuntu/juzi-tb-backup-upload-20261102.tar.gz，数据目录 /home/ubuntu/juzi-tb-data 保留。发布检查曾因幂等标记查错文件触发自动回滚，修正后重新部署成功。健康检查、游客路由的同意门槛及 challenge 已在服务器通过；未调用真实付费检测，手机三图生成报告仍待验收。未部署 H5／小红书服务或统一后台。

手机验收：重新编译并预览 → 扫新码 → 正常游客体验或淘宝登录 → 开始检测并填写档案 → 依次选择三张照片 → 查看报告和商品跳转。此轮无需进入“相机测试”。以下相机版本记录为此前专项历史。

目标与基准

以 https://1me.xajuzi.com/state/ 的页面、评分、七项报告、三视角拍摄和等待动画为基准。
源码起点 381da60，工作分支 codex/taobao-h5-adaptation。已重新 fetch；远端当前与此起点相同。
线上 HTML、评分及报告呈现文件已核对。本地 app.js 多了小红书渠道兼容，拍摄规则来自同一份 H5 源码。
淘宝账号替代微信；保留游客体验，游客报告仅本次可见。三档推荐文案保留，全部跳商品 1088839442533。
游客入口不需要淘宝账号登录／账号授权，不读取账号资料；仅在同意隐私告知后建立临时检测会话，相机权限在实际拍摄时申请。账号恢复不能阻塞游客按钮，迟到的旧账号结果不能覆盖游客流程。
最新用户选择：颜色校验仅保留为可选开发工具，不作为拍照／导出／报告门槛。缺少格式且严格匹配四通道的帧使用应用默认 RGBA；平台明确格式优先。
实时识别抓拍是首版验收要求。当前主线为普通前置相机；手机已识别人脸且姿态合格，CPU 优化版单帧从约 10.7 秒降至约 4.25 秒，仍未满足实时要求，首版尚未验收。正在验证原生 WebGL 加速候选。

平台测肤接入：新增前置核对（2026-11-02）

已核对淘宝公开的《肌肤测试》接入文档。页面更新于 2023-01-29，因此具体可用能力、申请入口和运营联系人仍需以目标应用后台及当前运营确认为准。

文档分别列出平台算法与自带算法两条路线。项目实际使用 Face++ 测肤服务及自有评分、报告逻辑，按“自带算法”路线准备；该路线仍有商家资质、ISV 调用资质、方案确认和测肤白名单流程。用户已反馈“尚未申请／目前不清楚”，当前按测肤白名单未申请、ISV 资质待确认处理；不能以已有 AppKey、可预览或普通相机可调用代替开通确认。

修正后的推进顺序

核实天猫品牌／美容护肤主营类目、对应应用及 ISV 资质，确认自带算法测肤白名单进度。申请材料说明现有算法供应商、三视角采集、用途、数据流和游客仅本次查看规则；提交申请、联系运营由商家确认后执行。
获得该应用实际开放的拍照组件及接入契约，确认能否实时取景、获得人脸点位或识别结果、自动触发抓拍、连续采集三视角并返回可送检照片。首版 H5 式实时识别抓拍目标不变；若组件限制影响目标，先确认平台支持的实现方式，再确定正式相机方案。
增加拍摄前的品牌方人脸采集告知和明确授权，覆盖正式账号、游客及相机测试入口。当前登录页展示的是 Face++ 政策，不等于品牌方采脸弹窗。需要补齐品牌主体名称、完整面部图像用途、14 周岁承诺、肖像使用范围、实际第三方处理情况、品牌隐私链接及退出／删除联系方式；拒绝后不启动采集。官方模板的营销共享条款需按实际业务与当前审核口径确认，不能直接扩张实际共享用途。
在平台要求的测肤结果边界适配一级 skinType：0 干性、1 中性、2 混合偏干、3 混合偏油、4 油性。先确认回传接口和现有算法结果的语义，再加适配；不直接改 H5 历史结构，也不用问卷答案冒充算法检测结果。品牌七项报告继续沿用。
平台接入、采集授权与相机能力一起验收，再进行真实三连拍、报告、商品回跳及部署验收。

文档没有写明“所有普通相机调用一律禁止”，也没有证明原生 ar-camera 就是白名单开放的测肤拍照组件。目前的 AR 实现和测试页保留为技术验证；即使真机有帧、能导出 JPEG，也不能据此认定测肤业务已获平台准入。正式拍摄组件方案仍待上述信息确认。

对接说明草稿（尚未提交）

业务为 1'me 以我品牌的淘宝小程序肌肤检测及产品推荐，拟采用自带算法接入：第三方 Face++ 提供检测能力，品牌系统负责评分、七项报告及推荐，算法服务不是品牌完全自研。参考 H5 为 https://1me.xajuzi.com/state/，首版要求页内实时识别、稳定后自动抓拍正脸／右脸／左脸三张图，随后生成报告并跳转指定天猫商品。

拟使用平台对该应用开放的测肤拍照组件，保留 H5 的引导与报告规则。图像经品牌后端送算法服务；淘宝与 H5 的身份、报告存储隔离，管理后台可只读汇总。游客按当前实现仅在本次会话处理，品牌后端不将其照片和报告写入持久目录；这不代表已确认第三方算法服务的保留规则。正式账号的照片／报告保留及删除规则仍需确定，再同步到隐私告知。

商家需补充：应用名称及 AppID、品牌运营主体、店铺主体及主营类目、开发主体／ISV 信息、品牌隐私政策链接与用户联系渠道。申请时不附密钥或用户照片。

需向当前平台运营确认的问题：

Face++ 加品牌自有评分的接入分类、所需资质及当前申请流程是什么？
开通后提供哪个插件／组件、版本和技术文档？是否支持三视角实时识别抓拍、自定义引导、合适的图像导出和自带算法送检？若由组件内置识别抓拍，如何取得结果和处理取消／失败？
现有原生 ar-camera 能否用于该业务，还是必须使用另行开放的测肤组件？不能把两者视为同一权限。
采脸授权的现行文案、品牌及第三方披露要求是什么？游客是否有额外接入规则？
skinType 通过哪个接口／事件返回，是否要求同时回传其他结果字段？

白名单申请的执行路径

优先由店铺负责人联系已有的天猫美容护肤行业运营，说明要申请“自带算法测肤拍照组件白名单”，请其确认当前测肤产品运营及接入要求。没有对接人时，可登录淘宝开放平台支持中心创建接入咨询工单，请求转接对应业务负责人；官方支持中心说明确认开发者可在线提交问题／需求。工单用于咨询和转接，正式白名单仍按业务运营给出的流程申请。

建议材料包括店铺链接与类目、品牌和开发主体、ISV 资质状态、目标应用名称及 AppID／AppKey、Face++ 与品牌评分的数据流、三视角实时抓拍流程、采集授权和隐私规则。先取得方案确认，再向当前运营指定的渠道提交白名单申请；通过后核对获批应用、组件／接口范围及技术文档。

公开测肤文档中的运营花名来自 2023 年，未公布邮箱，不推测联系地址。文档“申请插件”链接指向能力中心，本次未能验证登录后的申请按钮及能力 ID 63 的开放状态。也可从文档关联提问入口登录后咨询。

可发给运营／工单的说明：

我们计划为 1'me 以我品牌接入淘宝小程序肌肤检测，使用第三方 Face++ 检测及品牌自有评分、报告，申请自带算法路线的测肤拍照组件白名单。首版需要页内实时识别、稳定后自动抓拍正脸／右脸／左脸三张图，并支持默认前置和前后置切换。请协助确认商家及 ISV 资质要求、当前申请入口／材料和业务对接人，并提供对应组件文档。应用名称／AppID／AppKey、品牌主体及开发主体待补充。

已实施

独立登录首屏、淘宝／游客两入口、协议、失败重试、正式账号签名恢复和宿主换号隔离。
游客临时 Bearer 仅内存保存；账号库、照片、原始结果、报告和侧脸缓存不落盘。商品页往返保留本次报告，主动结束或冷启动清理。
通过网关完整签名与单用 challenge 建立游客，不要求 open_id，不接受客户端自报身份。正式 /me 对照当次签名身份与旧 Bearer，避免宿主换号后继续显示旧报告。
上传和临时任务按 Bearer 会话隔离；稳定 request_id／photo_refs 复用原任务。队列满不消费照片，提交响应丢失重试不会重新收费；过期任务返回明确错误。
拍照蒙版从 H5 原始 SVG 轮廓生成本地 PNG，包含三方向定位线；图标、完成卡、扫描等待画面与 H5 对齐。scripts/build-camera-assets.cjs 可重建。
补齐原来缺失的 compress-canvas；补压缩超时、迟到回调隔离、上传／恢复阶段提示及错误重试。切后台后继续查询原任务。
推荐跳转统一固定商品 ID，防重复点击，提供缺 API／失败反馈；新报告、游客报告、历史报告的内存状态保持。
后台可按显式配置只读汇总 H5 与淘宝的数据源，支持渠道筛选、分页、统计、详情、照片、原始 JSON 和 CSV。外源重试禁止写入。详见后台部署说明。

游客入口补充修复：登录页恢复旧账号期间允许直接选择游客；选择后立即失效旧账号恢复、清除旧 Bearer 和本地账号缓存。游客 challenge／guest-session 不携带旧账号 Bearer、不调用 scope.userInfo 授权；旧 /me 成功或 401、以及其迟到页面回调均不能重定向／覆盖游客流程，游客请求失败也不会自动恢复旧账号。用户未同意告知时仍保留原会话并提示同意，不提前切换身份。相关 API 时序与页面回归共 32 项通过。服务器游客接口仍需部署配套版本后才能手机验收。

AR 实时相机

普通 camera 的实时帧监听在旧官方文档中标为暂不支持。本轮改用淘宝原生 ar-camera，模式 faceDetection2D，事件 onARFrame 返回人脸框及 106 点坐标。

默认前置与镜头切换（初始排查，最新映射见后续更新）

用户反馈页内实时相机实际打开后置。原先的 devicePosition: 'front' 只绑定普通 camera，没有传给正在使用的 ar-camera；AR 分支的切换按钮也只弹出提示。现已向 AR 组件显式绑定驼峰属性 devicePosition，默认请求前置；正式拍照页右下角的翻转图标增加“切换镜头”文字，测试页也提供同名按钮。

点击切换会卸载旧组件，再按新方向挂载；取消旧倒计时、清除旧帧，并按相机会话标记丢弃旧组件的帧／停止／错误事件。已拍好的照片和当前拍摄步骤保留。人脸原始坐标仍沿用现有约定，不仅凭镜头方向推断坐标是否镜像。

本次镜头改动的相机、测试页及前端相关回归共 28 项通过，覆盖切换取消倒计时、旧组件事件隔离、已拍照片保留，以及测试页切镜头／重开时共享画布导出串行。这些是逻辑验证，不代表真实镜头已切换。

证据边界：淘宝缓存文档只描述按 mode 自动选择相机，没有列出方向参数。devicePosition 的明确字段及默认后置来自 Taro 官方 Alipay 适配源码，因此本轮是基于共享组件线索的兼容修正，尚未证实淘宝宿主接受该参数。没有调用未证实的 AR 切镜头方法，也没有直接用另一套 <ar> 替换识别与图像导出链。必须在手机确认实际镜头改变，不能以页面状态变化或本地测试通过代替验收。

用户随后重新编译预览反馈“默认仍是后置”，所以当前前置请求补丁未达到目标，镜头控制问题仍未解决；不把请求方向状态当作实际镜头状态，也不认定未开白名单就是该故障的原因。下一步需要目标应用实际可用组件的方向控制契约及真机能力确认。

继续排查：已复现并修复的本地问题

正式拍摄页原先在切后台时解除拍摄忙状态，但旧原生画布导出还可能继续。已用持久 Promise 队列串行化 AR 导出和普通三图压缩；队列跨后台／恢复保留，旧照片不能恢复到新会话。测试实际延迟 canvasPutImageData 回调，验证不会并发写同一画布。
已复现补光后的 300ms 内相机报错／停止，定时器仍能采用旧帧进入下一步。现在会使未完成抓拍的序号失效、清除倒计时／补光／旧帧；已提交分析任务继续运行。
三张照片拍完后，相机原先仍在等待动画背后运行。现在进入报告处理时卸载实时组件并清空帧引用；分析失败时保持关闭，主动“重新拍摄”才恢复。
云 SDK 的 init 或请求 Promise 若不结束，原有轮询截止时间无法中断当前等待。传输层已新增独立超时：初始化 15 秒，每次云／本机请求 12 秒；迟到结果被忽略，初始化失败可重新建立。重试仍沿用原任务／request_id，不在超时处理里自动发起新检测。

上述是已复现逻辑缺陷的本地修复，不等于用户手机上的报告卡住根因全部确认，也未解决默认后置问题。

新的两组真机诊断

原 AR 测试页版本为 AR-DIAG-20261102-01，展示可读取的设备／淘宝／SDK 版本、实际 context 方法名、原生事件类型和白名单元信息。收到不符合标准结构的回调也会计数，避免将“有回调但解析失败”误认为没有帧。帧计数保存在 JS 中，页面与元信息扫描最多每 400ms 更新一次；点击“复制诊断”才写剪贴板，文字不含图像、landmarks 或身份。登录首屏入口已从左上角小字改为醒目的黄色“相机测试（开发版）”按钮，仍仅在开发环境显示。
从该页新增“普通相机对照测试”，对应 pages/camnative/camnative。默认请求普通 camera 的前置，支持前后置重挂，按本机淘宝 SDK 实现调用 onCameraFrame(callback) 返回的 listener 的 start/stop。区分“方法存在”“start 成功”和“实际收到尺寸、字节非空的原始帧”；3／10 秒无帧给出明确状态。手动拍照仅作本页临时预览，无账号／上传／业务存储依赖。
普通相机对照页只验证取景、原始帧与照片能力，不作为实时人脸识别三连拍的替代方案。有原始帧也不代表已有可用人脸关键点或已取得测肤业务准入。

淘宝专用后端只读核对

本次通过现有 SSH 授权只读连接 ubuntu@1me.xajuzi.com，确认 juzi-taobao 为 active，回环 18081/api/health 的 ok=true。读取 /home/ubuntu/juzi-tb/h5 四个业务文件的哈希／功能标记后，确认与本地版本不同：已部署路由没有 guest-session，会话模块没有本轮 request_id 幂等实现。没有读取凭据、用户照片或报告，也没有重启／部署／修改远端。

因此新版游客和完整幂等链路仍需匹配的 Node 版本才能进行手机验收。相机诊断页无需后端，可先独立验证。

本次代码完成后运行 87 项自动测试全部通过，共享 H5 规则校验通过；淘宝 IDE 再次本地编译完成，界面显示 0 错误、0 警告。没有调用真实 Face++ 检测。默认前置、真实切换和完整三连拍仍等待用户手机的两组诊断结果。

用户真机反馈与颜色校验（后续更新）

用户已确认测试页为 AR 相机真机验收，计数持续增加，默认后置但按钮可以切换。其提供的旧测试页文字显示：720×1280、一张人脸、几何姿态判断通过，capturedImage 为 3,686,400 字节的 ArrayBuffer，未带像素格式；JPEG 导出报“相机原始图像格式尚未确认”。这个长度等于宽×高×4，可确认四通道长度匹配，但不能据此决定 R／B 或 alpha 的位置。默认方向和导出问题仍单独处理，不直接反转枚举值。

已修正两个有本机淘宝 SDK 源码依据的画布兼容问题：JPEG 结果兼容直接字符串及 dataURL／dataUrl／base64 外壳，验证 JPEG MIME、标准 Base64 与 JPEG 标记；像素写入优先使用淘宝 ctx.putImageData，保留探测到的 my.canvasPutImageData 兼容路径。四通道原始像素恰巧以 JPEG／PNG 标记字节开头时，不能误按压缩图片解码。

AR 测试页现为 AR-DIAG-20261102-04：顶部固定“复制诊断信息”和“导出照片”，复制失败仍展示可长按选择的脱敏文字。按用户后续要求，默认直接导出，不再要求做颜色校验。config.arPixelFormat='RGBA' 只补缺少格式且严格匹配四通道的图像；平台明确格式、开发页显式预览格式及当前运行内可选确认的格式优先，显式未知格式和不匹配的字节长度仍报错。应用默认值不是已确认的平台通道规范，诊断分别记录 default 与 confirmed。

颜色校验移至正文高级可选区域：明确点击才冻结一次原图，不复制 anchors，并串行生成最长边 480 的 RGBA／BGRA／ARGB／ABGR 预览。可选确认仅留在本次运行、仅用于同一图像字段路径，不写 Storage、不上传；不做校验或冷启动后也可使用应用默认值。正式导出保留最长边 1280，跨机型颜色与方向仍需后续验收。

用户进一步确认，切到实际自拍画面时页面显示“请求后置镜头”。据此将当前 AR 的 config.arFrontPosition 设为 back，测试页默认请求该值；正式页分开逻辑镜头 devicePosition 与 AR 请求 arDevicePosition，默认逻辑前置对应此请求值，切换后使用另一请求值。轮廓和扫描线的镜像继续按逻辑镜头计算；普通 camera 仍按其标准 front/back 属性控制。该配置来自当前真机反馈，新版本首次启动是否直接自拍及其他机型映射仍需验证，不能视为淘宝所有设备统一反向。

普通相机对照页同步补充固定复制入口和可选择文字后备，版本为 CAM-NATIVE-20261102-02。本次相关修改后 126 项自动测试全部通过，共享规则校验通过。仍需真机验证候选颜色、方向和 JPEG；未部署 Node 或调用真实 Face++。

默认导出与 AR 请求映射修改后，再次运行 131 项自动测试全部通过，共享 H5 规则校验通过。新增覆盖未校验直接导出、默认值不覆盖平台格式或可选确认、正式三连拍采用默认格式，以及反向 AR 请求不改变逻辑蒙版／普通相机。此次仍未部署 Node 或进行真实检测。

手机更新预览时，需在 IDE“预览”弹窗生成新的预览二维码，再扫码核对上述版本号；只重新编译本地模拟器不能当作手机已更新。用户此前提供的页面尚没有新版本号／复制按钮，不以该旧页面验收新入口。

点位转换使用官方图示的语义对应：轮廓取 0、2…32，眉鼻眼取 33…63，嘴取 84…103。H5 的头部姿态、距离、居中及稳定性判断原样同步到 vendor/，由哈希校验，未将未注明单位的原生 Euler 值当作角度。

useCapturedImage 只在官方文档中承诺返回图像 ArrayBuffer，未完整注明字段和像素格式。实现读取实际帧结构，支持可识别 JPEG／PNG 和明确标注的 RGBA／BGRA／ARGB／ABGR 四通道图像；按用户最新选择，缺少格式且严格匹配四通道的图像可使用应用默认值直接导出。显式未知格式或尺寸／字节不匹配仍明确报错。没有调用未记载的 AR takePhoto 方法。

真机验收步骤

后续手机反馈已确认：AR 反向请求映射仍未实现默认自拍；普通 camera 独立诊断则默认前置、可切换、可拍照出图，并且原始帧计数持续增加。因此继续验证“普通前置相机 + H5 本地人脸模型 + 原生 JPEG 自动三连拍”路线，不能把原 AR 请求映射标为修复成功。

用户反馈复制按钮与系统时间重叠后，两个诊断页的固定工具栏均新增顶部安全间距：读取可用状态栏／安全区／标题栏高度，最少留出 112px，正文同步下移。普通相机版号更新为 CAM-NATIVE-20261102-03，AR 页为 AR-DIAG-20261102-05。同时修正普通诊断页版号在 Page() 后才赋值导致初始页面可能不显示版号的问题。两页相关 39 项本地回归通过；真实手机点击位置仍待新预览验证。用户已要求跳过颜色校验，不再把此操作作为本轮测试步骤。

普通相机本地识别接线（最新实现）

config.captureMode 已切为 native-face 开发候选：普通 camera 默认请求 front，单次实时帧推理后复用 H5 的姿态、居中、距离和稳定判断，再倒计时并用同一相机 takePhoto 获取 JPEG。正／右／左三张接入既有顺序压缩及单次任务提交；手机已提供普通帧宽高／字节数，实际本地识别、方向和耗时仍须手机验证。显式未知格式、额外行填充及旋转标记会报错，不静默改成手动拍照。

utils/native-face.js 使用从 H5 原有 face-api 和量化权重构建的本地 CPU 副本：无需 DOM、网络、Node 模块或 Face++。无 DOM 环境下以仓库本地参考图真实跑过检测及 68 点，专项 6 项通过；模型占 68 个 tensor、2,200,644 字节，最后一个引擎释放后回到 0。CPU 耗时受环境影响，本机直接 Node 连续参考帧约 369–552ms，隔离 VM 约 1s；均不代表手机表现。构建脚本去掉了库内会被 IDE 静态解析的 Node-only require 分支，保存原版权声明、许可与来源 SHA。

帧缓冲在返回宿主前同步缩采样为独立 RGB，避免原生复用缓冲改变待处理图像；并发推理前先跳过忙帧。倒计时末若检测未完成，最多等 1.5 秒复核新结果，仍从原始帧采集时刻判断新鲜度；连续 3 次识别超过 1.5 秒会明确停止。切后台、换镜头、相机异常及报告处理清理监听和倒计时，旧推理／旧快门回调不能推进新会话。

本轮最终 163 项自动测试全部通过，H5 共享规则逐字节校验及本地模型构建校验通过。没有调用真实检测或部署服务。手机仍需验收帧格式、速度、方向、自动三连拍及报告闭环；当前服务器缺少新版游客接口的部署事实不变。

后续用户提供 AR-DIAG-20261102-05 的 iPhone15,2／iOS 27.0.1／淘宝 10.68.10／SDK 2.9.4 诊断，frameEvents=0、context 未观测。该记录属于 AR 页，并非普通相机元信息；无帧不能推断能力不支持。为减少误入，登录与首页开发测试入口现直接进入普通相机，AR 页普通相机按钮移至固定工具栏。两测试模式用 redirectTo 切换，避免反复堆叠页面；原生拍照或 AR 导出进行中不允许切换。用户当前手机版本仍可使用正文旧“普通相机对照测试”入口，无需为取得元信息反复生成二维码。

普通相机真机帧已取得

用户随后复制 CAM-NATIVE-20261102-03：同一设备上 requestedPosition=front，takePhoto/onCameraFrame/listener.start/stop 均存在，监听启动成功，145 个回调均有有效原始字节。图像为 540×960、2,073,600 字节，等于宽×高×4，未报告 pixelFormat／format。这证明有紧密四通道长度的连续图像，不能仅凭长度认定通道排列；按用户要求沿用应用 RGBA 默认值，不要求颜色校验。nativeReady=false 只表示该事件未观测，正式流程不依赖此标记；当前这份诊断未发起手动拍照，照片能力仍来自此前用户真机反馈。

真实模型新增同尺寸竖屏回归：参考图等比居中放入 540×960，缺格式采用默认值，并在 detect 调用后立即复用清空原生缓冲。实际检测出 1 脸和 68 点，输出坐标合法，tensor 无增长；模型专项现 7 项通过。本机隔离环境约 937ms，仍不代表手机性能。

普通诊断页更新为 CAM-NATIVE-20261102-04，顶部增加“开始自动三连拍测试”。该入口使用独立 debug=local-face 开发模式复用正式相机的识别、稳定判定、倒计时、正／右／左自动抓拍和 JPEG 压缩，完成后仅本页临时预览，不要求账号／档案、不上传照片、不创建检测任务、不播放远程语音。已有手动 debug=camera 保持原来的本机直连开关。测试入口不等于正式报告验证；已有账号的应用全局前台恢复仍可能独立进行 /me 校验，因此不宣称整个应用全程零网络。

自动验收版本为 LOCAL-FACE-20261102-01，复制入口避开状态栏，包含安全的 stage／failureStage、模型耗时、人脸计数、拍照计数及独立 canIUse 信号。正式相机属性与已验证普通诊断页对齐为 mode=normal、frame-size=medium。新增隔离回归验证不调用账号 API／getApp／discardAnalysis，不改变其他正在进行的检测；旧模式开关和生产环境登录门槛不放宽。最终 169 项自动测试全部通过，共享 H5 规则和模型构建校验通过；没有真实检测或部署操作。

手机性能阻塞与后续优化

用户在 LOCAL-FACE-20261102-01 实测：canIUse.camera/createCameraContext=yes，6 次处理后在正脸阶段因 performance 停止；最后一帧 10,734ms、1 脸、quality=ok，源图仍为 540×960／2,073,600 字节。连续 3 个结果超过 1.5 秒后正确停止，照片计数 0。问题是当前识别链路耗时，不能以姿态合格认定抓拍可用，也不能把结果完成时间改作源帧时间或直接放宽门限。

新版诊断 LOCAL-FACE-20261102-02 分开记录原始回调、忙时跳过、实际检测次数及 snapshot／model／tensor／detector／landmark／total 耗时，区分配置请求值和引擎实际值，补运行时版本。正常推理期间的额外 100 个回调只跳过、不复制图像、不刷新 UI；桥接的大帧交付和 GC 仍需实测排查。

连续预览改用官方 camera 的 small 帧尺寸，降低原生到 JS 的图像传输量，原生正式拍照仍保留 high JPEG。轻量 68 点模型来自 face-api 官方权重，单独存于 reference/native-face-models 并记录来源／SHA，H5 原始模型不改。定位输入为 160、缩采样最长边保留 320；本地等比双脸图在 128 输入只检出 1 脸，故未用该更低尺寸作为默认值。

CPU 优化仅将旧 TFJS padding 的逐标量坐标换算改为连续 typed-array 块复制，数值运算顺序不变；1×1 卷积实验未取得稳定收益，未纳入发布候选。原 540×960 参考竖屏的同图隔离基准约 full256 934ms → tiny160+pad-copy 302ms（约 3.1 倍），模型张量内存约 2.20MB → 1.08MB。更低 maxSide 192 仅省约 24ms，未采用。上述是本地基准，手机的输入帧大小、计算时间及自动抓拍仍待 LOCAL-FACE-20261102-02 验收。

上一轮还完成 temp/native-face-webgl-prototype.cjs 离线原型：显式 WebGL1 注入可在屏蔽 DOM 的模块中通过矩阵乘法、卷积、读回及真实 68 点模型，数值自测确实执行 shader；没有网络请求。但这不证明淘宝手机原生 GL 已兼容。原型阶段尚未启用 enableSkia 或 GPU；在本轮 CPU 真机复验后，已继续实现下述 WebGL 候选。MNN 插件未接入。

本轮最终 174 项自动测试全部通过，共享 H5 规则与模型生成校验通过。独立复核额外对照 250 组 padding，覆盖 rank 1–5、空维、TypedArray 偏移和特殊常量；多模型失败恢复与最终释放均通过。源帧 1.5 秒新鲜度、连续 3 次慢结果停止、多人拒绝和调试页无上传规则保持不变。

原生 WebGL 候选（后续开发）

用户在 LOCAL-FACE-20261102-02 复验：small 帧已实际降为 360×640／921,600 字节，tiny／160／pad-copy 均生效；处理 3 帧后仍停在 performance，最后一帧总耗时 4,253ms，其中 snapshot 8、model 29、tensor 0、detector 2,373、landmark 1,843ms。人脸及姿态合格，照片计数仍为 0。这证明减少传输量已生效，而本轮主要瓶颈在模型 CPU 计算，不能继续用同一 CPU 方案宣称实时通过。

下一候选 LOCAL-FACE-20261102-03 使用官方同层／离屏 Canvas 的原生 WebGL1 入口。按文档启用 app.json.window.enableSkia:"true"，配置明确请求 WebGL；不能仅以 API 存在或后端名称验收。初始化先做真实矩阵、卷积和 typed-array 读回数值自测，然后预热模型；数值错误、缺能力或上下文丢失时明确停止，不自动回到已证实过慢的 CPU。手机兼容性及速度仍待真机验证。

本机 SDK 的 legacy createCanvasContext 有原生 Canvas 兼容路由，保留现有 JPEG 压缩方式，不引入未证实的 2D 导出接口；文件读取结果补 JPEG 标记和标准 Base64 验证，防止把 PNG／坏数据标成 JPEG。真实手机仍需验证开启 Skia 后三张 JPEG 压缩、方向与覆盖层。

图形引擎的离线真实 WebGL 回归已验证：数值自测确实执行 shader 并读回；tiny／full 可共享同一后端；GPU 存活时拒绝切换 CPU；真实参考图输出 1 脸和 68 点；初始化缺浮点能力、读回错误及上下文失效均明确失败。挂起真实 Tensor 读回期间销毁 owner 不会提前删除资源，操作结束后旧结果被拒绝，模型及 Buffer／Texture／Framebuffer／Shader／Program／Renderbuffer 均释放；新会话可以重建。以上使用隔离 Chromium 软件 GL，网络请求为 0，不能当作淘宝手机支持或速度的证据。

相机在初始化时显示“正在校验图形加速并预热模型…”，模型就绪后才监听真实帧，初始化 30 秒未结束会停止并保留可复制诊断。GPU 错误会使原引擎退役，待其初始化／推理结束后才能重建，避免复用失效的缓存或在旧回调仍运行时删除资源。JPEG 的回调与 Promise 双通道都受同一完成标记保护，原生 binding 的 Promise 拒绝会被处理，不引发未处理拒绝。

本轮联合回归 190 项全部通过，其中 4 项使用真实隔离 WebGL，覆盖数值自测、模型、失败恢复、共享后端、挂起销毁、GPU 资源释放及重建。H5 共享规则与模型生成校验通过。没有上传手机照片、进行真实 Face++ 调用或部署后端；手机 GPU 自测、实时速度和三张 JPEG 闭环尚待版本 03 验收。

WebGL 真机数值兼容（后续开发）

用户在 LOCAL-FACE-20261102-03 返回：原生 Canvas／WebGL 上下文创建及后端注册已走通，矩阵自测执行了 4 次绘制，但严格数值校验失败，MATMUL_FAILED，没有开启真实帧监听或拍照。旧诊断把错误长度、非有限值和误差统一归此码；pixelReads=0 当时只在卷积成功后更新，不能解读为完全没有像素读回。当前不能认定手机支持可用 GPU 推理，也不能绕过自测继续抓拍。

离线兼容实验故意破坏 readPixels(FLOAT) 返回后，默认路径确实矩阵失败；关闭 WEBGL_DOWNLOAD_FLOAT_ENABLED 时，TFJS 1.7 的真实备用路径将浮点结果编码为 RGBA 字节并用 UNSIGNED_BYTE 读回，矩阵／卷积及完整 68 点模型可通过。同样可关闭 WEBGL_PACK 使用非打包 shader。依据为 TFJS 1.7 官方后端实现与开关定义，未强造 HAS_WEBGL、WebGL 版本或浮点能力。

版本 LOCAL-FACE-20261102-04 按 default → packed_byte（仅禁用浮点下载）→ unpacked_byte（再禁用打包 shader）逐档执行原有严格合成矩阵／卷积／读回自测，每次失败先释放后端和图形对象，通过才加载模型及预热；三种均不通过时明确停止，不回退 CPU，不放宽 1.5 秒源帧新鲜度。新增诊断包括 profile、attemptCount、合成输入的长度、非有限值数、误差及校验和，以及 floatReads／byteReads。合成指标和兼容配置仅在初始化阶段缓存，后续模型检测返回不能覆盖；不复制照片或人脸坐标。

版本 04 的联合回归 194 项全部通过，含 6 项隔离真实 WebGL 测试：浮点读回损坏后进入字节读回、前两档失败后进入非打包字节读回、三档失败停止、两条兼容路径与 CPU 参考图的人脸框／置信度／68 点几何对照，以及每次换档前图形对象释放。共享 H5 规则、模型生成及差异格式校验通过，淘宝 IDE 本地重新编译完成（DevServer: Done）。这些本地结果不代表手机 GPU、速度或自动三连拍已通过。

原生 WebGL 读回检查（版本 05）

用户在 LOCAL-FACE-20261102-04 真机复验：三档均 MATMUL_FAILED，最后 unpacked_byte 记录 5 次绘制、1 次 UNSIGNED_BYTE 读回，输出长度 256、非有限值 0、244 项不匹配、最大绝对误差 22、预期校验和 2786／实际 0。帧监听和照片计数均为 0。日志呈全零特征；聚合数据不能单独证明每个元素都为零，更不能据此确定是绘制、上传还是读回出错。此前代码在数值不匹配后即抛错，尚未检查该次 GL 错误，不能将“未报告 GL 错误”解读为“没有 GL 错误”。

版本 LOCAL-FACE-20261102-05 根据淘宝官方 Canvas 注意事项使用 getContext('webgl',{enable_flip_y_after_read_pixels:false})，关闭宿主默认附加的 flipY。隔离实验中，按较大 canvas 高度转换较小 framebuffer 的读取坐标可以产生全零且 getError=0；这说明该路径值得验证，尚未证实手机内部存在这种坐标转换。

TF 初始化前增加 2×2 RGBA8 清屏／读回、非对称 shader、字节纹理及浮点纹理上传采样检查，使用固定非零合成输入和预填目标哨兵值，区分未写回 TypedArray、错误像素、shader 编译／链接、纹理上传及 framebuffer 问题。基础检查失败即停止并释放资源；通过后仍需通过原有严格矩阵／卷积数值自测、兼容档选择及模型预热。没有降低数值阈值、放宽 1.5 秒新鲜度或自动回到 CPU。

新增诊断保留 nativeProbe 阶段与规范化错误、各基础检查结果、哨兵改写数、不匹配数、预期／实际校验和、读回返回值类型枚举、GL 错误和 framebuffer 状态。TF 自测在数值判定前采集 GL 状态；这些固定合成数据只在初始化时缓存，实际人脸检测不能覆盖，不复制照片、像素或人脸坐标。手机兼容性、根因、速度及自动三连拍仍待版本 05 验收。

本轮 05 联合回归 199 项全部通过，含 8 项隔离真实 WebGL 测试。新增测试验证默认坐标转换模拟的全零现象、关闭翻转后的非对称小 FBO 及完整人脸模型，并覆盖未修改读回出参、仅返回 ArrayBuffer／TypedArray／Promise、编译／链接返回 0、顶点上传、字节／浮点纹理故障共 9 类原生预检失败。失败时未注册 TF 后端、未加载模型，各类 GPU 对象释放。共享 H5 规则及模型构建校验通过，淘宝 IDE 本地重新编译完成（DevServer: Done）。实际手机结果仍待确认。

原生绘制与兼容选路（版本 06）

用户在 LOCAL-FACE-20261102-05 返回：原生清屏读回通过，非对称 shader 检查失败，changedBytes=16、3 项不匹配、预期校验和 2244／实际 2040，getError=0、FBO 状态 36053（完整）。实际校验和与原清屏颜色的 2040 相同。离线真实 GL 中，停止索引绘制、剔除所有三角形或把顶点上传清零均可复现这一组指标，因此它不能唯一确定绘制未覆盖、坐标、缓冲区上传或 GL 状态中的哪一项是手机根因。帧数及自动照片仍为 0。

版本 LOCAL-FACE-20261102-06 显式规范化 GL 绘制状态及颜色写入，在每次绘制前清黑以区分旧背景和实际绘制。先以不依赖 gl_FragCoord 的恒色 shader 分别验证 drawArrays 与索引绘制，再执行原非对称 shader、字节／浮点纹理检查。新增 constantArrays／constantIndexed 结果、可选顶点／索引缓冲区字节数及固定合成的四个 RGBA uint32 像素值；缓冲区元数据查询不额外作为硬门槛。

原生兼容策略按 standard → buffer_copy（将上传视图的字节紧密拷为标准 bufferData ArrayBuffer）→ framebuffer_y（仅为已绑定 FBO 补偿 viewport／scissor Y）→ combined 自测选择。仅原生 VALUE_MISMATCH 允许尝试下一路，其余错误明确停止；不能按手机型号认定某路可用。四路在同一个上下文上进行，每次检查结束清理本路图形对象；后续 TF 的 default／packed_byte／unpacked_byte 仍最多创建三个上下文。任何被选中的原生策略都须通过全部原生检查及后续原有严格矩阵／卷积数值校验和真实模型预热，保留 1.5 秒源帧新鲜度，不回退 CPU。

诊断同时保留 nativeInitialStage／nativeInitialCode 与最终 nativeStrategy，避免兼容通过后丢失最初失败信息。四像素、缓冲区及分层结果均来自固定合成输入，只在初始化时读取缓存，实际人脸检测不能覆盖。实际手机的选路、兼容性、速度及完整自动三连拍仍待版本 06 验收。

本轮 06 联合回归 204 项全部通过，其中 9 项为隔离真实 WebGL 测试。四种原生策略分别在第 1／2／3／4 次选中；模拟继承绘制状态、typed view 上传失效、viewport／scissor 坐标转换及组合情况后，实际模型和 CPU 人脸框／置信度／68 点几何对照通过。紧密 ArrayBuffer 拷贝保留子视图偏移和长度；索引绘制不执行时明确停在 constant_indexed，不会因 drawArrays 通过而准入。10 类原生故障保持注册后端／加载模型前停止，所有张量和跟踪 GPU 对象最终为 0。共享 H5 规则、模型生成及差异格式校验通过；淘宝 IDE 本地重新编译完成（DevServer: Done）。上述不能替代版本 06 的手机验收。

固定四边形的索引兼容（当前候选 07）

用户在 06 返回 nativeInitialStage=constant_indexed、VALUE_MISMATCH，由执行顺序可知标准路径清屏和普通恒色绘制已通过。索引缓冲为 12 字节，但长度不能证明其内容和原生索引执行正确。最后 buffer_copy_framebuffer_y 的 constant_arrays 黑色失败属于后续候选，不能覆盖初始故障。真实帧数、照片仍为 0。

LOCAL-FACE-20261102-07 在每次原生索引绘制前显式重新绑定索引缓冲。若标准普通绘制通过、索引数值失败，则在相同 native 策略下验证四顶点 TRIANGLE_STRIP，保持原非对称像素、字节／浮点纹理和矩阵／卷积严格自测及真实模型预热。依据固定四点与 [0,1,2,2,1,3] 的上游 TFJS 数据，第二个 strip 三角形与原第二三角形同为 (2,1,3)；这只适用于自有固定 quad。

实际转换同时要求精确的 TRIANGLES/6/UNSIGNED_SHORT/offset0 参数，以及已追踪上传的 12 字节固定索引内容。视图只读取其字节范围；未知缓冲、不同索引、数字分配、部分更新或删除后不再准入，错误为 DRAW_UNSUPPORTED。诊断明确 drawStrategy=indexed/quad_strip 和实际 strip 绘制计数；替代路径的 constantIndexed 保持 not_run，另以 constantQuad 表示替代输出，不宣称原生索引接口通过。原生自测最多 8 次且共用一个上下文，逐路释放检查对象；1500ms 新鲜度和不回退 CPU 的规则不变。手机是否能完成初始化、速度及三连拍仍待 07 验收。

本轮 07 联合回归 207 项全部通过，其中 11 项为隔离真实 WebGL 测试。模拟原生索引绘制完全无效后，标准原生策略在第 2 次原生检查选中 quad_strip，原矩阵／卷积、模型预热、实际人脸及 68 点与 CPU 几何对照通过。另验证 10 类错误调用／索引／缓冲状态均不会发出替代绘制，正确的 typed-view 字节边界仍能识别；资源和张量最终为 0。共享 H5 规则、模型生成及差异格式校验通过，淘宝 IDE 本地重新编译完成（DevServer: Done）。手机版本 07 尚未验收。

在电脑淘宝 IDE 顶部点“预览”，等待预览弹窗打开。
在弹窗内点橙色“重新编译并预览”，等待生成新二维码；仅本地重新编译不会更新旧的手机预览。
手机打开淘宝，使用“扫一扫”扫描这个新二维码，进入本次小程序预览。
在手机登录首屏点黄色“相机测试（开发版）”；已进入首页时在开发工具区点同名入口，进入普通相机诊断。
在“普通 camera · 独立诊断”确认版号 CAM-NATIVE-20261102-04，点顶部“开始自动三连拍测试”。
进入后确认版号为 LOCAL-FACE-20261102-07。若出现“开启实时相机”，点一次，并由用户处理系统相机权限。先等待基础图形检查、数值校验和模型预热，约 30 秒内无需重复点击。
将正脸居中并保持不动，等待自动倒计时及第一张拍摄；随后按页面提示分别露出右脸、左脸，完成三张自动拍摄和压缩。
卡住、报错或完成后，点页面上方的“复制识别诊断”，回到聊天粘贴文字；无需发送照片或校验颜色。后续再验证镜头切换、方向、切后台恢复及拒绝授权。
相机路线通过后，在配套服务版本下验收稳定识别 → 3 秒倒计时 → 三步完成 → 报告，分别测试游客和淘宝账号。再次核对左右脸语义与图层坐标。

已运行的验证

淘宝前后端、游客无落盘、幂等、账号隔离、AR 几何、相机生命周期及后台汇总共 61 项本地自动测试全部通过；共享 H5 评分／报告／拍摄规则哈希一致。
H5 四组浏览器回归：游客不留存、HTTPS 微信登录／退出／跨设备、报告／后台／CSV、异步侧脸图层。
Java Maven clean package，11 项测试通过；转发层原样支持新增路径，无需新增 Java 业务接口。
IDE 曾发生桌面进程崩溃；已发现 Crashpad 转储，JavaScript 日志未记录对应原因。重新打开后再次编译成功（0 错误、0 警告），未新增转储；尚未确定首次闪退根因，不直接归为 AR／GPU。

部署顺序与边界

淘宝专用 Node 已按上方“最新目标”记录备份并更新游客、签名恢复和幂等代码；H5 及小红书服务尚未更新。本轮未迁移或删除业务数据，手机完整报告及真实网关仍待验收。

先完成平台测肤资质／白名单及开放拍照组件核对，补齐采集授权；在平台支持的组件方案上通过实时识别、图像导出和三视角抓拍验收。现有 AR 验证只是其中一项技术验证。
部署淘宝专用 Node，保留独立数据目录；验证新登录／游客／三图报告，不向 H5 生产数据目录写入。
发布含本轮后台改动的 H5 管理服务，并明确配置只读 JUZI_ADMIN_TAOBAO_DATA_ROOT，保留原 nginx 管理员认证及 /tb/ 网关入口限制。
运行大报告／历史详情的真实网关与低内存手机测试。前台最近 5 份只是索引规则，后台照片和快照尚无自动清理；保留周期、备份、删除另行确定，不能直接合并两个文件目录。
验收正式／测试环境隔离、资源域名、商品详情能力、新老报告及游客回跳；关闭开发入口。按现有交接要求处理测试凭据后再正式发布。

明确未完成

平台自带算法路线的商家／ISV 资质和白名单状态确认、正式拍照组件契约、品牌采脸授权及平台结果字段适配。
普通相机在手机上的本地模型耗时、转头方向、覆盖层和完整自动三连拍。AR 保留为可选对照，其默认自拍和图像导出仍未验收。
手机上的新游客接口和原系统相机报告故障最终复验（本地回归已覆盖，线上尚未更新）。
固定商品真机跳转、真实网关大响应及后台跨源上线配置。
照片保留／清理周期、数据库／对象存储迁移；本轮没有自动删除旧数据。

73 KiB Raw Blame History Unescape Escape