arona-agent 1.2.3 → 1.2.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "arona-agent",
-  "version": "1.2.3",
+  "version": "1.2.4",
   "description": "Terminal AI Agent with desktop pet Arona — eye-tracking pupils, voice cloning, Computer Use, TTS/STT, MCP.",
   "keywords": [
     "voice-clone",

package/pet/renderer/renderer.js

@@ -11,6 +11,8 @@
 // 摸头/dizzy 手势级互斥（interactionDone）：同一次按住内任一触发过，另一项禁用直到松开。
 // 空闲注视：瞳孔跟随光标（spine_layer.js 内部实现），头部不歪。
 // 眨眼：Eye_Close_01 独立轨道（track5，预设之上），2~6s 均匀随机，15% 概率双眨；闭眼预设期间禁止。
+// 悬停渐隐：光标在桌宠不透明像素停留 ≥2s 且未触发摸头/dizzy → canvas opacity 渐隐揭示背后内容，
+//   移开渐入；会话内触发过摸头/dizzy 则移开前不再判断（状态机见下方悬停渐隐区块）。
 const spineCanvas = document.getElementById("spine");
 
 const IS_IDLE_DEBUG = new URLSearchParams(location.search).has("idledebug");
@@ -112,6 +114,10 @@ const HEAD_BOX = { xMin: 0.26, xMax: 0.78, yMin: 0.06, yMax: 0.29 };
 // 摸头期间"离开头部"判定缓冲（px）：用户反馈 16px 太严苛，先放宽 50px、再要求更宽 → 90px；
 // 摸头时手在头部附近大幅游移不打断；离开很远（躯干以下/窗口外）才结束 enjoy
 const HEAD_EXIT_MARGIN = 90;
+// ---- 悬停渐隐：光标在桌宠不透明像素停留 ≥2s 且未触发摸头/dizzy → 渐隐揭示背后内容，移开渐入 ----
+const HOVER_PEEK_MS = 2000;   // 悬停时长阈值
+const PEEK_FADE_MS = 300;     // 渐隐/渐入过渡时长
+const HOVER_EVAL_MS = 500;    // 悬停状态评估周期（光标轮询静止不重发事件，需周期评估防入口竞态）
 
 let dragging = false;
 let shaking = false;      // 摸头态（摇动触发）
@@ -126,6 +132,68 @@ let dizzyTimer = null;    // 松手后的延迟恢复定时器
 // 堵"摸头触发→离开头部区退出→继续大幅晃又触发 dizzy"（及反向）的串扰。
 let interactionDone = false;
 
+// ---- 悬停渐隐状态机 ----
+// onPet 判定复用动态穿透的 alpha 滞回（进入 ≥CLICK_ALPHA_ON / 退出 <CLICK_ALPHA_OFF）；
+// hoverOn 只在 500ms 周期评估（evalHover）里翻转——主进程光标轮询静止时（位移 <1px）不重发
+// pet:cursor，若只在事件里评估，光标刚停进桌宠边缘的那次事件拿到的仍是旧帧 alpha，会漏启动计时。
+let hoverOn = false;         // 光标在桌宠不透明像素上
+let peeked = false;          // 渐隐揭示态（canvas opacity 0）
+let peekBlocked = false;     // 本次悬停会话内触发过摸头/dizzy → 移开前不再判断
+let hoverTimer = null;       // 2s 悬停计时
+let lastCursor = null;       // 主进程光标轮询的最后坐标（窗口本地 CSS px）
+
+function isCursorOnPet() {
+  const c = lastCursor;
+  const cw = spineCanvas.clientWidth, ch = spineCanvas.clientHeight;
+  if (!c || c.x < 0 || c.y < 0 || c.x >= cw || c.y >= ch) return false;
+  const a = window.SpineLayer.getPickAlpha();
+  return hoverOn ? a >= CLICK_ALPHA_OFF : a >= CLICK_ALPHA_ON;
+}
+
+function setPeeked(on) {
+  if (on === peeked) return;
+  peeked = on;
+  spineCanvas.style.transition = `opacity ${PEEK_FADE_MS}ms ease`;
+  spineCanvas.style.opacity = on ? 0 : 1;
+  updateClickable(); // 渐隐期间强制穿透；渐入后按 alpha 重估
+}
+
+function clearHoverTimer() {
+  if (hoverTimer) {
+    clearTimeout(hoverTimer);
+    hoverTimer = null;
+  }
+}
+
+function scheduleHoverTimer() {
+  clearHoverTimer();
+  hoverTimer = setTimeout(checkHover, HOVER_PEEK_MS);
+}
+
+function checkHover() {
+  hoverTimer = null;
+  if (!hoverOn) return;
+  if (peekBlocked) return; // 会话内触发过摸头/dizzy → 移开前不再判断
+  if (dragging || shaking || dizzy) { // 手势进行中：推迟，结束后继续评估
+    hoverTimer = setTimeout(checkHover, HOVER_EVAL_MS);
+    return;
+  }
+  setPeeked(true);
+}
+
+function evalHover() {
+  const on = isCursorOnPet();
+  if (on === hoverOn) return;
+  hoverOn = on;
+  if (on) {
+    peekBlocked = false; // 重新进入：重置会话阻断
+    scheduleHoverTimer();
+  } else {
+    clearHoverTimer();
+    setPeeked(false); // 移开 → 渐入
+  }
+}
+
 // ---- 动态鼠标穿透（窗口 480 宽，透明区放行点击到下层应用）----
 // 光标处 alpha（spine_layer 渲染循环内采样，经 onCursor 时机读取）滞回阈值防角色边缘抖动：
 // 进入可点 ≥24，退出 <10；拖动/摸头手势期间强制可点（松手瞬间的 mouseup 不能丢）。
@@ -134,7 +202,9 @@ const CLICK_ALPHA_OFF = 10;
 let clickable = false;
 function updateClickable() {
   let want;
-  if (dragging || shaking) {
+  if (peeked) {
+    want = false; // 渐隐揭示期间点击穿透到背后内容
+  } else if (dragging || shaking) {
     want = true;
   } else {
     const a = window.SpineLayer.getPickAlpha ? window.SpineLayer.getPickAlpha() : 255;
@@ -155,6 +225,8 @@ function pushSample(x, y) {
 
 function enterPat() {
   interactionDone = true; // 手势级互斥：本手势内 dizzy 不再触发
+  if (hoverOn) peekBlocked = true; // 悬停会话内触发摸头 → 移开前不再渐隐
+  clearHoverTimer();
   window.SpineLayer.startPat();
   window.petAPI.shake();
 }
@@ -167,6 +239,8 @@ function exitPat() {
 // 窗口不锁死：dizzy 状态下仍走现有拖动路径（桌宠跟随鼠标被拎着晃），松手 dragEnd 落盘位置。
 function enterDizzy() {
   interactionDone = true; // 手势级互斥：本手势内摸头不再触发
+  if (hoverOn) peekBlocked = true; // 悬停会话内触发 dizzy → 移开前不再渐隐
+  clearHoverTimer();
   dizzy = true;
   window.petAPI.dizzy(); // 上报（与 pet:shake 对称，主进程仅日志）
   routeTo("dizzy");      // 幂等；闭眼预设（Arona 30 / Plana 13）自动禁眨眼/关注视
@@ -354,6 +428,7 @@ async function init() {
   // mousemove 断流（换向/位移凑不齐 → 摸头"没反应"），主进程 16ms 轮询不断流，
   // 轻微出窗的晃动也能采到 → 轻微划出窗口仍视为摸头手势的一部分。
   window.petAPI.onCursor((x, y, gx, gy) => {
+    lastCursor = { x, y };
     window.SpineLayer.setCursor(x, y);
     if (dragging) pushSample(gx, gy);
     updateClickable();
@@ -374,6 +449,7 @@ async function init() {
   document.addEventListener("mouseup", onMouseUp);
 
   scheduleBlink();
+  setInterval(evalHover, HOVER_EVAL_MS);
 }
 
 init();