← 返回文章列表
所属专题:AI 外骨骼

QoderCN 蓝湖 MCP 1:1 像素级前端还原工作流

by李奕锦年份:2026字数:1,450阅读时长:5 分钟

像素级还原不是“看着像”,而是每个字号、行高、色值、圆角都有 JSON 来源,每个切图都经过核验,每个字体宽度都在 document.fonts.load 之后测量。

AI Coding · 蓝湖 MCP · 像素级还原

核心原则:不脑补、不自作聪明。像素差 1px 也是差,机器对比不讲情面。

取值 · 切图

取值与切图:JSON 说话,先验货

1取值:JSON 说话,拒绝肉眼猜

  • 调 lanhu_resolve_link 和 lanhu_get_design 抓元数据。字号、行高、色值、圆角全以 JSON 为准。
  • 遇到设计漏标的字段,别凭感觉蒙。在 @2x 原图上跑脚本算墨迹包围盒(ink bbox);所有推测值在测量表单列,查不到的丢进「未知清单」,别把假设当事实。

2切图:先验货,别手贱

  • lanhu_download_slices 下载全部切图,一张张打开核验。
  • Logo、图标、复杂光晕能用切图就用切图。少用 CSS 拟合复杂渐变——肉眼看着像,逐像素对比一跑全是噪点。
字体 · 架构

字体与架构:防踩深坑,自动化对比

3字体:防踩“字距调教”的深坑

  • 字体名以设计稿为准。测算回退字宽前,必须先 await document.fonts.load(),否则测出来的全是一个宽度。
  • 严禁“优先调用 iOS 苹方,却按安卓 Roboto 的字宽去调 letter-spacing”,这在苹果设备上会挤成一团。文字容器与设计稿宽度差死磕在 ≤2 CSS px 内。

4架构与自动化对比闭环

  • 栈:React 18 + Vite 5 + TS(严格模式),极简依赖(≤3),写 1x CSS。
  • 无头渲染:Chromium 最小窗口约 500 CSS px,别硬设 375×812。开放大窗口(800×900)+ 2x 缩放渲染,以“主按钮”等关键元素为锚点裁切出 750×1624。
  • 验收硬指标:关键框线/图标 bbox 误差 ≤0.5 CSS px(1 设备像素);全页平均 RGB 偏差 ≤8。
交互 · 交付

交互与交付:诚实比好看更重要

5交互与交付:诚实比好看更重要

  • 跑自动化验证:Tab 切换保留表单内容、校验拦截、禁用态渐变平滑、Console 零报错。
  • 测不了的视觉细节老实交代,别拿假截图糊弄。
  • npm run build 必过,清掉临时测量脚本。

交付物:可直接跑的工程 + 产物 + 三栏验收报告(已验证实测数据 / 算法推断与近似 / 平台差异与未知项)。

本文属于 AI 实用主义流派 的第 56 篇肉身实战。

阅读时长:5 分钟


文档信息

版权声明:自由转载-非商用-非衍生-保持署名(CC BY-NC-ND 3.0)

原文链接:https://yijinlee.com/articles/article-75

作者:李奕锦

商业用途或修改衍生请联系授权。


李奕锦
李奕锦

全栈工程师,业余马拉松选手。

Tags:AI Coding蓝湖MCPReact 18Vite 5TypeScript像素级还原前端工程化

该专题下的阅读路径

AI Coding架构排障

常见问题 FAQ

Q1. 为什么取值必须靠 JSON,而不是肉眼量?
肉眼量图会引入系统误差:缩放、屏幕像素排列、子像素渲染都会让“看起来对”变成“实际差 1px”。JSON 元数据是设计稿的唯一事实来源,字号、行高、色值、圆角都应以 lanhu_get_design 返回的字段为准。
Q2. 字体宽度测量前为什么要 await document.fonts.load()?
在字体未加载完成前,getBoundingClientRect 拿到的是回退字体(如 sans-serif)的宽度。若此时调 letter-spacing,等真实字体加载后字宽会变化,导致苹果设备上文字挤成一团。
Q3. 自动化验收的硬指标是什么?
关键框线/图标 bbox 误差 ≤0.5 CSS px(即 1 设备像素@2x),全页平均 RGB 偏差 ≤8。达不到就继续调,不能凭感觉说“差不多”。
Q4. 为什么复杂光晕和 Logo 要尽量用切图?
CSS 渐变是人眼拟合,逐像素对比时会在高光、边缘、半透明叠加处产生噪点。切图是设计稿的原始像素表达,验收风险最低。

发表评论

分享你的想法和反馈

支持 Markdown 格式

0/5000