feat(editor): 接入MediaKit智能选片，基于视频内容分析推荐最佳片段起始时间 #1523

Merged

xiaoxia merged 2 commits from feat/mediakit-smart-clip-selection into develop 2026-08-27 16:25:09 +08:00

Conversation 4 Commits 2 Files Changed 2

+654 -2

xiaoxia commented 2026-08-27 15:53:21 +08:00

Owner

Copy Link

Copy Source

改动

在 create_clips_from_assets_editor 中接入 MediaKit 视频理解，智能推荐片段起始时间。

修改文件

1. apps/api/app/api/routes/templates_editor/clips.py
   • 新增 _get_mediakit_recommendations：调用 MediaKit analyze_videos 分析视频内容，返回每个素材的推荐起始时间
   • 新增 _recommended_time_conflicts：检查推荐时间与已使用时间段是否冲突
   • create_clips_from_assets_editor 优先使用 MediaKit 推荐时间，冲突/越界时降级为 _calc_random_start_time
2. tests/unit/test_mediakit_smart_clips.py（新增）
   • TestRecommendedTimeConflicts（8 个用例）：冲突检测逻辑
   • TestGetMediakitRecommendations（7 个用例）：解析与降级
   • TestMediakitIntegrationInFromAssets（5 个用例）：端点集成测试

降级策略

场景	行为
MediaKit 未配置	返回空字典 → 纯随机
MediaKit 超时/失败	返回空字典 → 纯随机
返回内容无法解析	返回空字典 → 纯随机
推荐时间与已用片段冲突	该素材降级为随机
推荐时间超出素材时长	该素材降级为随机

测试

• 21 个新测试全部通过
• 15 个已有相关测试无回归

## 改动 在 `create_clips_from_assets_editor` 中接入 MediaKit 视频理解，智能推荐片段起始时间。 ### 修改文件 1. `apps/api/app/api/routes/templates_editor/clips.py` - 新增 `_get_mediakit_recommendations`：调用 MediaKit `analyze_videos` 分析视频内容，返回每个素材的推荐起始时间 - 新增 `_recommended_time_conflicts`：检查推荐时间与已使用时间段是否冲突 - `create_clips_from_assets_editor` 优先使用 MediaKit 推荐时间，冲突/越界时降级为 `_calc_random_start_time` 2. `tests/unit/test_mediakit_smart_clips.py`（新增） - `TestRecommendedTimeConflicts`（8 个用例）：冲突检测逻辑 - `TestGetMediakitRecommendations`（7 个用例）：解析与降级 - `TestMediakitIntegrationInFromAssets`（5 个用例）：端点集成测试 ### 降级策略 | 场景 | 行为 | |------|------| | MediaKit 未配置 | 返回空字典 → 纯随机 | | MediaKit 超时/失败 | 返回空字典 → 纯随机 | | 返回内容无法解析 | 返回空字典 → 纯随机 | | 推荐时间与已用片段冲突 | 该素材降级为随机 | | 推荐时间超出素材时长 | 该素材降级为随机 | ### 测试 - 21 个新测试全部通过 - 15 个已有相关测试无回归

xiaoxia added 1 commit 2026-08-27 15:53:21 +08:00

feat(editor): 接入MediaKit智能选片，基于视频内容分析推荐最佳片段起始时间 ... d5032108b5

- 新增 _get_mediakit_recommendations 调用 MediaKit 视频理解分析素材
- 新增 _recommended_time_conflicts 检查推荐时间与已用时间段的冲突
- from-assets 端点优先使用 MediaKit 推荐时间，冲突时降级为随机
- 多层降级策略：MediaKit不可用/超时/解析失败/冲突 → 纯随机
- 非视频素材自动跳过，不发送给 MediaKit
- 新增 21 个单测覆盖冲突检测、解析逻辑、集成降级场景

gitea-actions bot commented 2026-08-27 16:01:20 +08:00

Copy Link

Copy Source

🚀 预览环境已部署

项目	详情
PR号	#1523
预览链接	https://pr-1523.preview.xiaoxiajianji.com
API环境	staging

💡 预览环境使用 staging API 数据，请勿在预览环境中操作重要数据。

🔄 每次提交新代码后预览环境会自动更新。

🗑️ PR 关闭或合并后，预览环境会自动清理。

🚀 **预览环境已部署** | 项目 | 详情 | |------|------| | PR号 | #1523 | | 预览链接 | [https://pr-1523.preview.xiaoxiajianji.com](https://pr-1523.preview.xiaoxiajianji.com) | | API环境 | staging | > 💡 预览环境使用 staging API 数据，请勿在预览环境中操作重要数据。 > > 🔄 每次提交新代码后预览环境会自动更新。 > > 🗑️ PR 关闭或合并后，预览环境会自动清理。

auto-approve-bot added 1 commit 2026-08-27 16:03:29 +08:00

style: auto-format with black + isort + prettier [skip ci-format-check] 6d225a89b4

auto-approve-bot approved these changes 2026-08-27 16:18:16 +08:00

auto-approve-bot left a comment

Collaborator

Copy Link

Copy Source

CI全绿，自动审批通过。

CI全绿，自动审批通过。

auto-approve-bot approved these changes 2026-08-27 16:18:16 +08:00

auto-approve-bot left a comment

Collaborator

Copy Link

Copy Source

CI全绿，自动审批通过。

CI全绿，自动审批通过。

xiaoxia merged commit 0c216bc545 into develop 2026-08-27 16:25:09 +08:00

gitea-actions bot commented 2026-08-27 16:29:39 +08:00

Copy Link

Copy Source

🗑️ 预览环境已清理

PR #1523 已关闭或合并，对应的预览环境已被清理。

如有需要，可以重新打开 PR 来重新生成预览环境。

🗑️ **预览环境已清理** PR #1523 已关闭或合并，对应的预览环境已被清理。 > 如有需要，可以重新打开 PR 来重新生成预览环境。

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

3 Participants

Notifications

Subscribe

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: xiaoxia/xiaoxia-saas#1523