arona-agent 1.1.2 → 1.1.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "arona-agent",
-  "version": "1.1.2",
+  "version": "1.1.3",
   "description": "Terminal AI Agent with desktop pet Arona — eye-tracking pupils, voice cloning, Computer Use, TTS/STT, MCP.",
   "license": "MIT",
   "type": "module",

package/pet/main.cjs

@@ -28,9 +28,9 @@ const AGENT_IDS = [MAIN_AGENT_ID, ...SUB_AGENT_IDS];
 
 const PREFIX = "###PET###";
 const POS_FILE = path.join(os.homedir(), ".arona", "pet.json");
-const WIN_W = 580; // 窗口总宽：左侧 320px 为 Spine 角色渲染区，右侧 260px 为文字气泡专用区（避免气泡遮脸）
+const WIN_W = 320; // 窗口 = Spine 角色渲染区本体（收窄以避免透明区域拦截点击造成误触；角色尺寸不变）
 const WIN_H = 674;
-const SUB_OFFSET_X = 620; // 子窗口默认横向错开（> WIN_W，避免角色+气泡区重叠）
+const SUB_OFFSET_X = 340; // 子窗口默认横向错开（略大于 WIN_W）
 const SUB_OFFSET_Y = 40;
 
 // --verbose（src/pet.ts 注入 ARONA_PET_VERBOSE=1 + --enable-logging）：
@@ -282,6 +282,62 @@ ipcMain.on("pet:fx-up", () => {
   if (fxWin && !fxWin.isDestroyed()) fxWin.webContents.send("fx:up");
 });
 
+// ---- 文字气泡：画在全屏特效窗上（桌宠窗口已收窄为角色本体，不再有气泡区） ----
+// 特效窗鼠标穿透（setIgnoreMouseEvents），气泡纯展示不会拦点击；层级高于桌宠。
+// 锚点沿用旧窗口内定位的观感：气泡出现在头部右上方、小尾巴指向角色；右侧越出
+// 所在显示器时翻到左侧（flip，fx 层镜像小尾巴）。
+const BUBBLE_ANCHOR_X = 264;   // 默认：气泡左缘相对桌宠窗口左上角
+const BUBBLE_ANCHOR_Y = 90;
+const BUBBLE_MAX_W = 220;      // 与 fx 层样式 max-width 一致
+const BUBBLE_FLIP_X = -196;    // 翻转：气泡左缘相对桌宠窗口左上角（右缘留 ~24px 缝隙给小尾巴）
+const BUBBLE_FLIP_PAD = 12;    // 翻转阈值缓冲：贴屏幕右缘多少 px 内就算溢出
+
+/** 桌宠窗口当前姿态 → 特效窗本地气泡锚点 { x, y, flip }；特效窗/角色窗不可用时返回 null */
+function bubbleAnchorLocal(agentId) {
+  const bw = windowByAgent(agentId);
+  if (!bw || bw.isDestroyed() || !fxWin || fxWin.isDestroyed()) return null;
+  const [wx, wy] = bw.getPosition();
+  const [fxX, fxY] = fxWin.getPosition();
+  let flip = false;
+  let gx = wx + BUBBLE_ANCHOR_X;
+  try {
+    const d = screen.getDisplayNearestPoint({ x: wx, y: wy });
+    const rightEdge = d.bounds.x + d.bounds.width;
+    if (gx + BUBBLE_MAX_W + BUBBLE_FLIP_PAD > rightEdge) {
+      // 右侧放不下 → 翻到角色左侧
+      flip = true;
+      gx = wx + BUBBLE_FLIP_X;
+    }
+    gx = Math.max(d.bounds.x + BUBBLE_FLIP_PAD, Math.min(gx, rightEdge - BUBBLE_FLIP_PAD));
+    // 垂直方向钳回所在显示器（粗略按气泡最大高度 ~140px 预留）
+    const gy = Math.max(d.bounds.y, Math.min(wy + BUBBLE_ANCHOR_Y, d.bounds.y + d.bounds.height - 140));
+    return { x: Math.round(gx - fxX), y: Math.round(gy - fy), flip };
+  } catch {
+    return { x: Math.round(gx - fxX), y: Math.round(wy + BUBBLE_ANCHOR_Y - fxY), flip };
+  }
+}
+
+/** 把某角色的文字消息转成特效窗上的气泡 show/hide */
+function forwardBubble(agentId, kind, data) {
+  if (!fxWin || fxWin.isDestroyed()) return;
+  if (kind === "tts_end") {
+    fxWin.webContents.send("pet:bubble", { agent: agentId, kind: "hide" });
+    return;
+  }
+  if (typeof data !== "string" || !data) return;
+  const pos = bubbleAnchorLocal(agentId);
+  if (!pos) return;
+  fxWin.webContents.send("pet:bubble", { agent: agentId, kind: "show", data, ...pos });
+}
+
+/** 拖动中/落位后同步气泡锚点（气泡已显示时 fx 层原地位移，未显示则忽略） */
+function syncBubblePosition(agentId) {
+  if (!fxWin || fxWin.isDestroyed()) return;
+  const pos = bubbleAnchorLocal(agentId);
+  if (!pos) return;
+  fxWin.webContents.send("pet:bubble", { agent: agentId, kind: "move", ...pos });
+}
+
 // ---- 全局光标轮询（~60Hz，DIP 坐标系内运算，供渲染层瞳孔跟随 + 按住期间晃动检测补采样） ----
 // 对每个桌宠窗口分别发送窗口本地坐标 + 全局坐标（gx/gy：renderer 按住期间用于晃动检测——
 // 光标快速甩动划出窗口时 mousemove 断流，本轮询不断流，轻微出窗仍能采到晃动）
@@ -324,6 +380,7 @@ ipcMain.on("pet:drag", (e, dx, dy) => {
       if (p && windowByAgent(agentId)) {
         windowByAgent(agentId).setPosition(Math.round(p.x), Math.round(p.y));
         dragPendingMap.delete(agentId);
+        syncBubblePosition(agentId); // 气泡跟随拖动
       }
     }, 16));
   }
@@ -343,6 +400,7 @@ ipcMain.on("pet:dragend", (e) => {
     bw.setPosition(Math.round(pending.x), Math.round(pending.y));
     dragPendingMap.delete(agentId);
   }
+  syncBubblePosition(agentId); // 落位后校正气泡锚点（flip 状态也可能变化）
   const [x, y] = bw.getPosition();
   savePosition(agentId, x, y);
   send({ type: "moved", agent: agentId, x, y });
@@ -385,7 +443,8 @@ function handleMessage(msg) {
       break;
     case "text": {
       const id = msg.agent && AGENTS[msg.agent] ? msg.agent : MAIN_AGENT_ID;
-      sendToAgent(id, "pet:text", { kind: msg.kind, data: msg.data });
+      // 气泡已迁出桌宠窗口（窗口收窄为角色本体），统一渲染在全屏特效窗上
+      forwardBubble(id, msg.kind, msg.data);
       break;
     }
     case "tts_level": {

package/pet/preload.cjs

@@ -3,7 +3,6 @@ const { contextBridge, ipcRenderer } = require("electron");
 contextBridge.exposeInMainWorld("petAPI", {
   onEmotion: (cb) => ipcRenderer.on("pet:emotion", (_e, name) => cb(name)),
   onReset: (cb) => ipcRenderer.on("pet:reset", () => cb()),
-  onText: (cb) => ipcRenderer.on("pet:text", (_e, p) => cb(p)),
   // TTS 播放中实时音量（RMS 0~1）→ 嘴型 lip-sync
   onTtsLevel: (cb) => ipcRenderer.on("pet:tts-level", (_e, rms) => cb(rms)),
   getAgentConfig: () => ipcRenderer.invoke("pet:get-agent-config"),
@@ -20,4 +19,6 @@ contextBridge.exposeInMainWorld("petAPI", {
   onFxDown: (cb) => ipcRenderer.on("fx:down", (_e, x, y) => cb(x, y)),
   onFxMove: (cb) => ipcRenderer.on("fx:move", (_e, x, y) => cb(x, y)),
   onFxUp: (cb) => ipcRenderer.on("fx:up", () => cb()),
+  // 文字气泡：main.cjs 把桌宠窗口姿态换算成本地坐标后发到这里（fx 层专用）
+  onBubble: (cb) => ipcRenderer.on("pet:bubble", (_e, p) => cb(p)),
 });

package/pet/renderer/fx.html

@@ -20,10 +20,55 @@
       height: 100%;
       pointer-events: none;
     }
+    /* 文字气泡容器：铺满窗口，纯展示（特效窗整体 setIgnoreMouseEvents） */
+    #fx-bubbles {
+      position: absolute;
+      inset: 0;
+      pointer-events: none;
+      z-index: 5;
+    }
+    /* 角色语音气泡（从桌宠窗口迁入）：位置由 main.cjs 按桌宠窗口姿态换算后下发，
+       显示在角色头部侧上方；.flip 时小尾巴镜像到右侧指向角色。淡出用 opacity 过渡 */
+    .bubble {
+      position: absolute;
+      max-width: 220px;
+      padding: 8px 12px;
+      box-sizing: border-box;
+      background: rgba(20, 22, 34, 0.82);
+      border-radius: 14px;
+      color: #fff;
+      font-size: 13px;
+      line-height: 1.45;
+      text-align: left;
+      white-space: pre-line;
+      word-break: break-all;
+      opacity: 1;
+      transition: opacity 0.25s ease;
+    }
+    .bubble::after {
+      content: "";
+      position: absolute;
+      left: -12px;
+      top: 50%;
+      transform: translateY(-50%);
+      border-top: 8px solid transparent;
+      border-bottom: 8px solid transparent;
+      border-right: 12px solid rgba(20, 22, 34, 0.82);
+    }
+    .bubble.flip::after {
+      left: auto;
+      right: -12px;
+      border-right: none;
+      border-left: 12px solid rgba(20, 22, 34, 0.82);
+    }
+    .bubble.hidden {
+      opacity: 0;
+    }
   </style>
 </head>
 <body>
   <div id="fx"></div>
+  <div id="fx-bubbles"></div>
   <script src="../../node_modules/ba-click-fx/dist/ba-click-fx.iife.js"></script>
   <script src="fx.js"></script>
 </body>

package/pet/renderer/fx.js

@@ -38,4 +38,38 @@ window.petAPI.onFxUp(() => {
   if (fx) fx.pointerUp(1);
 });
 
+// ---- 文字气泡：按角色各维护一个节点（气泡已从桌宠窗口迁到这里渲染） ----
+// main.cjs 下发的消息：
+//   { agent, kind: "show", data, x, y, flip } — 上屏文本并定位（flip=角色在右侧，尾巴镜像）
+//   { agent, kind: "move", x, y, flip }       — 仅更新位置（拖动跟随；未显示时无副作用）
+//   { agent, kind: "hide" }                   — 淡出（TTS 播完 / 兜底定时器 / 打断）
+const bubbles = new Map();
+
+function ensureBubble(agentId) {
+  let el = bubbles.get(agentId);
+  if (!el) {
+    el = document.createElement("div");
+    el.className = "bubble hidden";
+    document.getElementById("fx-bubbles").appendChild(el);
+    bubbles.set(agentId, el);
+  }
+  return el;
+}
+
+window.petAPI.onBubble((msg) => {
+  const agentId = String(msg?.agent ?? "main");
+  if (msg.kind === "hide") {
+    bubbles.get(agentId)?.classList.add("hidden");
+    return;
+  }
+  const el = ensureBubble(agentId);
+  el.style.left = `${Math.round(msg.x)}px`;
+  el.style.top = `${Math.round(msg.y)}px`;
+  el.classList.toggle("flip", !!msg.flip);
+  if (msg.kind === "show" && typeof msg.data === "string" && msg.data) {
+    el.textContent = msg.data;
+    el.classList.remove("hidden");
+  }
+});
+
 initFx();

package/pet/renderer/index.html

@@ -8,7 +8,6 @@
 <body>
   <div id="stage">
     <canvas id="spine"></canvas>
-    <div id="pet-bubble" class="hidden"></div>
   </div>
   <script src="../vendor/spine/spine-webgl.js"></script>
   <script src="../vendor/spine/spine-canvas.js"></script>

package/pet/renderer/renderer.js

@@ -104,9 +104,9 @@ const PAT_TURN_PX = 20;        // 单次"有效换向"所需的最小半波位
 const DIZZY_TURNS = 2;          // 换向次数阈值（一来一回）
 const DIZZY_AMPLITUDE = 150;    // 窗口内单轴摆幅极差阈值（px）——"大幅"档位，待实测调整
 const DIZZY_RECOVER_MS = 2000;  // 松手后保持晕脸的时长，之后自动回待机
-// 头部区域：x 比例基于左侧 320px 渲染区（spineCanvas.clientWidth），y 基于窗口高。
-// ⚠️ x 不能按整窗 innerWidth（580 = 320 渲染 + 260 气泡）算：0.26×580≈151px 比头部实际
-// 左缘（渲染区内 ~110px）偏右，会把头部左边缘切掉——左侧长按拖动永不触发摸头（实测）。
+// 头部区域：x 比例基于 320px 渲染区宽（spineCanvas.clientWidth——旧版窗口曾含 260px 气泡区，
+// 若按整窗 innerWidth 算 x 会把头部左缘切掉；现窗口已收窄为渲染区本体，两者恰好相等，
+// 但仍按 clientWidth 计算以防未来再加非渲染区域），y 基于窗口高。
 // Spine 姿势实测头部在 CSS y 119~180。
 const HEAD_BOX = { xMin: 0.26, xMax: 0.78, yMin: 0.06, yMax: 0.29 };
 // 摸头期间"离开头部"判定缓冲（px）：用户反馈 16px 太严苛，先放宽 50px、再要求更宽 → 90px；
@@ -300,20 +300,7 @@ function onMouseUp() {
   }
 }
 
-// ---- 文字气泡 ----
-const petBubble = document.getElementById("pet-bubble");
-let bubbleTimer = null;
-
-function showBubble(text) {
-  if (!petBubble) return;
-  petBubble.textContent = text;
-  petBubble.classList.remove("hidden");
-}
-
-function hideBubble() {
-  if (!petBubble) return;
-  petBubble.classList.add("hidden");
-}
+// ---- 文字气泡：已迁至全屏特效窗（fx.html/fx.js），本窗口不再渲染气泡 ----
 
 async function init() {
   // 情绪预设映射：agents.cjs（与 main 进程白名单同源）值 = 预设动画名；
@@ -360,23 +347,6 @@ async function init() {
     window.SpineLayer.setMouthLevel(rms);
   });
 
-  // 文字气泡：只显示 mid/final 短消息；等到 TTS 播放结束（tts_end）再消失
-  window.petAPI.onText(({ kind, data }) => {
-    if (!petBubble) return;
-    if (kind === "tts_end") {
-      if (bubbleTimer) clearTimeout(bubbleTimer);
-      bubbleTimer = null;
-      hideBubble();
-      return;
-    }
-    // mid / final
-    if (typeof data === "string" && data.length > 0) {
-      if (bubbleTimer) clearTimeout(bubbleTimer);
-      bubbleTimer = null;
-      showBubble(data);
-    }
-  });
-
   document.addEventListener("mousedown", onMouseDown);
   document.addEventListener("mousemove", onMouseMove);
   document.addEventListener("mouseup", onMouseUp);

package/pet/renderer/style.css

@@ -31,47 +31,4 @@ body:active {
   pointer-events: none;
   z-index: 1;
 }
-
-
-/* 桌宠文字气泡：定位到角色头部右侧，贴近角色（不遮脸、不高高飘在右上）；
-   top 取头部高度（头 CSS y 40~195），left 270px 贴近头部右缘（≈250）留 ~20px 缝隙，
-   由 ::after 小尾巴向左伸进缝隙指向角色（视觉上"连到"角色，不显远）；
-   高于 Spine、鼠标穿透；只显示 mid/final 短消息 */
-#pet-bubble {
-  position: absolute;
-  left: 270px;
-  top: 90px;
-  transform: none;
-  max-width: 220px;
-  padding: 8px 12px;
-  box-sizing: border-box;
-  background: rgba(20, 22, 34, 0.82);
-  border-radius: 14px;
-  color: #fff;
-  font-size: 13px;
-  line-height: 1.45;
-  text-align: left;
-  white-space: pre-line;
-  word-break: break-all;
-  pointer-events: none;
-  z-index: 10;
-  opacity: 1;
-  transition: opacity 0.25s ease;
-}
-
-/* 左指小三角尾巴：从气泡左缘向左伸进气泡与角色头部的缝隙里，指向角色。
-   随父级 hidden / opacity 过渡一起隐藏。top 取气泡中部即可，位置可按需微调 */
-#pet-bubble::after {
-  content: "";
-  position: absolute;
-  left: -12px;
-  top: 50%;
-  transform: translateY(-50%);
-  border-top: 8px solid transparent;
-  border-bottom: 8px solid transparent;
-  border-right: 12px solid rgba(20, 22, 34, 0.82);
-}
-
-#pet-bubble.hidden {
-  opacity: 0;
-}
+/* 文字气泡已迁至全屏特效窗（fx.html 的 .bubble），桌宠窗口只保留角色渲染区 */

package/src/agent.ts

@@ -20,7 +20,7 @@ import { createSkillTools } from "./tools/skill_tools.ts";
 import { readDocsTool } from "./tools/read_docs_tool.ts";
 import { connectMcpServers } from "./mcp.ts";
 import { InMemoryCredentialStore } from "./in_memory_credentials.ts";
-import { getMainAgent, type SubAgentId, type AgentId } from "./agent_registry.ts";
+import { getMainAgent, getAgentLabel, type SubAgentId, type AgentId } from "./agent_registry.ts";
 import { speakerContextExtension } from "./speaker_context.ts";
 import { gestureContextExtension } from "./gesture_context.ts";
 import { t, getLang } from "./locale.ts";
@@ -593,7 +593,7 @@ export async function initAgent(): Promise<{
 
 // ============================================================
 // 子 Agent（白子 / 星野）—— 纯聊天角色，仅 change_emotion + keep_silent
-// 人设全文硬编码（已内联，不再读外部文件）
+// 人设全文硬编码
 // ============================================================
 
 const SUB_PERSONA_ZH: Record<SubAgentId, string> = {
@@ -668,6 +668,7 @@ function buildSubSystemPrompt(id: SubAgentId, memoryContent: string): string {
 # Group Chat Rules
 
 - You are one of several desktop-pet characters chatting with Sensei (the user).
+- You are ${getAgentLabel(id)}. Always speak as yourself — do not play, mimic, or mix in the identity or tone of any other character (Arona, Plana, Shiroko, Hoshino, Hanako, Koharu).
 - After the main agent finishes replying, each enabled sub-agent takes a turn. Keep your reply SHORT (one or two sentences), natural, in-character, and add nothing but your own spoken line.
 - Do not repeat or summarize the main agent's reply.
 - In the conversation history, assistant messages carry a \`Name:\` prefix showing who said them (e.g. "Arona:", "Shiroko:", etc.); user inputs are Sensei speaking. When you reply, do NOT add any name prefix.
@@ -681,6 +682,7 @@ Available tools: change_emotion (set the emotion before speaking), keep_silent (
 # 群聊规则
 
 - 你是多个桌宠角色之一，正在陪老师聊天。
+- 你是${getAgentLabel(id)}。始终以自己的身份发言，禁止扮演或模仿或混用其他角色（阿洛娜、普拉娜、白子、星野、花子、小春）的身份与语气。
 - 主 Agent 回复完毕后，每个启用的子 Agent 依次发言。回复保持简短（一两句），贴角色，只说自己的台词。
 - 不要复读或总结主 Agent 的话。
 - 对话历史中，assistant 消息带「角色名：」前缀标明发言者（如「阿洛娜：」「砂狼白子：」等）；用户输入是 Sensei 说的。你发言时不要加名字前缀。

package/src/logo.ts

@@ -7,6 +7,10 @@
 
 import figlet from "figlet";
 
+// Fonts 是 @types/figlet 里 export = 命名空间的成员类型，默认导入/具名导入都拿不到；
+// 用 loadFont 的首参反推出等价的字体名联合类型。
+type FigletFont = Parameters<typeof figlet.loadFont>[0];
+
 // 配色（与原 launcher.sh 一致）
 const C = "\x1b[38;2;0;210;255m"; // CYAN  #00D2FF  边框 + 底部字母
 const B = "\x1b[38;2;66;135;245m"; // BLUE  #4287F5  顶部字母
@@ -21,7 +25,7 @@ const R = "\x1b[0m"; // RESET
 // 4) 平面字体（最后兜底）：按宽度降序，每个字体也是先 AGENT 再 ARONA
 //
 // 列数估算已留出边框 2 格 + 缩进 2 格 + 内边距 6 格（即 width + 10）
-const VARIANTS: { text: string; font: figlet.Fonts }[] = [
+const VARIANTS: { text: string; font: FigletFont }[] = [
   // —— ANSI Shadow 绝对优先 ——
   { text: "ARONA AGENT", font: "ANSI Shadow" }, // ~101 列
   { text: "ARONA",       font: "ANSI Shadow" }, // ~53 列

package/src/repl.ts

@@ -77,6 +77,10 @@ export class Repl {
   // 斜杠命令菜单（渲染与状态机封装在 SlashMenu 中）
   private menu = new SlashMenu();
   private menuKeyListener: ((s: any, k: any) => void) | null = null;
+  // 本次按键中被菜单消费、需要拦截 readline 内置处理的键名（up/down 的历史回溯）。
+  // 注意 readline 有自己的 stdin "keypress" 监听器，prependListener 只保证我们先执行，
+  // 无法阻止它处理同一按键——因此 start() 里包装 rl._ttyWrite，读到该字段时短路内置逻辑。
+  private swallowedKeyName: string | null = null;
   // 本地快照式 undo/redo 管理器（不依赖 git）
   private undoManager: UndoManager;
 
@@ -170,7 +174,7 @@ export class Repl {
         (this.rl as any).line = "";
         (this.rl as any).cursor = 0;
         process.stdout.write(chalk.yellow("\n[aborted]\n"));
-        // 标记刚中断过，下一次 Ctrl+C 直接退出（不再提示"再按一次"）
+        // 标记刚中断过，下一次 Ctrl+C 直接退出
         this.sigintCount = 1;
         if (this.sigintTimer) clearTimeout(this.sigintTimer);
         this.sigintTimer = setTimeout(() => {
@@ -528,7 +532,23 @@ export class Repl {
       (process.stdin as any).setRawMode?.(true);
     }
 
-    // 解析热键已移除：STT 热键改为全局监听（pynput），见 startHotkeyHook()
+    // 包装 readline 内部的 _ttyWrite：被菜单消费的导航键（见 swallowedKeyName，由
+    // menuKeyListener 置位）在此短路，readline 不再做历史回溯/移动光标。此前菜单打开时
+    // 按 ↑ 会同时触发 menu.move 和内置历史回溯——输入行直接被"上次执行的命令"覆盖。
+    // 每次调用后立即清标志：一个 keypress 事件只吞一次。
+    // _ttyWrite 是 readline 私有 API，带 typeof 守卫：不可用时优雅降级为旧行为。
+    const rlAny = this.rl as any;
+    if (typeof rlAny._ttyWrite === "function") {
+      const origTtyWrite = rlAny._ttyWrite;
+      rlAny._ttyWrite = (s: string, key: any) => {
+        const swallowed = !!key?.name && this.swallowedKeyName === key.name;
+        this.swallowedKeyName = null;
+        if (swallowed) return;
+        origTtyWrite.call(this.rl, s, key);
+      };
+    }
+
+    // STT 热键为全局监听（pynput），见 startHotkeyHook()
 
     this.rl.prompt();
 
@@ -540,8 +560,15 @@ export class Repl {
       if (this.menu.isOpen()) {
         if (key.name === "escape") { this.menu.close(this.rl); return; }
         if (key.name === "up" || key.name === "down") {
-          this.menu.move(key.name === "up" ? -1 : 1, this.rl);
-          return; // 不转发给 readline（避免移动输入光标）
+          if (this.menu.move(key.name === "up" ? -1 : 1, this.rl)) {
+            // 菜单消费了这次导航：吞掉，readline 不再做历史回溯/移动输入光标
+            this.swallowedKeyName = key.name;
+          } else {
+            // 菜单顶部按 ↑（仅此边界）：放行给 readline 做历史回溯——读取上次执行的命令。
+            // 缓冲区被改写后在微任务里刷新菜单（不再是斜杠前缀/完整命令名时自动关闭）。
+            queueMicrotask(() => this.menu.refresh(this.rl));
+          }
+          return;
         }
         // 行末再按 →：把选中指令填入输入框但不执行（用户可随后补参数/编辑，
         // 再自己 Enter）。光标不在行末时落到 readline 正常移动光标。
@@ -632,7 +659,7 @@ export class Repl {
   }
 
   private async processInput(input: string) {
-    // 桌宠手势（摸头/dizzy）不再拼进用户消息：落到主 Agent 发送边界注入（gesture_context.ts），
+    // 桌宠手势（摸头/dizzy）落到主 Agent 发送边界注入（gesture_context.ts），
     // 不进 state.messages → 子 Agent 复制主 session 历史时看不到、会话命名/存储零污染。
     // takeGesture 消费即清空由发送边界扩展完成，只注入最近一次。
     // 展开 @文件 / !命令 后走完整回合生命周期
@@ -771,7 +798,10 @@ export class Repl {
 
     // 子 Agent 的触发消息：固定短句（上下文在复制来的全量日志里，这里只负责"叫醒"它发言）
     const promptText = isSub
-      ? t("（现在轮到你，请简短发言）", "(It's your turn now, speak briefly)")
+      ? t(
+          `（你是${getAgentLabel(agentId)}。现在轮到你发言——保持你自己的身份和语气，不要扮演或模仿其他角色。请简短发言。）`,
+          `(You are ${getAgentLabel(agentId)}. It's your turn — stay in your own character and voice; do not play or mimic another character. Speak briefly.)`,
+        )
       : input;
 
     try {
@@ -855,13 +885,16 @@ export class Repl {
         console.warn(chalk.yellow(t(`撤销快照记录失败：${err instanceof Error ? err.message : err}`, `Failed to record undo snapshot: ${err instanceof Error ? err.message : err}`)));
       }
       this.isProcessing = false;
-      // 回合结束：恢复桌宠到 idle
-      // - TTS 启用 + 无残余播放 → 立即 reset；有残余由 onIdle(play_end) 兜底
-      // - TTS 禁用（--no-voice / 缺音色 / 切到无音色角色）→ 5s 后再撤表情和气泡
       this.turnEnded = true;
-      if (voice.isTtsEnabledFor(this.activeAgentId)) {
-        if (!this.ttsStream.isPending) pet.reset();
-      } else {
+      // 回合结束：恢复桌宠到 idle + 气泡兜底隐藏。
+      // 以"本回合实际是否还有待播内容"（isPending）为准，而非 TTS 配置开关——
+      // 否则 TTS 开启但整段 ≥50 字被 tts_stream.endTurn 整段跳过时，既没有 play_end
+      // 触发 onIdle 隐藏，又不走 5s 兜底定时器，气泡会永久停留在屏幕上。
+      // - 无待播（含 --no-voice / 缺音色 / ≥50 字整段静音）：立即 reset + 5s 后隐藏气泡
+      // - 有残余播放：由队列排空后的 onIdle(play_end) 隐藏气泡并 reset
+      // （onIdle 已先触发的场景下，这里的定时器重复隐藏一次已隐藏的气泡，无害）
+      if (!this.ttsStream.isPending) {
+        pet.reset();
         this.scheduleBubbleHide();
       }
       // 若被 Esc/Ctrl+C 中断，中断处理已重绘提示符，跳过重复 prompt

package/src/setup.ts

@@ -11,10 +11,10 @@ import {
   type TtsProvider,
 } from "./config.ts";
 import { AGENT_IDS, getAgentLabel, type AgentId } from "./agent_registry.ts";
-import { VOICE_AUDIO, cloneVoice, setVoiceId, getMissingAgents, hasVoice, getGptSovitsVoice, setGptSovitsVoice, deleteGptSovitsVoice } from "./voices.ts";
+import { VOICE_AUDIO, cloneVoice, setVoiceId, getMissingAgents, hasVoice, DEMO_PRECLONED_AGENTS, getGptSovitsVoice, setGptSovitsVoice } from "./voices.ts";
 import { normalizeGptSovitsConfig } from "./tts_provider.ts";
 import { installGptSovitsDeps } from "./gpt_sovits_local.ts";
-import { multiSelect } from "./tui_select.ts";
+import { multiSelect, lockExisting } from "./tui_select.ts";
 import { t, getLang, setLang } from "./locale.ts";
 
 interface Settings {
@@ -46,6 +46,8 @@ interface Settings {
   cuaApiKey?: string;
   pythonPath?: string;
   mcpServers?: Record<string, unknown>;
+  /** 启动时是否从 ~/.agents/skills 补全缺失 Skill（默认 true）；保留手写参数，勿覆盖 */
+  autoLoadSkills?: boolean;
   /** 用户手动维护；setup 向导只读不写。true 时启用演示模式。 */
   demoMode?: boolean;
 }
@@ -122,11 +124,11 @@ async function main() {
     const tried = `"${existing.pythonPath || "python3"}" 与 "python"`;
     if (pyCheck.version === "not found") {
       console.log(chalk.red(t(`\n✗ 未找到可用的 Python（已尝试 ${tried}）。`, `\n✗ No usable Python found (tried ${tried}).`)));
-      console.log(chalk.cyan(t("  ARONA 需要 Python 3.12 或 3.13（不支持 3.14）。", "  ARONA requires Python 3.12 or 3.13 (3.14 is not supported).")));
+      console.log(chalk.cyan(t("  ARONA 需要 Python 3.12 或 3.13。", "  ARONA requires Python 3.12 or 3.13.")));
       console.log(chalk.gray(t("  请安装 Python 后重新运行 arona setup。", "  Install Python and run arona setup again.")));
     } else {
       console.log(chalk.red(t(`\n✗ Python 版本不兼容：${pyCheck.version}`, `\n✗ Incompatible Python version: ${pyCheck.version}`)));
-      console.log(chalk.cyan(t("  ARONA 需要 Python 3.12 或 3.13（不支持 3.14，因 pydantic-core 限制）。", "  ARONA requires Python 3.12 or 3.13 (3.14 not supported due to pydantic-core).")));
+      console.log(chalk.cyan(t("  ARONA 需要 Python 3.12 或 3.13。", "  ARONA requires Python 3.12 or 3.13.")));
       console.log(chalk.gray(t("  请安装正确版本后重新运行 arona setup。", "  Install the correct version and run arona setup again.")));
     }
     process.exit(1);
@@ -160,8 +162,8 @@ async function main() {
     const detected = getLang();
     console.log(chalk.cyan(t(`  检测到系统语言：${detected === "en" ? "英文 (en)" : "中文 (zh)"}`, `  Detected system language: ${detected === "en" ? "English (en)" : "Chinese (zh)"}`)));
     const langInput = (await ask(t(
-      "  语言选择 [auto/en/zh]（默认 auto=按系统）：",
-      "  Language [auto/en/zh] (default auto = follow system): ",
+      "  语言选择 [auto/en/zh]: ",
+      "  Language [auto/en/zh]: ",
     ))).toLowerCase();
     let langSetting: "auto" | "zh" | "en" = "auto";
     if (langInput === "en") { langSetting = "en"; setLang("en"); }
@@ -206,7 +208,7 @@ async function main() {
     // Step 2: 语音配置
     // ============================================================
     console.log(chalk.bold.cyan(t("\nStep 2: 语音配置\n", "\nStep 2: Voice Configuration\n")));
-    console.log(chalk.cyan(t("  百炼 API Key（可选，用于TTS/STT）", "  Dashscope API Key (optional, for TTS/STT)")));
+    console.log(chalk.cyan(t("  百炼 API Key（可选）", "  Dashscope API Key (optional)")));
     console.log(chalk.cyan(t("  获取 API Key: https://help.aliyun.com/zh/model-studio/get-api-key\n", "  Get API Key: https://help.aliyun.com/zh/model-studio/get-api-key\n")));
 
     const existingTtsKey = existing.ttsApiKey || "";
@@ -218,7 +220,7 @@ async function main() {
 
     console.log(chalk.bold.cyan(t("\n  TTS Provider 菜单\n", "\n  TTS Provider Menu\n")));
     const providerOptions = [
-      { id: "aliyun", label: t("阿里云百炼（默认）", "Dashscope") },
+      { id: "aliyun", label: t("阿里云百炼", "Dashscope") },
       { id: "gpt-sovits", label: t("GPT-SoVITS", "GPT-SoVITS") },
     ];
     // 二选一使用 TUI 单选菜单（不要求键盘输入 1/2）
@@ -247,7 +249,7 @@ async function main() {
       console.log(chalk.bold.cyan(t("\n  GPT-SoVITS 配置\n", "\n  GPT-SoVITS Configuration\n")));
       // readline 已在上方 TUI 前关闭；为后续 TUI 选择保持 stdin 空闲
       const deployOptions = [
-        { id: "cloud", label: t("云端 API（远程服务）", "Cloud API (remote)") },
+        { id: "cloud", label: t("云端 API", "Cloud API") },
         { id: "local", label: t("本地模型", "Local model") },
       ];
       const deploySelected = await multiSelect(
@@ -418,7 +420,7 @@ async function main() {
         `  text_lang [${gptSovitsConfig.textLang}] (auto/zh/en/ja/yue/ko): `,
       ));
       const textLang = textLangInput.trim() || gptSovitsConfig.textLang;
-      // prompt_lang 不再全局询问：按每角色参考音频文字内容自动判断（走默认素材固定 zh，见 tts_provider.detectPromptLang）
+      // prompt_lang 按每角色参考音频文字内容自动判断（默认素材固定 zh，见 tts_provider.detectPromptLang）
       gptSovitsConfig = {
         ...gptSovitsConfig,
         mode,
@@ -433,9 +435,16 @@ async function main() {
       };
       rl2.close();
 
-      // 多选要配置音色的角色：全部可编辑（已配置者默认 [*]，取消勾选 = 删除该角色配置）
-      const configured = AGENT_IDS.filter((id) => getGptSovitsVoice(id));
-      const options = AGENT_IDS.map((id) => ({ id, label: getAgentLabel(id), locked: false }));
+      // 多选要配置音色的角色：已配置者经 lockExisting 锁定为已克隆。
+      // 演示模式：硬编码全未克隆，路径信息直接丢弃、不写 voices.json。
+      const configured: AgentId[] = demoMode ? [] : AGENT_IDS.filter((id) => getGptSovitsVoice(id));
+      const options = lockExisting(
+        AGENT_IDS.map((id) => ({
+          id,
+          label: configured.includes(id) ? `${getAgentLabel(id)}${t("（已克隆）", " (cloned)")}` : getAgentLabel(id),
+        })),
+        configured,
+      );
       const selected = await multiSelect(
         t("选择要配置 GPT-SoVITS 音色的角色", "Select characters to configure GPT-SoVITS voices"),
         options,
@@ -468,24 +477,37 @@ async function main() {
         if (!selected.has(id)) continue;
         const prev = getGptSovitsVoice(id) || {};
         console.log(chalk.bold.cyan(t(`\n  ${getAgentLabel(id)} 音色配置\n`, `\n  ${getAgentLabel(id)} voice config\n`)));
+        // GPT/SoVITS 权重必填：无既有值默认 [ N/A ]，空输入黄色提示后重新询问。
         const prevCkpt = prev.gptWeightsPath || "";
-        const ckpt = (await ask3(t(
-          prevCkpt
-            ? `    GPT 权重 .ckpt 路径 [${prevCkpt}]: `
-            : "    GPT 权重 .ckpt 路径 [不切换]: ",
-          prevCkpt
-            ? `    GPT weights .ckpt path [${prevCkpt}]: `
-            : "    GPT weights .ckpt path [no switch]: ",
-        ))).trim() || prevCkpt;
+        let ckpt = prevCkpt;
+        for (;;) {
+          const ckptInput = (await ask3(t(
+            ckpt
+              ? `    GPT 权重 .ckpt 路径 [${ckpt}]: `
+              : "    GPT 权重 .ckpt 路径 [ N/A ]: ",
+            ckpt
+              ? `    GPT weights .ckpt path [${ckpt}]: `
+              : "    GPT weights .ckpt path [ N/A ]: ",
+          ))).trim();
+          if (ckptInput) { ckpt = ckptInput; break; }
+          if (prevCkpt) break;
+          console.log(chalk.yellow(t("    请输入路径！", "    Please enter a path!")));
+        }
         const prevPth = prev.sovitsWeightsPath || "";
-        const pth = (await ask3(t(
-          prevPth
-            ? `    SoVITS 权重 .pth 路径 [${prevPth}]: `
-            : "    SoVITS 权重 .pth 路径 [不切换]: ",
-          prevPth
-            ? `    SoVITS weights .pth path [${prevPth}]: `
-            : "    SoVITS weights .pth path [no switch]: ",
-        ))).trim() || prevPth;
+        let pth = prevPth;
+        for (;;) {
+          const pthInput = (await ask3(t(
+            pth
+              ? `    SoVITS 权重 .pth 路径 [${pth}]: `
+              : "    SoVITS 权重 .pth 路径 [ N/A ]: ",
+            pth
+              ? `    SoVITS weights .pth path [${pth}]: `
+              : "    SoVITS weights .pth path [ N/A ]: ",
+          ))).trim();
+          if (pthInput) { pth = pthInput; break; }
+          if (prevPth) break;
+          console.log(chalk.yellow(t("    请输入路径！", "    Please enter a path!")));
+        }
         const prevRef = prev.refAudioPath || "";
         // cloud 模式 ref 必填（无 ref 则该角色 isTtsEnabledFor=false 静音且无解释）；循环重询直至非空
         let ref = prevRef;
@@ -506,8 +528,8 @@ async function main() {
           if (prevRef) break;
           if (mode !== "cloud") break;
           console.log(chalk.yellow(t(
-            `    ref_audio_path 不能为空（云端模式必填）。`,
-            `    ref_audio_path cannot be empty (required in cloud mode).`,
+            `    ref_audio_path 不能为空。`,
+            `    ref_audio_path cannot be empty.`,
           )));
         }
         const prevText = prev.promptText || "";
@@ -515,20 +537,19 @@ async function main() {
           prevText
             ? `    示例音频文字内容 prompt_text [${prevText}]: `
             : mode === "cloud"
-              ? "    示例音频文字内容 prompt_text [必填，文字/本地txt路径/URL]（语言自动判断）: "
-              : "    示例音频文字内容 prompt_text [文字/本地txt路径/URL，缺省用 voice_text.txt]（语言自动判断）: ",
+              ? "    示例音频文字内容 prompt_text [文字/本地txt路径/URL]: "
+              : `    示例音频文字内容 prompt_text [assets/blue-archive/${id}/voice_text.txt]: `,
           prevText
             ? `    Reference audio text prompt_text [${prevText}]: `
             : mode === "cloud"
-              ? "    Reference audio text prompt_text [required, text/local txt path/URL] (lang auto-detected): "
-              : "    Reference audio text prompt_text [text/local txt path/URL, default voice_text.txt] (lang auto-detected): ",
+              ? "    Reference audio text prompt_text [text/local txt path/URL]: "
+              : `    Reference audio text prompt_text [assets/blue-archive/${id}/voice_text.txt]: `,
         ))).trim() || prevText;
         // 每角色音色写 voices.json#gpt-sovits（与百炼 voice_id 共存，不写 settings.json）
-        setGptSovitsVoice(id, { gptWeightsPath: ckpt, sovitsWeightsPath: pth, refAudioPath: ref, promptText: refText });
-      }
-      // 未勾选的原已配置角色 → 删除其配置（幂等）
-      for (const id of AGENT_IDS) {
-        if (configured.includes(id) && !selected.has(id)) deleteGptSovitsVoice(id);
+        // 演示模式：路径信息直接丢弃，不写 voices.json。
+        if (!demoMode) {
+          setGptSovitsVoice(id, { gptWeightsPath: ckpt, sovitsWeightsPath: pth, refAudioPath: ref, promptText: refText });
+        }
       }
       rl3.close();
     }
@@ -588,22 +609,26 @@ async function main() {
         // 多选 TUI 独占 stdin raw mode（此后不再用 rl.question；rl 已在 TTS Provider TUI 前关闭）。
 
         // 已有音色的角色锁定 [*]（迁移已在模块加载时完成，此处读到的 voices.json 已是新格式）。
-        const missing = getMissingAgents();
+        // 演示模式：必然显示 TUI，预标记角色锁定为已克隆，其余未克隆。
+        const missing = demoMode ? AGENT_IDS : getMissingAgents();
         if (missing.length === 0) {
           console.log(chalk.green(t(
             "  所有角色已有音色，无需克隆。如需重新克隆请运行 arona voice add <角色名>。",
             "  All characters already have voices. Use `arona voice add <name>` to re-clone.",
           )));
         } else {
-          const options = AGENT_IDS.map((id) => ({
-            id,
-            label: hasVoice(id) ? `${getAgentLabel(id)}${t("（已克隆）", " (cloned)")}` : getAgentLabel(id),
-            locked: hasVoice(id),
-          }));
+          const clonedIds = demoMode ? DEMO_PRECLONED_AGENTS : AGENT_IDS.filter((id) => hasVoice(id));
+          const options = lockExisting(
+            AGENT_IDS.map((id) => ({
+              id,
+              label: clonedIds.includes(id) ? `${getAgentLabel(id)}${t("（已克隆）", " (cloned)")}` : getAgentLabel(id),
+            })),
+            clonedIds,
+          );
           const selected = await multiSelect(
             t("选择要克隆音色的角色", "Select characters to clone voices."),
             options,
-            new Set<string>(), // 已有音色者 locked 强制 [*]，未克隆者默认 [ ]
+            new Set<string>(), // 已有音色者经 lockExisting 锁定，未克隆者默认 [ ]
             t(
               "  ↑/↓ 切换 · 空格选中 [*] · 回车克隆 · Esc 取消",
               "  ↑/↓ move · Space select [*] · Enter clone · Esc cancel",
@@ -618,7 +643,7 @@ async function main() {
             )));
             return;
           } else if (selected.size === 0) {
-            console.log(chalk.cyan(t("  未选择任何角色，跳过音色克隆（TTS 将保持静音）。", "  No character selected, skipping voice cloning (TTS stays muted).")));
+            console.log(chalk.cyan(t("  未选择任何角色，跳过音色克隆。", "  No character selected, skipping voice cloning.")));
           } else {
             const model = existing.ttsModel || "qwen-audio-3.0-tts-plus";
             for (const id of AGENT_IDS) {
@@ -629,13 +654,13 @@ async function main() {
                 continue;
               }
               if (demoMode) {
-                // 演示模式：不调用 voice_clone.py、不写 voices.json，静默 5s 后显示成功。
-                console.log(chalk.cyan(t(`  正在克隆 ${getAgentLabel(id)} 的音色...`, `Cloning voice for ${getAgentLabel(id)}...`)));
+                // 演示模式：不调用 voice_clone.py、不写 voices.json，5s 模拟后显示成功。
+                console.log(chalk.cyan(t(`  正在克隆 ${getAgentLabel(id)} 的音色...`, `  Cloning ${getAgentLabel(id)}'s voice...`)));
                 await new Promise((r) => setTimeout(r, 5000));
                 console.log(chalk.green(t(`  ✓ ${getAgentLabel(id)} 音色克隆成功`, `  ✓ ${getAgentLabel(id)} voice cloned.`)));
                 continue;
               }
-              console.log(chalk.cyan(t(`  正在克隆 ${getAgentLabel(id)} 的音色（可能需要 1-2 分钟）...`, `  Cloning ${getAgentLabel(id)}'s voice (may take 1-2 minutes)...`)));
+              console.log(chalk.cyan(t(`  正在克隆 ${getAgentLabel(id)} 的音色...`, `  Cloning ${getAgentLabel(id)}'s voice...`)));
               try {
                 const voiceId = await cloneVoice(id, ttsApiKey, model);
                 setVoiceId(id, voiceId);

package/src/slash_menu.ts

@@ -171,15 +171,21 @@ export class SlashMenu {
     this.redraw(rl);
   }
 
-  /** ↑/↓ 导航（循环）。 */
-  move(direction: -1 | 1, rl: Interface): void {
-    if (!this.visible || this.matches.length === 0) return;
+  /**
+   * ↑/↓ 导航。返回是否移动了选中项：
+   * - ↓ 到底环绕回顶部（保持循环导航）；
+   * - ↑ 在顶部（selected === 0）不环绕，返回 false 作为"到达边界"信号，
+   *   由 repl 放行给 readline 做历史回溯（读取上次执行的命令）。
+   */
+  move(direction: -1 | 1, rl: Interface): boolean {
+    if (!this.visible || this.matches.length === 0) return false;
+    if (direction === -1 && this.selected === 0) return false; // 顶部按 ↑：交给历史回溯
     let next = this.selected + direction;
-    if (next < 0) next = this.matches.length - 1;
     if (next >= this.matches.length) next = 0;
     this.selected = next;
     this.clampScroll();
     this.redraw(rl);
+    return true;
   }
 
   /**

package/src/slash_registry.ts

@@ -26,7 +26,7 @@ export interface SlashCommandSpec {
 export const SLASH_COMMANDS: SlashCommandSpec[] = [
   { name: "help", aliases: ["?"], description: t("显示命令列表", "Show command list") },
   { name: "exit", aliases: ["quit", "q"], description: t("退出", "Exit") },
-  { name: "new", aliases: ["clear"], description: t("开始新会话（清空上下文）", "Start a new session (clear context)") },
+  { name: "new", aliases: ["clear"], description: t("开始新会话", "Start a new session") },
   { name: "resume", aliases: ["r"], description: t("上下键选择并恢复一个已保存的会话", "Pick and resume a saved session with arrow keys"), interactive: true },
   { name: "export", description: t("导出当前会话为 Markdown", "Export current session as Markdown") },
   { name: "thinking", description: t("开关推理块显示", "Toggle reasoning block display") },
@@ -34,7 +34,7 @@ export const SLASH_COMMANDS: SlashCommandSpec[] = [
   { name: "compact", description: t("压缩上下文", "Compact context") },
   { name: "tts", description: t("开关文字转语音", "Toggle text-to-speech") },
   { name: "stt", description: t(`开关语音转文字`, `Toggle speech-to-text`) },
-  { name: "skill", description: t("调用技能（/skill <名称>）", "Invoke a skill (/skill <name>)") },
+  { name: "skill", description: t("调用技能", "Invoke a skill") },
   { name: "mcp", description: t("管理 MCP 服务器和工具", "Manage MCP servers and tools") },
   { name: "change-agent", description: t("切换主 Agent + 多选子 Agent", "Switch main agent + multi-select sub agents"), interactive: true },
   { name: "undo", description: t("撤销上一个回合的全部文件改动", "Undo the previous turn's file changes") },

package/src/tools/skill_tools.ts

@@ -20,8 +20,8 @@ function loadSkillsTool(loader: DefaultResourceLoader): ToolDefinition {
     name: "load_skills",
     label: t("加载技能", "Load Skills"),
     description: t(
-      "列出或加载技能。**不传 names 时**：返回所有可用技能的 name + description 列表，便于先发现再加载。**传 names 时**：返回对应技能的 SKILL.md 全文（支持单个字符串或字符串数组），加载后遵循其中指令执行；未找到的技能会在结果中列出。建议单次加载不超过 5 个，避免上下文膨胀。",
-      "List or load skills. **Without names**: returns the name + description list of all available skills, so you can discover before loading. **With names**: returns the full SKILL.md content of the requested skills (accepts a single string or an array of strings); follow the instructions inside after loading; missing skills are reported in the result. Load at most 5 per call to avoid bloating the context.",
+      "列出或加载技能。**不传 names 时**：返回所有可用技能的 name + description 列表。**传 names 时**：返回对应技能的 SKILL.md 全文（单个字符串或字符串数组），加载后遵循其中指令执行；未找到的技能在结果中列出。单次加载不超过 5 个。",
+      "List or load skills. **Without names**: returns the name + description list of all available skills. **With names**: returns the full SKILL.md content of the requested skills (a single string or an array of strings); follow the instructions inside after loading; missing skills are reported in the result. Load at most 5 per call.",
     ),
     parameters: Type.Object({
       names: Type.Optional(

package/src/tui_select.ts

@@ -8,10 +8,22 @@ import { t } from "./locale.ts";
 export interface SelectOption {
   id: string;
   label: string;
-  /** 锁定：强制显示 [*]，空格不可切换（已有音色的角色）。 */
+  /**
+   * 锁定（已存在/已配置的项）。
+   * 请统一用 lockExisting() 按 existing 集合生成。
+   */
   locked?: boolean;
 }
 
+/**
+ * 把"已存在/已配置"的项标记为锁定。调用方给出 existing 集合即可。
+ * 已显式 locked:true 的项保持锁定；不在 existing 里的项原样返回。
+ */
+export function lockExisting<T extends SelectOption>(options: readonly T[], existing: Iterable<string>): T[] {
+  const set = new Set(existing);
+  return options.map((o) => (o.locked || set.has(o.id) ? { ...o, locked: true } : o));
+}
+
 /** 计算一个字符串去除 ANSI 转义后的可见宽度（CJK/全角算 2，控制符算 0）。 */
 function visibleWidth(s: string): number {
   const stripped = s.replace(/\x1b(?:\[[0-9;?]*[A-Za-z]|[0-9])/g, "");

package/src/undo.ts

@@ -135,8 +135,8 @@ export class UndoManager {
 
   /**
    * 启动时调用:加载持久化状态(如有),并在后台异步刷新基线为当前工作目录真实状态。
-   * 基线扫描改为后台异步 + 有界(MAX_SCAN_FILES/深度/系统目录):在 ~/、/ 等巨型目录下
-   * 同步全盘递归会把启动卡死(此前每次启动都在这卡住,子目录正常)。
+   * 基线扫描为后台异步 + 有界(MAX_SCAN_FILES/深度/系统目录):在 ~/、/ 等巨型目录下
+   * 同步全盘递归会卡死启动。
    */
   load(): void {
     try {
@@ -377,7 +377,7 @@ export class UndoManager {
 
   private hashLargeFile(abs: string): string {
     // 只读 4KB 头 + 4KB 尾 + size 当 hash 近似(够用于检测删除)
-    // 用 fd 流式读取,避免把整个大文件读入内存(原实现误用 readFileSync 全量读取)
+    // 用 fd 流式读取,避免把整个大文件读入内存
     let fd: number | null = null;
     try {
       const stat = statSync(abs);
@@ -436,8 +436,7 @@ export class UndoManager {
 
   /**
    * 把 before / after 两个 snapshot 对比,产出 changed files 的 diff。
-   * content 直接取自 snapshot(takeSnapshot 已读出),不再回读文件——
-   * 因为 afterTurn 调用时,文件已是 after 状态,回读会污染 before 内容。
+   * content 直接取自 snapshot（takeSnapshot 已读出）。
    * 无变化返回 null。
    */
   private computeDiff(

package/src/voice_cli.ts

@@ -10,8 +10,8 @@ import { existsSync, readFileSync } from "fs";
 import chalk from "chalk";
 import { SETTINGS_FILE, verbose } from "./config.ts";
 import { AGENT_IDS, getAgentLabel, type AgentId } from "./agent_registry.ts";
-import { cloneVoice, hasVoice, setVoiceId, getGptSovitsVoice, setGptSovitsVoice, deleteGptSovitsVoice } from "./voices.ts";
-import { multiSelect } from "./tui_select.ts";
+import { cloneVoice, hasVoice, setVoiceId, DEMO_PRECLONED_AGENTS, getGptSovitsVoice, setGptSovitsVoice } from "./voices.ts";
+import { multiSelect, lockExisting } from "./tui_select.ts";
 import { t } from "./locale.ts";
 
 function readSettings(): { ttsApiKey: string; ttsModel: string; ttsProvider: string } {
@@ -52,8 +52,9 @@ function isValidAgentId(id: string): id is AgentId {
  * 配置 GPT-SoVITS 每角色音色（gptWeightsPath/sovitsWeightsPath/refAudioPath/promptText）。
  * 写 voices.json#gpt-sovits（read-modify-write，与 voices.json#aliyun 的百炼音色共存）。
  * 带角色名 = 只配置该角色；无参 = TUI 多选（原已配置角色默认 [*]，取消勾选 = 删除其配置）。
+ * 演示模式：TUI 默认显示所有角色都为未克隆，记录的路径信息直接丢弃、不写 voices.json。
  */
-async function configureGptSovitsVoice(name?: string): Promise<void> {
+async function configureGptSovitsVoice(name: string | undefined, demoMode: boolean): Promise<void> {
   const targets: AgentId[] = [];
   if (name) {
     if (!isValidAgentId(name)) {
@@ -65,8 +66,16 @@ async function configureGptSovitsVoice(name?: string): Promise<void> {
     }
     targets.push(name);
   } else {
-    const configured = AGENT_IDS.filter((id) => getGptSovitsVoice(id));
-    const options = AGENT_IDS.map((id) => ({ id, label: getAgentLabel(id), locked: false }));
+    // 已配置者经 lockExisting 锁定为已克隆。
+    // 演示模式：硬编码全未克隆。
+    const configured: AgentId[] = demoMode ? [] : AGENT_IDS.filter((id) => getGptSovitsVoice(id));
+    const options = lockExisting(
+      AGENT_IDS.map((id) => ({
+        id,
+        label: configured.includes(id) ? `${getAgentLabel(id)}${t("（已克隆）", " (cloned)")}` : getAgentLabel(id),
+      })),
+      configured,
+    );
     const selected = await multiSelect(
       t("选择要配置 GPT-SoVITS 音色的角色", "Select characters to configure GPT-SoVITS voices"),
       options,
@@ -81,10 +90,6 @@ async function configureGptSovitsVoice(name?: string): Promise<void> {
       return;
     }
     targets.push(...AGENT_IDS.filter((id) => selected.has(id)));
-    // 未勾选的原已配置角色 → 删除其配置（与 setup 语义一致）
-    for (const id of AGENT_IDS) {
-      if (configured.includes(id) && !selected.has(id)) deleteGptSovitsVoice(id);
-    }
   }
 
   if (targets.length === 0) {
@@ -109,16 +114,29 @@ async function configureGptSovitsVoice(name?: string): Promise<void> {
       `\n  ${getAgentLabel(id)} GPT-SoVITS 音色配置\n`,
       `\n  ${getAgentLabel(id)} GPT-SoVITS voice config\n`,
     )));
+    // GPT/SoVITS 权重必填：无既有值默认 [ N/A ]，空输入黄色提示后重新询问。
     const prevCkpt = prev.gptWeightsPath || "";
-    const ckpt = (await ask(t(
-      prevCkpt ? `    GPT 权重 .ckpt 路径 [${prevCkpt}]: ` : "    GPT 权重 .ckpt 路径 [不切换]: ",
-      prevCkpt ? `    GPT weights .ckpt path [${prevCkpt}]: ` : "    GPT weights .ckpt path [no switch]: ",
-    ))) || prevCkpt;
+    let ckpt = prevCkpt;
+    for (;;) {
+      const ckptInput = (await ask(t(
+        ckpt ? `    GPT 权重 .ckpt 路径 [${ckpt}]: ` : "    GPT 权重 .ckpt 路径 [ N/A ]: ",
+        ckpt ? `    GPT weights .ckpt path [${ckpt}]: ` : "    GPT weights .ckpt path [ N/A ]: ",
+      ))).trim();
+      if (ckptInput) { ckpt = ckptInput; break; }
+      if (prevCkpt) break;
+      console.log(chalk.yellow(t("    请输入路径！", "    Please enter a path!")));
+    }
     const prevPth = prev.sovitsWeightsPath || "";
-    const pth = (await ask(t(
-      prevPth ? `    SoVITS 权重 .pth 路径 [${prevPth}]: ` : "    SoVITS 权重 .pth 路径 [不切换]: ",
-      prevPth ? `    SoVITS weights .pth path [${prevPth}]: ` : "    SoVITS weights .pth path [no switch]: ",
-    ))) || prevPth;
+    let pth = prevPth;
+    for (;;) {
+      const pthInput = (await ask(t(
+        pth ? `    SoVITS 权重 .pth 路径 [${pth}]: ` : "    SoVITS 权重 .pth 路径 [ N/A ]: ",
+        pth ? `    SoVITS weights .pth path [${pth}]: ` : "    SoVITS weights .pth path [ N/A ]: ",
+      ))).trim();
+      if (pthInput) { pth = pthInput; break; }
+      if (prevPth) break;
+      console.log(chalk.yellow(t("    请输入路径！", "    Please enter a path!")));
+    }
     const prevRef = prev.refAudioPath || "";
     const ref = (await ask(t(
       prevRef ? `    示例音频 ref_audio_path [${prevRef}]: ` : "    示例音频 ref_audio_path [本地路径或URL]: ",
@@ -126,11 +144,18 @@ async function configureGptSovitsVoice(name?: string): Promise<void> {
     ))) || prevRef;
     const prevText = prev.promptText || "";
     const text = (await ask(t(
-      prevText ? `    示例音频文字 prompt_text [${prevText}]: ` : "    示例音频文字 prompt_text [文字/本地txt路径/URL]（语言自动判断）: ",
-      prevText ? `    Reference audio text prompt_text [${prevText}]: ` : "    Reference audio text prompt_text [text/local txt path/URL] (lang auto-detected): ",
+      prevText
+        ? `    示例音频文字内容 prompt_text [${prevText}]: `
+        : `    示例音频文字内容 prompt_text [assets/blue-archive/${id}/voice_text.txt]: `,
+      prevText
+        ? `    Reference audio text prompt_text [${prevText}]: `
+        : `    Reference audio text prompt_text [assets/blue-archive/${id}/voice_text.txt]: `,
     ))) || prevText;
     // 每角色音色写 voices.json#gpt-sovits（与百炼 voice_id 共存，不写 settings.json）
-    setGptSovitsVoice(id, { gptWeightsPath: ckpt, sovitsWeightsPath: pth, refAudioPath: ref, promptText: text });
+    // 演示模式：路径信息直接丢弃，不写 voices.json。
+    if (!demoMode) {
+      setGptSovitsVoice(id, { gptWeightsPath: ckpt, sovitsWeightsPath: pth, refAudioPath: ref, promptText: text });
+    }
   }
   rl.close();
 
@@ -160,8 +185,8 @@ async function cloneOne(agent: AgentId, apiKey: string, model: string, simulate:
   if (simulate) {
     // 演示模式：打印"正在克隆"与"克隆成功"，但不调用 voice_clone.py、不写 voices.json、无演示模式提示。
     console.log(chalk.cyan(t(
-      `正在克隆 ${getAgentLabel(agent)} 的音色（可能需要 1-2 分钟）...`,
-      `Cloning ${getAgentLabel(agent)}'s voice (may take 1-2 minutes)...`,
+      `正在克隆 ${getAgentLabel(agent)} 的音色...`,
+      `Cloning ${getAgentLabel(agent)}'s voice...`,
     )));
     await new Promise((r) => setTimeout(r, 5000));
     console.log(chalk.green(t(
@@ -171,8 +196,8 @@ async function cloneOne(agent: AgentId, apiKey: string, model: string, simulate:
     return true;
   }
   console.log(chalk.cyan(t(
-    `正在克隆 ${getAgentLabel(agent)} 的音色（可能需要 1-2 分钟）...`,
-    `Cloning ${getAgentLabel(agent)}'s voice (may take 1-2 minutes)...`,
+    `正在克隆 ${getAgentLabel(agent)} 的音色...`,
+    `Cloning ${getAgentLabel(agent)}'s voice...`,
   )));
   try {
     const voiceId = await cloneVoice(agent, apiKey, model);
@@ -214,13 +239,13 @@ async function run(argv: string[]): Promise<void> {
 
   // GPT-SoVITS：配置每角色专属权重/参考音频（写 voices.json#gpt-sovits，与百炼音色共存）。
   if (ttsProvider === "gpt-sovits") {
-    await configureGptSovitsVoice(name);
+    await configureGptSovitsVoice(name, demoMode);
     return;
   }
   if (ttsProvider !== "aliyun") {
     console.log(chalk.yellow(t(
-      `当前 TTS Provider 为 ${ttsProvider}：arona voice add 仅支持 aliyun（百炼音色克隆）与 gpt-sovits（每角色权重/参考音频配置）。`,
-      `Current TTS Provider is ${ttsProvider}: arona voice add only supports aliyun (Bailian cloning) and gpt-sovits (per-character weights/ref audio).`,
+      `当前 TTS Provider 为 ${ttsProvider}：arona voice add 仅支持 aliyun 与 gpt-sovits。`,
+      `Current TTS Provider is ${ttsProvider}: arona voice add only supports aliyun and gpt-sovits.`,
     )));
     process.exit(1);
   }
@@ -257,20 +282,15 @@ async function run(argv: string[]): Promise<void> {
   }
 
   // 无参：TUI 展示全部角色（主 Agent + 子 Agent）。
-  // 演示模式：阿洛娜强制显示为已克隆（锁定、不重克隆）；普拉娜/砂狼白子/小鸟游星野强制显示为未克隆（可选）。
-  const options = AGENT_IDS.map((id) => {
-    if (demoMode && id === "arona") {
-      return { id, label: `${getAgentLabel(id)}${t("（已克隆）", " (cloned)")}`, locked: true };
-    }
-    if (demoMode) {
-      return { id, label: getAgentLabel(id), locked: false };
-    }
-    return {
+  // 演示模式：Arona/Plana/Shiroko/Hoshino 显示为已克隆，其余显示为未克隆。
+  const clonedIds = demoMode ? DEMO_PRECLONED_AGENTS : AGENT_IDS.filter((id) => hasVoice(id));
+  const options = lockExisting(
+    AGENT_IDS.map((id) => ({
       id,
-      label: hasVoice(id) ? `${getAgentLabel(id)}${t("（已克隆）", " (cloned)")}` : getAgentLabel(id),
-      locked: hasVoice(id),
-    };
-  });
+      label: clonedIds.includes(id) ? `${getAgentLabel(id)}${t("（已克隆）", " (cloned)")}` : getAgentLabel(id),
+    })),
+    clonedIds,
+  );
   const initial = new Set<string>();
   const selected = await multiSelect(
     t("选择要补全音色的角色", "Select characters to add voices"),

package/src/voices.ts

@@ -178,6 +178,12 @@ export function getMissingAgents(): AgentId[] {
   return AGENT_IDS.filter((id) => !hasVoice(id));
 }
 
+/**
+ * 演示模式（settings.json#demoMode === true）下，aliyun 分支 TUI 预标记为"已克隆"并锁定的角色。
+ * setup.ts 与 voice_cli.ts 共用此表（配合 tui_select.lockExisting），保证两个命令的演示行为一致（其余角色视为未克隆）。
+ */
+export const DEMO_PRECLONED_AGENTS: readonly AgentId[] = ["arona", "plana", "shiroko", "hoshino"];
+
 /**
  * 克隆指定角色的百炼音色，返回 voice_id。
  * 复用 python/voice_clone.py：ARONA_VOICE_AUDIO + ARONA_VOICE_PREFIX 指定音频与角色前缀。