@glittering0717/ai-browser 2.1.18 → 2.1.19

package/README.md

@@ -724,7 +724,7 @@ not bugs. The full write-up, including why the first measurement of this was wro
 ## Test & dev
 
 ```bash
-npm test             # vitest — 411 tests across 27 files
+npm test             # vitest — 970 tests across 69 files
 npm run smoke        # Electron contract layer, offline fixture      — 31 checks
 npm run capabilities # text fields, canvas, page source, network, DOM editing — 54 checks
 npm run richtext     # rich-text editors, nested menus, forms, errors, tags, upload — 117 checks
@@ -736,8 +736,14 @@ npm run audit        # every advertised action must exist; wait/downloads/permis
 npm run nav          # address bar + load-failure error page (the "white screen" report) — 19 checks
 npm run focus        # no focus stealing + full capability while backgrounded — 32 checks
 npm run interact     # trusted drag / key press / wheel (pointer gestures) — 31 checks
-npm run view         # viewport repaint + snapshot/diff verification — 28 checks
-npm run e2e:all      # 一次跑完上面全部套件（每个独立端口）+ 可信汇总 — 428 checks
+npm run view         # viewport repaint budget + snapshot/diff verification — 29 checks
+npm run dialog       # browser-level dialogs (native sheet blocks the renderer) — 15 checks
+npm run wrapper      # "in the tree but won't click" = matched a container, not a link — 13 checks
+npm run paint        # blank-page self-check: verdicts, bounded ladder, no false alarms — 23 checks
+npm run layout       # geometry invariants + "no twitching" (zero extra repaints on nav) — 25 checks
+npm run flicker      # frame-level: no frame may render the page shrunk (needs screen recording) — 6 checks
+npm run e2e:all      # 一次跑完上面全部 19 个套件（每个独立端口）+ 可信汇总 — 636 checks
+npm run verify:app   # boot the packaged /Applications app and assert on it — 22 checks
 npm run realsites    # navigate/read/act against a matrix of real sites
 ```
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@glittering0717/ai-browser",
-  "version": "2.1.18",
+  "version": "2.1.19",
   "description": "AI-native browser — renders pixels for humans, structured semantic-tree API for agents. No screenshots, no OCR, no coordinate guessing.",
   "main": "src/main/index.js",
   "bin": {
@@ -84,7 +84,8 @@
     "verify:app": "node e2e/shipped_ws.cjs",
     "wrapper": "node e2e/wrapper_ws.cjs",
     "paint": "node e2e/paint_ws.cjs",
-    "layout": "node e2e/layout_ws.cjs"
+    "layout": "node e2e/layout_ws.cjs",
+    "flicker": "node e2e/flicker_ws.cjs"
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",

package/src/main/page_manager.js

@@ -1040,7 +1040,18 @@ class PageManager {
         captureBeyondViewport: o.fullPage,
       };
       if (o.quality !== undefined) params.quality = o.quality;
-      if (o.clip) params.clip = o.clip;
+      // clip.scale < 1（"给我一张缩略概览"）**绝不交给合成器**：带 clip.scale 的
+      // 截图会让 Chromium 按该比例临时重建 surface，窗口恰好在合成时就会贴上那张
+      // 缩小的图 1–3 帧（见 SPEC「取帧两条铁律」，2026-10-25 实锤）。
+      // 现在按 scale=1 抓、用 nativeImage 在我们自己这边缩 —— 输出尺寸一致，
+      // 但不再碰合成器。scale>1（放大取值）仍交给 Chromium：本地放大得不到像素。
+      let localScale = 1;
+      if (o.clip && typeof o.clip.scale === 'number' && o.clip.scale > 0 && o.clip.scale < 1) {
+        localScale = o.clip.scale;
+        params.clip = { ...o.clip, scale: 1 };
+      } else if (o.clip) {
+        params.clip = o.clip;
+      }
       const shot = await withDeadline(
         dbg.sendCommand('Page.captureScreenshot', params),
         20000, 'captureScreenshot'
@@ -1048,6 +1059,21 @@ class PageManager {
       if (!shot || typeof shot.data !== 'string') {
         return { ok: false, error: 'empty screenshot result', tab: tid };
       }
+      // 需要缩小就自己做（见上：不把缩放交给合成器）。
+      let imgData = shot.data;
+      if (localScale !== 1) {
+        try {
+          const img0 = nativeImage.createFromBuffer(Buffer.from(shot.data, 'base64'));
+          if (!img0.isEmpty()) {
+            const sz = img0.getSize();
+            const w = Math.max(1, Math.round(sz.width * localScale));
+            const resized = img0.resize({ width: w });
+            imgData = o.format === 'jpeg'
+              ? resized.toJPEG(typeof o.quality === 'number' ? o.quality : 80).toString('base64')
+              : resized.toPNG().toString('base64');
+          }
+        } catch (_) { /* 缩失败就用原图（宁可图大，不要空图） */ }
+      }
 
       const mime = 'image/' + (o.format === 'jpeg' ? 'jpeg' : o.format);
       // 一次 evaluate 拿两样东西：可见密码框（截图不脱敏，泄密了得让调用方
@@ -1070,7 +1096,7 @@ class PageManager {
       const summary = screenshotOpts.describeShot({
         format: o.format,
         mime,
-        bytes: Buffer.byteLength(shot.data, 'base64'),
+        bytes: Buffer.byteLength(imgData, 'base64'),
         width: meta.width,
         height: meta.height,
         url: (this._getView(tid) && this._getView(tid).webContents.getURL()) || undefined,
@@ -1082,7 +1108,7 @@ class PageManager {
       if (o.path) {
         try {
           fs.mkdirSync(path.dirname(o.path), { recursive: true });
-          fs.writeFileSync(o.path, Buffer.from(shot.data, 'base64'));
+          fs.writeFileSync(o.path, Buffer.from(imgData, 'base64'));
           filePath = o.path;
         } catch (e) {
           return { ok: false, tab: tid, error: 'screenshot captured but writing to ' + o.path + ' failed: ' + ((e && e.message) || e), ...summary };
@@ -1095,7 +1121,7 @@ class PageManager {
         ok: true,
         tab: tid,
         // data 是 base64 裸数据（不带 data: 前缀）—— 调用方按需自己拼。
-        data: shot.data,
+        data: imgData,
         mime,
         ...(filePath ? { path: filePath } : {}),
         ...(ignored.length ? { ignored_params: ignored } : {}),

package/src/shared/version.js

@@ -2,4 +2,4 @@
 // Kept in JS (not imported from package.json) to avoid Node import-attribute
 // (JSON module) compatibility issues inside Electron. package.json "version"
 // is manually synced to this value; tests assert they match.
-export const VERSION = '2.1.18';
+export const VERSION = '2.1.19';