xiaoxia/xiaoxia-saas
1
0
Fork 0
Code Issues 11 Pull Requests 3 Actions Packages Projects Releases 7 Wiki Activity
Files
2b4a94ac95b49324d73a6c8ae1ba70c445393879
xiaoxia-saas/docs/PHASE7-PROGRESS.md
T
Xiaoxia AI 2b4a94ac95 fix(ci): align workflow triggers with branch policy
2026-06-19 06:41:20 +08:00

9.0 KiB
Raw Blame History

PHASE7-PROGRESS.md

Phase: Phase 7 - 核心视频剪辑业务
状态: 🔄 进行中
最后更新: 2026-06-19 06:40 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 预签名优先策略
  • 生成结果输出路径已对齐 workspace/project/task 结构
  • 前端主链路联调完成

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 稳定性、输出路径结构）
  • 前端 type-check 通过
  • 前端 build 通过

三、当前阻塞点

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

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

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

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

阻塞点 C：本轮暴露出 CI/CD 质量检查异常，但不得在业务收尾中顺手修改

已确认提交 e5d5ae4 对应的 ci-cd.yml #239 失败，失败点位于 Code Quality Check。 当前判断属于 CI/CD 环境 / 开发依赖工具链可执行性异常，而非本轮 Phase 7 业务代码主链缺陷。 老大已明确决策：

  • 本轮只记录问题，不边做边改 CI/CD
  • CI/CD 修复必须留到下一次单独规划、单独执行
  • 不得把 CI/CD 专项修复混入当前 Phase 7 业务收尾提交

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

当前 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 预签名优先策略
  • 生成 worker 输出路径已对齐正式目录结构
  • 前端生成页 / 结果页已接入主链并完成第一轮联调
  • 前端依赖环境、类型检查与构建链已恢复可用
  • 测试补齐与回归验证

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

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

Step 4：CI/CD 问题进入单独规划，不并入本轮业务收尾

  • 已记录 ci-cd.yml #239 在 Code Quality Check 失败
  • 已记录本轮处理原则：只暴露问题，不顺手改流水线
  • 已形成 CI/CD 后续专项治理清单
  • 已形成 CI-CD-稳定性修复专项规划-草案.md
  • 已正式启动 CI/CD 稳定性修复专项（独立分支）
  • 已完成 #239 失败链路复盘与第一轮根因确认
  • 已完成质量检查依赖与测试依赖拆分收敛
  • 已确认 workflow 触发范围漏掉 bugfix/**
  • 推送触发范围修复并等待新一轮 CI 验证

Step 5：全局质量审计与专项治理计划落档

  • 已完成一次面向整个 SaaS 仓库的全面质量审计
  • 已生成完整审计报告
  • 已生成执行摘要
  • 已生成后续专项整治清单
  • 按专项清单逐项进入后续治理

五、当前判断

当前 Phase 7 已完成素材前半主链打通，并把生成链推进到“最小可运行闭环 + 结果查询/下载接口可用（预签名优先）+ 输出路径结构对齐 + 前端生成/结果主链联调完成 + 前端构建恢复可用”，整体仍保持在既定规则内推进。与此同时，已完成一次面向整个 SaaS 仓库的全面质量审计，确认项目已具备可运行产品雏形，但全局一致性、测试可信度与 CI/CD 稳定性仍需专项收口。

当前执行策略是：

  • 暂停 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
  • 规则文档路径发生变化
  • 老大明确新增了流程约束（例如“只记录问题，不在业务收尾里顺手改 CI/CD”）

最低更新要求（强制）

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

状态结论：Phase 7 未跑偏，已暂停 Agent 实跑并切回主会话直开；当前素材前半主链已打通，生成链已进入最小可运行闭环且结果查询/下载可用（预签名优先），输出路径结构与前端主链联调均已完成，前端构建链也已恢复可用。CI/CD 专项已确认两层根因：其一是 Code Quality Check 使用 requirements-dev.txt 拉起整套运行时/测试依赖，导致质量工具链安装链过重且不稳定；其二是 workflow 的 push 触发范围未覆盖 bugfix/**，导致专项分支提交根本未触发 CI。当前已同步修复依赖拆分与触发范围问题，现进入新一轮 CI 验证阶段。

Reference in New Issue View Git Blame Copy Permalink