Lumeow AI · MVP 产品原型

结构图 · 用户流程 · 可点击原型 · 接口映射

MVP v1

功能结构图

一期目标只保留能验证核心价值和商业闭环的功能：找到角色 → 进入对话 → 持续聊天；创作者能创建角色；用户对话额度不足时能完成充值。

Lumeow AI
AI 角色互动平台 MVP

① 用户与账号

  • 注册 / 登录 / Google 登录
  • 找回密码
  • 个人资料
  • 剩余对话次数
  • 退出 / 注销

② 角色内容

  • 角色发现列表
  • 搜索 / 标签 / 分类
  • 角色详情
  • 收藏（可选）
  • 角色创建 / 编辑 / 发布

③ AI 对话

  • 创建会话
  • SSE 流式回复
  • 消息历史
  • 重生成 / 编辑 / 删除
  • 停止生成
  • 历史会话
  • 长期 / 永久记忆

④ 商业化

  • 剩余次数 / 余额
  • 充值套餐
  • 创建订单
  • 支付状态
  • 支付回调 / 幂等（需补）
  • 订单记录

⑤ 创作中心

  • 保存草稿
  • 我的作品
  • 上下架
  • 可见性
  • 违规状态

⑥ 社区轻互动

  • 评论
  • 评论列表
  • 点赞
  • 热门评论
  • 评论审核

⑦ 文件能力

  • 角色头像上传
  • 封面 / 立绘上传
  • 公共文件下载

⑧ MVP 明显缺口

  • 角色 CRUD / 详情
  • 角色发布动作定义
  • 删除整个会话
  • 订单详情 / 取消
  • 支付回调 / 退款
P0 必做P1 可压后当前接口需要确认/补充
3 条主链路

核心用户流程

一期不追求功能全，而是保证三条链路真的跑通：消费、创作、付费。

普通用户：发现 → 对话

登录 / 注册建立账号状态
→
角色发现列表 / 搜索 / 标签
→
角色详情设定 / 开场白
→
创建会话story/create
→
AI 对话SSE 流式
→
历史 / 记忆继续故事

创作者：创建 → 发布

个人中心我的角色
→
创建角色基础信息
→
角色设定人设 / 世界观
→
保存草稿creation drafts
→
发布角色当前需补接口
→
进入发现被用户使用

商业闭环：额度不足 → 支付 → 继续聊天

对话额度不足余额 / 次数校验
→
充值中心商品列表
→
创建订单order/create
→
渠道支付微信 / 支付宝
→
支付确认回调 + 状态查询
→
次数到账继续聊天

一期成功标准

1
新用户 1 分钟内能进入第一次对话
2
创作者能独立创建并发布一个角色
3
额度耗尽后能完成真实支付并恢复聊天

暂缓到下一期

—
指令市场、红包、推广分销、创作者分成
—
复杂排行榜、世界书编辑器、存档系统
—
生图、TTS、Live2D 等 AI 增值
Clickable

可点击 HTML 原型

左侧导航和页面内主要按钮都可点击。角色创建、聊天回复和充值都使用本地模拟状态，无需后端。

欢迎回来

开启你的专属故事

发现角色

找到一个故事，然后开始聊天
角色详情
🌙

角色简介

开场剧情

创建角色

四步完成：基础信息 → 人设关系 → 剧情对话 → 发布设置
基础信息
用于发现页、详情页和聊天页。
原型用 Emoji；正式版接公共文件上传。
建议 3～6 个，用逗号分隔。
角色设定
剧情与对话
用户示例
角色示例
示例对话用于稳定角色语气和人格。
发布设置
允许评论
发布后用户可留言。
允许被搜索
关闭后不进入公开搜索。
🌙

夜璃

财团继承人
简介

关系

开场

角色
在线 · 剩余 12 次
长期记忆

历史对话

继续之前的剧情

充值中心

剩余对话次数：12
支付方式
👤

Demo User

demo@lumeow.ai
12
剩余对话
1
我的角色

个人中心

账户与创作入口
API Scope

一期 MVP 接口整理

以下按“直接来自接口文档”和“为了跑通 MVP 必须额外纳入/补齐”拆分。P0 是建议本期必须接，P1 可以在不影响核心闭环的情况下后置。

1. Story — 对话核心 P0

这是现有文档里最完整的一组，足够支撑 MVP 聊天体验。

优先级接口MVP 用途
P0/api/story/create创建一次角色会话
P0/api/story/messageSSE 发送消息 / AI 流式回复
P0/api/story/message-list恢复聊天页时拉历史消息
P0/api/story/chat/stop停止生成
P0/api/story/message/slide重新生成 / 多版本切换
P0/api/story/message/save编辑消息
P0/api/story/message/del + /del/check删除消息及前置校验
P0/api/story/chat/history/records-page/V2历史会话列表
P1/api/story/restart重开剧情
P1/api/story/chat/get/setting/v1 + /setting聊天设置
P1/api/story/memory/list/v2长期记忆列表
P1/api/story/memory/permanent/list + edit/permanent永久记忆展示 / 编辑

2. Character — 发现与详情 P0

列表、搜索、标签都有，但“详情 + 创建编辑发布”不在这 25 个接口里，是 MVP 最大缺口。

优先级接口MVP 用途
P0/api/character/v2/list/V1发现页角色列表
P0/api/character/page/search/V1角色搜索
P0/api/character/tags/V2筛选标签
P0/api/character/types角色类型
P1/api/character/top热门 / 排行
P1/api/character/impressions角色印象
P1/api/character/comment/list + comment角色评论
缺失GET /api/character/{id}角色详情（建议补）
缺失POST /api/character/create创建角色（建议补）
缺失PUT /api/character/{id}编辑角色（建议补）
缺失POST /api/character/{id}/publish发布 / 上架（建议明确）

3. User — 登录与账户 P0

优先级接口MVP 用途
P0/api/user/login邮箱 / 手机登录
P0/api/user/register注册
P0/api/user/google/loginGoogle 登录
P0/api/user/send-verify-code注册 / 找回密码验证码
P0/api/user/reset-pwd重置密码
P0/api/user/login/check登录态恢复
P0/api/user/info/V1 + /info/save个人中心资料
P0/api/user/balance/dialog-times剩余对话次数
P1/api/user/balance/change/list余额 / 消费明细
P1/api/user/unregister/V1账号注销
P1/api/user/ban/detail + /ban/appeal封禁 / 申诉

4. 为了“角色创建”必须额外纳入

优先级接口MVP 用途
P0/api/creation/center/drafts/save角色编辑器保存草稿
P0/api/creation/center/works/list我的角色 / 我的作品
P0/api/creation/center/works/details编辑已有作品时读取数据
P0/api/creation/center/works/update/state上架 / 下架
P0/api/creation/center/works/update/visibility公开 / 私有
P0/api/common/file/upload/public头像 / 封面上传
需确认角色实体创建 / 更新接口creation 草稿接口是否最终落 character，需要后端明确

5. 为了“支付”必须额外纳入

优先级接口MVP 用途
P0/api/product/page充值档位
P0/api/order/create创建订单 / 获取支付信息
P0/api/order/result/check前端轮询支付结果
P0/api/order/list/page订单记录
缺失支付渠道 callback服务端确认支付结果，必须做幂等
缺失GET /api/order/{id}订单详情
P1订单取消 / 退款支付售后能力
建议后端在开工前先确认 5 个问题： ① creation 草稿最终如何变成 character；② 角色详情接口到底是哪一个；③ 发布/下架后首页列表如何同步；④ /order/create 返回支付 URL、二维码还是渠道参数；⑤ 支付成功到底以服务端 callback 还是前端 /result/check 为准。把这 5 个点定死，前端一期基本就能顺畅推进。