Skip to content

前端业务模块拆分 #41

Description

@huyanxius

承接产品策划案 #37,对 Windup「一次运行工作流」的前端做业务模块拆分:以前端页面 / 交互模块为单位,列出每个模块的行为与所需后端请求。

#39 模块拆分 是互补的两条轴 —— #39 从服务与接口拆系统模块,本 issue 从前端页面与所需请求拆前端模块;二者是同一产品的不同切面,不互相替代。

术语已对齐架构 #3 与导师评审口径(PR #2 / #38):统一使用基准帧(非「母版」)、动作模板 / 动作(非「动作定义 / 动作实例」),并保留造型层(基准帧归属造型,MS2 单造型)。

逐行评审走 review-only PR(仅评审不合并),评审定稿后内容落回本 issue,此后本 issue 作为 MS2 前端开发的起点与后续跟踪。


主线 / Main Flow

快速开始 ─────┐
              ├→ 运行工作流(画布)
从项目开始 ───┘     项目 → 角色/造型基准帧 → 动作 → 生成 → 审核 → 网页手感模拟质检 → 导出

所有模块都挂在一次运行工作流上。画布展示节点、连线、当前步骤和运行状态。

A. 应用基座

为所有页面提供共用的路由、外壳、当前上下文和服务请求入口。

  • 页面路由与导航
  • 应用外壳
  • 当前用户和当前项目入口
  • 全局提示
  • 统一服务请求

B. 工作流 / Workflow

负责节点编排、连线、导航和运行状态;点开节点后进入 C–G 对应界面,不重复实现具体业务。

B1. 快速开始 / Quick Start

  • 输入自然语言需求
  • 展示识别出的角色、动作和生成要求
  • 确认后创建并进入工作流

需要请求:

  • 解析自然语言需求
  • 创建工作流运行

B2. 从项目开始 / Start from Project

  • 选择项目
  • 选择已有角色或创建角色
  • 选择已有动作或新增动作
  • 确认后进入工作流

需要请求:

  • 获取项目、角色和动作
  • 创建工作流运行

B3. 工作流画布 / Workflow Canvas

  • 展示项目、角色/造型基准帧、动作、生成、审核、网页手感模拟质检和导出节点
  • 展示节点连线和先后关系
  • 上游节点确认后解锁下游节点
  • 展示当前节点、已完成节点和待处理节点
  • 点击节点查看和处理当前步骤

需要请求:

  • 获取工作流运行状态
  • 获取各节点状态(如正在生图中获取图片)
  • 提交当前节点结果

C. 项目与角色资产 / Projects & Character Assets

管理项目约束以及项目内的角色、造型、动作和资产。

C1. 项目 / Projects

  • 查看和选择项目
  • 创建项目
  • 设置项目名称、题材、美术风格和参考图
  • 设置视角模式、方向数量和画布尺寸
  • 在顶栏查看当前项目约束并切换项目

需要请求:

  • 获取项目列表和详情
  • 创建和修改项目名称

C2. 角色、造型与基准帧 / Characters, Outfits & Base Frames

  • 创建或选择角色
  • 选择从零创建、上传参考图或使用已有角色
  • 填写角色名称和角色身份描述
  • 提交造型基准帧生成要求,实际生成进入 D 模块
  • 选择和确认造型基准帧
  • 默认继承当前项目的风格、视角和方向约束
  • 查看角色已有动作

造型是角色的一套装扮,基准帧是该造型的定妆参考,后续动作均照它生成;MS2 每个角色单造型。

需要请求:

  • 获取角色列表和详情
  • 创建角色
  • 获取和确认造型基准帧

C3. 动作 / Actions

  • 查看动作模板
  • 选择一个动作模板应用到当前基准帧
  • 查看动作状态

需要请求:

  • 获取动作模板
  • 创建动作
  • 获取动作详情

C4. 资产库 / Asset Library

  • 查看当前项目的角色列表
  • 查看造型基准帧、动作数量和帧数统计
  • 按角色、视角和动作浏览资产
  • 从动作资产进入审核台
  • 为当前角色继续补充动作

需要请求:

  • 获取项目资产概览
  • 获取造型基准帧和动作资产

D. 生成 / Generation

负责两类生成任务的确认、进度与重试:基准帧生成、动作生成。两类任务共用同一套机制(排队 / 质检 / 重试),但输入与产物不同。

D1. 生成确认 / Generation Confirmation

  • 基准帧生成:展示项目与角色信息,确认后生成候选基准帧
  • 动作生成:展示已确认基准帧与动作要求,确认后生成候选帧
  • 展示生成要求与预计积分消耗
  • 确认并开始生成

需要请求:

  • 发起生成(区分基准帧生成 / 动作生成)

D2. 生成进度 / Generation Progress

  • 展示任务状态:排队中、生成中、质检中、成功、失败
  • 按任务类型展示步骤:基准帧生成 = 理解需求 → 生成基准帧 → 自动质检;动作生成 = 生成动作 → 自动质检
  • 候选基准帧或候选帧逐步出现
  • 任务失败时展示原因和重试入口

需要请求:

  • 获取生成任务状态
  • 获取候选基准帧或候选帧

D3. 生成任务重试 / Generation Retry

  • 重试失败任务
  • 查看重试进度和结果

需要请求:

  • 重试生成
  • 获取重试任务状态

E. 审核 / Review

负责动作预览、逐帧审核、自动质检结果查看和退回修复。

E1. 审核对象与动画预览 / Review Target & Animation Preview

  • 切换角色、视角和动作
  • 播放与暂停
  • 按 FPS 播放
  • 逐帧前进、后退和查看

需要请求:

  • 获取可审核的角色、视角和动作
  • 获取动作帧和播放配置

E2. 逐帧审核 / Frame-by-frame Review

  • 查看帧列表
  • 逐帧通过或退回
  • 批量通过
  • 在时间轴中区分待审、通过和退回帧
  • 查看审核进度

需要请求:

  • 获取帧审核状态
  • 保存单帧或批量审核结果
  • 恢复未完成的审核进度

E3. 质检结果 / Quality Check Results

  • 查看自动质检结论
  • 查看透明背景、画布尺寸、脚底基线、主体高度、相邻帧位移和循环接缝结果
  • 查看问题说明

需要请求:

  • 获取自动质检结果和问题说明

E4. 退回修复 / Return for Revision

  • 选择需要修复的单帧或单段
  • 填写退回要求
  • 发起单帧或单段重生成
  • 新帧返回后继续审核

需要请求:

  • 发起单帧或单段重生成
  • 获取修复任务状态
  • 获取修复后的帧

F. 手感模拟质检 / In-Browser Playability QA

在网页内模拟试玩角色,通过多动作按键绑定验证动作衔接与操作手感。这是浏览器里的手感模拟,不在真实游戏引擎中运行;真实引擎适配属于导出侧与后续工作。

MS2 纳入本模块:完成多动作选择、按键绑定、网页内模拟和退回审核。

F1. 动作与按键绑定 / Action & Key Binding

  • 选择多个已通过审核的动作
  • 为移动、待机、跳跃、攻击等动作绑定按键
  • 查看和修改当前按键映射

F2. 网页内模拟 / In-Browser Simulation

  • 在独立预览页面中试玩角色
  • 通过 WASD 和绑定按键触发、组合和切换多个动作
  • 展示当前触发按键和正在播放的动作
  • 切换动作循环状态
  • 检查动作循环、衔接、方向、锚点和实际操作手感

F3. 质检结论 / QA Result

  • 通过网页手感模拟质检
  • 将问题定位回具体动作或帧
  • 返回审核台继续修复

需要请求:

  • 获取可参与模拟的动作及对应资源
  • 获取和保存按键绑定
  • 保存手感模拟质检结果

G. 导出 / Export

将通过质检的动作组织为可下载、可导入目标引擎的资源包。

G1. 导出内容 / Export Content

  • 仅选择通过审核和网页手感模拟质检的动作
  • 预览透明 PNG、序列帧、SpriteSheet、GIF 和 JSON metadata

G2. 导出目标 / Export Target

  • 选择导出格式
  • 选择目标引擎
  • 查看目标引擎的包结构和平台要求

G3. 导出结果 / Export Result

  • 查看导出进度
  • 下载资源包
  • 查看引擎导入步骤
  • 返回项目或当前工作流

需要请求:

  • 获取可导出动作
  • 发起导出
  • 获取导出状态和下载链接

(一键导入目标引擎通过后续的引擎侧插件实现)

H. 账户 / Account

为用户提供注册、登录、会话恢复、登出和账户设置。

H1. 登录与注册 / Sign In & Sign Up

  • 邮箱密码登录
  • 邮箱验证码
  • 第三方账户登录
  • 用户注册
  • 忘记密码与重置密码

H2. 用户会话 / User Session

  • 当前用户
  • 登录状态
  • 自动恢复登录状态
  • 未登录访问时进入登录页
  • 登出

H3. 账户设置 / Account Settings

  • 个人资料
  • 修改密码

需要请求:

  • 登录、注册和登出
  • 发送验证码和重置密码
  • 发起第三方登录
  • 获取当前用户
  • 读取和修改账户资料

I. 积分与计费 / Credits & Billing

为用户展示积分余额、生成报价、套餐购买和消费记录。

I1. 积分余额 / Credit Balance

  • 当前余额
  • 可用额度
  • 余额不足提醒
  • 生成完成后展示本次积分消耗

I2. 生成报价 / Generation Estimate

  • 显示预计消耗
  • 余额不足时拦截生成并引导购买

I3. 套餐与记录 / Plans & Billing History

  • 查看套餐
  • 查看当前套餐
  • 购买或订阅
  • 按时间和消费类型查看消费记录

需要请求:

  • 获取积分余额和生成报价
  • 获取套餐并提交购买
  • 获取消费记录

MS2 不做

  • 将工作流保存为模板
  • 流程库
  • 跨角色重放已保存工作流
  • 账户(H)、积分计费(I)、多引擎真实适配:属总架构范畴,MS2 保留结构、不落地实现

验收 / 下一步

Metadata

Metadata

Assignees

No one assigned

    Labels

    documentationImprovements or additions to documentation

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions