xiaoxia/xiaoxia-saas
1
0
Fork 0
Code Issues 10 Pull Requests 2 Actions Packages Projects Releases 7 Wiki Activity

refactor: 步骤顺序调整 - 标题(4)→预览(5) + 预览接口增加标题参数 #1377

Merged
auto-approve-bot merged 1 commits from refactor/swap-title-preview-step-order into develop 2026-08-15 16:51:09 +08:00
Conversation 4 Commits 1 Files Changed 11
+106 -77
xiaoxia commented 2026-08-15 16:41:58 +08:00
Owner
Copy Link
Copy Source

改动概述

将智能剪辑流程中的「标题」和「预览」步骤互换顺序，让标题在预览之前设置，这样预览视频可以包含标题（后端通过 ASS 烧录）。

新步骤顺序

模板(1) → 素材(2) → 配音(3) → 标题(4) → 预览(5) → 封面(6) → 确认(7)

前端改动

  • constants.ts: STEPS 定义中 Step4/Step5 标签互换
  • GenerateStepContent.tsx: case 4 渲染 Step4TitleSettings，case 5 渲染 Step5GeneratePreview
  • useStepNavigation.ts: Step4 校验 title 非空，Step5 校验 previewReady
  • useStep4Preview.ts → useStep5Preview.ts: 重命名 + 新增 titleSettings prop，createPreview 调用增加 8 个标题字段
  • Step4GeneratePreview.tsx → Step5GeneratePreview.tsx: 重命名
  • GeneratePage.tsx: 预览面板改为 Step5+ 显示，结果面板改为 Step6+ 显示
  • PreviewVideoPanel.tsx: Canvas 标题叠加层保留（后续可简化）
  • api/generation/types.ts: CreatePreviewRequest 新增 title_text/title_font/title_size/title_color/title_position/title_bold/title_stroke/title_shadow

配套后端

后端需在 preview API 中接收标题参数并通过 ASS 烧录到预览视频中

测试文件

  • smoke.test.tsx 和 step5-preview.smoke.test.tsx 同步更新引用
## 改动概述 将智能剪辑流程中的「标题」和「预览」步骤互换顺序，让标题在预览之前设置，这样预览视频可以包含标题（后端通过 ASS 烧录）。 ### 新步骤顺序 模板(1) → 素材(2) → 配音(3) → **标题(4)** → **预览(5)** → 封面(6) → 确认(7) ### 前端改动 - **constants.ts**: STEPS 定义中 Step4/Step5 标签互换 - **GenerateStepContent.tsx**: case 4 渲染 Step4TitleSettings，case 5 渲染 Step5GeneratePreview - **useStepNavigation.ts**: Step4 校验 title 非空，Step5 校验 previewReady - **useStep4Preview.ts → useStep5Preview.ts**: 重命名 + 新增 `titleSettings` prop，createPreview 调用增加 8 个标题字段 - **Step4GeneratePreview.tsx → Step5GeneratePreview.tsx**: 重命名 - **GeneratePage.tsx**: 预览面板改为 Step5+ 显示，结果面板改为 Step6+ 显示 - **PreviewVideoPanel.tsx**: Canvas 标题叠加层保留（后续可简化） - **api/generation/types.ts**: CreatePreviewRequest 新增 title_text/title_font/title_size/title_color/title_position/title_bold/title_stroke/title_shadow ### 配套后端 后端需在 preview API 中接收标题参数并通过 ASS 烧录到预览视频中 ### 测试文件 - smoke.test.tsx 和 step5-preview.smoke.test.tsx 同步更新引用
xiaoxia added the feature label 2026-08-15 16:41:58 +08:00
xiaoxia added 1 commit 2026-08-15 16:41:58 +08:00
refactor: 步骤顺序调整 - 标题(4) → 预览(5)
CI/CD Pipeline / Build Staging Web Image (pull_request) Has been skipped
Details
CI/CD Pipeline / Build Staging Worker Image (pull_request) Has been skipped
Details
CI/CD Pipeline / Build Staging API Image (pull_request) Has been skipped
Details
CI/CD Pipeline / Deploy Staging (Watchtower auto-deploy) (pull_request) Has been skipped
Details
CI/CD Pipeline / Staging E2E Tests (pull_request) Has been skipped
Details
CI/CD Pipeline / Staging API Integration Tests (pull_request) Has been skipped
Details
CI/CD Pipeline / ACR Image Cleanup (pull_request) Has been skipped
Details
CI/CD Pipeline / Check if frontend-only change (pull_request) Successful in 27s
Details
CI/CD Pipeline / Unit Tests (pull_request) Has been skipped
Details
CI/CD Pipeline / Validate - Migration (alembic) (pull_request) Successful in 1m18s
Details
CI/CD Pipeline / PR Build API Image (pull_request) Has been skipped
Details
CI/CD Pipeline / Frontend Unit Tests (pull_request) Successful in 49s
Details
CI/CD Pipeline / PR Build Worker Image (pull_request) Has been skipped
Details
Preview Deploy / Deploy Preview Environment (pull_request) Successful in 1m22s
Details
CI/CD Pipeline / Validate - Type Check (mypy) (pull_request) Successful in 1m28s
Details
CI/CD Pipeline / Frontend Lint (pull_request) Successful in 1m6s
Details
PR Automation / Auto Approve on CI Green (pull_request) Successful in 1m35s
Details
PR Automation / Auto Merge on CI Green + Approved (pull_request) Successful in 1m45s
Details
CI/CD Pipeline / PR Build Web Image (pull_request) Successful in 1m17s
Details
CI/CD Pipeline / Validate - Code Quality (pull_request) Successful in 3m59s
Details
CI/CD Pipeline / Integration Tests (pull_request) Has been skipped
Details
CI/CD Pipeline / Build Production API Image (pull_request) Has been skipped
Details
CI/CD Pipeline / Build Production Web Image (pull_request) Has been skipped
Details
CI/CD Pipeline / Build Production Worker Image (pull_request) Has been skipped
Details
CI/CD Pipeline / Deploy Production (pull_request) Has been skipped
Details
CI/CD Pipeline / Canary Release to Production (pull_request) Has been skipped
Details
CI/CD Pipeline / Production Browser E2E (pull_request) Has been skipped
Details
CI/CD Pipeline / CI Gate (pull_request) Successful in 7s
Details
AI Code Review / AI Code Review (pull_request) Successful in 6m52s
Details
Preview Cleanup / Cleanup Preview Environment (pull_request) Successful in 45s
Details
ACR Cleanup / ACR Image Cleanup (pull_request_target) Successful in 51s
Details
0bcacde296 
- constants.ts: 步骤定义从 模板→素材→配音→预览→标题→封面→确认
  改为 模板→素材→配音→标题→预览→封面→确认
- GenerateStepContent.tsx: case 4 渲染 Step4TitleSettings，case 5 渲染 Step5GeneratePreview
- useStepNavigation.ts: 标题步骤(4)校验 title，预览步骤(5)校验 previewReady
- useStep4Preview.ts → useStep5Preview.ts: 新增 titleSettings prop，
  createPreview 调用增加标题字段
- Step4GeneratePreview.tsx → Step5GeneratePreview.tsx: 重命名
- api/generation/types.ts: CreatePreviewRequest 新增标题烧录参数
- GeneratePage.tsx: 预览面板 Step5+ 显示，结果面板 Step6+ 显示
- PreviewVideoPanel.tsx: Canvas 标题叠加保留
- 测试文件同步更新引用
gitea-actions bot commented 2026-08-15 16:43:23 +08:00
Copy Link
Copy Source

🚀 预览环境已部署

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

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

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

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

🚀 **预览环境已部署** | 项目 | 详情 | |------|------| | PR号 | #1377 | | 预览链接 | [https://pr-1377.preview.xiaoxiajianji.com](https://pr-1377.preview.xiaoxiajianji.com) | | API环境 | staging | > 💡 预览环境使用 staging API 数据，请勿在预览环境中操作重要数据。 > > 🔄 每次提交新代码后预览环境会自动更新。 > > 🗑️ PR 关闭或合并后，预览环境会自动清理。
auto-approve-bot approved these changes 2026-08-15 16:43:34 +08:00
auto-approve-bot left a comment
Collaborator
Copy Link
Copy Source

CI全绿，自动审批通过。

CI全绿，自动审批通过。
auto-approve-bot approved these changes 2026-08-15 16:43:34 +08:00
auto-approve-bot left a comment
Collaborator
Copy Link
Copy Source

CI全绿，自动审批通过。

CI全绿，自动审批通过。
auto-approve-bot merged commit 04330d2e9d into develop 2026-08-15 16:51:09 +08:00
auto-approve-bot deleted branch refactor/swap-title-preview-step-order 2026-08-15 16:51:09 +08:00
gitea-actions bot commented 2026-08-15 16:51:57 +08:00
Copy Link
Copy Source

🗑️ 预览环境已清理

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

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

🗑️ **预览环境已清理** PR #1377 已关闭或合并，对应的预览环境已被清理。 > 如有需要，可以重新打开 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 feature
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
auto-approve-bot xiaoxia
No Assignees
3 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: xiaoxia/xiaoxia-saas#1377
Delete Branch "refactor/swap-title-preview-step-order"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?