xiaoxia/xiaoxia-saas
1
0
Fork 0
Code Issues 8 Pull Requests Actions Packages Projects Releases 7 Wiki Activity

feat: 封面管理 - 配置读写 + 片段抽帧 + 智能选帧 #396

Merged
xiaoxia merged 2 commits from feat/cover-management into develop 2026-07-17 10:00:19 +08:00
Conversation 1 Commits 2 Files Changed 4
+1152
xiaoxia commented 2026-07-16 11:12:30 +08:00
Owner
Copy Link
Copy Source

功能

剪辑计划封面管理完整后端能力：

API 接口

  • GET /api/v1/edit-plans/{plan_id}/cover — 获取封面配置
  • PUT /api/v1/edit-plans/{plan_id}/cover — 更新封面配置（类型/图片URL/时间点）
  • POST /api/v1/edit-plans/{plan_id}/cover/extract — 从指定片段时间点抽帧生成封面
  • POST /api/v1/edit-plans/{plan_id}/cover/smart — 智能选帧（自动找第一个视频片段）

核心实现

  • CoverService 封装 FFmpeg 抽帧 + OSS 上传
  • 支持 ai_frame / manual / upload 三种封面类型
  • 抽帧自动 scale+crop 到 1080x1920 标准封面尺寸
  • 失败降级：scale+crop 失败时退化为原始尺寸抽帧

测试

  • 19个单元测试全覆盖
  • 原有 28个 剪辑计划测试零回归
## 功能 剪辑计划封面管理完整后端能力： ### API 接口 - **GET** `/api/v1/edit-plans/{plan_id}/cover` — 获取封面配置 - **PUT** `/api/v1/edit-plans/{plan_id}/cover` — 更新封面配置（类型/图片URL/时间点） - **POST** `/api/v1/edit-plans/{plan_id}/cover/extract` — 从指定片段时间点抽帧生成封面 - **POST** `/api/v1/edit-plans/{plan_id}/cover/smart` — 智能选帧（自动找第一个视频片段） ### 核心实现 - `CoverService` 封装 FFmpeg 抽帧 + OSS 上传 - 支持 ai_frame / manual / upload 三种封面类型 - 抽帧自动 scale+crop 到 1080x1920 标准封面尺寸 - 失败降级：scale+crop 失败时退化为原始尺寸抽帧 ### 测试 - 19个单元测试全覆盖 - 原有 28个 剪辑计划测试零回归
xiaoxia force-pushed feat/cover-management from 516911adc3 to da327c9ac5 2026-07-16 13:48:32 +08:00 Compare
xiaoxia force-pushed feat/cover-management from 89c427283c to 6f32f25159 2026-07-17 01:15:48 +08:00 Compare
xiaoxia force-pushed feat/cover-management from 6f32f25159 to 4c62dfaa76 2026-07-17 07:48:03 +08:00 Compare
xiaoxia added 1 commit 2026-07-17 09:25:20 +08:00
feat: 封面管理 - 配置读写 + 片段抽帧 + 智能选帧 508e622dbb 
- GET /{plan_id}/cover 获取封面配置
- PUT /{plan_id}/cover 更新封面配置（类型/图片URL/时间点）
- POST /{plan_id}/cover/extract 从指定片段时间点抽帧生成封面
- POST /{plan_id}/cover/smart 智能选帧（自动找第一个视频片段）
- CoverService 封装 FFmpeg 抽帧 + OSS 上传
- 19个单元测试全覆盖
xiaoxia force-pushed feat/cover-management from 4c62dfaa76 to a03b4b3231 2026-07-17 09:25:20 +08:00 Compare
xiaoxia added 1 commit 2026-07-17 09:36:31 +08:00
style: auto-format with black + isort
CI Build & Deploy Pipeline / Build Staging API Image (pull_request) Has been skipped
Details
CI Build & Deploy Pipeline / Build Staging Web Image (pull_request) Has been skipped
Details
CI Build & Deploy Pipeline / Build Staging Worker Image (pull_request) Has been skipped
Details
CI Build & Deploy Pipeline / Deploy Staging (Watchtower auto-deploy) (pull_request) Has been skipped
Details
CI Build & Deploy Pipeline / Build Production Web Image (pull_request) Has been skipped
Details
CI Build & Deploy Pipeline / Build Production API Image (pull_request) Has been skipped
Details
CI Build & Deploy Pipeline / Staging E2E Tests (pull_request) Has been skipped
Details
CI Build & Deploy Pipeline / Staging API Integration Tests (pull_request) Has been skipped
Details
CI Build & Deploy Pipeline / Build Production Worker Image (pull_request) Has been skipped
Details
CI Build & Deploy Pipeline / Deploy Production (pull_request) Has been skipped
Details
CI Build & Deploy Pipeline / Production Browser E2E (pull_request) Has been skipped
Details
CI/CD Pipeline / Check if frontend-only change (pull_request) Successful in 18s
Details
CI/CD Pipeline / Frontend Lint (pull_request) Successful in 51s
Details
AI Code Review / AI Code Review (pull_request) Successful in 2m2s
Details
CI/CD Pipeline / Validate Code Quality And Tests (pull_request) Successful in 2m35s
Details
CI/CD Pipeline / Unit Tests (pull_request) Successful in 2m46s
Details
CI/CD Pipeline / Integration Tests (pull_request) Successful in 1m57s
Details
33983eb76e
xiaoxia force-pushed feat/cover-management from a03b4b3231 to 33983eb76e 2026-07-17 09:36:31 +08:00 Compare
auto-approve-bot approved these changes 2026-07-17 09:44:56 +08:00
auto-approve-bot left a comment
Collaborator
Copy Link
Copy Source

CI全绿，自动审批通过。

CI全绿，自动审批通过。
xiaoxia merged commit a1f9557dc5 into develop 2026-07-17 10:00:19 +08:00
xiaoxia deleted branch feat/cover-management 2026-07-17 10:00:19 +08:00
Sign in to join this conversation.
Reviewers
No Reviewers
auto-approve-bot
Labels
Clear labels
P0
阻塞性，必须立即处理
 P1
高优先级
 P2
中优先级
 P3
低优先级/后考虑
 architecture
架构设计
 backend
后端相关
 blocked
阻塞中
 bug
Bug修复
 ci-bug
CI本身的bug
 ci-optimization
CI优化类任务
 ci-pipeline
CI流水线/workflow相关
 cleanup
代码清理
 devops
运维/部署/CI
 documentation
文档相关
 feature
新功能
 frontend
前端相关
 question
需要讨论确认
 ready
PR CI通过，可合并
 refactor
代码重构
No Label
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
auto-approve-bot xiaoxia
No Assignees
2 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: xiaoxia/xiaoxia-saas#396
Delete Branch "feat/cover-management"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?