docs: 四种视频剪辑模式技术设计方案 (Issue #22) #101

2026-06-29T10:56:28+08:00

xiaoxia commented

2026-06-29 10:56:28 +08:00

概述

Issue #22 的技术方案设计文档，定义 4 种降重剪辑模式。

变更内容

新增 docs/video-editing-modes-design.md 技术设计文档
设计 4 种降重模式：minimal / standard / creative / batch_variant
基于 6 种降重技术（素材随机排列、画面翻转、随机变速、随机裁剪、滤镜色调、转场效果）的不同组合
包含数据模型、API、Worker 实现方案
与现有 EditingMode 正交，向后兼容

四种模式

模式	降重强度	技术组合
极简模式	★☆☆	仅随机排列
标准模式	★★☆	排列 + 转场
创意模式	★★★	全技术叠加
批量变体模式	★★☆	排列+翻转+变速+滤镜

注意

本 PR 仅包含设计文档，不含实现代码。 方案经审查后再进入开发阶段。

## 概述 Issue #22 的技术方案设计文档，定义 4 种降重剪辑模式。 ## 变更内容 - 新增 `docs/video-editing-modes-design.md` 技术设计文档 - 设计 4 种降重模式：minimal / standard / creative / batch_variant - 基于 6 种降重技术（素材随机排列、画面翻转、随机变速、随机裁剪、滤镜色调、转场效果）的不同组合 - 包含数据模型、API、Worker 实现方案 - 与现有 EditingMode 正交，向后兼容 ## 四种模式 | 模式 | 降重强度 | 技术组合 | |------|----------|----------| | 极简模式 | ★☆☆ | 仅随机排列 | | 标准模式 | ★★☆ | 排列 + 转场 | | 创意模式 | ★★★ | 全技术叠加 | | 批量变体模式 | ★★☆ | 排列+翻转+变速+滤镜 | ## 注意 **本 PR 仅包含设计文档，不含实现代码。** 方案经审查后再进入开发阶段。

xiaoxia added 1 commit 2026-06-29 10:56:28 +08:00

docs: 四种视频剪辑模式技术设计方案 (Issue #22 )

CI/CD Pipeline / Validate Code Quality And Tests (pull_request) Has been cancelled

Details

CI/CD Pipeline / Frontend Lint (pull_request) Has been cancelled

Details

5ea9bfbddb

- 设计 4 种降重剪辑模式: minimal/standard/creative/batch_variant
- 基于 6 种降重技术的不同组合策略
- 包含数据模型、API、Worker 实现方案
- 与现有 EditingMode 正交，向后兼容
- 纯设计文档，不含实现代码

xiaoxia commented

2026-06-29 11:10:51 +08:00

代码审查结果 — PR #101 ❌ 不通过（需求偏差，需重写）

审查范围: 1 文件，+639（docs/video-editing-modes-design.md）

核心问题：设计方向与用户需求不匹配

本方案基于"降重手段组合"的理解设计了 4 种 DeduplicationMode（极简/标准/创意/批量变体），但用户已重新定义了四种剪辑模式：

用户定义的模式	说明	系统中已有的 EditingMode
画中画模式	多场景素材混合剪辑（非小窗口）	`pip`
人物口播模式	纯人物口播视频，不加画面素材切换	`voice_over`
一镜到底模式	连续不间断的单一镜头	`one_take`
人物口播+画中画模式	人物口播 + 场景素材穿插混剪	`voice_pip`

关键发现: 系统已有 one_take/pip/voice_over/voice_pip 四种 EditingMode，与用户描述的四种模式完全对应。本方案提出的 DeduplicationMode 是与之正交的另一个维度，虽然技术方案本身写得不错（FFmpeg 滤镜链、种子机制等都合理），但不是用户当前需要的东西。

P0（阻塞问题）

需求理解偏差: 用户要的是"四种剪辑模式"的 UI + 实现方案（类剪映操作界面），而非降重技术组合。方案需基于用户的真实需求重写
查重规则与模式关联: 用户明确要求"不同模式有不同的查重规则"，本方案未涉及

结论

❌ 不通过。 建议：

本方案作为"降重技术手段"的参考资料保留（FFmpeg 滤镜池、种子机制等设计可复用到后续实现）
基于用户新定义的四模式重新设计方案，重点：
- 复用现有 EditingMode 枚举
- 设计类剪映的剪辑计划配置 UI
- 每种模式配套不同的查重规则
- 支持用户自定义剪辑计划

## 代码审查结果 — PR #101 ❌ 不通过（需求偏差，需重写） **审查范围**: 1 文件，+639（docs/video-editing-modes-design.md） ### 核心问题：设计方向与用户需求不匹配本方案基于"降重手段组合"的理解设计了 4 种 DeduplicationMode（极简/标准/创意/批量变体），但用户已重新定义了四种剪辑模式： | 用户定义的模式 | 说明 | 系统中已有的 EditingMode | |---|---|---| | **画中画模式** | 多场景素材混合剪辑（非小窗口） | `pip` | | **人物口播模式** | 纯人物口播视频，不加画面素材切换 | `voice_over` | | **一镜到底模式** | 连续不间断的单一镜头 | `one_take` | | **人物口播+画中画模式** | 人物口播 + 场景素材穿插混剪 | `voice_pip` | **关键发现**: 系统已有 `one_take`/`pip`/`voice_over`/`voice_pip` 四种 EditingMode，与用户描述的四种模式**完全对应**。本方案提出的 DeduplicationMode 是与之正交的另一个维度，虽然技术方案本身写得不错（FFmpeg 滤镜链、种子机制等都合理），但**不是用户当前需要的东西**。 ### P0（阻塞问题） 1. **需求理解偏差**: 用户要的是"四种剪辑模式"的 UI + 实现方案（类剪映操作界面），而非降重技术组合。方案需基于用户的真实需求重写 2. **查重规则与模式关联**: 用户明确要求"不同模式有不同的查重规则"，本方案未涉及 ### 结论 ❌ **不通过。** 建议： 1. 本方案作为"降重技术手段"的参考资料保留（FFmpeg 滤镜池、种子机制等设计可复用到后续实现） 2. 基于用户新定义的四模式重新设计方案，重点： - 复用现有 EditingMode 枚举 - 设计类剪映的剪辑计划配置 UI - 每种模式配套不同的查重规则 - 支持用户自定义剪辑计划

xiaoxia commented

2026-06-29 12:31:42 +08:00

关闭说明：本方案基于旧需求（降重手段组合）设计，用户已重新定义四种剪辑模式（画中画/人物口播/一镜到底/人物口播+画中画），系统已有对应 EditingMode。需基于新需求重新设计方案。FFmpeg 滤镜池等设计可作为后续参考。

xiaoxia closed this pull request

2026-06-29 12:31:42 +08:00

CI/CD Pipeline / Validate Code Quality And Tests (pull_request) Has been cancelled

Details

CI/CD Pipeline / Frontend Lint (pull_request) Has been cancelled

Details

Pull request closed

Please reopen this pull request to perform a merge.

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: xiaoxia/xiaoxia-saas#101