事件协议

Event Bus

事件协议

业务组件大量使用事件总线串联流程。事件通常来自 @mbjia/utils 的 eventBus，用于素材、上传、AI 搜索、权益和媒体流程之间通信。

阅读方式

字段	含义
事件	事件名。注意部分历史事件名包含大小写或空格。
方向	emit 表示组件会发出事件，on 表示组件会监听事件，emit/on 表示两种情况都存在。
说明	事件触发场景或影响范围。

事件协议是业务组件之间的隐式契约。修改事件名或 payload 前，需要同时检查触发方和监听方。

素材管理

事件	方向	说明
modal:resetFilterParams	emit/on	重置筛选
global:deleteAsset	emit/on	删除素材
global:freshFolderList	emit/on	刷新目录
global:createDirEnd	on	创建目录完成
global:updateFolderType	emit/on	更新目录类型
global:showCurrentFolderAllAsset	emit/on	显示当前目录全部素材
global:searchAll	emit/on	全量搜索

上传

事件	方向	说明
global:everywhereUpload	emit/on	触发全局上传
global:retryUpload	on	重试上传
global:handleCancelUpload	on	取消上传
global:cancel:upload	emit	上传取消
some-asset-upload-success	emit/on	某些素材上传成功
global:uploadDir	emit/on	上传文件夹
global:selectedFolder	emit/on	选择目标文件夹
global: upload-level-warning	emit/on	文件夹层级超限，注意事件名含空格

AI 搜索

事件	方向	说明
AiSearch:searchActive	emit/on	搜索激活
AiSearch:searchInActive	emit/on	搜索失活
AiSearch:searchTypeChange	emit/on	搜索类型变化
aiSearch:restAllData	on	重置 AI 搜索数据

视频与权益

事件	方向	说明
global:mediaSplittingFlow	emit	打开素材拆条
global:setMainContentOfMaterial	emit	设置主商品素材
global:beginCaptrueVideo	emit	开始视频抓取
global:beginDownloadVideoByCapture	emit	通过抓取开始下载视频
global:beginGetSplittingDetail	emit	获取拆条详情
global:downloadVideosDirectly	emit	直接下载视频
global:pureDownloadVideo	emit	纯下载视频
global:publishVideo:direct	emit	直接发布视频
global:publishVideo:direct:response:data	on	发布视频响应数据
global:beginJudgePointsFlow	emit	开始积分判断流程
global:allCheckPoints:start	emit	开始全量积分检查
global:allCheckPoints:wholeProcess:start	emit	开始全流程积分检查
global:allCheckPoints:wholeProcess:hasEnough	emit/on	全流程积分充足
global:allCheckPoints:InsufficientPoints:start	emit	积分不足流程开始
global:showNotEnoughVideoPoints	emit	显示视频点数不足
global:showPurchasePoints	emit	显示购买点数
global:showConsumeDetail	emit	显示消费明细
global:AllUserInterests:BuyPoint:open	emit	打开购买点数弹窗
global:AllUserInterests:UpgradeVip:changeState	emit	升级会员状态变化
opening:rights:insufficient	emit	权益不足提示
vip:modal:open	emit	打开会员弹窗
global:GeneralInterestsFlow:show	emit	显示通用权益流程
global:AliBuyModal:show	emit	显示阿里购买弹窗
global:WaitingMemo:close	on	关闭等待提示

电商

事件	方向	说明
eCommerce:asset:edit	emit	编辑电商素材
eCommerce:showECommerceGoods	emit	显示电商商品
global:closeECommerceStatusModal	emit	关闭电商状态弹窗
global:taobaoDispatchSelectModal:dispatch	emit	淘宝分发选择弹窗
taobao:lastUnpaidOrder:open	emit	打开淘宝最后未支付订单
taobao:saas:dispatch	emit	淘宝 SaaS 分发
taobaoTemplate:order:confirm	emit	淘宝模板订单确认

编辑器

事件	方向	说明
editor:global:taobaoDispatchVideo	emit	编辑器淘宝分发视频
editor:global:taobaoDrawer	emit	编辑器淘宝抽屉
editor:global:taobaoOrderRedispatch	emit	编辑器淘宝订单重分发
editor:global:taobaoSaasRedispatch	emit	编辑器淘宝 SaaS 重分发
editor:global:taobaoStatusModal	emit	编辑器淘宝状态弹窗
template:editor:redux	emit	模板编辑器 Redux 同步
video:editor:fresh	emit	视频编辑器刷新
video:editor:track:main	emit	视频编辑器主轨道
video:editor:track:select	emit	视频编辑器轨道选择
videoEdit:panel:nav	emit	视频编辑面板导航
file-editor:complete	emit	文件编辑完成
cover:editor:change:template	emit	封面编辑器切换模板
cover:editor:preview	emit	封面编辑器预览
global:PlaneEditing:startDownload	emit	平面编辑开始下载
global:reFetchVideo	emit/on	重新获取视频

预览

事件	方向	说明
preview:play:change	emit	预览播放状态变化
preview:time:change	emit	预览时间变化
previewSideBar:checkVipInfo	emit	预览侧边栏检查 VIP
previewSideBar:download:byCopy	emit	预览侧边栏复制下载
previewSideBar:publishVideo:start	emit	预览侧边栏开始发布

轻应用

事件	方向	说明
lightApplication:goBack	emit	轻应用返回
lightApplication:publish	emit	轻应用发布
lightApplication:publishVideo	emit	轻应用发布视频
lightApplication:rePublishVideo	emit	轻应用重新发布视频

音乐与字幕编辑

事件	方向	说明
music:ai:match	emit	AI 音乐匹配
music:default:match	emit	默认音乐匹配
musicEdit:musicBox:reset	emit	音乐编辑框重置
captionEdit:audioBox:reset	emit	字幕编辑音轨重置

批量与素材分析

事件	方向	说明
global:batchAssetAnalysis	emit	批量素材分析
global:batchGenerate	emit	批量生成
global:getAssetAnalysisResult	emit	获取素材分析结果
global:reTryAnalysis	emit	重试分析
global:cancelAnalysis	emit	取消分析
global:cancelCantAnalysisAssetAndBeginAnalysis	emit	取消不可分析素材并开始分析
global:unSelectedAnalysis	emit	取消选中分析
beginAssetsAnalysisFlow	emit	开始素材分析流程
create-asset-success	emit	素材创建成功
assets:fission:getCurrentList	on	裂变获取当前列表

个人中心

事件	方向	说明
personalCenter:finalcut:download:success	emit	个人中心 Finalcut 下载成功
personalCenter:upload:clear	emit	个人中心上传清除

标签与文件夹

事件	方向	说明
global:showAddTagModal	emit	显示添加标签弹窗
global:tagSelectSubmit	emit	标签选择提交
global:showFolderModal	emit	显示文件夹弹窗
global:showFolderModal-level	emit	显示文件夹层级弹窗
global:hideManage	emit	隐藏管理
global:goCoverWithId	emit	跳转封面页
global:needContinueUploadAsset	emit/on	需要继续上传素材
global:modalTitle:modalDescribe	emit/on	弹窗标题描述

Uppy 上传事件

这些事件来自 @uppy/core，通过 uppy_on / uppy_off 监听：

事件	说明
file-added	文件加入上传队列
file-removed	文件从队列移除
upload-start	上传开始
upload-progress	上传进度变化，回调参数 (file, progress)
upload-success	单文件上传成功
upload-error	单文件上传失败
complete	批次上传完成
restored	上传队列恢复完成
restore-confirmed	恢复确认
restore-canceled	恢复取消
restore:get-data	获取恢复数据
state-update	上传状态更新
thumbnail:generated	缩略图生成完成
postprocess-complete	后处理完成