arona-agent 1.1.7 → 1.2.0

package/gui/main.cjs

@@ -1,9 +1,20 @@
 // ARONA GUI Electron 主进程：单窗口，与 Node 后端父进程经 stdin/stdout JSON lines 通信
 // （协议行前缀 ###GUI### 过滤 Electron 日志；与桌宠桥同模式）。
-const { app, BrowserWindow, ipcMain, nativeImage } = require("electron");
+const { app, BrowserWindow, Menu, ipcMain, nativeImage } = require("electron");
 const fs = require("fs");
 const path = require("path");
 
+// Windows：GUI 是纯 HTML/CSS（无 WebGL），默认硬件加速下页面加载/脚本均正常但不 paint（白屏，
+// 无 did-fail-load / render-process-gone / renderer 报错）——本机硬件 GPU 合成路径有问题，禁 GPU 走
+// 软件渲染（桌宠同款已验证配置）。ARONA_GUI_GPU=1 可强制恢复硬件加速用于排障对比。
+if (process.platform === "win32" && process.env.ARONA_GUI_GPU !== "1") {
+  app.commandLine.appendSwitch("disable-gpu");
+}
+// 桌宠（pet/main.cjs）与本 GUI 是两个 Electron 进程，默认共用 userData（%APPDATA%/arona-agent）会
+// 竞争磁盘缓存锁（日志表现：Unable to move the cache 0x5 / Gpu Cache Creation failed / DIPS SQLite
+// 初始化失败），ready 前按进程隔离。
+app.setPath("userData", path.join(app.getPath("appData"), "arona-agent-gui"));
+
 const APP_TITLE = "Arona Agent";
 const ICON_PATH = path.join(__dirname, "renderer", "assets", "icon.png");
 
@@ -26,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() {
@@ -226,8 +248,10 @@ function createWindow() {
     minHeight: 480,
     title: APP_TITLE,
     backgroundColor: "#f6f7f9",
-    titleBarStyle: "hiddenInset",
-    trafficLightPosition: { x: 16, y: 16 },
+    // hiddenInset/trafficLightPosition 是 macOS 专用（Windows 忽略 titleBarStyle，标准边框 + 无菜单）
+    ...(process.platform === "darwin"
+      ? { titleBarStyle: "hiddenInset", trafficLightPosition: { x: 16, y: 16 } }
+      : {}),
     icon: ICON_PATH,
     webPreferences: {
       preload: path.join(__dirname, "preload.cjs"),
@@ -238,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"));
@@ -247,6 +272,16 @@ function createWindow() {
   win.webContents.on("did-fail-load", (_e, code, desc, url) => {
     console.error(`[gui] did-fail-load ${code} ${desc} ${url}`);
   });
+  // renderer console → stderr：GUI 白屏等"进程活着但无画面"问题时可见。error 级无条件转发，
+  // 其余仅 VERBOSE（Electron 43 规范签名为单事件对象 event.{message,level,lineNumber}，与桌宠同）
+  win.webContents.on("console-message", (event) => {
+    const msg = typeof event.message === "string" ? event.message : "";
+    if (!msg) return;
+    if (VERBOSE || event.level === 3) {
+      const line = event.lineNumber ? `:${event.lineNumber}` : "";
+      console.error(`[gui:render:${event.level ?? "?"}]${line} ${msg}`);
+    }
+  });
   if (VERBOSE) win.webContents.openDevTools({ mode: "detach" });
 }
 
@@ -279,11 +314,23 @@ app.on("window-all-closed", () => {
 });
 
 app.whenReady().then(() => {
+  // Windows 上默认应用菜单（File/Edit/View/Window）画进窗口顶部，GUI 用不到 → 移除
+  //（须在 ready 后调用；Ctrl+C/V 等编辑快捷键是原生行为不受影响，仅去掉 Reload/DevTools 默认键）
+  if (process.platform === "win32") Menu.setApplicationMenu(null);
   // macOS 开发模式下 Dock 图标默认是 Electron 图标，用 LOGO 替换（打包后由应用 bundle 提供）
   if (process.platform === "darwin" && app.dock) {
     const icon = nativeImage.createFromPath(ICON_PATH);
     if (!icon.isEmpty()) app.dock.setIcon(icon);
   }
+  if (VERBOSE) {
+    // GPU 功能状态：Windows 白屏排查关键（disable-gpu 下预期 gpu_compositing=disabled_software 且可正常上屏）
+    try {
+      console.error("[gui:verbose] GPU feature status:", JSON.stringify(app.getGPUFeatureStatus()));
+    } catch (e) {
+      console.error("[gui:verbose] getGPUFeatureStatus failed:", e.message);
+    }
+    console.error("[gui:verbose] platform:", process.platform, "electron:", process.versions.electron, "chrome:", process.versions.chrome);
+  }
   createWindow();
 });
 

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.7",
+  "version": "1.2.0",
   "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/pet/main.cjs

@@ -8,6 +8,11 @@ const fs = require("fs");
 const os = require("os");
 const { AGENTS } = require("./agents.cjs");
 
+// 与 GUI（gui/main.cjs）是两个 Electron 进程：默认共用 userData（%APPDATA%/arona-agent）会竞争磁盘
+// 缓存锁（Windows 日志表现：Unable to move the cache 0x5 / Gpu Cache Creation failed / DIPS SQLite
+// 初始化失败），ready 前按进程隔离。
+app.setPath("userData", path.join(app.getPath("appData"), "arona-agent-pet"));
+
 // Windows 透明无边框窗口在部分显卡驱动下会触发渲染进程崩溃；禁 GPU 硬件加速（须在 app ready 前调用）。
 // 注意：不能用 app.disableHardwareAcceleration()——Electron 43 里它会顺带 --disable-software-rasterizer，
 // 把软件 WebGL 一并堵死（实测 getGPUFeatureStatus().webgl === "disabled_off"，Spine 直接白屏）。

package/src/gui/index.ts

@@ -23,6 +23,7 @@ class GuiBridge {
   private exited = false;
 
   emit(ev: GuiEvent): void {
+    if (verbose) console.error(chalk.gray("[gui:verbose]"), "emit", ev.type); // 白屏排查：后端→GUI 事件流向
     if (!this.proc || this.proc.killed) return;
     try {
       this.proc.stdin.write(formatGuiLine(ev));
@@ -41,7 +42,14 @@ class GuiBridge {
     const env: NodeJS.ProcessEnv = { ...process.env, ARONA_GUI: "1" };
     delete env.ELECTRON_RUN_AS_NODE;
     const args = ["--no-sandbox"];
-    if (verbose) args.push("--enable-logging");
+    if (verbose) {
+      // --enable-logging：渲染进程 console（GPU 初始化失败等）原样打进 stderr，白屏根因不传则完全不可见；
+      // ARONA_GUI_VERBOSE：接通 gui/main.cjs 的 VERBOSE 分支（GPU feature status / renderer console
+      // 全量转发 / devtools 自动打开）——此前未接线，--verbose 下这些诊断从未生效过。
+      args.push("--enable-logging");
+      env.ARONA_GUI_VERBOSE = "1";
+      console.error(chalk.gray("[gui:verbose]"), "spawn", electronPath, args.concat(join(GUI_DIR, "main.cjs")).join(" "));
+    }
 
     this.proc = spawn(electronPath, args.concat(join(GUI_DIR, "main.cjs")), {
       env,