主题
AI 对话聊需求
进入智码方舟后,你会看到一个 AI 对话界面。在这里用自然语言描述你想做的项目,AI 会引导你补充细节。
对话界面说明
对话页面分为三个区域:
| 区域 | 功能 |
|---|---|
| 左侧边栏 | 对话列表,可创建、切换、删除对话 |
| 中间聊天区 | 和 AI 对话的主区域,发送消息、查看回复 |
| 右侧需求栏 | AI 实时提取的功能模块和需求结构 |
三步进度条
对话过程中,顶部会显示 3 个步骤:
第1步:描述需求 → 第2步:AI 确认需求 → 第3步:生成项目- 第 1 步:你描述项目想法,AI 提问补充细节
- 第 2 步:AI 从对话中提取出结构化的需求(右侧需求栏同步显示)
- 第 3 步:需求确认后,点击"生成项目"进入技术栈选择
消息配额
每个对话有消息数量限制,属于免费额度。当剩余消息不足 30% 时会显示提醒。
额度用完后,可以购买额外消息继续对话。
如何写好需求
需求描述的质量直接决定生成代码的质量。 AI 会根据你的需求进行全局规划,需求越清晰,规划越精确。
好需求 vs 差需求
差的需求:
做一个电商系统
问题:什么类型?哪些功能?什么用户角色?AI 只能猜测。
好的需求:
做一个二手书交易平台,用户可以发布自己的闲置书籍,其他用户可以浏览和购买。
用户角色:
- 普通用户:发布书籍、购买书籍
- 管理员:审核书籍、处理举报
核心功能:
- 书籍发布:标题、作者、类别、新旧程度、价格、照片
- 书籍搜索:按书名、作者、类别筛选
- 订单管理:下单、付款、发货、确认收货
- 个人中心:我发布的、我购买的、收藏夹
需求描述要点
- 明确功能点:不要说"管理文章",而是说"可以发布、编辑、删除文章"
- 描述用户角色:谁会使用这个系统?管理员?普通用户?
- 说明业务规则:比如"草稿不对外显示"、"评论需要审核"
- 控制范围:先做核心功能,控制在 3~5 个主要模块
常见误区
| 误区 | 问题 | 建议 |
|---|---|---|
| 需求太简单 | "做一个博客" —— 太模糊 | 至少说明核心功能和用户角色 |
| 需求太复杂 | "做完整电商平台+社区+直播" | 从核心功能开始,MVP 原则 |
| 只说是什么 | "需要订单管理" | 描述用户如何使用 |
| 忽略业务规则 | 只列功能,不说规则 | 规则很重要,比如"库存不足不能下单" |
需求描述模板
使用以下模板来组织你的需求,覆盖了项目描述的关键维度:
markdown
# [系统名称]
## 项目背景
简要描述这个项目是做什么的,解决什么问题。
## 用户角色
列出所有使用系统的用户类型:
- 角色1:描述该角色的主要职责和能做什么
- 角色2:描述该角色的主要职责和能做什么
## 核心功能
### 功能模块1:[模块名]
- 功能点1.1(具体描述,如:用户可以上传商品图片,最多5张)
- 功能点1.2(具体描述)
- 功能点1.3(具体描述)
### 功能模块2:[模块名]
- 功能点2.1
- 功能点2.2
## 业务规则
列出重要的业务逻辑和规则:
- 规则1(示例:订单超过30分钟未付款自动取消)
- 规则2(示例:每个用户最多同时发布10个商品)
## 数据和展示
描述你希望看到的数据展示:
- 首页:显示最新上架的商品、热门分类
- 个人中心:我发布的、我购买的、我的收藏提示:用户角色建议控制在 2-3 种,功能模块控制在 3-5 个,遵循 MVP 原则。
需求自检清单
在确认需求之前,用以下清单逐项检查:
- [ ] 项目目标清晰:一句话能说明这是做什么的
- [ ] 用户角色明确:列出了所有使用者类型
- [ ] 核心功能具体:主要功能点都有详细描述,不是简单的"需要XX功能"
- [ ] 业务规则完整:重要的规则和限制都说明了(如库存不足不能下单)
- [ ] 范围可控:功能模块在 3-5 个以内
- [ ] 没有模糊表述:没有"等等"、"之类的"、"大概"这类词
常见项目需求示例
以下是一些常见类型项目的需求参考,点击展开查看详情。
博客系统
- 用户角色:管理员、作者、访客
- 文章管理:发布、编辑、删除、草稿、定时发布
- 分类标签:多级分类、标签系统
- 评论功能:发表评论、回复、审核
- SEO 优化:自定义 URL、Meta 信息
- 业务规则:草稿不对外显示、评论需审核后展示
电商系统
- 用户角色:买家、管理员
- 商品管理:上架、下架、库存、分类、多图片
- 购物流程:加入购物车、下单、支付(模拟)
- 订单管理:订单状态流转、收货确认
- 用户中心:个人信息、收货地址、订单历史
- 业务规则:库存不足不能下单、30分钟未付款自动取消
管理后台
- 用户角色:管理员、普通员工
- 权限系统:角色权限、菜单权限
- 数据管理:CRUD 操作、批量操作、导入导出
- 数据展示:表格、图表、统计面板
- 系统设置:参数配置、操作日志
- 业务规则:员工只能看自己负责的数据
任务管理系统
- 用户角色:管理员、普通用户
- 任务管理:创建、编辑、删除、标记完成
- 任务属性:标题、描述、截止日期、优先级、标签
- 视图展示:列表视图、看板视图
- 筛选排序:按状态、优先级、日期筛选
- 业务规则:逾期任务高亮显示、完成的任务可恢复
外部 API 选项
如果 AI 在对话中检测到你的项目可能需要调用外部接口(如支付、地图等),会出现一个选项:
| 选项 | 说明 | 适合 |
|---|---|---|
| 模拟接口 | AI 生成模拟数据,开箱即用 | 快速验证功能,大多数用户推荐 |
| 真实接口 | AI 集成真实的第三方 API,需要你提供 API 密钥 | 有第三方平台账号,能获取 API 密钥 |
不确定就选模拟接口
- 如果你没有第三方平台的 API 密钥(如微信支付商户号、地图 API Key 等),请选择模拟接口
- 模拟接口不影响项目功能展示,答辩和演示完全够用
- 后续如果需要对接真实接口,可以手动替换
下一步
需求确认后,AI 会提取出结构化的功能模块。此时点击"生成项目"按钮,进入技术栈选择。