从 Vue 到 PHP,我借助 AI 开发花椒小游戏的实践

文章来源声明: 原文作者:花椒技术; 来源站点:掘金; 原文链接:https://juejin.cn/post/7708627348665483290; 本文基于上述来源整理/加工,觅优补充点评,仅供技术学习交流。版权归原作者所有。
觅优短评

这篇复盘把AI编码落到接口契约、状态边界和可验证性上,适合前端转全栈、多仓库并行交付及需要真实联调测试的团队参考。

> **项目要交付,AI 也想跟上?** 在「花椒技术部」,看一线团队怎样用 AI 写代码、做 Agent、推进真实项目。技术群还会分享**工作日精选 AI 日报**,也欢迎带着工具选型和工程实现中的问题来交流。 **关注公众号「花椒技术部」,回复「技术群」获取入群入口。**

这次在花椒做「呱呱乐」,我这个前端,把服务端和运营后台的主要开发也一起做了。房间页面用 Vue,服务端沿用已有的 PHP 体系,三个仓库分别通过不同的 AI 会话推进。

呱呱乐是一个直播间九宫格玩法。主持可以把唱歌、真心话、绕口令等内容填进格子,揭晓后大家一起参与,也可以加入惊喜盲盒。

先看一段实际运行的演示。

页面上的操作很简单,主持选中一格,再点揭晓。沿着这个动作往下做,就得回答一些具体问题。请求重复提交会不会再次开奖?后台改了配置,已经生成的卡按哪一版处理?数据库已经提交,房间同步暂时失败,结果还算不算数?

我和 AI 把这些规则逐步落实到接口、数据和测试里。花椒已有的主持身份、房间同步等能力继续复用,我负责把新玩法的行为讲清楚,再检查不同仓库里的实现是否一致。

20261116191024.jpg

  1. 先跑通交互,把页面状态与业务状态分开

拿到需求后,我先让 AI 结合现有房间入口做可运行的原型。配置九格、揭晓、换卡、查看记录和盲盒演示,都能在原型中操作。

这一阶段使用本地模拟数据,身份和奖励相关流程也只是交互演示。它能帮助我确认配置完成后怎么返回、取消编辑是否保留原卡,以及普通指令和盲盒分别在哪里展示。

从前端往服务端继续做,首先要说清楚哪些变化需要保存。

状态具体内容由谁维护
页面临时状态选中的格子、弹窗开关、未提交的编辑草稿前端组件
房间业务状态已保存的九格配置、当前卡片、揭晓结果服务端保存,前端按权限读取,公开卡面变化通过房间同步更新
运营配置后台发布的玩法设置运营后台维护,服务端按已发布配置处理

点击格子只改变选中项,执行揭晓才提交业务操作。保存模板和应用配置也分开处理,编辑卡片库不能直接改变直播中正在使用的卡。

我让 AI 补页面和接口时,就沿用这些区别。这样,同一个“保存”按钮究竟只保存模板,还是会影响当前房间,前后端都有明确的处理依据。

视觉设计也分几步完成。先围绕主界面试风格,选定紫色卡通方向,再扩展到配置、模板编辑、历史记录和结果弹窗。整套 UI 确认后,才分别生成角色、格子底图和装饰,装配进 Vue 组件。

下面是当时比较的四种视觉方向。紫色卡通图依据最终采用的风格重新生成,用于统一主图尺寸与构图。

月光紫晶冰蓝极光
![月光紫晶风格设计稿](https://p3-xtjj-sign.byteimg.com/tos-cn-i-73owjymdk6/795aa003859843f69a7e3b74f5f1271a~tplv-73owjymdk6-jj-mark-v1:0:0:0:0:5o6Y6YeR5oqA5pyv56S-5Yy6IEAg6Iqx5qSS5oqA5pyv:q75.awebp?rk3s=f64ab15b&x-expires=1795433820&x-signature=5mRORfCvhutNJ8CpOkFOVHj%2B0HM%3D)![冰蓝极光风格设计稿](https://p3-xtjj-sign.byteimg.com/tos-cn-i-73owjymdk6/a11637ed21d34385975617b8bed79298~tplv-73owjymdk6-jj-mark-v1:0:0:0:0:5o6Y6YeR5oqA5pyv56S-5Yy6IEAg6Iqx5qSS5oqA5pyv:q75.awebp?rk3s=f64ab15b&x-expires=1795433820&x-signature=4u6TQs7Frx5f4WV2tvI3XBvRW3Q%3D)
紫色卡通(采用的风格)暖黄复古
![紫色卡通风格示意图](https://p3-xtjj-sign.byteimg.com/tos-cn-i-73owjymdk6/5129f8b2612045a8b2a20e9756d1f8bb~tplv-73owjymdk6-jj-mark-v1:0:0:0:0:5o6Y6YeR5oqA5pyv56S-5Yy6IEAg6Iqx5qSS5oqA5pyv:q75.awebp?rk3s=f64ab15b&x-expires=1795433820&x-signature=%2FQrry1rH%2FrgpFDC%2Fte33Qb4Kjqo%3D)![暖黄复古风格设计稿](https://p3-xtjj-sign.byteimg.com/tos-cn-i-73owjymdk6/a6722799f0e948a99c7f93dba97228bf~tplv-73owjymdk6-jj-mark-v1:0:0:0:0:5o6Y6YeR5oqA5pyv56S-5Yy6IEAg6Iqx5qSS5oqA5pyv:q75.awebp?rk3s=f64ab15b&x-expires=1795433820&x-signature=BiRqJlDVrqAKxZiG4HdQE5jm7%2F4%3D)

图 1|四种主界面视觉方向对比,均为设计示意。

风格确定后,再把配置、模板编辑和记录等页面放在一起检查。

呱呱乐多页 UI 设计预览

图 2|统一风格后的多页 UI 设计预览,图内为模拟内容。

进度、格号和奖品名称仍由代码显示。这些内容会随业务数据变化,把它们留在组件里,素材才能继续复用。页面接入模拟房间数据后,我再检查窄屏标题、长文案、记录滚动和弹窗位置。

  1. 三个仓库,先把同一份接口约定写清楚

开始写 PHP 前,我先让 AI 读已有玩法从开启、揭晓到结束的调用过程,找出可以复用的房间能力,以及新玩法需要增加的逻辑。

随后,我和 AI 沿着主持的操作讨论数据。保存配置后要留下什么,换卡后怎样查到之前的记录,房间状态、卡片内容和历史记录分别负责什么,都在这一步确定。

其中一条规则影响了后面的实现和测试。卡片保留生成时的配置快照,后台后续修改配置,只影响之后生成的新卡。揭晓旧卡时,服务端需要读取这张卡保存的配置。

房间前端、服务端、运营后台分属三个仓库,我在不同的 AI 会话中推进开发。为了让它们接得起来,我按配置保存、揭晓和换卡等操作整理接口清单,把请求内容、返回结构和错误含义写在一起,交给各个会话使用。

以揭晓操作为例,前后端需要对下面这些业务含义保持一致,具体字段名已省略。

接口涉及的内容实现时要回答的问题
当前玩法、卡片和版本请求操作的是哪一轮、哪张卡,页面持有的版本是否仍然有效
操作资格与卡片归属当前操作是否由允许执行的主持发起,目标卡是否属于当前玩法
重复操作的含义同一个格子已经揭晓时,后续请求不能再次开奖
返回内容和错误含义前端与服务端如何理解当前卡片状态,以及请求未被执行的原因

实现以后,我再从页面调用开始往后追,检查传出的参数能否被服务端正确理解,返回的数据能否支撑页面状态更新。

运营后台也使用这份约定。输入项的含义和单位要与服务端一致;查询失败时,页面清掉上一次查到的资料,并阻止确认,避免把旧结果带进当前操作。

  1. 揭晓一格,先保存结果,再更新房间

接口收到请求后,要检查主持权限、卡片归属和当前版本,处理页面状态滞后及重复提交。已经揭晓的格子不会再次开奖。

通过这些业务处理之后,一次揭晓会同时改变卡面结果和揭晓进度。我先和 AI 列出需要一起修改的记录,再把它们放进同一个数据库事务。全部写入成功才提交,中途出错就一起回滚。

下图把事务内的数据写入与提交后的缓存、房间同步分开。绿色分支提交后继续执行,写入失败则整体回滚。

呱呱乐揭晓一格的数据库事务、缓存与房间同步流程转存失败,建议直接上传图片文件

图 3|揭晓处理的简化流程,省略具体字段、权限实现与并发控制细节。

房间信息会被前端反复读取,因此查询结果放在 Redis 中缓存。发生揭晓后,先完成数据库提交,再失效旧缓存,让后续查询能够获取新的业务状态。

这里还要区分“结果已保存”和“房间已收到同步”。房间同步暂时失败时,数据库中的揭晓结果仍然有效,后续处理不能因此重新开奖。这个区别决定了异常发生后应该检查哪一段,也避免把通知失败理解成业务结果不存在。

公开同步的内容同样需要限定。房间里的其他人需要看到卡面变化,未揭晓的答案和接收用户等信息则保留在各自允许查看的范围内。

  1. 用真实回包联调,再检查业务记录

接口代码写出来以后,我先检查前后端能否按同一份数据工作。

服务端在隔离环境中执行实际 PHP 接口并导出回包,前端直接使用这些返回结果进行集成验证。默认九格、保存后的配置、卡片版本等内容,都来自后端的实际执行。

这样,前端测试使用的数据与服务端实现有直接联系。字段类型、状态含义或返回结构有偏差时,可以沿着同一份回包排查。组件测试、实际构建和浏览器检查,再继续覆盖请求处理、页面渲染、布局及操作。

接口能接上之后,还要检查业务结果是否遵循前面确定的规则。配置快照就有一条实际执行过的测试过程。

操作顺序需要验证的业务结果
先生成一张卡卡片保存生成时的配置
在后台修改配置已生成卡片保留原来的配置
修改后再揭晓这张旧卡旧卡仍按生成时的配置处理
随后生成新卡新卡采用更新后的配置

我让 AI 回查实际业务记录,确认旧卡和新卡分别使用了对应的配置。这里检查的是卡片生成、配置修改和后续处理能否遵守同一条规则,页面显示正确只是其中一部分。

另外几类情况也放进了隔离环境中的测试。

验证方式检查内容
两个 PHP 进程同时执行并发情况下的业务处理
注入数据库写入异常相关状态能否一起回滚
重复提交开卡、揭晓和换卡请求重复操作是否按预期处理
接入真实 Redis缓存与锁的行为

相关代码还交给独立的 AI 子代理审查。前端使用的回包、数据库里的记录和浏览器中的操作结果,需要能解释同一次业务行为。

  1. 数据库、后端、前端按依赖顺序部署

开发和联调完成后,我继续让 AI 准备数据库变更,补齐字段注释、默认值和检查信息。按现有审核流程确认执行,再检查字段及原有数据,随后按后端先、前端后的顺序部署。

这个顺序来自页面对接口的依赖。前端启用新的配置流程时,对应字段和后端接口需要已经就绪。

AI 整理变更、准备合入候选、运行检查,并推进测试环境流水线和部署。我还让它读取实际加载的页面、脚本与样式,核对部署产物是否对应通过检查的代码。检查通过的代码与页面真正加载的资源,要在同一环境里对得上。

截至这次实践整理时,呱呱乐已经完成多轮测试环境发布,生产侧配置了单房白名单入口。涉及关键执行、合并和发布,仍按平台已有流程确认。

这次从前端继续做服务端,我能借用的经验很具体。主持点下去后改变了哪些状态,其他人应该看到什么,旧页面还能不能继续操作,都可以从交互一路追到接口和数据。AI 帮我补实现,我也需要跟着把代码为什么这样工作解释清楚。

你用 AI 做项目时,最容易卡在哪一步? 多个会话怎样保持接口一致,生成代码接入现有系统后,联调和测试该从哪里开始?欢迎带着你的场景来技术群交流,也分享你已经走通的做法。关注公众号 「花椒技术部」,回复 「技术群」 获取入群入口。