feat(#1894): 废弃标题库整合到文案库 - scripts 模型新增标题字段 #1927

Merged

auto-approve-bot merged 7 commits from refactor/1894-merge-title-library-into-scripts into develop 2026-09-16 05:35:20 +08:00

Conversation 2 Commits 7 Files Changed 10

+545 -5

xiaoxia commented 2026-09-15 12:38:10 +08:00

Owner

Copy Link

Copy Source

概述

将冗余的 title_libraries（标题库）整合进 scripts（文案库），实现标题配置的统一管理。

变更内容

1. Scripts 模型新增字段

• title_text (String 500)：标题文字内容
• title_category (String 50)：标题分类
• title_config (JSON)：标题样式配置（字体、字号、颜色、位置等）

2. 数据迁移脚本 (009)

• 为 scripts 表新增 3 个字段
• 将 title_libraries 现有数据迁移到 scripts 表（text→title_text, category→title_category, title_config 映射）
• 迁移后 title_libraries 保留但标记为废弃

3. title_libraries API 标记 deprecated

• 所有 7 个接口添加 [Deprecated] 文档前缀
• 返回响应添加 Warning header
• 日志记录废弃警告

4. 视频生成支持从 script 读取标题配置

• 生成任务请求新增 script_id 字段
• 当传入 script_id 时，自动从 script 读取 title_text/title_config 作为标题配置
• 请求中的 title_config 优先级高于 script 中的配置（兼容旧逻辑）
• 预览生成和批量生成都支持此功能

5. 补充单元测试

• test_script_title_integration.py：新增 8 个测试覆盖完整链路
• test_scripts_routes.py：更新现有测试覆盖新字段

向后兼容

• title_libraries API 仍可用，仅标记废弃
• 旧的 title_config 请求参数仍优先生效
• title_ids 仍可在请求中传入（向后兼容）

关联 Issue

• Closes refactor: 废弃标题库，整合到文案库——每条文案自带标题字段 (#1894)

## 概述 将冗余的 title_libraries（标题库）整合进 scripts（文案库），实现标题配置的统一管理。 ## 变更内容 ### 1. Scripts 模型新增字段 - `title_text` (String 500)：标题文字内容 - `title_category` (String 50)：标题分类 - `title_config` (JSON)：标题样式配置（字体、字号、颜色、位置等） ### 2. 数据迁移脚本 (009) - 为 scripts 表新增 3 个字段 - 将 title_libraries 现有数据迁移到 scripts 表（text→title_text, category→title_category, title_config 映射） - 迁移后 title_libraries 保留但标记为废弃 ### 3. title_libraries API 标记 deprecated - 所有 7 个接口添加 `[Deprecated]` 文档前缀 - 返回响应添加 `Warning` header - 日志记录废弃警告 ### 4. 视频生成支持从 script 读取标题配置 - 生成任务请求新增 `script_id` 字段 - 当传入 `script_id` 时，自动从 script 读取 `title_text`/`title_config` 作为标题配置 - 请求中的 `title_config` 优先级高于 script 中的配置（兼容旧逻辑） - 预览生成和批量生成都支持此功能 ### 5. 补充单元测试 - `test_script_title_integration.py`：新增 8 个测试覆盖完整链路 - `test_scripts_routes.py`：更新现有测试覆盖新字段 ## 向后兼容 - title_libraries API 仍可用，仅标记废弃 - 旧的 `title_config` 请求参数仍优先生效 - `title_ids` 仍可在请求中传入（向后兼容） ## 关联 Issue - Closes #1894

gitea-actions bot commented 2026-09-15 12:40:11 +08:00

Copy Link

Copy Source

🚀 预览环境已部署

项目	详情
PR号	#1927
预览链接	https://pr-1927.preview.xiaoxiajianji.com
API环境	staging

💡 预览环境使用 staging API 数据，请勿在预览环境中操作重要数据。

🔄 每次提交新代码后预览环境会自动更新。

🗑️ PR 关闭或合并后，预览环境会自动清理。

🚀 **预览环境已部署** | 项目 | 详情 | |------|------| | PR号 | #1927 | | 预览链接 | [https://pr-1927.preview.xiaoxiajianji.com](https://pr-1927.preview.xiaoxiajianji.com) | | API环境 | staging | > 💡 预览环境使用 staging API 数据，请勿在预览环境中操作重要数据。 > > 🔄 每次提交新代码后预览环境会自动更新。 > > 🗑️ PR 关闭或合并后，预览环境会自动清理。

xiaoxia force-pushed refactor/1894-merge-title-library-into-scripts from be4879096a to 08cad1f1ee 2026-09-15 13:41:07 +08:00 Compare

xiaoxia force-pushed refactor/1894-merge-title-library-into-scripts from 8d7546ac0b to ea8e17e80d 2026-09-15 14:20:23 +08:00 Compare

xiaoxia force-pushed refactor/1894-merge-title-library-into-scripts from 7fc342df8b to 6a4913a3b9 2026-09-15 14:36:38 +08:00 Compare

xiaoxia force-pushed refactor/1894-merge-title-library-into-scripts from b64d384b91 to 24da6c9667 2026-09-15 17:07:01 +08:00 Compare

xiaoxia force-pushed refactor/1894-merge-title-library-into-scripts from 24da6c9667 to 41fa4e016f 2026-09-15 17:08:44 +08:00 Compare

xiaoxia force-pushed refactor/1894-merge-title-library-into-scripts from 0b1fb30147 to 41fa4e016f 2026-09-15 17:21:35 +08:00 Compare

xiaoxia added 6 commits 2026-09-15 21:21:46 +08:00

feat(#1894): 废弃标题库整合到文案库 - scripts 模型新增 title_text/title_category/title_config 字段 - 数据迁移脚本 009 - title_libraries API 标记 deprecated - 视频生成支持从 script 读取标题配置 - 补充单元测试 29a127c7f1

fix(#1894): 修复缺失的ScriptModel字段、ScriptService方法、schema字段和deprecated header 08cad1f1ee

fix(#1894): 修复重复 script_id 定义 + 补齐 ScriptModel 字段、ScriptService 方法、deprecated header bc85c79f39

fix(#1894): 移除 CreateGenerationTaskRequest 中重复的 script_id 字段定义 6a4913a3b9

style: auto-format with black + isort + ruff + prettier [skip ci-format-check] b64d384b91

fix(#1894): add alembic 077 migration; fix test imports (from main import app) + URL prefix + dependency_overrides; ASCII Warning header 509b8db3a3

xiaoxia force-pushed refactor/1894-merge-title-library-into-scripts from a62dc33599 to 509b8db3a3 2026-09-15 21:21:46 +08:00 Compare

xiaoxia added 1 commit 2026-09-15 22:21:04 +08:00

fix(#1894): fix alembic revision chain — rename 077→076 (no 076 existed), set down_revision to 075_add_sentence_timings, add postgresql dialect guard ... f30fe14ff8

KeyError: '076_membership_points' broke alembic upgrade on CI (Postgres).
No membership_points migration ever existed (PR #1919 added points
without a new alembic revision). Our migration should chain from
075_add_sentence_timings, the actual head on develop.

xiaoxia force-pushed refactor/1894-merge-title-library-into-scripts from ffc39686df to f30fe14ff8 2026-09-15 22:21:04 +08:00 Compare

xiaoxia added 1 commit 2026-09-15 23:13:33 +08:00

fix(#1894): shorten alembic revision ID to fit varchar(32) ... d0125a1da2

alembic_version.version_num is varchar(32); previous ID
'076_merge_title_library_into_scripts' was 36 chars and caused
StringDataRightTruncation on PostgreSQL. Renamed to '076_merge_title_libs'
(20 chars).

xiaoxia force-pushed refactor/1894-merge-title-library-into-scripts from a8843fee8e to d0125a1da2 2026-09-15 23:13:33 +08:00 Compare

auto-approve-bot added 1 commit 2026-09-16 00:01:31 +08:00

style: auto-format with black + isort + ruff + prettier [skip ci-format-check] d0af26116c

xiaoxia referenced this issue from a commit 2026-09-16 01:38:26 +08:00

feat(#1894): merge title_library into scripts (#1927)

xiaoxia added 1 commit 2026-09-16 03:48:48 +08:00

fix(#1894): fix unit test failures - mock attrs + category default ... cb021b66d9

- Add title_text/title_category/title_config to all MagicMock instances in route tests
- Fix assertion: title_category default is '' not 'default'

xiaoxia added 1 commit 2026-09-16 03:48:59 +08:00

fix(#1894): remove conflicting 076_merge_title_libs migration (renamed to 077) b620b50f23

xiaoxia added 1 commit 2026-09-16 03:49:22 +08:00

fix(#1894): add 077_merge_title_libs migration (down_revision=076_membership_points) ... d551ce62ac

Replaces deleted 076_merge_title_libs. develop has 076_membership_points.py from PR #1919/#1936, so our migration must chain after it as 077.

xiaoxia added 1 commit 2026-09-16 03:57:40 +08:00

fix(#1894): add 076_membership_points.py from develop to fix alembic chain 29e80db722

xiaoxia added 1 commit 2026-09-16 04:31:27 +08:00

chore(ci): retrigger CI after fixes ab7595a432

xiaoxia added 1 commit 2026-09-16 05:18:49 +08:00

Merge remote-tracking branch 'origin/develop' into refactor/1894-merge-title-library-into-scripts ... d60359537a

# Conflicts:
#	alembic/versions/077_merge_title_libs.py
#	tests/unit/test_scripts_routes.py

auto-approve-bot added 1 commit 2026-09-16 05:24:36 +08:00

style: auto-format with black + isort + ruff + prettier [skip ci-format-check] fe9e0806ea

auto-approve-bot merged commit 7564b50f7e into develop 2026-09-16 05:35:20 +08:00

auto-approve-bot deleted branch refactor/1894-merge-title-library-into-scripts 2026-09-16 05:35:21 +08:00

gitea-actions bot commented 2026-09-16 05:35:53 +08:00

Copy Link

Copy Source

🗑️ 预览环境已清理

PR #1927 已关闭或合并，对应的预览环境已被清理。

如有需要，可以重新打开 PR 来重新生成预览环境。

🗑️ **预览环境已清理** PR #1927 已关闭或合并，对应的预览环境已被清理。 > 如有需要，可以重新打开 PR 来重新生成预览环境。

Sign in to join this conversation.

Reviewers

No Reviewers

Labels

Clear labels

architecture

架构设计

backend

后端相关

blocked

阻塞中

bug

Bug修复

ci-bug

CI本身的bug

ci-optimization

CI优化类任务

ci-pipeline

CI流水线/workflow相关

cleanup

代码清理

devops

运维/部署/CI

documentation

文档相关

feature

新功能

frontend

前端相关

P0

阻塞性，必须立即处理

P1

高优先级

P2

中优先级

P3

低优先级/后考虑

question

需要讨论确认

ready

PR CI通过，可合并

refactor

代码重构

No Label

Milestone

No items

No Milestone

Projects

Clear projects

No project

Assignees

Clear assignees

auto-approve-bot frontend-dev xiaoxia

No Assignees

3 Participants

Notifications

Subscribe

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: xiaoxia/xiaoxia-saas#1927