arona-agent 1.2.0 → 1.2.1

package/gui/main.cjs

@@ -307,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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "arona-agent",
-  "version": "1.2.0",
+  "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",

package/src/gui/index.ts

@@ -21,9 +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); // 白屏排查：后端→GUI 事件流向
+    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));
@@ -56,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");
@@ -167,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();