@jackwener/opencli 1.6.0 → 1.6.2

package/skills/smart-search/references/sources-other.md

@@ -0,0 +1,42 @@
+# 其他垂直源
+
+用于求职、金融、书籍、词典等不适合归入前述分类的场景。
+
+## 站点
+
+### linkedin
+
+- 适用：全球职位、英文岗位、跨国公司招聘
+- 使用前先运行：`opencli linkedin -h`
+
+### boss
+
+- 适用：国内职位搜索、招聘与岗位信息
+- 使用前先运行：`opencli boss -h`
+
+### xueqiu
+
+- 适用：股票、金融讨论、行情相关线索
+- 使用前先运行：`opencli xueqiu -h`
+
+### weread
+
+- 适用：中文书籍搜索与书单线索
+- 使用前先运行：`opencli weread -h`
+
+### dictionary
+
+- 适用：英文词义、基础词典查询
+- 使用前先运行：`opencli dictionary -h`
+
+### sinablog
+
+- 适用：较旧的中文博客内容
+- 使用前先运行：`opencli sinablog -h`
+
+## 路由提示
+
+- 求职：全球优先 `linkedin`，国内优先 `boss`
+- 金融：优先 `xueqiu`
+- 书籍：中文优先 `weread`
+- 英文单词定义：优先 `dictionary`

package/skills/smart-search/references/sources-shopping.md

@@ -0,0 +1,31 @@
+# 购物
+
+用于商品搜索、价格、好价、口碑与区域电商结果。
+
+## 站点
+
+### amazon
+
+- 适用：全球商品搜索、价格参考、英文电商
+- 使用前先运行：`opencli amazon -h`
+
+### smzdm
+
+- 适用：国内好价、优惠、导购、商品讨论
+- 使用前先运行：`opencli smzdm -h`
+
+### coupang
+
+- 适用：韩国电商商品搜索
+- 使用前先运行：`opencli coupang -h`
+
+### douban
+
+- 适用：图书、影视、音乐类口碑补充，不是标准电商，但可用于消费决策补充
+- 使用前先运行：`opencli douban -h`
+
+## 路由提示
+
+- 用户指定平台时直接使用该平台
+- 未指定平台时，全球商品优先 `amazon`，国内好价优先 `smzdm`
+- 若先用 AI 做产品调研，后续可补电商站点拿实际商品结果

package/skills/smart-search/references/sources-social.md

@@ -0,0 +1,51 @@
+# 社交媒体
+
+用于需要原始帖子、原始用户结果、中文或英文社区讨论时。
+
+## 站点
+
+### twitter
+
+- 适用：Twitter/X 原始帖子、作者、实时讨论
+- 使用前先运行：`opencli twitter -h`
+
+### weibo
+
+- 适用：微博热点、话题、中文舆论
+- 使用前先运行：`opencli weibo -h`
+
+### xiaohongshu
+
+- 适用：生活方式、穿搭、美妆、旅行、真实体验
+- 使用前先运行：`opencli xiaohongshu -h`
+
+### zhihu
+
+- 适用：中文深度问答、专业解释、行业经验
+- 使用前先运行：`opencli zhihu -h`
+
+### tieba
+
+- 适用：兴趣圈子、历史帖子、粉丝社区
+- 使用前先运行：`opencli tieba -h`
+
+### instagram
+
+- 适用：账号搜索、图片社交线索
+- 使用前先运行：`opencli instagram -h`
+
+### facebook
+
+- 适用：主页、人物、帖子线索
+- 使用前先运行：`opencli facebook -h`
+
+### bluesky
+
+- 适用：Bluesky 用户与账号搜索
+- 使用前先运行：`opencli bluesky -h`
+
+## 路由提示
+
+- 用户明确指定某个平台时，直接用该平台
+- 用户只说“社交媒体上怎么看”时，可先选 `grok` 或 `doubao`
+- AI 只给摘要而没有原始帖子时，再切到对应社交站点

package/skills/smart-search/references/sources-tech.md

@@ -0,0 +1,42 @@
+# 技术 / 学术
+
+用于技术问题、研究论文、开发者讨论、开源社区信息。
+
+## 站点
+
+### arxiv
+
+- 适用：论文、研究、模型、算法、学术背景
+- 使用前先运行：`opencli arxiv -h`
+
+### stackoverflow
+
+- 适用：具体报错、API 用法、代码模式、实现细节
+- 使用前先运行：`opencli stackoverflow -h`
+
+### hackernews
+
+- 适用：技术社区讨论、开发者观点、创业和产品话题
+- 使用前先运行：`opencli hackernews -h`
+
+### reddit
+
+- 适用：英文社区问答、经验贴、推荐、对比讨论
+- 使用前先运行：`opencli reddit -h`
+
+### linux-do
+
+- 适用：人工智能、开源工具、中文技术社区
+- 使用前先运行：`opencli linux-do -h`
+
+### v2ex
+
+- 适用：中文技术社区
+- 使用前先运行：`opencli linux-do 
+
+## 路由提示
+
+- 用户明确说“论文”“研究”时，优先 `arxiv`
+- 用户明确说“报错”“API 怎么用”时，优先 `stackoverflow`
+- 用户要“社区讨论”“开发者观点”时，优先 `hackernews` 或 `reddit`
+- 若用户没有明确指定站点，可先选 `gemini` 或 `grok`，内容不足时再补这些专用源

package/skills/smart-search/references/sources-travel.md

@@ -0,0 +1,20 @@
+# 旅游
+
+用于目的地、景区、酒店联想和旅行线索。
+
+## 站点
+
+### ctrip
+
+- 适用：目的地、景区、酒店、旅行联想搜索
+- 使用前先运行：`opencli ctrip -h`
+
+### xiaohongshu
+
+- 适用：生活方式、穿搭、美妆、旅行、真实体验
+- 使用前先运行：`opencli xiaohongshu -h`
+
+## 路由提示
+
+- 用户明确说“携程”时直接使用 `ctrip`
+- 用户只说“旅行/目的地/景区”时，可先选 `doubao` 做中文语境粗检索，再补 `ctrip`

package/src/browser/base-page.ts

@@ -27,6 +27,8 @@ import { formatSnapshot } from '../snapshotFormatter.js';
 
 export abstract class BasePage implements IPage {
   protected _lastUrl: string | null = null;
+  /** Cached previous snapshot hashes for incremental diff marking */
+  private _prevSnapshotHashes: string | null = null;
 
   // ── Transport-specific methods (must be implemented by subclasses) ──
 
@@ -35,14 +37,34 @@ export abstract class BasePage implements IPage {
   abstract getCookies(opts?: { domain?: string; url?: string }): Promise<BrowserCookie[]>;
   abstract screenshot(options?: ScreenshotOptions): Promise<string>;
   abstract tabs(): Promise<unknown[]>;
-  abstract closeTab(index?: number): Promise<void>;
-  abstract newTab(): Promise<void>;
   abstract selectTab(index: number): Promise<void>;
 
   // ── Shared DOM helper implementations ──
 
   async click(ref: string): Promise<void> {
-    await this.evaluate(clickJs(ref));
+    const result = await this.evaluate(clickJs(ref)) as
+      | string
+      | { status: string; x?: number; y?: number; w?: number; h?: number; error?: string }
+      | null;
+
+    // Backwards compat: old format returned 'clicked' string
+    if (typeof result === 'string' || result == null) return;
+
+    // JS click succeeded
+    if (result.status === 'clicked') return;
+
+    // JS click failed — try CDP native click if coordinates available
+    if (result.x != null && result.y != null) {
+      const success = await this.tryNativeClick(result.x, result.y);
+      if (success) return;
+    }
+
+    throw new Error(`Click failed: ${result.error ?? 'JS click and CDP fallback both failed'}`);
+  }
+
+  /** Override in subclasses with CDP native click support */
+  protected async tryNativeClick(_x: number, _y: number): Promise<boolean> {
+    return false;
   }
 
   async typeText(ref: string, text: string): Promise<void> {
@@ -111,17 +133,30 @@ export abstract class BasePage implements IPage {
 
   async snapshot(opts: SnapshotOptions = {}): Promise<unknown> {
     const snapshotJs = generateSnapshotJs({
-      viewportExpand: opts.viewportExpand ?? 800,
+      viewportExpand: opts.viewportExpand ?? 2000,
       maxDepth: Math.max(1, Math.min(Number(opts.maxDepth) || 50, 200)),
       interactiveOnly: opts.interactive ?? false,
       maxTextLength: opts.maxTextLength ?? 120,
       includeScrollInfo: true,
       bboxDedup: true,
+      previousHashes: this._prevSnapshotHashes,
     });
 
     try {
-      return await this.evaluate(snapshotJs);
-    } catch {
+      const result = await this.evaluate(snapshotJs);
+      // Read back the hashes stored by the snapshot for next diff
+      try {
+        const hashes = await this.evaluate('window.__opencli_prev_hashes') as string | null;
+        this._prevSnapshotHashes = typeof hashes === 'string' ? hashes : null;
+      } catch {
+        // Non-fatal: diff is best-effort
+      }
+      return result;
+    } catch (err) {
+      // Log snapshot failure for debugging, then fallback to basic accessibility tree
+      if (process.env.DEBUG_SNAPSHOT) {
+        console.error('[snapshot] DOM snapshot failed, falling back to accessibility tree:', (err as Error)?.message?.slice(0, 200));
+      }
       return this._basicSnapshot(opts);
     }
   }

package/src/browser/bridge.ts

@@ -9,7 +9,7 @@ import * as fs from 'node:fs';
 import type { IPage } from '../types.js';
 import type { IBrowserFactory } from '../runtime.js';
 import { Page } from './page.js';
-import { isDaemonRunning, isExtensionConnected } from './daemon-client.js';
+import { fetchDaemonStatus, isExtensionConnected } from './daemon-client.js';
 import { DEFAULT_DAEMON_PORT } from '../constants.js';
 
 const DAEMON_SPAWN_TIMEOUT = 10000; // 10s to wait for daemon + extension
@@ -60,14 +60,17 @@ export class BrowserBridge implements IBrowserFactory {
     const effectiveSeconds = (timeoutSeconds && timeoutSeconds > 0) ? timeoutSeconds : Math.ceil(DAEMON_SPAWN_TIMEOUT / 1000);
     const timeoutMs = effectiveSeconds * 1000;
 
+    // Single status check instead of two separate fetchDaemonStatus() calls
+    const status = await fetchDaemonStatus();
+
     // Fast path: extension already connected
-    if (await isExtensionConnected()) return;
+    if (status?.extensionConnected) return;
 
     // Daemon running but no extension — wait for extension with progress
-    if (await isDaemonRunning()) {
+    if (status !== null) {
       if (process.env.OPENCLI_VERBOSE || process.stderr.isTTY) {
-        process.stderr.write('⏳ Waiting for Chrome extension to connect...\n');
-        process.stderr.write('   Make sure Chrome is open and the OpenCLI extension is enabled.\n');
+        process.stderr.write('⏳ Waiting for Chrome/Chromium extension to connect...\n');
+        process.stderr.write('   Make sure Chrome or Chromium is open and the OpenCLI extension is enabled.\n');
       }
       const deadline = Date.now() + timeoutMs;
       while (Date.now() < deadline) {
@@ -76,7 +79,7 @@ export class BrowserBridge implements IBrowserFactory {
       }
       throw new Error(
         'Daemon is running but the Browser Extension is not connected.\n' +
-        'Please install and enable the opencli Browser Bridge extension in Chrome.',
+        'Please install and enable the opencli Browser Bridge extension in Chrome or Chromium.',
       );
     }
 
@@ -110,10 +113,10 @@ export class BrowserBridge implements IBrowserFactory {
       if (await isExtensionConnected()) return;
     }
 
-    if (await isDaemonRunning()) {
+    if ((await fetchDaemonStatus()) !== null) {
       throw new Error(
         'Daemon is running but the Browser Extension is not connected.\n' +
-        'Please install and enable the opencli Browser Bridge extension in Chrome.',
+        'Please install and enable the opencli Browser Bridge extension in Chrome or Chromium.',
       );
     }
 

package/src/browser/cdp.ts

@@ -223,14 +223,6 @@ class CDPPage extends BasePage {
     return [];
   }
 
-  async closeTab(_index?: number): Promise<void> {
-    // Not supported in direct CDP mode
-  }
-
-  async newTab(): Promise<void> {
-    await this.bridge.send('Target.createTarget', { url: 'about:blank' });
-  }
-
   async selectTab(_index: number): Promise<void> {
     // Not supported in direct CDP mode
   }
@@ -274,6 +266,7 @@ function scoreCDPTarget(target: CDPTarget, preferredPattern?: RegExp): number {
 
   if (!haystack.trim() && !type) return Number.NEGATIVE_INFINITY;
   if (haystack.includes('devtools')) return Number.NEGATIVE_INFINITY;
+  if (type === 'background_page' || type === 'service_worker') return Number.NEGATIVE_INFINITY;
 
   let score = 0;
 

package/src/browser/daemon-client.ts

@@ -21,7 +21,7 @@ function generateId(): string {
 
 export interface DaemonCommand {
   id: string;
-  action: 'exec' | 'navigate' | 'tabs' | 'cookies' | 'screenshot' | 'close-window' | 'sessions' | 'set-file-input' | 'cdp';
+  action: 'exec' | 'navigate' | 'tabs' | 'cookies' | 'screenshot' | 'close-window' | 'sessions' | 'set-file-input' | 'insert-text' | 'bind-current' | 'network-capture-start' | 'network-capture-read' | 'cdp';
   tabId?: number;
   code?: string;
   workspace?: string;
@@ -29,6 +29,8 @@ export interface DaemonCommand {
   op?: string;
   index?: number;
   domain?: string;
+  matchDomain?: string;
+  matchPathPrefix?: string;
   format?: 'png' | 'jpeg';
   quality?: number;
   fullPage?: boolean;
@@ -37,6 +39,10 @@ export interface DaemonCommand {
   files?: string[];
   /** CSS selector for file input element (set-file-input action) */
   selector?: string;
+  /** Raw text payload for insert-text action */
+  text?: string;
+  /** URL substring filter pattern for network capture */
+  pattern?: string;
   cdpMethod?: string;
   cdpParams?: Record<string, unknown>;
 }
@@ -163,3 +169,7 @@ export async function listSessions(): Promise<BrowserSessionInfo[]> {
   const result = await sendCommand('sessions');
   return Array.isArray(result) ? result : [];
 }
+
+export async function bindCurrentTab(workspace: string, opts: { matchDomain?: string; matchPathPrefix?: string } = {}): Promise<unknown> {
+  return sendCommand('bind-current', { workspace, ...opts });
+}

package/src/browser/dom-helpers.ts

@@ -5,64 +5,76 @@
  * to eliminate code duplication for click, type, press, wait, scroll, etc.
  */
 
-/** Generate JS to click an element by ref */
-export function clickJs(ref: string): string {
-  const safeRef = JSON.stringify(ref);
+/** Shared element lookup JS fragment (4-strategy resolution) */
+function resolveElementJs(safeRef: string, selectorSet: string): string {
   return `
-    (() => {
       const ref = ${safeRef};
-      // 1. data-opencli-ref (set by snapshot engine)
       let el = document.querySelector('[data-opencli-ref="' + ref + '"]');
-      // 2. data-ref (legacy)
       if (!el) el = document.querySelector('[data-ref="' + ref + '"]');
-      // 3. CSS selector
       if (!el && ref.match(/^[a-zA-Z#.\\[]/)) {
         try { el = document.querySelector(ref); } catch {}
       }
-      // 4. Numeric index into interactive elements
       if (!el) {
         const idx = parseInt(ref, 10);
         if (!isNaN(idx)) {
-          el = document.querySelectorAll('a, button, input, select, textarea, [role="button"], [tabindex]:not([tabindex="-1"])')[idx];
+          el = document.querySelectorAll('${selectorSet}')[idx];
         }
-      }
+      }`;
+}
+
+/** Generate JS to click an element by ref.
+ *  Returns { status, x, y, w, h } for CDP fallback when JS click fails. */
+export function clickJs(ref: string): string {
+  const safeRef = JSON.stringify(ref);
+  return `
+    (() => {
+      ${resolveElementJs(safeRef, 'a, button, input, select, textarea, [role="button"], [tabindex]:not([tabindex="-1"])')}
       if (!el) throw new Error('Element not found: ' + ref);
       el.scrollIntoView({ behavior: 'instant', block: 'center' });
-      el.click();
-      return 'clicked';
+      const rect = el.getBoundingClientRect();
+      const x = Math.round(rect.left + rect.width / 2);
+      const y = Math.round(rect.top + rect.height / 2);
+      try {
+        el.click();
+        return { status: 'clicked', x, y, w: Math.round(rect.width), h: Math.round(rect.height) };
+      } catch (e) {
+        return { status: 'js_failed', x, y, w: Math.round(rect.width), h: Math.round(rect.height), error: e.message };
+      }
     })()
   `;
 }
 
-/** Generate JS to type text into an element by ref */
+/** Generate JS to type text into an element by ref.
+ *  Uses native setter for React compat + execCommand for contenteditable. */
 export function typeTextJs(ref: string, text: string): string {
   const safeRef = JSON.stringify(ref);
   const safeText = JSON.stringify(text);
   return `
     (() => {
-      const ref = ${safeRef};
-      // 1. data-opencli-ref (set by snapshot engine)
-      let el = document.querySelector('[data-opencli-ref="' + ref + '"]');
-      // 2. data-ref (legacy)
-      if (!el) el = document.querySelector('[data-ref="' + ref + '"]');
-      // 3. CSS selector
-      if (!el && ref.match(/^[a-zA-Z#.\\[]/)) {
-        try { el = document.querySelector(ref); } catch {}
-      }
-      // 4. Numeric index into typeable elements
-      if (!el) {
-        const idx = parseInt(ref, 10);
-        if (!isNaN(idx)) {
-          el = document.querySelectorAll('input, textarea, [contenteditable="true"]')[idx];
-        }
-      }
+      ${resolveElementJs(safeRef, 'input, textarea, [contenteditable="true"]')}
       if (!el) throw new Error('Element not found: ' + ref);
       el.focus();
       if (el.isContentEditable) {
-        el.textContent = ${safeText};
+        // Select all content + delete, then insert (supports undo, works with rich text editors)
+        const sel = window.getSelection();
+        const range = document.createRange();
+        range.selectNodeContents(el);
+        sel.removeAllRanges();
+        sel.addRange(range);
+        document.execCommand('delete', false);
+        document.execCommand('insertText', false, ${safeText});
         el.dispatchEvent(new Event('input', { bubbles: true }));
       } else {
-        el.value = ${safeText};
+        // Use native setter for React/framework compatibility (match element type)
+        const proto = el instanceof HTMLTextAreaElement
+          ? HTMLTextAreaElement.prototype
+          : HTMLInputElement.prototype;
+        const nativeSetter = Object.getOwnPropertyDescriptor(proto, 'value')?.set;
+        if (nativeSetter) {
+          nativeSetter.call(el, ${safeText});
+        } else {
+          el.value = ${safeText};
+        }
         el.dispatchEvent(new Event('input', { bubbles: true }));
         el.dispatchEvent(new Event('change', { bubbles: true }));
       }

package/src/browser/dom-snapshot.ts

@@ -377,6 +377,8 @@ export function generateSnapshotJs(opts: DomSnapshotOptions = {}): string {
     if (role && INTERACTIVE_ROLES.has(role)) return true;
     if (el.hasAttribute('onclick') || el.hasAttribute('onmousedown') || el.hasAttribute('ontouchstart')) return true;
     if (el.hasAttribute('tabindex') && el.getAttribute('tabindex') !== '-1') return true;
+    // Framework event listener detection (React/Vue/Angular onClick)
+    if (hasFrameworkListener(el)) return true;
     try { if (window.getComputedStyle(el).cursor === 'pointer') return true; } catch {}
     if (el.isContentEditable && el.getAttribute('contenteditable') !== 'false') return true;
     // Search element heuristic detection
@@ -384,9 +386,29 @@ export function generateSnapshotJs(opts: DomSnapshotOptions = {}): string {
     return false;
   }
 
+  function hasFrameworkListener(el) {
+    try {
+      // React: __reactProps$xxx / __reactEvents$xxx with onClick/onMouseDown
+      for (const key of Object.keys(el)) {
+        if (key.startsWith('__reactProps$') || key.startsWith('__reactEvents$')) {
+          const props = el[key];
+          if (props && (props.onClick || props.onMouseDown || props.onPointerDown)) return true;
+        }
+      }
+      // Vue 3: _vei (Vue Event Invoker) with onClick
+      if (el._vei && (el._vei.onClick || el._vei.click || el._vei.onMousedown)) return true;
+      // Vue 2: __vue__ instance with $listeners
+      if (el.__vue__?.$listeners?.click) return true;
+      // Angular: ng-reflect-click binding
+      if (el.hasAttribute('ng-reflect-click')) return true;
+    } catch { /* ignore errors from cross-origin or frozen objects */ }
+    return false;
+  }
+
   function isSearchElement(el) {
     // Check class names for search indicators
-    const className = el.className?.toLowerCase() || '';
+    // Note: SVG elements have className as SVGAnimatedString (not a string), use baseVal
+    const className = (typeof el.className === 'string' ? el.className : el.className?.baseVal || '').toLowerCase();
     const classes = className.split(/\\s+/).filter(Boolean);
     for (const cls of classes) {
       const cleaned = cls.replace(/[^a-z0-9-]/g, '');