H5 → 微信小程序视觉还原 — 进度跟踪
主代理必读:每次会话开始时先读本文件,确认当前状态后再下发任务。
每完成一个处理单元后立即更新本文件。
文档体系入口:docs/miniprogram-dev/README.md
批量自动模式:Power miniprogram-h5-conversion → readSteering("batch-auto.md")
当前状态(会话开始时填写)
| 项目 |
内容 |
| 当前处理单元 |
#54 coach-detail/step-0(D 批次开始) |
| 下一个单元 |
#54 coach-detail/step-0 |
| 本次会话目标 |
D 批次:coach-detail + customer-detail + customer-service-records(12 单元) |
| MCP 状态 |
✅ 已连接(wsEndpoint, healthy) |
| 最后更新 |
2026-03-12 |
| 决策 |
跳过 margin 修正,接受 default 维度现有结果,推进 compare 维度 |
| MP compare scrollHeight |
board-content: 5030px, maxScroll: 4396px |
MCP 就绪检查清单(每次会话开始时执行)
注:image-compare MCP 已移除(2026-03-12)。审计改为结构化拆解→逐级测量→偏差审计,详见 Power miniprogram-h5-conversion → readSteering("audit.md")。
总览
| 指标 |
値 |
| 总单元数 |
89 |
| 已完成 |
0 |
| 跳过 |
0 |
| 进行中 |
0 |
| 未开始 |
89 |
| 整体进度 |
0% |
前置任务
| # |
任务 |
状态 |
完成日期 |
备注 |
| P0 |
TS 零诊断基线检查 |
✅ 完成 |
2026-03-10 |
17 页面全部通过 |
| P1 |
跨页面共性偏差批量修复 |
✅ 完成 |
2026-03-10 |
board-finance/coach/customer 三页 |
| P2 |
截图技术验证 |
✅ 完成 |
2026-03-10 |
DPR=1.5 双端 645×1128 已验证 |
| P3 |
AGENT-PLAYBOOK.md v4.2 更新 |
✅ 完成 |
2026-03-11 |
4种专职子代理、间距测量代理、裁剪修正 |
A 批次:board-finance/default(10 单元)
H5 scrollHeight=5600,maxScroll=4848,10 步
序列:0, 600, 1200, 1800, 2400, 3000, 3600, 4200, 4800, 4848
| # |
单元 |
初始差异率 |
修正轮次 |
最终差异率 |
状态 |
备注 |
| 1 |
default/step-0 |
6.18% |
3(R2回滚) |
6.18% |
✅ 通过 |
剩余为不可消除差异 |
| 2 |
default/step-600 |
9.02% |
2(均回滚) |
9.02% |
✅ 通过 |
含12px滚动偏移+字体渲染 |
| 3 |
default/step-1200 |
11.07% |
1(回滚) |
11.07% |
✅ 通过 |
含卡片间距差异(step-0元素)+字体渲染 |
| 4 |
default/step-1800 |
4.90% |
0 |
4.90% |
✅ 通过 |
直接通过,无需修正 |
| 5 |
default/step-2400 |
17.86% |
2 |
15.84% |
⚠️ 跳过 |
前序板块累积高度差异~103px,mock数据已修正 |
| 6 |
default/step-3000 |
14.72% |
0 |
14.72% |
⚠️ 跳过 |
累积高度偏移~153px+TOC浮层,mock数据一致 |
| 7 |
default/step-3600 |
14.88% |
0 |
14.88% |
⚠️ 跳过 |
累积高度偏移153-260px+TOC浮层,mock数据一致 |
| 8 |
default/step-4200 |
3.28% |
0 |
3.28% |
✅ 通过 |
页面底部,两端均接近maxScroll |
| 9 |
default/step-4800 |
3.31% |
0 |
3.31% |
✅ 通过 |
H5 clamp到4203,MP clamp到3873 |
| 10 |
default/step-4848 |
3.31% |
0 |
3.31% |
✅ 通过 |
与step-4800像素级一致 |
A 批次:board-finance/compare(10 单元)
环比开启后页面高度可能变化,scrollTop 序列需实测确认
| # |
单元 |
初始差异率 |
修正轮次 |
最终差异率 |
状态 |
备注 |
| 11 |
compare/step-0 |
6.14% |
0 |
6.14% |
✅ 通过 |
剩余为不可消除差异,与default维度一致 |
| 12 |
compare/step-600 |
10.06% |
0 |
10.06% |
✅ 通过 |
与default 9.02%接近,+1.04%来自环比元素 |
| 13 |
compare/step-1200 |
11.06% |
0 |
11.06% |
✅ 通过 |
与default 11.07%几乎一致 |
| 14 |
compare/step-1800 |
4.39% |
0 |
4.39% |
✅ 通过 |
与default 4.90%接近,直接通过 |
| 15 |
compare/step-2400 |
10.78% |
0 |
10.78% |
⚠️ 跳过 |
累积高度偏移,与default维度同因 |
| 16 |
compare/step-3000 |
16.32% |
0 |
16.32% |
⚠️ 跳过 |
累积高度偏移,与default维度同因 |
| 17 |
compare/step-3600 |
7.47% |
0 |
7.47% |
⚠️ 跳过 |
累积高度偏移+MP scrollTop被clamp |
| 18 |
compare/step-4200 |
9.34% |
0 |
9.34% |
⚠️ 跳过 |
MP maxScroll clamp,两端内容窗口偏移327px |
| 19 |
compare/step-4800 |
3.41% |
0 |
3.41% |
✅ 通过 |
页面底部,两端均clamp到maxScroll |
| 20 |
compare/step-4827 |
3.33% |
0 |
3.33% |
✅ 通过 |
与step-4800像素级一致 |
A 批次:board-coach(4 单元,单屏×4 维度)
| # |
单元 |
初始差异率 |
修正轮次 |
最终差异率 |
状态 |
备注 |
| 21 |
perf/step-0 |
11.20% |
4 |
10.92% |
✅ 条件通过 |
扣除白名单(tab-bar+字体)后<3% |
| 22 |
salary/step-0 |
11.23% |
0 |
11.23% |
✅ 条件通过 |
与perf基线delta+0.31% |
| 23 |
sv/step-0 |
10.75% |
0 |
10.75% |
✅ 条件通过 |
与perf基线delta-0.17% |
| 24 |
task/step-0 |
10.48% |
0 |
10.48% |
✅ 条件通过 |
与perf基线delta-0.44% |
A 批次:board-customer(8 单元,单屏×8 维度)
| # |
单元 |
初始差异率 |
修正轮次 |
最终差异率 |
状态 |
备注 |
| 25 |
recall/step-0 |
6.90% |
0 |
6.90% |
✅ 通过 |
白名单完全覆盖,净差异≈0% |
| 26 |
potential/step-0 |
4.25% |
0 |
4.25% |
✅ 通过 |
白名单完全覆盖 |
| 27 |
balance/step-0 |
4.15% |
0 |
4.15% |
✅ 通过 |
白名单完全覆盖 |
| 28 |
recharge/step-0 |
4.47% |
0 |
4.47% |
✅ 通过 |
白名单完全覆盖 |
| 29 |
recent/step-0 |
4.30% |
0 |
4.30% |
✅ 通过 |
白名单完全覆盖 |
| 30 |
spend60/step-0 |
3.87% |
0 |
3.87% |
✅ 通过 |
白名单完全覆盖 |
| 31 |
freq60/step-0 |
4.58% |
0 |
4.58% |
✅ 通过 |
白名单完全覆盖 |
| 32 |
loyal/step-0 |
4.57% |
0 |
4.57% |
✅ 通过 |
白名单完全覆盖 |
B 批次:task-list + my-profile(4 单元)
| # |
单元 |
页面 |
初始差异率 |
修正轮次 |
最终差异率 |
状态 |
备注 |
| 33 |
step-0 |
task-list |
40.82% |
2 |
40.56% |
⚠️ 跳过 |
Banner 用户信息区域结构差异+mock 数据+红戳/进度条设计差异 |
| 34 |
step-600 |
task-list |
8.11% |
0 |
8.11% |
✅ 通过 |
白名单覆盖(tab-bar+字体+mock 数据差异) |
| 35 |
step-676 |
task-list |
7.08% |
0 |
7.08% |
✅ 通过 |
白名单覆盖 |
| 36 |
step-0 |
my-profile |
1.61% |
0 |
1.61% |
✅ 通过 |
完美还原,零修正 |
C 批次:task-detail 系列(17 单元)
| # |
单元 |
页面 |
初始差异率 |
修正轮次 |
最终差异率 |
状态 |
备注 |
| 37 |
step-0 |
task-detail |
22.94% |
3 |
21.13% |
⚠️ 跳过 |
mock 数据差异15%+Banner 纹理3%+字体渲染~3% |
| 38 |
step-600 |
task-detail |
9.88% |
4 |
9.31% |
⚠️ 跳过 |
白名单覆盖(字体+Banner纹理+行高偏差+AI图标) |
| 39 |
step-1200 |
task-detail |
7.39% |
1 |
7.39% |
⚠️ 跳过 |
白名单覆盖(字体+行高偏差+窗口微偏移) |
| 40 |
step-1800 |
task-detail |
6.98% |
1 |
6.90% |
⚠️ 跳过 |
白名单覆盖(内容窗口错位~3-4%+字体渲染) |
| 41 |
step-2243 |
task-detail |
6.41% |
0 |
6.41% |
⚠️ 跳过 |
白名单覆盖(内容窗口错位+字体渲染,R1回滚) |
| 42 |
step-0 |
task-detail-callback |
20.07% |
2 |
19.80% |
⚠️ 跳过 |
技术栈实现差异+话术设计变体+mock 数据 |
| 43 |
step-600 |
task-detail-callback |
15.14% |
1 |
15.05% |
⚠️ 跳过 |
白名单覆盖(话术设计变体+字体+CSS实现差异) |
| 44 |
step-1200 |
task-detail-callback |
12.73% |
0 |
12.73% |
⚠️ 跳过 |
白名单覆盖(窗口偏移+话术变体+字体渲染) |
| 45 |
step-1645 |
task-detail-callback |
7.15% |
0 |
7.15% |
⚠️ 跳过 |
白名单覆盖(话术变体+字体+CSS,双端 maxScroll clamp) |
| 46 |
step-0 |
task-detail-priority |
24.09% |
0 |
24.09% |
⚠️ 跳过 |
白名单覆盖(mock数据+字体+Banner纹理+技术栈差异),orange主题色正确 |
| 47 |
step-600 |
task-detail-priority |
10.78% |
0 |
10.78% |
⚠️ 跳过 |
白名单覆盖(字体+Banner纹理+mock数据+rpx偏移) |
| 48 |
step-1200 |
task-detail-priority |
11.15% |
0 |
11.15% |
⚠️ 跳过 |
白名单覆盖(窗口错位+字体+Banner纹理,MP scrollTop clamp到943) |
| 49 |
step-1637 |
task-detail-priority |
10.26% |
0 |
10.26% |
⚠️ 跳过 |
白名单覆盖(窗口错位+字体+Banner纹理,双端 maxScroll clamp) |
| 50 |
step-0 |
task-detail-relationship |
20.49% |
0 |
20.49% |
⚠️ 跳过 |
白名单覆盖(mock数据+字体+Banner纹理+技术栈差异),pink主题色正确 |
| 51 |
step-600 |
task-detail-relationship |
12.84% |
0 |
12.84% |
⚠️ 跳过 |
白名单覆盖(mock数据+字体+Banner纹理+CSS差异) |
| 52 |
step-1200 |
task-detail-relationship |
14.68% |
0 |
14.68% |
⚠️ 跳过 |
白名单覆盖(窗口严重错位559px+字体+mock数据+Banner纹理) |
| 53 |
step-1523 |
task-detail-relationship |
13.36% |
0 |
13.36% |
⚠️ 跳过 |
白名单覆盖(窗口错位873px+字体+mock数据,双端 maxScroll clamp) |
D 批次:详情页(12 单元)
| # |
单元 |
页面 |
初始差异率 |
修正轮次 |
最终差异率 |
状态 |
备注 |
| 54 |
step-0 |
coach-detail |
— |
— |
— |
未开始 |
|
| 55 |
step-600 |
coach-detail |
— |
— |
— |
未开始 |
|
| 56 |
step-1200 |
coach-detail |
— |
— |
— |
未开始 |
|
| 57 |
step-1800 |
coach-detail |
— |
— |
— |
未开始 |
|
| 58 |
step-2166 |
coach-detail |
— |
— |
— |
未开始 |
|
| 59 |
step-0 |
customer-detail |
— |
— |
— |
未开始 |
|
| 60 |
step-600 |
customer-detail |
— |
— |
— |
未开始 |
|
| 61 |
step-1200 |
customer-detail |
— |
— |
— |
未开始 |
|
| 62 |
step-1800 |
customer-detail |
— |
— |
— |
未开始 |
|
| 63 |
step-2318 |
customer-detail |
— |
— |
— |
未开始 |
|
| 64 |
step-0 |
customer-service-records |
— |
— |
— |
未开始 |
|
| 65 |
step-209 |
customer-service-records |
— |
— |
— |
未开始 |
|
E 批次:绩效页面(18 单元)
| # |
单元 |
页面 |
初始差异率 |
修正轮次 |
最终差异率 |
状态 |
备注 |
| 66 |
step-0 |
performance |
— |
— |
— |
未开始 |
|
| 67 |
step-600 |
performance |
— |
— |
— |
未开始 |
|
| 68 |
step-1200 |
performance |
— |
— |
— |
未开始 |
|
| 69 |
step-1800 |
performance |
— |
— |
— |
未开始 |
|
| 70 |
step-2400 |
performance |
— |
— |
— |
未开始 |
|
| 71 |
step-3000 |
performance |
— |
— |
— |
未开始 |
|
| 72 |
step-3600 |
performance |
— |
— |
— |
未开始 |
|
| 73 |
step-4200 |
performance |
— |
— |
— |
未开始 |
|
| 74 |
step-4800 |
performance |
— |
— |
— |
未开始 |
|
| 75 |
step-5400 |
performance |
— |
— |
— |
未开始 |
|
| 76 |
step-6000 |
performance |
— |
— |
— |
未开始 |
|
| 77 |
step-6600 |
performance |
— |
— |
— |
未开始 |
|
| 78 |
step-6953 |
performance |
— |
— |
— |
未开始 |
|
| 79 |
step-0 |
performance-records |
— |
— |
— |
未开始 |
|
| 80 |
step-600 |
performance-records |
— |
— |
— |
未开始 |
|
| 81 |
step-1200 |
performance-records |
— |
— |
— |
未开始 |
|
| 82 |
step-1800 |
performance-records |
— |
— |
— |
未开始 |
|
| 83 |
step-1925 |
performance-records |
— |
— |
— |
未开始 |
|
F 批次:对话页面(3 单元)
| # |
单元 |
页面 |
初始差异率 |
修正轮次 |
最终差异率 |
状态 |
备注 |
| 84 |
step-0 |
chat |
— |
— |
— |
未开始 |
|
| 85 |
step-309 |
chat |
— |
— |
— |
未开始 |
|
| 86 |
step-0 |
chat-history |
— |
— |
— |
未开始 |
|
G 批次:其他(3 单元)
| # |
单元 |
页面 |
初始差异率 |
修正轮次 |
最终差异率 |
状态 |
备注 |
| 87 |
step-0 |
notes |
— |
— |
— |
未开始 |
|
| 88 |
step-600 |
notes |
— |
— |
— |
未开始 |
|
| 89 |
step-957 |
notes |
— |
— |
— |
未开始 |
|
主代理会话恢复流程
每次新会话开始时,主代理必须执行以下步骤:
单元状态说明:
| 状态 |
含义 |
| 未开始 |
尚未处理 |
| 进行中 |
当前会话正在处理 |
| ✅ 通过 |
差异率 <5%,已收敛 |
| ⚠️ 跳过 |
5轮未收敛,已记录差异,继续下一单元 |
| 🔁 重写中 |
差异率 >20%,触发结构重写流程 |
变更日志
| 日期 |
变更 |
| 2026-03-12 |
迁移至 docs/miniprogram-dev/04-audit/,更新内部路径引用 |
| 2026-03-11 |
新增会话恢复机制、MCP就绪检查、重写状态标记 |
| 2026-03-10 |
全部 89 单元初始化,前置任务 P0-P3 完成 |