2.0.0@2026.08.24

v2.0.0 - 新增 AIWorkflow 智能分析模块

一、更新概述

本次更新围绕 AI 教育场景 进行扩展， - 新增 AI 教育场景化解决方案，支持 AI 章节、视频拆条、内容摘要与知识点展示，为短剧与短视频场景提供基于 AI 的视频内容理解能力，涵盖摘要生成与章节拆分等核心分析场景，同时完善了项目文档体系与工程化配套工具，进一步提升开发者的集成效率与使用体验。

---

二、核心能力上线

1. AIWorkflow 智能分析模块

• 新增 AIWorkflow 控制器、服务层和实体类，构建完整的视频分析任务处理链路。
• 实现工作流提交、任务查询和 AI 结果获取等核心 API 接口，支持异步任务模式。

2. 结构化结果解析

• 新增摘要（Summary）分析结果的结构化解析能力，支持视频内容自动摘要提取。
• 新增章节（Chapter）分析结果的结构化解析能力，支持视频内容自动章节拆分。

3. 性能优化

• 引入 5 分钟缓存机制，对 AI 分析结果进行缓存，减少重复调用，提升查询性能。

4. 工程化配套

• 新增打包工具脚本与统计生成脚本，提升项目构建与运维效率。

---

三、文档与配套说明

• 新增 AIWorkflow 模块 API 文档，包含接口说明、请求/响应示例与错误码定义。
• 新增快速上手指南，帮助开发者快速完成 AI 分析能力的接入与验证。
• 新增数据模型说明文档，详细描述各实体结构与字段含义。
• 补充项目配置文件（pom.xml、application.yml、.gitignore）及示例代码。

---

📋 API 概览

接口	方法	说明
/api/aiworkflow/submit	POST	提交 AI 工作流分析任务
/api/aiworkflow/query	GET	查询任务执行状态
/api/aiworkflow/result	GET	获取 AI 分析结果（摘要/章节）

1.3.0@2026.03.18

播放鉴权工具包正式发布 & 依赖优化

新增功能

• 正式发布 vod-toolkits 播放鉴权工具包集合
  提供跨语言（Java / Python / Go / PHP）的 JWTPlayAuth 本地生成与验证能力，支持服务端在不调用点播 API 的情况下，本地直接生成播放凭证，适用于：

  • 高并发播放场景（降低远程调用压力）
  • 网络不稳定环境（提升播放成功率）
  • 自主控制播放逻辑（灵活定制过期时间、内容策略等）

• 统一术语规范

  • 点播颁发播放凭证（PlayAuth）：由阿里云视频点播服务签发。
  • 本地签名播放凭证（JWTPlayAuth）：由客户 AppServer 基于 PlayKey 本地签名生成（JWT），点播服务负责校验。

升级需知

• 若使用 JWTPlayAuth，请确保客户端播放器 SDK ≥ 7.10.0
• PHP/Python 用户需特别注意 PlayKey 长度要求（详见各语言 README）
• 本次更新 无破坏性变更，现有 PlayAuth 调用方式完全兼容

1.2.0@2025.12.22

统一播放凭证术语：明确区分 PlayAuth 与 JWTPlayAuth

为提升一致性，本次更新将本地 JWT 签名生成的播放凭证正式命名为 JWTPlayAuth，并统一所有文档与代码注释中的表述：

• 点播颁发播放凭证（PlayAuth）：由阿里云视频点播服务签发。
• 本地签名播放凭证（JWTPlayAuth）：由客户 AppServer 基于 PlayKey 本地签名生成（JWT），点播服务负责校验。

💡 业务字段仍名为 playAuth。

主要变更

• 所有文档（README、API 指南、设计说明等）术语标准化
• Java 代码注释更新（JwtUtil、PlaylistItemDto、PlayListServiceImpl 等）
• 流程图重命名以匹配新术语

⚠️ 注意

使用 JWTPlayAuth 要求客户端播放器 SDK ≥ 7.10.0，否则无法播放。

本次更新无接口变更，仅优化表述，便于理解与维护。

1.1.0@2025.12.11

一、feat(播放鉴权): 增强播放密钥缓存与异步处理机制

• 新增基于ConcurrentHashMap的应用播放密钥缓存，支持10分钟TTL过期机制
• 重构播放列表获取逻辑，采用CompletableFuture实现并行化执行
• 将串行媒体信息调用替换为异步批量处理
• 使用parallelStream并行流优化视频列表处理性能
• 更新文档链接及配置文件结构（相关Markdown文件）

1.0.0@2025.12.03

一、项目总体说明

VodAppServer 是面向短剧与短视频场景的后端服务框架，基于阿里云 VOD（视频点播）能力构建，提供标准化的内容管理、媒资管理与播放鉴权等核心组件。系统通过可直接部署的 Demo 实现，为 业务快速集成、架构验证与产品评估 提供高可用、高可扩展的服务端参考。

围绕 内容生产链路、媒资生命周期管理与播放安全控制 等关键环节，VodAppServer 以工程化的方式输出清晰的服务接口与流程示例，帮助团队在实际项目中更高效地落地 VOD 驱动的内容服务架构。

二、核心能力上线

1. 项目基础框架

• 基于 Spring Boot 构建整体项目结构，形成清晰的模块边界与可扩展的工程体系。

2. 播放列表管理

• 完成播放列表新增、查询、更新、删除全量能力。
• 提供业务增强接口，支持微短剧业务所需的灵活列表管理场景。

3. 播放鉴权（VidAuth）

• 集成基于 JWT 的本地签名能力，用于生成视频播放凭证。
• 完成播放鉴权链路适配，确保视频访问的安全性与有效控制。

4. 媒资处理能力

• 支持点播媒体处理流程调用。
• 实现转码任务（Transcode Job）提交能力，满足多清晰度、多格式等媒资处理需求。

三、文档与配套说明

• 完成项目所需的文档体系，包括 API 文档、集成说明、功能使用指引与进阶能力介绍。

感谢您关注我们的项目。如有任何问题或建议，欢迎随时与我们联系！