消息与任务

用途

VVICAT 中有两类状态信息：站内消息用于发布产品更新和系统通知，任务状态用于表示文本、图片、视频、语音、导出等后台操作的执行进度。两者入口和处理方式不同。

使用前准备

登录后确认当前项目或任务作用域。普通用户可查看自己的消息与任务结果；全队列和失败详情需要管理员权限。

配图占位

页面：站内消息列表与详情抽屉

状态：同时有一条未读消息和一条带操作链接的已读消息

重点区域：未读标记、发布时间、正文、操作链接和重试

脱敏要求：隐藏真实用户、项目、任务标识和消息正文中的敏感信息

操作步骤

站内消息

登录后，顶部导航右侧的铃铛显示未读数量或未读圆点。点击铃铛进入消息列表，每页最多显示 20 条；未读消息带蓝色标记。

点击消息卡片，在右侧抽屉查看完整内容。
打开消息时会自动标记为已读。
消息包含操作链接时，点击“前往查看”进入对应页面。
加载失败时使用“重试”，不要连续刷新整个页面。

部分重要消息会以弹窗显示。可以稍后处理，也可以确认后查看全部未读消息。

后台任务

模型生成和视频导出通常不会在浏览器请求中等待完成，而是提交到后台队列。常见状态如下：

状态	含义	建议操作
等待	已提交，等待 Worker 处理	保持页面打开或稍后返回，不要重复提交
运行中	Worker 正在调用模型或处理媒体	观察进度，避免修改同一输入
完成	结果已保存	检查预览、版本和下载入口
失败	输入、模型、网络、存储或服务异常	阅读错误，修正原因后重试
已取消	用户或系统停止任务	确认是否需要重新提交

页面可能通过实时事件更新状态。短暂没有进度不代表任务丢失；刷新页面后以服务端任务记录为准。

不同任务的结果位置

操作	完成后查看
标准短剧生成	当前剧集对应阶段和素材卡片
无限画布节点	节点预览、版本面板和资产管理
资产中心生成	对应角色、场景、道具或音色卡片
AI 剪辑导出	导出面板和下载按钮
管理员批量操作	管理后台任务、日志或对应配置页

安全重试

记录任务 ID、发生时间、项目、剧集或节点。
阅读页面可见错误，确认是否为参数、凭据、余额、模型能力或网络问题。
检查结果是否已经生成，避免因状态延迟创建重复产物。
修正原因后只重试一次；仍失败时交由管理员查看任务和日志。

[!WARNING] 重复点击生成可能产生多次模型调用和费用。不要把“页面没有立即变化”当作任务未提交。

管理员查看任务

管理员后台的任务页面同时展示数据库任务和 Redis 队列概况，并定时刷新。管理员可以按状态和任务信息定位问题，但不应在不了解业务记录的情况下直接清理或批量重试队列。

开发环境可使用 Bull Board 查看等待、运行、完成和失败任务。Bull Board 是队列观察工具，不是业务数据修复入口。

配图占位

页面：管理员任务监控

状态：队列正常运行，并有一条脱敏失败任务

重点区域：状态统计、Worker 数量、等待/运行数量和错误摘要

脱敏要求：隐藏用户、项目、输入输出、供应商响应和完整任务标识

结果与状态

站内消息有未读和已读状态；后台任务有等待、运行中、完成、失败和已取消状态。任务完成后，结果回到对应剧集阶段、画布版本、资产卡片或导出面板，而不是消息正文。

权限和限制

普通用户只能查看自己有权访问的消息、项目任务和结果。
管理员任务页用于监控，不会自动重试、清理或取消任务；队列操作前必须核对业务记录。
重复提交可能产生重复产物和费用。先确认服务端状态，再安全重试一次。

常见问题

消息已读数量没有立即变化

等待列表刷新或重新进入消息页。若持续不一致，检查网络请求和消息读取接口，不要通过数据库手工修改。

任务一直等待

确认 Worker、Redis 和对应队列可用，再检查队列是否暂停或没有 Worker。普通用户记录任务 ID 后联系管理员。

任务显示完成但没有预览

刷新当前阶段或节点版本，检查媒体存储是否可访问。画布节点还应确认当前选中的是否为新版本。

任务失败后输入还在吗？

大多数流程会保留输入和已成功的中间产物，但重建或复位操作可能清理下游数据。重试前阅读页面确认提示。