docs(release): record package three baseline

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 保留策略。

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`，标题库/上传/生成三条浏览器门禁通过。
 
 ---
 

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