用 AI 写小程序,我劝你先别急着要代码
- 2026-11-22 21:17:41
今年年初,AI 编程刚火那阵,我用它写了个小程序,叫「极时」。一个用于康复计时的小工具,不复杂。
说真的,头半天特别爽。一句话丢过去,代码哗啦就出来了。页面、组件、样式,一样不缺。我当时还挺得意,觉得这活儿以后就不用自己干了。
嗯,然后就开始遭罪了。
"卡片太方了,圆一点。"
"配色不够高级,换一套。"
"顶上太空,加点层次。"
"字号再大一档。"
一句过去,它改一轮。改完一看,卡片是圆了,列表间距乱了;配色是换了,按钮上的字又糊了。再来一轮,越改越拧巴。改到后来我自己都懵了——这个页面到底该长什么样?说不上来。因为打从一开始,谁也没把它说清楚过,包括我。最后来来回回沟通好多轮,功能上总算大概OK了,但是主题风格完全不统一。
那会儿我一口咬定是模型不行,换强的就好了。讲道理,这个判断挺合理的,对吧?谁不这么想呢。
直到前阵子,我用 Hy4 接上 Pencil,把「极时」的界面从头到尾重做了一遍,才反应过来:根本不是模型的事儿。是我把顺序搞反了。
先写代码,再想界面长什么样,然后拿一句句大白话去修剪代码。这路子,从第一步就歪了。
不啰嗦,咱们先看重构后的效果对比。

第一版的毛病到底出在哪儿
事后复盘,第一版的路子是这样的:一句话需求,一整包代码,界面是代码跑出来的副产品。
你品品这里头最玄的一样东西——它到底长什么样。这么不确定的一件事,偏偏被压在最难回滚的地方:代码。代码既是设计稿,又是成品,还是唯一的参照物。
所以,所有关于"好不好看"的扯皮,都只能在代码里进行。
你说"再高级一点",模型得先琢磨啥叫高级,再猜该动哪个文件、哪行 WXSS,顺手还把隔壁的布局带歪。你说"卡片换一下",它改完卡片,圆角、阴影、内边距又跟上一轮的改动打起架来。来回几轮,我人都麻了。
等一下,这真不能怪模型笨。是我把三件本该分开办的事,捆一块儿塞给它了:需求是啥、页面分几块、视觉长啥样。一件都没定死就开工,后面每一步都在同时改这三样。返工不是偶尔赶上了,是注定的。
后来翻到一个做 UI 先行的开源项目,里头一句话我印象特别深,大意是:你让 AI "写个高级的网站",它自由发挥,你自己也不知道该长啥样,于是就无限返工——"再高级一点"、"Banner 再有点设计感"——项目越改越乱。
我看到那段的时候愣了一下。这不就是我吗,一字不差。
说白了,返工的根子不在代码写得好不好。是压根没这么个东西摆在那儿,能让大家(包括模型)指着说"就照这个来"。没有它,谁都只能凭感觉各说各话。
设计先行这事儿,怎么就被跳过去了
老程序员都懂,正经做项目,先有设计稿再写代码,天经地义。设计稿是给开发看的规格书,验收的时候拿它一条条对。
到了 AI 这儿,这一步没了。
倒不是谁故意省。是 AI 太快了。一句话到一段能跑的代码,几十秒。快到让人产生错觉:反正代码立刻就有,中间那张图,好像不画也行。
代价我上头已经付过了,挺贵的。
还有个说法我觉得挺在点子上:设计转代码,管的是"这张已经定死的稿子怎么落地";Vibe Coding,管的是"怎么靠自然语言、运行结果和反馈,一点点把东西推出来"。这俩不在一个层面上,也不打架。可 AI 编程缺的偏偏是前一半——一份定死了、能进版本库、能拿来逐项验收的视觉基准。
所以我才盯上 Pencil。
官网那句口号挺逗:"Dream on canvas. Land in code."(在画布上做梦,落到代码里。)下面还补了一刀:"No more design handoffs." 不搞设计交接了。
它也不是什么独立的设计软件,这点得说清楚。说白了就是一块长在 IDE 里的画布,号称"代理驱动的 MCP 画布",跟代码就隔一个标签页。设计稿存成 .pen 文件,扒开看是 JSON,能跟代码一块儿进 Git。
我当初看中它,说到底就图这几样:
画布在 IDE 里,压根不用"交接",因为人就没离开过这个窗口。.pen 是个正经文件,能 diff、能回滚、能定版,"就照这个来"总算有了实物。对了,还有一点容易被忽略——它是给 AI 读的,不是给人截个图看看的。模型能自己打开、读取、改这个文件,不用你费劲描述"大概是个蓝的、上面飘着张卡片的页面"。
嗯,这么一捋就清楚了:先把界面定死,再让代码照着抄。写第一行代码之前,需求、结构、视觉,全定。
后面会发生什么变化,我一开始也没料到。
为什么偏偏是 Hy4 加 Pencil
这回重做「极时」,我换了个组合:腾讯混元 Hy4 当脑子,Pencil 当画布。
先聊 Hy4。11 月 4 号正式版发的(2026 年),比 preview 扩了预训练也扩了后训练,头一回把视觉能力塞进主模型,也头一回正经支持操作电脑。官方在前端那块下了功夫,复杂交互、业务逻辑、状态管理、前后端联动都照顾到了,话说明白:生成的界面别光好看,得能用。
以前那种外挂式做法,给它一张设计图,得先把图转成一段文字描述,再喂给语言模型。这一转述就丢东西:表格的行列关系、图表的刻度、按钮谁压着谁,靠文字复述很难保真。原生多模态直接啃像素,省了中间那道二手贩子。
而"照着设计稿做"这件事,说穿了不就是:先看清楚,再照着来嘛。看都看不准,谈何做得准。
可问题来了,光模型看得准也没用。
模型再强,手里没个工具去打开、去读、去改那个 .pen 文件,它照样只能听你用嘴描述"大概长啥样"。绕一圈,又回凭感觉了。
中间缺的那根线,就是 MCP。模型上下文协议,连接模型和外部工具的标准协议,WorkBuddy、CodeBuddy 这一挂的产品都内置支持,符合协议的工具插上就能用。巧的是 Pencil 本身就管自己叫 "agent-driven MCP canvas"——设计的时候,就默认来调用它的是个 AI。
这么一接,分工就自然了:Hy4 管听懂人话、动笔改;Pencil 管把那张稿子钉住;MCP 负责两头连上。少哪头都不成,对吧。只有模型和画布,靠截图和嘴猜;只有画布和协议,没个看得懂界面的模型,稿子画得再漂亮也变不成代码。
哦对,还有句题外话。模型越强,"先想清楚"反而越值钱。生成都快不要钱了,方向要是错了,也会被同样不要钱的速度,放大成一整个项目。这个我后面还会说到。
Hy4目前还是免费使用的,这想想都爽。
手把手那部分来了:怎么把 Hy4 接进 Pencil
这块是最琐碎、也最容易被跳过的。我干脆拆开写,你照着捋一遍基本就能通。
我这边用的是 Trae,就是 Trae 国内版(Trae CN)。插件装它里头,模型我是在Workbuddy上用的Hy4。
先把插件装上
Pencil插件我是在Trae中安装的,所以先打开Trae,在扩展面板搜 "Pencil",装 highagency.pencildev 那个。
有个坑得提一句:有时候搜 "Pencil" 死活搜不出来,改搜 "pen" 倒冒出来了。扩展市场检索的毛病,不是没上架,别急着怀疑人生。
装完重启 Trae,点左边那个 Pencil 图标,头一回会弹注册登录,跟着走完就行。
然后得把那个二进制刨出来
Pencil 把 MCP Server 一起塞进插件目录了。要配的不是插件本身,是 out/ 底下那个可执行文件:
macOS: mcp-server-darwin-x64(Apple Silicon 的机器对应 arm64 那个)Windows: mcp-server-windows-x64.exe
找它最省事的办法:进已装插件的详情页,点开本地安装位置,钻进 out 文件夹,整条路径复制下来。
接着贴配置
因为是在WorkBuddy里用AI,所以还需要在Worbuddy配置一次MCP。
专家·技能·连接器 → 自定义连接器 → 添加MCP,把下面这段贴进去。我机器上是这样:

{"mcpServers": {"pencil": {"command": "/Users/{用户名}/.trae-cn/extensions/highagency.pencildev-0.6.72-universal/out/mcp-server-darwin-x64","args": ["--app","trae_cn" ],"env": {} } }}别光顾着复制粘贴啊,这三个字段我挨个念叨一下,第一个尤其别抄错:
command:就是刚才刨出来的那个可执行文件的绝对路径。要么写全路径,要么这命令本来就在 PATH 里;还有,路径里千万别带空格,带了直接解析失败。我这份里的 0.6.72 是插件版本号,插件一升级它就变,记得回来改这行,不然哪天突然连不上还一头雾水。
args:--app trae_cn 是告诉这 Server,宿主是 Trae CN。换个 IDE 这个值就得跟着换,所以同一份配置别无脑往别的编辑器里搬。
env:环境变量,每个值都得是字符串。macOS 留个空 {} 就能跑;Windows 的教程里常见补 NODE_ENV=production、再把 out 目录塞进 PATH,那是平台差异,不是必须的。
对了,这玩意儿是 stdio 类型的 MCP Server:客户端把进程拉起来,靠标准输入输出跟它说话。所以配置对了之后,你啥服务都不用手动起。
连没连上,先问它一句
先别急着上需求,让它自证一下。在workbuddy里,选择Hy4,然后输入:
用 Pencil 检查一下当前编辑器状态,看看有没有打开的 .pen 文档。
能回出文档状态(比如 get_editor_state 这类工具被调用了),就说明 Hy4 已经能借着 MCP 摸到 Pencil 了。
然后才给需求。提示词我就说三点,嗯,想到哪说到哪:
开头一定写明"使用 Pencil 设计",别让它自己挑实现方式,不然它可能又闷头去写代码了。
页面、元素、配色、风格,一口气说清楚。比如:"用 Pencil 设计一套计时类小程序的 UI:首页是当前计时卡片和开始按钮,第二页是记录列表,第三页是统计,整体冷静、克制、留白多,主色深蓝"。越具体,出来的越贴。
一整屏也行,整套流程一起出也行。社区里有个真实案例,就一句"使用 Pencil 设计一个商城小程序 UI 界面",半小时出了一整套能看的稿子。
生成完不用推倒重来。框住哪块改哪块,继续用嘴说就行:"这张卡片圆角加大""这一列改两栏""统计页图表换成环形"。改到顺眼了,Ctrl+S 存成 .pen,扔项目目录里。到这儿,稿子就算钉死了。
到这儿才轮到写代码
这才是跟第一版「极时」真正不一样的地方。
提示词从"帮我做个小程序",换成这句:
按这个 .pen 设计稿实现小程序页面,布局、配色、字号、间距严格以设计稿为准,不要自己发挥。
让代码去抄稿子,别再让稿子迁就代码。
俩坑,顺手记一下
头一回调用失败:多半是没打开任何 .pen 文档,画布还没起来。不用管它,Trae 会自己把任务重新拉起来,再发一次就好。
**蹦出 Built assets not found. Please build the editor first**:插件版本和它要下的编辑资源包版本对不上,版本检查没过,资源目录空了。要么把插件升到匹配的版本,要么干脆清干净本地缓存重装——注意,在 Trae 里点卸载是会留缓存的,得手动进安装目录删掉再装。社区里这坑被翻来覆去问,其实压根不是网络的锅。
改完顺序之后,日子确实好过多了
这回重做「极时」,我把流程倒过来走了一遍:先让 Hy4 借着 Pencil MCP 把首页、记录、统计那几屏画出来,来来回回改到顺眼,存成 .pen;然后才让代码老老实实照着实现。
变化倒不在"图变好看了"这种虚的。是后面每一环,突然都有东西可依了。
以前改个需求,得在代码里翻那一处样式,改完还提心吊胆,怕带歪别处。现在?先动画布,再让代码重新对照生成。争论在画布上解决,一帧的事;搁 WXSS 里,十处的事,还容易按下葫芦浮起瓢。
验收也不一样了。布局、字体、图片、留白、卡片、颜色、移动端,一项项对着看就行。以前全靠"我感觉差不多吧",现在能具体到"这项对上了,那项差 8px"。差多少说得出来,这事就吵不起来了。
还有返工。视觉上的分歧前移到画布上,改一次比在代码里改十次便宜太多。更让我踏实的是,改完不会把已经跑通的逻辑带崩——逻辑和视觉总算分开搁着了。
老实说,做完这轮我琢磨出个有点反直觉的东西:AI 没让"设计"便宜到可以省掉。它把"生成"打到几乎不要钱,结果呢,"我到底要什么"反倒成了唯一还值得人花时间的活儿。
以前写代码贵,贵到我们肯先想清楚再动手。现在代码白送,想不清楚的代价反而被放大了——方向一歪,会以同样白送的速度,复制出一整个项目。
嗯,就这么个理儿。
最后啰嗦两句
折腾完这一轮,我对 AI 编程就剩一个挺朴素的判断:别老盯着模型强不强了,先看看顺序对不对。界面定死,再让代码照着来。
模型肯定会一直变强,今天是 Hy4,明天指不定换谁。但"先定视觉、再落代码"这条不会过时,因为它治的不是算力,是心里没数——把最说不清的那件事,挪到最便宜、最好改的地方先办了。
要是你也在用 AI 做小程序,有几个动作明天就能试:
动手之前,先让它把稿子出出来,存成个能进 Git 的文件。别急着要代码,代码什么时候都能生成,方向错了才真贵。
MCP 那根线也顺手接上吧,让模型自己能读写设计文件。靠嘴转述"大概长啥样",中间丢掉的那些,最后全得变成返工还回来。
再有,把"以设计稿为准"写进提示词,验收时一项项对。让那张稿子说了算,别让每轮对话都各凭感觉重开一局。
顺序顺了,模型那身本事才落得到产品上。顺序拧着,换十个模型,也不过是更快地绕同一个圈罢了。
就这样,回见。
往期推荐
不换语言,只换框架,Solon 把 SpringBoot 的内存从 400MB 打到了 76MB
我把SpringBoot项目用Go重写后,内存从400MB掉到了10MB