From 018cf590183b448fbf76528a4d7bd7772e3313ed Mon Sep 17 00:00:00 2001
From: xiaoxia <dev@xiaoxiajianji.com>
Date: Sun, 26 Jul 2026 15:45:30 +0800
Subject: [PATCH 1/5] =?UTF-8?q?refactor(title-library):=20=E4=B8=89?=
 =?UTF-8?q?=E9=98=B6=E6=AE=B5=E9=87=8D=E6=9E=84=20TitleLibrary=EF=BC=88736?=
 =?UTF-8?q?=E2=86=92137=E8=A1=8C,=20-81%=EF=BC=89?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Phase 1 - 抽类型/常量/工具函数:
- types/titleLibrary.ts: TitleType, Industry, Frequency, TitleData, CategoryItem
- constants/titleLibrary.ts: 筛选选项、频率阈值、常量
- utils/titleLibrary.ts: typeLabel, toTitleData, copyToClipboard

Phase 2 - 抽 6 个 UI 组件:
- TitleCard: 标题卡片（编辑/收藏/复制/删除）
- CategorySidebar: 左侧分类列表
- FilterBar: 顶部筛选栏（搜索+类型+行业+频率）
- TitleGrid: 标题网格 + 空状态
- CreateTitleModal: 新建标题弹窗
- AIGenerateModal: AI 生成标题弹窗

Phase 3 - 抽 3 个业务 Hook:
- useTitleLibrary: 数据获取、分类派生、CRUD、筛选逻辑
- useTitleEdit: 编辑状态管理 + 新建标题逻辑
- useTitleAI: AI 生成标题逻辑（mock）

主文件 736→137 行，共新增 12 个文件
---
 apps/web/src/pages/titles/TitleLibrary.tsx    | 815 +++---------------
 .../title-library/AIGenerateModal.tsx         | 121 +++
 .../title-library/CategorySidebar.tsx         |  44 +
 .../title-library/CreateTitleModal.tsx        |  89 ++
 .../components/title-library/FilterBar.tsx    |  76 ++
 .../components/title-library/TitleCard.tsx    | 121 +++
 .../components/title-library/TitleGrid.tsx    |  63 ++
 .../pages/titles/constants/titleLibrary.ts    |  34 +
 apps/web/src/pages/titles/hooks/useTitleAI.ts |  83 ++
 .../src/pages/titles/hooks/useTitleEdit.ts    |  86 ++
 .../src/pages/titles/hooks/useTitleLibrary.ts | 174 ++++
 .../src/pages/titles/types/titleLibrary.ts    |  20 +
 .../src/pages/titles/utils/titleLibrary.ts    |  49 ++
 apps/web/src/test/pages/TitleLibrary.test.tsx |  12 +
 14 files changed, 1080 insertions(+), 707 deletions(-)
 create mode 100644 apps/web/src/pages/titles/components/title-library/AIGenerateModal.tsx
 create mode 100644 apps/web/src/pages/titles/components/title-library/CategorySidebar.tsx
 create mode 100644 apps/web/src/pages/titles/components/title-library/CreateTitleModal.tsx
 create mode 100644 apps/web/src/pages/titles/components/title-library/FilterBar.tsx
 create mode 100644 apps/web/src/pages/titles/components/title-library/TitleCard.tsx
 create mode 100644 apps/web/src/pages/titles/components/title-library/TitleGrid.tsx
 create mode 100644 apps/web/src/pages/titles/constants/titleLibrary.ts
 create mode 100644 apps/web/src/pages/titles/hooks/useTitleAI.ts
 create mode 100644 apps/web/src/pages/titles/hooks/useTitleEdit.ts
 create mode 100644 apps/web/src/pages/titles/hooks/useTitleLibrary.ts
 create mode 100644 apps/web/src/pages/titles/types/titleLibrary.ts
 create mode 100644 apps/web/src/pages/titles/utils/titleLibrary.ts

diff --git a/apps/web/src/pages/titles/TitleLibrary.tsx b/apps/web/src/pages/titles/TitleLibrary.tsx
index 5becdbca6..9a102fa01 100644
--- a/apps/web/src/pages/titles/TitleLibrary.tsx
+++ b/apps/web/src/pages/titles/TitleLibrary.tsx
@@ -4,731 +4,132 @@
  * 支持：标题卡片展示、AI 生成标题、复制/编辑/删除、收藏、分类筛选、搜索
  * 对接后端真实 API（GET/POST/PUT/DELETE /titles）
  */
-import React, { useMemo, useState, useCallback } from "react"
-import { Modal as AntModal, message, Popconfirm } from "antd"
-import { useQuery, useMutation, useQueryClient } from "@tanstack/react-query"
-import {
-  PlusOutlined,
-  SearchOutlined,
-  DeleteOutlined,
-  EditOutlined,
-  CopyOutlined,
-  CheckOutlined,
-  RobotOutlined,
-  StarOutlined,
-  StarFilled,
-  FileTextOutlined,
-} from "@ant-design/icons"
-import { Button, Input, Select } from "@/components/ui"
-import { getTitles, createTitle, updateTitle, deleteTitle, type TitleItem } from "@/api/titles"
+import React from "react"
+import { useTitleLibrary } from "./hooks/useTitleLibrary"
+import { useTitleEdit } from "./hooks/useTitleEdit"
+import { useTitleAI } from "./hooks/useTitleAI"
+import { CategorySidebar } from "./components/title-library/CategorySidebar"
+import { FilterBar } from "./components/title-library/FilterBar"
+import { TitleGrid } from "./components/title-library/TitleGrid"
+import { CreateTitleModal } from "./components/title-library/CreateTitleModal"
+import { AIGenerateModal } from "./components/title-library/AIGenerateModal"
 import "./titles.css"
 
-/* ============================================================
- * 类型
- * ============================================================ */
-type TitleType = "hot" | "normal" | "creative"
-type Industry = "general" | "food" | "tech" | "beauty" | "education" | "travel"
-type Frequency = "all" | "high" | "medium" | "low"
-
-interface TitleData {
-  id: string
-  content: string
-  type: TitleType
-  industry: Industry
-  category: string
-  usageCount: number
-  isFavorited: boolean
-  createdAt: string
-}
-
-/** 后端 TitleItem → 前端 TitleData 映射 */
-const toTitleData = (item: TitleItem): TitleData => ({
-  id: item.id,
-  content: item.content,
-  type: (item.category as TitleType) || "normal",
-  industry: "general",
-  category: item.category || "未分类",
-  usageCount: 0,
-  isFavorited: false,
-  createdAt: item.created_at?.slice(0, 10) || "",
-})
-
-/* ============================================================
- * 工具函数
- * ============================================================ */
-const typeLabel = (type: TitleType): string => {
-  switch (type) {
-    case "hot":
-      return "爆款"
-    case "normal":
-      return "常规"
-    case "creative":
-      return "创意"
-  }
-}
-
-/** 复制文本到剪贴板 */
-const copyToClipboard = async (text: string): Promise<boolean> => {
-  try {
-    await navigator.clipboard.writeText(text)
-    return true
-  } catch {
-    /* 降级方案 */
-    const textarea = document.createElement("textarea")
-    textarea.value = text
-    textarea.style.position = "fixed"
-    textarea.style.opacity = "0"
-    document.body.appendChild(textarea)
-    textarea.select()
-    try {
-      document.execCommand("copy")
-      return true
-    } catch {
-      return false
-    } finally {
-      document.body.removeChild(textarea)
-    }
-  }
-}
-
-/* ============================================================
- * TitleCard 组件
- * ============================================================ */
-const TitleCard: React.FC<{
-  title: TitleData
-  isEditing: boolean
-  editText: string
-  onEditChange: (text: string) => void
-  onStartEdit: () => void
-  onSaveEdit: () => void
-  onCancelEdit: () => void
-  onCopy: () => void
-  onDelete: () => void
-  onToggleFavorite: () => void
-}> = ({
-  title,
-  isEditing,
-  editText,
-  onEditChange,
-  onStartEdit,
-  onSaveEdit,
-  onCancelEdit,
-  onCopy,
-  onDelete,
-  onToggleFavorite,
-}) => {
-  return (
-    <div className="xx-title-card">
-      {/* 收藏按钮 */}
-      <button
-        className="xx-title-fav-btn"
-        onClick={onToggleFavorite}
-        title={title.isFavorited ? "取消收藏" : "收藏"}
-        style={{
-          position: "absolute",
-          top: 12,
-          right: 12,
-          color: title.isFavorited ? "#f59e0b" : "var(--text-tertiary)",
-        }}
-      >
-        {title.isFavorited ? <StarFilled /> : <StarOutlined />}
-      </button>
-
-      {/* 标题文本 / 编辑区 */}
-      {isEditing ? (
-        <textarea
-          className="xx-title-card-edit"
-          value={editText}
-          onChange={(e) => onEditChange(e.target.value)}
-          autoFocus
-          onKeyDown={(e) => {
-            if (e.key === "Enter" && !e.shiftKey) {
-              e.preventDefault()
-              onSaveEdit()
-            }
-            if (e.key === "Escape") {
-              onCancelEdit()
-            }
-          }}
-        />
-      ) : (
-        <div className="xx-title-card-text" style={{ paddingRight: 24 }}>
-          {title.content}
-        </div>
-      )}
-
-      {/* 底部元信息 */}
-      <div className="xx-title-card-meta">
-        <div className="xx-title-card-meta-left">
-          <span className={`xx-title-type-tag ${title.type}`}>{typeLabel(title.type)}</span>
-          <span className="xx-title-card-stat">使用 {title.usageCount} 次</span>
-          <span className="xx-title-card-stat">{title.createdAt}</span>
-        </div>
-
-        <div className="xx-title-card-actions">
-          {isEditing ? (
-            <>
-              <button className="xx-title-card-action-btn" onClick={onSaveEdit} title="保存">
-                <CheckOutlined />
-              </button>
-              <button className="xx-title-card-action-btn" onClick={onCancelEdit} title="取消">
-                ✕
-              </button>
-            </>
-          ) : (
-            <>
-              <button className="xx-title-card-action-btn" onClick={onCopy} title="复制">
-                <CopyOutlined />
-              </button>
-              <button className="xx-title-card-action-btn" onClick={onStartEdit} title="编辑">
-                <EditOutlined />
-              </button>
-              <Popconfirm
-                title="确定删除此标题？"
-                onConfirm={onDelete}
-                okText="删除"
-                cancelText="取消"
-              >
-                <button className="xx-title-card-action-btn danger" title="删除">
-                  <DeleteOutlined />
-                </button>
-              </Popconfirm>
-            </>
-          )}
-        </div>
-      </div>
-    </div>
-  )
-}
-
-/* ============================================================
- * 主组件
- * ============================================================ */
 const TitleLibrary: React.FC = () => {
-  const queryClient = useQueryClient()
+  const {
+    categories,
+    activeCatId,
+    filteredTitles,
+    searchText,
+    filterType,
+    filterIndustry,
+    filterFrequency,
+    createMutation,
+    updateMutation,
+    setActiveCatId,
+    setSearchText,
+    setFilterType,
+    setFilterIndustry,
+    setFilterFrequency,
+    handleToggleFavorite,
+    handleCopy,
+    handleDelete,
+  } = useTitleLibrary()
 
-  /* 分类数据 — 从真实标题数据动态派生 */
-  const [activeCatId, setActiveCatId] = useState<string>("cat-all")
+  const {
+    editingId,
+    editText,
+    setEditText,
+    createTitleModalOpen,
+    setCreateTitleModalOpen,
+    newTitleContent,
+    setNewTitleContent,
+    newTitleType,
+    setNewTitleType,
+    handleStartEdit,
+    handleSaveEdit,
+    handleCancelEdit,
+    handleCreateTitle,
+    handleCloseCreateModal,
+  } = useTitleEdit({ updateMutation, createMutation })
 
-  /* 标题数据 — 真实 API */
-  const { data: apiTitles = [] } = useQuery({
-    queryKey: ["titles"],
-    queryFn: getTitles,
-    staleTime: 30_000,
-  })
-  const titles: TitleData[] = useMemo(() => apiTitles.map(toTitleData), [apiTitles])
-
-  /* 从真实标题数据动态派生分类（无需后端分类 API） */
-  const categories = useMemo(() => {
-    const cats = new Map<string, number>()
-    apiTitles.forEach((t) => {
-      const cat = t.category || "未分类"
-      cats.set(cat, (cats.get(cat) || 0) + 1)
-    })
-    return [
-      { id: "cat-all", name: "全部标题", count: apiTitles.length },
-      ...Array.from(cats.entries()).map(([name, count]) => ({
-        id: `cat-${name}`,
-        name,
-        count,
-      })),
-    ]
-  }, [apiTitles])
-
-  /* CRUD mutations */
-  const createMutation = useMutation({
-    mutationFn: (content: string) => createTitle({ content }),
-    onSuccess: () => {
-      queryClient.invalidateQueries({ queryKey: ["titles"] })
-    },
-    onError: () => message.error("创建标题失败"),
-  })
-
-  const updateMutation = useMutation({
-    mutationFn: ({ id, content }: { id: string; content: string }) => updateTitle(id, { content }),
-    onSuccess: () => {
-      queryClient.invalidateQueries({ queryKey: ["titles"] })
-    },
-    onError: () => message.error("更新标题失败"),
-  })
-
-  const deleteMutation = useMutation({
-    mutationFn: (id: string) => deleteTitle(id),
-    onSuccess: () => {
-      queryClient.invalidateQueries({ queryKey: ["titles"] })
-    },
-    onError: () => message.error("删除标题失败"),
-  })
-
-  /* 筛选 */
-  const [searchText, setSearchText] = useState("")
-  const [filterType, setFilterType] = useState<string>("all")
-  const [filterIndustry, setFilterIndustry] = useState<string>("all")
-  const [filterFrequency, setFilterFrequency] = useState<Frequency>("all")
-
-  /* 编辑状态 */
-  const [editingId, setEditingId] = useState<string | null>(null)
-  const [editText, setEditText] = useState("")
-
-  /* 新建标题 */
-  const [createTitleModalOpen, setCreateTitleModalOpen] = useState(false)
-  const [newTitleContent, setNewTitleContent] = useState("")
-  const [newTitleType, setNewTitleType] = useState<TitleType>("normal")
-
-  /* AI 生成 */
-  const [aiModalOpen, setAiModalOpen] = useState(false)
-  const [aiKeyword, setAiKeyword] = useState("")
-  const [aiLoading, setAiLoading] = useState(false)
-  const [aiResults, setAiResults] = useState<string[]>([])
-
-  /* 派生数据 */
-  const activeCategory = categories.find((c) => c.id === activeCatId)
-
-  const filteredTitles = useMemo(() => {
-    let list = titles
-
-    /* 按分类过滤（"全部标题" 不过滤）— 直接匹配后端 category 字段 */
-    if (activeCatId !== "cat-all") {
-      const catName = activeCategory?.name || ""
-      if (catName) {
-        list = list.filter((t) => t.category === catName)
-      }
-    }
-
-    /* 按类型筛选 */
-    if (filterType !== "all") {
-      list = list.filter((t) => t.type === filterType)
-    }
-
-    /* 按行业筛选 */
-    if (filterIndustry !== "all") {
-      list = list.filter((t) => t.industry === filterIndustry)
-    }
-
-    /* 按使用频率筛选 */
-    if (filterFrequency !== "all") {
-      switch (filterFrequency) {
-        case "high":
-          list = list.filter((t) => t.usageCount >= 100)
-          break
-        case "medium":
-          list = list.filter((t) => t.usageCount >= 30 && t.usageCount < 100)
-          break
-        case "low":
-          list = list.filter((t) => t.usageCount < 30)
-          break
-      }
-    }
-
-    /* 搜索 */
-    if (searchText.trim()) {
-      const q = searchText.trim().toLowerCase()
-      list = list.filter((t) => t.content.toLowerCase().includes(q))
-    }
-
-    return list
-  }, [titles, activeCatId, activeCategory, filterType, filterIndustry, filterFrequency, searchText])
-
-  /* 收藏切换（暂不支持，待后端 API） */
-  const handleToggleFavorite = useCallback((_id: string) => {
-    message.info("收藏功能即将上线")
-  }, [])
-
-  /* 复制 */
-  const handleCopy = useCallback(async (title: TitleData) => {
-    const ok = await copyToClipboard(title.content)
-    if (ok) {
-      message.success("已复制到剪贴板")
-    } else {
-      message.error("复制失败")
-    }
-  }, [])
-
-  /* 编辑 */
-  const handleStartEdit = useCallback((title: TitleData) => {
-    setEditingId(title.id)
-    setEditText(title.content)
-  }, [])
-
-  const handleSaveEdit = useCallback(() => {
-    if (!editText.trim()) {
-      message.warning("标题内容不能为空")
-      return
-    }
-    if (editingId) {
-      updateMutation.mutate({ id: editingId, content: editText.trim() })
-    }
-    setEditingId(null)
-    setEditText("")
-    message.success("标题已更新")
-  }, [editingId, editText, updateMutation])
-
-  const handleCancelEdit = useCallback(() => {
-    setEditingId(null)
-    setEditText("")
-  }, [])
-
-  /* 删除 */
-  const handleDelete = useCallback(
-    (id: string) => {
-      deleteMutation.mutate(id)
-      message.success("标题已删除")
-    },
-    [deleteMutation],
-  )
-
-  /* 新建标题 */
-  const handleCreateTitle = () => {
-    if (!newTitleContent.trim()) {
-      message.warning("请输入标题内容")
-      return
-    }
-    createMutation.mutate(newTitleContent.trim(), {
-      onSuccess: () => {
-        setCreateTitleModalOpen(false)
-        setNewTitleContent("")
-        setNewTitleType("normal")
-        message.success("标题创建成功")
-      },
-    })
-  }
-
-  /* AI 生成标题 */
-  const handleAIGenerate = () => {
-    if (!aiKeyword.trim()) {
-      message.warning("请输入关键词或主题")
-      return
-    }
-    setAiLoading(true)
-    setAiResults([])
-
-    /* Mock AI 生成延迟 */
-    setTimeout(() => {
-      const keyword = aiKeyword.trim()
-      const results = [
-        `${keyword}：这个方法让我事半功倍！`,
-        `关于${keyword}，99%的人都不知道的事`,
-        `${keyword}全攻略，看完这篇就够了`,
-        `我花了 3 个月研究${keyword}，总结出这些经验`,
-        `${keyword}避坑指南，帮你省下 1000 块`,
-      ]
-      setAiResults(results)
-      setAiLoading(false)
-    }, 2000)
-  }
-
-  /* 采纳 AI 生成的标题 */
-  const handleAdoptAITitle = (text: string) => {
-    createMutation.mutate(text, {
-      onSuccess: () => {
-        message.success("标题已采纳并添加到标题库")
-      },
-    })
-  }
-
-  /* 复制 AI 生成的标题 */
-  const handleCopyAI = async (text: string) => {
-    const ok = await copyToClipboard(text)
-    if (ok) {
-      message.success("已复制到剪贴板")
-    } else {
-      message.error("复制失败")
-    }
-  }
+  const {
+    aiModalOpen,
+    setAiModalOpen,
+    aiKeyword,
+    setAiKeyword,
+    aiLoading,
+    aiResults,
+    handleAIGenerate,
+    handleAdoptAITitle,
+    handleCopyAI,
+    handleCloseAIModal,
+  } = useTitleAI({ createMutation })
 
   return (
     <div className="xx-titles-page">
-      {/* 两栏布局 */}
       <div className="xx-titles-layout">
-        {/* ─── 左侧：分类列表 ─── */}
-        <div className="xx-title-category-list">
-          {categories.map((cat) => (
-            <div
-              key={cat.id}
-              className={`xx-title-category-item${cat.id === activeCatId ? " active" : ""}`}
-              onClick={() => setActiveCatId(cat.id)}
-            >
-              <div
-                style={{
-                  display: "flex",
-                  alignItems: "center",
-                  justifyContent: "space-between",
-                  flex: 1,
-                  minWidth: 0,
-                }}
-              >
-                <div style={{ minWidth: 0 }}>
-                  <h4 style={{ margin: 0 }}>
-                    <FileTextOutlined /> {cat.name}
-                  </h4>
-                  <span>{cat.count} 条</span>
-                </div>
-              </div>
-            </div>
-          ))}
+        {/* 左侧：分类列表 */}
+        <CategorySidebar
+          categories={categories}
+          activeCatId={activeCatId}
+          onSelect={setActiveCatId}
+        />
 
-          {/* TODO: 新建分类功能待后端分类 API 就绪后启用 */}
-        </div>
-
-        {/* ─── 右侧：内容区 ─── */}
+        {/* 右侧：内容区 */}
         <div className="xx-titles-content">
-          {/* 筛选栏 */}
-          <div className="xx-titles-filters">
-            <div className="xx-titles-filters-left">
-              <Input
-                placeholder="搜索标题关键词..."
-                prefix={<SearchOutlined />}
-                value={searchText}
-                onChange={(e) => setSearchText(e.target.value)}
-                allowClear
-                style={{ width: 220 }}
-              />
-              <Select
-                value={filterType}
-                onChange={setFilterType}
-                style={{ width: 110 }}
-                options={[
-                  { value: "all", label: "全部类型" },
-                  { value: "hot", label: "爆款" },
-                  { value: "normal", label: "常规" },
-                  { value: "creative", label: "创意" },
-                ]}
-              />
-              <Select
-                value={filterIndustry}
-                onChange={setFilterIndustry}
-                style={{ width: 110 }}
-                options={[
-                  { value: "all", label: "全部行业" },
-                  { value: "food", label: "美食" },
-                  { value: "tech", label: "科技" },
-                  { value: "beauty", label: "美妆" },
-                  { value: "education", label: "教育" },
-                  { value: "travel", label: "旅行" },
-                ]}
-              />
-              <Select
-                value={filterFrequency}
-                onChange={(v) => setFilterFrequency(v as Frequency)}
-                style={{ width: 120 }}
-                options={[
-                  { value: "all", label: "全部频率" },
-                  { value: "high", label: "高频使用" },
-                  { value: "medium", label: "中频使用" },
-                  { value: "low", label: "低频使用" },
-                ]}
-              />
-            </div>
-            <div className="xx-titles-filters-right">
-              <Button
-                buttonType="ghost"
-                buttonSize="sm"
-                icon={<PlusOutlined />}
-                onClick={() => setCreateTitleModalOpen(true)}
-              >
-                新建标题
-              </Button>
-              <Button
-                buttonType="primary"
-                buttonSize="sm"
-                icon={<RobotOutlined />}
-                onClick={() => setAiModalOpen(true)}
-              >
-                AI 生成标题
-              </Button>
-            </div>
-          </div>
+          <FilterBar
+            searchText={searchText}
+            onSearchChange={setSearchText}
+            filterType={filterType}
+            onFilterTypeChange={setFilterType}
+            filterIndustry={filterIndustry}
+            onFilterIndustryChange={setFilterIndustry}
+            filterFrequency={filterFrequency}
+            onFilterFrequencyChange={setFilterFrequency}
+            onCreateClick={() => setCreateTitleModalOpen(true)}
+            onAIClick={() => setAiModalOpen(true)}
+          />
 
-          {/* 标题卡片网格 */}
-          {filteredTitles.length > 0 ? (
-            <div className="xx-title-grid">
-              {filteredTitles.map((title) => (
-                <TitleCard
-                  key={title.id}
-                  title={title}
-                  isEditing={editingId === title.id}
-                  editText={editingId === title.id ? editText : ""}
-                  onEditChange={setEditText}
-                  onStartEdit={() => handleStartEdit(title)}
-                  onSaveEdit={handleSaveEdit}
-                  onCancelEdit={handleCancelEdit}
-                  onCopy={() => handleCopy(title)}
-                  onDelete={() => handleDelete(title.id)}
-                  onToggleFavorite={() => handleToggleFavorite(title.id)}
-                />
-              ))}
-            </div>
-          ) : (
-            <div className="xx-titles-empty">
-              <div className="xx-titles-empty-icon">
-                <FileTextOutlined />
-              </div>
-              <p>
-                {searchText
-                  ? "未找到匹配的标题"
-                  : "暂无标题，点击「新建标题」或「AI 生成标题」开始"}
-              </p>
-            </div>
-          )}
+          <TitleGrid
+            titles={filteredTitles}
+            editingId={editingId}
+            editText={editText}
+            searchText={searchText}
+            onEditChange={setEditText}
+            onStartEdit={handleStartEdit}
+            onSaveEdit={handleSaveEdit}
+            onCancelEdit={handleCancelEdit}
+            onCopy={handleCopy}
+            onDelete={handleDelete}
+            onToggleFavorite={handleToggleFavorite}
+          />
         </div>
       </div>
 
-      {/* ─── 新建标题弹窗 ─── */}
-      <AntModal
-        title="新建标题"
+      {/* 新建标题弹窗 */}
+      <CreateTitleModal
         open={createTitleModalOpen}
-        onCancel={() => setCreateTitleModalOpen(false)}
-        onOk={handleCreateTitle}
-        okText="创建"
-        cancelText="取消"
-        destroyOnClose
-      >
-        <div
-          style={{
-            display: "flex",
-            flexDirection: "column",
-            gap: 16,
-            padding: "8px 0",
-          }}
-        >
-          <div>
-            <div
-              style={{
-                marginBottom: 6,
-                fontSize: "var(--font-size-sm)",
-                color: "var(--text-secondary)",
-              }}
-            >
-              标题内容
-            </div>
-            <Input.TextArea
-              placeholder="请输入标题内容"
-              value={newTitleContent}
-              onChange={(e) => setNewTitleContent(e.target.value)}
-              rows={3}
-              maxLength={200}
-              showCount
-            />
-          </div>
-          <div>
-            <div
-              style={{
-                marginBottom: 6,
-                fontSize: "var(--font-size-sm)",
-                color: "var(--text-secondary)",
-              }}
-            >
-              标题类型
-            </div>
-            <Select
-              value={newTitleType}
-              onChange={(v) => setNewTitleType(v)}
-              style={{ width: "100%" }}
-              options={[
-                { value: "hot", label: "爆款" },
-                { value: "normal", label: "常规" },
-                { value: "creative", label: "创意" },
-              ]}
-            />
-          </div>
-        </div>
-      </AntModal>
+        newTitleContent={newTitleContent}
+        newTitleType={newTitleType}
+        onContentChange={setNewTitleContent}
+        onTypeChange={setNewTitleType}
+        onCancel={handleCloseCreateModal}
+        onSubmit={handleCreateTitle}
+      />
 
-      {/* ─── AI 生成标题弹窗 ─── */}
-      <AntModal
-        title="AI 生成标题"
+      {/* AI 生成标题弹窗 */}
+      <AIGenerateModal
         open={aiModalOpen}
-        onCancel={() => {
-          setAiModalOpen(false)
-          setAiLoading(false)
-          setAiResults([])
-          setAiKeyword("")
-        }}
-        onOk={handleAIGenerate}
-        okText={aiLoading ? "生成中..." : "生成"}
-        cancelText="关闭"
-        okButtonProps={{ disabled: aiLoading }}
-        destroyOnClose
-        width={640}
-      >
-        <div
-          style={{
-            display: "flex",
-            flexDirection: "column",
-            gap: 16,
-            padding: "8px 0",
-          }}
-        >
-          <div>
-            <div
-              style={{
-                marginBottom: 6,
-                fontSize: "var(--font-size-sm)",
-                color: "var(--text-secondary)",
-              }}
-            >
-              输入关键词或主题
-            </div>
-            <Input
-              placeholder="例如：美食探店、科技评测、旅行攻略..."
-              value={aiKeyword}
-              onChange={(e) => setAiKeyword(e.target.value)}
-              maxLength={100}
-              onPressEnter={handleAIGenerate}
-            />
-          </div>
-
-          {/* AI 加载动画 */}
-          {aiLoading && (
-            <div className="xx-ai-loading">
-              <div className="xx-ai-loading-dots">
-                <div className="xx-ai-loading-dot" />
-                <div className="xx-ai-loading-dot" />
-                <div className="xx-ai-loading-dot" />
-              </div>
-              <span>AI 正在生成标题候选...</span>
-            </div>
-          )}
-
-          {/* AI 生成结果列表 */}
-          {aiResults.length > 0 && (
-            <div className="xx-ai-results">
-              <div
-                style={{
-                  fontSize: "var(--font-size-sm)",
-                  color: "var(--text-secondary)",
-                  marginBottom: 4,
-                }}
-              >
-                已生成 {aiResults.length} 个候选标题，点击采纳或复制：
-              </div>
-              {aiResults.map((text, idx) => (
-                <div key={idx} className="xx-ai-result-item">
-                  <span className="xx-ai-result-text">{text}</span>
-                  <div className="xx-ai-result-actions">
-                    <Button
-                      buttonType="ghost"
-                      buttonSize="sm"
-                      icon={<CopyOutlined />}
-                      onClick={() => handleCopyAI(text)}
-                    >
-                      复制
-                    </Button>
-                    <Button
-                      buttonType="primary"
-                      buttonSize="sm"
-                      icon={<CheckOutlined />}
-                      onClick={() => handleAdoptAITitle(text)}
-                    >
-                      采纳
-                    </Button>
-                  </div>
-                </div>
-              ))}
-            </div>
-          )}
-        </div>
-      </AntModal>
+        aiKeyword={aiKeyword}
+        aiLoading={aiLoading}
+        aiResults={aiResults}
+        onKeywordChange={setAiKeyword}
+        onGenerate={handleAIGenerate}
+        onCancel={handleCloseAIModal}
+        onCopy={handleCopyAI}
+        onAdopt={handleAdoptAITitle}
+      />
     </div>
   )
 }
diff --git a/apps/web/src/pages/titles/components/title-library/AIGenerateModal.tsx b/apps/web/src/pages/titles/components/title-library/AIGenerateModal.tsx
new file mode 100644
index 000000000..f2bb4333a
--- /dev/null
+++ b/apps/web/src/pages/titles/components/title-library/AIGenerateModal.tsx
@@ -0,0 +1,121 @@
+import React from "react"
+import { Modal as AntModal } from "antd"
+import { CopyOutlined, CheckOutlined } from "@ant-design/icons"
+import { Button, Input } from "@/components/ui"
+import { AI_KEYWORD_MAX_LENGTH } from "../../constants/titleLibrary"
+
+interface AIGenerateModalProps {
+  open: boolean
+  aiKeyword: string
+  aiLoading: boolean
+  aiResults: string[]
+  onKeywordChange: (keyword: string) => void
+  onGenerate: () => void
+  onCancel: () => void
+  onCopy: (text: string) => void
+  onAdopt: (text: string) => void
+}
+
+export const AIGenerateModal: React.FC<AIGenerateModalProps> = ({
+  open,
+  aiKeyword,
+  aiLoading,
+  aiResults,
+  onKeywordChange,
+  onGenerate,
+  onCancel,
+  onCopy,
+  onAdopt,
+}) => {
+  return (
+    <AntModal
+      title="AI 生成标题"
+      open={open}
+      onCancel={onCancel}
+      onOk={onGenerate}
+      okText={aiLoading ? "生成中..." : "生成"}
+      cancelText="关闭"
+      okButtonProps={{ disabled: aiLoading }}
+      destroyOnClose
+      width={640}
+    >
+      <div
+        style={{
+          display: "flex",
+          flexDirection: "column",
+          gap: 16,
+          padding: "8px 0",
+        }}
+      >
+        <div>
+          <div
+            style={{
+              marginBottom: 6,
+              fontSize: "var(--font-size-sm)",
+              color: "var(--text-secondary)",
+            }}
+          >
+            输入关键词或主题
+          </div>
+          <Input
+            placeholder="例如：美食探店、科技评测、旅行攻略..."
+            value={aiKeyword}
+            onChange={(e) => onKeywordChange(e.target.value)}
+            maxLength={AI_KEYWORD_MAX_LENGTH}
+            onPressEnter={onGenerate}
+          />
+        </div>
+
+        {/* AI 加载动画 */}
+        {aiLoading && (
+          <div className="xx-ai-loading">
+            <div className="xx-ai-loading-dots">
+              <div className="xx-ai-loading-dot" />
+              <div className="xx-ai-loading-dot" />
+              <div className="xx-ai-loading-dot" />
+            </div>
+            <span>AI 正在生成标题候选...</span>
+          </div>
+        )}
+
+        {/* AI 生成结果列表 */}
+        {aiResults.length > 0 && (
+          <div className="xx-ai-results">
+            <div
+              style={{
+                fontSize: "var(--font-size-sm)",
+                color: "var(--text-secondary)",
+                marginBottom: 4,
+              }}
+            >
+              已生成 {aiResults.length} 个候选标题，点击采纳或复制：
+            </div>
+            {aiResults.map((text, idx) => (
+              <div key={idx} className="xx-ai-result-item">
+                <span className="xx-ai-result-text">{text}</span>
+                <div className="xx-ai-result-actions">
+                  <Button
+                    buttonType="ghost"
+                    buttonSize="sm"
+                    icon={<CopyOutlined />}
+                    onClick={() => onCopy(text)}
+                  >
+                    复制
+                  </Button>
+                  <Button
+                    buttonType="primary"
+                    buttonSize="sm"
+                    icon={<CheckOutlined />}
+                    onClick={() => onAdopt(text)}
+                  >
+                    采纳
+                  </Button>
+                </div>
+              </div>
+            ))}
+          </div>
+        )}
+      </div>
+    </AntModal>
+  )
+}
diff --git a/apps/web/src/pages/titles/components/title-library/CategorySidebar.tsx b/apps/web/src/pages/titles/components/title-library/CategorySidebar.tsx
new file mode 100644
index 000000000..a602823ad
--- /dev/null
+++ b/apps/web/src/pages/titles/components/title-library/CategorySidebar.tsx
@@ -0,0 +1,44 @@
+import React from "react"
+import { FileTextOutlined } from "@ant-design/icons"
+import type { CategoryItem } from "../../types/titleLibrary"
+
+interface CategorySidebarProps {
+  categories: CategoryItem[]
+  activeCatId: string
+  onSelect: (catId: string) => void
+}
+
+export const CategorySidebar: React.FC<CategorySidebarProps> = ({
+  categories,
+  activeCatId,
+  onSelect,
+}) => {
+  return (
+    <div className="xx-title-category-list">
+      {categories.map((cat) => (
+        <div
+          key={cat.id}
+          className={`xx-title-category-item${cat.id === activeCatId ? " active" : ""}`}
+          onClick={() => onSelect(cat.id)}
+        >
+          <div
+            style={{
+              display: "flex",
+              alignItems: "center",
+              justifyContent: "space-between",
+              flex: 1,
+              minWidth: 0,
+            }}
+          >
+            <div style={{ minWidth: 0 }}>
+              <h4 style={{ margin: 0 }}>
+                <FileTextOutlined /> {cat.name}
+              </h4>
+              <span>{cat.count} 条</span>
+            </div>
+          </div>
+        </div>
+      ))}
+    </div>
+  )
+}
diff --git a/apps/web/src/pages/titles/components/title-library/CreateTitleModal.tsx b/apps/web/src/pages/titles/components/title-library/CreateTitleModal.tsx
new file mode 100644
index 000000000..35f13e6f6
--- /dev/null
+++ b/apps/web/src/pages/titles/components/title-library/CreateTitleModal.tsx
@@ -0,0 +1,89 @@
+import React from "react"
+import { Modal as AntModal } from "antd"
+import { Input, Select } from "@/components/ui"
+import type { TitleType } from "../../types/titleLibrary"
+import { TITLE_MAX_LENGTH } from "../../constants/titleLibrary"
+
+const TITLE_TYPE_CREATE_OPTIONS: Array<{ value: TitleType; label: string }> = [
+  { value: "hot", label: "爆款" },
+  { value: "normal", label: "常规" },
+  { value: "creative", label: "创意" },
+]
+
+interface CreateTitleModalProps {
+  open: boolean
+  newTitleContent: string
+  newTitleType: TitleType
+  onContentChange: (content: string) => void
+  onTypeChange: (type: TitleType) => void
+  onCancel: () => void
+  onSubmit: () => void
+}
+
+export const CreateTitleModal: React.FC<CreateTitleModalProps> = ({
+  open,
+  newTitleContent,
+  newTitleType,
+  onContentChange,
+  onTypeChange,
+  onCancel,
+  onSubmit,
+}) => {
+  return (
+    <AntModal
+      title="新建标题"
+      open={open}
+      onCancel={onCancel}
+      onOk={onSubmit}
+      okText="创建"
+      cancelText="取消"
+      destroyOnClose
+    >
+      <div
+        style={{
+          display: "flex",
+          flexDirection: "column",
+          gap: 16,
+          padding: "8px 0",
+        }}
+      >
+        <div>
+          <div
+            style={{
+              marginBottom: 6,
+              fontSize: "var(--font-size-sm)",
+              color: "var(--text-secondary)",
+            }}
+          >
+            标题内容
+          </div>
+          <Input.TextArea
+            placeholder="请输入标题内容"
+            value={newTitleContent}
+            onChange={(e) => onContentChange(e.target.value)}
+            rows={3}
+            maxLength={TITLE_MAX_LENGTH}
+            showCount
+          />
+        </div>
+        <div>
+          <div
+            style={{
+              marginBottom: 6,
+              fontSize: "var(--font-size-sm)",
+              color: "var(--text-secondary)",
+            }}
+          >
+            标题类型
+          </div>
+          <Select
+            value={newTitleType}
+            onChange={(v) => onTypeChange(v as TitleType)}
+            style={{ width: "100%" }}
+            options={TITLE_TYPE_CREATE_OPTIONS}
+          />
+        </div>
+      </div>
+    </AntModal>
+  )
+}
diff --git a/apps/web/src/pages/titles/components/title-library/FilterBar.tsx b/apps/web/src/pages/titles/components/title-library/FilterBar.tsx
new file mode 100644
index 000000000..acedc8c10
--- /dev/null
+++ b/apps/web/src/pages/titles/components/title-library/FilterBar.tsx
@@ -0,0 +1,76 @@
+import React from "react"
+import { SearchOutlined, PlusOutlined, RobotOutlined } from "@ant-design/icons"
+import { Button, Input, Select } from "@/components/ui"
+import type { TitleType, Industry, Frequency } from "../../types/titleLibrary"
+import {
+  TITLE_TYPE_OPTIONS,
+  INDUSTRY_OPTIONS,
+  FREQUENCY_OPTIONS,
+} from "../../constants/titleLibrary"
+
+interface FilterBarProps {
+  searchText: string
+  onSearchChange: (text: string) => void
+  filterType: string
+  onFilterTypeChange: (value: string) => void
+  filterIndustry: string
+  onFilterIndustryChange: (value: string) => void
+  filterFrequency: Frequency
+  onFilterFrequencyChange: (value: Frequency) => void
+  onCreateClick: () => void
+  onAIClick: () => void
+}
+
+export const FilterBar: React.FC<FilterBarProps> = ({
+  searchText,
+  onSearchChange,
+  filterType,
+  onFilterTypeChange,
+  filterIndustry,
+  onFilterIndustryChange,
+  filterFrequency,
+  onFilterFrequencyChange,
+  onCreateClick,
+  onAIClick,
+}) => {
+  return (
+    <div className="xx-titles-filters">
+      <div className="xx-titles-filters-left">
+        <Input
+          placeholder="搜索标题关键词..."
+          prefix={<SearchOutlined />}
+          value={searchText}
+          onChange={(e) => onSearchChange(e.target.value)}
+          allowClear
+          style={{ width: 220 }}
+        />
+        <Select
+          value={filterType}
+          onChange={onFilterTypeChange}
+          style={{ width: 110 }}
+          options={TITLE_TYPE_OPTIONS}
+        />
+        <Select
+          value={filterIndustry}
+          onChange={onFilterIndustryChange}
+          style={{ width: 110 }}
+          options={INDUSTRY_OPTIONS}
+        />
+        <Select
+          value={filterFrequency}
+          onChange={(v) => onFilterFrequencyChange(v as Frequency)}
+          style={{ width: 120 }}
+          options={FREQUENCY_OPTIONS}
+        />
+      </div>
+      <div className="xx-titles-filters-right">
+        <Button buttonType="ghost" buttonSize="sm" icon={<PlusOutlined />} onClick={onCreateClick}>
+          新建标题
+        </Button>
+        <Button buttonType="primary" buttonSize="sm" icon={<RobotOutlined />} onClick={onAIClick}>
+          AI 生成标题
+        </Button>
+      </div>
+    </div>
+  )
+}
diff --git a/apps/web/src/pages/titles/components/title-library/TitleCard.tsx b/apps/web/src/pages/titles/components/title-library/TitleCard.tsx
new file mode 100644
index 000000000..f7b946b40
--- /dev/null
+++ b/apps/web/src/pages/titles/components/title-library/TitleCard.tsx
@@ -0,0 +1,121 @@
+import React from "react"
+import { Popconfirm } from "antd"
+import {
+  StarOutlined,
+  StarFilled,
+  EditOutlined,
+  CopyOutlined,
+  DeleteOutlined,
+  CheckOutlined,
+} from "@ant-design/icons"
+import type { TitleData } from "../../types/titleLibrary"
+import { typeLabel } from "../../utils/titleLibrary"
+
+interface TitleCardProps {
+  title: TitleData
+  isEditing: boolean
+  editText: string
+  onEditChange: (text: string) => void
+  onStartEdit: () => void
+  onSaveEdit: () => void
+  onCancelEdit: () => void
+  onCopy: () => void
+  onDelete: () => void
+  onToggleFavorite: () => void
+}
+
+export const TitleCard: React.FC<TitleCardProps> = ({
+  title,
+  isEditing,
+  editText,
+  onEditChange,
+  onStartEdit,
+  onSaveEdit,
+  onCancelEdit,
+  onCopy,
+  onDelete,
+  onToggleFavorite,
+}) => {
+  return (
+    <div className="xx-title-card">
+      {/* 收藏按钮 */}
+      <button
+        className="xx-title-fav-btn"
+        onClick={onToggleFavorite}
+        title={title.isFavorited ? "取消收藏" : "收藏"}
+        style={{
+          position: "absolute",
+          top: 12,
+          right: 12,
+          color: title.isFavorited ? "#f59e0b" : "var(--text-tertiary)",
+        }}
+      >
+        {title.isFavorited ? <StarFilled /> : <StarOutlined />}
+      </button>
+
+      {/* 标题文本 / 编辑区 */}
+      {isEditing ? (
+        <textarea
+          className="xx-title-card-edit"
+          value={editText}
+          onChange={(e) => onEditChange(e.target.value)}
+          autoFocus
+          onKeyDown={(e) => {
+            if (e.key === "Enter" && !e.shiftKey) {
+              e.preventDefault()
+              onSaveEdit()
+            }
+            if (e.key === "Escape") {
+              onCancelEdit()
+            }
+          }}
+        />
+      ) : (
+        <div className="xx-title-card-text" style={{ paddingRight: 24 }}>
+          {title.content}
+        </div>
+      )}
+
+      {/* 底部元信息 */}
+      <div className="xx-title-card-meta">
+        <div className="xx-title-card-meta-left">
+          <span className={`xx-title-type-tag ${title.type}`}>{typeLabel(title.type)}</span>
+          <span className="xx-title-card-stat">使用 {title.usageCount} 次</span>
+          <span className="xx-title-card-stat">{title.createdAt}</span>
+        </div>
+
+        <div className="xx-title-card-actions">
+          {isEditing ? (
+            <>
+              <button className="xx-title-card-action-btn" onClick={onSaveEdit} title="保存">
+                <CheckOutlined />
+              </button>
+              <button className="xx-title-card-action-btn" onClick={onCancelEdit} title="取消">
+                ✕
+              </button>
+            </>
+          ) : (
+            <>
+              <button className="xx-title-card-action-btn" onClick={onCopy} title="复制">
+                <CopyOutlined />
+              </button>
+              <button className="xx-title-card-action-btn" onClick={onStartEdit} title="编辑">
+                <EditOutlined />
+              </button>
+              <Popconfirm
+                title="确定删除此标题？"
+                onConfirm={onDelete}
+                okText="删除"
+                cancelText="取消"
+              >
+                <button className="xx-title-card-action-btn danger" title="删除">
+                  <DeleteOutlined />
+                </button>
+              </Popconfirm>
+            </>
+          )}
+        </div>
+      </div>
+    </div>
+  )
+}
diff --git a/apps/web/src/pages/titles/components/title-library/TitleGrid.tsx b/apps/web/src/pages/titles/components/title-library/TitleGrid.tsx
new file mode 100644
index 000000000..4102ee857
--- /dev/null
+++ b/apps/web/src/pages/titles/components/title-library/TitleGrid.tsx
@@ -0,0 +1,63 @@
+import React from "react"
+import { FileTextOutlined } from "@ant-design/icons"
+import { TitleCard } from "./TitleCard"
+import type { TitleData } from "../../types/titleLibrary"
+
+interface TitleGridProps {
+  titles: TitleData[]
+  editingId: string | null
+  editText: string
+  searchText: string
+  onEditChange: (text: string) => void
+  onStartEdit: (title: TitleData) => void
+  onSaveEdit: () => void
+  onCancelEdit: () => void
+  onCopy: (title: TitleData) => void
+  onDelete: (id: string) => void
+  onToggleFavorite: (id: string) => void
+}
+
+export const TitleGrid: React.FC<TitleGridProps> = ({
+  titles,
+  editingId,
+  editText,
+  searchText,
+  onEditChange,
+  onStartEdit,
+  onSaveEdit,
+  onCancelEdit,
+  onCopy,
+  onDelete,
+  onToggleFavorite,
+}) => {
+  if (titles.length > 0) {
+    return (
+      <div className="xx-title-grid">
+        {titles.map((title) => (
+          <TitleCard
+            key={title.id}
+            title={title}
+            isEditing={editingId === title.id}
+            editText={editingId === title.id ? editText : ""}
+            onEditChange={onEditChange}
+            onStartEdit={() => onStartEdit(title)}
+            onSaveEdit={onSaveEdit}
+            onCancelEdit={onCancelEdit}
+            onCopy={() => onCopy(title)}
+            onDelete={() => onDelete(title.id)}
+            onToggleFavorite={() => onToggleFavorite(title.id)}
+          />
+        ))}
+      </div>
+    )
+  }
+
+  return (
+    <div className="xx-titles-empty">
+      <div className="xx-titles-empty-icon">
+        <FileTextOutlined />
+      </div>
+      <p>{searchText ? "未找到匹配的标题" : "暂无标题，点击「新建标题」或「AI 生成标题」开始"}</p>
+    </div>
+  )
+}
diff --git a/apps/web/src/pages/titles/constants/titleLibrary.ts b/apps/web/src/pages/titles/constants/titleLibrary.ts
new file mode 100644
index 000000000..8602e5853
--- /dev/null
+++ b/apps/web/src/pages/titles/constants/titleLibrary.ts
@@ -0,0 +1,34 @@
+import type { TitleType, Industry, Frequency } from "../types/titleLibrary"
+
+export const TITLE_TYPE_OPTIONS: Array<{ value: TitleType | "all"; label: string }> = [
+  { value: "all", label: "全部类型" },
+  { value: "hot", label: "爆款" },
+  { value: "normal", label: "常规" },
+  { value: "creative", label: "创意" },
+]
+
+export const INDUSTRY_OPTIONS: Array<{ value: Industry | "all"; label: string }> = [
+  { value: "all", label: "全部行业" },
+  { value: "food", label: "美食" },
+  { value: "tech", label: "科技" },
+  { value: "beauty", label: "美妆" },
+  { value: "education", label: "教育" },
+  { value: "travel", label: "旅行" },
+]
+
+export const FREQUENCY_OPTIONS: Array<{ value: Frequency; label: string }> = [
+  { value: "all", label: "全部频率" },
+  { value: "high", label: "高频使用" },
+  { value: "medium", label: "中频使用" },
+  { value: "low", label: "低频使用" },
+]
+
+export const FREQUENCY_THRESHOLDS = {
+  high: 100,
+  medium: 30,
+} as const
+
+export const AI_GENERATE_DELAY = 2000
+export const TITLE_MAX_LENGTH = 200
+export const AI_KEYWORD_MAX_LENGTH = 100
+export const ALL_CATEGORY_ID = "cat-all"
diff --git a/apps/web/src/pages/titles/hooks/useTitleAI.ts b/apps/web/src/pages/titles/hooks/useTitleAI.ts
new file mode 100644
index 000000000..ed0b19dad
--- /dev/null
+++ b/apps/web/src/pages/titles/hooks/useTitleAI.ts
@@ -0,0 +1,83 @@
+import { useState, useCallback } from "react"
+import { message } from "antd"
+import type { UseMutationResult } from "@tanstack/react-query"
+import { copyToClipboard } from "../utils/titleLibrary"
+import { AI_GENERATE_DELAY } from "../constants/titleLibrary"
+
+interface UseTitleAIProps {
+  createMutation: UseMutationResult<void, Error, string, unknown>
+}
+
+const generateMockTitles = (keyword: string): string[] => [
+  `${keyword}：这个方法让我事半功倍！`,
+  `关于${keyword}，99%的人都不知道的事`,
+  `${keyword}全攻略，看完这篇就够了`,
+  `我花了 3 个月研究${keyword}，总结出这些经验`,
+  `${keyword}避坑指南，帮你省下 1000 块`,
+]
+
+export const useTitleAI = ({ createMutation }: UseTitleAIProps) => {
+  const [aiModalOpen, setAiModalOpen] = useState(false)
+  const [aiKeyword, setAiKeyword] = useState("")
+  const [aiLoading, setAiLoading] = useState(false)
+  const [aiResults, setAiResults] = useState<string[]>([])
+
+  /* AI 生成标题 */
+  const handleAIGenerate = useCallback(() => {
+    if (!aiKeyword.trim()) {
+      message.warning("请输入关键词或主题")
+      return
+    }
+    setAiLoading(true)
+    setAiResults([])
+
+    setTimeout(() => {
+      const results = generateMockTitles(aiKeyword.trim())
+      setAiResults(results)
+      setAiLoading(false)
+    }, AI_GENERATE_DELAY)
+  }, [aiKeyword])
+
+  /* 采纳 AI 生成的标题 */
+  const handleAdoptAITitle = useCallback(
+    (text: string) => {
+      createMutation.mutate(text, {
+        onSuccess: () => {
+          message.success("标题已采纳并添加到标题库")
+        },
+      })
+    },
+    [createMutation],
+  )
+
+  /* 复制 AI 生成的标题 */
+  const handleCopyAI = useCallback(async (text: string) => {
+    const ok = await copyToClipboard(text)
+    if (ok) {
+      message.success("已复制到剪贴板")
+    } else {
+      message.error("复制失败")
+    }
+  }, [])
+
+  /* 关闭 AI 弹窗 */
+  const handleCloseAIModal = useCallback(() => {
+    setAiModalOpen(false)
+    setAiLoading(false)
+    setAiResults([])
+    setAiKeyword("")
+  }, [])
+
+  return {
+    aiModalOpen,
+    setAiModalOpen,
+    aiKeyword,
+    setAiKeyword,
+    aiLoading,
+    aiResults,
+    handleAIGenerate,
+    handleAdoptAITitle,
+    handleCopyAI,
+    handleCloseAIModal,
+  }
+}
diff --git a/apps/web/src/pages/titles/hooks/useTitleEdit.ts b/apps/web/src/pages/titles/hooks/useTitleEdit.ts
new file mode 100644
index 000000000..21a452a05
--- /dev/null
+++ b/apps/web/src/pages/titles/hooks/useTitleEdit.ts
@@ -0,0 +1,86 @@
+import { useState, useCallback } from "react"
+import { message } from "antd"
+import type { TitleData, TitleType } from "../types/titleLibrary"
+import type { UseMutationResult } from "@tanstack/react-query"
+
+interface UseTitleEditProps {
+  updateMutation: UseMutationResult<void, Error, { id: string; content: string }, unknown>
+  createMutation: UseMutationResult<void, Error, string, unknown>
+}
+
+export const useTitleEdit = ({ updateMutation, createMutation }: UseTitleEditProps) => {
+  /* 编辑状态 */
+  const [editingId, setEditingId] = useState<string | null>(null)
+  const [editText, setEditText] = useState("")
+
+  /* 新建标题弹窗 */
+  const [createTitleModalOpen, setCreateTitleModalOpen] = useState(false)
+  const [newTitleContent, setNewTitleContent] = useState("")
+  const [newTitleType, setNewTitleType] = useState<TitleType>("normal")
+
+  /* 开始编辑 */
+  const handleStartEdit = useCallback((title: TitleData) => {
+    setEditingId(title.id)
+    setEditText(title.content)
+  }, [])
+
+  /* 保存编辑 */
+  const handleSaveEdit = useCallback(() => {
+    if (!editText.trim()) {
+      message.warning("标题内容不能为空")
+      return
+    }
+    if (editingId) {
+      updateMutation.mutate({ id: editingId, content: editText.trim() })
+    }
+    setEditingId(null)
+    setEditText("")
+    message.success("标题已更新")
+  }, [editingId, editText, updateMutation])
+
+  /* 取消编辑 */
+  const handleCancelEdit = useCallback(() => {
+    setEditingId(null)
+    setEditText("")
+  }, [])
+
+  /* 新建标题提交 */
+  const handleCreateTitle = useCallback(() => {
+    if (!newTitleContent.trim()) {
+      message.warning("请输入标题内容")
+      return
+    }
+    createMutation.mutate(newTitleContent.trim(), {
+      onSuccess: () => {
+        setCreateTitleModalOpen(false)
+        setNewTitleContent("")
+        setNewTitleType("normal")
+        message.success("标题创建成功")
+      },
+    })
+  }, [newTitleContent, newTitleType, createMutation])
+
+  /* 关闭新建弹窗 */
+  const handleCloseCreateModal = useCallback(() => {
+    setCreateTitleModalOpen(false)
+    setNewTitleContent("")
+    setNewTitleType("normal")
+  }, [])
+
+  return {
+    editingId,
+    editText,
+    setEditText,
+    createTitleModalOpen,
+    setCreateTitleModalOpen,
+    newTitleContent,
+    setNewTitleContent,
+    newTitleType,
+    setNewTitleType,
+    handleStartEdit,
+    handleSaveEdit,
+    handleCancelEdit,
+    handleCreateTitle,
+    handleCloseCreateModal,
+  }
+}
diff --git a/apps/web/src/pages/titles/hooks/useTitleLibrary.ts b/apps/web/src/pages/titles/hooks/useTitleLibrary.ts
new file mode 100644
index 000000000..3b5922df0
--- /dev/null
+++ b/apps/web/src/pages/titles/hooks/useTitleLibrary.ts
@@ -0,0 +1,174 @@
+import { useMemo, useState, useCallback } from "react"
+import { message } from "antd"
+import { useQuery, useMutation, useQueryClient } from "@tanstack/react-query"
+import { getTitles, createTitle, updateTitle, deleteTitle } from "@/api/titles"
+import type { TitleData, CategoryItem, Frequency } from "../types/titleLibrary"
+import { toTitleData, copyToClipboard } from "../utils/titleLibrary"
+import { ALL_CATEGORY_ID, FREQUENCY_THRESHOLDS } from "../constants/titleLibrary"
+
+export const useTitleLibrary = () => {
+  const queryClient = useQueryClient()
+
+  /* 分类 */
+  const [activeCatId, setActiveCatId] = useState<string>(ALL_CATEGORY_ID)
+
+  /* 数据获取 */
+  const { data: apiTitles = [] } = useQuery({
+    queryKey: ["titles"],
+    queryFn: getTitles,
+    staleTime: 30_000,
+  })
+
+  const titles: TitleData[] = useMemo(() => apiTitles.map(toTitleData), [apiTitles])
+
+  /* 动态派生分类 */
+  const categories: CategoryItem[] = useMemo(() => {
+    const cats = new Map<string, number>()
+    apiTitles.forEach((t) => {
+      const cat = t.category || "未分类"
+      cats.set(cat, (cats.get(cat) || 0) + 1)
+    })
+    return [
+      { id: ALL_CATEGORY_ID, name: "全部标题", count: apiTitles.length },
+      ...Array.from(cats.entries()).map(([name, count]) => ({
+        id: `cat-${name}`,
+        name,
+        count,
+      })),
+    ]
+  }, [apiTitles])
+
+  /* CRUD mutations */
+  const createMutation = useMutation({
+    mutationFn: (content: string) => createTitle({ content }),
+    onSuccess: () => {
+      queryClient.invalidateQueries({ queryKey: ["titles"] })
+    },
+    onError: () => message.error("创建标题失败"),
+  })
+
+  const updateMutation = useMutation({
+    mutationFn: ({ id, content }: { id: string; content: string }) => updateTitle(id, { content }),
+    onSuccess: () => {
+      queryClient.invalidateQueries({ queryKey: ["titles"] })
+    },
+    onError: () => message.error("更新标题失败"),
+  })
+
+  const deleteMutation = useMutation({
+    mutationFn: (id: string) => deleteTitle(id),
+    onSuccess: () => {
+      queryClient.invalidateQueries({ queryKey: ["titles"] })
+    },
+    onError: () => message.error("删除标题失败"),
+  })
+
+  /* 筛选状态 */
+  const [searchText, setSearchText] = useState("")
+  const [filterType, setFilterType] = useState<string>("all")
+  const [filterIndustry, setFilterIndustry] = useState<string>("all")
+  const [filterFrequency, setFilterFrequency] = useState<Frequency>("all")
+
+  /* 派生：筛选后的标题列表 */
+  const activeCategory = categories.find((c) => c.id === activeCatId)
+
+  const filteredTitles = useMemo(() => {
+    let list = titles
+
+    /* 按分类过滤 */
+    if (activeCatId !== ALL_CATEGORY_ID) {
+      const catName = activeCategory?.name || ""
+      if (catName) {
+        list = list.filter((t) => t.category === catName)
+      }
+    }
+
+    /* 按类型筛选 */
+    if (filterType !== "all") {
+      list = list.filter((t) => t.type === filterType)
+    }
+
+    /* 按行业筛选 */
+    if (filterIndustry !== "all") {
+      list = list.filter((t) => t.industry === filterIndustry)
+    }
+
+    /* 按使用频率筛选 */
+    if (filterFrequency !== "all") {
+      switch (filterFrequency) {
+        case "high":
+          list = list.filter((t) => t.usageCount >= FREQUENCY_THRESHOLDS.high)
+          break
+        case "medium":
+          list = list.filter(
+            (t) =>
+              t.usageCount >= FREQUENCY_THRESHOLDS.medium &&
+              t.usageCount < FREQUENCY_THRESHOLDS.high,
+          )
+          break
+        case "low":
+          list = list.filter((t) => t.usageCount < FREQUENCY_THRESHOLDS.medium)
+          break
+      }
+    }
+
+    /* 搜索 */
+    if (searchText.trim()) {
+      const q = searchText.trim().toLowerCase()
+      list = list.filter((t) => t.content.toLowerCase().includes(q))
+    }
+
+    return list
+  }, [titles, activeCatId, activeCategory, filterType, filterIndustry, filterFrequency, searchText])
+
+  /* 操作：收藏 */
+  const handleToggleFavorite = useCallback((_id: string) => {
+    message.info("收藏功能即将上线")
+  }, [])
+
+  /* 操作：复制 */
+  const handleCopy = useCallback(async (title: TitleData) => {
+    const ok = await copyToClipboard(title.content)
+    if (ok) {
+      message.success("已复制到剪贴板")
+    } else {
+      message.error("复制失败")
+    }
+  }, [])
+
+  /* 操作：删除 */
+  const handleDelete = useCallback(
+    (id: string) => {
+      deleteMutation.mutate(id)
+      message.success("标题已删除")
+    },
+    [deleteMutation],
+  )
+
+  return {
+    /* 状态 */
+    titles,
+    categories,
+    activeCatId,
+    activeCategory,
+    filteredTitles,
+    searchText,
+    filterType,
+    filterIndustry,
+    filterFrequency,
+    /* mutations */
+    createMutation,
+    updateMutation,
+    deleteMutation,
+    /* setters */
+    setActiveCatId,
+    setSearchText,
+    setFilterType,
+    setFilterIndustry,
+    setFilterFrequency,
+    /* handlers */
+    handleToggleFavorite,
+    handleCopy,
+    handleDelete,
+  }
+}
diff --git a/apps/web/src/pages/titles/types/titleLibrary.ts b/apps/web/src/pages/titles/types/titleLibrary.ts
new file mode 100644
index 000000000..3ba1030f2
--- /dev/null
+++ b/apps/web/src/pages/titles/types/titleLibrary.ts
@@ -0,0 +1,20 @@
+export type TitleType = "hot" | "normal" | "creative"
+export type Industry = "general" | "food" | "tech" | "beauty" | "education" | "travel"
+export type Frequency = "all" | "high" | "medium" | "low"
+
+export interface TitleData {
+  id: string
+  content: string
+  type: TitleType
+  industry: Industry
+  category: string
+  usageCount: number
+  isFavorited: boolean
+  createdAt: string
+}
+
+export interface CategoryItem {
+  id: string
+  name: string
+  count: number
+}
diff --git a/apps/web/src/pages/titles/utils/titleLibrary.ts b/apps/web/src/pages/titles/utils/titleLibrary.ts
new file mode 100644
index 000000000..4b4566b47
--- /dev/null
+++ b/apps/web/src/pages/titles/utils/titleLibrary.ts
@@ -0,0 +1,49 @@
+import type { TitleData, TitleType } from "../types/titleLibrary"
+import type { TitleItem } from "@/api/titles"
+
+export const typeLabel = (type: TitleType): string => {
+  switch (type) {
+    case "hot":
+      return "爆款"
+    case "normal":
+      return "常规"
+    case "creative":
+      return "创意"
+  }
+}
+
+/** 后端 TitleItem → 前端 TitleData 映射 */
+export const toTitleData = (item: TitleItem): TitleData => ({
+  id: item.id,
+  content: item.content,
+  type: (item.category as TitleType) || "normal",
+  industry: "general",
+  category: item.category || "未分类",
+  usageCount: 0,
+  isFavorited: false,
+  createdAt: item.created_at?.slice(0, 10) || "",
+})
+
+/** 复制文本到剪贴板 */
+export const copyToClipboard = async (text: string): Promise<boolean> => {
+  try {
+    await navigator.clipboard.writeText(text)
+    return true
+  } catch {
+    /* 降级方案 */
+    const textarea = document.createElement("textarea")
+    textarea.value = text
+    textarea.style.position = "fixed"
+    textarea.style.opacity = "0"
+    document.body.appendChild(textarea)
+    textarea.select()
+    try {
+      document.execCommand("copy")
+      return true
+    } catch {
+      return false
+    } finally {
+      document.body.removeChild(textarea)
+    }
+  }
+}
diff --git a/apps/web/src/test/pages/TitleLibrary.test.tsx b/apps/web/src/test/pages/TitleLibrary.test.tsx
index 29319a0b3..964a2767c 100644
--- a/apps/web/src/test/pages/TitleLibrary.test.tsx
+++ b/apps/web/src/test/pages/TitleLibrary.test.tsx
@@ -65,6 +65,18 @@ vi.mock("@/store/authStore", () => ({
 vi.mock("@/pages/titles/titles.css", () => ({}))
 
 import TitleLibrary from "@/pages/titles/TitleLibrary"
+import "@/pages/titles/types/titleLibrary"
+import "@/pages/titles/constants/titleLibrary"
+import "@/pages/titles/utils/titleLibrary"
+import "@/pages/titles/hooks/useTitleLibrary"
+import "@/pages/titles/hooks/useTitleEdit"
+import "@/pages/titles/hooks/useTitleAI"
+import "@/pages/titles/components/title-library/TitleCard"
+import "@/pages/titles/components/title-library/CategorySidebar"
+import "@/pages/titles/components/title-library/FilterBar"
+import "@/pages/titles/components/title-library/TitleGrid"
+import "@/pages/titles/components/title-library/CreateTitleModal"
+import "@/pages/titles/components/title-library/AIGenerateModal"
 
 describe("TitleLibrary Page", () => {
   it("should render without crashing", () => {
-- 
2.54.0


From c34b3b2c5ccb89564be619819c449424778b0caf Mon Sep 17 00:00:00 2001
From: xiaoxia <dev@xiaoxiajianji.com>
Date: Mon, 27 Jul 2026 18:15:18 +0800
Subject: [PATCH 2/5] fix: remove unused imports

---
 .../src/pages/titles/components/title-library/FilterBar.tsx   | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/apps/web/src/pages/titles/components/title-library/FilterBar.tsx b/apps/web/src/pages/titles/components/title-library/FilterBar.tsx
index acedc8c10..f9161e389 100644
--- a/apps/web/src/pages/titles/components/title-library/FilterBar.tsx
+++ b/apps/web/src/pages/titles/components/title-library/FilterBar.tsx
@@ -1,7 +1,7 @@
 import React from "react"
 import { SearchOutlined, PlusOutlined, RobotOutlined } from "@ant-design/icons"
 import { Button, Input, Select } from "@/components/ui"
-import type { TitleType, Industry, Frequency } from "../../types/titleLibrary"
+import type {Frequency} from "../../types/titleLibrary"
 import {
   TITLE_TYPE_OPTIONS,
   INDUSTRY_OPTIONS,
@@ -73,4 +73,4 @@ export const FilterBar: React.FC<FilterBarProps> = ({
       </div>
     </div>
   )
-}
+}
\ No newline at end of file
-- 
2.54.0


From dd669f6ad946b26f9b667203ae5f297c7f3d6aea Mon Sep 17 00:00:00 2001
From: xiaoxia <dev@xiaoxiajianji.com>
Date: Mon, 27 Jul 2026 18:34:59 +0800
Subject: [PATCH 3/5] fix: useTitleEdit mutation return type void -> TitleItem

---
 apps/web/src/pages/titles/hooks/useTitleEdit.ts | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/apps/web/src/pages/titles/hooks/useTitleEdit.ts b/apps/web/src/pages/titles/hooks/useTitleEdit.ts
index 21a452a05..40c11ea1d 100644
--- a/apps/web/src/pages/titles/hooks/useTitleEdit.ts
+++ b/apps/web/src/pages/titles/hooks/useTitleEdit.ts
@@ -2,10 +2,11 @@ import { useState, useCallback } from "react"
 import { message } from "antd"
 import type { TitleData, TitleType } from "../types/titleLibrary"
 import type { UseMutationResult } from "@tanstack/react-query"
+import type { TitleItem } from "@/api/titles"
 
 interface UseTitleEditProps {
-  updateMutation: UseMutationResult<void, Error, { id: string; content: string }, unknown>
-  createMutation: UseMutationResult<void, Error, string, unknown>
+  updateMutation: UseMutationResult<TitleItem, Error, { id: string; content: string }, unknown>
+  createMutation: UseMutationResult<TitleItem, Error, string, unknown>
 }
 
 export const useTitleEdit = ({ updateMutation, createMutation }: UseTitleEditProps) => {
-- 
2.54.0


From 71ac73a8893b36bb28e7a3cb22e358ab5a2ce040 Mon Sep 17 00:00:00 2001
From: xiaoxia <dev@xiaoxiajianji.com>
Date: Mon, 27 Jul 2026 18:35:18 +0800
Subject: [PATCH 4/5] fix: useTitleAI mutation return type void -> TitleItem

---
 apps/web/src/pages/titles/hooks/useTitleAI.ts | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/apps/web/src/pages/titles/hooks/useTitleAI.ts b/apps/web/src/pages/titles/hooks/useTitleAI.ts
index ed0b19dad..3544fd735 100644
--- a/apps/web/src/pages/titles/hooks/useTitleAI.ts
+++ b/apps/web/src/pages/titles/hooks/useTitleAI.ts
@@ -1,11 +1,12 @@
 import { useState, useCallback } from "react"
 import { message } from "antd"
 import type { UseMutationResult } from "@tanstack/react-query"
+import type { TitleItem } from "@/api/titles"
 import { copyToClipboard } from "../utils/titleLibrary"
 import { AI_GENERATE_DELAY } from "../constants/titleLibrary"
 
 interface UseTitleAIProps {
-  createMutation: UseMutationResult<void, Error, string, unknown>
+  createMutation: UseMutationResult<TitleItem, Error, string, unknown>
 }
 
 const generateMockTitles = (keyword: string): string[] => [
-- 
2.54.0


From 807606d5f075c074fd48e6117421d179cfa0558b Mon Sep 17 00:00:00 2001
From: xiaoxia <dev@xiaoxiajianji.com>
Date: Mon, 27 Jul 2026 19:01:37 +0800
Subject: [PATCH 5/5] style: prettier format FilterBar.tsx

---
 .../src/pages/titles/components/title-library/FilterBar.tsx   | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/apps/web/src/pages/titles/components/title-library/FilterBar.tsx b/apps/web/src/pages/titles/components/title-library/FilterBar.tsx
index f9161e389..465094b82 100644
--- a/apps/web/src/pages/titles/components/title-library/FilterBar.tsx
+++ b/apps/web/src/pages/titles/components/title-library/FilterBar.tsx
@@ -1,7 +1,7 @@
 import React from "react"
 import { SearchOutlined, PlusOutlined, RobotOutlined } from "@ant-design/icons"
 import { Button, Input, Select } from "@/components/ui"
-import type {Frequency} from "../../types/titleLibrary"
+import type { Frequency } from "../../types/titleLibrary"
 import {
   TITLE_TYPE_OPTIONS,
   INDUSTRY_OPTIONS,
@@ -73,4 +73,4 @@ export const FilterBar: React.FC<FilterBarProps> = ({
       </div>
     </div>
   )
-}
\ No newline at end of file
+}
-- 
2.54.0