xiaoxia/xiaoxia-saas
1
0
Fork 0
Code Issues 11 Pull Requests 3 Actions 2 Packages Projects Releases 7 Wiki Activity
Files
642d01eee4f78d528ef8e9995133b738dca5c263
xiaoxia-saas/docs/PHASE7-PROGRESS.md
T

6.4 KiB
Raw Blame History

PHASE7-PROGRESS.md

Phase: Phase 7 - 核心视频剪辑业务
状态: 🔄 进行中
最后更新: 2026-06-18 20:48 GMT+8

一、Phase 目标

根据 F:\openclaw-saas\docs\PHASE7-DESIGN.md，Phase 7 的目标是打通从：

  • 上传素材
  • 素材分类
  • 发起生成
  • 查看并下载成片

即完成 SaaS MVP 的核心视频剪辑主链路。

二、当前实际进展

1. 已完成（基础体系）

  • 完整工业化开发体系文档已建立
  • 8 Agent 角色体系已定义
  • Git 工作流规范已确定
  • Gitea Runner 已运行
  • .gitea/workflows/ci-cd.yml 已建立
  • .github/workflows/ci-cd.yml 已与 .gitea 统一
  • 开发环境防跑偏收敛方案已建立
  • 启动链文档已修正到新标准
  • CI 主链已成功跑通一次（Code Quality / Run Tests / Build Summary）
  • requirements-dev.txt 已接入 CI
  • 本地 Git 仓库维护已完成第一轮收口（pack 数量已显著下降）

2. 当前进行中（执行策略已调整）

  • 文档维护机制持续执行
  • 暂停 8 Agent 实跑，保留全部开发规则与质量门禁
  • 由主会话按既定文档体系直接推进 Phase 7 业务开发

3. Phase 7 已正式进入第一批业务实现

当前优先顺序：

  • Asset / AssetLibrary 领域模型第一轮收口与校准
  • 当前主线 application + api + sqlalchemy_impl + in_memory 已对齐到统一素材模型
  • 旧素材链第一轮兼容压平（domain/asset.py、domain/asset_library.py、旧 ports、postgres/asset_repository.py）
  • OSS 上传能力第一轮打通
  • 素材列表与查询流程第一轮打通
  • ClassificationJob 流程第一轮打通
  • GenerationTask 主线骨架已落地
  • GeneratedVideo 主线骨架已落地
  • 生成任务创建后自动触发 worker
  • 生成结果最小闭环测试已落地
  • 生成结果下载地址接口已落地
  • 下载地址已升级为 MinIO 预签名优先策略
  • 前端主链路联调完成

4. 本轮已完成的具体验证

  • tests/integration/test_asset_tags.py 通过
  • tests/integration/test_ingest_pipeline.py 通过
  • tests/integration/test_upload_pipeline.py 通过
  • tests/integration/test_classification_pipeline.py 通过
  • tests/integration/test_projects.py 通过
  • tests/integration/test_generation_pipeline.py 通过（含生成结果最小闭环、下载地址查询、下载源 URL 稳定性）
  • 素材与生成主线相关目录编译检查通过

三、当前阻塞点

阻塞点 A：OpenClaw 子 Agent 运行时暂不可作为正式执行底座

已确认当前 webchat/control-ui 链路下，子 Agent 存在 runtime / continuation 异常。 当前决策：暂停 Agent 实跑，不让该问题阻塞 SaaS 主线开发。

阻塞点 B：文档维护必须持续执行

文档现在已经补齐，但后续如果不随着真实进展更新，依然会重新变成摆设。 必须把更新动作视为开发流程的一部分，而不是事后补写。

阻塞点 C：数据库模型字段命名仍保留历史包袱

当前 sqlalchemy_impl.models.AssetModel 及相关存储层字段仍使用历史命名：

  • asset_library_id
  • file_type
  • file_url
  • classification_result

当前处理策略：先在领域层与适配层完成语义收口，通过映射兼容；数据库层字段重命名延后为独立收口任务，避免影响当前主链开发速度。

四、下一步顺序（强制）

Step 1：文档维护持续化

  • 每次状态变化后同步更新 PHASE7-PROGRESS.md
  • 每次规则变化后同步更新相关规范文档
  • 每次新会话启动时先检查路径有效性

Step 2：主会话直接推进 Phase 7 第一批业务任务

  • Asset / AssetLibrary 领域模型与仓储接口第一轮收口
  • 上传 / Asset 创建链路第一轮对齐
  • ClassificationJob 与 Asset 元数据更新链路第一轮打通
  • GenerationTask / GeneratedVideo 主线骨架已补齐
  • API / Adapter / Worker 的生成结果流第一轮联调
  • GeneratedVideo 查询 / 下载地址第一轮打通
  • 下载地址已接入 MinIO 预签名优先策略
  • 测试补齐与回归验证

Step 3：保留 Agent 体系设计，等待 runtime 修复后再恢复实跑

  • 记录 Agent runtime 阻塞结论
  • 后续在不影响业务主线时继续修复 OpenClaw 子 Agent 问题

五、当前判断

当前 Phase 7 已完成素材前半主链打通，并把生成链推进到“最小可运行闭环 + 结果查询/下载接口可用（预签名优先）”，整体仍保持在既定规则内推进。

当前执行策略是：

  • 暂停 Agent 实跑
  • 保留全部开发规范、文档链、Git/CI/环境规则
  • 先在本地完成可提交单元收口与聚焦验证
  • 现在进入提交、推送、CI/CD 完整门禁阶段

六、老大可验证问题

如果新会话启动后问：

  1. 当前 Phase 是什么？

    • 答：Phase 7 - 核心视频剪辑业务

  2. 当前 Phase 主要在做什么？

    • 答：已切入 Phase 7 第一批业务开发，当前已完成素材前半主链收口，并把生成链推进到最小可运行闭环与结果查询/下载可用（预签名优先），正在持续提交与 CI/CD 验证

  3. 当前最重要的阻塞点是什么？

    • 答：OpenClaw 子 Agent runtime 暂不稳定，因此暂停 Agent 实跑；另外数据库字段命名仍有历史包袱，但已通过映射兼容，不阻断主线开发

  4. 当前进度文档路径是什么？

    • 答：F:\openclaw-saas\docs\PHASE7-PROGRESS.md

七、更新规则

每次发生以下情况，必须更新本文件：

  • CI 环境策略发生变化
  • Phase 7 正式进入业务实现
  • 新的关键阻塞点出现
  • 一个业务里程碑完成
  • 创建或试跑新的 Agent
  • 规则文档路径发生变化

最低更新要求（强制）

  • 每次完成一个阶段性收口动作，必须更新一次
  • 每次会话结束前，若状态有变化，必须检查是否需要更新
  • 如果文档状态落后于真实状态，视为违反流程，不得继续推进新任务

状态结论：Phase 7 未跑偏，已暂停 Agent 实跑并切回主会话直开；当前素材前半主链已打通，生成链已进入最小可运行闭环且结果查询/下载可用（预签名优先），现继续通过提交与 CI/CD 验证推进。

Reference in New Issue View Git Blame Copy Permalink