发布任务模型

本文档引用的文件

publish.types.ts
publish.service.ts
publish.controller.ts
schema.prisma
index.vue
publish-api.ts
test-douyin-publish.js

简介

AI有声书生成平台的发布任务模型是一个完整的多平台内容发布解决方案，支持抖音、快手、B站等主流短视频和音频平台的内容自动发布。该系统通过统一的任务模型和标准化的发布流程，实现了从内容生成到多平台发布的完整自动化。

发布任务模型的核心价值在于：

统一抽象：通过标准化的任务模型管理不同平台的发布需求
状态管理：完善的任务生命周期状态跟踪和转换
多平台支持：灵活扩展支持更多内容平台
错误处理：健壮的异常处理和恢复机制
用户体验：简洁直观的前端发布界面

项目结构

发布任务系统采用分层架构设计，包含前端界面、API控制器、业务服务和数据持久化四个主要层次：

graph TB
subgraph "前端层"
UI[发布页面<br/>index.vue]
API[publish-api.ts]
end
subgraph "API层"
Controller[发布控制器<br/>publish.controller.ts]
end
subgraph "业务层"
Service[发布服务<br/>publish.service.ts]
Types[类型定义<br/>publish.types.ts]
end
subgraph "数据层"
Prisma[Prisma Schema<br/>schema.prisma]
DB[(MySQL数据库)]
end
UI --> API
API --> Controller
Controller --> Service
Service --> Prisma
Prisma --> DB

图表来源

publish.controller.ts:1-333
publish.service.ts:1-630
schema.prisma:393-411

章节来源

publish.controller.ts:1-333
publish.service.ts:1-630
schema.prisma:393-411

核心组件

发布任务模型包含以下核心组件：

数据模型定义

发布任务模型采用Prisma ORM进行数据持久化，支持完整的CRUD操作和查询优化。

章节来源

schema.prisma:393-411
publish.types.ts:26-42

平台账号管理

系统支持多种内容平台的账号绑定和管理，包括抖音、快手、B站等平台。

章节来源

publish.types.ts:11-24
publish.service.ts:23-121

发布流程控制

完整的发布流程包括任务创建、状态管理、平台适配和结果反馈。

章节来源

publish.controller.ts:202-277
publish.service.ts:159-238

架构概览

发布任务系统的整体架构采用经典的三层架构模式，确保了良好的可维护性和扩展性：

sequenceDiagram
participant User as 用户
participant Frontend as 前端界面
participant API as API控制器
participant Service as 业务服务
participant Platform as 内容平台
participant DB as 数据库
User->>Frontend : 选择平台并填写发布信息
Frontend->>API : POST /publish/tasks
API->>Service : createPublishTask()
Service->>DB : 创建发布任务记录
DB-->>Service : 返回任务ID
Service->>Service : 根据平台调用发布方法
Service->>Platform : 执行平台特定发布流程
Platform-->>Service : 返回发布结果
Service->>DB : 更新任务状态和结果
DB-->>Service : 确认更新
Service-->>API : 返回发布结果
API-->>Frontend : 显示发布状态
Frontend-->>User : 展示发布结果

图表来源

publish.controller.ts:202-277
publish.service.ts:245-316

详细组件分析

发布任务模型字段详解

发布任务模型定义了完整的任务属性和约束条件：

主键和关联字段

id: 自增主键，唯一标识每个发布任务
userId: 用户ID，建立任务与用户之间的关联关系
videoProjectId: 视频项目ID，关联到具体的视频生成项目

内容元数据字段

platform: 平台标识，支持'douyin'、'kuaishou'、'bilibili'
title: 标题，必填字段，限制长度为100字符
description: 描述，可选字段，限制长度为500字符
tags: 话题标签数组，JSON序列化存储
coverUrl: 封面图片URL，可选字段

文件和状态字段

videoUrl: 视频文件URL，支持相对路径和绝对路径
status: 发布状态，枚举值包括'pending'、'uploading'、'success'、'failed'
errorMsg: 错误信息，存储发布过程中的异常详情
publishedUrl: 已发布URL，存储平台返回的作品链接

时间戳字段

createdAt: 创建时间，默认当前时间
updatedAt: 更新时间，默认当前时间，自动更新

章节来源

publish.types.ts:26-42
schema.prisma:393-411

平台账号管理模型

平台账号模型支持多平台的认证信息存储和管理：

账号基本信息

platform: 平台类型，支持'douyin'、'kuaishou'、'bilibili'
cookies: 登录Cookie，存储完整的认证信息
headers: 请求头信息，存储User-Agent等关键头部

账号状态信息

nickname: 账号昵称，用于用户界面展示
avatar: 账号头像，存储用户头像URL
isValid: 凭证有效性，布尔值标记
expireTime: 过期时间，存储认证信息的有效期限

章节来源

publish.types.ts:11-24
schema.prisma:375-391

发布状态管理

发布任务采用有限状态机模型，支持完整的状态转换：

stateDiagram-v2
[*] --> 待发布 : 创建任务
待发布 --> 上传中 : 开始发布
上传中 --> 成功 : 发布成功
上传中 --> 失败 : 发布失败
成功 --> [*]
失败 --> 待发布 : 重新发布
失败 --> 上传中 : 重新尝试

图表来源

publish.types.ts:8-9
publish.service.ts:224-238

状态转换规则

待发布(pending): 任务刚创建时的状态
上传中(uploading): 正在执行平台特定的发布流程
成功(success): 发布完成且平台返回成功确认
失败(failed): 发布过程中发生错误或平台返回失败

章节来源

publish.types.ts:8-9
publish.service.ts:262

多平台发布流程

系统支持三种主要的内容平台发布流程：

抖音平台发布流程

抖音发布采用网页版创作者平台的认证机制：

flowchart TD
Start([开始发布]) --> GetAccount[获取抖音账号信息]
GetAccount --> ValidateAccount{账号有效?}
ValidateAccount --> |否| ReturnError[返回错误]
ValidateAccount --> |是| GetTask[获取发布任务]
GetTask --> UpdateStatus[更新状态为上传中]
UpdateStatus --> ParseVideo[解析视频文件路径]
ParseVideo --> UploadVideo[调用抖音上传接口]
UploadVideo --> CheckResult{上传成功?}
CheckResult --> |是| UpdateSuccess[更新为成功状态]
CheckResult --> |否| UpdateFailed[更新为失败状态]
UpdateSuccess --> ReturnSuccess[返回成功结果]
UpdateFailed --> ReturnError
ReturnError --> End([结束])
ReturnSuccess --> End

图表来源

publish.service.ts:245-316
test-douyin-publish.js:100-141

B站平台发布流程

B站发布采用官方API的OAuth2认证机制：

sequenceDiagram
participant Service as 发布服务
participant Account as 平台账号
participant API as B站API
participant Task as 发布任务
Service->>Account : 获取B站账号信息
Account-->>Service : 返回access_token
Service->>Task : 更新状态为上传中
Service->>API : POST /v1/archive/upload/basic
API-->>Service : 返回上传结果
Service->>Task : 更新状态和结果URL
Service-->>Service : 返回发布结果

图表来源

publish.service.ts:478-548

快手平台发布流程

快手平台发布流程与抖音类似，采用网页版创作者平台的认证机制。

章节来源

publish.service.ts:245-316
publish.service.ts:478-548

前端发布界面

前端发布界面提供了完整的用户交互体验：

平台选择界面

支持多种内容平台的选择和绑定状态显示，包括抖音、B站、快手、小红书等平台。

账号绑定功能

提供自动获取Cookie和手动输入Cookie两种绑定方式，支持User-Agent自定义。

发布设置界面

包含标题、描述、话题标签等发布参数的设置，支持推荐标签的快速添加。

章节来源

index.vue:318-418
index.vue:602-625

依赖关系分析

发布任务系统各组件之间的依赖关系如下：

graph TB
subgraph "类型定义层"
Types[publish.types.ts]
end
subgraph "业务服务层"
Service[publish.service.ts]
Test[test-douyin-publish.js]
end
subgraph "API控制器层"
Controller[publish.controller.ts]
end
subgraph "数据模型层"
Prisma[schema.prisma]
end
subgraph "前端界面层"
Vue[index.vue]
API[publish-api.ts]
end
Types --> Service
Types --> Controller
Service --> Prisma
Controller --> Service
Vue --> API
API --> Controller
Test --> Service

图表来源

publish.types.ts:1-80
publish.service.ts:1-630
publish.controller.ts:1-333
schema.prisma:393-411

章节来源

publish.types.ts:1-80
publish.service.ts:1-630
publish.controller.ts:1-333

性能考虑

发布任务系统在设计时充分考虑了性能优化：

数据库性能优化

索引策略: 在(userId, platform)和(status)字段上建立复合索引，优化查询性能
查询优化: 使用Promise.all并行查询任务列表和总数，减少数据库往返次数
数据类型优化: 使用合适的数据类型和长度限制，减少存储空间占用

缓存策略

内存缓存: 对频繁访问的平台账号信息进行缓存
CDN加速: 对静态资源如封面图片和视频文件使用CDN加速

异步处理

异步上传: 视频上传采用异步处理，避免阻塞主线程
批量操作: 支持批量创建和查询发布任务

故障排除指南

常见问题及解决方案

账号绑定问题

问题: 账号绑定后无法验证 解决方案:

检查Cookie是否完整和最新
确认User-Agent设置正确
验证账号是否在目标平台有效

发布失败问题

问题: 发布任务状态长时间停留在"上传中" 解决方案:

检查网络连接和平台API可用性
验证视频文件格式和大小限制
查看错误日志获取具体错误信息

平台兼容性问题

问题: 某些平台发布失败 解决方案:

检查平台API版本和认证要求
验证平台账号权限设置
确认平台内容政策和限制

章节来源

publish.service.ts:309-315
test-douyin-publish.js:143-188

结论

AI有声书生成平台的发布任务模型是一个设计精良、功能完整的多平台内容发布解决方案。通过标准化的任务模型、完善的状态管理和灵活的平台适配机制，系统实现了从内容生成到多平台发布的完整自动化流程。

主要优势

统一抽象: 通过标准化模型管理不同平台的发布需求
状态管理: 完善的任务生命周期跟踪和转换
错误处理: 健壮的异常处理和恢复机制
扩展性: 灵活的架构设计支持新平台的快速集成
用户体验: 简洁直观的前端界面和流畅的操作体验

技术特点

采用分层架构设计，职责分离清晰
使用Prisma ORM提供类型安全的数据访问
实现了完整的异步处理和错误恢复机制
支持多种内容平台的认证和发布流程

该发布任务模型为AI有声书生成平台提供了强大的内容分发能力，为用户提供了便捷的内容发布体验，同时也为平台的规模化发展奠定了坚实的技术基础。

发布任务模型.md 14 KB Geçmiş Ham

发布任务模型

目录

简介

项目结构

核心组件

数据模型定义

平台账号管理

发布流程控制

架构概览

详细组件分析

发布任务模型字段详解

主键和关联字段

内容元数据字段

文件和状态字段

时间戳字段

平台账号管理模型

账号基本信息

账号状态信息

发布状态管理

状态转换规则

多平台发布流程

抖音平台发布流程

B站平台发布流程

快手平台发布流程

前端发布界面

平台选择界面

账号绑定功能

发布设置界面

依赖关系分析

性能考虑

数据库性能优化

缓存策略

异步处理

故障排除指南

常见问题及解决方案

账号绑定问题

发布失败问题

平台兼容性问题

结论

主要优势

技术特点

发布任务模型.md 14 KB

Geçmiş Ham