antigravity-office 2.5D Pixel Agent Office 实景截图
图 1:antigravity-office 注入在首页的 2.5D 像素工作室看板

1. 第一轮修复(6f6b7a8):修稳了数据竞态,界面却继续闪且草稿归零

在 antigravity-office 里,我们在输入框 + 按钮旁挂载了一个极简的上下文余量圆环。上线后发现圆环经常闪烁跳变,第一轮很快定位到两个真的数据层竞态并修掉了:

然而改完上线后出现了两个极其反直觉的现象:圆环还在闪,而且打字时的实时草稿 Token 估算悄悄失效了。后者原因让人哭笑不得:

// 第一轮引入的回归:estimateTextTokens() 返回的是对象 { tokens, chars, cjk },不是数字!
const draftTokens = trimmed ? usageCore.estimateTextTokens(trimmed) : 0;

// 下游 computeRingTelemetry() 里:
const draft = Math.max(0, Number(draftTokens) || 0); // Number({...}) === NaN -> 0

JavaScript 的 Number(obj) || 0 没有任何报错,只是静默地把所有实时输入估算抹成了 0。

2. 第二轮修复(53e84e7):躲在 DOM 生命周期里的 5 个闪烁真凶

宿主 React 重渲 / 输入框打字事件 MutationObserver isHudNode() 过滤自身变更 syncRings() 走 rAF 同帧挂载 · 无 250ms 盲窗 syncStudio() 防抖 250ms 重型 2.5D SVG 解耦独立刷新 占位环 + Promise 去重 22x28px 透明 pending 占位 entry.inflight 复用请求 keepRing:true 原地改属性
图 2:拆离 rAF 轻量渲染通道与全墙 250ms 防抖、用透明占位环锁死布局

把视角从 RPC 移到 Electron React 渲染进程后,真正的五个闪烁根因全部浮出水面:

  1. 自触发 MutationObserver + 250ms 防抖空窗:以前 mutObs 把极轻的圆环更新和重绘整面 2.5D 办公室的 syncStudio() 绑进同一个 250ms 防抖,宿主动一次输入框,圆环就要凭空消失 250ms;且 HUD 自己修改 DOM 又触发自身 observer。拆出 syncRings() 走同帧 requestAnimationFrame,并通过 isHudNode() 忽略自身节点变更。
  2. 切对话执行 existing.remove() 导致布局跳变:切到未缓存对话时先删掉圆环节点,旁边按钮整体左塌 22px,数据回来又弹回去。改用透明描边的 22×28px pending 占位环占住几何位置。
  3. 布尔锁 entry.fetching 返回 null:改为基于 entry.inflight 的 Promise 去重。
  4. 热更新重注入先拆后建:watcher.mjs 热重载脚本时调用 __agLiteHudDestroy({ keepRing: true }),保留 DOM 只原地更新 stroke 与 stroke-dasharray。
  5. 旧样式类名残留冲突:统一为 .ag-lite-ctx-ring 并显式隐藏旧类名及去重多余兄弟节点。

3. 顺手踩平的两个隐蔽 CDP 坑位

诚实边界
该工具仍是挂载于 Antigravity 私有 DOM 选择器与 React Fiber 属性之上的本地渲染层覆盖,上游大幅改版时需同步适配选择器;零外网请求、无需系统辅助功能/录屏权限,唯一落盘的数据文件为本地测速样本 ~/.config/howmanyusage/agy-speed.json。
← 上一篇:Ghostty 定时注入 11 个静默坑位 下一篇:AI 记忆内核的 Fail-Closed 边界设计 →