---
title: "QoderCN 蓝湖 MCP 1:1 像素级前端还原工作流"
date: 2026-10-29
description: "蓝湖 MCP 不是设计稿搬运工，而是像素级还原的审计链。核心原则只有一条：不脑补、不自作聪明。取值靠 JSON，切图先验货，字体先等 document.fonts.load，架构用 React 18 + Vite 5 + TS 严格模式，验收以 bbox 误差 ≤0.5 CSS px 和全页平均 RGB 偏差 ≤8 为硬指标。"
canonical_url: "https://yijinlee.com/articles/article-75"
tags:
  - "AI Coding"
  - 蓝湖
  - MCP
  - "React 18"
  - "Vite 5"
  - TypeScript
  - 像素级还原
  - 前端工程化
topic: "AI 外骨骼"
---

核心原则：不脑补、不自作聪明。像素差 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` 必过，清掉临时测量脚本。

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