arona-agent 1.0.2 → 1.0.4

package/src/index.ts

@@ -3,36 +3,39 @@ import { Repl } from "./repl.ts";
 import { resetConversationFlag, loadSession } from "./memory.ts";
 import { startPet } from "./pet.ts";
 import { config, settingsExist } from "./config.ts";
+import { preloadGptSovitsLocal } from "./tts_provider.ts";
+import { syncSkillsFromAgentsDir } from "./skills.ts";
 import { t } from "./locale.ts";
 import chalk from "chalk";
 
 async function main() {
-  // Require settings.json — if missing, tell user to run arona setup
   if (!settingsExist()) {
-    console.log(chalk.yellow(t("未找到配置文件。", "Config file not found.")));
-    console.log(chalk.cyan(t("请先运行 arona setup 进行初始化配置。", "Please run arona setup to initialize first.")));
+    console.log(chalk.yellow(t("未找到配置文件，请运行 arona setup 初始化。", "Config file not found. Run `arona setup` to initialize.")));
     process.exit(1);
   }
 
-  // Check for required environment
   if (!config.apiKey) {
-    console.log(chalk.yellow(t("警告：未找到 LLM API Key。", "Warning: LLM API Key not found.")));
-    console.log(chalk.cyan(t("请运行 arona setup 进行配置。", "Please run arona setup to configure.")));
-    console.log();
+    console.log(chalk.yellow(t("警告：未找到 LLM API Key，请运行 arona setup 配置。", "Warning: LLM API Key not found. Run `arona setup` to configure.")));
   }
 
   if (config.noVoice) {
     console.log(chalk.cyan(t("语音功能已禁用（--no-voice）。", "Voice features disabled (--no-voice).")));
   }
 
-  // Initialize agent
-  console.log(chalk.cyan(t("正在初始化 ARONA...", "Initializing ARONA...")));
+  // 补全缺失 Skill（仅补缺，不覆盖用户定制）
+  const synced = syncSkillsFromAgentsDir();
+  if (synced > 0) {
+    console.log(chalk.cyan(t(`已同步 ${synced} 个 Skill`, `Synced ${synced} skill(s)`)));
+  }
 
   let { session, modelRuntime, loader } = await initAgent();
 
-  // 启动桌宠（首次需下载 Electron 二进制，须等下载完成再进入 REPL，避免卡在后台静默下载）
+  // 首次启动需下载 Electron，须等下载完成再进入 REPL
   await startPet();
 
+  // 后台预热本地 GPT-SoVITS，避免首句合成冷启动等待（fire-and-forget）
+  preloadGptSovitsLocal();
+
   // Handle session resume from command line arg
   // 只加载消息到 session，渲染交给 Repl.start() 处理（确保 logo 在历史记录之前）
   // initialSessionPath 传给 Repl，退出时覆盖保存回原文件而非另存为新文件

package/src/memory.ts

@@ -171,12 +171,7 @@ interface SessionHeader {
   preview: string;
 }
 
-/**
- * 从首条 user 消息提取会话预览。
- * 剥离 repl.ts 注入的桌宠手势场景块（全角括号 `（…）` 包裹、后随空行），
- * 避免"摸头/dizzy 提示词"污染会话命名（用户首条消息常是手势触发）。
- * 仅影响预览命名，不改动存储内容。
- */
+/** 从首条 user 消息提取会话预览。 */
 function firstUserPreview(messages: any[]): string {
   const firstUserMsg = messages.find((m) => m.role === "user");
   if (!firstUserMsg) return "(empty)";
@@ -189,10 +184,8 @@ function firstUserPreview(messages: any[]): string {
             .map((c: any) => c.text)
             .join(" ")
         : "";
-  // 剥离开头的注入块：`（…）\n\n<用户真实输入>`
-  const cleaned = content.replace(/^（[^）]*）[ \t]*\n*/u, "");
-  let preview = cleaned.slice(0, 50).replace(/\n/g, " ");
-  if (cleaned.length > 50) preview += "...";
+  let preview = content.slice(0, 50).replace(/\n/g, " ");
+  if (content.length > 50) preview += "...";
   return preview;
 }
 

package/src/oss_upload.ts

@@ -0,0 +1,116 @@
+// 本地文件 → 阿里云 DashScope 托管 OSS 的工具：上传换取可长期引用的 URL，供云端 GPT-SoVITS
+// 作为 ref_audio_path 引用（复用 python/oss_upload.py，与 voice_clone.py 同一 DashScope 通道）。
+//
+// - 同一本地路径会话内只上传一次（URL 长期有效），缓存于 urlCache；并发上传共享同一 in-flight Promise。
+// - ensureOssUrlAlive 用 Range GET 探测 URL 有效性，失效则 invalidate 触发下次重传
+//   （"发现无效→重新走上传流程"）。
+// - promptText 若为 URL 用 fetchTextFromUrl 抓内容；joinPromptLines 把多行文字合并为一行，
+//   行尾缺句末标点时按中英文智能补「。」或「.」。
+import { verbose } from "./config.ts";
+import { t } from "./locale.ts";
+import { runPython } from "./utils/python.ts";
+
+const urlCache = new Map<string, string>(); // 本地源路径 → OSS URL（会话内复用）
+const inflight = new Map<string, Promise<string>>(); // 在途上传（并发去重）
+const verifiedSet = new Set<string>(); // 已校验且仍有效的源路径（避免每 drain 重复探测）
+
+/** 是否 http(s) URL（用于区分"本地路径"与"远端 URL"输入）。 */
+export function isHttpUrl(s: string): boolean {
+  return /^https?:\/\/\S+$/i.test(s.trim());
+}
+
+/** 上传本地文件到 DashScope 托管 OSS，返回长期有效的 URL（同源路径会话内缓存，只上传一次）。 */
+export function uploadToOss(path: string, apiKey: string): Promise<string> {
+  const cached = urlCache.get(path);
+  if (cached) return Promise.resolve(cached);
+  const pending = inflight.get(path);
+  if (pending) return pending;
+  const task = runPython("oss_upload.py", [], JSON.stringify({ path, apiKey }), {}, 120_000)
+    .then((out) => {
+      let parsed: { url?: string; error?: string };
+      try {
+        parsed = JSON.parse(out);
+      } catch {
+        throw new Error(t(`OSS 上传输出解析失败: ${out}`, `OSS upload parse failed: ${out}`));
+      }
+      if (!parsed.url) {
+        throw new Error(parsed.error || t("OSS 上传未返回 URL", "OSS upload returned no URL"));
+      }
+      urlCache.set(path, parsed.url);
+      if (verbose) console.error(`[oss] uploaded ${path} -> ${parsed.url}`);
+      return parsed.url;
+    })
+    .finally(() => {
+      inflight.delete(path);
+    });
+  inflight.set(path, task);
+  return task;
+}
+
+/** 作废某源路径的缓存 URL（发现无效时调用，下次上传会重新走上传流程）。 */
+export function invalidateOssUrl(path: string): void {
+  urlCache.delete(path);
+  verifiedSet.delete(path);
+}
+
+/** Range GET 探测 URL 是否仍可访问（OSS 支持 range，200/206/304 均视为有效）。 */
+async function checkUrlAlive(url: string): Promise<boolean> {
+  try {
+    const res = await fetch(url, {
+      method: "GET",
+      headers: { Range: "bytes=0-0" },
+      redirect: "follow",
+      signal: AbortSignal.timeout(6000),
+    });
+    return res.status === 200 || res.status === 206 || res.status === 304;
+  } catch {
+    return false;
+  }
+}
+
+/**
+ * 校验 OSS URL 有效性；失效则强制重传并返回新 URL（"发现无效→重新走上传流程"）。
+ * 会话内每个源路径只校验一次（URL 长期有效，无需每 drain 都探测）。
+ */
+export async function ensureOssUrlAlive(sourcePath: string, url: string, apiKey: string): Promise<string> {
+  if (verifiedSet.has(sourcePath)) return url;
+  if (await checkUrlAlive(url)) {
+    verifiedSet.add(sourcePath);
+    return url;
+  }
+  if (verbose) console.error(`[oss] URL 失效，重新上传: ${url}`);
+  invalidateOssUrl(sourcePath);
+  const fresh = await uploadToOss(sourcePath, apiKey);
+  verifiedSet.add(sourcePath);
+  return fresh;
+}
+
+/** 抓取 URL 文本内容（promptText 为 URL 时使用）。 */
+export async function fetchTextFromUrl(url: string): Promise<string> {
+  const res = await fetch(url, { redirect: "follow", signal: AbortSignal.timeout(10_000) });
+  if (!res.ok) {
+    throw new Error(t(`拉取文字失败 (HTTP ${res.status})`, `Fetch text failed (HTTP ${res.status})`));
+  }
+  return await res.text();
+}
+
+/**
+ * 把多行文字合并为一行：丢弃空行；行尾缺少句末标点（。．.!?！？…）时，按该行是否含
+ * 中日韩字符智能补「。」或「.」；最后一行不补（官方会自动补全）。单行输入原样返回。
+ */
+export function joinPromptLines(text: string): string {
+  const lines = text
+    .split(/\r?\n/)
+    .map((l) => l.trim())
+    .filter(Boolean);
+  if (lines.length <= 1) return lines[0] || "";
+  const CJK = /[\u3040-\u30ff\u3400-\u4dbf\u4e00-\u9fff\uf900-\ufaff]/;
+  const END = /[。．.!?！？…]$/;
+  return lines
+    .map((line, i) => {
+      if (i === lines.length - 1) return line; // 最后一行不补标点
+      if (END.test(line)) return line;
+      return line + (CJK.test(line) ? "。" : ".");
+    })
+    .join(" ");
+}

package/src/renderer.ts

@@ -161,6 +161,17 @@ export function createRenderer(
     setSpeakerLabel(label: string | undefined) {
       speakerLabel = label;
     },
+    // 切 session（setActiveAgent）时显式复位回合状态：消除跨会话 curMsgText/lastText 残留，
+    // 防止被新 session 的 agent_end 误读上一角色文本。
+    resetTurn() {
+      curMsgText = "";
+      lastText = "";
+      thinkingBuffer = "";
+      drawnThinkingLines = 0;
+      inThinking = false;
+      inText = false;
+      textPrefixWritten = false;
+    },
     subscribe: (session: any) => {
       return session.subscribe((event: any) => {
         switch (event.type) {
@@ -248,19 +259,19 @@ export function createRenderer(
             if (showToolDetails) {
               const name = event.toolName;
               const input = event.input ? JSON.stringify(event.input).slice(0, 100) : "";
-              process.stdout.write(chalk.cyan(t(`\n  [工具] ${name}`, `\n  [tool] ${name}`)) + (input ? ` ${input}` : "") + "\n");
+              process.stdout.write(chalk.cyan(`\n  → ${name} ${input}`.trimEnd() + "\n"));
             }
             break;
 
           case "tool_execution_end":
             if (showToolDetails) {
-              const status = event.isError ? chalk.red(t("错误", "error")) : chalk.green(t("完成", "done"));
-              process.stdout.write(t("  [工具] ", "  [tool] ") + `${status}\n`);
+              const status = event.isError ? chalk.red(t("✗", "✗")) : chalk.green(t("✓", "✓"));
+              process.stdout.write(status + "\n");
             }
             break;
 
           case "compaction_start":
-            process.stdout.write(chalk.yellow(t("\n[正在压缩上下文...]\n", "\n[Compacting context...]\n")));
+            process.stdout.write(chalk.yellow(t("\n[压缩上下文…]\n", "\n[Compacting…]\n")));
             break;
 
           case "compaction_end":
@@ -271,12 +282,12 @@ export function createRenderer(
               const msg = String(event.errorMessage).replace(/^Compaction failed:\s*/i, "");
               process.stdout.write(chalk.red(t(`[压缩失败] ${msg}\n\n`, `[Compaction failed] ${msg}\n\n`)));
             } else {
-              process.stdout.write(chalk.yellow(t("[压缩完成]\n\n", "[Compaction complete]\n\n")));
+              process.stdout.write(chalk.yellow(t("[压缩完成]\n\n", "[Compaction done]\n\n")));
             }
             break;
 
           case "auto_retry_start":
-            process.stdout.write(chalk.yellow(t("\n[重试中...]\n", "\n[Retrying...]\n")));
+            process.stdout.write(chalk.yellow(t("\n[重试中…]\n", "\n[Retrying…]\n")));
             break;
         }
       });

package/src/repl.ts

@@ -4,15 +4,17 @@ import { execSync, type ChildProcessWithoutNullStreams } from "child_process";
 import { readFileSync, existsSync } from "fs";
 import { join, resolve } from "path";
 import type { AgentSession, ModelRuntime, DefaultResourceLoader } from "@earendil-works/pi-coding-agent";
-import { config } from "./config.ts";
+import { config, sttHotkeyKey, sttHotkeyLabel } from "./config.ts";
 import { handleCommand, type CommandContext } from "./commands.ts";
 import { createRenderer, renderSavedMessages } from "./renderer.ts";
 import * as memory from "./memory.ts";
 import * as voice from "./voice.ts";
+import { getTtsProvider } from "./tts_provider.ts";
 import { TtsStream } from "./tts_stream.ts";
+import { stopGptSovitsLocalServer } from "./gpt_sovits_local.ts";
 import { stopComputerUse } from "./tools/computer_use.ts";
 import { disconnectAllMcp } from "./mcp.ts";
-import { pet, stopPet, type PetGestureType } from "./pet.ts";
+import { pet, stopPet } from "./pet.ts";
 import { SlashMenu } from "./slash_menu.ts";
 import { printLogo } from "./logo.ts";
 import { PYTHON_DIR } from "./config.ts";
@@ -25,20 +27,6 @@ import { getMainAgent, getSubAgents, getAgentLabel, type AgentId, type SubAgentI
 // STT 长按阈值：按下录音热键持续 ≥ 该毫秒数并在释放时才触发录音；提前松开视为误触
 const STT_HOLD_MS = 2000;
 
-/** 桌宠手势 → 注入用户消息头部的上下文场景行（双语）。引导 Agent 在回复中自然流露出被摸头/被摇晃的感受。 */
-function petGestureScene(type: PetGestureType): string {
-  if (type === "dizzy") {
-    return t(
-      "（Sensei刚才拖着你到处晃来晃去，你感觉有些头晕。请在回复里自然地体现出这份晕眩感。）",
-      "(Sensei just swung you around, and you feel a bit dizzy. Let that dizziness show naturally in your reply.)",
-    );
-  }
-  return t(
-    "（Sensei刚才摸了摸你的头。请在回复里自然地体现出被摸头的感受。）",
-    "(Sensei just petted your head. Let that show naturally in your reply.)",
-  );
-}
-
 export class Repl {
   private rl: readline.Interface;
   private session: AgentSession;
@@ -223,6 +211,9 @@ export class Repl {
         this.activeSession = this.session;
         this.activeAgentId = getMainAgent();
         this.currentSessionPath = null; // 新会话清除源文件路径，退出时另存为新文件
+        // 复制上下文方案下子会话消息每轮被覆盖，无需清历史；此处回收子 session 对象，
+        // 让下轮按新主会话重新初始化（刷新 initSubAgent 期捕获的 memory 等快照）
+        this.resetSubSessions();
         this.rendererUnsub?.();
         this.renderer.setSpeakerLabel(getAgentLabel(getMainAgent()));
         this.rendererUnsub = this.renderer.subscribe(this.session);
@@ -252,6 +243,9 @@ export class Repl {
       },
       undoManager: this.undoManager,
       restartTts: () => this.ttsStream.restartVoice(),
+      // /change-agent 只改子 Agent 组合时回收旧的子 session 对象（dispose + 清空），
+      // 下轮 ensureSubSessions 按新组合重新初始化（刷新 initSubAgent 期捕获的 memory/工具状态）。
+      resetSubAgents: () => this.resetSubSessions(),
     };
   }
 
@@ -266,7 +260,7 @@ export class Repl {
 
   /**
    * 启动全局热键监听（Python pynput 独立进程）。
-   * 检测到右 Cmd 长按 ≥2 秒时，hotkey.py 输出 {"event":"trigger"}，触发 STT 录音。
+   * 检测到全局录音热键（macOS 右 Cmd / 其他右 Ctrl）长按 ≥2 秒时，hotkey.py 输出 {"event":"trigger"}，触发 STT 录音。
    */
   private async startHotkeyHook() {
     if (this.hotkeyProc) return; // 已启动
@@ -278,7 +272,7 @@ export class Repl {
         env: {
           ...process.env,
           PYTHONUTF8: "1",
-          ARONA_HOTKEY_KEY: "cmd_r",
+          ARONA_HOTKEY_KEY: sttHotkeyKey(),
           ARONA_HOTKEY_HOLD_MS: String(STT_HOLD_MS),
         },
         stdio: ["pipe", "pipe", "pipe"],
@@ -323,6 +317,16 @@ export class Repl {
         }
       });
 
+      // spawn 失败（pythonPath 不存在 / 脚本缺失）不会触发 close，必须监听 error，
+      // 否则 Node 会因未处理的 'error' 事件直接崩溃。
+      proc.on("error", (err) => {
+        this.hotkeyProc = null;
+        this.hotkeyReady = false;
+        if (this.hotkeyReadyReject) {
+          this.hotkeyReadyReject(new Error(t(`hotkey.py 启动失败：${err.message}`, `hotkey.py failed to start: ${err.message}`)));
+        }
+      });
+
       // 等待 ready 信号（最多 5 秒；进程提前退出会立即 reject）
       await new Promise<void>((resolve, reject) => {
         const cleanup = () => {
@@ -348,14 +352,15 @@ export class Repl {
       this.hotkeyReadyReject = null;
     } catch (err) {
       this.hotkeyProc = null;
+      const isMac = process.platform === "darwin";
       console.warn(chalk.yellow(
         t(
-          "STT 热键不可用：全局键盘监听启动失败。\n" +
-          "  请确认已安装 pynput（pip install pynput），\n" +
-          "  并在 系统设置 → 隐私与安全性 → 辅助功能 中为Python 授权。",
-          "STT hotkey unavailable: global keyboard listener failed to start.\n" +
-          "  Make sure pynput is installed (pip install pynput),\n" +
-          "  and grant Accessibility permission to Python in System Settings.",
+          isMac
+            ? "STT 热键不可用：请安装 pynput（pip install pynput），并在 系统设置 → 隐私与安全性 → 辅助功能 中为Python授权。"
+            : "STT 热键不可用：请安装 pynput（pip install pynput），并检查 Python 是否有权限监听全局键盘。",
+          isMac
+            ? "STT hotkey unavailable: install pynput (pip install pynput) and grant Accessibility permission to Python in System Settings."
+            : "STT hotkey unavailable: install pynput (pip install pynput) and check that Python has permission to listen for global keys.",
         )
       ));
     }
@@ -400,7 +405,7 @@ export class Repl {
     }
     // 让 readline 先把当前提示符行清掉，再启动录音 UI
     await new Promise((r) => setImmediate(r));
-    console.log(chalk.cyan(t("正在聆听... 请说话", "Listening... speak now")));
+    console.log(chalk.cyan(t("聆听…请说话", "Listening…")));
     this.rl.prompt();
     const text = await voice.listen();
     if (text) {
@@ -444,6 +449,9 @@ export class Repl {
     try {
       const messages = memory.loadSession(path);
       this.session.agent.state.messages = messages;
+      // 复制上下文方案下子会话消息每轮被覆盖，无需清历史；此处回收子 session 对象，
+      // 让下轮按恢复的会话重新初始化（刷新 initSubAgent 期捕获的 memory 等快照）
+      this.resetSubSessions();
       memory.resetConversationFlag();
       this.currentSessionPath = path; // 退出时覆盖保存回此文件
       console.clear();
@@ -489,28 +497,18 @@ export class Repl {
       console.clear();
     }
     printLogo();
-    console.log(chalk.cyan(t(`  模型：${config.model}`, `  Model: ${config.model}`)));
+    const statusLine: string[] = [];
+    statusLine.push(t(`模型：${config.model}`, `Model: ${config.model}`));
     if (config.noVoice) {
-      console.log(chalk.cyan(t("  语音：已禁用（--no-voice）", "  Voice: disabled (--no-voice)")));
+      statusLine.push(t("语音：关", "Voice: off"));
     } else {
-      // 当前主 Agent 无音色时强制显示"未配置声音"（权重大于 settings.ttsEnabled），
-      // TTS 在 isTtsEnabled() 里已被挡掉，不会启动
-      if (!voice.hasCurrentVoice()) {
-        console.log(chalk.cyan(t("  TTS：关（未配置声音）", "  TTS: off (no voice configured)")));
-      } else {
-        console.log(chalk.cyan(t(`  TTS：${voice.isTtsEnabled() ? "开" : "关"}`, `  TTS: ${voice.isTtsEnabled() ? "on" : "off"}`)));
-      }
-      console.log(chalk.cyan(t(`  STT：${voice.isSttEnabled() ? "开" : "关"}`, `  STT: ${voice.isSttEnabled() ? "on" : "off"}`)));
-      // STT 开启时打印热键提示：长按右 Cmd ≥2秒录音；任务中按会先 abort 再录音
-      if (voice.isSttEnabled()) {
-        console.log(chalk.cyan(t(`  录音：长按右 Cmd ≥${STT_HOLD_MS / 1000}秒（提前松开取消）`, `  Record: hold right Cmd ≥${STT_HOLD_MS / 1000}s (release early to cancel)`)));
-        // 非 macOS 无 系统设置 → 隐私与安全性 → 辅助功能 这一路径，提示仅对 macOS 显示
-        if (process.platform === "darwin") {
-          console.log(chalk.cyan(t("  提示：若热键无响应，请在 系统设置 → 隐私与安全性 → 辅助功能 中为Python授权", "  Tip: if the hotkey does not respond, grant Accessibility permission to Python in System Settings → Privacy & Security")));
-        }
-      }
+      statusLine.push(voice.hasCurrentVoice()
+        ? t(`TTS：${voice.isTtsEnabled() ? `开（${getTtsProvider().label()}）` : "关"}`, `TTS: ${voice.isTtsEnabled() ? `on (${getTtsProvider().label()})` : "off"}`)
+        : t("TTS：关（未配置声音）", "TTS: off (no voice configured)"));
+      statusLine.push(t(`STT：${voice.isSttEnabled() ? "开" : "关"}`, `STT: ${voice.isSttEnabled() ? "on" : "off"}`));
     }
-    console.log(chalk.cyan(t("  输入 / 弹出命令菜单，/help 查看完整命令，/exit 退出。\n", "  Type / to open the command menu, /help for all commands, /exit to quit.\n")));
+    console.log(chalk.cyan("  " + statusLine.join(" · ")));
+    // 仅在有编程语义的操作提示时打印帮助行
 
     // --resume= 启动时渲染恢复的历史记录（在 logo 之后，提示符之前）
     if (this.resumedMessages) {
@@ -623,25 +621,18 @@ export class Repl {
       this.doExit();
     });
 
-    // STT 开启时启动全局热键监听（pynput，长按右 Cmd ≥2秒触发录音）
+    // STT 开启时启动全局热键监听（pynput，长按全局录音热键 ≥2秒触发录音）
     if (voice.isSttEnabled()) {
       this.startHotkeyHook();
     }
   }
 
   private async processInput(input: string) {
-    // 桌宠手势（摸头/dizzy）注入：若用户摸过头/拖住晃过，把"刚才发生了什么"作为
-    // 上下文行写在用户消息头部，引导 Agent 在回复中自然流露出确实感受到了。
-    // takeGesture 消费即清空 → 只注入最近一次、不重复注入；若用户发的是纯命令消息，
-    // processInput 不会被调用（见 line handler 的 / 分支），手势保留到下一条真实消息。
-    const gesture = pet.takeGesture();
-    let effective = input;
-    if (gesture) {
-      const scene = petGestureScene(gesture);
-      if (scene) effective = `${scene}\n\n${input}`;
-    }
+    // 桌宠手势（摸头/dizzy）不再拼进用户消息：落到主 Agent 发送边界注入（gesture_context.ts），
+    // 不进 state.messages → 子 Agent 复制主 session 历史时看不到、会话命名/存储零污染。
+    // takeGesture 消费即清空由发送边界扩展完成，只注入最近一次。
     // 展开 @文件 / !命令 后走完整回合生命周期
-    await this.runRawTurn(this.parseInput(effective));
+    await this.runRawTurn(this.parseInput(input));
   }
 
   /** 把 renderer 订阅切到指定角色 session，并记录当前发言者。 */
@@ -649,10 +640,29 @@ export class Repl {
     this.activeAgentId = agentId;
     this.activeSession = session;
     this.renderer.setSpeakerLabel(getAgentLabel(agentId));
+    // 显式复位回合状态，杜绝跨 session 残留 curMsgText/lastText 被误读
+    this.renderer.resetTurn();
     this.rendererUnsub?.();
     this.rendererUnsub = this.renderer.subscribe(session);
   }
 
+  /**
+   * 回收全部子 session 对象（dispose + 清空）。
+   * 复制上下文方案下子会话每轮被主 session 消息覆盖，无需借此清历史；此处目的是释放
+   * session 对象，并让下轮 ensureSubSessions 按新主会话/新子组合重新初始化，刷新
+   * initSubAgent 期捕获的 memoryContent 等快照与工具状态（/new、/resume、/change-agent 时调用）。
+   */
+  private resetSubSessions(): void {
+    for (const subSession of this.subSessions.values()) {
+      try {
+        subSession.dispose();
+      } catch {
+        // 回收失败不影响主流程
+      }
+    }
+    this.subSessions.clear();
+  }
+
   /** 按 settings.json 当前启用的子 Agent 初始化/补齐子 session。 */
   private async ensureSubSessions(): Promise<void> {
     const enabled = getSubAgents();
@@ -800,7 +810,7 @@ export class Repl {
     this.hidePetBubble();
     // 回合开始前打 checkpoint:扫一次当前工作目录,作为 before 快照
     // (回合结束后 afterTurn 会与它做 diff 入 undo 栈)
-    this.undoManager.beforeTurn();
+    await this.undoManager.beforeTurn();
     // 回合开始：不主动切换情绪，保持默认待机动画；
     // 由 agent 调用 change_emotion 一步到位地确定本回合情绪，避免先 saying 再切换的跳变
 
@@ -835,7 +845,7 @@ export class Repl {
     } finally {
       // 回合结束后打 after checkpoint,产出 diff 入 undo 栈
       try {
-        this.undoManager.afterTurn();
+        await this.undoManager.afterTurn();
       } catch (err) {
         // undo checkpoint 失败不影响主流程
         console.warn(chalk.yellow(t(`撤销快照记录失败：${err instanceof Error ? err.message : err}`, `Failed to record undo snapshot: ${err instanceof Error ? err.message : err}`)));
@@ -876,8 +886,9 @@ export class Repl {
     // 停止全局热键监听（pynput）
     this.stopHotkeyHook();
 
-    // 停止 TTS：终止当前合成进程并清空队列
+    // 停止 TTS：终止当前合成进程并清空队列；同时回收本进程自动启动的 GPT-SoVITS api_v2 子进程
     this.ttsStream.shutdown();
+    stopGptSovitsLocalServer();
 
     // Cleanup
     stopComputerUse();