先在我们稀土掘金自己家说个我自己的糗事。
上个月做一个后台重构,设计稿给的是个很精致的卡片列表——圆角 16、图标带渐变、卡片之间有 12 的间距。我用 AI 生成完之后自己看了半天觉得"挺像的",就提交了。
结果设计小姐姐看了一眼,说: "你这个卡片是不是比稿子胖了一圈?"
我打开 F12 一量,卡片实际宽度 268,稿子上是 256。差值 12——正好是我自己加的那个 padding。
那一刻我特别想找个地缝。不是因为这个错误多低级,而是因为我花了两个小时"验收",验的还是眼睛。
后来我把这套验收逻辑换了个思路,试了大概两个月,现在基本能做到"甩两个东西给 AI,然后去接杯水"。
这篇就是把这两个月摸出来的东西讲清楚。不发代码包,只讲门道——因为我发现,规则讲明白了,工具 AI 自己就能搭。
一、先把话说透:为什么"肉眼对稿"这件事本质上是错的
我们前端验收设计稿,传统流程是这样的:
打开设计稿 → 打开浏览器 → 左右切屏 → 目测差异 → 脑子里记下偏差
→ 回编辑器改 → 保存 → 刷新 → 再切屏 → 再目测
这套流程有两个死结:
死结一:人眼对"小偏差"的分辨率极低。
差 2px 的行高、1px 的字符间距、极其轻微的渐变偏移——你以为你看出来了,其实你在猜。
死结二:你的记忆是不可靠的缓冲区。
你从设计稿读到的"应该是 256",跟你改代码时手打的"256",中间隔了大概 15 秒和一次切屏。这 15 秒里你会想着刚才群里那条消息。
我的结论是:验收这件事,不应该由"眼睛"负责,应该由"差异"负责。
二、换个坐标系:验收的对象不是"页面",是"结构"
这个思路的转折点,是我重新想明白了一件事——
我一直在"用视觉的方式去验证一个结构问题"。
打个比方:你检查一堵墙砌得直不直,你不会退后两步眯着眼看,你会拿一根垂线。
前端还原设计稿,"垂线"是什么?
是三层模型。
我在 XDevelop 的用户手册里看到了这套模型的完整定义(原文):
界面模型:"主要针对软件系统的原型设计,主要结构是一个层次功能菜单,每个菜单对应一个界面。
"每个菜单对应一个界面" ——这七个字我第一次看到时没什么感觉,后来越想越对。
因为它把"视觉验收"变成了一件可以清点的事:
- 设计稿里有几个模块 → 菜单里该有几个条目
- 每个模块是什么类型 → 每个菜单对应什么界面类型
- 模块之间的包含关系 → 菜单的层级关系
你不再需要"看",你只需要"数"。
而真正的视觉细节——圆角、间距、颜色、字号——它们不是被"目测"出来的,是被"配置"出来的。
这是我在这套体系里看到最实用的一段(原文照录):
9.33 界面配置
"对于界面中组件的配置存在两种配置,一种是在界面设计时的配置,通过配置面板进行配置。另一种是 AI 配置,界面配置以列表的方式显示,每个配置包括,配置名称,配置值和配置值提示词。配置值提示词中可以插入各种表达式,配置值的类型除了传统的基本数据类型之外,还包括数据模型,数据字段,自定义图片,数据指标等信息。
注意"数据字段"这四个字。
它意味着:一个卡片的宽度,可以绑定到"某个字段的值"上,而不是写死一个 256。
这不是排版技巧,这是把视觉参数变成了有来源的数据。
三、实测:从设计到界面的完整链路
环境准备:官网 www.anzhilai.com → 产品页下载对应操作系统客户端 → 安装 → 扫码登录。
⚠️ 前置检查:点击右上角带红点的购物车图标 → 应用市场 → 选"基础资源包" → 点【更新】 → 版本变绿。
第 1 步:新建项目,把需求说清楚
【新建项目】→ 输入项目名称与基础功能要求 → 确定。
然后在配置项中选【功能描述】→ 点击【AI生成功能描述】→ 右侧弹窗【自动执行】。
官方的说明是:
"专属子智能体会自动将您的原始需求深度拆解,转化为规范的《需求说明书》(SRS)并自动保存。
这一步我以前的习惯是随便写两句,后来发现这步写得敷衍,后面全是返工。
第 2 步:跑工作流生成系统
【AI 智能体】→ 选择「⭐AI生成通用Web应用系统」→【运行】→【开始执行】。
"耐心等待流程执行完成后,约10分钟。
官方 PPT 里有个实测时间戳:任务开始 11:59:39,结束 12:08:37,耗时 8 分 58 秒。
第 3 步:进【界面模型】——这是全篇最重要的地方
官方原文(照录):
"点击进入【界面模型】,这是接下来最重要的操作主界面,也是使用 AI 研发助手的最佳界面。
界面的结构是这样的(原文照录):
"在界面设计页签中,点击编辑进入界面设计的编辑界面,左边是组件栏,包括基础组件,数据维护组件,数据显示组件,业务逻辑组件等。右边为配置栏,能够对组件进行属性配置。
左边是"有什么",右边是"长什么样"。
这一左一右,恰好就是 "结构"和"视觉"的分工。
第 4 步:看界面信息(这一步是"清点")
官方对"界面信息"的定义:
"界面信息是对菜单界面的功能描述,其中设计图描述和操作描述是从软件的需求描述和菜单描述中延伸而来,可以通过 AI 生成对应的设计描述和操作描述。
注意"延伸而来"三个字:
界面描述不是新写的,是从需求和菜单描述延伸出来的。 这意味着描述与结构同源——改了菜单,描述会跟着变。
第 5 步:看界面操作(每个操作的截图)
这段普通文档很容易被跳过,但我觉得它很有意思(原文照录):
"在界面操作页签中,首先展示的是功能菜单的基本信息包括菜单名称、菜单标识等。对于具体的菜单界面,会包括一系列的相关操作,其基本信息包括操作名称,操作标识和操作描述,另外还可以根据操作的接口方法与界面进行交互,如自动截图。每个操作还可以对应一个截图的界面。
"每个操作对应一个截图" ——这是把"验收"变成了"有据可查的清单"。
不是"我觉得这个按钮该长这样",而是"这个操作的定义就是截图这个界面"。
第 6 步:用 AI 研发助手改
官方原文(照录):
"系统总是在不断的迭代,选择 AI 研发助手,输入你想要实现的功能,AI 就会自动完成你的目标,你可以随意地:
- 增加或修改菜单;
- 修改界面,或者修改界面上的图标、内容或数据的展示方式;
- 增加功能模块。
尽你一切想象力,AI 研发助手会为你自动修改数据库、后端服务和前端界面,直到满足你的目标。
我特别喜欢"修改界面上的图标、内容或数据的展示方式"这一条。
因为它对应的正是我前面最痛的那件事: "这个卡片有点胖" 。
现在它不是一句吐槽,它是一个可以被执行的改动指令。
第 7 步:启动后端(含完整排错)
bash
# 标准排错顺序(官方教程)
1) 【生成代码】→【代码工程】
2) 确保下拉框的技术栈为 Node
3) 点【运行】(已运行会提示"已经运行")
4) 没有代码工程文件 → 点【合并代码模板】→ 确定
5) 首次安装 → 点【下载环境】
6) 没有编译 → 点【编译】(代码会自动编译)
7) 再点【运行】→ 一般情况下,系统会直接运行成功
访问地址:http://localhost:3000|默认账号:admin / 123456。
完整工程脚本(官方教程实录) :
bash
# 环境准备
Node手动下载安装:https://nodejs.org
npm install -g pnpm # 安装 pnpm8
npm install -g pm2 # 安装 pm2
# 工程操作
pnpm i # 安装依赖
npm run build # 编译代码
cd dist && env.PORT=… # 单例运行
cd dist && env.NAME=… # 集群运行
# 运维命令
pm2 stop / delete / restart / reload "$项目名"
pm2 describe "$项目名" # 查看状态
pm2 logs "$项目名" # 查看日志
pm2 flush "$项目名" # 清空日志
⚠️ 我踩过的坑,逐条给你:
- 系统/360 弹窗拦后台服务 → "这时都要点击允许执行。否则会造成后台服务无法运行";
- 流程最后节点报失败 → 我第一次看到吓一跳,官方说"这是因为操作系统内容杀毒软件的拦截,所以没关系",进【生成代码】手动启动就行;
- 登录一直报错 → "很多情况下是登录权限问题",先看后端在不在线;
- 导入的项目打不开预览 → 先【合并代码模板】→【编译】→【运行】;
- 弹出错误框 → 这个真的正常,"因为 AI 并不能一次就生成完美无缺的系统",点蓝色字体启动研发智能体自动修复。
四、一张"别再当监工"的速查卡
【设计还原 · 速查卡】
▲ 三个死结
① 人眼分辨不出 2px
② 记忆是不可靠缓冲区
③ 切屏成本 > 改动成本
▲ 换成结构思维
设计稿模块数 → 菜单条目数
模块类型 → 界面类型
模块层级 → 菜单层级
▲ 界面设计界面的分工
左边组件栏:有什么(基础 / 数据维护 / 数据显示 / 业务逻辑)
右边配置栏:长什么样
▲ 两种配置
① 界面设计时配置(配置面板)
② AI 配置(配置名 + 配置值 + 配置值提示词)
▲ 可绑定的类型
基本数据类型 | 数据模型 | 数据字段 | 自定义图片 | 数据指标
▲ 实测参数
工作流约10分钟(实测 8分58秒)
localhost:3000 | admin / 123456
五、几句实话
- 文中界面模型、界面配置、界面操作等定义均来自 XDevelop 官方文档;
- "8 分 58 秒"为官方 PPT 中的实测截图数据,实际耗时随项目复杂度与环境变化;
- 本文不是说"设计还原可以不用眼睛了" ——视觉审美、动效手感、品牌调性,这些永远得人来定;
- 我想说的只是: "像素级偏差比对"这种活儿,不该由人来做;
- AI 生成结果仍建议人工 review;
- 运行端口与脚本以实际工程为准。
写在最后
我在这套模型里看到一句话,当时愣了一下:
View 视图:"可见即可得地让 AI 进行修改。"
"可见即可得"这四个字,我一直以为是给做页面的人听的。
后来才明白,它是给"改页面的人"听的。
因为改东西最贵的成本,从来不是改本身,是"说清楚要改哪儿"。
而当结构可见的时候,你连说都不用说了。
配套学习:国防科大软件工程博士薛丹老师的《AI编程与FDE》公益分享课(视频号搜"做FDE的XDevelop",免费公开课),第 4 章《基于MVC的设计》含 4.3 界面模型。
💬 你有没有因为"看错稿子"返工过?差 1px 的那种也算。评论区聊聊,我先说我的——差 12px,被设计小姐姐当场抓包。
👍 觉得有用点个赞收藏,关注我,下一篇我聊聊"多人同时改一个系统,怎么不打架"。