Compare commits

...

1 Commits

Author SHA1 Message Date
saas-backend 05b5de2ea8 feat(web): 标题模板管理系统 — 预设区域升级为模板卡片网格,支持新建/编辑/复制/删除 + 持久化
CI/CD Pipeline / Check push changed paths (pull_request) Has been skipped
CI/CD Pipeline / Dedup Check - skip PR tests when covered by push pipeline (pull_request) Successful in 2s
CI/CD Pipeline / Check if frontend-only change (pull_request) Successful in 2s
CI/CD Pipeline / Unit Tests (pull_request) Has been skipped
CI/CD Pipeline / Integration Tests (pull_request) Has been skipped
CI/CD Pipeline / PR Build API Image (pull_request) Has been skipped
CI/CD Pipeline / PR Build Worker Image (pull_request) Has been skipped
CI/CD Pipeline / Build Staging API Image (pull_request) Has been skipped
CI/CD Pipeline / Build Staging Worker Image (pull_request) Has been skipped
CI/CD Pipeline / Build Staging Web Image (pull_request) Has been skipped
CI/CD Pipeline / Retag skipped Staging API Image (pull_request) Has been skipped
CI/CD Pipeline / Retag skipped Staging Worker Image (pull_request) Has been skipped
CI/CD Pipeline / Retag skipped Staging Web Image (pull_request) Has been skipped
CI/CD Pipeline / Deploy Staging (Watchtower auto-deploy) (pull_request) Has been skipped
CI/CD Pipeline / Staging E2E Tests (pull_request) Has been skipped
CI/CD Pipeline / Staging API Integration Tests (pull_request) Has been skipped
CI/CD Pipeline / ACR Image Cleanup (pull_request) Has been skipped
CI/CD Pipeline / Frontend Lint (pull_request) Failing after 50s
PR Automation / Auto Approve on CI Green (pull_request) Successful in 1m9s
CI/CD Pipeline / Frontend Unit Tests (pull_request) Successful in 1m18s
CI/CD Pipeline / PR Build Web Image (pull_request) Failing after 1m40s
Preview Deploy / Deploy Preview Environment (pull_request) Failing after 3m57s
CI/CD Pipeline / Validate - Style (pull_request) Successful in 4m28s
AI Code Review / AI Code Review (pull_request) Successful in 6m33s
CI/CD Pipeline / Validate - Python (mypy + alembic) (pull_request) Successful in 7m42s
PR Automation / Auto Merge on CI Green + Approved (pull_request) Successful in 6m55s
CI/CD Pipeline / Validate - Security (pull_request) Successful in 11m33s
CI/CD Pipeline / Build Production Web Image (pull_request) Has been skipped
CI/CD Pipeline / Build Production Worker Image (pull_request) Has been skipped
CI/CD Pipeline / Build Production API Image (pull_request) Has been skipped
CI/CD Pipeline / Canary Release to Production (pull_request) Has been skipped
CI/CD Pipeline / CI Gate (pull_request) Failing after 2s
CI/CD Pipeline / Deploy Production (pull_request) Has been skipped
CI/CD Pipeline / Production Browser E2E (pull_request) Has been skipped
ACR Cleanup / ACR Image Cleanup (pull_request_target) Successful in 3m45s
Preview Cleanup / Cleanup Preview Environment (pull_request) Successful in 3m58s
Bug修复:
- Bug1:预设选中后手动改参数自动脱离预设(useRef→useState管理activePreset)
- Bug2:预设卡片预览字号统一(canvas固定120px宽度渲染)
- Bug3:描边参数始终可手动调整(预设只给初始值不锁定)

功能升级:
- 预设区域改为4列模板卡片网格(预览+名称+系统/自定义标签)
- 新增「新建模板」按钮,编辑模式实时预览+参数面板
- 支持编辑/复制/删除用户自定义模板
- 模板数据持久化到localStorage(key: xiaoxia-title-templates)

影响范围:TitleStylePanel公共组件,智能剪辑和AI数字人两个页面自动生效
2026-09-22 22:25:58 +08:00
9 changed files with 770 additions and 104 deletions
@@ -15,6 +15,7 @@ import type { TitleOption } from "@/pages/generate/components/title/TitleLibrary
import type { TitleSettings } from "@/pages/generate/types"
import { POSITION_OPTIONS } from "@/pages/generate/constants"
import { FONT_OPTIONS, TITLE_PRESETS } from "@/components/title/constants"
import { useTitleTemplates } from "@/pages/generate/hooks/useStep4Title/useTitleTemplates"
import type { AiAvatarTitleConfig } from "../types"
// #1894: 标题数据源切换到文案库,取 script.title 作为候选
import { getScripts } from "@/api/scripts"
@@ -30,6 +31,9 @@ const PanelTitleConfig: React.FC<PanelTitleConfigProps> = ({ titleConfig, onUpda
/** TitleStylePanel 内部高亮的预设 key(面板本地状态) */
const [activePreset, setActivePreset] = useState<string | null>(null)
/** 模板管理 */
const { allTemplates, saveTemplate, updateTemplate, deleteTemplate, duplicateTemplate } = useTitleTemplates()
/** 标题库选项(#1894:从文案库 scripts[].title 取候选) */
const [titleOptions, setTitleOptions] = useState<TitleOption[]>([])
useEffect(() => {
@@ -218,33 +222,63 @@ const PanelTitleConfig: React.FC<PanelTitleConfigProps> = ({ titleConfig, onUpda
}
}, [titleConfig])
/** 应用预设:覆盖新细粒度字段(颜色/描边/阴影/字号/字体等) */
/** 应用预设/模板:覆盖新细粒度字段(颜色/描边/阴影/字号/字体等) */
const handleApplyPreset = (presetKey: string) => {
// 先找系统预设
const preset = TITLE_PRESETS.find((p) => p.key === presetKey)
if (!preset) return
setActivePreset(presetKey)
const st = preset.style || {}
onUpdate({
font: st.font,
size: st.size,
color: st.color,
bold: st.bold,
italic: st.italic,
stroke: st.stroke,
stroke_width: st.stroke_width,
stroke_color: st.stroke_color,
shadow: st.shadow,
shadow_offset_x: st.shadow_offset_x,
shadow_offset_y: st.shadow_offset_y,
shadow_blur: st.shadow_blur,
shadow_color: st.shadow_color,
bg_enabled: st.bg_enabled,
bg_color: st.bg_color,
bg_padding: st.bg_padding,
bg_radius: st.bg_radius,
line_overrides: [],
cover_title_config: null,
})
if (preset) {
setActivePreset(presetKey)
const st = preset.style || {}
onUpdate({
font: st.font,
size: st.size,
color: st.color,
bold: st.bold,
italic: st.italic,
stroke: st.stroke,
stroke_width: st.stroke_width,
stroke_color: st.stroke_color,
shadow: st.shadow,
shadow_offset_x: st.shadow_offset_x,
shadow_offset_y: st.shadow_offset_y,
shadow_blur: st.shadow_blur,
shadow_color: st.shadow_color,
bg_enabled: st.bg_enabled,
bg_color: st.bg_color,
bg_padding: st.bg_padding,
bg_radius: st.bg_radius,
line_overrides: [],
cover_title_config: null,
})
return
}
// 再找用户模板
const tmpl = allTemplates.find((t) => t.key === presetKey)
if (tmpl && !tmpl.isSystem) {
setActivePreset(presetKey)
const st = tmpl.style || {}
onUpdate({
font: st.font,
size: st.size,
color: st.color,
bold: st.bold,
italic: st.italic,
stroke: st.stroke,
stroke_width: (st as any).stroke_width,
stroke_color: (st as any).stroke_color,
shadow: st.shadow,
shadow_offset_x: (st as any).shadow_offset_x,
shadow_offset_y: (st as any).shadow_offset_y,
shadow_blur: (st as any).shadow_blur,
shadow_color: (st as any).shadow_color,
bg_enabled: (st as any).bg_enabled,
bg_color: (st as any).bg_color,
bg_padding: (st as any).bg_padding,
bg_radius: (st as any).bg_radius,
line_overrides: [],
cover_title_config: null,
})
}
}
/** 字段 patch 透传:TitleStylePanel 的 onUpdateStylecamelCase → snake_case */
@@ -381,6 +415,11 @@ const PanelTitleConfig: React.FC<PanelTitleConfigProps> = ({ titleConfig, onUpda
}
POSITION_OPTIONS={POSITION_OPTIONS}
FONT_OPTIONS={FONT_OPTIONS}
templates={allTemplates}
onSaveTemplate={(label, style, emoji) => saveTemplate(label, style as any, emoji)}
onUpdateTemplate={(key, patch) => updateTemplate(key, patch as any)}
onDeleteTemplate={deleteTemplate}
onDuplicateTemplate={duplicateTemplate}
/>
{/* 自动生成字幕 */}
@@ -29,6 +29,7 @@ import { usePreviewAssets } from "./hooks/usePreviewAssets"
import { useBatchVariantPlans } from "./hooks/useBatchVariantPlans"
import { useVariantVoicePreview } from "./hooks/useVariantVoicePreview"
import { useTitleStyleUpdaters } from "./hooks/useStep4Title/useTitleStyleUpdaters"
import { useTitleTemplates } from "./hooks/useStep4Title/useTitleTemplates"
import { getAssetsByKind } from "@/api/assets"
import { previewTts } from "@/api/tts"
import { usePointsStore } from "@/store/pointsStore"
@@ -156,6 +157,9 @@ const GeneratePage: React.FC = () => {
onTitleSettingsChange: setTitleSettings,
})
/* ── 模板管理 ─ */
const { allTemplates, saveTemplate, updateTemplate, deleteTemplate, duplicateTemplate } = useTitleTemplates()
/* ── 配音素材库(TTS 试听)── */
const { data: voiceMaterials = [] } = useQuery({
queryKey: ["assets", "voice"],
@@ -643,6 +647,11 @@ const GeneratePage: React.FC = () => {
onUpdateStyle={styleUpdaters.updateStyle}
activePreset={styleUpdaters.activePreset}
titlePresets={styleUpdaters.titlePresets}
templates={allTemplates}
onSaveTemplate={(label, style, emoji) => saveTemplate(label, style as any, emoji)}
onUpdateTemplate={(key, patch) => updateTemplate(key, patch as any)}
onDeleteTemplate={deleteTemplate}
onDuplicateTemplate={duplicateTemplate}
bgm={bgm}
bgmConfig={bgmConfig}
coverSettings={coverSettings}
@@ -59,6 +59,20 @@ export interface GenerateStepContentProps {
emoji?: string
style: Record<string, unknown>
}>
/* ── 模板管理 ── */
templates?: Array<{
key: string
label: string
emoji?: string
isSystem: boolean
style: Record<string, unknown>
}>
onSaveTemplate?: (label: string, style: Record<string, unknown>, emoji?: string) => void
onUpdateTemplate?: (key: string, patch: { label?: string; style?: Record<string, unknown>; emoji?: string }) => void
onDeleteTemplate?: (key: string) => void
onDuplicateTemplate?: (key: string) => void
selectedTemplateKey?: string | null
onSelectTemplate?: (key: string | null) => void
/* ── 封面 ── */
coverSettings: CoverConfig
onCoverSettingsChange: (settings: CoverConfig) => void
@@ -128,6 +142,13 @@ export const GenerateStepContent: React.FC<GenerateStepContentProps> = (props) =
onUpdateStyle,
activePreset,
titlePresets,
templates,
onSaveTemplate,
onUpdateTemplate,
onDeleteTemplate,
onDuplicateTemplate,
selectedTemplateKey,
onSelectTemplate,
coverSettings,
onCoverSettingsChange,
onServerClipsChange,
@@ -201,6 +222,13 @@ export const GenerateStepContent: React.FC<GenerateStepContentProps> = (props) =
onUpdateStyle={onUpdateStyle}
activePreset={activePreset}
titlePresets={titlePresets}
templates={templates}
onSaveTemplate={onSaveTemplate}
onUpdateTemplate={onUpdateTemplate}
onDeleteTemplate={onDeleteTemplate}
onDuplicateTemplate={onDuplicateTemplate}
selectedTemplateKey={selectedTemplateKey}
onSelectTemplate={onSelectTemplate}
previewCount={previewCount}
previewTitles={previewTitles}
onPreviewTitlesChange={onPreviewTitlesChange}
@@ -43,6 +43,20 @@ interface Step4TitleSettingsProps {
style?: Record<string, unknown>
previewStyle?: React.CSSProperties
}>
/* ── 模板管理 ── */
templates?: Array<{
key: string
label: string
emoji?: string
isSystem: boolean
style: Record<string, unknown>
}>
onSaveTemplate?: (label: string, style: Record<string, unknown>, emoji?: string) => void
onUpdateTemplate?: (key: string, patch: { label?: string; style?: Record<string, unknown>; emoji?: string }) => void
onDeleteTemplate?: (key: string) => void
onDuplicateTemplate?: (key: string) => void
selectedTemplateKey?: string | null
onSelectTemplate?: (key: string | null) => void
/* ── 批量生成(#1677)── */
/** 生成数量 */
previewCount?: number
@@ -95,6 +109,13 @@ const Step4TitleSettings: React.FC<Step4TitleSettingsProps> = (props) => {
onUpdateStyle,
activePreset,
titlePresets,
templates,
onSaveTemplate,
onUpdateTemplate,
onDeleteTemplate,
onDuplicateTemplate,
selectedTemplateKey,
onSelectTemplate,
previewCount = 1,
previewTitles,
onPreviewTitlesChange,
@@ -300,6 +321,13 @@ const Step4TitleSettings: React.FC<Step4TitleSettingsProps> = (props) => {
titlePresets={titlePresets}
POSITION_OPTIONS={POSITION_OPTIONS}
FONT_OPTIONS={FONT_OPTIONS}
templates={templates}
onSaveTemplate={onSaveTemplate}
onUpdateTemplate={onUpdateTemplate}
onDeleteTemplate={onDeleteTemplate}
onDuplicateTemplate={onDuplicateTemplate}
selectedTemplateKey={selectedTemplateKey}
onSelectTemplate={onSelectTemplate}
/>
</div>
)
@@ -442,3 +442,190 @@
font-size: 12px !important;
padding: 6px 8px !important;
}
/* ============================================================
#模板管理系统 — 模板卡片网格样式
============================================================ */
/* 模板头部(标签 + 新建按钮) */
.ts-template-header {
display: flex;
align-items: center;
justify-content: space-between;
margin-bottom: 8px;
}
.ts-template-header label {
margin-bottom: 0;
}
.ts-new-template-btn {
padding: 4px 12px;
font-size: 12px;
font-weight: 500;
color: #7c3aed;
background: #faf5ff;
border: 1px solid #ddd6fe;
border-radius: 6px;
cursor: pointer;
transition: 0.15s;
}
.ts-new-template-btn:hover {
background: #ede9fe;
border-color: #7c3aed;
}
/* 模板网格:4列 */
.ts-template-grid {
display: grid;
grid-template-columns: repeat(4, 1fr);
gap: 8px;
}
/* 模板卡片 */
.ts-template-card {
position: relative;
border: 2px solid #e5e7eb;
border-radius: 8px;
background: #fff;
overflow: hidden;
transition: 0.15s;
}
.ts-template-card:hover {
border-color: #c4b5fd;
box-shadow: 0 2px 8px rgba(124, 58, 237, 0.1);
}
.ts-template-card.active {
border-color: #7c3aed;
background: #faf5ff;
box-shadow: 0 0 0 1px #7c3aed;
}
/* 预览按钮 */
.ts-template-preview-btn {
display: block;
width: 100%;
padding: 0;
border: none;
background: none;
cursor: pointer;
}
/* 预览 canvas 容器 */
.ts-template-canvas-wrap {
height: 48px;
display: flex;
align-items: center;
justify-content: center;
background: #0f172a;
overflow: hidden;
}
.ts-template-canvas-wrap canvas {
max-width: 100%;
max-height: 100%;
}
/* 标签行 */
.ts-template-label-row {
display: flex;
align-items: center;
justify-content: space-between;
padding: 4px 6px;
gap: 4px;
}
.ts-template-name {
font-size: 10px;
color: #4b5563;
overflow: hidden;
text-overflow: ellipsis;
white-space: nowrap;
flex: 1;
}
.ts-template-tag {
font-size: 9px;
padding: 1px 4px;
border-radius: 3px;
flex-shrink: 0;
}
.ts-template-tag.system {
background: #f3f4f6;
color: #6b7280;
}
.ts-template-tag.user {
background: #ede9fe;
color: #7c3aed;
}
/* 操作按钮 */
.ts-template-actions {
position: absolute;
bottom: 0;
left: 0;
right: 0;
display: flex;
justify-content: center;
gap: 2px;
padding: 3px 4px;
background: rgba(255, 255, 255, 0.95);
border-top: 1px solid #e5e7eb;
z-index: 2;
}
.ts-template-action-btn {
padding: 2px 6px;
font-size: 10px;
border: 1px solid #d1d5db;
border-radius: 4px;
background: #fff;
cursor: pointer;
color: #374151;
transition: 0.1s;
}
.ts-template-action-btn:hover {
border-color: #7c3aed;
color: #7c3aed;
}
.ts-template-action-delete:hover {
border-color: #ef4444;
color: #ef4444;
}
/* 编辑模式横幅 */
.ts-editing-banner {
display: flex;
align-items: center;
gap: 8px;
padding: 8px 12px;
margin-bottom: 10px;
background: #ede9fe;
border: 1px solid #c4b5fd;
border-radius: 8px;
font-size: 13px;
color: #5b21b6;
}
.ts-editing-save-btn {
padding: 4px 12px;
font-size: 12px;
font-weight: 500;
color: #fff;
background: #7c3aed;
border: none;
border-radius: 6px;
cursor: pointer;
margin-left: auto;
transition: 0.15s;
}
.ts-editing-save-btn:hover {
background: #6d28d9;
}
.ts-editing-cancel-btn {
padding: 4px 12px;
font-size: 12px;
color: #6b7280;
background: #fff;
border: 1px solid #d1d5db;
border-radius: 6px;
cursor: pointer;
transition: 0.15s;
}
.ts-editing-cancel-btn:hover {
border-color: #9ca3af;
color: #374151;
}
@@ -1,17 +1,21 @@
/**
* 标题样式设置面板(#2001 升级)
* 标题样式设置面板(#2001 升级 + #模板管理系统
*
* P0:描边宽度滑块 / 描边颜色选择器 / 每行最大字符数 / 行距+顶部边距 /
* 4款爆款字体 / 抖音爆款黄预设
* P1:阴影参数化 / 背景色块 / Canvas 实时迷你预览 /
* 封面独立标题配置入口
* 模板卡片网格 / 新建模板 / 编辑模板
*
* 向后兼容:旧的 onToggleBold/Italic/Stroke/Shadow/onUpdatePosition/onUpdateFont/
* onUpdateSize/onApplyPreset props 全部保留;新增字段通过 onUpdateStyle 统一回写。
*
* Bug修复(#模板管理系统):
* - Bug1:预设选中后手动改参数自动脱离预设
* - Bug2:预设卡片预览字号统一(canvas 固定宽度渲染)
* - Bug3:描边参数始终可手动调整(预设只给初始值)
*/
import React, { useState } from "react"
import { Tabs } from "antd"
import React, { useState, useMemo } from "react"
import { Tabs, Modal, Input, Button } from "antd"
import type { TitleSettings } from "../../types"
import type { TitleStyleConfig } from "@/components/title/types"
import {
FONT_OPTIONS as NEW_FONT_OPTIONS,
TITLE_PRESETS,
@@ -19,10 +23,12 @@ import {
STROKE_COLOR_PALETTE,
BG_COLOR_PALETTE,
} from "@/components/title/constants"
import type { TitleTemplate } from "../../hooks/useStep4Title/useTitleTemplates"
import TitleMiniPreview from "./TitleMiniPreview"
import "./TitleStylePanel.css"
/* ── 类型定义 ── */
interface PositionOption {
value: string
label: string
@@ -57,9 +63,27 @@ interface TitleStylePanelProps {
showCoverToggle?: boolean
/** 画布预览宽度(默认 200) */
previewWidth?: number
/* ── 模板管理新增 ── */
/** 所有模板列表(系统 + 用户) */
templates?: TitleTemplate[]
/** 保存模板 */
onSaveTemplate?: (label: string, style: Partial<TitleStyleConfig>, emoji?: string) => TitleTemplate | void
/** 更新模板 */
onUpdateTemplate?: (key: string, patch: { label?: string; style?: Partial<TitleStyleConfig>; emoji?: string }) => void
/** 删除模板 */
onDeleteTemplate?: (key: string) => void
/** 复制模板 */
onDuplicateTemplate?: (key: string) => void
/** 当前选中的模板 key(编辑模式) */
selectedTemplateKey?: string | null
/** 选中模板 */
onSelectTemplate?: (key: string | null) => void
}
/* ── 通用 Slider + Label 行 ── */
/* ── 统一预览字号:所有预设卡片用相同 canvas 宽度渲染 ─ */
const PREVIEW_CANVAS_WIDTH = 120
/* ── SliderRow ── */
const SliderRow: React.FC<{
label: string
value: number
@@ -89,7 +113,7 @@ const SliderRow: React.FC<{
</div>
)
/* ── 色板 + 自定义颜色选择 ── */
/* ── ColorPicker ── */
const ColorPicker: React.FC<{
label?: string
value: string
@@ -140,40 +164,172 @@ const ColorPicker: React.FC<{
)
}
/* ── 预设网格(含爆款黄,10 个 + 迷你 Canvas 缩略) ── */
const PresetGrid: React.FC<{
activePreset: string | null
onApply: (key: string) => void
settings: TitleSettings
}> = ({ activePreset, onApply, settings }) => {
/* ── 保存模板弹窗 ── */
const SaveTemplateDialog: React.FC<{
open: boolean
isEdit: boolean
currentLabel?: string
onCancel: () => void
onSave: (label: string, emoji: string) => void
}> = ({ open, isEdit, currentLabel = "", onCancel, onSave }) => {
const [label, setLabel] = useState(currentLabel)
const [emoji, setEmoji] = useState("")
React.useEffect(() => {
if (open) {
setLabel(currentLabel)
setEmoji("")
}
}, [open, currentLabel])
const handleSave = () => {
if (!label.trim()) return
onSave(label.trim(), emoji.trim())
}
return (
<div className="ts-presets-grid">
{TITLE_PRESETS.map((p) => {
const isActive = activePreset === p.key
// 合并当前 style 与 preset.style 用于预览(仅预览时覆盖)
const previewStyle: TitleSettings = { ...settings, ...(p.style as Partial<TitleSettings>) }
<Modal
title={isEdit ? "编辑模板" : "保存模板"}
open={open}
onCancel={onCancel}
onOk={handleSave}
okText="保存"
cancelText="取消"
okButtonProps={{ disabled: !label.trim() }}
>
<div style={{ marginBottom: 16 }}>
<label style={{ display: "block", marginBottom: 6, fontWeight: 500 }}></label>
<Input
placeholder="请输入模板名称"
value={label}
onChange={(e) => setLabel(e.target.value)}
maxLength={20}
/>
</div>
<div>
<label style={{ display: "block", marginBottom: 6, fontWeight: 500 }}>
</label>
<Input
placeholder="输入 emoji,如 🔥"
value={emoji}
onChange={(e) => setEmoji(e.target.value)}
maxLength={4}
/>
</div>
<div style={{ marginTop: 16, fontSize: 12, color: "#9ca3af", lineHeight: 1.6 }}>
<p style={{ margin: "0 0 4px" }}></p>
<ul style={{ margin: 0, paddingLeft: 20 }}>
<li></li>
<li></li>
<li></li>
<li></li>
<li></li>
</ul>
</div>
</Modal>
)
}
/* ── 模板卡片网格(替代旧 PresetGrid ─ */
const TemplateGrid: React.FC<{
templates: TitleTemplate[]
activeKey: string | null
onApply: (key: string) => void
onEdit: (key: string) => void
onCopy: (key: string) => void
onDelete: (key: string) => void
currentSettings: TitleSettings
hoveredKey: string | null
onHover: (key: string | null) => void
}> = ({ templates, activeKey, onApply, onEdit, onCopy, onDelete, currentSettings, hoveredKey, onHover }) => {
return (
<div className="ts-template-grid">
{templates.map((t) => {
const isActive = activeKey === t.key
const isHovered = hoveredKey === t.key
// 预览用:合并当前设置与模板样式
const previewSettings: TitleSettings = {
...currentSettings,
...(t.style as Partial<TitleSettings>),
}
return (
<button
key={p.key}
type="button"
className={`ts-preset-card${isActive ? " active" : ""}`}
onClick={() => onApply(p.key)}
title={p.label}
<div
key={t.key}
className={`ts-template-card${isActive ? " active" : ""}`}
onMouseEnter={() => onHover(t.key)}
onMouseLeave={() => onHover(null)}
>
<div className="ts-preset-preview">
<TitleMiniPreview settings={previewStyle} width={100} sampleText="标题" />
{/* 预览区 */}
<button
type="button"
className="ts-template-preview-btn"
onClick={() => onApply(t.key)}
title={t.label}
>
<div className="ts-template-canvas-wrap">
<TitleMiniPreview
settings={previewSettings}
width={PREVIEW_CANVAS_WIDTH}
sampleText="标题"
/>
</div>
</button>
{/* 标签行 */}
<div className="ts-template-label-row">
<span className="ts-template-name">{t.emoji} {t.label}</span>
<span className={`ts-template-tag ${t.isSystem ? "system" : "user"}`}>
{t.isSystem ? "系统" : "自定义"}
</span>
</div>
<div className="ts-preset-meta">
<span className="ts-preset-emoji">{p.emoji}</span>
<span className="ts-preset-label">{p.label}</span>
</div>
</button>
{/* 操作按钮(hover 显示,系统预设不显示删除) */}
{isHovered && (
<div className="ts-template-actions">
<button
type="button"
className="ts-template-action-btn"
onClick={(e) => {
e.stopPropagation()
onEdit(t.key)
}}
title="编辑"
>
</button>
<button
type="button"
className="ts-template-action-btn"
onClick={(e) => {
e.stopPropagation()
onCopy(t.key)
}}
title="复制"
>
</button>
{!t.isSystem && (
<button
type="button"
className="ts-template-action-btn ts-template-action-delete"
onClick={(e) => {
e.stopPropagation()
onDelete(t.key)
}}
title="删除"
>
</button>
)}
</div>
)}
</div>
)
})}
</div>
)
}
/* ── 主面板 ── */
const TitleStylePanel: React.FC<TitleStylePanelProps> = ({
settings,
onUpdatePosition,
@@ -190,16 +346,130 @@ const TitleStylePanel: React.FC<TitleStylePanelProps> = ({
showCoverToggle = false,
previewWidth = 220,
onUpdateStyle,
/* 模板管理 */
templates = [],
onSaveTemplate,
onUpdateTemplate,
onDeleteTemplate,
onDuplicateTemplate,
selectedTemplateKey,
onSelectTemplate,
}) => {
const upd = (patch: Partial<TitleSettings>) => {
onUpdateStyle?.(patch)
}
/* 封面独立标题切换 */
const [coverOpen, setCoverOpen] = useState(!!settings.coverTitle)
/* ── 模板管理状态 ── */
const [saveDialogOpen, setSaveDialogOpen] = useState(false)
const [saveDialogEdit, setSaveDialogEdit] = useState(false)
const [saveDialogKey, setSaveDialogKey] = useState<string | null>(null)
const [hoveredTemplateKey, setHoveredTemplateKey] = useState<string | null>(null)
// 编辑模板:选择某个模板进入编辑模式,修改参数后保存
const [editingTemplateKey, setEditingTemplateKey] = useState<string | null>(null)
const handleNewTemplate = () => {
setSaveDialogEdit(false)
setSaveDialogKey(null)
setSaveDialogOpen(true)
}
const handleEditTemplate = (key: string) => {
setEditingTemplateKey(key)
setSaveDialogEdit(true)
setSaveDialogKey(key)
// 应用模板样式到当前设置
const tmpl = templates.find((t) => t.key === key)
if (tmpl) {
onApplyPreset(key)
}
}
const handleSaveDialog = (label: string, emoji: string) => {
// 将当前设置转为 TitleStyleConfig 格式
const style: Partial<TitleStyleConfig> = {
font: settings.font,
size: settings.size,
color: settings.color,
bold: settings.bold,
italic: settings.italic,
stroke: settings.stroke,
stroke_width: settings.strokeWidth,
stroke_color: settings.strokeColor,
shadow: settings.shadow,
shadow_offset_x: settings.shadowOffsetX,
shadow_offset_y: settings.shadowOffsetY,
shadow_blur: settings.shadowBlur,
shadow_color: settings.shadowColor,
bg_enabled: settings.bgEnabled,
bg_color: settings.bgColor,
bg_padding: settings.bgPadding,
bg_radius: settings.bgRadius,
line_height: settings.lineHeight,
max_chars_per_line: settings.maxCharsPerLine,
}
if (saveDialogEdit && saveDialogKey && onUpdateTemplate) {
onUpdateTemplate(saveDialogKey, { label, style, emoji: emoji || undefined })
} else if (onSaveTemplate) {
onSaveTemplate(label, style, emoji || undefined)
}
setSaveDialogOpen(false)
setEditingTemplateKey(null)
setSaveDialogKey(null)
}
const handleDeleteTemplate = (key: string) => {
if (onDeleteTemplate) {
onDeleteTemplate(key)
}
}
const handleCopyTemplate = (key: string) => {
if (onDuplicateTemplate) {
onDuplicateTemplate(key)
}
}
const handleApplyTemplate = (key: string) => {
onApplyPreset(key)
onSelectTemplate?.(key)
setEditingTemplateKey(null)
}
// 编辑模式提示
const isEditing = editingTemplateKey !== null
const editingTemplate = editingTemplateKey ? templates.find((t) => t.key === editingTemplateKey) : null
return (
<div className="xx-title-style-section ts-panel">
{/* 编辑模式提示 */}
{isEditing && editingTemplate && (
<div className="ts-editing-banner">
<span>{editingTemplate.label}</span>
<button
type="button"
className="ts-editing-save-btn"
onClick={() => {
setSaveDialogEdit(true)
setSaveDialogKey(editingTemplateKey)
setSaveDialogOpen(true)
}}
>
</button>
<button
type="button"
className="ts-editing-cancel-btn"
onClick={() => setEditingTemplateKey(null)}
>
</button>
</div>
)}
{/* 实时迷你预览 */}
<div className="ts-preview-wrap">
<TitleMiniPreview
@@ -209,12 +479,28 @@ const TitleStylePanel: React.FC<TitleStylePanelProps> = ({
/>
</div>
{/* 预设样式(10个,含抖音爆款黄) */}
{/* 模板管理区域 */}
<div className="ts-form-field">
<label></label>
<PresetGrid activePreset={activePreset} onApply={onApplyPreset} settings={settings} />
<div className="ts-template-header">
<label style={{ margin: 0 }}></label>
<button type="button" className="ts-new-template-btn" onClick={handleNewTemplate}>
+
</button>
</div>
<TemplateGrid
templates={templates.length > 0 ? templates : []}
activeKey={activePreset}
onApply={handleApplyTemplate}
onEdit={handleEditTemplate}
onCopy={handleCopyTemplate}
onDelete={handleDeleteTemplate}
currentSettings={settings}
hoveredKey={hoveredTemplateKey}
onHover={setHoveredTemplateKey}
/>
</div>
{/* 基础参数面板 */}
<Tabs
size="small"
defaultActiveKey="basic"
@@ -224,7 +510,6 @@ const TitleStylePanel: React.FC<TitleStylePanelProps> = ({
label: "基础",
children: (
<>
{/* 位置 + 字体 */}
<div className="ts-row-2">
<div className="ts-form-field ts-half">
<label></label>
@@ -249,7 +534,7 @@ const TitleStylePanel: React.FC<TitleStylePanelProps> = ({
>
{NEW_FONT_OPTIONS.map((f) => (
<option key={f.value} value={f.value}>
{f.tag === "hot" ? "🔥 " : f.tag === "new" ? "🆕 " : ""}
{f.tag === "hot" ? " " : f.tag === "new" ? "🆕 " : ""}
{f.label}
</option>
))}
@@ -265,7 +550,6 @@ const TitleStylePanel: React.FC<TitleStylePanelProps> = ({
onChange={onUpdateSize}
/>
{/* 样式按钮 */}
<div className="ts-form-field">
<label></label>
<div className="ts-style-btns">
@@ -288,7 +572,6 @@ const TitleStylePanel: React.FC<TitleStylePanelProps> = ({
className={`ts-style-btn${settings.stroke ? " active" : ""}`}
onClick={() => {
onToggleStroke()
// 如果之前 strokeWidth 为 0,启用时给个默认值
if (!settings.stroke && (settings.strokeWidth ?? 0) < 2) {
upd({ strokeWidth: 4 })
}
@@ -318,7 +601,6 @@ const TitleStylePanel: React.FC<TitleStylePanelProps> = ({
</div>
</div>
{/* 字色 */}
<ColorPicker
label="字色"
value={settings.color}
@@ -531,6 +813,19 @@ const TitleStylePanel: React.FC<TitleStylePanelProps> = ({
: []),
]}
/>
{/* 保存模板弹窗 */}
<SaveTemplateDialog
open={saveDialogOpen}
isEdit={saveDialogEdit}
currentLabel={saveDialogKey ? templates.find((t) => t.key === saveDialogKey)?.label : ""}
onCancel={() => {
setSaveDialogOpen(false)
setSaveDialogEdit(false)
setSaveDialogKey(null)
}}
onSave={handleSaveDialog}
/>
</div>
)
}
@@ -114,6 +114,7 @@ export function useStep4Title({
aiTitleResults,
hasGeneratedTitles,
activePreset: styleUpdaters.activePreset,
setActivePreset: styleUpdaters.setActivePreset,
titlePresets: styleUpdaters.titlePresets,
// AI 标题操作
handleGenerateAiTitles,
@@ -132,6 +133,7 @@ export function useStep4Title({
toggleStroke: styleUpdaters.toggleStroke,
toggleShadow: styleUpdaters.toggleShadow,
applyPreset: styleUpdaters.applyPreset,
updateStyle: styleUpdaters.updateStyle,
}
}
@@ -1,4 +1,4 @@
import { useCallback, useMemo } from "react"
import { useCallback, useState } from "react"
import { TITLE_PRESETS } from "../../constants"
import { TITLE_PRESETS as NEW_TITLE_PRESETS } from "@/components/title/constants"
import type { TitleSettings } from "../../types"
@@ -11,28 +11,15 @@ interface UseTitleStyleUpdatersOptions {
/**
* 标题样式更新 Hook
* 封装标题文字、位置、字体、样式等所有设置更新函数
*
* Bug修复:手动修改参数时自动脱离预设(#模板管理系统)
*/
export function useTitleStyleUpdaters({
titleSettings,
onTitleSettingsChange,
}: UseTitleStyleUpdatersOptions) {
/** 匹配预设:只用 color/bold/italic/stroke/shadow,不再匹配 size */
const getActivePreset = (settings: TitleSettings): string | null => {
for (const p of TITLE_PRESETS) {
if (
settings.color === p.style.color &&
settings.bold === p.style.bold &&
settings.italic === p.style.italic &&
settings.stroke === p.style.stroke &&
settings.shadow === p.style.shadow
) {
return p.key
}
}
return null
}
const activePreset = useMemo(() => getActivePreset(titleSettings), [titleSettings])
/** 当前选中的预设 key(手动修改参数时置 null) */
const [activePreset, setActivePreset] = useState<string | null>(null)
const updateTitle = useCallback(
(title: string) => {
@@ -47,7 +34,6 @@ export function useTitleStyleUpdaters({
const updatePosition = useCallback(
(position: string) => {
// 切回三档预设时清掉自定义坐标
onTitleSettingsChange({ ...titleSettings, position, posX: null, posY: null })
},
[titleSettings, onTitleSettingsChange],
@@ -61,8 +47,18 @@ export function useTitleStyleUpdaters({
[titleSettings, onTitleSettingsChange],
)
/** 通用手动更新:自动脱离预设 */
const updateStyle = useCallback(
(patch: Partial<TitleSettings>) => {
setActivePreset(null)
onTitleSettingsChange({ ...titleSettings, ...patch })
},
[titleSettings, onTitleSettingsChange],
)
const updateFont = useCallback(
(font: string) => {
setActivePreset(null)
onTitleSettingsChange({ ...titleSettings, font })
},
[titleSettings, onTitleSettingsChange],
@@ -70,6 +66,7 @@ export function useTitleStyleUpdaters({
const updateSize = useCallback(
(size: number) => {
setActivePreset(null)
onTitleSettingsChange({ ...titleSettings, size })
},
[titleSettings, onTitleSettingsChange],
@@ -77,65 +74,64 @@ export function useTitleStyleUpdaters({
const updateColor = useCallback(
(color: string) => {
setActivePreset(null)
onTitleSettingsChange({ ...titleSettings, color })
},
[titleSettings, onTitleSettingsChange],
)
const toggleBold = useCallback(() => {
setActivePreset(null)
onTitleSettingsChange({ ...titleSettings, bold: !titleSettings.bold })
}, [titleSettings, onTitleSettingsChange])
const toggleItalic = useCallback(() => {
setActivePreset(null)
onTitleSettingsChange({ ...titleSettings, italic: !titleSettings.italic })
}, [titleSettings, onTitleSettingsChange])
const toggleStroke = useCallback(() => {
setActivePreset(null)
onTitleSettingsChange({ ...titleSettings, stroke: !titleSettings.stroke })
}, [titleSettings, onTitleSettingsChange])
const toggleShadow = useCallback(() => {
setActivePreset(null)
onTitleSettingsChange({ ...titleSettings, shadow: !titleSettings.shadow })
}, [titleSettings, onTitleSettingsChange])
/** 应用预设(支持新预设细粒度字段) */
const applyPreset = useCallback(
(presetKey: string) => {
// 优先匹配新预设(10个爆款预设),fallback 旧预设
const newPreset = NEW_TITLE_PRESETS.find((p) => p.key === presetKey)
const oldPreset = TITLE_PRESETS.find((p) => p.key === presetKey)
if (newPreset) {
onTitleSettingsChange({
...titleSettings,
...(newPreset.style as Partial<TitleSettings>),
// 清除逐行覆盖
lineOverrides: [],
})
setActivePreset(presetKey)
return
}
if (!oldPreset) return
onTitleSettingsChange({
...titleSettings,
color: oldPreset.style.color,
bold: oldPreset.style.bold,
italic: oldPreset.style.italic,
stroke: oldPreset.style.stroke,
shadow: oldPreset.style.shadow,
})
},
[titleSettings, onTitleSettingsChange],
)
/** 通用字段更新(patch */
const updateStyle = useCallback(
(patch: Partial<TitleSettings>) => {
onTitleSettingsChange({ ...titleSettings, ...patch })
if (oldPreset) {
onTitleSettingsChange({
...titleSettings,
color: oldPreset.style.color,
bold: oldPreset.style.bold,
italic: oldPreset.style.italic,
stroke: oldPreset.style.stroke,
shadow: oldPreset.style.shadow,
})
setActivePreset(presetKey)
}
},
[titleSettings, onTitleSettingsChange],
)
return {
activePreset,
setActivePreset,
titlePresets: NEW_TITLE_PRESETS,
updateTitle,
toggleAiAutoSelect,
@@ -0,0 +1,82 @@
/**
* 标题模板管理 Hook
* - 系统预设从 TITLE_PRESETS 加载(始终可用)
* - 用户自定义模板存 localStorage
* - 支持创建、编辑、复制、删除
*/
import { useState, useCallback, useEffect } from "react"
import { TITLE_PRESETS } from "@/components/title/constants"
import type { TitleStyleConfig } from "@/components/title/types"
const STORAGE_KEY = "xiaoxia-title-templates"
export interface TitleTemplate {
key: string
label: string
emoji?: string
isSystem: boolean
style: Partial<TitleStyleConfig>
}
/** 生成唯一模板 key */
function genTemplateKey(label: string): string {
const slug = label
.toLowerCase()
.replace(/[^\w\u4e00-\u9fff]/g, "_")
.replace(/_+/g, "_")
.replace(/^_|_$/g, "")
return `user_${slug}_${Date.now().toString(36)}`
}
export function useTitleTemplates() {
const [userTemplates, setUserTemplates] = useState<TitleTemplate[]>(() => {
try {
const raw = localStorage.getItem(STORAGE_KEY)
return raw ? JSON.parse(raw) : []
} catch {
return []
}
})
useEffect(() => {
try {
localStorage.setItem(STORAGE_KEY, JSON.stringify(userTemplates))
} catch {
// ignore
}
}, [userTemplates])
const allTemplates: TitleTemplate[] = [
...TITLE_PRESETS.map((p) => ({ ...p, isSystem: true })),
...userTemplates,
]
const saveTemplate = useCallback((label: string, style: Partial<TitleStyleConfig>, emoji?: string) => {
const t: TitleTemplate = { key: genTemplateKey(label), label, emoji: emoji || "", isSystem: false, style }
setUserTemplates((prev) => [...prev, t])
return t
}, [])
const updateTemplate = useCallback((key: string, patch: { label?: string; style?: Partial<TitleStyleConfig>; emoji?: string }) => {
setUserTemplates((prev) => prev.map((t) => (t.key === key ? { ...t, ...patch } : t)))
}, [])
const deleteTemplate = useCallback((key: string) => {
setUserTemplates((prev) => prev.filter((t) => t.key !== key))
}, [])
const duplicateTemplate = useCallback((key: string) => {
setUserTemplates((prev) => {
const src = prev.find((t) => t.key === key)
if (!src) return prev
const dup: TitleTemplate = {
...src,
key: genTemplateKey(src.label + "_copy"),
label: src.label + " 副本",
}
return [...prev, dup]
})
}, [])
return { allTemplates, saveTemplate, updateTemplate, deleteTemplate, duplicateTemplate }
}