From e94541d7938ff54ca271e69edb7029c6c58efb40 Mon Sep 17 00:00:00 2001 From: Xiaoxia AI Date: Wed, 24 Jun 2026 01:29:36 +0800 Subject: [PATCH] docs(release): record package three baseline --- docs/CURRENT-RELEASE-SURFACE.md | 57 +++++++++++++++--------- docs/SAAS-UPGRADE-EXECUTION-CHECKLIST.md | 20 ++++----- tests/unit/test_release_surface_docs.py | 10 ++--- 3 files changed, 51 insertions(+), 36 deletions(-) diff --git a/docs/CURRENT-RELEASE-SURFACE.md b/docs/CURRENT-RELEASE-SURFACE.md index 1f5aaaacc..c82923b44 100644 --- a/docs/CURRENT-RELEASE-SURFACE.md +++ b/docs/CURRENT-RELEASE-SURFACE.md @@ -1,7 +1,7 @@ # 当前发布面清单 最后更新：2026-06-23 -生产基线：`v0.1.18` +生产基线：`v0.1.42` 公网 Web：`https://saas.xiaoxiajianji.com/` 公网 API：`https://saas-api.xiaoxiajianji.com/` @@ -11,9 +11,9 @@ 当前 SaaS 版是视频处理/自动生成 MVP，已打通： -登录 → 工作空间 → 项目 → 素材库 → 上传素材 → 生成真实 MP4 → 下载成片。 +登录 → 工作空间 → 项目 → 素材库 → 上传素材 → 素材诊断 → 标题库 → 生成真实 MP4 → 下载成片。 -当前版本不是完整智能自动剪辑平台。旧版桌面软件中的素材诊断、标题库、成片历史、模板编排、ASR/TTS/BGM/转场等能力，已进入后续升级路线，但不属于当前已开放能力。 +当前版本不是完整智能自动剪辑平台。旧版桌面软件中的成片历史、模板编排、ASR/TTS/BGM/转场等能力，已进入后续升级路线，但不属于当前已开放能力。 --- @@ -68,7 +68,21 @@ - `public_upload_flow=ok` - `public_batch_upload_flow=ok` -### 2.5 视频生成 +### 2.5 标题库 + +- 项目级标题库。 +- 新增、启用/停用、常用标记。 +- 搜索和分类筛选。 +- 生成页可手选标题。 +- 未手选时自动优先选择常用且低使用次数标题。 +- 生成成功后回写标题使用次数。 + +生产验证： + +- 浏览器 E2E `core-titles.spec.ts` 通过。 +- 浏览器 E2E `core-generation.spec.ts` 验证标题选择和使用次数回写。 + +### 2.6 视频生成 - 创建生成任务。 - Worker 异步执行生成。 @@ -81,7 +95,7 @@ - `public_generation_flow=ok` -### 2.6 成片下载 +### 2.7 成片下载 - 查询生成结果。 - 获取下载 URL。 @@ -91,7 +105,7 @@ - 下载响应 `Content-Type: video/mp4`。 -### 2.7 权限边界 +### 2.8 权限边界 当前已验证： @@ -112,7 +126,7 @@ - `public_boundary_flow=ok`，覆盖 project、asset-library、assets、upload、generation task、generation results、generated video download 边界。 -### 2.8 生产发布与监控 +### 2.9 生产发布与监控 - 生产发布使用 tag 触发。 - runtime-builder 构建 API/Worker 镜像和 Web 产物。 @@ -123,8 +137,8 @@ 生产验证： -- `https://saas-api.xiaoxiajianji.com/health` 返回 `version: v0.1.18`。 -- 最新巡检报告显示 API/Web/容器/版本正常，但内存偏低为 warning。 +- `https://saas-api.xiaoxiajianji.com/health` 返回 `version: v0.1.42`。 +- 最新巡检报告显示 API/Web/容器/版本正常，无 alerts。 --- @@ -138,7 +152,6 @@ - Profile 高级设置：资料编辑、通知偏好、账号安全、会话管理。 - 全局项目列表。 - 全局成员管理。 -- 完整标题库。 - 素材智能视图/缺口诊断已开放基础版：推荐、慎用、高风险、未分类、最近上传、未使用、已使用、待复核、配音统计、准备度评分、生成前 critical 缺口拦截。 - 复核操作入口已开放基础版：素材页支持通过/拒绝，拒绝素材计入高风险。 - 成片历史管理、封面预览、批量下载、复核状态。 @@ -177,8 +190,9 @@ - `scripts/smoke_public_boundary_flow.py`：公网匿名/非成员访问 project、asset-library、assets、upload、generation task、generation results、generated video download 边界 smoke。 - `tests/unit/test_asset_diagnosis.py`：项目素材准备度、缺口诊断和智能视图计数规则。 - `tests/unit/test_generation_preflight.py`：API 创建生成任务前必须存在 ready 视频素材。 -- `apps/web/e2e/core-upload.spec.ts`：真实浏览器上传 MOV 后验证素材 ready 和智能诊断展示。 -- `apps/web/e2e/core-generation.spec.ts`：真实浏览器上传有效 MP4、生成成片、签名下载并校验 `video/mp4`。 +- `apps/web/e2e/core-upload.spec.ts`：真实浏览器上传 MOV 后验证素材 ready、智能诊断展示和复核入口。 +- `apps/web/e2e/core-titles.spec.ts`：真实浏览器新增标题、常用标记和搜索筛选。 +- `apps/web/e2e/core-generation.spec.ts`：真实浏览器上传有效 MP4、选择标题、生成成片、回写标题使用次数、签名下载并校验 `video/mp4`。 --- @@ -191,7 +205,7 @@ - CPU：2 核。 - 内存：约 1.7GiB。 - swap：已补 2GiB。 -- 根分区：约 40GiB，最近巡检约 79%。 +- 根分区：约 40GiB，彻底清理后巡检约 45%。 影响： @@ -202,26 +216,27 @@ - 生产机升级到至少 4GiB，推荐 8GiB。 -### 6.2 Gitea 仍与生产业务同机 +### 6.2 Gitea 已拆离生产业务机 现状： -- 构建任务已拆到 runtime-builder。 -- Gitea 服务本体仍在生产业务机。 +- 构建任务运行在 runtime-builder。 +- Gitea 服务本体已迁移到 runtime-builder 主机，生产业务机不再承载 Gitea。 影响： -- Git/Gitea 与生产业务共享 CPU、内存、磁盘和网络入口。 -- 单机故障会同时影响代码仓库、发布入口和生产业务。 +- 生产业务机资源压力显著降低。 +- 仍需持续关注小规格生产机磁盘和内存。 建议： -- 后续迁移 Gitea 到独立服务器，或升级当前生产机后再拆分。 +- 保持部署后 Docker artifact 自动清理。 +- 中期仍建议扩容生产机磁盘/内存。 --- ## 7. 下一步 1. 执行真实浏览器 UAT：登录 → 工作空间 → 项目 → 批量上传 → 智能诊断 → 复核 → 生成 → 下载。 -2. 进入开发包 3：标题库。 -3. 处理生产资源长期风险：升级生产机或迁移 Gitea。 +2. 进入开发包 4：成片中心。 +3. 处理生产资源长期风险：扩容生产机磁盘/内存或继续收紧 artifact 保留策略。 diff --git a/docs/SAAS-UPGRADE-EXECUTION-CHECKLIST.md b/docs/SAAS-UPGRADE-EXECUTION-CHECKLIST.md index 52b631eb6..c293adb93 100644 --- a/docs/SAAS-UPGRADE-EXECUTION-CHECKLIST.md +++ b/docs/SAAS-UPGRADE-EXECUTION-CHECKLIST.md @@ -132,17 +132,17 @@ ## 5. 开发包 3：标题库 -- [ ] 设计标题数据模型。 -- [ ] 增加标题迁移脚本。 -- [ ] 增加标题 CRUD API。 -- [ ] 增加搜索和分类筛选。 -- [ ] 增加常用标题。 -- [ ] 增加自动选标题。 -- [ ] 生成页接入标题库。 -- [ ] 生成成功后更新使用次数。 -- [ ] 测试标题权限边界。 +- [x] 设计标题数据模型。 +- [x] 增加标题迁移脚本。 +- [x] 增加标题 CRUD API。 +- [x] 增加搜索和分类筛选。 +- [x] 增加常用标题。 +- [x] 增加自动选标题。 +- [x] 生成页接入标题库。 +- [x] 生成成功后更新使用次数。 +- [x] 测试标题权限边界。 -验收：用户可以维护标题资产，生成时可手选或自动选择。 +验收：用户可以维护标题资产，生成时可手选或自动选择。生产基线：`v0.1.42`，标题库/上传/生成三条浏览器门禁通过。 --- diff --git a/tests/unit/test_release_surface_docs.py b/tests/unit/test_release_surface_docs.py index 5978c595f..f2fb037e4 100644 --- a/tests/unit/test_release_surface_docs.py +++ b/tests/unit/test_release_surface_docs.py @@ -1,17 +1,17 @@ from pathlib import Path -def test_current_release_surface_freezes_v018_capabilities(): +def test_current_release_surface_freezes_current_capabilities(): docs = Path("docs/CURRENT-RELEASE-SURFACE.md").read_text(encoding="utf-8") - assert "生产基线：`v0.1.18`" in docs + assert "生产基线：`v0.1.42`" in docs assert "public_auth_flow=ok" in docs assert "public_upload_flow=ok" in docs assert "public_generation_flow=ok" in docs assert "public_boundary_flow=ok" in docs - assert "version: v0.1.18" in docs + assert "version: v0.1.42" in docs assert "/var/lib/xiaoxia-ci/duty_report.json" in docs - assert "Gitea 仍与生产业务同机" in docs + assert "Gitea 已拆离生产业务机" in docs def test_current_release_surface_keeps_unimplemented_features_closed(): @@ -20,12 +20,12 @@ def test_current_release_surface_keeps_unimplemented_features_closed(): for feature in [ "订阅升级", "Admin 后台", - "完整标题库", "统一任务中心", "ASR 字幕", "TTS 配音", ]: assert feature in docs + assert "标题库" in docs assert "素材智能视图/缺口诊断已开放基础版" in docs assert "不得假成功" in docs