fix: _download_video_assets 允许仅传 asset_ids（模板预览模式） #1213

Merged

xiaoxia merged 2 commits from fix/download-assets-allow-asset-ids-only into develop 2026-08-01 21:59:20 +08:00

Conversation 3 Commits 2 Files Changed 1

+8 -4

xiaoxia commented 2026-08-01 21:46:23 +08:00

Owner

Copy Link

Copy Source

问题

预览生成（#1197）是模板模式，只传 template_id + asset_ids，不传 project_id/asset_library_id。Worker 执行 _download_video_assets 时被过早的校验挡住：

ValueError: asset_library_id 和 project_id 至少需要提供一个

修复

• 校验条件从 (not library and not project) 改为 (not library and not project and not asset_ids)
• mode_desc 兜底：三者都空时显示"指定素材"而非"项目 None"
• 向后兼容：原有传 project_id 或 asset_library_id 的路径不受影响

测试

• 87 个相关单元测试全绿

## 问题 预览生成（#1197）是模板模式，只传 template_id + asset_ids，不传 project_id/asset_library_id。Worker 执行 `_download_video_assets` 时被过早的校验挡住： ``` ValueError: asset_library_id 和 project_id 至少需要提供一个 ``` ## 修复 - 校验条件从 `(not library and not project)` 改为 `(not library and not project and not asset_ids)` - `mode_desc` 兜底：三者都空时显示"指定素材"而非"项目 None" - 向后兼容：原有传 project_id 或 asset_library_id 的路径不受影响 ## 测试 - 87 个相关单元测试全绿

xiaoxia added 1 commit 2026-08-01 21:46:23 +08:00

fix: _download_video_assets 允许仅传 asset_ids（模板预览模式） ... 34b6f4b205

预览生成（#1197）是模板模式，只传 template_id + asset_ids，
不传 project_id/asset_library_id。asset_ids 已有明确素材ID列表，
下游查询也支持直接按ID查，但被这个校验挡住了。

改动：
- 校验条件从 (not library and not project) 改为 (not library and not project and not asset_ids)
- mode_desc 兜底：三者都空时显示"指定素材"而非"项目 None"
- 向后兼容：原有传 project_id 或 asset_library_id 的路径不受影响

gitea-actions bot commented 2026-08-01 21:47:45 +08:00

Copy Link

Copy Source

🚀 预览环境已部署

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

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

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

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

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

auto-approve-bot added 1 commit 2026-08-01 21:50:36 +08:00

style: auto-format with black + isort + prettier [skip ci-format-check] 67530da9bb

auto-approve-bot commented 2026-08-01 21:52:59 +08:00

Collaborator

Copy Link

Copy Source

【阻塞级判定】

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

📊 审查概览

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

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

无

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

无

✅ 良好实践

1. 逻辑校验完善：新增对 asset_ids 参数的判空校验，确保了在通过 ID 列表下载素材时的参数合法性，逻辑严密。
2. 文档同步更新：及时更新了函数文档字符串中的 Raises 描述，保持代码与文档的一致性。
3. 错误信息清晰：优化了 mode_desc 的生成逻辑，使得在三种不同的下载模式下（素材库、项目、指定素材），错误日志都能准确反映当前上下文，便于排查问题。

---

_{🤖 由 AI 代码审查机器人自动生成 | 2026-08-01 13:52:59 | 模型:}

### 【阻塞级判定】 - 是否存在阻塞级问题：否 - 阻塞级问题数量：0 个 ### 📊 审查概览 - 整体评价：通过 - 建议级问题数量：0 个 ### 🔴 阻塞级问题（必须修复） 无 ### 💡 改进建议（不阻塞合并） 无 ### ✅ 良好实践 1. **逻辑校验完善**：新增对 `asset_ids` 参数的判空校验，确保了在通过 ID 列表下载素材时的参数合法性，逻辑严密。 2. **文档同步更新**：及时更新了函数文档字符串中的 `Raises` 描述，保持代码与文档的一致性。 3. **错误信息清晰**：优化了 `mode_desc` 的生成逻辑，使得在三种不同的下载模式下（素材库、项目、指定素材），错误日志都能准确反映当前上下文，便于排查问题。 --- _{🤖 由 AI 代码审查机器人自动生成 | 2026-08-01 13:52:59 | 模型:} <!-- AI_CODE_REVIEW_AUTO_COMMENT -->

xiaoxia merged commit 4bbc71d9d1 into develop 2026-08-01 21:59:20 +08:00

gitea-actions bot commented 2026-08-01 22:01:31 +08:00

Copy Link

Copy Source

🗑️ 预览环境已清理

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

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

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

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