Merge branch 'develop' into refactor/editing-planner-deepen

- 抽 useGlobalSettings: 集中管理 9 个全局配置状态（标题/字幕/BGM/水印/片头片尾/画中画/滤镜/绿幕/贴纸/封面）
- 抽 useVoiceMaterials: 配音素材数据加载（queryKey 与 VoiceMaterialLibrary 共享缓存）
- 主文件 413→340 行 (-18%)

apps/web/src/api/tasks.ts

@@ -1,6 +1,14 @@
 /**
- * 任务相关类型定义
+ * 任务相关 API
+ * 对接后端任务中心 API：
+ * - POST /api/v1/generation/tasks — 创建生成任务
+ * - GET  /api/v1/tasks              — 用户级任务列表（支持分页/筛选）
+ * - GET  /api/v1/tasks/{task_id}    — 任务详情（含 error_info）
+ * - POST /api/v1/tasks/{task_id}/retry — 重试失败任务
  */
+import apiClient from "./client"
+
+/* ──────────── 类型定义 ──────────── */
 
 /** 任务状态 */
 export type TaskStatus = "pending" | "waiting" | "running" | "completed" | "failed" | "cancelled"
@@ -77,3 +85,39 @@ export interface CreateGenerationTaskResponse {
   result_count: number
   error_message: string
 }
+
+/* ──────────── API 函数 ──────────── */
+
+/** 创建生成任务（智能剪辑） */
+export const createGenerationTask = async (
+  params: CreateGenerationTaskRequest,
+): Promise<CreateGenerationTaskResponse> => {
+  const { data } = await apiClient.post<CreateGenerationTaskResponse>("/generation/tasks", params)
+  return data
+}
+
+/** 获取任务列表（支持分页和筛选） */
+export const getTasks = async (params?: TaskListParams): Promise<TaskListResponse> => {
+  const { data } = await apiClient.get<TaskListResponse>("/tasks", {
+    params,
+  })
+  return data
+}
+
+/** 获取当前用户的所有任务（兼容旧接口，跨 project） */
+export const getUserTasks = async (): Promise<TaskItem[]> => {
+  const { data } = await apiClient.get("/tasks")
+  return data.items || data || []
+}
+
+/** 获取单个任务详情（含 error_info） */
+export const getTask = async (taskId: string): Promise<TaskItem> => {
+  const { data } = await apiClient.get(`/tasks/${taskId}`)
+  return data
+}
+
+/** 重试失败的任务 */
+export const retryTask = async (taskId: string): Promise<TaskItem> => {
+  const { data } = await apiClient.post(`/tasks/${taskId}/retry`)
+  return data
+}

apps/web/src/api/tasks/index.ts

@@ -1,19 +0,0 @@
-/**
- * 任务相关 API — 目录化入口
- * 保持与原 tasks.ts 相同导出，向后兼容
- */
-
-// 类型
-export type {
-  TaskStatus,
-  TaskType,
-  TaskErrorInfo,
-  TaskItem,
-  TaskListParams,
-  TaskListResponse,
-  CreateGenerationTaskRequest,
-  CreateGenerationTaskResponse,
-} from "./types"
-
-// API 函数
-export { createGenerationTask, getTasks, getUserTasks, getTask, retryTask } from "./tasks"

apps/web/src/api/tasks/tasks.ts

@@ -1,46 +0,0 @@
-/**
- * 任务相关 API 函数
- * 对接后端任务中心 API
- */
-import apiClient from "../client"
-import type {
-  CreateGenerationTaskRequest,
-  CreateGenerationTaskResponse,
-  TaskItem,
-  TaskListParams,
-  TaskListResponse,
-} from "./types"
-
-/** 创建生成任务（智能剪辑） */
-export const createGenerationTask = async (
-  params: CreateGenerationTaskRequest,
-): Promise<CreateGenerationTaskResponse> => {
-  const { data } = await apiClient.post<CreateGenerationTaskResponse>("/generation/tasks", params)
-  return data
-}
-
-/** 获取任务列表（支持分页和筛选） */
-export const getTasks = async (params?: TaskListParams): Promise<TaskListResponse> => {
-  const { data } = await apiClient.get<TaskListResponse>("/tasks", {
-    params,
-  })
-  return data
-}
-
-/** 获取当前用户的所有任务（兼容旧接口，跨 project） */
-export const getUserTasks = async (): Promise<TaskItem[]> => {
-  const { data } = await apiClient.get("/tasks")
-  return data.items || data || []
-}
-
-/** 获取单个任务详情（含 error_info） */
-export const getTask = async (taskId: string): Promise<TaskItem> => {
-  const { data } = await apiClient.get(`/tasks/${taskId}`)
-  return data
-}
-
-/** 重试失败的任务 */
-export const retryTask = async (taskId: string): Promise<TaskItem> => {
-  const { data } = await apiClient.post(`/tasks/${taskId}/retry`)
-  return data
-}