From 18a40f037705d16902e8aa8b1d0df4c77b0a2a64 Mon Sep 17 00:00:00 2001
From: SaaS Frontend <saas-frontend@xiaoxia.local>
Date: Sat, 25 Jul 2026 12:48:46 +0800
Subject: [PATCH 1/7] refactor(voices): Phase 2 - extract 7 UI sub-components

Extract 7 sub-components from VoiceLibrary.tsx into separate files:
- VoiceCard: preset voice card with play controls
- CloneVoiceCard: cloned voice card with actions
- CloneDetailModal: clone voice detail modal
- CloneCardSkeleton: skeleton loading for clone cards
- UploadVoiceModal: audio upload modal with drag & drop
- TtsModal: AI TTS synthesis modal
- VoiceFilterBar: search + gender + language filter bar

Main file reduced from 1645 to 798 lines (-51.5%).
All components follow the same controlled pattern with props interfaces.
Functionally equivalent, no behavior changes.

Signed-off-by: xiaoxia <xiaoxia@xiaoxiajianji.com>
---
 apps/web/src/pages/voices/VoiceLibrary.tsx    | 963 ++----------------
 .../voices/components/CloneCardSkeleton.tsx   |  17 +
 .../voices/components/CloneDetailModal.tsx    | 100 ++
 .../voices/components/CloneVoiceCard.tsx      | 180 ++++
 .../voices/components/MaterialVoiceCard.tsx   |  41 +
 .../src/pages/voices/components/TtsModal.tsx  | 264 +++++
 .../voices/components/UploadVoiceModal.tsx    | 329 ++++++
 .../src/pages/voices/components/VoiceCard.tsx | 133 +++
 .../voices/components/VoiceFilterBar.tsx      |  61 ++
 9 files changed, 1183 insertions(+), 905 deletions(-)
 create mode 100755 apps/web/src/pages/voices/components/CloneCardSkeleton.tsx
 create mode 100755 apps/web/src/pages/voices/components/CloneDetailModal.tsx
 create mode 100755 apps/web/src/pages/voices/components/CloneVoiceCard.tsx
 create mode 100755 apps/web/src/pages/voices/components/MaterialVoiceCard.tsx
 create mode 100755 apps/web/src/pages/voices/components/TtsModal.tsx
 create mode 100755 apps/web/src/pages/voices/components/UploadVoiceModal.tsx
 create mode 100755 apps/web/src/pages/voices/components/VoiceCard.tsx
 create mode 100755 apps/web/src/pages/voices/components/VoiceFilterBar.tsx

diff --git a/apps/web/src/pages/voices/VoiceLibrary.tsx b/apps/web/src/pages/voices/VoiceLibrary.tsx
index 6185d6717..a9340ae43 100644
--- a/apps/web/src/pages/voices/VoiceLibrary.tsx
+++ b/apps/web/src/pages/voices/VoiceLibrary.tsx
@@ -61,137 +61,15 @@ import {
 } from "@/pages/voices/utils/format"
 import { getAudioDuration } from "@/pages/voices/utils/audio"
 import CloneModal from "@/components/voice/CloneModal"
+import VoiceCard from "@/pages/voices/components/VoiceCard"
+import CloneVoiceCard from "@/pages/voices/components/CloneVoiceCard"
+import CloneDetailModal from "@/pages/voices/components/CloneDetailModal"
+import CloneCardSkeleton from "@/pages/voices/components/CloneCardSkeleton"
+import UploadVoiceModal from "@/pages/voices/components/UploadVoiceModal"
+import TtsModal, { type TtsStatus } from "@/pages/voices/components/TtsModal"
+import VoiceFilterBar from "@/pages/voices/components/VoiceFilterBar"
 import "./voices.css"
 
-/* ============================================================
- * VoiceCard 组件（预置音色 + 克隆音色统一）
- * ============================================================ */
-interface VoiceCardProps {
-  id: string
-  name: string
-  subtitle: string
-  tags: string[]
-  duration: number
-  gender: VoiceGender
-  isPlaying: boolean
-  isSelected: boolean
-  currentTime: number
-  starred?: boolean
-  status?: "ready" | "processing" | "failed"
-  onPlay: () => void
-  onPause: () => void
-  onSeek: (time: number) => void
-  onSelect?: () => void
-  onToggleStar?: () => void
-}
-
-const VoiceCard: React.FC<VoiceCardProps> = ({
-  id: _id,
-  name,
-  subtitle,
-  tags,
-  duration,
-  gender,
-  isPlaying,
-  isSelected,
-  currentTime,
-  starred,
-  status = "ready",
-  onPlay,
-  onPause,
-  onSeek,
-  onSelect,
-  onToggleStar,
-}) => {
-  const progressRef = useRef<HTMLDivElement>(null)
-
-  const handleProgressClick = (e: React.MouseEvent<HTMLDivElement>) => {
-    if (!progressRef.current || status !== "ready") return
-    const rect = progressRef.current.getBoundingClientRect()
-    const percent = (e.clientX - rect.left) / rect.width
-    onSeek(percent * duration)
-  }
-
-  const progress = duration > 0 ? (currentTime / duration) * 100 : 0
-
-  return (
-    <div
-      className={`xx-voice-card ${genderClass(gender)}${isSelected ? " selected" : ""}${isPlaying ? " playing" : ""}`}
-      onClick={onSelect}
-    >
-      <div className="xx-voice-avatar">
-        <SoundOutlined />
-      </div>
-
-      <div className="xx-voice-info">
-        <div className="xx-voice-name-row">
-          <h4 className="xx-voice-name" title={name}>
-            {name}
-          </h4>
-          {starred !== undefined && (
-            <button
-              className={`xx-voice-star${starred ? " active" : ""}`}
-              onClick={(e) => {
-                e.stopPropagation()
-                onToggleStar?.()
-              }}
-              title={starred ? "取消收藏" : "收藏"}
-            >
-              <HeartOutlined />
-            </button>
-          )}
-        </div>
-        <div className="xx-voice-subtitle">{subtitle}</div>
-        <div className="xx-voice-tags">
-          {tags.slice(0, 3).map((tag) => (
-            <span key={tag} className="xx-voice-tag">
-              {tag}
-            </span>
-          ))}
-        </div>
-      </div>
-
-      {status === "processing" && (
-        <div className="xx-voice-status xx-voice-status--processing">
-          <span className="xx-voice-status-dot" />
-          处理中...
-        </div>
-      )}
-      {status === "failed" && (
-        <div className="xx-voice-status xx-voice-status--failed">克隆失败</div>
-      )}
-
-      {status === "ready" && <div className="xx-voice-wave" />}
-
-      {status === "ready" && (
-        <div className="xx-voice-controls">
-          <button
-            className="xx-voice-play-btn"
-            onClick={(e) => {
-              e.stopPropagation()
-              isPlaying ? onPause() : onPlay()
-            }}
-            title={isPlaying ? "暂停" : "试听"}
-          >
-            {isPlaying ? <PauseCircleOutlined /> : <PlayCircleOutlined />}
-          </button>
-          <div ref={progressRef} className="xx-voice-progress" onClick={handleProgressClick}>
-            <div className="xx-voice-progress-bar" style={{ width: `${progress}%` }} />
-          </div>
-          <span className="xx-voice-time">
-            {isPlaying ? formatTime(currentTime) : formatTime(duration)}
-          </span>
-        </div>
-      )}
-    </div>
-  )
-}
-
-/* ============================================================
- * 克隆音色卡片组件（任务 3.12）
- * ============================================================ */
-
-/** Toast 类型 */
 interface Toast {
   id: number
   message: string
@@ -200,268 +78,7 @@ interface Toast {
 
 let toastIdSeq = 0
 
-/** 克隆音色卡片 */
-interface CloneVoiceCardProps {
-  voice: ClonedVoiceDisplay
-  isPlaying: boolean
-  currentTime: number
-  onPlay: () => void
-  onPause: () => void
-  onUse: () => void
-  onDelete: () => void
-  onRetry: () => void
-  onShowDetail: () => void
-}
 
-const CloneVoiceCard: React.FC<CloneVoiceCardProps> = ({
-  voice,
-  isPlaying,
-  currentTime,
-  onPlay,
-  onPause,
-  onUse,
-  onDelete,
-  onRetry,
-  onShowDetail,
-}) => {
-  const statusCfg = CLONE_STATUS_CONFIG[voice.status]
-  const isFailed = voice.status === "failed"
-  const isProcessing = voice.status === "processing"
-  const genderText =
-    voice.gender === "male" ? "男声" : voice.gender === "female" ? "女声" : voice.gender
-
-  return (
-    <div
-      className={`xx-clone-card${isPlaying ? " playing" : ""}${isFailed ? " failed" : ""}`}
-      onClick={isFailed ? undefined : onShowDetail}
-    >
-      {/* 右上角操作按钮 */}
-      <div className="xx-clone-card-actions">
-        <Tooltip title="删除">
-          <button
-            type="button"
-            className="xx-clone-action-btn xx-clone-action-btn--danger"
-            onClick={(e) => {
-              e.stopPropagation()
-              onDelete()
-            }}
-          >
-            <DeleteOutlined />
-          </button>
-        </Tooltip>
-        {isFailed && (
-          <Tooltip title="重试">
-            <button
-              type="button"
-              className="xx-clone-action-btn"
-              onClick={(e) => {
-                e.stopPropagation()
-                onRetry()
-              }}
-            >
-              <ReloadOutlined />
-            </button>
-          </Tooltip>
-        )}
-      </div>
-
-      {/* 头部：头像 + 名称 + 状态 */}
-      <div className="xx-clone-card-header">
-        <div className={`xx-clone-avatar${isProcessing ? " xx-clone-avatar--processing" : ""}`}>
-          <SoundOutlined />
-        </div>
-        <div className="xx-clone-header-info">
-          <h4 className="xx-clone-name" title={voice.name}>
-            {voice.name}
-          </h4>
-          <span className={`xx-clone-status ${statusCfg.className}`}>
-            <span className="xx-clone-status-dot" />
-            {statusCfg.label}
-          </span>
-        </div>
-      </div>
-
-      {/* 描述 */}
-      {voice.description && <p className="xx-clone-desc">{voice.description}</p>}
-
-      {/* 元信息 */}
-      <div className="xx-clone-meta">
-        {(voice.gender || voice.language) && (
-          <span className="xx-clone-meta-item">
-            <UserOutlined />
-            {genderText}
-            {voice.language ? ` · ${voice.language}` : ""}
-          </span>
-        )}
-        <span className="xx-clone-meta-item">{voice.createdAt}</span>
-      </div>
-
-      {/* 错误信息 */}
-      {isFailed && voice.errorMessage && (
-        <div className="xx-clone-error">
-          <CloseCircleOutlined />
-          <span>{voice.errorMessage}</span>
-        </div>
-      )}
-
-      {/* 底部操作区 */}
-      <div className="xx-clone-footer">
-        {voice.status === "ready" && (
-          <>
-            <button
-              type="button"
-              className="xx-clone-play-btn"
-              onClick={(e) => {
-                e.stopPropagation()
-                isPlaying ? onPause() : onPlay()
-              }}
-              title={isPlaying ? "暂停" : "试听"}
-            >
-              {isPlaying ? <PauseCircleOutlined /> : <PlayCircleOutlined />}
-            </button>
-            <div className="xx-clone-progress">
-              <div
-                className="xx-clone-progress-bar"
-                style={{
-                  width: isPlaying
-                    ? `${Math.min((currentTime / Math.max(voice.duration, 1)) * 100, 100)}%`
-                    : "0%",
-                }}
-              />
-            </div>
-            <button
-              type="button"
-              className="xx-clone-use-btn"
-              onClick={(e) => {
-                e.stopPropagation()
-                onUse()
-              }}
-            >
-              使用
-            </button>
-          </>
-        )}
-        {isProcessing && (
-          <div className="xx-clone-processing-hint">
-            <ReloadOutlined spin />
-            克隆处理中，请稍候...
-          </div>
-        )}
-        {isFailed && (
-          <button
-            type="button"
-            className="xx-clone-retry-btn"
-            onClick={(e) => {
-              e.stopPropagation()
-              onRetry()
-            }}
-          >
-            <ReloadOutlined />
-            重试克隆
-          </button>
-        )}
-      </div>
-    </div>
-  )
-}
-
-/** 克隆音色详情弹窗 */
-const CloneDetailModal: React.FC<{
-  voice: ClonedVoiceDisplay
-  onClose: () => void
-  onUse: () => void
-  onDelete: () => void
-  onRetry: () => void
-}> = ({ voice, onClose, onUse, onDelete, onRetry }) => {
-  const statusCfg = CLONE_STATUS_CONFIG[voice.status]
-  const genderText =
-    voice.gender === "male" ? "男声" : voice.gender === "female" ? "女声" : voice.gender || "未知"
-  const langText = voice.language || "未知"
-
-  return (
-    <div className="xx-clone-detail-overlay" onClick={onClose}>
-      <div className="xx-clone-detail" onClick={(e) => e.stopPropagation()}>
-        <button type="button" className="xx-clone-detail-close" onClick={onClose}>
-          <CloseCircleOutlined />
-        </button>
-
-        <div className="xx-clone-detail-header">
-          <div className="xx-clone-avatar">
-            <SoundOutlined />
-          </div>
-          <div>
-            <h3 className="xx-clone-detail-name">{voice.name}</h3>
-            <span className={`xx-clone-status ${statusCfg.className}`}>
-              <span className="xx-clone-status-dot" />
-              {statusCfg.label}
-            </span>
-          </div>
-        </div>
-
-        {voice.description && <p className="xx-clone-detail-desc">{voice.description}</p>}
-
-        <div className="xx-clone-detail-info">
-          <div className="xx-clone-detail-row">
-            <span className="xx-clone-detail-label">性别</span>
-            <span>{genderText}</span>
-          </div>
-          <div className="xx-clone-detail-row">
-            <span className="xx-clone-detail-label">语言</span>
-            <span>{langText}</span>
-          </div>
-          <div className="xx-clone-detail-row">
-            <span className="xx-clone-detail-label">来源</span>
-            <span>{voice.sourceName}</span>
-          </div>
-          <div className="xx-clone-detail-row">
-            <span className="xx-clone-detail-label">创建时间</span>
-            <span>{voice.createdAt}</span>
-          </div>
-          {voice.errorMessage && (
-            <div className="xx-clone-detail-row" style={{ color: "var(--error-color, #ef4444)" }}>
-              <span className="xx-clone-detail-label">错误</span>
-              <span>{voice.errorMessage}</span>
-            </div>
-          )}
-        </div>
-
-        <div className="xx-clone-detail-actions">
-          {voice.status === "failed" && (
-            <Button buttonType="ghost" buttonSize="sm" icon={<ReloadOutlined />} onClick={onRetry}>
-              重试
-            </Button>
-          )}
-          <Button buttonType="ghost" buttonSize="sm" icon={<DeleteOutlined />} onClick={onDelete}>
-            删除
-          </Button>
-          {voice.status === "ready" && (
-            <Button buttonType="primary" buttonSize="sm" onClick={onUse}>
-              使用此音色
-            </Button>
-          )}
-        </div>
-      </div>
-    </div>
-  )
-}
-
-/** 骨架屏 */
-const CloneCardSkeleton: React.FC = () => (
-  <div className="xx-voice-card xx-skeleton-clone">
-    <div className="xx-skeleton-clone-avatar" />
-    <div className="xx-skeleton-clone-info">
-      <div className="xx-skeleton-clone-line xx-skeleton-clone-line--name" />
-      <div className="xx-skeleton-clone-line xx-skeleton-clone-line--status" />
-      <div className="xx-skeleton-clone-line xx-skeleton-clone-line--desc" />
-      <div className="xx-skeleton-clone-line xx-skeleton-clone-line--meta" />
-      <div className="xx-skeleton-clone-line xx-skeleton-clone-line--footer" />
-    </div>
-  </div>
-)
-
-/* ============================================================
- * 主组件
- * ============================================================ */
 const VoiceLibrary: React.FC = () => {
   const [activeTab, setActiveTab] = useState<TabKey>("preset")
   const [searchText, setSearchText] = useState("")
@@ -491,7 +108,7 @@ const VoiceLibrary: React.FC = () => {
   const [ttsVoiceId, setTtsVoiceId] = useState<string>("")
   const [ttsSpeed, setTtsSpeed] = useState(1.0)
   const [ttsJobId, setTtsJobId] = useState<string | null>(null)
-  const [ttsStatus, setTtsStatus] = useState<"idle" | "synthesizing" | "done" | "error">("idle")
+  const [ttsStatus, setTtsStatus] = useState<TtsStatus>("idle")
   const [ttsAudioUrl, setTtsAudioUrl] = useState<string | null>(null)
   const [ttsError, setTtsError] = useState<string | null>(null)
   const ttsTimerRef = useRef<ReturnType<typeof setInterval> | null>(null)
@@ -874,15 +491,14 @@ const VoiceLibrary: React.FC = () => {
 
       {activeTab === "preset" && (
         <div className="xx-voices-tab-content">
-          <div className="xx-voices-filters">
-            <Input
-              placeholder="搜索音色名称、标签..."
-              prefix={<SearchOutlined />}
-              value={searchText}
-              onChange={(e) => setSearchText(e.target.value)}
-              allowClear
-              style={{ width: 260 }}
-            />
+          <VoiceFilterBar
+            searchText={searchText}
+            filterGender={filterGender}
+            filterLang={filterLang}
+            onSearchChange={setSearchText}
+            onGenderChange={setFilterGender}
+            onLangChange={setFilterLang}
+          />
             <Select
               value={filterGender}
               onChange={setFilterGender}
@@ -1104,313 +720,51 @@ const VoiceLibrary: React.FC = () => {
       )}
 
       {/* ── 上传音频弹窗 ── */}
-      <Modal
-        title="上传音频"
+      <UploadVoiceModal
         open={uploadOpen}
-        onCancel={() => {
-          if (uploadProgress !== null) return // 上传中不可关闭
+        uploadFile={uploadFile}
+        uploadName={uploadName}
+        uploadGender={uploadGender}
+        uploadDesc={uploadDesc}
+        uploadProgress={uploadProgress}
+        onClose={() => {
           setUploadOpen(false)
           setUploadFile(null)
           setUploadName("")
           setUploadDesc("")
         }}
-        footer={null}
-        width={520}
-        maskClosable={uploadProgress === null}
-      >
-        <div
-          style={{
-            display: "flex",
-            flexDirection: "column",
-            gap: 16,
-            padding: "8px 0",
-          }}
-        >
-          {/* 拖拽上传区 */}
-          <Upload.Dragger
-            accept="audio/*"
-            maxCount={1}
-            beforeUpload={(file) => {
-              setUploadFile(file)
-              if (!uploadName) setUploadName(file.name.replace(/\.[^.]+$/, ""))
-              return false
-            }}
-            onRemove={() => {
-              setUploadFile(null)
-              setUploadProgress(null)
-            }}
-            showUploadList={false}
-            disabled={uploadProgress !== null}
-          >
-            <p
-              style={{
-                fontSize: 32,
-                color: "var(--primary-color)",
-                marginBottom: 8,
-              }}
-            >
-              <UploadOutlined />
-            </p>
-            <p style={{ fontSize: 14, fontWeight: 500, margin: "0 0 4px" }}>
-              点击或拖拽音频文件到此处
-            </p>
-            <p
-              style={{
-                fontSize: 12,
-                color: "var(--text-secondary)",
-                margin: 0,
-              }}
-            >
-              支持 MP3、WAV、AAC、FLAC 等格式，最大 200MB
-            </p>
-          </Upload.Dragger>
-
-          {/* 已选文件信息 */}
-          {uploadFile && (
-            <div
-              style={{
-                padding: "10px 12px",
-                background: "var(--bg-secondary)",
-                borderRadius: 8,
-                display: "flex",
-                alignItems: "center",
-                gap: 10,
-              }}
-            >
-              <SoundOutlined style={{ fontSize: 18, color: "var(--primary-color)" }} />
-              <div style={{ flex: 1, minWidth: 0 }}>
-                <div
-                  style={{
-                    fontSize: 13,
-                    fontWeight: 500,
-                    overflow: "hidden",
-                    textOverflow: "ellipsis",
-                    whiteSpace: "nowrap",
-                  }}
-                >
-                  {uploadFile.name}
-                </div>
-                <div style={{ fontSize: 11, color: "var(--text-secondary)" }}>
-                  {formatFileSize(uploadFile.size)}
-                </div>
-              </div>
-            </div>
-          )}
-
-          {/* 上传进度 */}
-          {uploadProgress !== null && (
-            <div style={{ textAlign: "center", padding: "8px 0" }}>
-              <div
-                style={{
-                  fontSize: 22,
-                  fontWeight: 700,
-                  color: "var(--primary-color)",
-                }}
-              >
-                {uploadProgress}%
-              </div>
-              <div style={{ fontSize: 12, color: "var(--text-secondary)" }}>
-                {uploadProgress < 100 ? "上传中..." : "处理中..."}
-              </div>
-              <div
-                style={{
-                  height: 4,
-                  background: "var(--bg-tertiary)",
-                  borderRadius: 2,
-                  marginTop: 8,
-                  overflow: "hidden",
-                }}
-              >
-                <div
-                  style={{
-                    height: "100%",
-                    width: `${uploadProgress}%`,
-                    background: "var(--primary-color)",
-                    borderRadius: 2,
-                    transition: "width 0.3s ease",
-                  }}
-                />
-              </div>
-            </div>
-          )}
-
-          {/* 名称 */}
-          <div>
-            <div
-              style={{
-                fontSize: 13,
-                color: "var(--text-secondary)",
-                marginBottom: 6,
-              }}
-            >
-              素材名称
-            </div>
-            <input
-              value={uploadName}
-              onChange={(e) => setUploadName(e.target.value)}
-              placeholder="输入素材名称"
-              maxLength={100}
-              disabled={uploadProgress !== null}
-              style={{
-                width: "100%",
-                padding: "8px 12px",
-                border: "1px solid var(--border-color)",
-                borderRadius: 8,
-                fontSize: 13,
-                background: "var(--bg-primary)",
-                color: "var(--text-primary)",
-                outline: "none",
-              }}
-            />
-          </div>
-
-          {/* 性别选择 */}
-          <div>
-            <div
-              style={{
-                fontSize: 13,
-                color: "var(--text-secondary)",
-                marginBottom: 6,
-              }}
-            >
-              音色性别
-            </div>
-            <div style={{ display: "flex", gap: 8 }}>
-              {(["female", "male", "child"] as VoiceGender[]).map((g) => (
-                <button
-                  key={g}
-                  type="button"
-                  onClick={() => setUploadGender(g)}
-                  disabled={uploadProgress !== null}
-                  style={{
-                    flex: 1,
-                    padding: "6px 0",
-                    borderRadius: 8,
-                    border: `1px solid ${uploadGender === g ? "var(--primary-color)" : "var(--border-color)"}`,
-                    background: uploadGender === g ? "var(--primary-soft)" : "transparent",
-                    color: uploadGender === g ? "var(--primary-color)" : "var(--text-secondary)",
-                    fontSize: 13,
-                    fontWeight: uploadGender === g ? 600 : 400,
-                    cursor: uploadProgress !== null ? "not-allowed" : "pointer",
-                    transition: "all 0.2s",
-                  }}
-                >
-                  {g === "female" ? "女声" : g === "male" ? "男声" : "童声"}
-                </button>
-              ))}
-            </div>
-          </div>
-
-          {/* 描述 */}
-          <div>
-            <div
-              style={{
-                fontSize: 13,
-                color: "var(--text-secondary)",
-                marginBottom: 6,
-              }}
-            >
-              音色描述（可选）
-            </div>
-            <textarea
-              value={uploadDesc}
-              onChange={(e) => setUploadDesc(e.target.value)}
-              placeholder="描述这个音色的特点..."
-              maxLength={500}
-              rows={2}
-              disabled={uploadProgress !== null}
-              style={{
-                width: "100%",
-                padding: "8px 12px",
-                border: "1px solid var(--border-color)",
-                borderRadius: 8,
-                fontSize: 13,
-                background: "var(--bg-primary)",
-                color: "var(--text-primary)",
-                outline: "none",
-                resize: "vertical",
-                fontFamily: "inherit",
-              }}
-            />
-          </div>
-
-          {/* 操作按钮 */}
-          <div
-            style={{
-              display: "flex",
-              justifyContent: "flex-end",
-              gap: 10,
-              paddingTop: 4,
-            }}
-          >
-            <button
-              type="button"
-              onClick={() => {
-                setUploadOpen(false)
-                setUploadFile(null)
-                setUploadName("")
-                setUploadDesc("")
-              }}
-              disabled={uploadProgress !== null}
-              style={{
-                padding: "8px 20px",
-                borderRadius: 8,
-                border: "1px solid var(--border-color)",
-                background: "transparent",
-                fontSize: 13,
-                cursor: uploadProgress !== null ? "not-allowed" : "pointer",
-                color: "var(--text-secondary)",
-              }}
-            >
-              取消
-            </button>
-            <button
-              type="button"
-              onClick={() => {
-                if (!uploadFile) {
-                  message.warning("请先选择音频文件")
-                  return
-                }
-                if (!uploadName.trim()) {
-                  message.warning("请输入素材名称")
-                  return
-                }
-                uploadMutation.mutate({
-                  file: uploadFile,
-                  name: uploadName.trim(),
-                  gender: uploadGender,
-                  description: uploadDesc.trim(),
-                })
-              }}
-              disabled={!uploadFile || !uploadName.trim() || uploadProgress !== null}
-              style={{
-                padding: "8px 20px",
-                borderRadius: 8,
-                border: "none",
-                background:
-                  !uploadFile || !uploadName.trim() || uploadProgress !== null
-                    ? "var(--text-tertiary)"
-                    : "var(--primary-color)",
-                color: "#fff",
-                fontSize: 13,
-                fontWeight: 600,
-                cursor:
-                  !uploadFile || !uploadName.trim() || uploadProgress !== null
-                    ? "not-allowed"
-                    : "pointer",
-              }}
-            >
-              {uploadProgress !== null ? "上传中..." : "开始上传"}
-            </button>
-          </div>
-        </div>
-      </Modal>
+        onFileSelect={(file) => {
+          setUploadFile(file)
+          if (!uploadName) setUploadName(file.name.replace(/\.[^.]+$/, ""))
+        }}
+        onFileRemove={() => {
+          setUploadFile(null)
+          setUploadProgress(null)
+        }}
+        onNameChange={setUploadName}
+        onGenderChange={setUploadGender}
+        onDescChange={setUploadDesc}
+        onUpload={() =>
+          uploadMutation.mutate({
+            file: uploadFile!,
+            name: uploadName.trim(),
+            gender: uploadGender,
+            description: uploadDesc.trim(),
+          })
+        }
+      />
 
       {/* ── AI 配音弹窗 ── */}
-      <Modal
-        title="AI 配音"
+      <TtsModal
         open={ttsOpen}
-        onCancel={() => {
+        ttsText={ttsText}
+        ttsVoiceId={ttsVoiceId}
+        ttsSpeed={ttsSpeed}
+        ttsStatus={ttsStatus}
+        ttsAudioUrl={ttsAudioUrl}
+        ttsError={ttsError}
+        presetVoices={presetVoices}
+        onClose={() => {
           setTtsOpen(false)
           setTtsText("")
           setTtsVoiceId("")
@@ -1420,213 +774,12 @@ const VoiceLibrary: React.FC = () => {
           setTtsError(null)
           setTtsJobId(null)
         }}
-        footer={null}
-        width={560}
-      >
-        <div
-          style={{
-            display: "flex",
-            flexDirection: "column",
-            gap: 16,
-            padding: "8px 0",
-          }}
-        >
-          {/* 文本输入 */}
-          <div>
-            <div
-              style={{
-                fontSize: 13,
-                color: "var(--text-secondary)",
-                marginBottom: 6,
-              }}
-            >
-              输入文本
-            </div>
-            <textarea
-              value={ttsText}
-              onChange={(e) => setTtsText(e.target.value)}
-              placeholder="输入要配音的文本内容..."
-              maxLength={2000}
-              rows={4}
-              style={{
-                width: "100%",
-                padding: "10px 12px",
-                border: "1px solid var(--border-color)",
-                borderRadius: 8,
-                fontSize: 13,
-                background: "var(--bg-primary)",
-                color: "var(--text-primary)",
-                outline: "none",
-                resize: "vertical",
-                fontFamily: "inherit",
-                lineHeight: 1.6,
-              }}
-            />
-            <div
-              style={{
-                fontSize: 11,
-                color: "var(--text-tertiary)",
-                textAlign: "right",
-                marginTop: 4,
-              }}
-            >
-              {ttsText.length}/2000
-            </div>
-          </div>
-
-          {/* 音色选择 */}
-          <div>
-            <div
-              style={{
-                fontSize: 13,
-                color: "var(--text-secondary)",
-                marginBottom: 6,
-              }}
-            >
-              选择音色
-            </div>
-            <select
-              value={ttsVoiceId}
-              onChange={(e) => setTtsVoiceId(e.target.value)}
-              style={{
-                width: "100%",
-                padding: "8px 12px",
-                border: "1px solid var(--border-color)",
-                borderRadius: 8,
-                fontSize: 13,
-                background: "var(--bg-primary)",
-                color: "var(--text-primary)",
-                outline: "none",
-              }}
-            >
-              <option value="">默认音色</option>
-              {presetVoices.map((v) => (
-                <option key={v.id} value={v.id}>
-                  {v.name} — {genderLabel(v.gender)}
-                </option>
-              ))}
-            </select>
-          </div>
-
-          {/* 语速 */}
-          <div>
-            <div
-              style={{
-                fontSize: 13,
-                color: "var(--text-secondary)",
-                marginBottom: 6,
-              }}
-            >
-              语速：{ttsSpeed.toFixed(1)}x
-            </div>
-            <input
-              type="range"
-              min={0.5}
-              max={2.0}
-              step={0.1}
-              value={ttsSpeed}
-              onChange={(e) => setTtsSpeed(parseFloat(e.target.value))}
-              style={{ width: "100%", accentColor: "var(--primary-color)" }}
-            />
-            <div
-              style={{
-                display: "flex",
-                justifyContent: "space-between",
-                fontSize: 11,
-                color: "var(--text-tertiary)",
-              }}
-            >
-              <span>0.5x</span>
-              <span>1.0x</span>
-              <span>2.0x</span>
-            </div>
-          </div>
-
-          {/* 合成按钮 */}
-          <button
-            type="button"
-            onClick={handleTtsSynthesize}
-            disabled={ttsStatus === "synthesizing" || !ttsText.trim()}
-            style={{
-              width: "100%",
-              padding: "10px 0",
-              borderRadius: 8,
-              border: "none",
-              background:
-                ttsStatus === "synthesizing" || !ttsText.trim()
-                  ? "var(--text-tertiary)"
-                  : "var(--primary-color)",
-              color: "#fff",
-              fontSize: 14,
-              fontWeight: 600,
-              cursor: ttsStatus === "synthesizing" || !ttsText.trim() ? "not-allowed" : "pointer",
-              display: "flex",
-              alignItems: "center",
-              justifyContent: "center",
-              gap: 8,
-            }}
-          >
-            <RobotOutlined />
-            {ttsStatus === "synthesizing" ? "合成中..." : "开始合成"}
-          </button>
-
-          {/* 错误提示 */}
-          {ttsError && (
-            <div
-              style={{
-                padding: "10px 12px",
-                background: "var(--error-soft, #fff2f0)",
-                borderRadius: 8,
-                color: "var(--error-color, #ff4d4f)",
-                fontSize: 13,
-              }}
-            >
-              {ttsError}
-            </div>
-          )}
-
-          {/* 合成结果 */}
-          {ttsStatus === "done" && ttsAudioUrl && (
-            <div
-              style={{
-                padding: 12,
-                background: "var(--bg-secondary)",
-                borderRadius: 8,
-                display: "flex",
-                flexDirection: "column",
-                gap: 10,
-              }}
-            >
-              <div
-                style={{
-                  fontSize: 13,
-                  fontWeight: 500,
-                  color: "var(--success-color, #52c41a)",
-                }}
-              >
-                ✅ 合成完成
-              </div>
-              <audio controls src={ttsAudioUrl} style={{ width: "100%" }} />
-              <button
-                type="button"
-                onClick={handleTtsSave}
-                style={{
-                  padding: "8px 0",
-                  borderRadius: 8,
-                  border: "1px solid var(--primary-color)",
-                  background: "var(--primary-soft)",
-                  color: "var(--primary-color)",
-                  fontSize: 13,
-                  fontWeight: 600,
-                  cursor: "pointer",
-                }}
-              >
-                保存到配音库
-              </button>
-            </div>
-          )}
-        </div>
-      </Modal>
+        onTextChange={setTtsText}
+        onVoiceChange={setTtsVoiceId}
+        onSpeedChange={setTtsSpeed}
+        onSynthesize={handleTtsSynthesize}
+        onSave={handleTtsSave}
+      />
 
       {/* Toast 提示 */}
       {toasts.length > 0 && (
diff --git a/apps/web/src/pages/voices/components/CloneCardSkeleton.tsx b/apps/web/src/pages/voices/components/CloneCardSkeleton.tsx
new file mode 100755
index 000000000..9566f0e5a
--- /dev/null
+++ b/apps/web/src/pages/voices/components/CloneCardSkeleton.tsx
@@ -0,0 +1,17 @@
+import React from "react"
+
+/** 克隆音色卡片骨架屏 */
+const CloneCardSkeleton: React.FC = () => (
+  <div className="xx-voice-card xx-skeleton-clone">
+    <div className="xx-skeleton-clone-avatar" />
+    <div className="xx-skeleton-clone-info">
+      <div className="xx-skeleton-clone-line xx-skeleton-clone-line--name" />
+      <div className="xx-skeleton-clone-line xx-skeleton-clone-line--status" />
+      <div className="xx-skeleton-clone-line xx-skeleton-clone-line--desc" />
+      <div className="xx-skeleton-clone-line xx-skeleton-clone-line--meta" />
+      <div className="xx-skeleton-clone-line xx-skeleton-clone-line--footer" />
+    </div>
+  </div>
+)
+
+export default CloneCardSkeleton
diff --git a/apps/web/src/pages/voices/components/CloneDetailModal.tsx b/apps/web/src/pages/voices/components/CloneDetailModal.tsx
new file mode 100755
index 000000000..e6ac3e25f
--- /dev/null
+++ b/apps/web/src/pages/voices/components/CloneDetailModal.tsx
@@ -0,0 +1,100 @@
+import React from "react"
+import {
+  SoundOutlined,
+  CloseCircleOutlined,
+  ReloadOutlined,
+  DeleteOutlined,
+} from "@ant-design/icons"
+import { Button } from "@/components/ui"
+import { type ClonedVoiceDisplay } from "@/pages/voices/types"
+import { CLONE_STATUS_CONFIG } from "@/pages/voices/constants"
+
+export interface CloneDetailModalProps {
+  voice: ClonedVoiceDisplay
+  onClose: () => void
+  onUse: () => void
+  onDelete: () => void
+  onRetry: () => void
+}
+
+/** 克隆音色详情弹窗 */
+const CloneDetailModal: React.FC<CloneDetailModalProps> = ({
+  voice,
+  onClose,
+  onUse,
+  onDelete,
+  onRetry,
+}) => {
+  const statusCfg = CLONE_STATUS_CONFIG[voice.status]
+  const genderText =
+    voice.gender === "male" ? "男声" : voice.gender === "female" ? "女声" : voice.gender || "未知"
+  const langText = voice.language || "未知"
+
+  return (
+    <div className="xx-clone-detail-overlay" onClick={onClose}>
+      <div className="xx-clone-detail" onClick={(e) => e.stopPropagation()}>
+        <button type="button" className="xx-clone-detail-close" onClick={onClose}>
+          <CloseCircleOutlined />
+        </button>
+
+        <div className="xx-clone-detail-header">
+          <div className="xx-clone-avatar">
+            <SoundOutlined />
+          </div>
+          <div>
+            <h3 className="xx-clone-detail-name">{voice.name}</h3>
+            <span className={`xx-clone-status ${statusCfg.className}`}>
+              <span className="xx-clone-status-dot" />
+              {statusCfg.label}
+            </span>
+          </div>
+        </div>
+
+        {voice.description && <p className="xx-clone-detail-desc">{voice.description}</p>}
+
+        <div className="xx-clone-detail-info">
+          <div className="xx-clone-detail-row">
+            <span className="xx-clone-detail-label">性别</span>
+            <span>{genderText}</span>
+          </div>
+          <div className="xx-clone-detail-row">
+            <span className="xx-clone-detail-label">语言</span>
+            <span>{langText}</span>
+          </div>
+          <div className="xx-clone-detail-row">
+            <span className="xx-clone-detail-label">来源</span>
+            <span>{voice.sourceName}</span>
+          </div>
+          <div className="xx-clone-detail-row">
+            <span className="xx-clone-detail-label">创建时间</span>
+            <span>{voice.createdAt}</span>
+          </div>
+          {voice.errorMessage && (
+            <div className="xx-clone-detail-row" style={{ color: "var(--error-color, #ef4444)" }}>
+              <span className="xx-clone-detail-label">错误</span>
+              <span>{voice.errorMessage}</span>
+            </div>
+          )}
+        </div>
+
+        <div className="xx-clone-detail-actions">
+          {voice.status === "failed" && (
+            <Button buttonType="ghost" buttonSize="sm" icon={<ReloadOutlined />} onClick={onRetry}>
+              重试
+            </Button>
+          )}
+          <Button buttonType="ghost" buttonSize="sm" icon={<DeleteOutlined />} onClick={onDelete}>
+            删除
+          </Button>
+          {voice.status === "ready" && (
+            <Button buttonType="primary" buttonSize="sm" onClick={onUse}>
+              使用此音色
+            </Button>
+          )}
+        </div>
+      </div>
+    </div>
+  )
+}
+
+export default CloneDetailModal
diff --git a/apps/web/src/pages/voices/components/CloneVoiceCard.tsx b/apps/web/src/pages/voices/components/CloneVoiceCard.tsx
new file mode 100755
index 000000000..af8caad1c
--- /dev/null
+++ b/apps/web/src/pages/voices/components/CloneVoiceCard.tsx
@@ -0,0 +1,180 @@
+import React from "react"
+import {
+  SoundOutlined,
+  PlayCircleOutlined,
+  PauseCircleOutlined,
+  DeleteOutlined,
+  ReloadOutlined,
+  CloseCircleOutlined,
+  UserOutlined,
+} from "@ant-design/icons"
+import { Tooltip } from "antd"
+import { type ClonedVoiceDisplay } from "@/pages/voices/types"
+import { CLONE_STATUS_CONFIG } from "@/pages/voices/constants"
+
+export interface CloneVoiceCardProps {
+  voice: ClonedVoiceDisplay
+  isPlaying: boolean
+  currentTime: number
+  onPlay: () => void
+  onPause: () => void
+  onUse: () => void
+  onDelete: () => void
+  onRetry: () => void
+  onShowDetail: () => void
+}
+
+/** 克隆音色卡片 */
+const CloneVoiceCard: React.FC<CloneVoiceCardProps> = ({
+  voice,
+  isPlaying,
+  currentTime,
+  onPlay,
+  onPause,
+  onUse,
+  onDelete,
+  onRetry,
+  onShowDetail,
+}) => {
+  const statusCfg = CLONE_STATUS_CONFIG[voice.status]
+  const isFailed = voice.status === "failed"
+  const isProcessing = voice.status === "processing"
+  const genderText =
+    voice.gender === "male" ? "男声" : voice.gender === "female" ? "女声" : voice.gender
+
+  return (
+    <div
+      className={`xx-clone-card${isPlaying ? " playing" : ""}${isFailed ? " failed" : ""}`}
+      onClick={isFailed ? undefined : onShowDetail}
+    >
+      {/* 右上角操作按钮 */}
+      <div className="xx-clone-card-actions">
+        <Tooltip title="删除">
+          <button
+            type="button"
+            className="xx-clone-action-btn xx-clone-action-btn--danger"
+            onClick={(e) => {
+              e.stopPropagation()
+              onDelete()
+            }}
+          >
+            <DeleteOutlined />
+          </button>
+        </Tooltip>
+        {isFailed && (
+          <Tooltip title="重试">
+            <button
+              type="button"
+              className="xx-clone-action-btn"
+              onClick={(e) => {
+                e.stopPropagation()
+                onRetry()
+              }}
+            >
+              <ReloadOutlined />
+            </button>
+          </Tooltip>
+        )}
+      </div>
+
+      {/* 头部：头像 + 名称 + 状态 */}
+      <div className="xx-clone-card-header">
+        <div className={`xx-clone-avatar${isProcessing ? " xx-clone-avatar--processing" : ""}`}>
+          <SoundOutlined />
+        </div>
+        <div className="xx-clone-header-info">
+          <h4 className="xx-clone-name" title={voice.name}>
+            {voice.name}
+          </h4>
+          <span className={`xx-clone-status ${statusCfg.className}`}>
+            <span className="xx-clone-status-dot" />
+            {statusCfg.label}
+          </span>
+        </div>
+      </div>
+
+      {/* 描述 */}
+      {voice.description && <p className="xx-clone-desc">{voice.description}</p>}
+
+      {/* 元信息 */}
+      <div className="xx-clone-meta">
+        {(voice.gender || voice.language) && (
+          <span className="xx-clone-meta-item">
+            <UserOutlined />
+            {genderText}
+            {voice.language ? ` · ${voice.language}` : ""}
+          </span>
+        )}
+        <span className="xx-clone-meta-item">{voice.createdAt}</span>
+      </div>
+
+      {/* 错误信息 */}
+      {isFailed && voice.errorMessage && (
+        <div className="xx-clone-error">
+          <CloseCircleOutlined />
+          <span>{voice.errorMessage}</span>
+        </div>
+      )}
+
+      {/* 底部操作区 */}
+      <div className="xx-clone-footer">
+        {voice.status === "ready" && (
+          <>
+            <button
+              type="button"
+              className="xx-clone-play-btn"
+              onClick={(e) => {
+                e.stopPropagation()
+                isPlaying ? onPause() : onPlay()
+              }}
+              title={isPlaying ? "暂停" : "试听"}
+            >
+              {isPlaying ? <PauseCircleOutlined /> : <PlayCircleOutlined />}
+            </button>
+            <div className="xx-clone-progress">
+              <div
+                className="xx-clone-progress-bar"
+                style={{
+                  width: isPlaying
+                    ? `${Math.min((currentTime / Math.max(voice.duration, 1)) * 100, 100)}%`
+                    : "0%",
+                }}
+              />
+            </div>
+            <button
+              type="button"
+              className="xx-clone-use-btn"
+              onClick={(e) => {
+                e.stopPropagation()
+                onUse()
+              }}
+            >
+              使用
+            </button>
+          </>
+        )}
+        {isProcessing && (
+          <div className="xx-clone-processing-hint">
+            <ReloadOutlined spin />
+            克隆处理中，请稍候...
+          </div>
+        )}
+        {isFailed && (
+          <button
+            type="button"
+            className="xx-clone-retry-btn"
+            onClick={(e) => {
+              e.stopPropagation()
+              onRetry()
+            }}
+          >
+            <ReloadOutlined />
+            重试克隆
+          </button>
+        )}
+      </div>
+    </div>
+  )
+}
+
+export default CloneVoiceCard
diff --git a/apps/web/src/pages/voices/components/MaterialVoiceCard.tsx b/apps/web/src/pages/voices/components/MaterialVoiceCard.tsx
new file mode 100755
index 000000000..ec52debcd
--- /dev/null
+++ b/apps/web/src/pages/voices/components/MaterialVoiceCard.tsx
@@ -0,0 +1,41 @@
+import React from "react"
+import { AudioOutlined } from "@ant-design/icons"
+import { type AssetItem } from "@/api/assets"
+import { formatFileSize } from "@/pages/voices/utils/format"
+
+export interface MaterialVoiceCardProps {
+  asset: AssetItem
+  onClick?: () => void
+}
+
+/** 配音素材卡片 */
+const MaterialVoiceCard: React.FC<MaterialVoiceCardProps> = ({ asset, onClick }) => {
+  const duration = (asset.metadata?.duration as number) || 0
+  const minutes = Math.floor(duration / 60)
+  const seconds = Math.floor(duration % 60)
+
+  return (
+    <div className="vmat-card" onClick={onClick}>
+      <div className="vmat-thumb">
+        <AudioOutlined className="vmat-thumb-icon" />
+        <span className="vmat-duration">
+          {minutes}:{seconds.toString().padStart(2, "0")}
+        </span>
+      </div>
+      <div className="vmat-info">
+        <div className="vmat-name" title={asset.name}>
+          {asset.name}
+        </div>
+        <div className="vmat-meta">
+          <span>
+            {asset.file_size
+              ? formatFileSize(asset.file_size)
+              : "--"}
+          </span>
+        </div>
+      </div>
+    </div>
+  )
+}
+
+export default MaterialVoiceCard
diff --git a/apps/web/src/pages/voices/components/TtsModal.tsx b/apps/web/src/pages/voices/components/TtsModal.tsx
new file mode 100755
index 000000000..54104bc43
--- /dev/null
+++ b/apps/web/src/pages/voices/components/TtsModal.tsx
@@ -0,0 +1,264 @@
+import React from "react"
+import { RobotOutlined } from "@ant-design/icons"
+import { Modal, message } from "antd"
+import { type PresetVoiceDisplay } from "@/pages/voices/types"
+import { genderLabel } from "@/pages/voices/utils/format"
+
+export type TtsStatus = "idle" | "synthesizing" | "done" | "error"
+
+export interface TtsModalProps {
+  open: boolean
+  ttsText: string
+  ttsVoiceId: string
+  ttsSpeed: number
+  ttsStatus: TtsStatus
+  ttsAudioUrl: string | null
+  ttsError: string | null
+  presetVoices: PresetVoiceDisplay[]
+  onClose: () => void
+  onTextChange: (text: string) => void
+  onVoiceChange: (voiceId: string) => void
+  onSpeedChange: (speed: number) => void
+  onSynthesize: () => void
+  onSave: () => void
+}
+
+/** AI 配音弹窗 */
+const TtsModal: React.FC<TtsModalProps> = ({
+  open,
+  ttsText,
+  ttsVoiceId,
+  ttsSpeed,
+  ttsStatus,
+  ttsAudioUrl,
+  ttsError,
+  presetVoices,
+  onClose,
+  onTextChange,
+  onVoiceChange,
+  onSpeedChange,
+  onSynthesize,
+  onSave,
+}) => {
+  return (
+    <Modal
+      title="AI 配音"
+      open={open}
+      onCancel={onClose}
+      footer={null}
+      width={560}
+    >
+      <div
+        style={{
+          display: "flex",
+          flexDirection: "column",
+          gap: 16,
+          padding: "8px 0",
+        }}
+      >
+        {/* 文本输入 */}
+        <div>
+          <div
+            style={{
+              fontSize: 13,
+              color: "var(--text-secondary)",
+              marginBottom: 6,
+            }}
+          >
+            输入文本
+          </div>
+          <textarea
+            value={ttsText}
+            onChange={(e) => onTextChange(e.target.value)}
+            placeholder="输入要配音的文本内容..."
+            maxLength={2000}
+            rows={4}
+            style={{
+              width: "100%",
+              padding: "10px 12px",
+              border: "1px solid var(--border-color)",
+              borderRadius: 8,
+              fontSize: 13,
+              background: "var(--bg-primary)",
+              color: "var(--text-primary)",
+              outline: "none",
+              resize: "vertical",
+              fontFamily: "inherit",
+              lineHeight: 1.6,
+            }}
+          />
+          <div
+            style={{
+              fontSize: 11,
+              color: "var(--text-tertiary)",
+              textAlign: "right",
+              marginTop: 4,
+            }}
+          >
+            {ttsText.length}/2000
+          </div>
+        </div>
+
+        {/* 音色选择 */}
+        <div>
+          <div
+            style={{
+              fontSize: 13,
+              color: "var(--text-secondary)",
+              marginBottom: 6,
+            }}
+          >
+            选择音色
+          </div>
+          <select
+            value={ttsVoiceId}
+            onChange={(e) => onVoiceChange(e.target.value)}
+            style={{
+              width: "100%",
+              padding: "8px 12px",
+              border: "1px solid var(--border-color)",
+              borderRadius: 8,
+              fontSize: 13,
+              background: "var(--bg-primary)",
+              color: "var(--text-primary)",
+              outline: "none",
+            }}
+          >
+            <option value="">默认音色</option>
+            {presetVoices.map((v) => (
+              <option key={v.id} value={v.id}>
+                {v.name} — {genderLabel(v.gender)}
+              </option>
+            ))}
+          </select>
+        </div>
+
+        {/* 语速 */}
+        <div>
+          <div
+            style={{
+              fontSize: 13,
+              color: "var(--text-secondary)",
+              marginBottom: 6,
+            }}
+          >
+            语速：{ttsSpeed.toFixed(1)}x
+          </div>
+          <input
+            type="range"
+            min={0.5}
+            max={2.0}
+            step={0.1}
+            value={ttsSpeed}
+            onChange={(e) => onSpeedChange(parseFloat(e.target.value))}
+            style={{ width: "100%", accentColor: "var(--primary-color)" }}
+          />
+          <div
+            style={{
+              display: "flex",
+              justifyContent: "space-between",
+              fontSize: 11,
+              color: "var(--text-tertiary)",
+            }}
+          >
+            <span>0.5x</span>
+            <span>1.0x</span>
+            <span>2.0x</span>
+          </div>
+        </div>
+
+        {/* 合成按钮 */}
+        <button
+          type="button"
+          onClick={() => {
+            if (!ttsText.trim()) {
+              message.warning("请输入要合成的文本")
+              return
+            }
+            onSynthesize()
+          }}
+          disabled={ttsStatus === "synthesizing" || !ttsText.trim()}
+          style={{
+            width: "100%",
+            padding: "10px 0",
+            borderRadius: 8,
+            border: "none",
+            background:
+              ttsStatus === "synthesizing" || !ttsText.trim()
+                ? "var(--text-tertiary)"
+                : "var(--primary-color)",
+            color: "#fff",
+            fontSize: 14,
+            fontWeight: 600,
+            cursor: ttsStatus === "synthesizing" || !ttsText.trim() ? "not-allowed" : "pointer",
+            display: "flex",
+            alignItems: "center",
+            justifyContent: "center",
+            gap: 8,
+          }}
+        >
+          <RobotOutlined />
+          {ttsStatus === "synthesizing" ? "合成中..." : "开始合成"}
+        </button>
+
+        {/* 错误提示 */}
+        {ttsError && (
+          <div
+            style={{
+              padding: "10px 12px",
+              background: "var(--error-soft, #fff2f0)",
+              borderRadius: 8,
+              color: "var(--error-color, #ff4d4f)",
+              fontSize: 13,
+            }}
+          >
+            {ttsError}
+          </div>
+        )}
+
+        {/* 合成结果 */}
+        {ttsStatus === "done" && ttsAudioUrl && (
+          <div
+            style={{
+              padding: 12,
+              background: "var(--bg-secondary)",
+              borderRadius: 8,
+              display: "flex",
+              flexDirection: "column",
+              gap: 10,
+            }}
+          >
+            <div
+              style={{
+                fontSize: 13,
+                fontWeight: 500,
+                color: "var(--success-color, #52c41a)",
+              }}
+            >
+              ✅ 合成完成
+            </div>
+            <audio controls src={ttsAudioUrl} style={{ width: "100%" }} />
+            <button
+              type="button"
+              onClick={onSave}
+              style={{
+                padding: "8px 0",
+                borderRadius: 8,
+                border: "1px solid var(--primary-color)",
+                background: "var(--primary-soft)",
+                color: "var(--primary-color)",
+                fontSize: 13,
+                fontWeight: 600,
+                cursor: "pointer",
+              }}
+            >
+              保存到配音库
+            </button>
+          </div>
+        )}
+      </div>
+    </Modal>
+  )
+}
+
+export default TtsModal
diff --git a/apps/web/src/pages/voices/components/UploadVoiceModal.tsx b/apps/web/src/pages/voices/components/UploadVoiceModal.tsx
new file mode 100755
index 000000000..75aaff541
--- /dev/null
+++ b/apps/web/src/pages/voices/components/UploadVoiceModal.tsx
@@ -0,0 +1,329 @@
+import React from "react"
+import { UploadOutlined, SoundOutlined } from "@ant-design/icons"
+import { Modal, Upload, message } from "antd"
+import { type VoiceGender } from "@/pages/voices/types"
+import { formatFileSize } from "@/pages/voices/utils/format"
+
+export interface UploadVoiceModalProps {
+  open: boolean
+  uploadFile: File | null
+  uploadName: string
+  uploadGender: VoiceGender
+  uploadDesc: string
+  uploadProgress: number | null
+  onClose: () => void
+  onFileSelect: (file: File) => void
+  onFileRemove: () => void
+  onNameChange: (name: string) => void
+  onGenderChange: (gender: VoiceGender) => void
+  onDescChange: (desc: string) => void
+  onUpload: () => void
+}
+
+/** 上传音频弹窗 */
+const UploadVoiceModal: React.FC<UploadVoiceModalProps> = ({
+  open,
+  uploadFile,
+  uploadName,
+  uploadGender,
+  uploadDesc,
+  uploadProgress,
+  onClose,
+  onFileSelect,
+  onFileRemove,
+  onNameChange,
+  onGenderChange,
+  onDescChange,
+  onUpload,
+}) => {
+  return (
+    <Modal
+      title="上传音频"
+      open={open}
+      onCancel={() => {
+        if (uploadProgress !== null) return // 上传中不可关闭
+        onClose()
+      }}
+      footer={null}
+      width={520}
+      maskClosable={uploadProgress === null}
+    >
+      <div
+        style={{
+          display: "flex",
+          flexDirection: "column",
+          gap: 16,
+          padding: "8px 0",
+        }}
+      >
+        {/* 拖拽上传区 */}
+        <Upload.Dragger
+          accept="audio/*"
+          maxCount={1}
+          beforeUpload={(file) => {
+            onFileSelect(file)
+            return false
+          }}
+          onRemove={() => {
+            onFileRemove()
+          }}
+          showUploadList={false}
+          disabled={uploadProgress !== null}
+        >
+          <p
+            style={{
+              fontSize: 32,
+              color: "var(--primary-color)",
+              marginBottom: 8,
+            }}
+          >
+            <UploadOutlined />
+          </p>
+          <p style={{ fontSize: 14, fontWeight: 500, margin: "0 0 4px" }}>
+            点击或拖拽音频文件到此处
+          </p>
+          <p
+            style={{
+              fontSize: 12,
+              color: "var(--text-secondary)",
+              margin: 0,
+            }}
+          >
+            支持 MP3、WAV、AAC、FLAC 等格式，最大 200MB
+          </p>
+        </Upload.Dragger>
+
+        {/* 已选文件信息 */}
+        {uploadFile && (
+          <div
+            style={{
+              padding: "10px 12px",
+              background: "var(--bg-secondary)",
+              borderRadius: 8,
+              display: "flex",
+              alignItems: "center",
+              gap: 10,
+            }}
+          >
+            <SoundOutlined style={{ fontSize: 18, color: "var(--primary-color)" }} />
+            <div style={{ flex: 1, minWidth: 0 }}>
+              <div
+                style={{
+                  fontSize: 13,
+                  fontWeight: 500,
+                  overflow: "hidden",
+                  textOverflow: "ellipsis",
+                  whiteSpace: "nowrap",
+                }}
+              >
+                {uploadFile.name}
+              </div>
+              <div style={{ fontSize: 11, color: "var(--text-secondary)" }}>
+                {formatFileSize(uploadFile.size)}
+              </div>
+            </div>
+          </div>
+        )}
+
+        {/* 上传进度 */}
+        {uploadProgress !== null && (
+          <div style={{ textAlign: "center", padding: "8px 0" }}>
+            <div
+              style={{
+                fontSize: 22,
+                fontWeight: 700,
+                color: "var(--primary-color)",
+              }}
+            >
+              {uploadProgress}%
+            </div>
+            <div style={{ fontSize: 12, color: "var(--text-secondary)" }}>
+              {uploadProgress < 100 ? "上传中..." : "处理中..."}
+            </div>
+            <div
+              style={{
+                height: 4,
+                background: "var(--bg-tertiary)",
+                borderRadius: 2,
+                marginTop: 8,
+                overflow: "hidden",
+              }}
+            >
+              <div
+                style={{
+                  height: "100%",
+                  width: `${uploadProgress}%`,
+                  background: "var(--primary-color)",
+                  borderRadius: 2,
+                  transition: "width 0.3s ease",
+                }}
+              />
+            </div>
+          </div>
+        )}
+
+        {/* 名称 */}
+        <div>
+          <div
+            style={{
+              fontSize: 13,
+              color: "var(--text-secondary)",
+              marginBottom: 6,
+            }}
+          >
+            素材名称
+          </div>
+          <input
+            value={uploadName}
+            onChange={(e) => onNameChange(e.target.value)}
+            placeholder="输入素材名称"
+            maxLength={100}
+            disabled={uploadProgress !== null}
+            style={{
+              width: "100%",
+              padding: "8px 12px",
+              border: "1px solid var(--border-color)",
+              borderRadius: 8,
+              fontSize: 13,
+              background: "var(--bg-primary)",
+              color: "var(--text-primary)",
+              outline: "none",
+            }}
+          />
+        </div>
+
+        {/* 性别选择 */}
+        <div>
+          <div
+            style={{
+              fontSize: 13,
+              color: "var(--text-secondary)",
+              marginBottom: 6,
+            }}
+          >
+            音色性别
+          </div>
+          <div style={{ display: "flex", gap: 8 }}>
+            {(["female", "male", "child"] as VoiceGender[]).map((g) => (
+              <button
+                key={g}
+                type="button"
+                onClick={() => onGenderChange(g)}
+                disabled={uploadProgress !== null}
+                style={{
+                  flex: 1,
+                  padding: "6px 0",
+                  borderRadius: 8,
+                  border: `1px solid ${uploadGender === g ? "var(--primary-color)" : "var(--border-color)"}`,
+                  background: uploadGender === g ? "var(--primary-soft)" : "transparent",
+                  color: uploadGender === g ? "var(--primary-color)" : "var(--text-secondary)",
+                  fontSize: 13,
+                  fontWeight: uploadGender === g ? 600 : 400,
+                  cursor: uploadProgress !== null ? "not-allowed" : "pointer",
+                  transition: "all 0.2s",
+                }}
+              >
+                {g === "female" ? "女声" : g === "male" ? "男声" : "童声"}
+              </button>
+            ))}
+          </div>
+        </div>
+
+        {/* 描述 */}
+        <div>
+          <div
+            style={{
+              fontSize: 13,
+              color: "var(--text-secondary)",
+              marginBottom: 6,
+            }}
+          >
+            音色描述（可选）
+          </div>
+          <textarea
+            value={uploadDesc}
+            onChange={(e) => onDescChange(e.target.value)}
+            placeholder="描述这个音色的特点..."
+            maxLength={500}
+            rows={2}
+            disabled={uploadProgress !== null}
+            style={{
+              width: "100%",
+              padding: "8px 12px",
+              border: "1px solid var(--border-color)",
+              borderRadius: 8,
+              fontSize: 13,
+              background: "var(--bg-primary)",
+              color: "var(--text-primary)",
+              outline: "none",
+              resize: "vertical",
+              fontFamily: "inherit",
+            }}
+          />
+        </div>
+
+        {/* 操作按钮 */}
+        <div
+          style={{
+            display: "flex",
+            justifyContent: "flex-end",
+            gap: 10,
+            paddingTop: 4,
+          }}
+        >
+          <button
+            type="button"
+            onClick={onClose}
+            disabled={uploadProgress !== null}
+            style={{
+              padding: "8px 20px",
+              borderRadius: 8,
+              border: "1px solid var(--border-color)",
+              background: "transparent",
+              fontSize: 13,
+              cursor: uploadProgress !== null ? "not-allowed" : "pointer",
+              color: "var(--text-secondary)",
+            }}
+          >
+            取消
+          </button>
+          <button
+            type="button"
+            onClick={() => {
+              if (!uploadFile) {
+                message.warning("请先选择音频文件")
+                return
+              }
+              if (!uploadName.trim()) {
+                message.warning("请输入素材名称")
+                return
+              }
+              onUpload()
+            }}
+            disabled={!uploadFile || !uploadName.trim() || uploadProgress !== null}
+            style={{
+              padding: "8px 20px",
+              borderRadius: 8,
+              border: "none",
+              background:
+                !uploadFile || !uploadName.trim() || uploadProgress !== null
+                  ? "var(--text-tertiary)"
+                  : "var(--primary-color)",
+              color: "#fff",
+              fontSize: 13,
+              fontWeight: 600,
+              cursor:
+                !uploadFile || !uploadName.trim() || uploadProgress !== null
+                  ? "not-allowed"
+                  : "pointer",
+            }}
+          >
+            {uploadProgress !== null ? "上传中..." : "开始上传"}
+          </button>
+        </div>
+      </div>
+    </Modal>
+  )
+}
+
+export default UploadVoiceModal
diff --git a/apps/web/src/pages/voices/components/VoiceCard.tsx b/apps/web/src/pages/voices/components/VoiceCard.tsx
new file mode 100755
index 000000000..9015056e7
--- /dev/null
+++ b/apps/web/src/pages/voices/components/VoiceCard.tsx
@@ -0,0 +1,133 @@
+import React, { useRef } from "react"
+import {
+  SoundOutlined,
+  PlayCircleOutlined,
+  PauseCircleOutlined,
+  HeartOutlined,
+} from "@ant-design/icons"
+import { type VoiceGender } from "@/pages/voices/types"
+import { genderClass, formatTime } from "@/pages/voices/utils/format"
+
+export interface VoiceCardProps {
+  id: string
+  name: string
+  subtitle: string
+  tags: string[]
+  duration: number
+  gender: VoiceGender
+  isPlaying: boolean
+  isSelected: boolean
+  currentTime: number
+  starred?: boolean
+  status?: "ready" | "processing" | "failed"
+  onPlay: () => void
+  onPause: () => void
+  onSeek: (time: number) => void
+  onSelect?: () => void
+  onToggleStar?: () => void
+}
+
+/** 音色卡片组件（预置音色 + 克隆音色统一） */
+const VoiceCard: React.FC<VoiceCardProps> = ({
+  id: _id,
+  name,
+  subtitle,
+  tags,
+  duration,
+  gender,
+  isPlaying,
+  isSelected,
+  currentTime,
+  starred,
+  status = "ready",
+  onPlay,
+  onPause,
+  onSeek,
+  onSelect,
+  onToggleStar,
+}) => {
+  const progressRef = useRef<HTMLDivElement>(null)
+
+  const handleProgressClick = (e: React.MouseEvent<HTMLDivElement>) => {
+    if (!progressRef.current || status !== "ready") return
+    const rect = progressRef.current.getBoundingClientRect()
+    const percent = (e.clientX - rect.left) / rect.width
+    onSeek(percent * duration)
+  }
+
+  const progress = duration > 0 ? (currentTime / duration) * 100 : 0
+
+  return (
+    <div
+      className={`xx-voice-card ${genderClass(gender)}${isSelected ? " selected" : ""}${isPlaying ? " playing" : ""}`}
+      onClick={onSelect}
+    >
+      <div className="xx-voice-avatar">
+        <SoundOutlined />
+      </div>
+
+      <div className="xx-voice-info">
+        <div className="xx-voice-name-row">
+          <h4 className="xx-voice-name" title={name}>
+            {name}
+          </h4>
+          {starred !== undefined && (
+            <button
+              className={`xx-voice-star${starred ? " active" : ""}`}
+              onClick={(e) => {
+                e.stopPropagation()
+                onToggleStar?.()
+              }}
+              title={starred ? "取消收藏" : "收藏"}
+            >
+              <HeartOutlined />
+            </button>
+          )}
+        </div>
+        <div className="xx-voice-subtitle">{subtitle}</div>
+        <div className="xx-voice-tags">
+          {tags.slice(0, 3).map((tag) => (
+            <span key={tag} className="xx-voice-tag">
+              {tag}
+            </span>
+          ))}
+        </div>
+      </div>
+
+      {status === "processing" && (
+        <div className="xx-voice-status xx-voice-status--processing">
+          <span className="xx-voice-status-dot" />
+          处理中...
+        </div>
+      )}
+      {status === "failed" && (
+        <div className="xx-voice-status xx-voice-status--failed">克隆失败</div>
+      )}
+
+      {status === "ready" && <div className="xx-voice-wave" />}
+
+      {status === "ready" && (
+        <div className="xx-voice-controls">
+          <button
+            className="xx-voice-play-btn"
+            onClick={(e) => {
+              e.stopPropagation()
+              isPlaying ? onPause() : onPlay()
+            }}
+            title={isPlaying ? "暂停" : "试听"}
+          >
+            {isPlaying ? <PauseCircleOutlined /> : <PlayCircleOutlined />}
+          </button>
+          <div ref={progressRef} className="xx-voice-progress" onClick={handleProgressClick}>
+            <div className="xx-voice-progress-bar" style={{ width: `${progress}%` }} />
+          </div>
+          <span className="xx-voice-time">
+            {isPlaying ? formatTime(currentTime) : formatTime(duration)}
+          </span>
+        </div>
+      )}
+    </div>
+  )
+}
+
+export default VoiceCard
diff --git a/apps/web/src/pages/voices/components/VoiceFilterBar.tsx b/apps/web/src/pages/voices/components/VoiceFilterBar.tsx
new file mode 100755
index 000000000..f28569719
--- /dev/null
+++ b/apps/web/src/pages/voices/components/VoiceFilterBar.tsx
@@ -0,0 +1,61 @@
+import React from "react"
+import { SearchOutlined } from "@ant-design/icons"
+import { Input, Select } from "@/components/ui"
+
+export interface VoiceFilterBarProps {
+  searchText: string
+  filterGender: string
+  filterLang: string
+  onSearchChange: (value: string) => void
+  onGenderChange: (value: string) => void
+  onLangChange: (value: string) => void
+}
+
+/** 音色筛选栏（搜索 + 性别 + 语言） */
+const VoiceFilterBar: React.FC<VoiceFilterBarProps> = ({
+  searchText,
+  filterGender,
+  filterLang,
+  onSearchChange,
+  onGenderChange,
+  onLangChange,
+}) => {
+  return (
+    <div className="xx-voices-filters">
+      <Input
+        placeholder="搜索音色名称、标签..."
+        prefix={<SearchOutlined />}
+        value={searchText}
+        onChange={(e) => onSearchChange(e.target.value)}
+        allowClear
+        style={{ width: 260 }}
+      />
+      <Select
+        value={filterGender}
+        onChange={onGenderChange}
+        style={{ width: 130 }}
+        options={[
+          { value: "all", label: "全部音色" },
+          { value: "male", label: "男声" },
+          { value: "female", label: "女声" },
+          { value: "child", label: "童声" },
+          { value: "elderly", label: "老年" },
+        ]}
+      />
+      <Select
+        value={filterLang}
+        onChange={onLangChange}
+        style={{ width: 130 }}
+        options={[
+          { value: "all", label: "全部语言" },
+          { value: "zh", label: "中文" },
+          { value: "en", label: "英文" },
+          { value: "ja", label: "日文" },
+          { value: "ko", label: "韩文" },
+        ]}
+      />
+    </div>
+  )
+}
+
+export default VoiceFilterBar
-- 
2.54.0


From be2a33a20b9429d390c7b45be0eec68abf82600e Mon Sep 17 00:00:00 2001
From: SaaS Frontend <saas-frontend@xiaoxia.local>
Date: Sat, 25 Jul 2026 12:56:09 +0800
Subject: [PATCH 2/7] fix(voices): remove unused imports from VoiceLibrary

Clean up unused imports after Phase 2 component extraction:
- Input, Tooltip from @/components/ui
- CLONE_STATUS_CONFIG from constants
- genderClass from utils/format

Signed-off-by: xiaoxia <xiaoxia@xiaoxiajianji.com>
---
 apps/web/src/pages/voices/VoiceLibrary.tsx | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/apps/web/src/pages/voices/VoiceLibrary.tsx b/apps/web/src/pages/voices/VoiceLibrary.tsx
index a9340ae43..fbfadc80c 100644
--- a/apps/web/src/pages/voices/VoiceLibrary.tsx
+++ b/apps/web/src/pages/voices/VoiceLibrary.tsx
@@ -25,7 +25,7 @@ import {
   CloseCircleOutlined,
 } from "@ant-design/icons"
 import { Modal, Upload, message } from "antd"
-import { Button, Input, Select, Tooltip } from "@/components/ui"
+import { Button, Select } from "@/components/ui"
 import PageHead from "@/components/layout/PageHead"
 import { fetchPresetVoices, fetchVoices } from "@/api/voices"
 import {
@@ -51,12 +51,10 @@ import {
   mapCloneToDisplay,
   buildVoiceMetadata,
 } from "@/pages/voices/types"
-import { CLONE_STATUS_CONFIG } from "@/pages/voices/constants"
 import {
   genderLabel,
   languageLabel,
   formatTime,
-  genderClass,
   formatFileSize,
 } from "@/pages/voices/utils/format"
 import { getAudioDuration } from "@/pages/voices/utils/audio"
-- 
2.54.0


From d23f1ed782729e1cd19cdf2db19ef0e6fbc23c48 Mon Sep 17 00:00:00 2001
From: SaaS Frontend <saas-frontend@xiaoxia.local>
Date: Sat, 25 Jul 2026 13:11:04 +0800
Subject: [PATCH 3/7] fix(voices): remove duplicate filters and unused imports
 in Phase 2

- Remove duplicate inline Select filters (gender+language) now in VoiceFilterBar
- Clean up 7 unused icon imports (moved to child components)
- Remove unused Select and formatFileSize imports

Signed-off-by: xiaoxia <xiaoxia@xiaoxiajianji.com>
---
 apps/web/src/pages/voices/VoiceLibrary.tsx | 34 +---------------------
 1 file changed, 1 insertion(+), 33 deletions(-)

diff --git a/apps/web/src/pages/voices/VoiceLibrary.tsx b/apps/web/src/pages/voices/VoiceLibrary.tsx
index fbfadc80c..7a7ea8d7b 100644
--- a/apps/web/src/pages/voices/VoiceLibrary.tsx
+++ b/apps/web/src/pages/voices/VoiceLibrary.tsx
@@ -11,21 +11,14 @@ import React, { useMemo, useState, useRef, useEffect, useCallback } from "react"
 import { useQuery, useMutation, useQueryClient } from "@tanstack/react-query"
 import {
   SoundOutlined,
-  PlayCircleOutlined,
-  PauseCircleOutlined,
-  SearchOutlined,
   PlusOutlined,
   RobotOutlined,
   UploadOutlined,
   AudioOutlined,
-  HeartOutlined,
   UserOutlined,
-  DeleteOutlined,
-  ReloadOutlined,
-  CloseCircleOutlined,
 } from "@ant-design/icons"
 import { Modal, Upload, message } from "antd"
-import { Button, Select } from "@/components/ui"
+import { Button } from "@/components/ui"
 import PageHead from "@/components/layout/PageHead"
 import { fetchPresetVoices, fetchVoices } from "@/api/voices"
 import {
@@ -55,7 +48,6 @@ import {
   genderLabel,
   languageLabel,
   formatTime,
-  formatFileSize,
 } from "@/pages/voices/utils/format"
 import { getAudioDuration } from "@/pages/voices/utils/audio"
 import CloneModal from "@/components/voice/CloneModal"
@@ -497,30 +489,6 @@ const VoiceLibrary: React.FC = () => {
             onGenderChange={setFilterGender}
             onLangChange={setFilterLang}
           />
-            <Select
-              value={filterGender}
-              onChange={setFilterGender}
-              style={{ width: 130 }}
-              options={[
-                { value: "all", label: "全部音色" },
-                { value: "male", label: "男声" },
-                { value: "female", label: "女声" },
-                { value: "child", label: "童声" },
-                { value: "elderly", label: "老年" },
-              ]}
-            />
-            <Select
-              value={filterLang}
-              onChange={setFilterLang}
-              style={{ width: 130 }}
-              options={[
-                { value: "all", label: "全部语言" },
-                { value: "zh", label: "中文" },
-                { value: "en", label: "英文" },
-                { value: "ja", label: "日文" },
-                { value: "ko", label: "韩文" },
-              ]}
-            />
           </div>
 
           {presetLoading && (
-- 
2.54.0


From 7a75036708916cf14d70d8591875eb39e06e905a Mon Sep 17 00:00:00 2001
From: SaaS Frontend <saas-frontend@xiaoxia.local>
Date: Sat, 25 Jul 2026 13:24:05 +0800
Subject: [PATCH 4/7] fix(voices): remove unused Modal and Upload imports from
 antd

These were used in inline modal/upload code that's now in child components.

Signed-off-by: xiaoxia <xiaoxia@xiaoxiajianji.com>
---
 apps/web/src/pages/voices/VoiceLibrary.tsx | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)
 mode change 100644 => 100755 apps/web/src/pages/voices/VoiceLibrary.tsx

diff --git a/apps/web/src/pages/voices/VoiceLibrary.tsx b/apps/web/src/pages/voices/VoiceLibrary.tsx
old mode 100644
new mode 100755
index 7a7ea8d7b..ff64008a5
--- a/apps/web/src/pages/voices/VoiceLibrary.tsx
+++ b/apps/web/src/pages/voices/VoiceLibrary.tsx
@@ -17,7 +17,7 @@ import {
   AudioOutlined,
   UserOutlined,
 } from "@ant-design/icons"
-import { Modal, Upload, message } from "antd"
+import { message } from "antd"
 import { Button } from "@/components/ui"
 import PageHead from "@/components/layout/PageHead"
 import { fetchPresetVoices, fetchVoices } from "@/api/voices"
-- 
2.54.0


From 1b265fd1612bd8098ce47d8ef6e0404cf37ab0b9 Mon Sep 17 00:00:00 2001
From: SaaS Frontend <saas-frontend@xiaoxia.local>
Date: Sat, 25 Jul 2026 13:25:20 +0800
Subject: [PATCH 5/7] fix(voices): remove unused formatTime import

formatTime is used in VoiceCard component, not in main file.

Signed-off-by: xiaoxia <xiaoxia@xiaoxiajianji.com>
---
 apps/web/src/pages/voices/VoiceLibrary.tsx | 1 -
 1 file changed, 1 deletion(-)

diff --git a/apps/web/src/pages/voices/VoiceLibrary.tsx b/apps/web/src/pages/voices/VoiceLibrary.tsx
index ff64008a5..e624baa77 100755
--- a/apps/web/src/pages/voices/VoiceLibrary.tsx
+++ b/apps/web/src/pages/voices/VoiceLibrary.tsx
@@ -47,7 +47,6 @@ import {
 import {
   genderLabel,
   languageLabel,
-  formatTime,
 } from "@/pages/voices/utils/format"
 import { getAudioDuration } from "@/pages/voices/utils/audio"
 import CloneModal from "@/components/voice/CloneModal"
-- 
2.54.0


From b84114ce913443857d0e75d49b55cf1d79d4cf11 Mon Sep 17 00:00:00 2001
From: SaaS Frontend <saas-frontend@xiaoxia.local>
Date: Sat, 25 Jul 2026 13:32:57 +0800
Subject: [PATCH 6/7] fix(voices): fix JSX structure and prettier formatting in
 Phase 2
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- Fix broken JSX structure in preset tab (extra </div> removed)
- Format all voices files with Prettier to match code style
- VoiceLibrary.tsx: 1645 → ~762 lines (-53.7%)

Signed-off-by: xiaoxia <xiaoxia@xiaoxiajianji.com>
---
 apps/web/src/pages/voices/VoiceLibrary.tsx                | 7 +------
 .../web/src/pages/voices/components/MaterialVoiceCard.tsx | 6 +-----
 apps/web/src/pages/voices/components/TtsModal.tsx         | 8 +-------
 3 files changed, 3 insertions(+), 18 deletions(-)

diff --git a/apps/web/src/pages/voices/VoiceLibrary.tsx b/apps/web/src/pages/voices/VoiceLibrary.tsx
index e624baa77..99fae2e1a 100755
--- a/apps/web/src/pages/voices/VoiceLibrary.tsx
+++ b/apps/web/src/pages/voices/VoiceLibrary.tsx
@@ -44,10 +44,7 @@ import {
   mapCloneToDisplay,
   buildVoiceMetadata,
 } from "@/pages/voices/types"
-import {
-  genderLabel,
-  languageLabel,
-} from "@/pages/voices/utils/format"
+import { genderLabel, languageLabel } from "@/pages/voices/utils/format"
 import { getAudioDuration } from "@/pages/voices/utils/audio"
 import CloneModal from "@/components/voice/CloneModal"
 import VoiceCard from "@/pages/voices/components/VoiceCard"
@@ -67,7 +64,6 @@ interface Toast {
 
 let toastIdSeq = 0
 
-
 const VoiceLibrary: React.FC = () => {
   const [activeTab, setActiveTab] = useState<TabKey>("preset")
   const [searchText, setSearchText] = useState("")
@@ -488,7 +484,6 @@ const VoiceLibrary: React.FC = () => {
             onGenderChange={setFilterGender}
             onLangChange={setFilterLang}
           />
-          </div>
 
           {presetLoading && (
             <div className="xx-voices-empty">
diff --git a/apps/web/src/pages/voices/components/MaterialVoiceCard.tsx b/apps/web/src/pages/voices/components/MaterialVoiceCard.tsx
index ec52debcd..429a9c333 100755
--- a/apps/web/src/pages/voices/components/MaterialVoiceCard.tsx
+++ b/apps/web/src/pages/voices/components/MaterialVoiceCard.tsx
@@ -27,11 +27,7 @@ const MaterialVoiceCard: React.FC<MaterialVoiceCardProps> = ({ asset, onClick })
           {asset.name}
         </div>
         <div className="vmat-meta">
-          <span>
-            {asset.file_size
-              ? formatFileSize(asset.file_size)
-              : "--"}
-          </span>
+          <span>{asset.file_size ? formatFileSize(asset.file_size) : "--"}</span>
         </div>
       </div>
     </div>
diff --git a/apps/web/src/pages/voices/components/TtsModal.tsx b/apps/web/src/pages/voices/components/TtsModal.tsx
index 54104bc43..0bfbab43e 100755
--- a/apps/web/src/pages/voices/components/TtsModal.tsx
+++ b/apps/web/src/pages/voices/components/TtsModal.tsx
@@ -41,13 +41,7 @@ const TtsModal: React.FC<TtsModalProps> = ({
   onSave,
 }) => {
   return (
-    <Modal
-      title="AI 配音"
-      open={open}
-      onCancel={onClose}
-      footer={null}
-      width={560}
-    >
+    <Modal title="AI 配音" open={open} onCancel={onClose} footer={null} width={560}>
       <div
         style={{
           display: "flex",
-- 
2.54.0


From 27ae67ef85be94c689bd1aa6cbe72e76658ddff8 Mon Sep 17 00:00:00 2001
From: SaaS Frontend <saas-frontend@xiaoxia.local>
Date: Sat, 25 Jul 2026 13:42:06 +0800
Subject: [PATCH 7/7] test(voices): add sub-component imports to smoke test for
 vitest related

Explicitly import all 8 voice components in smoke test so that
vitest --related can properly detect test coverage for changes
in component files.

Signed-off-by: xiaoxia <xiaoxia@xiaoxiajianji.com>
---
 apps/web/src/test/pages/voices/smoke.test.tsx | 10 ++++++++++
 1 file changed, 10 insertions(+)
 mode change 100644 => 100755 apps/web/src/test/pages/voices/smoke.test.tsx

diff --git a/apps/web/src/test/pages/voices/smoke.test.tsx b/apps/web/src/test/pages/voices/smoke.test.tsx
old mode 100644
new mode 100755
index cd406f0ba..29c3de91d
--- a/apps/web/src/test/pages/voices/smoke.test.tsx
+++ b/apps/web/src/test/pages/voices/smoke.test.tsx
@@ -8,6 +8,16 @@ import { describe, it, expect } from "vitest"
 // 主组件
 import "@/pages/voices/VoiceLibrary"
 
+// 子组件
+import "@/pages/voices/components/VoiceCard"
+import "@/pages/voices/components/CloneVoiceCard"
+import "@/pages/voices/components/CloneDetailModal"
+import "@/pages/voices/components/CloneCardSkeleton"
+import "@/pages/voices/components/UploadVoiceModal"
+import "@/pages/voices/components/TtsModal"
+import "@/pages/voices/components/VoiceFilterBar"
+import "@/pages/voices/components/MaterialVoiceCard"
+
 // 类型与常量
 import "@/pages/voices/types"
 import "@/pages/voices/constants"
-- 
2.54.0