feat: 正式生成时片段随机重排（降重，默认开启无开关）#1663 #1668

Merged

xiaoxia merged 1 commits from feat/segment-random-shuffle-1663 into develop 2026-09-03 20:17:06 +08:00

Conversation 3 Commits 1 Files Changed 2

+164

xiaoxia commented 2026-09-03 20:01:41 +08:00

Owner

Copy Link

Copy Source

改动

在 _distribute_assets 方法中，smart_match 评分排序完成后、distribute_assets 之前，对 asset_ids 做 random.shuffle。

行为

• smart_match 评分排序保留 — 它决定选哪些素材（高分优先）
• shuffle 只改变分配到 clips 的顺序 — 同一批素材每次生成时分配到各 clip 的顺序不同
• 场景切换点缓存不受影响 — _fetch_asset_scene_points 在 shuffle 之前调用
• 不修改调用方原列表 — 先 list() 复制再 shuffle
• 无功能开关 — 默认始终生效

改动范围

• apps/api/app/services/plan_generator_service.py（+5 行）
• tests/unit/test_plan_generator.py（+3 个测试用例）

单测

• test_formal_generation_shuffles_asset_ids — 验证 10 次调用产生至少 2 种不同顺序
• test_formal_generation_does_not_mutate_original_list — 验证原始列表不被修改
• test_preview_random_mode_unaffected_by_shuffle — 验证预览模式不受影响

Closes #1663

## 改动 在 `_distribute_assets` 方法中，smart_match 评分排序完成后、`distribute_assets` 之前，对 `asset_ids` 做 `random.shuffle`。 ### 行为 - **smart_match 评分排序保留** — 它决定选哪些素材（高分优先） - **shuffle 只改变分配到 clips 的顺序** — 同一批素材每次生成时分配到各 clip 的顺序不同 - **场景切换点缓存不受影响** — `_fetch_asset_scene_points` 在 shuffle 之前调用 - **不修改调用方原列表** — 先 `list()` 复制再 shuffle - **无功能开关** — 默认始终生效 ### 改动范围 - `apps/api/app/services/plan_generator_service.py`（+5 行） - `tests/unit/test_plan_generator.py`（+3 个测试用例） ### 单测 - `test_formal_generation_shuffles_asset_ids` — 验证 10 次调用产生至少 2 种不同顺序 - `test_formal_generation_does_not_mutate_original_list` — 验证原始列表不被修改 - `test_preview_random_mode_unaffected_by_shuffle` — 验证预览模式不受影响 Closes #1663

xiaoxia added 1 commit 2026-09-03 20:01:41 +08:00

feat: 正式生成时片段随机重排（降重，默认开启无开关）#1663 ... 229f9dddeb

在 _distribute_assets 方法中，smart_match 评分排序完成后、
distribute_assets 之前，对 asset_ids 做 random.shuffle。

- smart_match 决定选哪些素材（评分排序保留）
- shuffle 只改变最终分配到 clips 的顺序
- scene_points 缓存不受影响（shuffle 之前已读取）
- asset_ids 先 list() 复制再 shuffle，不修改调用方原列表
- 新增 3 个单元测试验证 shuffle 行为

Closes #1663

gitea-actions bot commented 2026-09-03 20:04:33 +08:00

Copy Link

Copy Source

🚀 预览环境已部署

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

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

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

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

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

auto-approve-bot commented 2026-09-03 20:08:18 +08:00

Collaborator

Copy Link

Copy Source

【阻塞级判定】

• 是否存在阻塞级问题：否
• 阻塞级问题数量：0 个

📊 审查概览

• 整体评价：通过
• 建议级问题数量：0 个

🔴 阻塞级问题（必须修复）

无

💡 改进建议（不阻塞合并）

无

✅ 良好实践

1. 副作用控制：在 plan_generator_service.py 第 237 行，使用 asset_ids = list(asset_ids) 创建副本后再进行 shuffle，有效避免了修改调用方传入的原始列表，防止了潜在的副作用，这是一个很好的防御性编程实践。
2. 测试覆盖全面：新增的单元测试 TestFormalGenerationShuffle 覆盖了核心功能（随机打乱）、边界保护（不修改原列表）以及不同模式下的行为差异（预览模式不受影响），测试逻辑严谨且概率断言合理（10次取2种不同顺序，置信度极高）。
3. 代码逻辑清晰：通过 if not random_selection 条件精准控制了 shuffle 的执行时机，仅影响正式生成路径，符合需求描述。

---

✅ 格式检查通过 | ✅ 逻辑审查通过 | ✅ 性能良好

---

_{🤖 由 AI 代码审查机器人自动生成 | 2026-09-03 12:08:18 | 模型:}

### 【阻塞级判定】 - 是否存在阻塞级问题：否 - 阻塞级问题数量：0 个 ### 📊 审查概览 - 整体评价：通过 - 建议级问题数量：0 个 ### 🔴 阻塞级问题（必须修复） 无 ### 💡 改进建议（不阻塞合并） 无 ### ✅ 良好实践 1. **副作用控制**：在 `plan_generator_service.py` 第 237 行，使用 `asset_ids = list(asset_ids)` 创建副本后再进行 `shuffle`，有效避免了修改调用方传入的原始列表，防止了潜在的副作用，这是一个很好的防御性编程实践。 2. **测试覆盖全面**：新增的单元测试 `TestFormalGenerationShuffle` 覆盖了核心功能（随机打乱）、边界保护（不修改原列表）以及不同模式下的行为差异（预览模式不受影响），测试逻辑严谨且概率断言合理（10次取2种不同顺序，置信度极高）。 3. **代码逻辑清晰**：通过 `if not random_selection` 条件精准控制了 shuffle 的执行时机，仅影响正式生成路径，符合需求描述。 --- ✅ 格式检查通过 | ✅ 逻辑审查通过 | ✅ 性能良好 --- _{🤖 由 AI 代码审查机器人自动生成 | 2026-09-03 12:08:18 | 模型:} <!-- AI_CODE_REVIEW_AUTO_COMMENT -->

xiaoxia merged commit aac8cc5fd7 into develop 2026-09-03 20:17:06 +08:00

gitea-actions bot commented 2026-09-03 20:18:43 +08:00

Copy Link

Copy Source

🗑️ 预览环境已清理

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

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

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

xiaoxia referenced this pull request 2026-09-04 23:31:28 +08:00

Release: 同步 develop 到 main（PR #1654~#1698 全量同步） #1699

Sign in to join this conversation.

Reviewers

No Reviewers

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#1668