Guide · 使用教程
Emergent 教程：从产品简报到可部署全栈 MVP
用 Emergent 构建带登录、工作区、数据库、权限和部署的全栈 MVP：从产品简报、数据模型、分批生成到 GitHub、测试、credits 控制与生产安全检查。
作者：Li Xuan·更新于 2026年8月20日
Emergent 的优势不是把一句想法变成一张漂亮页面，而是把产品简报逐步转成带认证、数据库、业务逻辑、第三方集成和部署的全栈 MVP。要获得稳定结果，关键不是连续追加提示词，而是先收紧范围，再让 Agent 按可验证的阶段工作。
本教程用“客户反馈门户”作为示例：客户登录后提交反馈，团队成员可以分类、更新状态和回复；后续再增加付费团队空间。这个案例覆盖大多数 SaaS 首版都会遇到的角色、数据、权限、通知和部署问题。正式操作前可先阅读 Emergent 评测，了解 credits、GitHub 和生产风险。
第一步：定义一个可以验收的 MVP
不要从“帮我做一个比某某更好的 SaaS”开始。先写清楚：
- 用户是谁：客户、团队成员、管理员。
- 核心问题：客户反馈散落在邮件和聊天工具里。
- 首版必须完成：登录、提交反馈、状态跟踪、团队回复、基础搜索。
- 暂不实现：复杂计费、AI 自动分类、多语言、移动 App、企业 SSO。
- 成功标准：新用户能在五分钟内注册、提交反馈并看到状态变化。
- 风险边界：不用真实客户数据，不连接生产支付，不上传机密文件。
范围越小，越容易判断生成结果是否正确，也越不容易在错误架构上浪费 credits。
第二步：准备产品简报
可以把下面模板作为第一次输入：
text
Build a responsive full-stack customer feedback portal.
Users:
- Customer: sign up, submit feedback, view status and replies
- Team member: review, tag, change status, and reply
- Admin: manage team members and workspace settings
Core entities:
- User
- Workspace
- Feedback
- Tag
- Reply
MVP flows:
1. Customer creates an account and joins a workspace
2. Customer submits feedback with title, description, and optional category
3. Team member changes status: New, Reviewing, Planned, Completed
4. Customer sees status history and replies
5. Users can search and filter their own workspace data
Constraints:
- Every record belongs to one workspace
- Customers cannot view other customers' private feedback
- Do not build billing yet
- Use test data only
- Include loading, empty, validation, permission-denied, and error states
Before coding, ask questions about ambiguous permissions and data relationships.
常见问题
- 第一次使用 Emergent 应该从多大的项目开始？
- 从只有一个核心用户流程的 MVP 开始，例如登录后提交和查看一类数据。先不要同时加入支付、通知、AI 分类和多端应用。
- Emergent 免费版能完成本教程吗？
- 免费版每月 credits 较少，适合验证提示词和简单原型。私有项目、GitHub、部署和完整移动端流程通常需要 Standard 或更高套餐。
- 为什么要先定义 workspace 和权限？
- SaaS 最常见的高风险错误是跨租户数据泄露。先定义 Membership、workspace role 和查询过滤，可以避免后期在每个页面补权限。
- 什么时候连接 GitHub 最合适？
- 认证和第一条核心流程稳定后就连接。越早建立版本历史，越容易回滚、审查代码并让开发者接手。
- 可以把真实 API Key 发给 Emergent Agent 吗？
- 不要粘贴到提示词或前端代码。使用平台 Secrets 或环境变量，并区分测试与生产凭证；一旦暴露应立即撤销和轮换。
- Emergent 生成的支付功能可以直接上线吗？
- 不可以直接信任。必须验证 Webhook 签名、幂等、套餐权限、失败、取消、退款和重复事件，并使用测试环境完成完整流程。
- 如何减少 credits 消耗？
- 先写规划和验收标准，一次只构建一个批次，定位根因后做局部修改，在稳定节点保存版本，避免模糊的“全部重做”。
- 重新部署会覆盖生产数据吗？
- 官方说明通常表示 Redeploy 保留生产数据库，但预览数据不会自动复制，已有 Secrets 也可能不会自动覆盖。操作前仍要备份并核对当前部署类型。
- 生成应用可以商业使用吗？
- 可以作为商业项目基础，但要审查代码、开源依赖、字体图片、模型和第三方 API 条款，并完成隐私、安全与合规检查。