错误一：写一份规格说明，而不是一句话
被糟糕软件伤过的人,往往一打开构建器就会敲下一大段话。评分系统、单位偏好、离线模式、配色方案,全都在收到第一条回复之前就一股脑写进去。这感觉很稳妥,但其实并非如此。构建器读完你那一句话,推断出你大致的意图,大约十五秒后就带着一份方案回来了——“一个给攀岩者用的训练日志”,会被拆解成训练记录、评级追踪视图和一个仪表盘,默认选用 V 级抱石和 YDS 攀爬路线等级,因为大多数攀岩者用的就是这套体系。它会在方案里明确告诉你它选了什么,这样你如果是例外情况,一句话就能纠正过来。提前把那段话写好,并不能省掉这一步。你依然会拿到一份方案,依然得读它,而你花三分钟打出来的那些约束条件,方案本来就会按照对你的构建真正重要的顺序,主动呈现给你。
这份方案不是一张等你填空的表格,而是一段文字,你也用文字来回应。“其实改成法式等级吧,我在欧洲”就是一次完整的修改。“加一个搭档/保护员记录字段,我和不同的人一起攀岩”也是。每一次修改都会重新生成方案,而不是重新构建——你是在真正耗费资源的阶段开始之前进行引导,而不是推倒重来。批准这份方案,是你唯一必须做出的决定。之后的一切都是生成与验证。
误区二:像盯着卡住的终端一样盯着活动流
构建在服务器端运行,这里的“灾难现场”几乎总是虚惊一场:有人盯着安静的活动流看了两分钟,就以为它卡住了。其实没有——它正处于一个不会每秒都产生可见输出的阶段,活动流之所以标注出你当前所处的阶段,正是为了说明这一点。你完全可以直接关掉标签页,这次运行并不依赖你的浏览器。
你实际应该预期多长时间,因构建内容而异很大。攀岩日志——几个页面,一个本地数据模型,不调用任何外部 API——通常三分钟以内就能完成,这对任何本质上是“记录这个、绘制那个图表、给我看个列表”的应用来说都很典型。一旦构建需要真正的后端、身份验证、带关联关系的数据库、后台任务,时间就会来到八到十二分钟,因为这时需要生成和迁移数据库结构,而且验证环节还要针对服务器端代码再跑一遍,不只是针对页面标记。游戏则更慢,因为它们需要生成资源:精灵图、音效提示,有时如果第一版效果在实际展示尺寸下看起来不对,还需要再做一次视觉调整。而原生打包——一个真正可安装的 APK,而不是套了个壳的网页视图——会交给真正的工具链去处理:Gradle、签名等等。单是这一步,就可能在其他所有步骤之上再增加五到十分钟,而这正是那个“活动流安静下来不代表出了问题、只是工具链在做该做的事”的阶段。
这种模式说实话的代价是,你失去了那种看着代码逐字流入编辑器的即时反馈感。取而代之的,是一个即便你的笔记本电脑休眠、Wi-Fi 断开也依然在运行的系统,你可以在手机上查看它,无论你是否在盯着它,它都会持续运行。对于一次九十秒的构建来说,这种取舍几乎可以忽略不计。但对于一次十二分钟的后端构建来说,这就是“守在终端前干等”和“去喝杯咖啡”的区别。
错误三：把生成完成当成任务完成
这是代价最高的一个错误。一次快速完成、却未经检查的构建，并不是完成的构建——它只是一份恰好能运行的草稿——而这两者之间的差距，正是许多快速建站工具口碑不佳的原因，比如上线了没有做输入过滤的表单、或者键盘完全无法访问的按钮。在本平台把任何东西标记为完成之前，会有独立的验证智能体对其进行审查：代码、安全性、链接、SEO、无障碍访问，以及是否与你批准的方案保持一致。这是真正独立的一轮检查，而不是同一个智能体自己检查自己生成的内容然后点头通过。
安全检查会排查那些真正会在生产环境中造成问题的常见隐患：提交到客户端代码中的 API 密钥、未做输入过滤就接受数据的表单、信任客户端传来的用户 ID 而不是从会话中派生用户身份的接口。无障碍检查不是那种可以靠注释就能糊弄过去的 linter——它会检查真实的对比度，以及交互元素是否可以通过键盘访问。
一致性检查是最容易被低估的一项。生成过程中很容易悄悄漏掉你要求的某项内容——比如你在方案修改中加入的那个伙伴/保护日志字段——在构建进行到第三个文件时，就在无人决定的情况下被降低优先级并遗漏了。一致性检查会将你批准的方案与实际输出重新比对，从而发现这类差距。一旦发现问题，修复会自动应用并重新检查；你得到的不是一份待办清单，而是一个你根本看不到的修复，或者压根就没有问题。每个验证环节具体检查什么、以及某项连续两次失败后会发生什么，详见《构建如何自我验证》。这一节最值得记住的一点是：完成意味着通过验证，而不是已生成。把这两者混为一谈，你最终会上线暴露的密钥或无法访问的按钮。
避开这三个错误后，你会得到什么
- 一个可以点击体验的真实预览产品——一个真正接入了你数据的运行实例，不是效果截图。
- 一个与之关联的对话线程，在这里，“把标题栏调深一点，再加一个数据统计页”会生成与第一版并列的第二版。旧版本不会消失；它会作为备用版本保留，而新版本会成为线上的预览版。
- 真正能起作用的按钮：一键上线、下载代码、构建原生安装包、上架到应用商店。不是包装成按钮的升级弹窗。
“下载代码”这个按钮值得多留意一下，因为它决定了这是一款你敢用来做真实项目的工具，还是只适合做一次性原型的玩具。如果代码真正属于你、可以随时带走——文件结构清晰可读，除了你主动要求的功能外没有奇怪的绑定——那么平台就必须持续赢得你的下一次使用，而不是靠你已经被困在里面这一事实混日子。
