arona-agent 1.1.8 → 1.2.1

package/gui/main.cjs

@@ -37,33 +37,44 @@ const pending = [];
 
 function forward(msg) {
   if (win && !win.isDestroyed() && rendererReady) {
+    if (VERBOSE) console.error("[gui:verbose] forward", msg.type);
     win.webContents.send("gui-event", msg);
   } else {
+    if (VERBOSE) console.error("[gui:verbose] buffer", msg.type, "(rendererReady=" + rendererReady + ")");
     pending.push(msg);
   }
 }
 
 function flushPending() {
   if (!win || win.isDestroyed()) return;
+  if (VERBOSE && pending.length) console.error("[gui:verbose] flush " + pending.length + " buffered events");
   while (pending.length) {
     win.webContents.send("gui-event", pending.shift());
   }
 }
 
-// ARONA_GUI_SMOKE=1：loadFile + flush 后探测 DOM（页面可见性 / preload / 渲染层脚本），
-// 结果打 SMOKE_RESULT 行后退出——冒烟验证 mode 事件不丢（无需人工看窗口）。
-// 另起 SMOKE_UI 探测（8s 后，等 startMain 就绪）：欢迎页 LOGO / 浅色背景 / 斜杠菜单过滤 / 工具行样式。
-function smokeProbe(skipQuit) {
+// ARONA_GUI_SMOKE=1：loadFile 后周期探测 DOM（每 2s，最长 30s）——页面可见性 / preload / 渲染层脚本，
+// 结果打 SMOKE_RESULT 行；一旦有页面揭示（或超时）打 SMOKE_UI 详情后退出。
+// 周期重试的原因：后端 startMain（initAgent 等）可能远超 8s，单次探测会把"启动慢"误判成"事件未送达"。
+function smokeProbe() {
   const js = '(function(){var p=document.querySelectorAll(".page:not(.hidden)");'
     + 'return JSON.stringify({visible:p.length?p[0].id:null,'
     + 'api:!!(window.guiAPI&&window.guiAPI.send&&window.guiAPI.on),'
     + 'setup:!!(window.SetupUI&&window.SetupUI.handle)});})()';
-  setTimeout(() => {
+  const started = Date.now();
+  const timer = setInterval(() => {
+    if (!win || win.isDestroyed()) { clearInterval(timer); return; }
     win.webContents.executeJavaScript(js)
       // stderr 会被 backend 转发到终端（stdout 被 ###GUI### 协议解析占用）
-      .then((r) => { console.error("SMOKE_RESULT " + r); if (!skipQuit) app.quit(); })
-      .catch((e) => { console.error("SMOKE_ERROR " + e); if (!skipQuit) app.quit(); });
-  }, 300);
+      .then((r) => {
+        console.error("SMOKE_RESULT " + r);
+        if (JSON.parse(r).visible || Date.now() - started >= 30000) {
+          clearInterval(timer);
+          smokeProbeUI();
+        }
+      })
+      .catch((e) => { console.error("SMOKE_ERROR " + e); clearInterval(timer); smokeProbeUI(); });
+  }, 2000);
 }
 
 function smokeProbeUI() {
@@ -251,8 +262,9 @@ function createWindow() {
   // 先挂监听再 loadFile：避免加载完成事件在挂监听前触发导致 rendererReady 永不置位
   win.webContents.once("did-finish-load", () => {
     rendererReady = true;
+    if (VERBOSE) console.error("[gui:verbose] did-finish-load, pending=" + pending.length);
     flushPending();
-    if (process.env.ARONA_GUI_SMOKE === "1") { smokeProbe(true); smokeProbeUI(); }
+    if (process.env.ARONA_GUI_SMOKE === "1") smokeProbe();
     if (process.env.ARONA_GUI_DEMO === "1") setTimeout(demoScenario, 2000);
   });
   win.loadFile(path.join(__dirname, "renderer", "index.html"));
@@ -295,6 +307,11 @@ process.stdin.on("data", (data) => {
   }
 });
 
+// 握手：告知 backend 本进程的 stdin 解析器已就绪，可以开始下发 ###GUI### 事件。
+// Windows 下 spawn 后立刻写 stdin 会丢数据（GUI 白屏根因：mode 事件从未到达本进程），
+// backend 收到 hello 前把事件全部入队，收到后按序下发。
+send({ type: "hello" });
+
 // 窗口全关：先发 exit 请求让后端走完整清理，再退出（延迟让协议行先 flush）
 app.on("window-all-closed", () => {
   send({ type: "exit" });

package/gui/renderer/app.js

@@ -1,5 +1,15 @@
 // ARONA GUI 渲染层主逻辑：###GUI### 协议 → DOM（侧栏会话列表 / 斜杠菜单 / 消息流 / 麦克风 / 弹窗）
+// 全局错误陷阱：未捕获异常打进 console.error（经 main.cjs 以 [gui:render:3] 转发终端）——
+// 定位"页面加载正常但 .page 保持 hidden → 白屏"时 app.js 中途崩溃的情况
+window.addEventListener("error", (e) => {
+  console.error("[app.js] window error:", e.message, e.filename + ":" + e.lineno);
+});
+window.addEventListener("unhandledrejection", (e) => {
+  console.error("[app.js] unhandled rejection:", e.reason);
+});
+
 (function () {
+  console.log("[app.js] boot");
   const $ = (sel) => document.querySelector(sel);
   const api = window.guiAPI;
   const chat = $("#chat");
@@ -1166,6 +1176,7 @@
 
   // ── 协议分发 ──────────────────────────────────
   api.on((msg) => {
+    if (msg.type === "mode") console.log("[app.js] mode ->", msg.mode); // 白屏排查：确认事件到达渲染层
     switch (msg.type) {
       case "mode":
         $("#main-page").classList.toggle("hidden", msg.mode !== "main");
@@ -1227,4 +1238,5 @@
   });
 
   updateSendState(); // 初始为空输入：发送按钮置灰
+  console.log("[app.js] listener ready"); // 白屏排查：走到此处 = app.js 完整执行、api.on 已注册
 })();

package/package.json

@@ -1,8 +1,16 @@
 {
   "name": "arona-agent",
-  "version": "1.1.8",
+  "version": "1.2.1",
   "description": "Terminal AI Agent with desktop pet Arona — eye-tracking pupils, voice cloning, Computer Use, TTS/STT, MCP.",
-  "keywords": ["voice-clone", "Blue Archive", "blue-archive", "ai-agent", "arona", "computer-use", "desktop-pet"],
+  "keywords": [
+    "voice-clone",
+    "Blue Archive",
+    "blue-archive",
+    "ai-agent",
+    "arona",
+    "computer-use",
+    "desktop-pet"
+  ],
   "license": "MIT",
   "type": "module",
   "bin": {

package/src/gui/index.ts

@@ -21,8 +21,18 @@ class GuiBridge {
   private controller: GuiController | null = null;
   private startingMain = false;
   private exited = false;
+  // Windows 下 spawn 后立刻写 stdin 会丢数据（GUI 白屏根因：mode 事件从未到达 Electron 进程）——
+  // 等 GUI 进程回报 hello（stdin 解析器就绪的握手，gui/main.cjs 模块加载即发送）才真正下发，此前入队。
+  // macOS/Linux 不受影响，但握手在所有平台统一走一遍（幂等，且顺带验证 stdout 协议链路通）。
+  private helloReceived = false;
+  private queuedEvents: GuiEvent[] = [];
 
   emit(ev: GuiEvent): void {
+    if (verbose) console.error(chalk.gray("[gui:verbose]"), "emit", ev.type, this.helloReceived ? "" : "(queued)");
+    if (!this.helloReceived) {
+      this.queuedEvents.push(ev);
+      return;
+    }
     if (!this.proc || this.proc.killed) return;
     try {
       this.proc.stdin.write(formatGuiLine(ev));
@@ -55,6 +65,16 @@ class GuiBridge {
       stdio: ["pipe", "pipe", "pipe"],
     });
 
+    // 握手超时告警：hello 不来 = GUI 进程的 stdin/stdout 协议链路不通（页面白屏只是其结果）
+    setTimeout(() => {
+      if (!this.helloReceived && !this.exited && this.proc) {
+        console.error(chalk.red(t(
+          "GUI：15s 未收到 GUI 进程握手（hello），###GUI### stdin 协议链路不通，界面将保持白屏。",
+          "GUI: no handshake (hello) from the GUI process within 15s; the ###GUI### stdin protocol is broken and the window will stay blank.",
+        )));
+      }
+    }, 15000);
+
     this.proc.stdout.on("data", (data) => {
       this.buffer += data.toString();
       const lines = this.buffer.split("\n");
@@ -166,6 +186,18 @@ class GuiBridge {
 
   private async handleRequest(req: GuiRequest): Promise<void> {
     switch (req.type) {
+      case "hello": {
+        // GUI 进程 stdin 解析器就绪：解锁排队中的事件（emit mode/setup_info 在 spawn 后立即调用，
+        // Windows 下彼时写入会丢失——见 emit() 注释）
+        this.helloReceived = true;
+        const queued = this.queuedEvents;
+        this.queuedEvents = [];
+        if (verbose && queued.length) {
+          console.error(chalk.gray("[gui:verbose]"), "hello received, flushing", queued.length, "queued events");
+        }
+        for (const ev of queued) this.emit(ev);
+        break;
+      }
       case "setup_submit": {
         const ok = await runGuiSetup(req.form as unknown as GuiSetupForm, (ev) => this.emit(ev));
         if (ok) await this.startMain();