Skip to Content
最佳实践Vibe CodingVibe Coding 搭建 Web 应用

Vibe Coding 搭建 Web 应用

本教程用一个「AI 饮食助手」网站走完从零到上线的流程:你用自然语言描述需求,AI 编程工具通过 Zion Plugin 在 Zion 里搭好后端(数据表、权限、行为流、AI 智能体),再用 React + Vite 写出前端,最后把前端部署到 Zion,得到一个可以直接访问的地址。

  • 前端:代码在你自己的文件夹里,由 AI 编写,你可以随时查看和修改。
  • 后端:托管在 Zion,可以在编辑器里直接看到 AI 建了哪些表、配了哪些逻辑。
  • 部署:前端和后端都在 Zion,不需要自己准备服务器。

如果你希望前端页面也直接搭在 Zion 里、而不是写代码,见 接入你自己的 AI 编程工具。

开始前

  • 一个 Zion 账号。还没有的话,点此注册 。
  • 一个支持插件的 AI 编程工具,例如 Claude Code、Codex、Cursor 或 WorkBuddy。
  • Node.js 18 或更高版本。
  • 一个空文件夹,用来存放前端代码。建议让 AI 先在里面初始化 Git 仓库,方便回退到任意一步。

教程步骤

安装 Zion Plugin 并登录

按 接入你自己的 AI 编程工具 · 安装 Plugin 在你的工具里安装 Zion Plugin。插件仓库地址:

  • 全球:https://github.com/functorz-tech/zion-nocode-plugin.git
  • 国内镜像:https://gitee.com/functorz/zion-nocode-plugin.git

首次使用时,AI 会弹出 Zion 登录页面,登录后它才能操作你的项目。

让 AI 搭建后端

先只做后端。一次性要求 AI 同时写前后端时,它容易用模拟数据代替真实接口;先把后端建好、确认无误,再写前端,结果更可靠。

使用 Zion Plugin,在 Zion 新建一个 Web 应用项目「AI 饮食助手」,作为这个网站的后端。 需要支持: - 用户注册和登录 - 用户上传一张餐食照片,由 AI 智能体识别食物并估算热量 - 识别结果保存为历史记录,用户只能查看、修改和删除自己的记录 要求: - 先给出数据表、权限和行为流的设计,我确认后再创建 - 创建完成后同步后端 - 这一步不写前端

检查点:打开 Zion 个人中心 ,进入新项目,能看到 AI 建好的数据表和 AI 智能体。

AI 在 Zion 中创建的数据表AI 在 Zion 中创建的 AI 智能体

让 AI 写前端

在当前文件夹用 React + Vite 实现这个网站的前端,后端使用刚才的 Zion 项目。 - 所有数据读写都调用 Zion 的真实接口,不使用模拟数据 - 页面:登录 / 注册、上传照片识别、历史记录 - 视觉风格:wabi-sabi(侘寂)——暖灰色调、大量留白、无渐变和厚重阴影 完成后在本地启动,告诉我访问地址。

一定要说明「用 React + Vite 写前端」。Zion Plugin 也能直接在 Zion 里搭页面,不说明的话,AI 可能会去 Zion 里搭页面,而不是写代码。

视觉风格可以参考 superdesign.dev 、designprompts.dev 、reactbits.dev  上的提示词。

检查点:在本地打开 AI 给出的地址,注册一个账号并上传一张照片,然后到 Zion 编辑器的数据表里确认这条记录已经写入。

AI 开发的网站登录界面AI 开发的网站功能页面

部署预览版

构建当前前端,通过 Zion Plugin 部署到项目的预览版。

AI 会返回预览版地址。用它在手机和电脑上走一遍注册、上传和历史记录。

发布正式版

通过 Zion Plugin 把当前前端部署到正式版。
  • 部署正式版会让网站直接上线,需要你在弹出的确认框中输入项目 ID 才会执行,AI 不能代为确认。
  • 基础版项目不支持正式发布。需要先将项目升级到高级版或更高版本,见 升级项目。
  • 需要使用自己的域名时,见 使用自定义域名。

后续迭代

继续用自然语言描述要改的地方即可:

  • 只改前端:AI 修改代码后,重新部署预览版检查,再发布正式版。
  • 涉及后端:让 AI 先修改并同步 Zion 后端,再更新前端调用,最后重新部署。

每完成一个功能,让 AI 提交一次 Git,出问题时可以回到上一个可用的版本。

常见问题

AI 没有真正调用 Zion 的接口

表现为页面能显示数据,但 Zion 的数据表里没有记录。让 AI 检查哪些地方使用了模拟数据,全部改为调用 Zion 的接口,并在改完后按上面的检查点重新验证。

图标和图片素材放在哪里

在 Zion 中建一张「媒体资源表」,包含名称或标签字段和图片字段,把图标上传到这张表,再告诉 AI 哪个位置使用哪条记录。也可以让 AI 按当前风格设计一组 SVG 图标,上传到这张表后引用。

用户案例

好痛 Howtone

好痛 Howtone  接入 Zion 作为后端,从互联网上的用户吐槽中分析产品痛点、生成运营文案。

好痛 Howtone:产品痛点分析及运营文案生成平台

Shikilab

Shikilab.cn 是一位 Notion 博主的个人独立站,跑通了虚拟产品从下单到交付的闭环。

Shikilab:用 AI 搭建个人独立站

关于 Zion 和 Zion Plugin

Zion 是全栈 vibe no-coding 平台。本教程只把它用作后端和前端托管:数据库、行为流、AI 智能体、用户与权限、文件存储都由 Zion 托管,并通过统一的 GraphQL 接口对外提供。后端提供哪些服务、接口怎么调用,见 Headless · Zion BaaS。

Zion Plugin 是面向 AI 编程工具的开发套件,包含 Zion MCP 服务器、Zion CLI 和 zion-platform 技能。技能里带有前端对接 Zion 后端、部署前端的指引,能减少 AI 编造接口的情况。

搭建中可能用到的能力:

能力说明文档
AI 智能体自定义提示词、知识库和工具调用搭建 AI Agent
支付Web 应用可接入支付宝、Airwallex,以及仅在微信内打开时可用的微信支付;需要专业版支付功能概述
权限基于角色和数据条件控制谁能读写哪些数据管理应用权限
套餐与容量不同版本的 RPS 上限和资源额度,以及如何升级升级项目、管理项目资源

附录:各工具的插件安装入口

完整的安装说明以 接入你自己的 AI 编程工具 为准,下面是几个常用工具的界面截图。

Cursor

Customize → Plugin → add from marketplace → 粘贴插件仓库地址。

Cursor Plugins 安装入口

Cursor 从 GitHub 导入技能

WorkBuddy

专家 / 技能 / 连接器 → 技能 → 套件 → 添加。添加成功后显示「此市场暂无套件」属于正常现象。

WorkBuddy 添加市场WorkBuddy 找到 zion-nocode 套件WorkBuddy 更新套件

Codex

在对话框中输入:

安装 Zion Plugin,Git 地址是:https://github.com/functorz-tech/zion-nocode-plugin.git

更新时输入:

更新 Zion Plugin 到最新版本,Git 地址是:https://github.com/functorz-tech/zion-nocode-plugin.git
Last updated on