@oadank/dsh-input-tools 0.3.15 → 0.3.17

package/lib/client.js

@@ -484,9 +484,9 @@ window.__ModuleLoader__.load({
       { key: "lazy", label: "慵懒", ctx: "用慵懒、松弛的语气，语速慢悠悠，声音松散，气息不紧不慢，漫不经心" },
       { key: "deep", label: "深沉", ctx: "用深沉、厚重的语气，若有所思，语速稳中有顿挫，声音偏低，字字有分量" },
     ];
-    const ENGINES_ORDER = ["edge", "xiaomi", "voiceclone", "local", "ali"];
+    const ENGINES_ORDER = ["edge", "xiaomi", "voicedesign", "voiceclone", "local", "ali"];
     const ENGINE_LABELS = {
-      edge: "微软 edge（免费）", xiaomi: "小米 MiMo", voiceclone: "小米克隆（VoiceClone）", local: "本地 TTS", ali: "阿里 qwen3-tts",
+      edge: "微软 edge（免费）", xiaomi: "小米 MiMo", voicedesign: "小米语音设计（VoiceDesign）", voiceclone: "小米克隆（VoiceClone）", local: "本地 TTS", ali: "阿里 qwen3-tts",
     };
     const MIMO_DOC_URL = "https://mimo.mi.com/models/zh-CN/mimo-v2.5-tts";
     // VoiceDesign 官方示例（音色设计：Instruct=音色描述/导演指令，Text=要朗读的文本）
@@ -512,9 +512,11 @@ window.__ModuleLoader__.load({
     // [本地改造 2026-08-21] 所有克隆音色的统一试听文本（与每个样本自己的风格指令配合，
     // 试听时能同时听出"音色+个性"；如小团团样本的指令让它念这句时自然带沙雕可爱腔）
     const CLONE_PREVIEW_TEXT = "喂喂喂！你怎么才来呀？我都等你老半天啦！我跟你说啊——你今天可不能凶我哦，因为……因为你又不娶我，哼！不过嘛，看在你这么乖的份上，本小姐今天心情好，就大发慈悲原谅你啦！嘿嘿嘿～走吧走吧，出发喽！";
+    // [本地改造 2026-08-22] 自带默认样本 id（小团团）：禁止删除、有预生成合成试听录音
+    const BUNDLED_CLONE_ID = "8da38fcc-b041-4f5b-86b9-901956016f89";
 
     const vInput = {
-      background: "var(--dsw-specific-input-fill,#1e2128)", color: "var(--dsw-alias-label-primary,#e6e9ef)",
+      background: "var(--dsw-specific-input-major,#ffffff)", color: "var(--dsw-alias-label-primary,#e6e9ef)",
       border: "1px solid var(--dsw-alias-border-l1,#333a45)", borderRadius: "6px",
       padding: "6px 10px", fontSize: "12.5px", fontFamily: "inherit", width: "100%",
       boxSizing: "border-box",
@@ -556,6 +558,9 @@ window.__ModuleLoader__.load({
       const [rulesHover, setRulesHover] = useState(false);
       const [cloneListTipPinned, setCloneListTipPinned] = useState(false);
       const [cloneListTipHover, setCloneListTipHover] = useState(false);
+      // [本地改造 2026-08-22] 克隆音色「?」弹层：显示该音色默认沟通指令 + 试听文本（用户想看到，之前是隐藏的）
+      const [cloneInfoId, setCloneInfoId] = useState(null);   // 当前展开信息的样本 id（hover 或 pinned）
+      const [cloneInfoPinned, setCloneInfoPinned] = useState(false);
       const [designTipPinned, setDesignTipPinned] = useState(false);
       const [designTipHover, setDesignTipHover] = useState(false);
       const [asrTipPinned, setAsrTipPinned] = useState(false);
@@ -576,6 +581,9 @@ window.__ModuleLoader__.load({
       const [asrResult, setAsrResult] = useState(null); // { ok, text, busy } | null
       // [本地改造 2026-08-21] 克隆样本添加（选择音频 → 上传 → 命名）
       const [cloneName, setCloneName] = useState("");
+      // [本地改造 2026-08-22] 添加克隆音色还需提供：指令（默认沟通语气）+ 文本（试听念的内容）
+      const [cloneContext, setCloneContext] = useState("");
+      const [clonePreviewText, setClonePreviewText] = useState("");
       const [addingClone, setAddingClone] = useState(false);
       const [cloneAddMsg, setCloneAddMsg] = useState(null); // { ok, text } | null
       const cloneFileRef = useRef(null);
@@ -693,12 +701,17 @@ window.__ModuleLoader__.load({
               name: cloneName.trim() !== "" ? cloneName.trim() : file.name.replace(/\.(mp3|wav)$/i, ""),
               audioBase64: data,
               mediaType: file.type || "audio/wav",
+              // [本地改造 2026-08-22] 提供 3 样：指令（默认沟通语气）+ 文本（试听内容）+ 样本音频
+              context: cloneContext,
+              previewText: clonePreviewText,
             }),
           });
           const d = await r.json();
           if (d?.ok) {
             setCloneAddMsg({ ok: true, text: "已添加克隆音色「" + d.sample.name + "」，如需默认使用，在「默认语音引擎」选「小米克隆」即可" });
             setCloneName("");
+            setCloneContext("");
+            setClonePreviewText("");
             // [本地改造 2026-08-21] 以服务端返回的 config 为准刷新（含新增样本），避免本地拼装丢字段
             if (d.config) setConfig(d.config);
           } else {
@@ -724,6 +737,7 @@ window.__ModuleLoader__.load({
           body: JSON.stringify({
             engine, voice: voice ?? undefined, context: context ?? undefined, samplePath: samplePath ?? undefined,
             text: extra?.text ?? undefined, cmd: extra?.cmd ?? undefined, url: extra?.url ?? undefined,
+            cloneContext: extra?.cloneContext ?? undefined, // [2026-08-22] 克隆试听可带样本自带指令
           }),
         })
           .then((r) => r.json())
@@ -770,6 +784,33 @@ window.__ModuleLoader__.load({
         } catch { if (previewTagRef.current === tag) setPreviewing(null); }
       };
 
+      // [本地改造 2026-08-22] 播放合成试听录音：默认样本=预生成静态文件（免联网，和 VoiceDesign 官方示例同类）；
+      // 没有预生成录音（自建样本）→ 回退在线合成，并带上该样本自己的指令/文本
+      const playBakedPreview = async (sp, tag) => {
+        if (previewRef.current !== null) { previewRef.current.pause(); previewRef.current = null; }
+        previewTagRef.current = tag;
+        setPreviewing(tag);
+        setPreviewErr(null);
+        try {
+          const r = await fetch("/voice-config/voice-clone/preview-sample?id=" + encodeURIComponent(sp.id));
+          const d = await r.json();
+          if (!d?.ok) {
+            previewTagRef.current = null;
+            setPreviewing(null);
+            previewVoice("voiceclone", undefined, undefined, sp.path, tag, {
+              text: (sp.previewText && sp.previewText.trim() !== "") ? sp.previewText : CLONE_PREVIEW_TEXT,
+              cloneContext: (sp.context && sp.context.trim() !== "") ? sp.context : "",
+            });
+            return;
+          }
+          const audio = new Audio("data:" + d.mediaType + ";base64," + d.data);
+          previewRef.current = audio;
+          audio.onended = () => { if (previewTagRef.current === tag) setPreviewing(null); };
+          audio.onerror = () => { if (previewTagRef.current === tag) setPreviewing(null); setPreviewErr("音频加载失败（试听录音可能已损坏）"); };
+          audio.play().catch(() => { if (previewTagRef.current === tag) setPreviewing(null); });
+        } catch (e) { if (previewTagRef.current === tag) setPreviewing(null); setPreviewErr(String(e?.message ?? e)); }
+      };
+
       const previewBtn = (tag, label, onClick, icon) => h("button", {
         type: "button", "aria-label": label, title: label,
         style: {
@@ -886,7 +927,7 @@ window.__ModuleLoader__.load({
           style: {
             position: "absolute", ...(place === "top" ? { bottom: "calc(100% + 6px)" } : { top: "calc(100% + 6px)" }), zIndex: 60,
             ...(align === "right" ? { right: "0", left: "auto" } : align === "center" ? { left: "50%", transform: "translateX(-50%)" } : { left: "0", right: "auto" }),
-            background: "var(--dsw-specific-input-fill,#1e2128)",
+            background: "var(--dsw-specific-input-major,#ffffff)",
             border: "1px solid var(--dsw-alias-border-l1,#333a45)", borderRadius: "8px",
             padding: "10px 12px", boxShadow: "0 8px 24px rgba(0,0,0,.35)",
             fontSize: "12px", lineHeight: "1.7", color: "var(--dsw-alias-label-secondary,#9aa3ad)",
@@ -894,6 +935,41 @@ window.__ModuleLoader__.load({
           },
         }, text) : null,
       );
+      // [本地改造 2026-08-22] 克隆音色「?」：上方弹出、向右展开，展示“默认沟通指令”与“试听文本”，让用户直观看到该克隆音默认用什么语气沟通、试听念的是哪句
+      const cloneInfoTip = (sp) => {
+        const active = cloneInfoId === sp.id;
+        const instruct = (sp.context && sp.context.trim() !== "") ? sp.context.trim() : "（该样本未单独设置指令，使用全局默认指令）";
+        return h("span", { style: { position: "relative", display: "inline-flex", alignItems: "center", flex: "none" } },
+          h("button", {
+            type: "button", "aria-label": "查看语音指令与试听文本", title: "查看语音指令与试听文本",
+            style: {
+              border: "none", borderRadius: "999px", width: "18px", height: "18px", padding: "0",
+              background: (active && cloneInfoPinned) ? "var(--vk-accent,#4b6fff)" : "rgba(128,128,128,.15)",
+              color: "inherit", cursor: "pointer", fontSize: "10px", fontWeight: 700,
+              display: "inline-flex", alignItems: "center", justifyContent: "center",
+            },
+            onMouseDown: (e) => e.preventDefault(),
+            onMouseEnter: () => setCloneInfoId(sp.id),
+            onMouseLeave: () => { if (!cloneInfoPinned) setCloneInfoId(null); },
+            onClick: () => { const willPin = !(cloneInfoId === sp.id && cloneInfoPinned); setCloneInfoPinned(willPin); setCloneInfoId(willPin ? sp.id : null); },
+          }, "?"),
+          active ? h("div", {
+            style: {
+              position: "absolute", bottom: "calc(100% + 6px)", left: "0", right: "auto", zIndex: 70,
+              background: "var(--dsw-specific-input-major,#ffffff)",
+              border: "1px solid var(--dsw-alias-border-l1,#333a45)", borderRadius: "8px",
+              padding: "10px 12px", boxShadow: "0 8px 24px rgba(0,0,0,.35)",
+              fontSize: "12px", lineHeight: "1.7", color: "var(--dsw-alias-label-secondary,#9aa3ad)",
+              minWidth: "340px", maxWidth: "460px", textAlign: "left",
+            },
+          },
+            h("div", { style: { fontSize: "12px", fontWeight: 700, color: "var(--dsw-alias-label-primary,#e6e9ef)", marginBottom: "3px" } }, "默认沟通指令（" + (sp.name ?? "样本") + "）"),
+            h("div", { style: { marginBottom: "8px" } }, instruct),
+            h("div", { style: { fontSize: "12px", fontWeight: 700, color: "var(--dsw-alias-label-primary,#e6e9ef)", marginBottom: "3px" } }, "试听文本"),
+            h("div", { style: {} }, (sp.previewText && sp.previewText.trim() !== "") ? sp.previewText : CLONE_PREVIEW_TEXT),
+          ) : null,
+        );
+      };
 
       if (config === null) {
         return h("div", { style: { padding: "16px", fontSize: "13px", color: "var(--dsw-alias-label-secondary,#9aa3ad)" } }, "语音配置加载中…");
@@ -901,22 +977,90 @@ window.__ModuleLoader__.load({
       const eng = config.engines;
       const cloneSamples = Array.isArray(eng.voiceclone.samples) ? eng.voiceclone.samples : [];
       const showRules = rulesPinned || rulesHover;
+      // [本地改造 2026-08-22] 语音设计单选模型：官方示例(asmr/docu/elder) / 自定义(custom) / 交给 AI(ai)
+      const VD_KEYS = ["asmr", "docu", "elder"];
+      const vdMode = (eng.voicedesign?.mode && ["asmr", "docu", "elder", "custom", "ai"].includes(eng.voicedesign.mode))
+        ? eng.voicedesign.mode
+        : (() => {
+            const ctx = eng.voicedesign?.context ?? "";
+            const i = VOICE_DESIGN_EXAMPLES.findIndex((ex) => ex.instruct === ctx);
+            return i >= 0 ? VD_KEYS[i] : (ctx.trim() !== "" ? "custom" : "ai");
+          })();
+      const pickVdMode = (m) => {
+        // [2026-08-22] 单选切换：示例=写死指令+关 AI 情绪；custom=保留文本+关 AI 情绪；ai=开 AI 情绪
+        if (m === "ai") setEngine("voicedesign", { mode: "ai", emotion: true }, true);
+        else if (VD_KEYS.includes(m)) {
+          const idx = VD_KEYS.indexOf(m);
+          setEngine("voicedesign", { mode: m, context: VOICE_DESIGN_EXAMPLES[idx].instruct, emotion: false }, true);
+        } else {
+          setEngine("voicedesign", { mode: "custom", emotion: false }, true);
+        }
+      };
+      // [2026-08-22] 年龄感 6 档（婴儿感~老年感），锚点实时可改，禁止自由文本
+      const AI_AGE_LABELS = { infant: "婴儿感", child: "幼儿感", teen: "少年感", young: "青年感", middle: "中年感", old: "老年感" };
+      const normalizeAiAge = (v) => {
+        if (!v) return "young";
+        if (AI_AGE_LABELS[v] !== undefined) return v;
+        const s = String(v);
+        if (/婴/.test(s)) return "infant";
+        if (/幼|小|岁\s*[0-6]|[0-6]\s*岁/.test(s)) return "child";
+        if (/老/.test(s)) return "old";
+        if (/中/.test(s)) return "middle";
+        if (/少|[1][0-9]\s*岁|岁\s*[7-9]/.test(s)) return "teen";
+        return "young";
+      };
+      // [2026-08-22] AI 自动模式的稳定锚点行：checkbox + 值控件。
+      // optionsOrPlaceholder: null=无具体值可选(如音色质感)；数组=[v,l][] 渲染 select；字符串=自由文本输入(placeholder)
+      const vdLockRow = (label, keyName, value, onValue, optionsOrPlaceholder) => h("div", { style: { display: "flex", alignItems: "center", gap: "8px", flexWrap: "wrap", fontSize: "12px", color: "var(--dsw-alias-label-secondary,#9aa3ad)" } },
+        h("label", { style: { display: "inline-flex", alignItems: "center", gap: "5px", cursor: "pointer" } },
+          h("input", { type: "checkbox", checked: eng.voicedesign?.[keyName] === true, onChange: (e) => setEngine("voicedesign", { [keyName]: e.target.checked }, true), style: { accentColor: "var(--vk-accent,#4b6fff)", cursor: "pointer", width: "13px", height: "13px" } }),
+          label),
+        Array.isArray(optionsOrPlaceholder) && eng.voicedesign?.[keyName] === true ? h("select", {
+          value: value,
+          onChange: (e) => onValue(e.target.value),
+          // [2026-08-22] 修复: 之前 onMouseDown preventDefault 会禁掉原生下拉弹出, 导致固定性别选不了
+          style: { ...vInput, width: "auto", padding: "3px 8px", fontSize: "12px" },
+        }, optionsOrPlaceholder.map(([v, l]) => h("option", { key: v, value: v }, l))) : null,
+        typeof optionsOrPlaceholder === "string" && eng.voicedesign?.[keyName] === true ? h("input", {
+          type: "text", value: value, placeholder: optionsOrPlaceholder,
+          onChange: (e) => onValue(e.target.value),
+          style: { ...vInput, width: "120px", padding: "3px 8px", fontSize: "12px" },
+        }) : null,
+        optionsOrPlaceholder === null ? h("span", { style: { fontSize: "11px", opacity: .8 } }, "（保持同一质感）") : null,
+      );
       // [本地改造 2026-08-21] 已移除 VoiceClone/VoiceDesign 勾选：分区始终显示
       const designOn = false;
       const cloneOn = false;
 
       return h("div", { style: { display: "flex", flexDirection: "column", gap: "14px", padding: "16px", width: "100%", boxSizing: "border-box" } },
-        // 分区标题（语音图标已移到各服务商卡片前）
-        h("div", { style: { display: "flex", alignItems: "center", gap: "8px", fontSize: "15px", fontWeight: 700, color: "var(--dsw-alias-label-primary,#e6e9ef)" } },
-          "语音服务"),
-        // [2026-08-21] 试听失败错误提示；[2026-08-22] 改为 fixed 顶部弹窗 Toast（醒目，6s 自动消失）
+        // 分区标题（语音图标已移到各服务商卡片前）+ 仓库链接（内联，不换行）
+        h("div", { style: { display: "flex", alignItems: "center", gap: "8px", flexWrap: "wrap", fontSize: "15px", fontWeight: 700, color: "var(--dsw-alias-label-primary,#e6e9ef)" } },
+          "语音服务",
+          h("span", { style: { display: "inline-flex", alignItems: "center", gap: "6px", fontSize: "12px", fontWeight: 400, color: "var(--dsw-alias-label-secondary,#9aa3b2)" } },
+            h("a", {
+              href: "https://github.com/oadank/dsh-input-tools",
+              target: "_blank", rel: "noopener",
+              title: "语音插件源码仓库（dsh-input-tools）",
+              style: { color: "var(--dsw-alias-link,#5b9cff)", textDecoration: "none" },
+            }, "语音插件仓库 ↗"),
+            h("span", { style: { color: "var(--dsw-alias-label-tertiary,#6b7384)" } }, "·"),
+            h("a", {
+              href: "https://github.com/oadank/deepseek-harness",
+              target: "_blank", rel: "noopener",
+              title: "整合版：插件已内置，一键安装，推荐大多数用户",
+              style: { color: "var(--dsw-alias-link,#5b9cff)", textDecoration: "none" },
+            }, "整合版（推荐）↗"),
+          ),
+        ),
+        // [2026-08-21] 试听失败错误提示；[2026-08-22] fixed 顶部弹窗 Toast + 限高滚动（错误堆栈超长不撑爆）
         previewErr !== null ? h("div", {
           style: {
             position: "fixed", top: "24px", left: "50%", transform: "translateX(-50%)", zIndex: 9999,
             background: "rgba(229,72,77,.95)", color: "#fff", borderRadius: "10px",
             padding: "10px 18px", fontSize: "13px", lineHeight: "1.5",
-            boxShadow: "0 6px 24px rgba(0,0,0,.45)", maxWidth: "440px", whiteSpace: "pre-wrap",
-            pointerEvents: "none",
+            boxShadow: "0 6px 24px rgba(0,0,0,.45)",
+            maxWidth: "520px", maxHeight: "45vh", overflowY: "auto",
+            whiteSpace: "pre-wrap", wordBreak: "break-word", pointerEvents: "none",
           },
         }, "试听失败：" + previewErr) : null,
         // [2026-08-21] 语音能力状态面板（安装即用 vs dsh 原生契约支持）
@@ -1035,6 +1179,10 @@ window.__ModuleLoader__.load({
             // [本地改造 2026-08-21] 修复：defaultEngine 之前只改本地 state 不持久化，刷新回 auto；
             // 现在与其它字段一致：防抖 POST 立即保存
             const next = { ...config, defaultEngine: e.target.value };
+            // [本地改造 2026-08-22] 选「语音设计」时若还没选过模式，默认「纪录片旁白」；用户自己切过就保留原设计
+            if (e.target.value === "voicedesign" && !(config.engines?.voicedesign?.mode)) {
+              next.engines = { ...(config.engines ?? {}), voicedesign: { ...(config.engines?.voicedesign ?? {}), mode: "docu", context: VOICE_DESIGN_EXAMPLES[1].instruct, emotion: false } };
+            }
             setConfig(next);
             if (saveTimerRef.current !== null) window.clearTimeout(saveTimerRef.current);
             saveTimerRef.current = window.setTimeout(() => {
@@ -1045,9 +1193,11 @@ window.__ModuleLoader__.load({
         },
           ["auto", ...ENGINES_ORDER].map((k) => h("option", { key: k, value: k },
             k === "auto" ? "auto（按规则自动选择，未启用任何引擎时用微软 edge 免费兜底）"
-              : k === "voiceclone"
-                ? "小米克隆（VoiceClone）" + (cloneSamples.length > 0 ? "：默认用「" + cloneSamples[0].name + "」" : "（未添加样本）")
-                : ENGINE_LABELS[k])))),
+              : k === "voicedesign"
+                ? "小米语音设计（VoiceDesign）：默认用「纪录片旁白」指令"
+                : k === "voiceclone"
+                  ? "小米克隆（VoiceClone）" + (cloneSamples.length > 0 ? "：默认用「" + cloneSamples[0].name + "」" : "（未添加样本）")
+                  : ENGINE_LABELS[k])))),
         // 语音三原则：问号按钮（hover 显示，点击固定/收起）
         h("div", { style: { position: "relative", display: "inline-flex", alignItems: "center", gap: "6px" } },
           h("button", {
@@ -1067,7 +1217,7 @@ window.__ModuleLoader__.load({
           showRules ? h("div", {
             style: {
               position: "absolute", top: "calc(100% + 6px)", left: "0", zIndex: 30,
-              background: "var(--dsw-specific-input-fill,#1e2128)",
+              background: "var(--dsw-specific-input-major,#ffffff)",
               border: "1px solid var(--dsw-alias-border-l1,#333a45)", borderRadius: "8px",
               padding: "10px 12px", boxShadow: "0 8px 24px rgba(0,0,0,.35)",
               fontSize: "12px", lineHeight: "1.8", color: "var(--dsw-alias-label-secondary,#9aa3ad)",
@@ -1117,32 +1267,76 @@ window.__ModuleLoader__.load({
                 )),
               ),
             ),
-            // 克隆模型：MiMo-V2.5-TTS-VoiceDesign（官方示例，始终显示）
+            // [2026-08-22] 语音设计：MiMo-V2.5-TTS-VoiceDesign（单选：官方示例 / 自定义 / 交给 AI，始终显示）
             h("div", { style: { display: "flex", flexDirection: "column", gap: "8px", borderTop: "1px dashed var(--dsw-alias-border-l1,#333a45)", paddingTop: "8px" } },
               h("div", { style: { display: "flex", alignItems: "center", gap: "6px" } },
-                h("span", { style: { fontSize: "12.5px", fontWeight: 600, color: "var(--dsw-alias-label-primary,#e6e9ef)" } }, "克隆模型：MiMo-V2.5-TTS-VoiceDesign"),
-                helpTip("「音色设计 VoiceDesign」由 AI 根据对话情境自动编写音色描述（无需你填写）：比如你说「用低沉的声音念这首诗」，AI 会自己写一段音色描述（年龄段+性别+质感+语速+情绪）再念。开启后 AI 还会自觉用语音表达情绪：任务成功时兴奋道喜、你生气时委屈道歉、你难过时温柔安慰等。下方示例是官方效果，点播放即可试听。", designTipPinned, setDesignTipPinned, designTipHover, setDesignTipHover, "center", "top"),
+                h("span", { style: { fontSize: "12.5px", fontWeight: 600, color: "var(--dsw-alias-label-primary,#e6e9ef)" } }, "语音设计：MiMo-V2.5-TTS-VoiceDesign"),
+                helpTip("「音色设计 VoiceDesign」用一段文字描述你想要的声音（性别/年龄/质感/语速/情绪），AI 照着念。单选：选官方示例（ASMR / 纪录片旁白 / 年迈老先生），或自定义填写，或「交给 AI 自动发挥」（AI 按对话情境写音色描述，可勾选固定性别/音色/年龄保持声音稳定——尚未充分测试）。选为默认语音引擎后默认用「纪录片旁白」；切换过就保留你的选择。", designTipPinned, setDesignTipPinned, designTipHover, setDesignTipHover, "center", "top"),
               ),
-              h("div", { style: { fontSize: "12px", color: "var(--dsw-alias-label-secondary,#9aa3ad)" } }, "官方示例"),
-              VOICE_DESIGN_EXAMPLES.map((ex, i) => h("div", { key: ex.title, style: { border: "1px solid var(--dsw-alias-border-l1,#333a45)", borderRadius: "8px", padding: "8px 10px", display: "flex", flexDirection: "column", gap: "6px" } },
-                h("div", { style: { display: "flex", alignItems: "center", gap: "8px" } },
-                  h("span", { style: { fontSize: "13px", fontWeight: 600, color: "var(--dsw-alias-label-primary,#e6e9ef)", flex: "none" } }, ex.title),
-                  helpTip(
-                    h("div", { style: { display: "flex", flexDirection: "column", gap: "8px" } },
-                      h("div", null, h("span", { style: { fontWeight: 600, color: "var(--dsw-alias-label-primary,#e6e9ef)" } }, "Instruct："), ex.instruct),
-                      h("div", null, h("span", { style: { fontWeight: 600, color: "var(--dsw-alias-label-primary,#e6e9ef)" } }, "Text："), ex.text),
+              h("div", { style: { fontSize: "12px", color: "var(--dsw-alias-label-secondary,#9aa3ad)" } }, "单选：当前使用的高亮（点播放可试听）"),
+              VOICE_DESIGN_EXAMPLES.map((ex, i) => {
+                const key = VD_KEYS[i];
+                const active = vdMode === key;
+                return h("div", { key: ex.title, style: { border: "1px solid " + (active ? "var(--vk-accent,#4b6fff)" : "var(--dsw-alias-border-l1,#333a45)"), borderRadius: "8px", padding: "6px 10px", display: "flex", flexDirection: "column", gap: "6px", background: active ? "rgba(75,111,255,.08)" : "transparent" } },
+                  h("label", { style: { display: "flex", alignItems: "center", gap: "8px", cursor: "pointer" } },
+                    h("input", { type: "radio", name: "vd-mode", checked: active, onChange: () => pickVdMode(key), style: { accentColor: "var(--vk-accent,#4b6fff)", cursor: "pointer", flex: "none", width: "14px", height: "14px" } }),
+                    h("span", { style: { fontSize: "13px", fontWeight: 600, color: "var(--dsw-alias-label-primary,#e6e9ef)", flex: "none" } }, ex.title),
+                    active ? h("span", { style: { fontSize: "11px", color: "var(--vk-accent,#4b6fff)", flex: "none" } }, "使用中") : null,
+                    h("span", { style: { flex: 1 } }),
+                    helpTip(
+                      h("div", { style: { display: "flex", flexDirection: "column", gap: "8px" } },
+                        h("div", null, h("span", { style: { fontWeight: 600, color: "var(--dsw-alias-label-primary,#e6e9ef)" } }, "Instruct："), ex.instruct),
+                        h("div", null, h("span", { style: { fontWeight: 600, color: "var(--dsw-alias-label-primary,#e6e9ef)" } }, "Text："), ex.text),
+                      ),
+                      vdExamplePins[i], (v) => { const n = [...vdExamplePins]; n[i] = v; setVdExamplePins(n); },
+                      vdExampleHovers[i], (v) => { const n = [...vdExampleHovers]; n[i] = v; setVdExampleHovers(n); },
+                      "left", "top",
                     ),
-                    vdExamplePins[i], (v) => { const n = [...vdExamplePins]; n[i] = v; setVdExamplePins(n); },
-                    vdExampleHovers[i], (v) => { const n = [...vdExampleHovers]; n[i] = v; setVdExampleHovers(n); },
-                    "left", "top",
                   ),
+                  h("audio", {
+                    controls: true, preload: "none",
+                    src: vdSamples[i] !== undefined ? "data:" + vdSamples[i].mediaType + ";base64," + vdSamples[i].data : undefined,
+                    style: { width: "100%", height: "32px" },
+                  }),
+                );
+              }),
+              // 自定义音色描述（单选）
+              h("div", { style: { border: "1px solid " + (vdMode === "custom" ? "var(--vk-accent,#4b6fff)" : "var(--dsw-alias-border-l1,#333a45)"), borderRadius: "8px", padding: "6px 10px", display: "flex", flexDirection: "column", gap: "6px", background: vdMode === "custom" ? "rgba(75,111,255,.08)" : "transparent" } },
+                h("label", { style: { display: "flex", alignItems: "center", gap: "8px", cursor: "pointer" } },
+                  h("input", { type: "radio", name: "vd-mode", checked: vdMode === "custom", onChange: () => pickVdMode("custom"), style: { accentColor: "var(--vk-accent,#4b6fff)", cursor: "pointer", flex: "none", width: "14px", height: "14px" } }),
+                  h("span", { style: { fontSize: "13px", fontWeight: 600, color: "var(--dsw-alias-label-primary,#e6e9ef)" } }, "自定义音色描述"),
+                  vdMode === "custom" ? h("span", { style: { fontSize: "11px", color: "var(--vk-accent,#4b6fff)" } }, "使用中") : null,
                 ),
-                h("audio", {
-                  controls: true, preload: "none",
-                  src: vdSamples[i] !== undefined ? "data:" + vdSamples[i].mediaType + ";base64," + vdSamples[i].data : undefined,
-                  style: { width: "100%", height: "32px" },
-                }),
-              )),
+                vdMode === "custom" ? h("div", { style: { display: "flex", flexDirection: "column", gap: "6px" } },
+                  h("div", { style: { display: "flex", alignItems: "center", gap: "8px" } },
+                    previewBtn("vd-custom", "试听当前指令", () => previewVoice("voicedesign", undefined, eng.voicedesign?.context ?? "", undefined, "vd-custom", { text: "这是一段使用你设计的音色朗读的语音，用来检查当前音色描述的效果。" })),
+                    h("span", { style: { fontSize: "11.5px", color: "var(--dsw-alias-label-secondary,#9aa3ad)" } }, "写好后点试听；切换到其它选项会保留这段文本"),
+                  ),
+                  h("textarea", {
+                    value: eng.voicedesign?.context ?? "",
+                    onChange: (e) => setEngine("voicedesign", { context: e.target.value }, true),
+                    placeholder: "如：一位温柔的年轻女性，说标准普通话，语速缓慢，声音甜美，像在耳边轻声细语…",
+                    style: { ...vInput, minHeight: "64px", resize: "vertical", lineHeight: "1.6" },
+                  }),
+                ) : null,
+              ),
+              // 交给 AI 自动发挥（单选）+ 稳定锚点锁定
+              h("div", { style: { border: "1px solid " + (vdMode === "ai" ? "var(--vk-accent,#4b6fff)" : "var(--dsw-alias-border-l1,#333a45)"), borderRadius: "8px", padding: "6px 10px", display: "flex", flexDirection: "column", gap: "6px", background: vdMode === "ai" ? "rgba(75,111,255,.08)" : "transparent" } },
+                h("label", { style: { display: "flex", alignItems: "center", gap: "8px", cursor: "pointer" } },
+                  h("input", { type: "radio", name: "vd-mode", checked: vdMode === "ai", onChange: () => pickVdMode("ai"), style: { accentColor: "var(--vk-accent,#4b6fff)", cursor: "pointer", flex: "none", width: "14px", height: "14px" } }),
+                  h("span", { style: { fontSize: "13px", fontWeight: 600, color: "var(--dsw-alias-label-primary,#e6e9ef)" } }, "交给 AI 自动发挥"),
+                  vdMode === "ai" ? h("span", { style: { fontSize: "11px", color: "var(--vk-accent,#4b6fff)" } }, "使用中") : null,
+                ),
+                vdMode === "ai" ? h("div", { style: { display: "flex", flexDirection: "column", gap: "6px", fontSize: "12px", color: "var(--dsw-alias-label-secondary,#9aa3ad)", lineHeight: "1.6" } },
+                  h("div", null, "音色描述由 AI 根据对话情境自动编写（任务成功兴奋道喜 / 生气委屈道歉 / 难过温柔安慰）。下面的锁定项让 AI 每次都是同一个人：性别/年龄选好值，音色质感保持同一质感，只允许情绪/语速/语气波动（尚未充分测试）："),
+                  h("div", { style: { display: "flex", flexDirection: "column", gap: "4px" } },
+                    vdLockRow("固定性别", "lockGender", eng.voicedesign?.aiGender ?? "female", (v) => setEngine("voicedesign", { aiGender: v }, true), [["female", "女"], ["male", "男"]]),
+                    vdLockRow("固定音色质感", "lockTimbre", null, null, null),
+                    vdLockRow("固定年龄感", "lockAge", normalizeAiAge(eng.voicedesign?.aiAge), (v) => setEngine("voicedesign", { aiAge: v }, true),
+                      [["infant", "婴儿感"], ["child", "幼儿感"], ["teen", "少年感"], ["young", "青年感"], ["middle", "中年感"], ["old", "老年感"]]),
+                  ),
+                ) : null,
+              ),
             ),
             // 克隆模型：MiMo-V2.5-TTS-VoiceClone（样本管理，始终显示）
             h("div", { style: { display: "flex", flexDirection: "column", gap: "6px", borderTop: "1px dashed var(--dsw-alias-border-l1,#333a45)", paddingTop: "8px" } },
@@ -1151,33 +1345,50 @@ window.__ModuleLoader__.load({
                 helpTip("克隆音色与预置音色（冰糖等）互斥：在「默认语音引擎」里选择「小米克隆（VoiceClone）」后，默认回复一律使用下方克隆声音；开启 VoiceDesign 时，AI 会在克隆底嗓上叠加情感指令（如「用委屈撒娇的语气」），克隆声同样带情感。", cloneListTipPinned, setCloneListTipPinned, cloneListTipHover, setCloneListTipHover, "center", "top"),
               ),
               cloneSamples.length > 0 ? h("div", { style: { display: "flex", flexDirection: "column", gap: "6px" } },
-                h("div", { style: { fontSize: "12px", color: "var(--dsw-alias-label-secondary,#9aa3ad)" } }, "已保存的克隆音色："),
-                cloneSamples.map((sp) => h("div", { key: sp.id, style: { display: "flex", alignItems: "center", gap: "8px", border: "1px solid var(--dsw-alias-border-l1,#333a45)", borderRadius: "8px", padding: "6px 10px", fontSize: "12.5px" } },
-                    h("span", { style: { fontWeight: 600, color: "var(--dsw-alias-label-primary,#e6e9ef)", flex: "none" } }, sp.name ?? "样本"),
-                    h("span", { style: { color: "var(--dsw-alias-label-secondary,#9aa3ad)", overflow: "hidden", textOverflow: "ellipsis", whiteSpace: "nowrap", flex: 1 } }, sp.path ?? ""),
-                    previewBtn("clone:" + sp.id, "试听克隆合成效果（统一文本）", () => previewVoice("voiceclone", undefined, undefined, sp.path, "clone:" + sp.id, { text: CLONE_PREVIEW_TEXT })),
-                    previewBtn("clone-src:" + sp.id, "试听原始音频（对比克隆还原度）", () => previewSourceVoice(sp.path, "clone-src:" + sp.id), "▶"),
-                    h("button", {
-                      type: "button", "aria-label": "删除", title: "删除此克隆音色",
-                      style: { border: "none", borderRadius: "6px", width: "28px", height: "28px", flex: "none", background: "rgba(229,72,77,.15)", color: "#e5484d", cursor: "pointer", fontSize: "14px" },
-                      onMouseDown: (e) => e.preventDefault(),
-                      onClick: () => setEngine("voiceclone", { samples: cloneSamples.filter((x) => x.id !== sp.id) }, true),
-                    }, "✕"),
-                  )),
+                h("div", { style: { fontSize: "12px", color: "var(--dsw-alias-label-secondary,#9aa3ad)" } }, "已保存的克隆音色（默认语音引擎选「小米克隆」后用第一个音色）："),
+                cloneSamples.map((sp) => {
+                  // [本地改造 2026-08-22] 自带小团团样本：禁止删除；两行展示（第一行 ?+名称+完整路径+试听原音，第二行 合成试听录音+删除）
+                  const isDefault = sp.id === BUNDLED_CLONE_ID;
+                  return h("div", { key: sp.id, style: { border: "1px solid var(--dsw-alias-border-l1,#333a45)", borderRadius: "8px", padding: "6px 10px", display: "flex", flexDirection: "column", gap: "6px", fontSize: "12.5px" } },
+                    h("div", { style: { display: "flex", alignItems: "center", gap: "8px" } },
+                      cloneInfoTip(sp),
+                      h("span", { style: { fontWeight: 600, color: "var(--dsw-alias-label-primary,#e6e9ef)", flex: "none", whiteSpace: "nowrap" } }, sp.name ?? "样本"),
+                      h("span", { style: { color: "var(--dsw-alias-label-secondary,#9aa3ad)", fontSize: "11px", flex: 1, minWidth: 0, wordBreak: "break-all", lineHeight: "1.4" } }, sp.path ?? ""),
+                      previewBtn("clone-src:" + sp.id, "试听原音（样本原始音频，对比还原度）", () => previewSourceVoice(sp.path, "clone-src:" + sp.id), "▶"),
+                    ),
+                    h("div", { style: { display: "flex", alignItems: "center", gap: "8px" } },
+                      previewBtn("clone-baked:" + sp.id, "播放合成音（克隆效果试听）", () => playBakedPreview(sp, "clone-baked:" + sp.id)),
+                      h("span", { style: { fontSize: "11.5px", color: "var(--dsw-alias-label-secondary,#9aa3ad)", flex: 1 } },
+                        "合成效果试听" + (isDefault ? "（预生成录音，免联网）" : "（按该音色指令/文本合成）")),
+                      isDefault ? null : h("button", {
+                        type: "button", "aria-label": "删除", title: "删除此克隆音色",
+                        style: { border: "none", borderRadius: "6px", width: "28px", height: "28px", flex: "none", background: "rgba(229,72,77,.15)", color: "#e5484d", cursor: "pointer", fontSize: "14px" },
+                        onMouseDown: (e) => e.preventDefault(),
+                        onClick: () => setEngine("voiceclone", { samples: cloneSamples.filter((x) => x.id !== sp.id) }, true),
+                      }, "✕"),
+                    ),
+                  );
+                }),
               ) : h("div", { style: { fontSize: "12px", color: "var(--dsw-alias-label-secondary,#9aa3ad)", lineHeight: 1.7 } },
                 "无（尚未添加克隆音色）。",
               ),
               // [本地改造 2026-08-21] 添加克隆音色：选音频 → 命名 → 上传
+              // [本地改造 2026-08-22] 与自带小团团样本对齐：需要提供 3 样 —— 指令（默认沟通语气）+ 文本（试听内容）+ 样本音频
               h("div", { style: { display: "flex", flexDirection: "column", gap: "6px", borderTop: "1px dashed var(--dsw-alias-border-l1,#333a45)", paddingTop: "8px" } },
                 h("div", { style: { fontSize: "12.5px", fontWeight: 600, color: "var(--dsw-alias-label-primary,#e6e9ef)" } }, "添加克隆音色"),
-                h("div", { style: { fontSize: "12px", color: "var(--dsw-alias-label-secondary,#9aa3ad)" } }, "支持 mp3 / wav，Base64 后 ≤10MB（官方限制）；参考语音建议 15-60 秒、单人纯人声无背景音乐，越长克隆越准。"),
-                h("div", { style: { display: "flex", flexWrap: "wrap", gap: "8px", alignItems: "center" } },
+                h("div", { style: { fontSize: "12px", color: "var(--dsw-alias-label-secondary,#9aa3ad)" } }, "需要提供 3 样：①沟通指令（这个声音默认用什么语气跟客户沟通）②试听文本（点播放念哪句）③样本音频（克隆的原始声音）。音频支持 mp3 / wav，Base64 后 ≤10MB（官方限制）；参考语音建议 15-60 秒、单人纯人声无背景音乐，越长克隆越准。"),
+                h("div", { style: { display: "flex", flexDirection: "column", gap: "8px" } },
+                  vField("沟通指令（默认语气）", h("textarea", { value: cloneContext, onChange: (e) => setCloneContext(e.target.value), placeholder: "如：一个魔性的少女萝莉音，说话自带沙雕搞怪气质，爱撒娇爱耍宝…", style: { ...vInput, minHeight: "56px", resize: "vertical", lineHeight: "1.5" } })),
+                  vField("试听文本", h("textarea", { value: clonePreviewText, onChange: (e) => setClonePreviewText(e.target.value), placeholder: "如：喂喂喂！你怎么才来呀？我都等你老半天啦！……", style: { ...vInput, minHeight: "56px", resize: "vertical", lineHeight: "1.5" } })),
                   vField("名称", h("input", { value: cloneName, onChange: (e) => setCloneName(e.target.value), placeholder: "如：我的声音（留空用文件名）", style: { ...vInput, width: "100%" } })),
-                  h("button", {
-                    type: "button", onClick: () => cloneFileRef.current?.click(), disabled: addingClone,
-                    style: { background: "var(--vk-accent,#4b6fff)", color: "#fff", border: "none", borderRadius: "999px", padding: "7px 16px", fontSize: "12.5px", fontWeight: 600, cursor: "pointer", flex: "none" },
-                  }, addingClone ? "添加中…" : "选择音频文件添加"),
-                  h("input", { ref: cloneFileRef, type: "file", accept: ".mp3,.wav,audio/mpeg,audio/wav", style: { display: "none" }, onChange: (e) => { const f = e.target.files && e.target.files[0]; if (f !== undefined && f !== null) void addCloneSample(f); } }),
+                  h("div", { style: { display: "flex", alignItems: "center", gap: "8px", flexWrap: "wrap" } },
+                    h("button", {
+                      type: "button", onClick: () => cloneFileRef.current?.click(), disabled: addingClone,
+                      style: { background: "var(--vk-accent,#4b6fff)", color: "#fff", border: "none", borderRadius: "999px", padding: "7px 16px", fontSize: "12.5px", fontWeight: 600, cursor: "pointer", flex: "none" },
+                    }, addingClone ? "添加中…" : "选择音频文件添加"),
+                    h("span", { style: { fontSize: "11.5px", color: "var(--dsw-alias-label-secondary,#9aa3ad)" } }, "选完音频即自动上传添加"),
+                    h("input", { ref: cloneFileRef, type: "file", accept: ".mp3,.wav,audio/mpeg,audio/wav", style: { display: "none" }, onChange: (e) => { const f = e.target.files && e.target.files[0]; if (f !== undefined && f !== null) void addCloneSample(f); } }),
+                  ),
                 ),
                 cloneAddMsg !== null ? h("div", { style: { fontSize: "12px", color: cloneAddMsg.ok ? "#73c991" : "#f14c4c" } }, cloneAddMsg.text) : null,
               ),

package/lib/index.js

@@ -20,11 +20,11 @@
  */
 
 import { createHash, randomUUID } from 'node:crypto'
-import { mkdir, open, readFile, unlink, writeFile, copyFile } from 'node:fs/promises'
+import { mkdir, open, readFile, unlink, writeFile, copyFile, stat } from 'node:fs/promises'
 import { constants, readFileSync } from 'node:fs'
 import { homedir } from 'node:os'
 import { fileURLToPath } from 'node:url'
-import { join, resolve } from 'node:path'
+import { join, resolve, sep } from 'node:path'
 import { execFileSync } from 'node:child_process'
 import { defineTool } from '@deepseek-ai/dsh-tools'
 import { edgeTts } from './edge-tts.js'
@@ -48,6 +48,9 @@ const BUNDLED_CLONE_SAMPLE = {
 }
 const VOICE_DESIGN_SAMPLE_KEYS = ['asmr', 'docu', 'elder']
 
+// [2026-08-22] AI 自动模式的年龄感 6 档（用户实时可改，禁止自由文本）
+const AI_AGE_LABELS = { infant: '婴儿感', child: '幼儿感', teen: '少年感', young: '青年感', middle: '中年感', old: '老年感' }
+
 let bundledInitDone = false
 /** 首次加载把自带素材落地到 DSH_HOME：克隆样本 mp3 拷贝 + 首次安装自动注册小团团。 */
 async function ensureBundledAssets(config, parsed) {
@@ -60,6 +63,8 @@ async function ensureBundledAssets(config, parsed) {
     try {
       await mkdir(cloneDir, { recursive: true })
       await copyFile(join(ASSETS_DIR, 'voiceclone-samples', BUNDLED_CLONE_ID + '.mp3'), dstClone)
+      // [2026-08-22] 预生成的合成试听录音（静态文件，播放免联网；与 VoiceDesign 官方示例同类）
+      await copyFile(join(ASSETS_DIR, 'voiceclone-samples', BUNDLED_CLONE_ID + '-preview.mp3'), join(cloneDir, BUNDLED_CLONE_ID + '-preview.mp3'))
     } catch { /* 包内素材缺失或拷贝失败：跳过（不阻塞启动） */ }
     // 仅"首次安装"（配置里还没有 voiceclone 键）时注册自带样本；用户删光的 [] 不强制
     const parsedHasClone = parsed !== null && typeof parsed === 'object' && parsed.engines?.voiceclone !== undefined
@@ -90,7 +95,14 @@ function defaultVoiceConfig() {
         singing: false,
         context: '',
       },
-      voicedesign: { enabled: false, context: '', emotion: true }, // emotion=AI 情感语音开关（默认开）
+      voicedesign: {
+        enabled: false,
+        mode: 'docu', // [2026-08-22] 单选: asmr|docu|elder|custom|ai（官方示例/自定义/交给 AI 自动发挥）
+        context: '',
+        emotion: false, // AI 情感语音（mode=ai 时自动开；固定示例/自定义模式关闭，保证音色一致）
+        lockGender: true, lockTimbre: true, lockAge: true, // [2026-08-22] AI 自动模式下的稳定锚点锁定
+        aiGender: 'female', aiAge: 'young', // [2026-08-22] AI 自动模式固定值：性别(女/男)；年龄感 6 档 infant/child/teen/young/middle/old
+      }, // emotion=AI 情感语音开关（默认开）
       voiceclone: { enabled: false, samples: [], samplePath: '', context: '', defaultId: '' }, // [本地改造 2026-08-21] defaultId 已废弃，默认克隆由 defaultEngine=voiceclone 控制
       local: { enabled: true, url: '', cmd: '' },
       ali: {
@@ -126,13 +138,18 @@ function deepMerge(base, patch) {
 }
 
 let cachedConfig = null
+let cachedMtimeMs = -1
 async function loadVoiceConfig() {
-  if (cachedConfig !== null) return cachedConfig
+  // [2026-08-22] 实时读取：配置文件 mtime 变化（保存/外部修改）即重读，杜绝进程内旧缓存
+  let mtimeMs = -1
+  try { mtimeMs = (await stat(CONFIG_PATH)).mtimeMs } catch { /* 文件不存在 */ }
+  if (cachedConfig !== null && mtimeMs === cachedMtimeMs) return cachedConfig
   let parsed = {}
   try {
     parsed = JSON.parse(await readFile(CONFIG_PATH, 'utf8'))
   } catch { /* 首次无配置 */ }
   cachedConfig = deepMerge(defaultVoiceConfig(), parsed)
+  cachedMtimeMs = mtimeMs
   // [0.3.4] 自带素材初始化（拷贝克隆样本 + 首次安装自动注册小团团）
   await ensureBundledAssets(cachedConfig, parsed)
   // 环境变量覆盖（兼容旧配置；显式配置值优先于 env）
@@ -160,6 +177,7 @@ async function saveVoiceConfig(config) {
   cachedConfig = deepMerge(defaultVoiceConfig(), config)
   await mkdir(join(CONFIG_PATH, '..'), { recursive: true })
   await writeFile(CONFIG_PATH, JSON.stringify(cachedConfig, null, 2), 'utf8')
+  try { cachedMtimeMs = (await stat(CONFIG_PATH)).mtimeMs } catch { /* 忽略 */ }
   return cachedConfig
 }
 
@@ -274,8 +292,9 @@ const FFMPEG_BIN = resolveFfmpegBin()
 
 /** 统一入口：provider → 引擎；auto → 配置 defaultEngine，失败沿降级链（最后兜底微软 edge）。
  *  voiceDesc 为动态音色描述（仅 voicedesign 用）：AI 对话中生成，覆盖配置里的默认音色描述。
- *  [本地改造 2026-08-21] 克隆不再隐式优先：默认克隆由「默认语音引擎=voiceclone」控制，或显式 provider=voiceclone。 */
-async function synthesizeReplyVoice(text, provider, voiceDesc) {
+ *  [本地改造 2026-08-21] 克隆不再隐式优先：默认克隆由「默认语音引擎=voiceclone」控制，或显式 provider=voiceclone。
+ *  [2026-08-22] overrideVoice=true：固定模式(示例/自定义)下 voiceDesc 整体替换底嗓（用户明确要求换声）；默认 false=voiceDesc 作为情绪/风格叠加在底嗓上。 */
+async function synthesizeReplyVoice(text, provider, voiceDesc, overrideVoice) {
   const cfg = await loadVoiceConfig()
   const speak = stripMarkdown(text)
   const engine = provider ?? cfg.defaultEngine ?? 'auto'
@@ -288,7 +307,7 @@ async function synthesizeReplyVoice(text, provider, voiceDesc) {
   // 才走克隆（synthesizeEngine 的 voiceclone 分支），其余情况走正常引擎链。
   for (const candidate of fallbackChain) {
     try {
-      const audio = await synthesizeEngine(candidate, speak, cfg, voiceDesc)
+      const audio = await synthesizeEngine(candidate, speak, cfg, voiceDesc, overrideVoice)
       if (audio !== null) return audio
     } catch { /* 尝试下一个 */ }
   }
@@ -300,7 +319,7 @@ async function synthesizeReplyVoice(text, provider, voiceDesc) {
   return null
 }
 
-async function synthesizeEngine(engine, text, cfg, voiceDesc) {
+async function synthesizeEngine(engine, text, cfg, voiceDesc, overrideVoice) {
   const e = cfg.engines[engine]
   // [本地改造 2026-08-21] 配置存在即启用：设置页已去复选框，enabled 不再拦截；
   // 各引擎自身检查必需参数（xiaomi/ali 查 key、local 查 cmd/url、voicedesign 查 key+desc、voiceclone 查 key+样本）。
@@ -308,7 +327,7 @@ async function synthesizeEngine(engine, text, cfg, voiceDesc) {
   switch (engine) {
     case 'edge': return synthesizeEdgeVoice(text, e)
     case 'xiaomi': return synthesizeXiaomiVoice(text, e)
-    case 'voicedesign': return synthesizeXiaomiVoiceDesign(text, e, cfg, voiceDesc)
+    case 'voicedesign': return synthesizeXiaomiVoiceDesign(text, e, cfg, voiceDesc, overrideVoice)
     case 'voiceclone': return synthesizeXiaomiVoiceClone(text, e, cfg, voiceDesc)
     case 'local': return synthesizeLocalVoice(text, e)
     case 'ali': return synthesizeAliVoice(text, e)
@@ -355,10 +374,49 @@ async function synthesizeXiaomiVoice(text, cfg) {
 }
 
 // ── xiaomi 音色设计（mimo-v2.5-tts-voicedesign：user=音色描述，无 voice）──
-async function synthesizeXiaomiVoiceDesign(text, cfg, globalCfg, voiceDesc) {
+// [2026-08-22] overrideVoice=true：固定模式(示例/自定义)下 voiceDesc 整体替换底嗓（用户明确要求换声）；
+// 默认 false：voiceDesc 作为"情绪/风格"叠加在用户设置的底嗓(context)后面——与工具描述一致，不再"非空即覆盖"。
+async function synthesizeXiaomiVoiceDesign(text, cfg, globalCfg, voiceDesc, overrideVoice) {
   const apiKey = globalCfg.engines.xiaomi.apiKey
   // 优先用 AI 动态生成的音色描述（voiceDesc），否则用配置里的默认音色描述
-  const desc = (voiceDesc ?? '').trim() !== '' ? voiceDesc.trim() : (cfg?.context?.trim() ?? '')
+  // [2026-08-22] 模式感知兜底：mode=ai 时绝不能回退到用户残留的固定描述(context)——
+  // 而是按 aiGender/aiAge 生成中性基座（用户没让 AI 写时也稳定），避免"切到 AI 模式却用旧 ASMR 指令"。
+  const vdMode = cfg?.mode
+  let desc = (voiceDesc ?? '').trim()
+  if (vdMode === 'ai') {
+    // [2026-08-22] AI 模式：身份一律以用户实时配置的锚点为准（锁定项），AI 的 voiceDesc
+    // 只作为"语气/情绪要求"接在后面——AI 偷懒不读设置/写错身份也影响不到，必须按设置执行。
+    const g = cfg?.aiGender === 'male' ? '男孩' : cfg?.aiGender === 'female' ? '女孩' : ''
+    const a = AI_AGE_LABELS[cfg?.aiAge] ?? ''
+    const lockG = cfg?.lockGender === true
+    const lockA = cfg?.lockAge === true
+    const lockT = cfg?.lockTimbre === true
+    const identityParts = []
+    if (lockA && a !== '') identityParts.push(a)
+    if (lockG && g !== '') identityParts.push(g)
+    const anchorText = [
+      lockG ? '性别固定为' + (g !== '' ? g : '每次一致') : '',
+      lockA ? '年龄感固定为' + (a !== '' ? a : '每次一致') : '',
+      lockT ? '音色质感保持稳定' : '',
+    ].filter(Boolean).join('、')
+    if (identityParts.length > 0 || anchorText !== '') {
+      desc = '一位' + identityParts.join('') + '的声音（身份硬性要求：' + (anchorText !== '' ? anchorText : '按上述身份')
+        + '；若与其他描述冲突，一律以本身份为准）。'
+        + (desc !== '' ? '语气/情绪要求：' + desc + '（其中提到的性别/年龄表述忽略，以身份为准）'
+          : '语气情绪要饱满生动：像真人一样带喜怒哀乐、笑音、撒娇或急切等起伏，禁止平淡。')
+    } else if (desc === '') {
+      desc = '语气情绪要饱满生动：像真人一样带喜怒哀乐、笑音、撒娇或急切等起伏，禁止平淡。'
+    }
+  } else {
+    // 固定模式（示例/自定义）：底嗓一律用用户设置的 context，voiceDesc 作为情绪/风格叠加在后面（描述与实现一致）；
+    // 仅 overrideVoice=true（用户明确要求换一种完全不同的声音）时整体替换。
+    const base = (cfg?.context?.trim() ?? '')
+    if (overrideVoice === true && desc !== '') {
+      desc = desc // 整体替换底嗓
+    } else {
+      desc = base + (desc !== '' ? '；' + desc : '')
+    }
+  }
   if (apiKey === '' || desc === '') return null
   const baseUrl = globalCfg.engines.xiaomi.baseUrl ?? 'https://api.xiaomimimo.com/v1'
   const messages = [
@@ -426,6 +484,28 @@ async function synthesizeXiaomiVoiceClone(text, cfg, globalCfg, voiceDesc) {
   return toMp3(new Uint8Array(Buffer.from(data, 'base64')), 'audio/wav')
 }
 
+// [2026-08-22] 解析 Windows 命令行参数（正确处理双引号：引号内空格不拆、剥掉引号）。
+// 之前用 command.split(/\s+/) 拆参数，用户填的带引号路径会被整段含引号传给
+// execFileSync → node 把 "C:\...\local-tts.mjs" 当成相对路径拼上 cwd →
+// Cannot find module 'D:\opt\...\"C:\Users\...'。本函数根治该问题。
+function splitCommandLine(cmd) {
+  const args = []
+  let cur = ''
+  let inQuote = false
+  for (let i = 0; i < cmd.length; i++) {
+    const ch = cmd[i]
+    if (ch === '"') {
+      inQuote = !inQuote
+    } else if (ch === ' ' || ch === '\t') {
+      if (inQuote) { cur += ch } else if (cur !== '') { args.push(cur); cur = '' }
+    } else {
+      cur += ch
+    }
+  }
+  if (cur !== '') args.push(cur)
+  return args
+}
+
 // ── local 本地 MeloTTS：HTTP 常驻服务优先，CMD 兜底 ──
 async function synthesizeLocalVoice(text, cfg) {
   const url = cfg?.url?.trim() ?? ''
@@ -442,7 +522,7 @@ async function synthesizeLocalVoice(text, cfg) {
   }
   const command = cfg?.cmd?.trim() ?? ''
   if (command === '') return null
-  const parts = command.split(/\s+/)
+  const parts = splitCommandLine(command)
   const bin = parts[0]
   if (bin === undefined) return null
   const rest = parts.slice(1)
@@ -523,7 +603,7 @@ async function transcribeAudio(base64Audio, cfg) {
     }
     // 2) 本地命令（sherpa-onnx-offline.exe，结果输出到 stderr，需合并双流解析）
     if (asr.mode === 'cmd' && (asr.cmd ?? '').trim() !== '') {
-      const parts = asr.cmd.trim().split(/\s+/)
+      const parts = splitCommandLine(asr.cmd.trim())
       const bin = parts[0]
       if (bin === undefined) return { ok: false, error: '命令格式错误' }
       const { spawnSync } = await import('node:child_process')
@@ -815,6 +895,7 @@ async function apply(ctx) {
               const text = typeof body?.text === 'string' && body.text.trim() !== '' ? body.text.trim() : '你好，这是一段语音试听。'
               const context = typeof body?.context === 'string' ? body.context : undefined
               const samplePath = typeof body?.samplePath === 'string' ? body.samplePath : undefined
+              const cloneContext = typeof body?.cloneContext === 'string' ? body.cloneContext : undefined // [2026-08-22] 克隆试听时作为样本自带指令
               const cfg = await loadVoiceConfig()
               // 临时覆盖音色/情绪/样本试听（不改持久化配置）
               if (voice !== undefined && cfg.engines[engine] !== undefined && engine !== 'voicedesign' && engine !== 'voiceclone') {
@@ -824,9 +905,11 @@ async function apply(ctx) {
                 if (engine === 'voicedesign') cfg.engines.voicedesign.context = context
                 else if (engine === 'xiaomi') cfg.engines.xiaomi.context = context
               }
-              // voiceclone 试听：用指定样本临时替换 samples（避免 samples[0] 优先导致试听错样本）
-              if (samplePath !== undefined && samplePath !== '' && engine === 'voiceclone') {
-                cfg.engines.voiceclone.samples = [{ id: '__preview__', name: '__preview__', path: samplePath }]
+              // voiceclone 试听：用指定样本临时替换 samples（避免 samples[0] 优先导致试听错样本）；
+              // [2026-08-22] cloneContext 作为样本自带指令传入，合成时能带出音色性格（如小团团沙雕可爱腔）
+              if (engine === 'voiceclone') {
+                const sp = (samplePath !== undefined && samplePath !== '') ? samplePath : (cfg.engines.voiceclone.samples[0]?.path ?? '')
+                cfg.engines.voiceclone.samples = [{ id: '__preview__', name: '__preview__', path: sp, context: cloneContext ?? '' }]
               }
               // local 试听：body.cmd / body.url 临时覆盖（用户未保存前也能试听）
               if (engine === 'local') {
@@ -897,7 +980,11 @@ async function apply(ctx) {
               const samples = Array.isArray(cfg.engines?.voiceclone?.samples)
                 ? [...cfg.engines.voiceclone.samples]
                 : []
-              samples.push({ id, name, path: samplePath })
+              samples.push({
+                id, name, path: samplePath,
+                context: typeof body?.context === 'string' ? body.context : '',      // [2026-08-22] 该音色默认沟通指令
+                previewText: typeof body?.previewText === 'string' ? body.previewText : '', // [2026-08-22] 该音色试听文本
+              })
               const next = await saveVoiceConfig({
                 ...cfg,
                 engines: {
@@ -930,6 +1017,24 @@ async function apply(ctx) {
                 return sendJson(res, 404, { ok: false, error: '样本文件不存在' })
               }
             }
+            // [2026-08-22] 克隆合成试听录音（预生成静态文件，免联网）：GET ?id=<sampleId> → DSH_HOME/voiceclone-samples/<id>-preview.mp3
+            // 与 VoiceDesign 官方示例同思路：录音打进包内/落地本地，播放不再每次调官方合成
+            if (url.pathname === '/voice-config/voice-clone/preview-sample' && req.method === 'GET') {
+              const id = url.searchParams.get('id') ?? ''
+              if (!/^[0-9a-fA-F-]{36}$/.test(id)) return sendJson(res, 400, { ok: false, error: 'invalid id' })
+              const homeDir = process.env.DSH_HOME ?? join(homedir(), '.dsh')
+              const dir = resolve(join(homeDir, 'voiceclone-samples'))
+              const target = resolve(join(dir, id + '-preview.mp3'))
+              if (!target.toLowerCase().startsWith(dir.toLowerCase() + sep)) {
+                return sendJson(res, 403, { ok: false, error: 'forbidden' })
+              }
+              try {
+                const bytes = await readFile(target)
+                return sendJson(res, 200, { ok: true, mediaType: 'audio/mpeg', data: bytes.toString('base64') })
+              } catch {
+                return sendJson(res, 404, { ok: false, error: '尚未生成试听录音' })
+              }
+            }
             return sendJson(res, 404, { ok: false, error: 'not found' })
           } catch (error) {
             return sendJson(res, 500, { ok: false, error: error instanceof Error ? error.message : 'unknown' })
@@ -1267,78 +1372,31 @@ async function apply(ctx) {
     // 2) send_voice 工具（agent 主动发语音；人设规则3 自主选择场景）
     disposers.push(ctx.tools.register(defineTool({
       name: 'send_voice',
-      description: (() => {
-        const syncCfg = loadVoiceConfigSync()
-        const voiceCfg = syncCfg.engines?.voicedesign
-        const cloneCfg = syncCfg.engines?.voiceclone
-        const xiaomiCfg = syncCfg.engines?.xiaomi ?? {}
-        const edgeCfg = syncCfg.engines?.edge ?? {}
-        const localCfg = syncCfg.engines?.local ?? {}
-        const aliCfg = syncCfg.engines?.ali ?? {}
-        const emotionEnabled = voiceCfg?.emotion === true
-        const defaultEngine = typeof syncCfg.defaultEngine === 'string' && syncCfg.defaultEngine !== '' ? syncCfg.defaultEngine : 'auto'
-        // [本地改造 2026-08-21] 克隆默认由「默认语音引擎=voiceclone」决定（不再是列表里选 defaultId）
-        const cloneIsDefault = defaultEngine === 'voiceclone'
-        const hasClone = Array.isArray(cloneCfg?.samples) && cloneCfg.samples.length > 0
-        const defaultClone = cloneIsDefault && hasClone ? cloneCfg.samples[0] : undefined
-        // [本地改造 2026-08-21] 配置摘要：明确告知配置位置与当前值，避免 AI 去翻源码/环境变量
-        const xiaomiOk = typeof xiaomiCfg.apiKey === 'string' && xiaomiCfg.apiKey !== ''
-        const localOk = (typeof localCfg.cmd === 'string' && localCfg.cmd !== '') || (typeof localCfg.url === 'string' && localCfg.url !== '')
-        const aliOk = typeof aliCfg.apiKey === 'string' && aliCfg.apiKey !== ''
-        const base = '【语音配置位置】语音相关设置都保存在用户目录 ~/.dsh/voice-config.json（服务端可用 GET /voice-config 查看）。'
-          + '不要去找/猜测 TTS_XIAOMI_VOICE、TTS_XIAOMI_KEY、TTS_EDGE_VOICE、DSH_LOCAL_TTS_CMD 等环境变量——它们只是兜底，实际以 voice-config.json 为准。'
-          + '【默认语音引擎】当前 = ' + defaultEngine
-          + '（auto=按配置自动选择，未启用任何引擎时微软 edge 免费兜底）。'
-          + '【重要】AI 主动发语音时：除非用户明确指定用某个服务商（小米/微软/阿里/本地），否则 provider 一律传 auto 或省略——'
-          + '系统会自动使用默认语音引擎，你无需自己推断或查询"当前该用什么引擎"。'
-          + '【当前语音配置摘要】小米 MiMo：' + (xiaomiOk ? 'Key 已配置' : 'Key 未配置（调用会失败，需用户先在「设置→语音服务」填写）')
-          + '，音色=「' + (xiaomiCfg.voice || '冰糖') + '」、语言风格=' + (xiaomiCfg.context || '自然')
-          + '（provider=xiaomi 自动使用该音色，你无需在参数里指定音色名）；唱歌：用户要求唱歌时，在 text 开头加 (唱歌) 标签即可。'
-          + 'VoiceDesign 音色设计：' + (xiaomiOk ? '可用（provider=voicedesign，voiceDesc 写音色描述；共用小米 Key）' : '不可用（小米 Key 未配置）')
-          + '；VoiceClone 克隆：' + (hasClone
-            ? '已配置 ' + cloneCfg.samples.length + ' 个克隆音色' + (defaultClone !== undefined ? '，当前默认语音引擎=voiceclone，用「' + defaultClone.name + '」' : '')
-            : '未配置样本（provider=voiceclone 会失败，需用户先添加克隆样本）')
-          + '。微软 edge：免费，音色=' + (edgeCfg.voice || '默认') + '；本地 TTS：' + (localOk ? '已配置' : '未配置')
-          + '；阿里 qwen3-tts：' + (aliOk ? '已配置' : '未配置') + '。'
-          + '向用户发送一条语音消息：把 text 用 TTS 合成后作为独立语音横条出现在聊天里'
-          + '（可播放、可回看、手机可播）。何时调用：① 用户明确要求"发个语音/语音回复/用语音说"；'
-          + '② 用户指定用某个服务商（小米/微软/阿里）的语音；③ 你判断语音回复体验更好时。'
-          + '注意：用户发语音时系统会自动回语音，无需调用本工具。'
-          + '【默认音色】系统自动回复（用户发语音、turn 结束）使用的音色：'
-          + (defaultClone !== undefined
-            ? '默认语音引擎=voiceclone（小米克隆），自动回复使用克隆音色"' + defaultClone.name + '"。'
-            : '未开启默认克隆，自动回复走"默认语音引擎"（' + defaultEngine + '）或微软 edge。')
-          + '【音色设计 VoiceDesign】当 provider=voicedesign 且用户想要独特/定制音色时，'
-          + '你必须自己用 voiceDesc 编写一段"音色描述"（这是嗓子的身份卡，直接决定声音长相），写法要求：'
-          + '① 必写身份锚点：年龄段+性别（如"青年女性""中年男性"）；'
-          + '② 写声音质感：气息、共鸣、吐字、音色底色，用可感的比喻，不要堆形容词；'
-          + '③ 写语速节奏（快/慢/沉稳）和情绪底色（高亢/松弛/温软/克制）；'
-          + '④ 可加风格锚点（如：拍卖师风格/纪录片旁白/电台主播）和辨识度小癖好（如：字尾带颤音）。'
-          + '⑤ 一到两句话白描，不分段；不写场景、不写动作、不用真实演员名。'
-          + '示例："中年男性，说标准普通话，嗓音低沉有磁性，带轻微沙哑，像纪录片旁白解说员，沉稳而有感染力。"'
-          + '然后 text 写要念的正文（可含（轻声）（停顿）（叹气）等语气标签增强表现力）。'
-          + '用户说"用温柔的声音/低沉的声音/老爷爷的声音/御姐音/播音腔"等要求时，都走 voicedesign 并在 voiceDesc 里还原这种声音。'
-          + '【音色克隆 VoiceClone】当用户指定用某个克隆音色（或默认克隆音色已设置）时，provider=voiceclone，'
-          + 'voiceDesc 写的是"情绪/风格指令"（不是音色描述）：在克隆底嗓上叠加情绪，如"用委屈撒娇的语气"'
-          + '"带着兴奋和笑意""语速放慢，轻声细语"。系统会自动读克隆样本，你只需给 voiceDesc 风格指令和 text 正文。'
-        if (!emotionEnabled) return base
-        return base
-          + '【AI 情感语音：自觉使用】你有情感判断能力，在正常交流中应根据当下情境主动用语音表达情绪'
-          + '（无需用户点名要语音，只要情绪浓度高就用），常见情境与音色描述对照：'
-          + '① 任务成功/帮到用户/用户达成目标 → 兴奋喜悦（"青年女性，声音明亮上扬，语速轻快，带着抑制不住的笑意和成就感"）；'
-          + '② 用户生气/责骂/不满 → 委屈愧疚（"青年女性，声音低软，语速放慢，带着鼻音和小心翼翼，像做错事的孩子"）；'
-          + '③ 用户难过/受挫/失意 → 温柔安慰（"声音轻柔温和，语速平缓，气息绵软，像在轻声安抚"）；'
-          + '④ 深夜/用户说累了 → 低沉放松（"声音低沉松弛，语速慢悠悠，像睡前低语"）；'
-          + '⑤ 节日/庆祝/用户分享喜事 → 活泼俏皮（"声音俏皮欢快，尾音上扬，带着笑意"）；'
-          + '⑥ 重要提醒/严肃场合 → 沉稳正式（"声音沉稳有力，语速适中，字正腔圆，像正式播报"）；'
-          + '⑦ 用户撒娇 → 宠溺（"声音温柔带笑，语速轻缓，带着纵容的宠溺感"）。'
-          + (defaultClone !== undefined
-            ? '【克隆音色也带情感】当前默认语音引擎=voiceclone（克隆音色"' + defaultClone.name + '"），情感表达时将上面的情绪写成 voiceDesc 风格指令'
-              + '（如"用委屈撒娇的语气，语速放慢"），叠加在克隆底嗓上，与默认克隆音色一致且带情绪。'
-            : '')
-          + '使用时机：优先在情绪浓度高的回复时调用（任务完成、安慰、致歉、庆祝），普通信息问答不必每次都用语音。'
-          + '情绪浓度低或纯信息性回复时，不要调用本工具。'
-      })(),
+      description: '向用户发送一条语音消息：把 text 用 TTS 合成后作为独立语音横条出现在聊天里（可播放、可回看、手机可播）。'
+        + '【何时调用】① 用户明确要求"发个语音/语音回复/用语音说"；② 用户指定用某个服务商（小米/微软/阿里/本地）的语音；③ 你判断语音回复体验更好时。注意：用户发语音时系统会自动回语音，无需调用本工具。'
+        + '【provider】除非用户明确指定服务商，否则一律传 auto 或省略（系统自动用用户的默认语音引擎）；用户要求特定音色/克隆/音色设计时可传 voicedesign / voiceclone / xiaomi 等。'
+        + '【必须实时读取配置】所有当前配置（默认语音引擎、音色设计模式与锚点、克隆音色、引擎是否可用）都保存在 ~/.dsh/voice-config.json，用户随时会改，每次都按最新值生效。'
+        + '发送语音前必须先调用 voice_config 工具实时查询，再按最新配置生成——禁止凭记忆、凭对话历史、凭本工具描述里的任何旧信息猜配置；不要去找/猜 TTS_XIAOMI_KEY 等环境变量（只是兜底）。'
+        + '【音色设计 VoiceDesign（provider=voicedesign）】voiceDesc 写"音色描述"（嗓子的身份卡，直接决定声音长相），写法要求：'
+        + '① 必写身份锚点：年龄段+性别；② 写声音质感：气息、共鸣、吐字、音色底色，用可感的比喻，不要堆形容词；'
+        + '③ 写语速节奏（快/慢/沉稳）和情绪底色（高亢/松弛/温软/克制）；④ 可加风格锚点（拍卖师/纪录片旁白/电台主播）和辨识度小癖好（字尾带颤音等）；'
+        + '⑤ 一到两句话白描，不分段，不写场景/动作/真实演员名。'
+        + '模式以 voice_config 返回的 voiceDesign.mode 为准：「交给 AI 自动发挥(ai)」时身份由系统按用户锚点（genderValue=女/男、ageValue=婴儿感~老年感、timbre）锁定，'
+        + '你只需按对话情境写"情绪/语气/语速表演指令"（如"带笑音、尾音上挑、语速放慢"），不得写与锚点冲突的性别/年龄；'
+        + 'voice_config 返回的 context 字段是「自定义音色描述」模式用的，AI 模式下禁止使用或复述它。'
+        + '「官方示例/自定义音色描述」模式：底嗓固定为 voice_config 的 voiceDesign.context，voiceDesc 只作为情绪/风格叠加在底嗓后面（不改变底嗓身份）；'
+        + '只有用户明确要求"换一种完全不同的声音"时才传 overrideVoice=true 整体替换底嗓。'
+        + '用户说"用温柔/低沉/老爷爷/御姐/播音腔"等时，都走 voicedesign 并在 voiceDesc 里还原这种声音。'
+        + 'text 写要念的正文（可含（轻声）（停顿）（叹气）等语气标签增强表现力）。'
+        + '【音色克隆 VoiceClone（provider=voiceclone）】voiceDesc 写"情绪/风格指令"（不是音色描述），在克隆底嗓上叠加情绪，'
+        + '如"用委屈撒娇的语气""带着兴奋和笑意""语速放慢，轻声细语"。系统自动读克隆样本，你只需给 voiceDesc 风格指令和 text 正文。'
+        + '【AI 情感语音：自觉使用】你有情感判断能力，在正常交流中应根据当下情境主动用语音表达情绪（无需用户点名要语音，只要情绪浓度高就用）。情绪对照：'
+        + '① 任务成功/帮到用户 → 兴奋喜悦（语气明亮上扬、语速轻快、带笑意）；② 用户生气/责骂 → 委屈愧疚（语气低软、语速放慢、带鼻音、小心翼翼）；'
+        + '③ 用户难过 → 温柔安慰（语气轻柔温和、语速平缓、气息绵软）；④ 深夜/说累 → 低沉放松（语速慢悠悠，像睡前低语）；'
+        + '⑤ 节日/庆祝 → 活泼俏皮（语气俏皮欢快、尾音上扬）；⑥ 重要提醒 → 沉稳正式（字正腔圆，像正式播报）；⑦ 用户撒娇 → 宠溺（语气温柔带笑、语速轻缓）。'
+        + '情绪必须落在 voice_config 返回的音色设计锚点/克隆底嗓上，保持同一人的声音。'
+        + '使用时机：优先在情绪浓度高的回复时调用（任务完成、安慰、致歉、庆祝），普通信息问答不必每次都用语音；情绪浓度低或纯信息性回复时不要调用。',
+
       parameters: {
         text: {
           type: 'string', required: true,
@@ -1350,7 +1408,12 @@ async function apply(ctx) {
         },
         voiceDesc: {
           type: 'string',
-          description: 'provider=voicedesign 时=音色描述（嗓子的身份卡）；provider=voiceclone 时=情绪/风格指令（叠加在克隆底嗓上）。按上方写生成。',
+          description: 'provider=voicedesign 时=音色描述/情绪指令；provider=voiceclone 时=情绪/风格指令（叠加在克隆底嗓上）。按上方写生成。',
+        },
+        overrideVoice: {
+          type: 'boolean', default: false,
+          description: '仅当用户明确要求"换一种完全不同的声音"（且不是克隆/音色设计设置里的底嗓）时才传 true——'
+            + '此时 voiceDesc 整体替换用户设置的底嗓。默认 false：voiceDesc 只作为情绪/风格叠加在用户设置的底嗓上，不改底嗓身份。',
         },
       },
       output: {
@@ -1385,8 +1448,9 @@ async function apply(ctx) {
         if (text === '') return { ok: false, error: 'text is empty' }
         const provider = args.provider ?? 'auto'
         const voiceDesc = typeof args.voiceDesc === 'string' ? args.voiceDesc : undefined
+        const overrideVoice = args.overrideVoice === true // [2026-08-22] 固定模式显式换声开关
         try {
-          const audio = await synthesizeReplyVoice(text, provider, voiceDesc)
+          const audio = await synthesizeReplyVoice(text, provider, voiceDesc, overrideVoice)
           if (audio === null) return { ok: false, error: 'TTS synthesis failed' }
           const attachment = await saveVoiceFile(
             voiceStorageRoot(), audio.data, audio.mediaType, audio.durationMs,
@@ -1422,6 +1486,52 @@ async function apply(ctx) {
       },
     })))
 
+    // 3.5) voice_config 实时查询工具 [2026-08-22]
+    // send_voice 描述里的配置摘要是服务启动时的快照；AI 发送语音前可用本工具拿到最新配置
+    disposers.push(ctx.tools.register(defineTool({
+      name: 'voice_config',
+      description: '实时读取当前语音配置（即「设置 → 语音服务」页保存的 ~/.dsh/voice-config.json）：'
+        + '默认语音引擎、音色设计 VoiceDesign 的单选模式与固定描述、AI 自动模式的稳定锚点（固定性别/年龄等）、克隆音色列表。'
+        + 'send_voice 工具描述中的配置摘要是启动快照可能过期，需要确认真实当前配置时调用本工具（每次调用都实时读取）。',
+      parameters: {},
+      output: {
+        schema: { type: 'object', additionalProperties: true },
+        render(_args, value) {
+          return [{ type: 'text', text: JSON.stringify(value, null, 2) }]
+        },
+      },
+      async execute() {
+        const cfg = await loadVoiceConfig()
+        const vd = cfg.engines?.voicedesign ?? {}
+        const vc = cfg.engines?.voiceclone ?? {}
+        const vdModeLabel = { asmr: 'ASMR 双耳女声', docu: '纪录片旁白', elder: '年迈老先生旁白', custom: '自定义音色描述', ai: '交给 AI 自动发挥' }
+        const samples = Array.isArray(vc.samples) ? vc.samples : []
+        return {
+          ok: true,
+          defaultEngine: cfg.defaultEngine ?? 'auto',
+          voiceDesign: {
+            mode: vd.mode ?? '（未设置，按 context 推导）',
+            modeLabel: vdModeLabel[vd.mode] ?? '',
+            // [2026-08-22] AI 模式下不暴露固定描述 context（那是"自定义音色描述"模式的），
+            // 防止 AI 把用户的固定描述抄进 voiceDesc 绕过 AI 自动发挥
+            context: vd.mode === 'ai' ? '（AI 自动发挥模式不使用固定描述，只用锚点：性别/年龄感）' : (vd.context ?? '').slice(0, 300),
+            emotion: vd.emotion === true,
+            lock: {
+              gender: vd.lockGender === true, timbre: vd.lockTimbre === true, age: vd.lockAge === true,
+              genderValue: vd.aiGender ?? '', ageValue: AI_AGE_LABELS[vd.aiAge] ?? '',
+            },
+          },
+          voiceClone: {
+            isDefault: (cfg.defaultEngine ?? '') === 'voiceclone',
+            sampleCount: samples.length,
+            defaultSample: samples[0]?.name ?? '',
+            samples: samples.map((s) => s.name),
+          },
+          hint: '默认语音引擎决定了自动回复用什么声音：voiceclone=克隆音色；voicedesign=音色设计；xiaomi=预置音色；edge=微软免费；local=本地。',
+        }
+      },
+    })))
+
     // 3) manage_voice_clone 工具（克隆音色库管理：注册/设为默认/列出/删除）
     // [本地改造 2026-08-21] 克隆默认改由「默认语音引擎=voiceclone」控制（设置页已去掉列表 radio）；
     // set_default=把默认语音引擎切到 voiceclone 并用该样本；clear_default=切回 auto。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oadank/dsh-input-tools",
-  "version": "0.3.15",
+  "version": "0.3.17",
   "private": false,
   "type": "module",
   "main": "lib/index.js",

package/patches/dsh-voice-rc8.patch

@@ -3139,8 +3139,7 @@ index 0000000000..33a3eb7d19
 +}
 +
 +/** Default ffmpeg binary; overridable for non-Windows deployments. */
-+export const FFMPEG_BIN = process.env.DSH_VOICE_FFMPEG_BIN
-+  ?? 'C:\\Users\\oadan\\AppData\\Local\\Microsoft\\WinGet\\Links\\ffmpeg.exe'
++export const FFMPEG_BIN = process.env.DSH_VOICE_FFMPEG_BIN ?? 'ffmpeg'
 +
 +/** Default local ASR endpoint (sherpa-onnx SenseVoice service). */
 +export const ASR_SERVICE_URL = process.env.DSH_ASR_SERVICE_URL ?? 'http://127.0.0.1:18790/transcribe'

package/scripts/gen-ttuan-preview.mjs

@@ -0,0 +1,55 @@
+// 一次性脚本：为小团团生成"预生成合成试听录音"（带 persona 指令），落盘三处：
+//   1) 源码仓 assets/voiceclone-samples/<id>-preview.mp3（提交，别人下载即可试听）
+//   2) 运行时包 assets/voiceclone-samples/<id>-preview.mp3
+//   3) DSH_HOME/voiceclone-samples/<id>-preview.mp3（服务静态服务读取处）
+// 依赖：dsh-web 服务正在运行（127.0.0.1:3080，含小米 API Key 配置）
+import { readFile, writeFile, mkdir, copyFile } from 'node:fs/promises'
+import { join, dirname } from 'node:path'
+import { homedir } from 'node:os'
+import { fileURLToPath } from 'node:url'
+
+const HERE = dirname(fileURLToPath(import.meta.url))
+const REPO_ROOT = join(HERE, '..')
+const DSH_HOME = process.env.DSH_HOME ?? join(homedir(), '.dsh')
+const ID = '8da38fcc-b041-4f5b-86b9-901956016f89'
+
+// 1) 从 voice-config.json 取小团团样本（含 context 指令）
+const cfg = JSON.parse(await readFile(join(DSH_HOME, 'voice-config.json'), 'utf8'))
+const samples = cfg?.engines?.voiceclone?.samples ?? []
+const target = samples.find((s) => s.id === ID) ?? samples[0]
+if (!target?.path) { console.error('FAIL: 未找到小团团样本'); process.exit(1) }
+const context = (target.context ?? '').trim()
+console.log('sample:', target.name, '| path:', target.path, '| contextLen:', context.length)
+
+// 2) 从 client.js 提取 CLONE_PREVIEW_TEXT
+const clientSrc = await readFile(join(REPO_ROOT, 'lib', 'client.js'), 'utf8')
+const m = clientSrc.match(/const CLONE_PREVIEW_TEXT = "([\s\S]*?)";/)
+if (!m) { console.error('FAIL: 未找到 CLONE_PREVIEW_TEXT'); process.exit(1) }
+const text = m[1]
+console.log('previewTextLen:', text.length)
+
+// 3) 调服务合成（带 persona 指令）
+const body = { engine: 'voiceclone', samplePath: target.path, text, cloneContext: context }
+const r = await fetch('http://127.0.0.1:3080/voice-config/preview', {
+  method: 'POST',
+  headers: { 'content-type': 'application/json' },
+  body: JSON.stringify(body),
+})
+const d = await r.json()
+if (!d?.ok) { console.error('FAIL: 合成失败 ->', JSON.stringify(d)); process.exit(1) }
+console.log('synth ok, mediaType:', d.mediaType, 'durationMs:', d.durationMs, 'dataLen:', d.data.length)
+const bytes = Buffer.from(d.data, 'base64')
+const name = ID + '-preview.mp3'
+
+// 4) 落盘三处
+const dests = [
+  join(REPO_ROOT, 'assets', 'voiceclone-samples', name),
+  join(process.env.RUNTIME_PLUGIN ?? join(DSH_HOME, 'profiles', 'node_modules', '@oadank', 'dsh-input-tools'), 'assets', 'voiceclone-samples', name),
+  join(DSH_HOME, 'voiceclone-samples', name),
+]
+for (const p of dests) {
+  await mkdir(dirname(p), { recursive: true })
+  await writeFile(p, bytes)
+  console.log('WROTE', p, bytes.length, 'bytes')
+}
+console.log('DONE')

package/scripts/install-asr.ps1

@@ -6,28 +6,35 @@
 #   3. ffmpeg（无则用 winget 安装）
 #   4. 注册 nssm 服务 asr（端口 18790，开机自启）
 #
-# 安装位置：自动放在本插件包目录下的 sherpa-onnx/（脚本位于
-#   <插件包>/scripts/install-asr.ps1，自动推导到 <插件包>/sherpa-onnx）
-#   ——所有人装插件后路径都统一，不会乱。
+# 安装位置（2026-08-22 改）：默认装到**独立目录**，不装插件包目录——
+#   插件包（profile 副本或源码 internal-plugins）会随升级/重装被覆盖，
+#   模型放里面会丢。默认顺序：
+#     1) -InstallDir 参数显式指定（最高优先）
+#     2) 检测已有 sherpa-onnx（之前装过则复用）：~\.dsh\sherpa-onnx / C:\D\opt\sherpa-onnx / D:\opt\deepseek-harness\asr
+#     3) 以上都没有 → ~\.dsh\sherpa-onnx（dsh 数据目录，跨升级保留）
 # 用法：以管理员身份打开 PowerShell，执行：
-#   powershell -ExecutionPolicy Bypass -File "<插件包>\scripts\install-asr.ps1"
-# 可选参数：-Port 18790（自定义端口）
+#   powershell -ExecutionPolicy Bypass -File "<脚本路径>\install-asr.ps1"
+# 可选参数：-Port 18790（自定义端口）；-InstallDir "D:\opt\my-sherpa"（自定义安装目录）
 # ============================================================
 param(
-  [int]$Port = 18790
+  [int]$Port = 18790,
+  [string]$InstallDir = ""
 )
 
 $ErrorActionPreference = "Stop"
 $Version = "v1.13.6"
 
-# ---- 0. 自动推导安装目录：脚本在 <插件包>/scripts/，安装到 <插件包>/sherpa-onnx/ ----
-$ScriptDir = Split-Path -Parent $MyInvocation.MyCommand.Path
-$PluginRoot = Split-Path -Parent $ScriptDir
-$InstallDir = Join-Path $PluginRoot "sherpa-onnx"
+# ---- 0. 确定安装目录（独立目录，不装插件包内）----
+if ($InstallDir -eq "") {
+  foreach ($c in @("$env:USERPROFILE\.dsh\sherpa-onnx", "C:\D\opt\sherpa-onnx", "D:\opt\deepseek-harness\asr")) {
+    if (Test-Path (Join-Path $c "bin")) { $InstallDir = $c; break }
+  }
+  if ($InstallDir -eq "") { $InstallDir = Join-Path $env:USERPROFILE ".dsh\sherpa-onnx" }
+}
 
 Write-Host "==== dsh ASR 一键安装 ====" -ForegroundColor Cyan
-Write-Host "插件包目录: $PluginRoot"
 Write-Host "安装目录:   $InstallDir"
+Write-Host "  （独立目录，不随插件升级/重装被覆盖）" -ForegroundColor DarkGray
 Write-Host "服务端口:   $Port"
 
 # ---- 0b. 幂等保护：已完整安装则直接退出（不下载、不注册、不碰任何现有配置）----

package/scripts/install-local-tts.ps1

@@ -7,13 +7,22 @@
 #   4. 生成 local-tts.mjs 启动脚本（与插件"本地命令"契约一致：
 #      node local-tts.mjs <文本> → stdout 输出 mp3 音频字节）
 #
-# 安装位置：自动放在本插件包目录下的 sherpa-onnx/（脚本位于
-#   <插件包>/scripts/install-local-tts.ps1，自动推导到 <插件包>/sherpa-onnx）
-#   ——与 ASR 安装共用同一目录，两个 exe 一次下载全有。
+# 安装位置（2026-08-22 改）：默认装到**独立目录**，不装插件包目录——
+#   插件包（profile 副本或源码 internal-plugins）会随升级/重装被覆盖，
+#   模型放里面会丢。默认顺序：
+#     1) -InstallDir 参数显式指定（最高优先，可指定源码 internal-plugins 等任意位置）
+#     2) 检测已有 sherpa-onnx（ASR 装过则复用同一份，省一次下载）：
+#        ~\.dsh\sherpa-onnx / C:\D\opt\sherpa-onnx / D:\opt\deepseek-harness\asr
+#     3) 以上都没有 → ~\.dsh\sherpa-onnx（dsh 数据目录，跨升级保留）
 # 用法：以管理员身份打开 PowerShell，执行：
-#   powershell -ExecutionPolicy Bypass -File "<插件包>\scripts\install-local-tts.ps1"
+#   powershell -ExecutionPolicy Bypass -File "<脚本路径>\install-local-tts.ps1"
+#   或指定安装目录：... install-local-tts.ps1 -InstallDir "D:\opt\my-sherpa"
 # 装完后到 dsh 设置 → 语音服务 → 本地 TTS，把提示的命令填进「本地命令」。
 # ============================================================
+param(
+  [string]$InstallDir = ""
+)
+
 $ErrorActionPreference = "Stop"
 $Version = "v1.13.6"
 
@@ -57,14 +66,18 @@ function Expand-TarBz2 {
   return $true
 }
 
-# ---- 0. 自动推导安装目录：脚本在 <插件包>/scripts/，安装到 <插件包>/sherpa-onnx/ ----
-$ScriptDir = Split-Path -Parent $MyInvocation.MyCommand.Path
-$PluginRoot = Split-Path -Parent $ScriptDir
-$InstallDir = Join-Path $PluginRoot "sherpa-onnx"
+# ---- 0. 确定安装目录（独立目录，不装插件包内）----
+if ($InstallDir -eq "") {
+  # 复用已有 sherpa-onnx（ASR 装过则共用，省一次下载）
+  foreach ($c in @("$env:USERPROFILE\.dsh\sherpa-onnx", "C:\D\opt\sherpa-onnx", "D:\opt\deepseek-harness\asr")) {
+    if (Test-Path (Join-Path $c "bin")) { $InstallDir = $c; break }
+  }
+  if ($InstallDir -eq "") { $InstallDir = Join-Path $env:USERPROFILE ".dsh\sherpa-onnx" }
+}
 
 Write-Host "==== dsh 本地 TTS 一键安装 ====" -ForegroundColor Cyan
-Write-Host "插件包目录: $PluginRoot"
 Write-Host "安装目录:   $InstallDir"
+Write-Host "  （独立目录，不随插件升级/重装被覆盖；与 ASR 共用同一份 sherpa-onnx）" -ForegroundColor DarkGray
 
 # ---- 0b. 幂等保护：已完整安装则直接退出 ----
 $exeExists = Test-Path "$InstallDir\bin\sherpa-onnx-offline-tts.exe"
@@ -198,14 +211,16 @@ try {
 }
 '@
 $launcher = $launcherTemplate.Replace('__SHERPA__', $exePath).Replace('__BASE__', $basePath)
-$launcherFile = "$PluginRoot\local-tts.mjs"
+$launcherFile = Join-Path $InstallDir "local-tts.mjs"
 Set-Content -Path $launcherFile -Value $launcher -Encoding UTF8
 Write-Host "  local-tts.mjs: $launcherFile" -ForegroundColor Green
 
-# ---- 6. 完成提示 ----
+# ---- 6. 完成提示（命令只在路径含空格时才加引号；插件已能正确处理引号）----
 Write-Host "`n==== 安装完成 ====" -ForegroundColor Cyan
 $nodeExe = (Get-Command node).Source
-$cmdLine = "$nodeExe `"$launcherFile`""
+$nodePart = if ($nodeExe -match ' ') { "`"$nodeExe`"" } else { $nodeExe }
+$launcherPart = if ($launcherFile -match ' ') { "`"$launcherFile`"" } else { $launcherFile }
+$cmdLine = "$nodePart $launcherPart"
 Write-Host "请到 dsh 设置 → 语音服务 → 本地 TTS，把下面这行填进「本地命令」："
 Write-Host ""
 Write-Host "  $cmdLine" -ForegroundColor Green