feat(ai): 新增 AI 操作净化层——越界截断、重叠平移、无效操作忽略 #4

Merged
xhgit merged 1 commits from feat/ai-op-sanitize into main 2026-11-14 11:23:59 +08:00
Owner

问题

AI 剪辑助手「经常报错」的主要原因:模型返回的方案里只要有一个片段数值越界(如 out 超素材时长)、引用不存在的素材、或视频轨重叠,整个方案就被 validateProject 拒绝并报错,重试一次再失败就只能放弃。

修改

新增 sanitizeOperations(p, operations),在严格校验之前对操作逐项净化:

  • add:越界数值自动截断(speed 0.25–4、volume 0–4、fade 0–10、亮度/对比/饱和、字号、色值);in/out 收进素材时长内;引用不存在或类型不符的素材时忽略该条操作
  • update:禁止修改 id / mediaId / track(提示并忽略);字段逐项截断;入点出点矛盾时忽略
  • remove:引用不存在的片段时忽略
  • 视频轨重叠自动右移:按起点排序,把后置片段平移到前一片段结束处,而不是整体报错
  • 返回 notes 数组记录所有自动修正,方案摘要会显示「已自动修正 N 处细节」

严格校验(applyOperations / validateProject)保持不变,净化后仍不合法的方案才会被拒绝并触发重试。

测试

新增用例:8 种脏操作(越界数值、错误轨道、幽灵引用、不支持的类型),断言截断结果、重叠平移结果(25s → 32.5s)、净化后的操作直接通过 applyOperations 校验。

合并顺序

依赖:#2 → #3(本 PR 为 #4)。

## 问题 AI 剪辑助手「经常报错」的主要原因:模型返回的方案里只要有一个片段数值越界(如 out 超素材时长)、引用不存在的素材、或视频轨重叠,整个方案就被 `validateProject` 拒绝并报错,重试一次再失败就只能放弃。 ## 修改 新增 `sanitizeOperations(p, operations)`,在严格校验之前对操作逐项净化: - **add**:越界数值自动截断(speed 0.25–4、volume 0–4、fade 0–10、亮度/对比/饱和、字号、色值);`in/out` 收进素材时长内;引用不存在或类型不符的素材时忽略该条操作 - **update**:禁止修改 id / mediaId / track(提示并忽略);字段逐项截断;入点出点矛盾时忽略 - **remove**:引用不存在的片段时忽略 - **视频轨重叠自动右移**:按起点排序,把后置片段平移到前一片段结束处,而不是整体报错 - 返回 `notes` 数组记录所有自动修正,方案摘要会显示「已自动修正 N 处细节」 严格校验(`applyOperations` / `validateProject`)保持不变,净化后仍不合法的方案才会被拒绝并触发重试。 ## 测试 新增用例:8 种脏操作(越界数值、错误轨道、幽灵引用、不支持的类型),断言截断结果、重叠平移结果(25s → 32.5s)、净化后的操作直接通过 `applyOperations` 校验。 ## 合并顺序 依赖:#2 → #3(本 PR 为 #4)。
xhgit added 1 commit 2026-11-14 11:21:15 +08:00
模型输出中个别小错误(数值越界、引用不存在的素材/片段、视频轨重叠)不再导致整个剪辑方案被校验拒绝:
- add:截断越界数值(speed/volume/fade/色值/字号等),引用不存在或类型不符的素材时忽略该操作
- update:禁止改 id/mediaId/track,字段逐项截断,入点出点矛盾时忽略
- remove:引用不存在片段时忽略
- 视频轨重叠自动右移后置片段,而不是整体报错
- 返回 notes 记录所有自动修正,供方案摘要展示
xhgit force-pushed feat/ai-op-sanitize from cb83b156ac to aa17701241 2026-11-14 11:21:15 +08:00 Compare
xhgit merged commit 8d83cee7c5 into main 2026-11-14 11:23:59 +08:00
xhgit deleted branch feat/ai-op-sanitize 2026-11-14 11:23:59 +08:00
Sign in to join this conversation.
No Reviewers
No labels
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: xhgit/AI-cut#4