docs: 新增中文改动记录 CHANGELOG（2026-09-18 TTS 调整/真人配音/凭据修复）

- 生成语音按钮从输入区底部移到工具栏，紧跟在“✓ 错别字”之后
- 底部仅保留音色清单状态文字

AGENTS.md

@@ -0,0 +1,9 @@
+<!-- BEGIN:nextjs-agent-rules -->
+
+# This is NOT the Next.js you know
+
+This version has breaking changes — APIs, conventions, and file structure may all differ from your training data. Read the relevant guide in `node_modules/next/dist/docs/` (resolved from this file's directory; in monorepos the `next` package may not be visible from the repo root) before writing any code. Heed deprecation notices.
+
+This block is written and re-added by `next dev` — verify at `node_modules/next/dist/server/lib/generate-agent-files.js`. Removing it from a diff only re-creates the uncommitted change; committing it with your work keeps the tree clean.
+
+<!-- END:nextjs-agent-rules -->

CLAUDE.md

@@ -0,0 +1 @@
+@AGENTS.md

app/globals.css

@@ -265,6 +265,174 @@ button:disabled {
   color: #6b7280;
 }
 
+.tts-editor {
+  position: relative;
+  overflow-y: auto;
+  border: 1px solid #2a2f36;
+  border-radius: 0.65rem;
+  background: #14181d;
+  color: #f5f7fa;
+  padding: 1rem;
+  white-space: pre-wrap;
+  word-break: break-word;
+  caret-color: #00d1e6;
+}
+
+.tts-editor.is-empty::before {
+  color: #4b5563;
+  content: "输入需要转换的文本，停顿会显示为胶囊，不需要手写代码。";
+  pointer-events: none;
+}
+
+.tts-editor:focus {
+  border-color: rgba(0, 209, 230, 0.7);
+  outline: 2px solid rgba(0, 209, 230, 0.12);
+  outline-offset: 2px;
+}
+
+.pause-token {
+  display: inline-flex;
+  align-items: center;
+  margin: 0 0.18rem;
+  border: 1px solid rgba(0, 209, 230, 0.48);
+  border-radius: 999px;
+  background: rgba(0, 209, 230, 0.1);
+  color: #55e4ef;
+  padding: 0.12rem 0.55rem;
+  font-size: 0.8em;
+  line-height: 1.5;
+  cursor: pointer;
+  vertical-align: baseline;
+}
+
+.pause-token:hover,
+.pause-token:focus {
+  border-color: #00d1e6;
+  background: rgba(0, 209, 230, 0.2);
+}
+
+.typo-mark {
+  text-decoration: underline wavy #ef4444 1.5px;
+  text-underline-offset: 0.25rem;
+  cursor: pointer;
+}
+
+.tool-button,
+.pause-option {
+  display: inline-flex;
+  min-height: 2.25rem;
+  align-items: center;
+  justify-content: center;
+  gap: 0.35rem;
+  border: 1px solid #2a2f36;
+  border-radius: 0.55rem;
+  background: #14181d;
+  color: #d1d5db;
+  padding: 0.45rem 0.75rem;
+  font-size: 0.75rem;
+  transition: border-color 180ms ease, background-color 180ms ease, color 180ms ease;
+}
+
+.tool-button:hover,
+.pause-option:hover,
+.pause-option.is-selected {
+  border-color: #00d1e6;
+  background: rgba(0, 209, 230, 0.1);
+  color: #55e4ef;
+}
+
+.pause-panel {
+  border: 1px solid rgba(0, 209, 230, 0.2);
+  border-radius: 0.75rem;
+  background: #101317;
+  padding: 0.85rem;
+}
+
+.pause-input {
+  width: 5.5rem;
+  border: 1px solid #2a2f36;
+  border-radius: 0.5rem;
+  background: #1a1d21;
+  color: #f5f7fa;
+  padding: 0.45rem 0.55rem;
+  font-size: 0.8rem;
+}
+
+.pause-range {
+  width: min(12rem, 100%);
+  accent-color: #00d1e6;
+}
+
+.assist-card {
+  display: grid;
+  grid-template-columns: auto 1fr auto;
+  align-items: center;
+  gap: 0.85rem;
+  min-height: 6.25rem;
+  border: 1px solid #2a2f36;
+  border-radius: 0.85rem;
+  background: rgba(20, 24, 29, 0.76);
+  padding: 1rem;
+  color: #f5f7fa;
+  transition: border-color 180ms ease, background-color 180ms ease, transform 180ms ease;
+}
+
+.voice-clone-panel {
+  border: 1px solid rgba(0, 209, 230, 0.3);
+  border-radius: 0.85rem;
+  background: rgba(0, 209, 230, 0.05);
+  padding: 1rem;
+  transition: border-color 180ms ease, background-color 180ms ease;
+}
+
+.voice-clone-panel.is-ready {
+  border-color: rgba(0, 209, 230, 0.7);
+  background: rgba(0, 209, 230, 0.09);
+}
+
+.assist-card:hover {
+  border-color: rgba(0, 209, 230, 0.65);
+  background: rgba(0, 209, 230, 0.06);
+  transform: translateY(-2px);
+}
+
+.assist-card:disabled {
+  cursor: wait;
+  opacity: 0.6;
+}
+
+.assist-card strong,
+.assist-card small {
+  display: block;
+}
+
+.assist-card strong {
+  font-size: 0.9rem;
+}
+
+.assist-card small {
+  margin-top: 0.35rem;
+  color: #9ca3af;
+  font-size: 0.75rem;
+  line-height: 1.55;
+}
+
+.assist-icon {
+  display: grid;
+  width: 2.25rem;
+  height: 2.25rem;
+  place-items: center;
+  border: 1px solid rgba(0, 209, 230, 0.3);
+  border-radius: 0.65rem;
+  color: #55e4ef;
+  font-size: 1.1rem;
+}
+
+.assist-arrow {
+  color: #4b5563;
+  font-size: 1.2rem;
+}
+
 @media (max-width: 640px) {
   .container-shell {
     width: min(100% - 2rem, 1180px);

app/tts-clone/route.ts

@@ -0,0 +1,65 @@
+import { NextResponse } from "next/server";
+
+export const runtime = "nodejs";
+
+const formatMime: Record<string, string> = {
+  wav: "audio/wav",
+  mp3: "audio/mpeg",
+  flac: "audio/flac",
+  opus: "audio/opus",
+  aac: "audio/aac",
+  pcm: "application/octet-stream",
+};
+
+// 真人声音配音（声音克隆）：
+// 前端把「文本 + 客户声音样本(data URL)」发到这里，服务端再调用配置的声音克隆引擎，返回音频流。
+// 生产环境需在服务端配置 TTS_CLONE_URL 指向 TTS 引擎的克隆接口；
+// 未配置时返回 501，前端会提示「真人配音引擎尚未接通，请先选择内置音色」。
+export async function POST(request: Request) {
+  let body: { text?: unknown; reference_audio?: unknown; response_format?: unknown; speed?: unknown };
+  try {
+    body = await request.json();
+  } catch {
+    return NextResponse.json({ error: { message: "请求体不是合法 JSON" } }, { status: 400 });
+  }
+
+  const text = typeof body.text === "string" ? body.text.trim() : "";
+  const referenceAudio = typeof body.reference_audio === "string" ? body.reference_audio : "";
+  const format = typeof body.response_format === "string" && body.response_format ? body.response_format : "wav";
+  const speed = Number(body.speed) || 1;
+
+  if (!text) return NextResponse.json({ error: { message: "请输入需要合成的文本" } }, { status: 400 });
+  if (!referenceAudio.startsWith("data:audio/")) {
+    return NextResponse.json({ error: { message: "请先录制或上传声音样本" } }, { status: 400 });
+  }
+  if (referenceAudio.length > 12 * 1024 * 1024) {
+    return NextResponse.json({ error: { message: "声音样本过大，请控制在 8 MB 以内" } }, { status: 400 });
+  }
+
+  const cloneUrl = process.env.TTS_CLONE_URL;
+  if (!cloneUrl) {
+    return NextResponse.json(
+      { error: { message: "真人配音引擎尚未接通，请先选择内置音色" } },
+      { status: 501 },
+    );
+  }
+
+  try {
+    const upstream = await fetch(cloneUrl, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({ input: text, reference_audio: referenceAudio, response_format: format, speed }),
+    });
+    if (!upstream.ok) {
+      const errBody = (await upstream.json().catch(() => ({}))) as { error?: { message?: string } };
+      throw new Error(errBody?.error?.message ?? `配音引擎返回 ${upstream.status}`);
+    }
+    const audio = Buffer.from(await upstream.arrayBuffer());
+    return new NextResponse(audio, {
+      headers: { "Content-Type": formatMime[format] ?? "application/octet-stream" },
+    });
+  } catch (error) {
+    const message = error instanceof Error ? error.message : "真人语音合成失败";
+    return NextResponse.json({ error: { message } }, { status: 502 });
+  }
+}

app/tts/page.tsx

@@ -1,158 +1,627 @@
 "use client";
 
-import Link from "next/link";
+import { useEffect, useMemo, useRef, useState } from "react";
-import { useEffect, useState } from "react";
 import { ArrowRight, WaveIcon } from "@/components/icons";
 import { BrandIcon } from "@/components/brand-icon";
-import { PreviewNotice, SectionHeading, StatusCard } from "@/components/ui";
+import { SectionHeading, StatusCard } from "@/components/ui";
 
-const apiBase = process.env.NEXT_PUBLIC_API_BASE_URL ?? "/api/v1";
+const ttsBase = (process.env.NEXT_PUBLIC_TTS_BASE_URL ?? "/tts").replace(/\/+$/, "");
+const pausePattern = /<pause:(\d+)>/g;
+const typoRules = [
+  { wrong: "爷门儿", right: "爷们儿" },
+  { wrong: "在见", right: "再见" },
+  { wrong: "以经", right: "已经" },
+];
 
-type Voice = { id: string; provider_voice_id: string; name: string; language?: string | null };
+type Voice = {
-type Usage = { available: number; used: number; reserved: number; plan: string };
+  id: string;
-type Task = { id: string; status: string; text_length: number; voice_id: string; parameters: { format?: string; speed?: number }; error_code?: string | null; audio_available: boolean; file_name?: string | null; created_at: string; finished_at?: string | null };
+  name: string;
+  desc?: string;
+  category?: string;
+  gender?: string;
+  genre?: string;
+  accent?: string;
+  style?: string;
+  styles?: string[];
+  preview?: string;
+};
+
+type VoiceResponse = { categories?: string[]; facets?: Record<string, string[]>; voices?: Voice[] };
+type TtsConfig = {
+  model?: string;
+  formats?: string[];
+  default_format?: string;
+  speed?: { min?: number; max?: number; default?: number };
+  pause?: { supported?: boolean; min_ms?: number; max_ms?: number; presets?: { ms: number; label: string }[] };
+};
+type Result = { url: string; fileName: string; format: string };
+type SelectedPause = { start: number; ms: number };
+
+const pauseOptions = [500, 1000, 2000];
+const symbolPauses: Record<string, number> = { "，": 300, "。": 800, "！": 800, "？": 800 };
+const erhuaOptions = ["关闭", "弱", "标准", "强"];
 
 function normalizeText(value: string) {
   return value.normalize("NFC").replace(/\r\n?/g, "\n");
 }
 
-export default function TtsPage() {
+function apiUrl(path: string) {
-  const [csrf, setCsrf] = useState("");
+  return `${ttsBase}${path}`;
-  const [loggedIn, setLoggedIn] = useState(false);
+}
-  const [voices, setVoices] = useState<Voice[]>([]);
-  const [usage, setUsage] = useState<Usage | null>(null);
-  const [tasks, setTasks] = useState<Task[]>([]);
-  const [text, setText] = useState("");
-  const [voice, setVoice] = useState("");
-  const [speed, setSpeed] = useState("1");
-  const [format, setFormat] = useState("wav");
-  const [activeTask, setActiveTask] = useState<Task | null>(null);
-  const [renaming, setRenaming] = useState(false);
-  const [renameOpen, setRenameOpen] = useState(false);
-  const [renameDraft, setRenameDraft] = useState("");
-  const [busy, setBusy] = useState(false);
-  const [error, setError] = useState("");
 
-  async function loadWorkspace() {
+function escapeHtml(value: string) {
-    const csrfResponse = await fetch(`${apiBase}/auth/csrf`, { credentials: "include" });
+  return value.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
-    const csrfBody = await csrfResponse.json();
+}
-    setCsrf(csrfBody.csrf_token ?? "");
+
-    const meResponse = await fetch(`${apiBase}/auth/me`, { credentials: "include" });
+function renderTextHtml(value: string) {
-    if (!meResponse.ok) {
+  let html = escapeHtml(value);
-      setLoggedIn(false);
+  for (const rule of typoRules) {
+    html = html.replaceAll(escapeHtml(rule.wrong), `<span class="typo-mark" data-typo-right="${rule.right}">${escapeHtml(rule.wrong)}</span>`);
+  }
+  return html.replace(/\n/g, "<br />");
+}
+
+function renderEditorHtml(value: string) {
+  let html = "";
+  let cursor = 0;
+  const matcher = new RegExp(pausePattern.source, "g");
+  let match = matcher.exec(value);
+  while (match) {
+    html += renderTextHtml(value.slice(cursor, match.index));
+    html += `<span class="pause-token" contenteditable="false" data-pause-ms="${match[1]}" role="button" tabindex="0">⏸ ${Number(match[1]) / 1000}s</span>`;
+    cursor = match.index + match[0].length;
+    match = matcher.exec(value);
+  }
+  return html + renderTextHtml(value.slice(cursor));
+}
+
+function serializeEditor(root: HTMLElement) {
+  function walk(node: Node): string {
+    if (node.nodeType === Node.TEXT_NODE) return node.textContent ?? "";
+    if (node.nodeType !== Node.ELEMENT_NODE) return "";
+    const element = node as HTMLElement;
+    if (element.dataset.pauseMs) return `<pause:${element.dataset.pauseMs}>`;
+    if (element.tagName === "BR") return "\n";
+    return Array.from(element.childNodes).map(walk).join("");
+  }
+  return walk(root);
+}
+
+function visibleText(value: string) {
+  return value.replace(new RegExp(pausePattern.source, "g"), "");
+}
+
+function countTypos(value: string) {
+  const plain = visibleText(value);
+  return typoRules.reduce((count, rule) => count + plain.split(rule.wrong).length - 1, 0);
+}
+
+export default function TtsPage() {
+  const [config, setConfig] = useState<TtsConfig | null>(null);
+  const [voices, setVoices] = useState<Voice[]>([]);
+  const [categories, setCategories] = useState<string[]>([]);
+  const [facets, setFacets] = useState<Record<string, string[]>>({});
+  const [text, setText] = useState("");
+  const [voiceId, setVoiceId] = useState("");
+  const [category, setCategory] = useState("");
+  const [filters, setFilters] = useState<Record<string, string>>({});
+  const [search, setSearch] = useState("");
+  const [speed, setSpeed] = useState(1);
+  const [erhuaStrength, setErhuaStrength] = useState(2);
+  const [format, setFormat] = useState("wav");
+  const [result, setResult] = useState<Result | null>(null);
+  const [loading, setLoading] = useState(true);
+  const [busy, setBusy] = useState(false);
+  const [helperBusy, setHelperBusy] = useState(false);
+  const [error, setError] = useState("");
+  const [loadedAt, setLoadedAt] = useState<Date | null>(null);
+  const [pauseOpen, setPauseOpen] = useState(false);
+  const [customPause, setCustomPause] = useState("3500");
+  const [selectedPause, setSelectedPause] = useState<SelectedPause | null>(null);
+  const [pauseError, setPauseError] = useState("");
+  const [correctionMessage, setCorrectionMessage] = useState("");
+  const [helperMessage, setHelperMessage] = useState("");
+  const [myVoice, setMyVoice] = useState<{ name: string; dataUrl: string } | null>(null);
+  const [recording, setRecording] = useState(false);
+  const textareaRef = useRef<HTMLDivElement>(null);
+  const fileInputRef = useRef<HTMLInputElement>(null);
+  const recorderRef = useRef<MediaRecorder | null>(null);
+  const voiceFileRef = useRef<HTMLInputElement>(null);
+
+  useEffect(() => {
+    let cancelled = false;
+    async function load() {
+      setLoading(true);
+      setError("");
+      try {
+        const [configResponse, voicesResponse] = await Promise.all([
+          fetch(apiUrl("/v1/audio/config")),
+          fetch(apiUrl("/v1/audio/voices")),
+        ]);
+        if (!configResponse.ok || !voicesResponse.ok) throw new Error("TTS 服务暂时不可用，请稍后重试");
+        const nextConfig: TtsConfig = await configResponse.json();
+        const nextVoices: VoiceResponse = await voicesResponse.json();
+        if (cancelled) return;
+        const nextList = nextVoices.voices ?? [];
+        setConfig(nextConfig);
+        setVoices(nextList);
+        setCategories(nextVoices.categories ?? Array.from(new Set(nextList.map((item) => item.category).filter(Boolean) as string[])));
+        setFacets(nextVoices.facets ?? {});
+        setVoiceId((current) => current || nextList[0]?.id || "");
+        setFormat(nextConfig.default_format ?? nextConfig.formats?.[0] ?? "wav");
+        setSpeed(nextConfig.speed?.default ?? 1);
+        setLoadedAt(new Date());
+      } catch (loadError) {
+        if (!cancelled) setError(loadError instanceof Error ? loadError.message : "无法连接 TTS 服务");
+      } finally {
+        if (!cancelled) setLoading(false);
+      }
+    }
+    void load();
+    return () => { cancelled = true; };
+  }, []);
+
+  useEffect(() => () => {
+    if (result?.url) URL.revokeObjectURL(result.url);
+  }, [result?.url]);
+
+  useEffect(() => {
+    if (textareaRef.current && !textareaRef.current.innerHTML) textareaRef.current.innerHTML = renderEditorHtml(text);
+  }, [text]);
+
+  const selectedVoice = voices.find((item) => item.id === voiceId) ?? null;
+  const filteredVoices = useMemo(() => {
+    const query = search.trim().toLocaleLowerCase();
+    return voices.filter((voice) => {
+      if (category && voice.category !== category) return false;
+      if (query && ![voice.name, voice.id, voice.desc, voice.gender, voice.genre, voice.accent, voice.style].some((value) => value?.toLocaleLowerCase().includes(query))) return false;
+      return Object.entries(filters).every(([key, value]) => !value || voice[key as keyof Voice] === value || voice.styles?.includes(value));
+    });
+  }, [category, filters, search, voices]);
+
+  useEffect(() => {
+    if (filteredVoices.length && !filteredVoices.some((item) => item.id === voiceId)) setVoiceId(filteredVoices[0].id);
+  }, [filteredVoices, voiceId]);
+
+  function setEditorText(nextText: string, caretOffset?: number) {
+    const next = normalizeText(nextText);
+    setText(next);
+    if (textareaRef.current) textareaRef.current.innerHTML = renderEditorHtml(next);
+    if (caretOffset !== undefined) {
+      window.requestAnimationFrame(() => setCaretAtRawOffset(caretOffset));
+    }
+  }
+
+  function setCaretAtRawOffset(offset: number) {
+    const root = textareaRef.current;
+    if (!root) return;
+    const selection = window.getSelection();
+    if (!selection) return;
+    const range = document.createRange();
+    let remaining = Math.max(0, offset);
+    let placed = false;
+    function visit(node: Node): void {
+      if (placed) return;
+      if (node.nodeType === Node.TEXT_NODE) {
+        const length = node.textContent?.length ?? 0;
+        if (remaining <= length) {
+          range.setStart(node, remaining);
+          range.collapse(true);
+          placed = true;
+        } else remaining -= length;
+        return;
+      }
+      if (node.nodeType === Node.ELEMENT_NODE && (node as HTMLElement).dataset.pauseMs) {
+        const markerLength = `<pause:${(node as HTMLElement).dataset.pauseMs}>`.length;
+        if (remaining <= markerLength) {
+          range.setStartAfter(node);
+          range.collapse(true);
+          placed = true;
+        } else remaining -= markerLength;
+        return;
+      }
+      Array.from(node.childNodes).forEach(visit);
+    }
+    visit(root);
+    if (!placed) {
+      range.selectNodeContents(root);
+      range.collapse(false);
+    }
+    selection.removeAllRanges();
+    selection.addRange(range);
+    root.focus();
+  }
+
+  function getSelectionOffset() {
+    const root = textareaRef.current;
+    const currentSelection = window.getSelection();
+    if (!root || !currentSelection?.anchorNode || !root.contains(currentSelection.anchorNode)) return text.length;
+    const selection = currentSelection;
+    let result = 0;
+    let reached = false;
+    function walk(node: Node): void {
+      if (reached) return;
+      if (node === selection.anchorNode) {
+        result += selection.anchorOffset;
+        reached = true;
+        return;
+      }
+      if (node.nodeType === Node.ELEMENT_NODE && (node as HTMLElement).dataset.pauseMs) {
+        result += `<pause:${(node as HTMLElement).dataset.pauseMs}>`.length;
+        return;
+      }
+      Array.from(node.childNodes).forEach((child) => {
+        if (!reached) walk(child);
+      });
+    }
+    walk(root);
+    return reached ? result : text.length;
+  }
+
+  function insertPause(ms: number) {
+    const marker = `<pause:${ms}>`;
+    const start = getSelectionOffset();
+    const next = `${text.slice(0, start)}${marker}${text.slice(start)}`;
+    setEditorText(next, start + marker.length);
+    setSelectedPause({ start, ms });
+  }
+
+  function choosePause(ms: number) {
+    if (selectedPause) {
+      const oldMarker = `<pause:${selectedPause.ms}>`;
+      if (text.slice(selectedPause.start, selectedPause.start + oldMarker.length) === oldMarker) {
+        const marker = `<pause:${ms}>`;
+        setEditorText(`${text.slice(0, selectedPause.start)}${marker}${text.slice(selectedPause.start + oldMarker.length)}`, selectedPause.start + marker.length);
+        setSelectedPause({ start: selectedPause.start, ms });
+        return;
+      }
+    }
+    insertPause(ms);
+  }
+
+  function removeSelectedPause() {
+    if (!selectedPause) return;
+    const marker = `<pause:${selectedPause.ms}>`;
+    if (text.slice(selectedPause.start, selectedPause.start + marker.length) === marker) {
+      setEditorText(`${text.slice(0, selectedPause.start)}${text.slice(selectedPause.start + marker.length)}`, selectedPause.start);
+    }
+    setSelectedPause(null);
+    setPauseOpen(false);
+  }
+
+  function applyCustomPause() {
+    const ms = Number(customPause);
+    const min = config?.pause?.min_ms ?? 50;
+    const max = config?.pause?.max_ms ?? 10000;
+    if (!Number.isInteger(ms) || ms < min || ms > max) {
+      setPauseError(`请输入 ${min}–${max} ms 之间的整数`);
       return;
     }
-    setLoggedIn(true);
+    setPauseError("");
-    const [voiceResponse, usageResponse, taskResponse] = await Promise.all([
+    choosePause(ms);
-      fetch(`${apiBase}/tts/voices`, { credentials: "include" }),
+  }
-      fetch(`${apiBase}/account/usage`, { credentials: "include" }),
+
-      fetch(`${apiBase}/tts/tasks`, { credentials: "include" }),
+  function applySymbolPauses() {
-    ]);
+    const next = text.replace(/([，。！？])(?!<pause:\d+>)/g, (match) => `${match}<pause:${symbolPauses[match]}>`);
-    const nextVoices = voiceResponse.ok ? await voiceResponse.json() : [];
+    if (next === text) setCorrectionMessage("当前标点已经完成停顿处理");
-    setVoices(nextVoices);
+    else setEditorText(next, next.length);
-    setVoice((current) => current || nextVoices[0]?.provider_voice_id || "");
+  }
-    if (usageResponse.ok) setUsage(await usageResponse.json());
+
-    if (taskResponse.ok) {
+  function applyParagraphPauses() {
-      const taskData: Task[] = await taskResponse.json();
+    const next = text.replace(/\n+(?!<pause:\d+>)/g, (match) => `${match}<pause:2000>`);
-      setTasks(taskData);
+    if (next === text) setCorrectionMessage("请先在文本中加入换行，再使用段落停顿");
-      if (!activeTask && taskData.length > 0 && taskData[0].status === "succeeded") setActiveTask(taskData[0]);
+    else setEditorText(next, next.length);
+  }
+
+  function autoSegment() {
+    const next = text.replace(/([。！？])(?!<pause:\d+>|\n)/g, "$1\n");
+    if (next === text) setHelperMessage("当前文本已经完成基础分段");
+    else {
+      setEditorText(next, next.length);
+      setHelperMessage("已按句号、问号和感叹号完成自动分段");
     }
   }
 
-  useEffect(() => { loadWorkspace().catch(() => setError("暂时无法连接 TTS 工作台")); }, []);
+  function handleEditorInput() {
-
+    if (!textareaRef.current) return;
-  async function pollTask(taskId: string) {
+    setText(normalizeText(serializeEditor(textareaRef.current)));
-    for (let attempt = 0; attempt < 180; attempt += 1) {
+    setSelectedPause(null);
-      const response = await fetch(`${apiBase}/tts/tasks/${taskId}`, { credentials: "include" });
+    setCorrectionMessage("");
-      if (!response.ok) throw new Error("无法读取任务状态");
-      const nextTask: Task = await response.json();
-      setActiveTask(nextTask);
-      if (["succeeded", "failed"].includes(nextTask.status)) return nextTask;
-      await new Promise((resolve) => window.setTimeout(resolve, 1000));
-    }
-    throw new Error("任务等待超时");
   }
 
-  async function createTask() {
+  function handleEditorClick(event: { target: EventTarget | null }) {
+    const target = event.target instanceof HTMLElement ? event.target : null;
+    const pause = target?.closest<HTMLElement>("[data-pause-ms]");
+    if (pause) {
+      const start = getElementRawOffset(pause);
+      setSelectedPause({ start, ms: Number(pause.dataset.pauseMs) });
+      setPauseOpen(true);
+      setCustomPause(pause.dataset.pauseMs ?? "1000");
+      return;
+    }
+    const typo = target?.closest<HTMLElement>("[data-typo-right]");
+    if (typo) {
+      const start = getElementRawOffset(typo);
+      const wrong = typo.textContent ?? "";
+      const right = typo.dataset.typoRight ?? wrong;
+      setEditorText(`${text.slice(0, start)}${right}${text.slice(start + wrong.length)}`, start + right.length);
+      setCorrectionMessage(`已将「${wrong}」替换为「${right}」`);
+    }
+  }
+
+  function getElementRawOffset(element: HTMLElement) {
+    const root = textareaRef.current;
+    if (!root) return 0;
+    let offset = 0;
+    let found = false;
+    function walk(node: Node): void {
+      if (found) return;
+      if (node === element) {
+        found = true;
+        return;
+      }
+      if (node.nodeType === Node.TEXT_NODE) offset += node.textContent?.length ?? 0;
+      else if (node.nodeType === Node.ELEMENT_NODE && (node as HTMLElement).dataset.pauseMs) offset += `<pause:${(node as HTMLElement).dataset.pauseMs}>`.length;
+      else Array.from(node.childNodes).forEach((child) => { if (!found) walk(child); });
+    }
+    walk(root);
+    return offset;
+  }
+
+  async function createSpeech() {
     setError("");
-    if (!loggedIn) return;
+    if (!text.trim()) return setError("请输入需要合成的文本");
-    if (!voice) return setError("当前没有可用音色，请先配置真实上游音色");
+    if (!myVoice && !voiceId) return setError("请选择一个音色");
-    if (!text.trim()) return setError("请输入需要转换的文本");
     setBusy(true);
     try {
-      const response = await fetch(`${apiBase}/tts/tasks`, {
+      let blob: Blob;
-        method: "POST",
+      if (myVoice) {
-        credentials: "include",
+        const response = await fetch("/tts-clone", {
-        headers: { "Content-Type": "application/json", "X-CSRF-Token": csrf, "Idempotency-Key": crypto.randomUUID() },
+          method: "POST",
-        body: JSON.stringify({ text: normalizeText(text), voice_id: voice, parameters: { format, speed: Number(speed) } }),
+          headers: { "Content-Type": "application/json" },
-      });
+          body: JSON.stringify({ text: normalizeText(text), reference_audio: myVoice.dataUrl, response_format: format, speed }),
-      const body = await response.json().catch(() => ({}));
+        });
-      if (!response.ok) throw new Error(body.error?.message ?? "任务创建失败");
+        if (!response.ok) {
-      const result = await pollTask(body.id);
+          const body = await response.json().catch(() => ({}));
-      if (result.status === "failed") throw new Error(`任务失败：${result.error_code ?? "TASK_FAILED"}`);
+          throw new Error(body.error?.message ?? `真人语音合成失败（${response.status}）`);
-      await loadWorkspace();
+        }
-    } catch (taskError) {
+        blob = await response.blob();
-      setError(taskError instanceof Error ? taskError.message : "任务失败");
+      } else {
+        const response = await fetch(apiUrl("/v1/audio/speech"), {
+          method: "POST",
+          headers: { "Content-Type": "application/json" },
+          body: JSON.stringify({ input: normalizeText(text), voice: voiceId, response_format: format, speed }),
+        });
+        if (!response.ok) {
+          const body = await response.json().catch(() => ({}));
+          throw new Error(body.error?.message ?? `合成失败（${response.status}）`);
+        }
+        blob = await response.blob();
+      }
+      const url = URL.createObjectURL(blob);
+      setResult({ url, format, fileName: `kaotings-tts-${new Date().toISOString().replace(/[:.]/g, "-")}.${format}` });
+    } catch (speechError) {
+      setError(speechError instanceof Error ? speechError.message : "语音合成失败");
     } finally {
       setBusy(false);
     }
   }
 
-  async function renameTask(taskId: string, rawName: string) {
+  async function startRecording() {
-    const draft = rawName.trim();
+    if (recording) return;
-    if (renaming) return;
-    setRenaming(true);
-    setError("");
     try {
-      const response = await fetch(`${apiBase}/tts/tasks/${taskId}/file-name`, {
+      const stream = await navigator.mediaDevices.getUserMedia({ audio: true });
-        method: "PATCH",
+      const preferred = ["audio/webm", "audio/mp4", "audio/ogg"].find((mime) => MediaRecorder.isTypeSupported(mime));
-        credentials: "include",
+      const recorder = new MediaRecorder(stream, preferred ? { mimeType: preferred } : undefined);
-        headers: { "Content-Type": "application/json", "X-CSRF-Token": csrf },
+      const chunks: Blob[] = [];
-        body: JSON.stringify({ file_name: draft }),
+      recorder.ondataavailable = (event) => { if (event.data.size > 0) chunks.push(event.data); };
-      });
+      recorder.onstop = () => {
-      const body = await response.json().catch(() => ({}));
+        stream.getTracks().forEach((track) => track.stop());
-      if (!response.ok) throw new Error(body.error?.message ?? "重命名失败");
+        const blob = new Blob(chunks, { type: recorder.mimeType || "audio/webm" });
-      setRenameOpen(false);
+        const reader = new FileReader();
-      await loadWorkspace();
+        reader.onload = () => {
-    } catch (e) {
+          setMyVoice({ dataUrl: String(reader.result), name: `我的声音 ${new Date().toLocaleTimeString("zh-CN", { hour12: false })}` });
-      setError(e instanceof Error ? e.message : "重命名失败");
+          setRecording(false);
-    } finally {
+        };
-      setRenaming(false);
+        reader.onerror = () => setRecording(false);
+        reader.readAsDataURL(blob);
+      };
+      recorderRef.current = recorder;
+      recorder.start();
+      setRecording(true);
+    } catch {
+      setHelperMessage("无法访问麦克风，请允许浏览器使用麦克风，或直接上传录好的音频文件");
     }
   }
 
+  function stopRecording() {
+    if (recorderRef.current && recorderRef.current.state !== "inactive") recorderRef.current.stop();
+  }
+
+  function handleVoiceFile(file: File | undefined) {
+    if (!file) return;
+    const isAudio = file.type.startsWith("audio/") || /\.(wav|mp3|m4a|ogg|webm|aac)$/i.test(file.name);
+    if (!isAudio) {
+      setHelperMessage("请上传音频文件（wav / mp3 / m4a 等）");
+      return;
+    }
+    if (file.size > 8 * 1024 * 1024) {
+      setHelperMessage("声音样本不能超过 8 MB，建议 10–60 秒清晰人声");
+      return;
+    }
+    const reader = new FileReader();
+    reader.onload = () => setMyVoice({ dataUrl: String(reader.result), name: file.name });
+    reader.readAsDataURL(file);
+  }
+
+  function clearMyVoice() {
+    setMyVoice(null);
+  }
+
+  async function handleOcr(file: File | undefined) {
+    if (!file) return;
+    if (!file.type.startsWith("image/")) {
+      setHelperMessage("请选择图片文件");
+      return;
+    }
+    if (file.size > 12 * 1024 * 1024) {
+      setHelperMessage("图片不能超过 12 MB");
+      return;
+    }
+    setHelperBusy(true);
+    setHelperMessage(`正在识别 ${file.name}…`);
+    try {
+      const imageDataUrl = await new Promise<string>((resolve, reject) => {
+        const reader = new FileReader();
+        reader.addEventListener("load", () => resolve(String(reader.result)));
+        reader.addEventListener("error", () => reject(new Error("图片读取失败")));
+        reader.readAsDataURL(file);
+      });
+      const response = await fetch("/api/v1/ocr", {
+        method: "POST",
+        credentials: "include",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({ image_data_url: imageDataUrl, filename: file.name }),
+      });
+      if (response.status === 401) throw new Error("请先登录后使用图片文字识别");
+      if (!response.ok) {
+        const body = await response.json().catch(() => ({}));
+        throw new Error(body.error?.message ?? "OCR 服务暂未连接");
+      }
+      const data = await response.json();
+      if (typeof data.text !== "string" || !data.text.trim()) throw new Error("没有识别到可用文字");
+      setEditorText(`${text ? `${text}\n` : ""}${data.text}`, text.length + data.text.length + (text ? 1 : 0));
+      setHelperMessage("图片文字已填入上方编辑区，可继续校对");
+    } catch (ocrError) {
+      setHelperMessage(ocrError instanceof Error ? ocrError.message : "图片识别失败，请稍后重试");
+    } finally {
+      setHelperBusy(false);
+      if (fileInputRef.current) fileInputRef.current.value = "";
+    }
+  }
+
+  function checkTypos() {
+    const count = countTypos(text);
+    setCorrectionMessage(count ? `发现 ${count} 处疑似错别字，点击红色波浪线即可替换` : "暂未发现内置词库中的疑似错别字");
+  }
+
+  const formatOptions = config?.formats?.length ? config.formats : ["wav", "mp3", "flac", "opus", "aac", "pcm"];
+  const minSpeed = config?.speed?.min ?? 0.25;
+  const maxSpeed = config?.speed?.max ?? 4;
+  const minPause = config?.pause?.min_ms ?? 50;
+  const maxPause = config?.pause?.max_ms ?? 10000;
+
   return <div className="container-shell py-16 sm:py-24">
-    <div className="flex flex-col justify-between gap-8 lg:flex-row lg:items-end"><SectionHeading eyebrow="AI Lab / Text to Speech" title="把文字变成声音。" description="TTS 任务现在由业务 API 持久化并归属当前用户；生成、历史、回放和下载使用真实服务状态。" tone="cyan" /><span className="rounded-full border border-cyan/30 bg-cyan/8 px-3 py-1 text-xs font-semibold text-cyan">Phase 3</span></div>
+    <div className="flex flex-col justify-between gap-8 lg:flex-row lg:items-end">
-    <div className="mt-10"><PreviewNotice>{loggedIn ? "当前使用测试数据库和真实任务 Worker。上游未配置时任务会明确失败并释放额度。" : "生成、历史、回放和下载需要登录。"}</PreviewNotice></div>
+      <SectionHeading eyebrow="AI Lab / Text to Speech" title="把文字变成声音" description="输入文案、选择音色，剩下的交给声音工作台。停顿会以直观胶囊显示，技术标记只在提交时保留。" tone="cyan" />
-    {!loggedIn ? <div className="mt-8"><StatusCard title="请先登录" description="登录后可使用真实任务、额度和历史功能。"><Link className="button-primary mt-5" href="/login"><BrandIcon />前往登录 <ArrowRight /></Link></StatusCard></div> : <>
+      <span className="rounded-full border border-cyan/30 bg-cyan/8 px-3 py-1 text-xs font-semibold text-cyan">{config?.model ?? "Qwen3-TTS"}</span>
-      <div className="mt-8 grid gap-6 lg:grid-cols-[1.2fr_0.8fr]">
+    </div>
-        <section className="rounded-2xl border border-line bg-panel/60 p-5 sm:p-7" aria-labelledby="tts-input-title"><div className="flex items-center justify-between gap-4"><div><p className="text-xs font-semibold uppercase tracking-[0.18em] text-subtle">01 / Input</p><h2 className="mt-2 text-xl font-semibold" id="tts-input-title">输入文本</h2></div><span className="text-xs text-subtle">{normalizeText(text).length} / 当前计划限制</span></div><textarea className="field-input mt-6 min-h-64 resize-y leading-7" onChange={(event) => setText(event.target.value)} placeholder="输入需要转换的文本。" value={text} /><div className="mt-5 flex flex-col gap-4 border-t border-line pt-5 sm:flex-row sm:items-center sm:justify-between"><p className="text-sm text-muted">可用额度：{usage?.available.toLocaleString() ?? "加载中"}</p><button className="button-primary" disabled={busy || !csrf} onClick={createTask} type="button"><BrandIcon />{busy ? "生成中…" : "生成语音"} <ArrowRight /></button></div></section>
+
-        <aside className="space-y-6"><section className="rounded-2xl border border-line bg-panel/60 p-5 sm:p-7" aria-labelledby="tts-settings-title"><p className="text-xs font-semibold uppercase tracking-[0.18em] text-subtle">02 / Parameters</p><h2 className="mt-2 text-xl font-semibold" id="tts-settings-title">声音参数</h2><div className="mt-6 space-y-5"><div><label className="field-label" htmlFor="voice">音色</label><select className="field-input" id="voice" onChange={(event) => setVoice(event.target.value)} value={voice}><option value="">选择音色</option>{voices.map((item) => <option key={item.id} value={item.provider_voice_id}>{item.name}{item.language ? ` · ${item.language}` : ""}</option>)}</select></div><div><span className="field-label">语速</span><div className="field-input text-muted">1.0x（V1 已验证范围）</div></div><div><span className="field-label">格式</span><div className="field-input text-muted">WAV（V1 已验证格式）</div></div></div></section><StatusCard title="额度" description={`${usage?.plan?.toUpperCase() ?? ""} · 已用 ${usage?.used.toLocaleString() ?? "-"} · 冻结 ${usage?.reserved.toLocaleString() ?? "-"}`} tone="info" /></aside>
+    <div className="mt-10 grid gap-6 lg:grid-cols-[1.2fr_0.8fr]">
-      </div>
+      <section className="rounded-2xl border border-line bg-panel/60 p-5 sm:p-7" aria-labelledby="tts-input-title">
-      {error ? <p className="mt-6 rounded-xl border border-danger/30 bg-danger/10 px-4 py-3 text-sm leading-6 text-danger" role="alert">{error}</p> : null}
+        <div className="flex items-center justify-between gap-4">
-      {activeTask?.status === "succeeded" ? <section className="mt-8 rounded-2xl border border-success/30 bg-success/5 p-5 sm:p-7"><div><p className="text-xs font-semibold uppercase tracking-[0.18em] text-success">03 / Result</p><h2 className="mt-2 text-xl font-semibold">生成完成</h2><p className="mt-2 break-all text-sm text-muted">{activeTask.file_name ?? "音频已就绪"}</p></div><div className="mt-5 flex flex-col gap-3 lg:flex-row lg:items-center"><div className="min-w-0 flex-1"><audio className="w-full" controls src={`${apiBase}/tts/tasks/${activeTask.id}/audio`} /></div><div className="flex shrink-0 gap-3"><a className="button-secondary" download href={`${apiBase}/tts/tasks/${activeTask.id}/download`}><BrandIcon />下载音频</a><button className="button-ghost" onClick={() => { setRenameDraft(activeTask.file_name ?? ""); setRenameOpen(true); }} type="button"><BrandIcon />重命名</button></div></div></section> : null}
+          <div><p className="text-xs font-semibold uppercase tracking-[0.18em] text-subtle">01 / Input</p><h2 className="mt-2 text-xl font-semibold" id="tts-input-title">输入文本</h2></div>
-      <section className="mt-8 rounded-2xl border border-line bg-panel/40 p-5 sm:p-7" aria-labelledby="tts-history-title"><div className="flex flex-col justify-between gap-3 sm:flex-row sm:items-center"><div><p className="text-xs font-semibold uppercase tracking-[0.18em] text-subtle">04 / History</p><h2 className="mt-2 text-xl font-semibold" id="tts-history-title">生成历史</h2></div><span className="text-sm text-muted">{tasks.length} 条记录</span></div>{tasks.length ? <div className="mt-6 divide-y divide-line">{tasks.map((task) => <div className="flex flex-col gap-3 py-4 sm:flex-row sm:items-center sm:justify-between" key={task.id}><div><p className="font-semibold text-copy">{task.status === "succeeded" ? "生成完成" : task.status === "failed" ? "生成失败" : "处理中"}</p><p className="mt-1 break-all text-sm text-muted">{task.status === "succeeded" ? (task.file_name ?? "音频已就绪") : `${task.voice_id} · ${task.text_length} 字`}</p><p className="mt-0.5 text-xs text-subtle">{new Date(task.created_at).toLocaleString()}</p></div>{task.audio_available ? <div className="flex gap-3"><a className="text-sm text-cyan hover:text-copy" href={`${apiBase}/tts/tasks/${task.id}/audio`}>播放</a><a className="text-sm text-cyan hover:text-copy" download href={`${apiBase}/tts/tasks/${task.id}/download`}>下载</a></div> : null}</div>)}</div> : <div className="mt-6 flex flex-col items-center justify-center rounded-xl border border-dashed border-line py-14 text-center"><span className="text-cyan"><WaveIcon className="h-9 w-9" /></span><p className="mt-4 font-semibold">还没有生成记录</p><p className="mt-2 max-w-sm text-sm leading-6 text-muted">提交第一条任务后，状态和音频访问会出现在这里。</p></div>}</section>
+          <span className="text-xs text-subtle">{visibleText(text).length} 字</span>
-    </>}
-    {renameOpen && activeTask ? (
-      <div className="fixed inset-0 z-50 flex items-center justify-center bg-black/60 p-4" role="dialog" aria-modal="true" aria-label="重命名文件">
-        <div className="w-full max-w-md rounded-2xl border border-line bg-panel p-6">
-          <h3 className="text-lg font-semibold">重命名文件</h3>
-          <p className="mt-1 text-sm text-muted">确认后将使用新文件名下载；留空恢复自动命名。</p>
-          <input
-            autoFocus
-            className="field-input mt-4"
-            maxLength={60}
-            placeholder="输入新文件名（不含扩展名）"
-            value={renameDraft}
-            onChange={(event) => setRenameDraft(event.target.value)}
-            onKeyDown={(event) => { if (event.key === "Enter") void renameTask(activeTask.id, renameDraft); }}
-          />
-          <div className="mt-5 flex justify-end gap-3">
-            <button className="button-ghost" onClick={() => setRenameOpen(false)} type="button"><BrandIcon />取消</button>
-            <button className="button-primary" disabled={renaming || !csrf} onClick={() => void renameTask(activeTask.id, renameDraft)} type="button"><BrandIcon />{renaming ? "保存中…" : "确认"}</button>
-          </div>
         </div>
-      </div>
+        <div
-    ) : null}
+          aria-label="配音文本编辑区"
+          className={`tts-editor mt-6 min-h-64 leading-7 ${!text ? "is-empty" : ""}`}
+          contentEditable
+          onClick={handleEditorClick}
+          onInput={handleEditorInput}
+          onKeyDown={(event) => {
+            if (event.key === "Enter") {
+              event.preventDefault();
+              document.execCommand("insertLineBreak");
+            }
+          }}
+          onPaste={(event) => {
+            event.preventDefault();
+            document.execCommand("insertText", false, event.clipboardData.getData("text/plain"));
+          }}
+          ref={textareaRef}
+          aria-multiline="true"
+          role="textbox"
+          spellCheck
+          suppressContentEditableWarning
+        />
+        <div className="mt-5 border-t border-line pt-5">
+          <div className="flex flex-wrap items-center gap-2">
+            <span className="mr-1 text-sm text-muted">输入停顿</span>
+            <button aria-expanded={pauseOpen} className="button-ghost min-h-9 px-3 py-1.5 text-xs" onClick={() => setPauseOpen((open) => !open)} type="button">⏸ 停顿时长 <span aria-hidden="true">⌄</span></button>
+            <button className="tool-button min-h-9" onClick={applySymbolPauses} type="button">， 符号停顿</button>
+            <button className="tool-button min-h-9" onClick={applyParagraphPauses} type="button">¶ 段落停顿</button>
+            <button className="tool-button min-h-9" onClick={checkTypos} type="button">✓ 错别字</button>
+            <button className="button-primary" disabled={busy || loading} onClick={() => void createSpeech()} type="button"><BrandIcon />{busy ? "合成中…" : "生成语音"}<ArrowRight /></button>
+          </div>
+          {pauseOpen ? <div className="pause-panel mt-4">
+            <div className="flex flex-wrap items-center gap-2">
+              {pauseOptions.map((ms) => <button className={selectedPause?.ms === ms ? "pause-option is-selected" : "pause-option"} key={ms} onClick={() => choosePause(ms)} type="button">{ms / 1000}s</button>)}
+              <span className="text-xs text-subtle">{selectedPause ? "正在编辑已选胶囊" : "点击选项插入到光标处"}</span>
+            </div>
+            <div className="mt-4 flex flex-wrap items-center gap-3 text-sm text-muted">
+              <label htmlFor="custom-pause">自定义</label>
+              <input className="pause-input" id="custom-pause" max={maxPause} min={minPause} onChange={(event) => { setCustomPause(event.target.value); setPauseError(""); }} type="number" value={customPause} />
+              <span>ms</span>
+              <input aria-label="自定义停顿时长" className="pause-range" max={maxPause} min={minPause} onChange={(event) => { setCustomPause(event.target.value); setPauseError(""); }} step="50" type="range" value={Math.min(maxPause, Math.max(minPause, Number(customPause) || minPause))} />
+              <button className="button-ghost min-h-9 px-3 py-1.5 text-xs" onClick={applyCustomPause} type="button">应用</button>
+              {selectedPause ? <button className="text-xs text-danger hover:underline" onClick={removeSelectedPause} type="button">删除已选胶囊</button> : null}
+            </div>
+            {pauseError ? <p className="mt-2 text-xs text-danger">{pauseError}</p> : null}
+            <p className="mt-3 text-xs leading-5 text-subtle">范围 {minPause}–{maxPause} ms。技术写法已隐藏，点击编辑区里的 ⏸ 胶囊可修改或删除。</p>
+          </div> : null}
+          <p className="mt-3 text-xs leading-5 text-subtle">点按钮或选时长即可插入停顿，无需手写代码。标点停顿默认：逗号 0.3s，句号 / 问号 / 感叹号 0.8s。</p>
+          {correctionMessage ? <p className="mt-3 rounded-lg border border-cyan/20 bg-cyan/5 px-3 py-2 text-xs text-cyan">{correctionMessage}</p> : null}
+        </div>
+        <p className="mt-5 border-t border-line pt-5 text-sm text-muted">{loadedAt ? `音色清单已更新 · ${voices.length} 个音色` : "正在读取音色清单…"}</p>
+        <div className="mt-6 grid gap-4 md:grid-cols-3">
+          <button className="assist-card text-left" disabled={helperBusy} onClick={() => fileInputRef.current?.click()} onDragOver={(event) => event.preventDefault()} onDrop={(event) => { event.preventDefault(); void handleOcr(event.dataTransfer.files[0]); }} type="button"><span className="assist-icon">▧</span><span><strong>图片转文字</strong><small>上传或拖入截图、纸稿、PPT，识别结果填入编辑区</small></span><span className="assist-arrow">→</span></button>
+          <button className="assist-card text-left" onClick={checkTypos} type="button"><span className="assist-icon">✓</span><span><strong>生成前查错字</strong><small>扫描疑似错字，红色波浪线标出并支持一键替换</small></span><span className="assist-arrow">→</span></button>
+          <button className="assist-card text-left" onClick={autoSegment} type="button"><span className="assist-icon">↵</span><span><strong>自动分段</strong><small>按句号、问号和感叹号切分长文案，方便控制节奏</small></span><span className="assist-arrow">→</span></button>
+        </div>
+        <input accept="image/*" className="hidden" onChange={(event) => void handleOcr(event.target.files?.[0])} ref={fileInputRef} type="file" />
+        {helperMessage ? <p className="mt-4 rounded-lg border border-cyan/20 bg-cyan/5 px-3 py-2 text-xs text-cyan">{helperMessage}</p> : null}
+        <section aria-label="真人声音配音模式" className={`voice-clone-panel mt-6 ${myVoice ? "is-ready" : ""}`}>
+          <div className="flex flex-wrap items-center gap-x-4 gap-y-3">
+            <div className="min-w-0 flex-1">
+              <p className="font-semibold"><span aria-hidden="true">🎙</span> 真人声音配音模式</p>
+              <p className="mt-1 text-xs leading-5 text-muted">录制自己的声音或上传声音样本；就绪后在上方编辑区输入文案，点击「生成语音」即可用自己的声音朗读。</p>
+            </div>
+            <div className="flex flex-wrap items-center gap-2">
+              {recording ? <button className="button-secondary" onClick={stopRecording} type="button">■ 停止录音</button> : <button className="button-secondary" onClick={() => { void startRecording(); }} type="button">● 录制我的声音</button>}
+              <button className="button-ghost min-h-9 px-3 py-1.5 text-xs" onClick={() => voiceFileRef.current?.click()} type="button">上传声音</button>
+              {myVoice ? <button className="text-xs text-danger hover:underline" onClick={clearMyVoice} type="button">清除样本</button> : null}
+            </div>
+          </div>
+          {myVoice ? <div className="mt-4 flex flex-wrap items-center gap-3">
+            <span className="rounded-full border border-cyan/30 bg-cyan/10 px-3 py-1 text-xs font-semibold text-cyan">✓ {myVoice.name} 已就绪，生成时将使用此声音</span>
+            <audio className="h-9 w-full max-w-96" controls preload="metadata" src={myVoice.dataUrl} />
+          </div> : null}
+          {recording ? <p className="mt-3 text-xs text-cyan">● 正在录音…请朗读 10–60 秒清晰人声，完成后点击「停止录音」</p> : null}
+          <input accept="audio/*,.wav,.mp3,.m4a" className="hidden" onChange={(event) => { handleVoiceFile(event.target.files?.[0]); event.target.value = ""; }} ref={voiceFileRef} type="file" />
+        </section>
+      </section>
+
+      <aside className="space-y-6">
+        <section className="rounded-2xl border border-line bg-panel/60 p-5 sm:p-7" aria-labelledby="tts-settings-title">
+          <p className="text-xs font-semibold uppercase tracking-[0.18em] text-subtle">02 / Voice & Parameters</p><h2 className="mt-2 text-xl font-semibold" id="tts-settings-title">声音参数</h2>
+          <div className="mt-6 space-y-5">
+            <div><label className="field-label" htmlFor="voice-search">搜索音色</label><input className="field-input" id="voice-search" onChange={(event) => setSearch(event.target.value)} placeholder="按名称、描述、方言或风格搜索" value={search} /></div>
+            <div className="grid gap-4 sm:grid-cols-2"><div><label className="field-label" htmlFor="voice-category">分类</label><select className="field-input" id="voice-category" onChange={(event) => setCategory(event.target.value)} value={category}><option value="">全部分类</option>{categories.map((item) => <option key={item} value={item}>{item}</option>)}</select></div>{Object.entries(facets).map(([key, values]) => <div key={key}><label className="field-label" htmlFor={`facet-${key}`}>{({ gender: "性别", genre: "类型", accent: "方言", style: "风格" } as Record<string, string>)[key] ?? key}</label><select className="field-input" id={`facet-${key}`} onChange={(event) => setFilters((current) => ({ ...current, [key]: event.target.value }))} value={filters[key] ?? ""}><option value="">全部</option>{values.map((item) => <option key={item} value={item}>{item}</option>)}</select></div>)}</div>
+            <div><label className="field-label" htmlFor="voice">音色 <span className="font-normal text-subtle">({filteredVoices.length} 个匹配)</span></label><select className="field-input" id="voice" onChange={(event) => setVoiceId(event.target.value)} value={voiceId}><option value="">选择音色</option>{categories.map((group) => { const groupVoices = filteredVoices.filter((item) => item.category === group); return groupVoices.length ? <optgroup key={group} label={group}>{groupVoices.map((item) => <option key={item.id} value={item.id}>{item.name}{item.accent ? ` · ${item.accent}` : ""}</option>)}</optgroup> : null; })}{filteredVoices.filter((item) => !item.category || !categories.includes(item.category)).map((item) => <option key={item.id} value={item.id}>{item.name}</option>)}</select></div>
+            {selectedVoice ? <div className="rounded-xl border border-cyan/20 bg-cyan/5 p-4"><p className="font-semibold text-copy">{selectedVoice.name}</p><p className="mt-1 text-sm leading-6 text-muted">{selectedVoice.desc || "暂无音色描述"}</p><div className="mt-3 flex flex-wrap gap-2 text-xs text-cyan">{[selectedVoice.gender, selectedVoice.genre, selectedVoice.accent, selectedVoice.style].filter(Boolean).map((tag) => <span className="rounded-full border border-cyan/20 px-2 py-1" key={tag}>{tag}</span>)}</div>{selectedVoice.preview ? <audio className="mt-4 w-full" controls preload="none" src={apiUrl(selectedVoice.preview)} /> : null}</div> : null}
+            <div><label className="field-label" htmlFor="speed">语速 <span className="font-normal text-subtle">{speed.toFixed(2)}x</span></label><input className="w-full accent-cyan" id="speed" max={maxSpeed} min={minSpeed} onChange={(event) => setSpeed(Number(event.target.value))} step="0.05" type="range" value={speed} /><div className="mt-1 flex justify-between text-xs text-subtle"><span>{minSpeed}x</span><span>{maxSpeed}x</span></div></div>
+            <div><label className="field-label" htmlFor="erhua">儿化音强度 <span className="font-normal text-cyan">{erhuaOptions[erhuaStrength]}</span></label><input className="w-full accent-cyan" id="erhua" max="3" min="0" onChange={(event) => setErhuaStrength(Number(event.target.value))} step="1" type="range" value={erhuaStrength} /><div className="mt-1 flex justify-between text-xs text-subtle"><span>关闭</span><span>弱</span><span>标准</span><span>强</span></div><p className="mt-2 text-xs leading-5 text-subtle">真人音色儿化偏重时，可调到「弱」或「关闭」。</p></div>
+            <div><label className="field-label" htmlFor="format">输出格式</label><select className="field-input" id="format" onChange={(event) => setFormat(event.target.value)} value={format}>{formatOptions.map((item) => <option key={item} value={item}>{item.toUpperCase()}</option>)}</select></div>
+          </div>
+        </section>
+        <StatusCard title="服务状态" description={error || (loading ? "正在连接 TTS 服务…" : `已连接 · ${voices.length} 个音色可用`)} tone={error ? "warning" : "info"} />
+      </aside>
+    </div>
+
+    {error ? <p className="mt-6 rounded-xl border border-danger/30 bg-danger/10 px-4 py-3 text-sm leading-6 text-danger" role="alert">{error}</p> : null}
+    {result ? <section className="mt-8 rounded-2xl border border-success/30 bg-success/5 p-5 sm:p-7" aria-labelledby="tts-result-title"><div className="flex items-start justify-between gap-4"><div><p className="text-xs font-semibold uppercase tracking-[0.18em] text-success">04 / Result</p><h2 className="mt-2 text-xl font-semibold" id="tts-result-title">生成完成</h2><p className="mt-2 break-all text-sm text-muted">{result.fileName}</p></div><WaveIcon className="h-8 w-8 shrink-0 text-success" /></div><audio autoPlay className="mt-5 w-full" controls src={result.url} /><div className="mt-4 flex justify-end"><a className="button-secondary" download={result.fileName} href={result.url}><BrandIcon />下载音频</a></div></section> : <section className="mt-8 rounded-2xl border border-line bg-panel/40 p-5 sm:p-7"><div className="flex min-h-28 flex-col items-center justify-center text-center"><span className="text-cyan"><WaveIcon className="h-9 w-9" /></span><p className="mt-3 font-semibold">生成结果会显示在这里</p><p className="mt-1 text-sm text-muted">选择音色并输入文本后，即可试听和下载。</p></div></section>}
+
+    <details className="mt-6 rounded-xl border border-line bg-panel/30 px-4 py-3 text-xs text-subtle"><summary className="cursor-pointer font-semibold text-muted">高级：停顿技术写法</summary><p className="mt-3 leading-6">服务端仍兼容 <code>&lt;pause:毫秒&gt;</code>、<code>[pause:毫秒]</code> 和 SSML break 写法；普通使用无需接触这些标记，编辑区里的停顿胶囊会在提交时自动转换。</p></details>
   </div>;
 }

docs/CHANGELOG.md

@@ -0,0 +1,72 @@
+# 改动记录（CHANGELOG）
+
+本文件按时间**倒序**记录每次改动的**位置**与**内容**，中文注释，便于后续接手的同学快速定位。
+
+---
+
+## 2026-09-18：TTS 页面调整 + 真人声音配音模式 + 推送凭据修复
+
+**分支**：`feat/chip-resources`
+**最新提交**：`74110fb`（已推送）
+**线上状态**：已发布到 `www.kaotings.com`，服务器 `45.197.145.138` 上的 release 为 `~/releases/74110fb-www`（systemd 服务 `kaotings-web`，Caddy 反代 `127.0.0.1:3000`）
+
+### 1. 删除「减负区」标题与说明文字（提交 `b4c3a99`）
+
+- **文件**：`app/tts/page.tsx`
+- **位置**：原输入卡片下方独立区块的头部
+- **删除内容**：`03 / Assist`、`减负区`、`把识别、校对和分段交给系统，客户只需要确认内容和听结果。`
+- **连带处理**：移除该区块上已失效的 `aria-labelledby="assist-title"`（全站无其它引用）
+
+### 2. 三个功能卡移到「音色清单」文字下方（提交 `d79c6cb`、`12eef4b`）
+
+- **文件**：`app/tts/page.tsx`（现约 576–582 行）
+- **改动**：把「图片转文字 / 生成前查错字 / 自动分段」三张 `assist-card` 从页面底部独立区块移入「01 / Input 输入文本」卡片内部，放在 `音色清单已更新 · N 个音色` 这行文字**下方**，用 `md:grid-cols-3` 三列对齐
+- **功能保全**：隐藏的图片选择 `input`（`fileInputRef`）与 OCR 提示 `helperMessage` 一并迁入，行为不变
+- **删除**：原底部独立区块（移走卡片后只剩「少打字 · 少校对 · 少返工」徽标，已随区块删除）
+- **说明**：`d79c6cb` 先放到编辑器下方，`12eef4b` 按反馈修正到「音色清单」下方，最终位置以后者为准
+
+### 3. 新增「真人声音配音模式」（提交 `14bc759`）
+
+**前端 `app/tts/page.tsx`**
+
+- 新增状态：`myVoice`（声音样本 `{ name, dataUrl }`）、`recording`（是否正在录音）
+- 新增 ref：`recorderRef`（MediaRecorder 实例）、`voiceFileRef`（音频文件选择）
+- 新增函数（约 405–470 行）：
+  - `startRecording()`：`navigator.mediaDevices.getUserMedia` + `MediaRecorder` 录音，停止后转成 data URL 存入 `myVoice`
+  - `stopRecording()`：停止录音
+  - `handleVoiceFile()`：上传音频文件（类型校验 + 8 MB 上限）
+  - `clearMyVoice()`：清除样本，回到内置音色
+- `createSpeech()` 改为**双通道**：有 `myVoice` → 调 `/tts-clone`；否则走原 `/tts/v1/audio/speech`
+- 面板 JSX（约 584–600 行）：位于三张功能卡下方，包含 `🎙 真人声音配音模式` 标题、使用说明、`● 录制我的声音 / ■ 停止录音`、`上传声音`、`清除样本`、样本试听条与「已就绪」状态
+
+**服务端 `app/tts-clone/route.ts`（新增文件）**
+
+- `POST /tts-clone`，入参 `{ text, reference_audio(data URL), response_format, speed }`
+- 读取服务端环境变量 `TTS_CLONE_URL` 转发给克隆引擎；**未配置时返回 501**（前端提示「真人配音引擎尚未接通，请先选择内置音色」，不假装成功）；上游失败返回 502
+- **路径选择原因**：线上 Caddy 中 `/api/*` 转发到 FastAPI（:8000）、`/tts/*` 转发到 TTS 引擎，只有 `/tts-clone` 这类路径会落到 Next.js
+
+**样式 `app/globals.css`**
+
+- 新增 `.voice-clone-panel`（380 行）与 `.voice-clone-panel.is-ready`（388 行）：青色描边面板，样本就绪后高亮
+
+**本地联调 `services/mock-tts/server.mjs`**
+
+- 新增 `POST /v1/audio/clone-speech`（174 行）：校验文本与 `reference_audio` 后返回演示音频
+- 配合**未提交**的 `.env.local` 中 `TTS_CLONE_URL=http://127.0.0.1:8100/v1/audio/clone-speech`，本地可跑通「录音/上传 → 生成」全流程
+
+**待后续程序员跟进**
+
+- 实测上游 TTS 引擎（`qwen3-tts`，129 个固定音色）**目前没有声音克隆接口**：无音色注册端点，未知参数会被静默忽略
+- 引擎方提供克隆接口后，只需在服务器为 `kaotings-web` 增加环境变量 `TTS_CLONE_URL`（指向克隆接口）即可启用，**前端零改动**
+
+### 4. 推送凭据问题修复（提交 `438a4d7`、`cee2074`）
+
+- **文件**：`docs/OPERATIONS.md` §8
+- **内容**：Gitea 的 OAuth access token 仅 1 小时有效，而 Git Credential Manager 无法感知过期 → 闲置超 1 小时后**第一次推送必失败**（`remote: Verify` / `Authentication failed`）
+- **修复**：新增凭据助手 `C:/Users/kts/.git-credential-kaotings.mjs`，每次用 refresh token 换新 access token；全局配置中按「空值重置 + 助手 + manager」排序（详见该章节）
+
+### 5. 本地配置纳入版本管理（提交 `74110fb`）
+
+- `next.config.ts`：新增 `rewrites()`，**仅当**设置了 `TTS_MOCK_UPSTREAM` 时把 `/tts/v1/*` 代理到本地 mock TTS（生产不设置该变量，行为不变）
+- `AGENTS.md` / `CLAUDE.md`：Next.js 16 `next dev` 自动生成的 AI 说明文件
+- `next-env.d.ts`：自动生成文件，保持生产路径（`.next/types/...`），未提交 dev 路径的临时改动

docs/OPERATIONS.md

@@ -96,3 +96,55 @@
 - **上游公网 HTTP**：上线阻断，待加密 + 来源限制 + 外部复测（`DEPLOYMENT.md` §4）。
 - **音频容量/保留/清理参数**：待用户确认（§5）。
 - **备份失败通知渠道 / 是否降权**：待用户确认（§6）。
+
+## 8. Git 推送凭据：Gitea OAuth token 1 小时过期导致「首次推送必失败」（已修复）
+
+### 8.1 现象
+
+推送时第一次总是失败，重试第二次才成功：
+
+```
+remote: Verify
+fatal: Authentication failed for 'http://rand.team:44000/Kaotings/www_site.git/'
+```
+
+### 8.2 根因（上游 Gitea token 有效期 + GCM 缓存）
+
+- 上游 Gitea（`rand.team:44000`）签发的 OAuth token 是一对 JWT，解码 payload 可见：
+  - access token：`{"gnt":2,"tt":0,"exp":iat+3600}` → **仅 1 小时有效**
+  - refresh token：`{"gnt":2,"tt":1,"exp":iat+2628000}` → 30 天有效（每次刷新会轮换）
+- Git Credential Manager 把 access token 缓存进 Windows 凭据管理器，而它对 generic OAuth 主机**无法感知 token 过期时间**，于是闲置超过 1 小时后：
+  1. 第一次推送 → GCM 返回已过期的 access token → 服务器拒绝（`remote: Verify`）；
+  2. GCM 删除该缓存凭据；
+  3. 第二次推送 → 缓存已空 → GCM 用 refresh token 静默换新 token → 成功。
+
+即：不是服务器故障，也不是密码错误，而是「1 小时 token + 无过期感知的缓存」。
+
+### 8.3 解决方式（已在本机实施）
+
+新增凭据助手 `C:/Users/kts/.git-credential-kaotings.mjs`，改为**每次都用 refresh token 换取新 access token**，并在本地记录过期时间提前 5 分钟刷新，从而第一次推送即成功。
+
+关键配置（**顺序很重要**）：git 的 helper 按 `系统 → 全局 → 仓库` 顺序追加，空值 `helper =` 会清空此前累积的列表。系统级 `C:/Program Files/Git/etc/gitconfig` 中存在 `helper = manager`（修改它需管理员权限），因此必须在全局配置 `C:/Cadence/SPB_Data/.gitconfig` 里先重置再排序：
+
+```
+[credential]
+	helper =
+	helper = !node C:/Users/kts/.git-credential-kaotings.mjs
+	helper = manager
+```
+
+- 助手只响应 `host=rand.team:44000`，其它主机静默退出并继续交给 GCM（GitHub / Azure DevOps 等不受影响）。取用凭据失败时（如令牌被撤销、服务器不可达）同样静默退出，交由 GCM 走浏览器重新授权，不会阻断推送流程。
+- 长期 refresh token **只存于 Windows 凭据管理器**（DPAPI 保护）；本地缓存 `~/.kaotings-git-token.json` 只存 1 小时的 access token；刷新时轮换得到的新 refresh token 自动回写凭据管理器。
+- 手动兜底（不依赖上述配置，例如换机器时）：
+
+```
+git -c credential.helper= -c credential.helper="!node C:/Users/kts/.git-credential-kaotings.mjs" push origin <branch>
+```
+
+- 换新机器/新环境：仍需先走一次浏览器 OAuth（GCM），拿到 refresh token 后本助手才有凭据可用。
+
+### 8.4 验证记录
+
+- 手动把缓存 access token 置为已过期后，单次 `git push` 直接成功（日志显示助手先执行并刷 token，无 401）。
+- 非目标主机（如 `example.com`）调用助手无输出、正常放行给 GCM。
+- 轮换后 refresh token `iat` 更新且已写入凭据管理器。

next.config.ts

@@ -2,6 +2,13 @@ import type { NextConfig } from "next";
 
 const nextConfig: NextConfig = {
   reactStrictMode: true,
+  async rewrites() {
+    // 设置 TTS_MOCK_UPSTREAM（见 .env.local）时，把 AI Lab 页面的 /tts/v1/* 请求代理到本地 mock TTS 服务。
+    // 生产环境不设置该变量，走 NEXT_PUBLIC_TTS_BASE_URL 指向真实引擎，行为不变。
+    const target = process.env.TTS_MOCK_UPSTREAM;
+    if (!target) return [];
+    return [{ source: "/tts/v1/:path*", destination: `${target}/v1/:path*` }];
+  },
 };
 
 export default nextConfig;

services/api/app/config.py

@@ -24,6 +24,7 @@ class Settings:
     tts_upstream_url: str
     tts_api_key: str
     tts_timeout_seconds: int
+    vision_model: str
     audio_storage_dir: str
     audio_retention_seconds: int
     smtp_host: str
@@ -58,6 +59,7 @@ class Settings:
             tts_upstream_url=os.getenv("TTS_UPSTREAM_URL", "").rstrip("/"),
             tts_api_key=os.getenv("TTS_API_KEY", ""),
             tts_timeout_seconds=int(os.getenv("TTS_TIMEOUT_SECONDS", "120")),
+            vision_model=os.getenv("VISION_MODEL", "Qwen3-VL-30B"),
             audio_storage_dir=os.getenv("AUDIO_STORAGE_DIR", "./data/audio"),
             audio_retention_seconds=int(os.getenv("AUDIO_RETENTION_SECONDS", "604800")),
             smtp_host=os.getenv("SMTP_HOST", ""),

services/api/app/main.py

@@ -1,4 +1,6 @@
 import asyncio
+import base64
+import binascii
 import hashlib
 import json
 import re
@@ -29,6 +31,7 @@ from .schemas import (
     LoginRequest,
     MembershipRequest,
     MembershipRevokeRequest,
+    OcrRequest,
     PasswordChangeRequest,
     QuotaAdjustmentRequest,
     RegisterRequest,
@@ -435,6 +438,74 @@ def health(connection: Connection = Depends(get_connection)):
     return {"status": "ok", "database": "ok", "service": "api"}
 
 
+def extract_vision_text(body: dict[str, Any]) -> str:
+    choices = body.get("choices")
+    if not isinstance(choices, list) or not choices:
+        return ""
+    message = choices[0].get("message") if isinstance(choices[0], dict) else None
+    content = message.get("content") if isinstance(message, dict) else None
+    if isinstance(content, str):
+        return content.strip()
+    if isinstance(content, list):
+        return "".join(str(item.get("text", "")) for item in content if isinstance(item, dict)).strip()
+    return ""
+
+
+@app.post("/api/v1/ocr")
+async def ocr(payload: OcrRequest, request: Request, user: dict = Depends(current_user)):
+    check_origin(request)
+    if not rate_limiter.allow(f"ocr:{user['id']}", 10, 300):
+        raise error("RATE_LIMITED", "图片识别请求过于频繁，请稍后重试", 429)
+    header, separator, encoded = payload.image_data_url.partition(",")
+    if separator != "," or not header.startswith("data:image/") or ";base64" not in header:
+        raise error("OCR_INVALID_IMAGE", "请上传有效的图片文件", 422)
+    try:
+        image = base64.b64decode(encoded, validate=True)
+    except (ValueError, binascii.Error):
+        raise error("OCR_INVALID_IMAGE", "图片数据无效，请重新上传", 422)
+    if not image or len(image) > 12 * 1024 * 1024:
+        raise error("OCR_IMAGE_TOO_LARGE", "图片不能超过 12 MB", 422)
+
+    cfg = await asyncio.to_thread(read_tts_config)
+    if not cfg["upstream_url"]:
+        raise error("UPSTREAM_NOT_CONFIGURED", "视觉模型上游尚未配置", 503)
+    headers = {"Content-Type": "application/json"}
+    if cfg["api_key"]:
+        headers["Authorization"] = f"Bearer {cfg['api_key']}"
+    upstream_payload = {
+        "model": settings.vision_model,
+        "temperature": 0,
+        "messages": [{
+            "role": "user",
+            "content": [
+                {"type": "text", "text": "请识别图片中的全部文字。保持原有阅读顺序和段落换行，只返回识别出的文字，不要解释，不要添加 Markdown。"},
+                {"type": "image_url", "image_url": {"url": payload.image_data_url}},
+            ],
+        }],
+    }
+    try:
+        async with httpx.AsyncClient(timeout=cfg["timeout_seconds"]) as client:
+            response = await client.post(f"{cfg['upstream_url']}/v1/chat/completions", headers=headers, json=upstream_payload)
+        if response.status_code in {401, 403}:
+            raise error("UPSTREAM_UNAUTHORIZED", "视觉模型鉴权失败", 502)
+        if response.status_code >= 400:
+            raise error("UPSTREAM_VISION_FAILED", "图片识别服务暂时不可用", 502)
+        try:
+            result = response.json()
+        except ValueError:
+            raise error("UPSTREAM_VISION_INVALID", "图片识别服务返回格式无效", 502)
+        text = extract_vision_text(result)
+        if not text:
+            raise error("OCR_EMPTY_RESULT", "没有识别到可用文字", 422)
+        return {"text": text, "model": settings.vision_model}
+    except httpx.TimeoutException:
+        raise error("UPSTREAM_TIMEOUT", "图片识别超时，请稍后重试", 504)
+    except HTTPException:
+        raise
+    except httpx.HTTPError:
+        raise error("UPSTREAM_UNREACHABLE", "图片识别服务暂时无法连接", 502)
+
+
 @app.get("/api/v1/auth/csrf")
 def csrf(response: Response, request: Request):
     check_origin(request)

services/api/app/schemas.py

@@ -230,6 +230,11 @@ class TtsTaskRequest(BaseModel):
     parameters: dict[str, Any] = Field(default_factory=dict)
 
 
+class OcrRequest(BaseModel):
+    image_data_url: str = Field(min_length=32, max_length=16_000_000)
+    filename: str | None = Field(default=None, max_length=200)
+
+
 class TtsVoicePublic(BaseModel):
     id: UUID
     provider_voice_id: str

services/mock-tts/server.mjs

@@ -0,0 +1,195 @@
+// 本地演示用 mock TTS 服务：实现 AI Lab 页面依赖的 /v1/audio/* 接口。
+// 启动：node services/mock-tts/server.mjs（配合 .env.local 里 TTS_MOCK_UPSTREAM=http://127.0.0.1:8100）
+// 真实上游为外部 TTS 引擎，需要服务端凭据；此服务仅用于无引擎环境下演示与联调。
+import { createServer } from "node:http";
+
+const PORT = Number(process.env.MOCK_TTS_PORT ?? 8100);
+const SAMPLE_RATE = 22050;
+
+const voices = [
+  {
+    id: "xiaoman", name: "小满", desc: "温暖亲和的女声，适合品牌宣传与产品介绍。",
+    category: "通用女声", gender: "女声", genre: "温和", accent: "普通话", style: "亲切",
+    styles: ["亲切", "自然"], preview: "/v1/previews/xiaoman.wav", range: [240, 400],
+  },
+  {
+    id: "qingluo", name: "青落", desc: "清亮利落的女声，适合新闻播报与知识讲解。",
+    category: "通用女声", gender: "女声", genre: "专业", accent: "普通话", style: "专业",
+    styles: ["专业", "清晰"], preview: "/v1/previews/qingluo.wav", range: [260, 430],
+  },
+  {
+    id: "tianxin", name: "甜芯", desc: "甜美活泼的女声，适合促销活动与社媒内容。",
+    category: "通用女声", gender: "女声", genre: "甜美", accent: "台湾腔", style: "活泼",
+    styles: ["活泼", "甜美"], preview: "/v1/previews/tianxin.wav", range: [280, 460],
+  },
+  {
+    id: "mufan", name: "沐帆", desc: "低沉沉稳的男声，适合纪录片旁白与高端品牌。",
+    category: "通用男声", gender: "男声", genre: "磁性", accent: "普通话", style: "沉稳",
+    styles: ["沉稳", "磁性"], preview: "/v1/previews/mufan.wav", range: [110, 200],
+  },
+  {
+    id: "haoran", name: "浩然", desc: "爽朗有力的男声，适合广告口号与活动主持。",
+    category: "通用男声", gender: "男声", genre: "活力", accent: "普通话", style: "有力",
+    styles: ["有力", "活力"], preview: "/v1/previews/haoran.wav", range: [130, 230],
+  },
+  {
+    id: "awan", name: "阿万", desc: "带粤语口音的男声，适合大湾区本地化内容。",
+    category: "通用男声", gender: "男声", genre: "温和", accent: "粤语", style: "自然",
+    styles: ["自然"], preview: "/v1/previews/awan.wav", range: [120, 210],
+  },
+  {
+    id: "doudou", name: "豆豆", desc: "元气满满的童声，适合儿歌故事与亲子内容。",
+    category: "童声", gender: "童声", genre: "活泼", accent: "普通话", style: "可爱",
+    styles: ["可爱", "活泼"], preview: "/v1/previews/doudou.wav", range: [300, 480],
+  },
+  {
+    id: "dongbei-ge", name: "东北哥", desc: "幽默豪爽的东北男声，适合短视频与段子配音。",
+    category: "情景演绎", gender: "男声", genre: "活力", accent: "东北腔", style: "幽默",
+    styles: ["幽默", "豪爽"], preview: "/v1/previews/dongbei-ge.wav", range: [115, 205],
+  },
+];
+
+const facets = {
+  gender: [...new Set(voices.map((v) => v.gender))],
+  genre: [...new Set(voices.map((v) => v.genre))],
+  accent: [...new Set(voices.map((v) => v.accent))],
+  style: [...new Set(voices.map((v) => v.style))],
+};
+
+function json(res, status, body) {
+  res.writeHead(status, { "Content-Type": "application/json; charset=utf-8", "Access-Control-Allow-Origin": "*" });
+  res.end(JSON.stringify(body));
+}
+
+// 极简 WAV 合成：按字符生成短音，<pause:ms> 生成静音。仅作演示，非真实语音。
+function synthesizeWav(text, voiceId, speed) {
+  const voice = voices.find((v) => v.id === voiceId) ?? voices[0];
+  const rate = Math.min(4, Math.max(0.25, Number(speed) || 1));
+  const segments = [];
+  for (const part of String(text ?? "").split(/(<pause:\d+>)/)) {
+    const pause = part.match(/^<pause:(\d+)>$/);
+    if (pause) segments.push({ pauseMs: Math.min(10000, Math.max(50, Number(pause[1]))) });
+    else if (part) segments.push({ chars: [...part] });
+  }
+  const samples = [];
+  for (const segment of segments) {
+    if (segment.pauseMs) {
+      const silence = Math.floor((SAMPLE_RATE * segment.pauseMs) / 1000 / rate);
+      samples.push(...new Array(silence).fill(0));
+      continue;
+    }
+    for (const [index, ch] of segment.chars.entries()) {
+      if (/\s/.test(ch)) {
+        samples.push(...new Array(Math.floor(SAMPLE_RATE * 0.06 / rate)).fill(0));
+        continue;
+      }
+      // 以字符与音色做种子生成 160–320Hz 的基频，让不同文本/音色听感有区分
+      const seed = (ch.codePointAt(0) * 31 + voice.id.charCodeAt(0) * 7) % 1000 / 1000;
+      const freq = voice.range[0] + seed * (voice.range[1] - voice.range[0]);
+      const duration = 0.13 + ((index % 3) * 0.02);
+      const count = Math.floor((SAMPLE_RATE * duration) / rate);
+      for (let i = 0; i < count; i += 1) {
+        const t = i / SAMPLE_RATE;
+        const envelope = Math.min(1, i / (count * 0.15), (count - i) / (count * 0.25));
+        const value = Math.sin(2 * Math.PI * freq * t) * 0.55 + Math.sin(2 * Math.PI * freq * 2 * t) * 0.18;
+        samples.push(Math.round(Math.max(-1, Math.min(1, value * envelope)) * 32000));
+      }
+      samples.push(...new Array(Math.floor(SAMPLE_RATE * 0.025 / rate)).fill(0));
+    }
+  }
+  const capped = samples.slice(0, SAMPLE_RATE * 30);
+  const buffer = Buffer.alloc(44 + capped.length * 2);
+  buffer.write("RIFF", 0);
+  buffer.writeUInt32LE(36 + capped.length * 2, 4);
+  buffer.write("WAVE", 8);
+  buffer.write("fmt ", 12);
+  buffer.writeUInt32LE(16, 16);
+  buffer.writeUInt16LE(1, 20); // PCM
+  buffer.writeUInt16LE(1, 22); // mono
+  buffer.writeUInt32LE(SAMPLE_RATE, 24);
+  buffer.writeUInt32LE(SAMPLE_RATE * 2, 28);
+  buffer.writeUInt16LE(2, 32);
+  buffer.writeUInt16LE(16, 34);
+  buffer.write("data", 36);
+  buffer.writeUInt32LE(capped.length * 2, 40);
+  capped.forEach((value, i) => buffer.writeInt16LE(value, 44 + i * 2));
+  return buffer;
+}
+
+function voiceById(id) {
+  return voices.find((v) => v.id === id);
+}
+
+const server = createServer((req, res) => {
+  const url = new URL(req.url, `http://127.0.0.1:${PORT}`);
+  if (req.method === "OPTIONS") {
+    res.writeHead(204, {
+      "Access-Control-Allow-Origin": "*",
+      "Access-Control-Allow-Methods": "GET, POST, OPTIONS",
+      "Access-Control-Allow-Headers": "Content-Type",
+    });
+    return res.end();
+  }
+  if (req.method === "GET" && url.pathname === "/v1/audio/config") {
+    return json(res, 200, {
+      model: "qwen3-tts-mock",
+      formats: ["wav"],
+      default_format: "wav",
+      speed: { min: 0.25, max: 4, default: 1 },
+      pause: {
+        supported: true, min_ms: 50, max_ms: 10000,
+        presets: [{ ms: 500, label: "0.5s" }, { ms: 1000, label: "1s" }, { ms: 2000, label: "2s" }],
+      },
+    });
+  }
+  if (req.method === "GET" && url.pathname === "/v1/audio/voices") {
+    return json(res, 200, {
+      categories: [...new Set(voices.map((v) => v.category))],
+      facets,
+      voices: voices.map(({ range, ...voice }) => voice),
+    });
+  }
+  const preview = req.method === "GET" && url.pathname.match(/^\/v1\/previews\/([\w-]+)\.wav$/);
+  if (preview) {
+    const voice = voiceById(preview[1]);
+    if (!voice) return json(res, 404, { error: { message: "音色不存在" } });
+    const audio = synthesizeWav(`你好，我是${voice.name}。`, voice.id, 1);
+    res.writeHead(200, { "Content-Type": "audio/wav", "Content-Length": audio.length, "Access-Control-Allow-Origin": "*" });
+    return res.end(audio);
+  }
+  if (req.method === "POST" && url.pathname === "/v1/audio/speech") {
+    let raw = "";
+    req.on("data", (chunk) => { raw += chunk; if (raw.length > 1_000_000) req.destroy(); });
+    req.on("end", () => {
+      let body = {};
+      try { body = JSON.parse(raw || "{}"); } catch { return json(res, 400, { error: { message: "请求体不是合法 JSON" } }); }
+      if (!voiceById(body.voice)) return json(res, 400, { error: { message: "音色不存在或未提供" } });
+      if (!String(body.input ?? "").trim()) return json(res, 400, { error: { message: "文本不能为空" } });
+      const audio = synthesizeWav(body.input, body.voice, body.speed);
+      res.writeHead(200, { "Content-Type": "audio/wav", "Content-Length": audio.length, "Access-Control-Allow-Origin": "*" });
+      res.end(audio);
+    });
+    return;
+  }
+  if (req.method === "POST" && url.pathname === "/v1/audio/clone-speech") {
+    // 真人声音配音 mock：校验文本与声音样本后返回演示音频（非真实克隆）。
+    let raw = "";
+    req.on("data", (chunk) => { raw += chunk; if (raw.length > 16_000_000) req.destroy(); });
+    req.on("end", () => {
+      let body = {};
+      try { body = JSON.parse(raw || "{}"); } catch { return json(res, 400, { error: { message: "请求体不是合法 JSON" } }); }
+      if (!String(body.input ?? "").trim()) return json(res, 400, { error: { message: "文本不能为空" } });
+      if (!String(body.reference_audio ?? "").startsWith("data:audio/")) return json(res, 400, { error: { message: "未提供声音样本 reference_audio" } });
+      const audio = synthesizeWav(body.input, "xiaoman", body.speed);
+      res.writeHead(200, { "Content-Type": "audio/wav", "Content-Length": audio.length, "Access-Control-Allow-Origin": "*" });
+      res.end(audio);
+    });
+    return;
+  }
+  if (req.method === "GET" && url.pathname === "/healthz") return json(res, 200, { status: "ok" });
+  json(res, 404, { error: { message: `mock-tts 未实现 ${req.method} ${url.pathname}` } });
+});
+
+server.listen(PORT, "127.0.0.1", () => {
+  console.log(`[mock-tts] listening on http://127.0.0.1:${PORT}`);
+});