不写 CSS,我用 Ardot + Codex 把混乱的界面重构了一遍
产品经理分享用 Ardot 可编辑画布配合 Codex,通过 MCP 将设计稿转为代码并重构混乱界面的实践流程。

本文来自「Ardot 案例征集活动」| 作者:产品经理 @小胡
导读
这是一位产品经理的真实实践。他用 Ardot 的本地 MCP,把设计规划、可编辑画布和本地代码实现接到了一起。文中他选用 Codex,Ardot MCP 同样支持 WorkBuddy、Codebuddy、Cursor、Claude Code 等 Agent,换成你习惯的那个,流程一样成立。
近期我正在开发一个小项目,为了快速跑通核心流程,早期只建立了一份简单的设计规范,所有的页面都是 Agent 直接生成。
功能虽然实现了,但项目不同页面的设计却十分混乱。字体、字号、间距没有统一,组件该复用的没有复用,不同页面甚至遵循着不同的排版方式。
实际上,这些要求在设计规范中都有明确,然而对于 Agent 来说,「一个页面就是一次设计」,很容易把不同页面当成相对独立的设计任务。仅靠文档约束,很难保证多个页面始终遵循同一套规则。
这也是我本次想分享的内容,怎样把设计规划、Ardot 设计稿和本地代码实现接到一起,以及这个过程里哪些地方仍然需要自己把控。

整个过程中,我既让 Codex 操作 Ardot,也亲自改过画布。组件怎么复用、间距怎么算、菜单面板多大合适,都经过了反复调整。已经落到代码里的部分,也还在实测和修正,并没有全项目验收完成。
正因为走过这些来回,我觉得这条流程值得写出来。为想用 Codex 做一个小产品,又希望能自己把握界面的人,提供可供参考的实践经验。
01 在画页面之前,先整理这次要改什么
我先让网页端的 ChatGPT 读取代码仓库,基于项目现状形成了一份 UI 改版交付包,里面包含目标规范、逐页方案和后续 Ardot 工作流。
在要求 ChatGPT 提供方案时,我提前将自己的完整计划(实际上就是本次要分享的完整工作流)同步给它,以便于它帮助我划分阶段,提供针对性的规划文档。

之后把这份交付包交接给 Codex,先让它知道哪些决策已经存在,哪些地方还没有决定。
这一步最容易漏的是界面背后看不见的约定。应用已经实现了核心流程,哪些输入可以为空,关闭窗口以后内容要不要保留,哪个操作需要确认,这些不能因为重新画了一套页面就丢掉。

我把前期需要交代的事情归成了三类:
页面要帮助用户完成什么。比如设置页,需要明确分类怎样组织、标题和内容如何排列、长内容怎样滚动。
多个页面共同遵守什么视觉规则。字体层级、颜色用途、留白和按钮尺寸。
已有行为中哪些不能随改版改变。已经存在的保存、同步与计时行为,要继续沿用。
我还要求把工作拆成适合快速执行和检查的小包:先落文档,再做样板,确认后扩展页面,代码也分批实现。限制每次改动的范围,方便我在交付后快速验证。
在本地协作时,我让 GPT-5.6-Sol-high 作为主对话的模型,负责整体方案、进度和检查,再把明确的小任务交给执行子代理(Luna-max)。因为原型生成的过程需要截图验证,涉及到多模态非常消耗 Token,这套组合能够让我放心将任务交给 Agent,而不用担心额度快速消耗。
如果要借用这套方法,可以使用下面的 Prompt 作为起点。先让 Agent 了解项目和你的完整计划,之后再根据它给出的方案逐步细化。
我计划对「项目」完成一次完整的 UI/UX 重构。
我会让本地 Agent 根据新的规范和实现方案,先通过 Ardot(Tencent 出品的设计软件)MCP 本地工具,将页面复现出来,并由我手动调整,之后让本地 Agent 根据设计好的原型页面,通过 Ardot MCP 本地工具反向优化项目代码。
请你先阅读现有项目和设计资料,列出这次要改的页面、需要保留的行为,以及缺少的信息。
02 Agent 怎样在 Ardot 里工作
本次连接用的是 Ardot 本地 MCP(Model Context Protocol)。连接好之后,我在 Ardot 里创建了一个空白文件,让 Codex 按前面的方案开始制作。配置方式可以参考 Ardot 本地 MCP 文档[1]。
正式开工前,我建议先让 Agent 报出它读到的文件和页面名称,核对是不是你准备使用的那个文件。比起看到一个已连接的标记,这更能确认双方正在看同一份内容。
它会读取当前文件和画布,建立容器、文字、按钮与组件,设置布局关系,然后重新读取结果。除了页面截图,还能查看里面有哪些对象,以及对象之间怎样排列。
每次我发布指令后,Codex 会读取对应的页面,确定这次改哪一部分,执行修改,再回读布局和截图。我检查结果,有问题就针对那一处继续调整。
对我来说,可编辑画布的价值在这里变得很明显。看到按钮位置不合适,我可以直接移动。觉得图表太矮,可以调整它占用的空间。想删除一个多余对象,也可以自己删掉,再让 Codex 读取修改后的状态。
审美判断因此有了一个具体的落点。相比反复解释「再紧凑一点」「这个地方不协调」,我能先把想要的效果摆出来。
03 先把一张样板调顺,再让其他页面跟上
我让 Agent 先在 Ardot 中实现了一组设置样板供我检查。它们包含普通设置,也包含内容较长、步骤较多的页面,可以用来观察同一套规则在不同内容下是否成立。

样板阶段的问题很具体。有的分组标题和设置项没有左对齐,有的页面选中状态用了另一种控件,有的按钮放在设置里显得太大。还有些地方出现了制作过程说明,看起来仍然像待完成的草稿。
即便要求把共性内容做成组件,也很难解决所有不一致。一个组件本身合理,放进另一个容器以后,仍然可能出问题。
我遇到过一个很典型的例子:外层分组设置了 12pt 的水平留白,里面的设置行也设置了 12pt,两层叠在一起,文字离边缘就变成了 24pt。
更麻烦的是,Agent 为了实现“页面内对象水平间距 12pt”这条规范,在不同页面上采用了不同的局部处理:有的单独调整实例,有的直接修改分组内边距。同一种间距,在不同页面里出现了好几套处理方式。
诸如此类的问题,都可以通过样板页面暴露出来,并在项目设计规范中加以约束,防止扩散到更多页面。
这也让我重新意识到设计软件在这类 UI 重构中的价值。文档可以描述规则,但真正落到多个页面以后,很多问题只有摆在同一个可编辑画布里才能直观看出来。
Ardot 提供的正是这样一个视觉基准,让我可以先把页面调到满意,再要求 Agent 按这个结果实现。
04 我手动改完,还需要一次回读
这条流程中,我自己参与得最多的地方,就是打开 Ardot 调整页面。
例如菜单面板,我在实测后觉得整体太大,便要求先缩小原型,确认后再改代码。后来又觉得图表显得又粗又矮,我在 Ardot 中删掉了占位对象,让图表撑满可用高度,再要求 Codex 收窄柱状图每列的宽度。
这些判断都来自实际看见页面、使用应用之后的感受。
这时会出现一个新的问题:画布变了,Agent 还记着之前的方案。
如果只说一句「继续」,它可能按旧资料继续,也可能把我的调整理解成偶然的不一致,尝试统一回去。所以我和 Codex 约定,在我调整结束后先读取当前页面,列出变化,再决定怎样接续。
改过的画布,需要成为下一轮工作的输入。

回读时还要区分变化影响多大。只把某个页面的按钮移到右边,不意味着所有页面都要改;调整了公共设置行的对齐方式,则需要检查引用它的页面。
所以我会让 Codex 把局部变化写回对应页面说明,把确认过的公共变化写回设计规范。这个动作有点像把讨论结果记进会议纪要,下一次接手的人才能知道哪些已经决定了。
等一批页面确认后,再保存对应截图、页面信息和依赖关系,作为这批实现的基准。后续实测提出新调整,就明确记录新的范围;旧截图留着用于追溯,避免两个版本混在一起。
05 实现与验收:还原度不只是“看视觉一致”
Agent 根据 Ardot 设计稿在项目中的复现程度已经相当高,但这个过程无法一蹴而就,仍然需要经历多轮核对和修改。

好在这个过程大部分可以交给 Agent 完成,我只需要在每次核验之后,把发现的问题提交给它。
人工复核时,建议把原型和实际窗口放在相近的尺寸下看,比较内容顺序、标题位置和留白。页面缩放比例不同,容易把大小差异误当成布局问题。
实际复核时就发现过这样的偏差:原型左右留白是 40pt,代码却用了 24pt;标题到第一组内容的距离也没有按确认稿处理;还有原本要求固定的页首,被一起放进了滚动区域。
下图是 Agent 在修改侧栏选中背景色时发生的问题。它改了选中颜色,却没有实现整行填充,而是给内容按钮外加了一个带 2pt 上下缩进的背景。因此我让 Agent 重新读取 Ardot 文件,并完成修复。

另一些问题在静态原型里看不出来。例如代码复核发现,设置页输入到一半再切换分类,草稿可能被清除。页面结构看起来没问题,操作流程却出现了回归。这类问题需要检查代码,也需要在真实应用里尝试同样的操作。
每当 Agent 完成一轮修复,我都会针对上次提交的需求一条条核对。
不过最好的验证还是高频使用。这个项目是针对我的个人需求定制的,开发过程中我也在高强度使用,常常会发现 Agent「拆了东墙补西墙」的情况。我会把这些问题单独记录下来,再按小批次交给它修复。

06 所见即所得
这次实践里,Ardot 给了我一个能直接参与调整的窗口,Codex 则把项目资料、画布操作和代码实现串了起来。
我能在动代码之前先看见方案,也能把自己的修改交回给 Codex 继续处理。最终在软件设计中的原型,被原原本本地实现到了项目中。
这个过程,称得上是 Vibe Coding 的「所见即所得」了。
立即体验
注册 Ardot(新用户送 1000 Credits),新建文件并用 MCP 连接 AI Agent。以可编辑画布为唯一基准,你调细节,它写代码,支持双向回读。
相关链接:
[1] Ardot 本地 MCP 文档
https://docs.ardot.tencent.com/ardot-mcp/desktop-mcp.html
本文作者已凭这篇干货拿下 3,000 AI 积分!(基础案例奖 × 前6周 1.5 倍首发加成)
1.5 倍积分加成进入最后倒计时,10.26 截止!最后几天,把你的 Ardot 作品整理成案例换积分吧~
Ardot 案例征集|分享你的日常用法,最高赢 15000 AI 积分大奖
立即投稿:https://doc.weixin.qq.com/forms/AJEAIQdfAAoAYIArQZpAL4CNG1k3za9ef

腾讯设计Ardot的更多文章
- 别再对着截图临摹了!用 Ardot 把老代码直接“画”成设计稿
- Ardot 本地 MCP 免费打通 Claude + Kimi:双端开发者的同源实战
- AI 设计协作的下半场:设计师定规则,AI 生成,团队延展
雁评
真实、有观点的好评或吐槽,欢迎分享你的使用体验。