v0.2.0 发布说明

v0.2.0 是面向生产可用性的一次关键版本更新。 该版本重点解决长耗时任务可观测性、分镜流程职责边界与前后端契约一致性问题。

Highlights

• 新增全局 Task Center，统一查看异步任务状态、进度、取消与回跳入口。
• 长耗时流程迁移至异步执行模型，补齐任务注册、执行与运行日志链路。
• 分镜页面职责进一步收口：编辑页负责准备，工作室负责生成。
• shot.status 与运行时任务状态解耦，状态语义更清晰。
• OpenAPI 契约与前端 generated client 全量同步更新。

Added

• 任务中心（Task Center）
  • 提供任务生命周期统一视图（queued/running/success/failed/cancelled）与取消、回跳入口。
• 异步任务基础设施
  • 新增后端任务执行/注册能力、运行时日志与取消支持。
• 分镜准备态能力
  • 新增提取候选流转、准备态/运行态聚合信息、视频提示词打包与视频准备度检查。

Changed

• ChapterShotEditPage 收敛为提取/确认/修正主入口，ChapterStudio 聚焦生成准备与生成执行。
• shot.status 仅表达信息确认状态（pending/ready），运行态由任务系统与 runtime summary 提供。
• API 契约已同步 OpenAPI，并完成前端 generated client 再生成。

Breaking Changes

• shot.status 不再表达运行中生成状态；运行态请改用任务系统与 runtime summary。
• 分镜页面职责边界收敛：提取/确认主流程在 ChapterShotEditPage，ChapterStudio 聚焦生成链路。
• 长耗时流程默认采用异步任务模式；调用方应使用“提交任务 + 状态轮询/订阅”的交互模型。
• 若未同步最新 OpenAPI 与 generated client，可能出现字段不匹配或类型漂移问题。

Deprecations

• 在前端手写 service 封装已被 generated client 覆盖的接口调用方式。
• 在 shot.status 中复用“运行中”语义来表达任务执行态的做法。
• 在分镜工作室内承载提取确认主流程的历史交互路径。

Fixed

• 修复异步场景下的任务调用与任务状态展示问题。
• 修复分镜编辑流程中的关联数据刷新滞后问题。
• 清理历史废弃路由与代码路径，改善重构后的兼容性。

Security

本版本未包含已公开披露的安全漏洞修复项。 若你在升级或使用过程中发现潜在安全问题，请通过项目维护渠道私下反馈，避免在公开渠道披露可利用细节。

Known Issues

• 个别历史页面若仍使用旧状态判断逻辑，可能在边界场景下出现展示不一致。
• 若部署顺序错误（先上代码后迁移），可能触发与新字段相关的运行时异常。

Migration Guide

本版本包含数据库结构与行为层变更，必须先迁移数据库再部署应用代码。

1. 执行 backend/sql 下本版本相关迁移。
2. 部署后端服务。
3. 重新生成并部署前端 OpenAPI client 产物。

Rollback Notes

如需紧急回滚，请确保前后端与数据库版本保持一致：

1. 先回滚前端到与旧 OpenAPI 对齐的版本。
2. 再回滚后端服务到目标稳定版本。
3. 若已执行不可逆迁移，请优先走“兼容模式”而非直接回退表结构。

Compatibility Matrix

Validation Commands

# 更新并同步 OpenAPI 产物
pnpm run openapi:update

# 前端类型检查
pnpm exec tsc --noEmit

# 后端关键测试
uv run pytest backend/tests -q

Upgrade Checklist

• 数据库迁移执行完成并验证通过。
• 后端任务 worker 与异步运行时组件已正常启动。
• 前端 generated client 已与最新 OpenAPI 对齐。
• 任务创建、轮询、取消与回跳链路验证通过。
• 分镜准备 -> ready -> 生成主流程端到端验证通过。

References

• Tag: v0.2.0
• 关键目录：backend/sql、front/src/services/generated、backend/app/services/worker
• 关键组件：front/src/pages/aiStudio/components/TaskCenter.tsx

Notes for Contributors

• 后端 API 契约变更后，请执行 pnpm run openapi:update，并在同一 PR 同步前端 generated client。
• 在代码与 UI 中保持 shot.status、运行时任务状态、video-readiness 三类语义分离。

Acknowledgements

感谢所有参与本次异步任务基础能力与流程边界重构的贡献者。