mooncat-browser 0.1.0

package/browser-op/webplater/public/capture.js

@@ -0,0 +1,310 @@
+/**
+ * 捕获脚本本体（webplater 自带，等价 bee 的 capture-inject.ts captureInjectJS）。
+ *
+ * 行为：鼠标悬浮蓝色高亮 + Ctrl+C 复制 BeeCapture 到剪贴板。
+ * 由 background 用 chrome.scripting.registerContentScripts(world:'MAIN',
+ * runAt:'document_start') 注册，等价 CDP Page.addScriptToEvaluateOnNewDocument
+ * ——每个文档加载（导航/刷新/新 tab）都自动执行，document_start 即注入，持久存在。
+ *
+ * installed/enabled 标志位做幂等与开关控制。enabled 由 background 控制
+ * （开启捕获时 background 再注入一次把 enabled 置 true）。
+ *
+ * ⚠️ 此脚本是 bee/packages/.../capture-inject.ts 的 captureInjectJS 的独立副本。
+ *    webplater 与 bee 非 monorepo，逻辑需手动保持一致（两处改动要同步）。
+ */
+(function () {
+  if (window.__bee_capture_installed) return;
+
+  // enabled 状态存 chrome.storage.local（background enable/disable 写入）。
+  // 脚本跑在 ISOLATED world，可直接读 storage + 监听变化，所有 tab（含新 tab）状态一致。
+  var enabled = false;
+  try { chrome.storage.local.get(['bee_capture_enabled'], function (r) {
+    enabled = !!r && r.bee_capture_enabled;
+  }); } catch (e) {}
+  try { chrome.storage.onChanged.addListener(function (changes, area) {
+    if (area === 'local' && changes.bee_capture_enabled) {
+      enabled = !!changes.bee_capture_enabled.newValue;
+    }
+  }); } catch (e) {}
+
+  var BEE_MIME = 'web application/vnd.bee.capture+json';
+
+  function escapeHtml(s) {
+    return String(s)
+      .replace(/&/g, '&')
+      .replace(/"/g, '"')
+      .replace(/</g, '&lt;')
+      .replace(/>/g, '&gt;');
+  }
+
+  function buildLabel(el) {
+    var text = (el.textContent || '').trim().replace(/\s+/g, ' ').slice(0, 40);
+    if (text) return text;
+    var tag = el.tagName ? el.tagName.toLowerCase() : 'element';
+    var parts = [tag];
+    if (el.id) parts.push('#' + el.id);
+    if (el.className && typeof el.className === 'string') {
+      var classes = el.className.split(/\s+/).filter(Boolean);
+      if (classes.length) parts.push('.' + classes.join('.'));
+    }
+    return 'DOM: ' + parts.join('');
+  }
+
+  function buildStableSelector(el) {
+    var path = [];
+    var node = el;
+    var MAX_DEPTH = 15;
+    var depth = 0;
+    while (node && node.nodeType === 1 && node.tagName && depth < MAX_DEPTH) {
+      var tag = node.tagName.toLowerCase();
+      if (tag === 'html') break;
+      if (tag === 'body') { path.unshift('body'); break; }
+      var parent = node.parentElement;
+      if (!parent) { path.unshift(tag); break; }
+      var index = 1;
+      var sibling = parent.firstElementChild;
+      while (sibling && sibling !== node) {
+        sibling = sibling.nextElementSibling;
+        index++;
+      }
+      if (parent.id && /^[A-Za-z][\w-]*$/.test(parent.id)) {
+        path.unshift(tag + ':nth-child(' + index + ')');
+        path.unshift('#' + parent.id);
+        break;
+      }
+      path.unshift(tag + ':nth-child(' + index + ')');
+      node = parent;
+      depth++;
+    }
+    return path.join(' > ');
+  }
+
+  function inferImplicitRole(el, tagLower) {
+    if (tagLower === 'a' && el.getAttribute('href')) return 'link';
+    if (tagLower === 'a') return 'generic';
+    var directMap = {
+      button: 'button', nav: 'navigation', main: 'main', header: 'banner',
+      footer: 'contentinfo', aside: 'complementary', form: 'form', search: 'search',
+      ul: 'list', ol: 'list', li: 'listitem', table: 'table', tr: 'row', td: 'cell',
+      th: 'columnheader', img: 'image', figure: 'figure', dialog: 'dialog',
+    };
+    if (directMap[tagLower]) return directMap[tagLower];
+    if (/^h[1-6]$/.test(tagLower)) return 'heading';
+    if (tagLower === 'input') {
+      var inputType = (el.getAttribute('type') || 'text').toLowerCase();
+      if (inputType === 'button' || inputType === 'submit' || inputType === 'reset') return 'button';
+      if (inputType === 'checkbox') return 'checkbox';
+      if (inputType === 'radio') return 'radio';
+      if (inputType === 'range') return 'slider';
+      if (inputType === 'search') return 'searchbox';
+      return 'textbox';
+    }
+    if (tagLower === 'textarea') return 'textbox';
+    if (tagLower === 'select') return 'listbox';
+    return '';
+  }
+
+  function buildA11yInfo(el) {
+    var role = el.getAttribute('role') || '';
+    var ariaLabel = el.getAttribute('aria-label') || '';
+    var ariaLabelledBy = el.getAttribute('aria-labelledby') || '';
+    var ariaDescribedBy = el.getAttribute('aria-describedby') || '';
+    var headingLevel = 0;
+    var tagLower = (el.tagName || '').toLowerCase();
+    var hMatch = tagLower.match(/^h(\d)$/);
+    if (hMatch) headingLevel = parseInt(hMatch[1], 10);
+    if (!headingLevel && role === 'heading') {
+      var ariaLevel = el.getAttribute('aria-level');
+      if (ariaLevel) headingLevel = parseInt(ariaLevel, 10);
+    }
+    if (!role) role = inferImplicitRole(el, tagLower);
+    var name = ariaLabel || ((el.textContent || '').trim().replace(/\s+/g, ' ').slice(0, 40));
+    return {
+      role: role, name: name, ariaLabel: ariaLabel,
+      ariaLabelledBy: ariaLabelledBy, ariaDescribedBy: ariaDescribedBy,
+      headingLevel: headingLevel || undefined,
+    };
+  }
+
+  function buildParentContext(el) {
+    var contexts = [];
+    var node = el.parentElement;
+    var depth = 0;
+    var semClassRe = /(?:^|[\s_-])(nav|menu|header|footer|sidebar|content|main|body|article|post|list|item|card|product|detail|search|login|user|cart|banner|hero|modal|dialog|popup|tab|panel|section|category|breadcrumb|pagination|comment|reply|form|register|checkout|profile|setting)(?:[\s_-]|$)/i;
+    while (node && depth < 8) {
+      var role = node.getAttribute && node.getAttribute('role');
+      var nodeTag = (node.tagName || '').toLowerCase();
+      var nodeClass = (typeof node.className === 'string' ? node.className : '');
+      var nodeText = (node.textContent || '').trim().replace(/\s+/g, ' ').slice(0, 30);
+      var hasSemanticClass = semClassRe.test(nodeClass);
+      var isSemantic = role || /^h[1-6]$/.test(nodeTag) ||
+        ['nav', 'main', 'header', 'footer', 'section', 'article', 'aside', 'form', 'dialog', 'ul', 'ol', 'table'].indexOf(nodeTag) >= 0 ||
+        node.id || hasSemanticClass;
+      if (isSemantic) {
+        contexts.push({
+          tag: nodeTag, role: role || inferImplicitRole(node, nodeTag),
+          id: node.id || '', className: nodeClass, text: nodeText,
+        });
+        if (contexts.length >= 3) break;
+      }
+      node = node.parentElement;
+      depth++;
+    }
+    return contexts;
+  }
+
+  function buildCapture(el) {
+    var tag = el.tagName ? el.tagName.toLowerCase() : '';
+    var attrs = {};
+    if (el.attributes) {
+      for (var i = 0; i < el.attributes.length; i++) {
+        var a = el.attributes[i];
+        attrs[a.name] = a.value;
+      }
+    }
+    var selector = el.id ? '#' + el.id : tag;
+    if (!el.id && el.className && typeof el.className === 'string') {
+      var classes = el.className.split(/\s+/).filter(Boolean);
+      if (classes.length) selector += '.' + classes.join('.');
+    }
+    var text = (el.textContent || '').trim().slice(0, 200);
+    return {
+      v: 1, source: 'browser', kind: 'dom-element',
+      label: buildLabel(el),
+      preview: text ? text.slice(0, 80) : undefined,
+      data: {
+        tag: tag, id: el.id || '',
+        className: typeof el.className === 'string' ? el.className : '',
+        text: text, selector: selector,
+        stableSelector: buildStableSelector(el),
+        attributes: attrs, a11y: buildA11yInfo(el),
+        parentContext: buildParentContext(el),
+        url: location.href, title: document.title,
+      },
+    };
+  }
+
+  function encodeCaptureHtml(capture, refId) {
+    var dataStr = encodeURIComponent(JSON.stringify(capture.data));
+    var previewAttr = capture.preview
+      ? ' data-bee-preview="' + escapeHtml(capture.preview) + '"'
+      : '';
+    return '<a data-bee-capture="' + escapeHtml(refId) + '"' +
+      ' data-bee-source="' + escapeHtml(capture.source) + '"' +
+      ' data-bee-kind="' + escapeHtml(capture.kind) + '"' +
+      ' data-bee-label="' + escapeHtml(capture.label) + '"' +
+      ' data-bee-data="' + escapeHtml(dataStr) + '"' +
+      previewAttr + '>' + escapeHtml(capture.label) + '</a>';
+  }
+
+  function execCommandCopy(html) {
+    try {
+      var container = document.createElement('div');
+      container.setAttribute('contenteditable', 'true');
+      container.style.cssText = 'position:fixed;left:-9999px;top:0;opacity:0;';
+      container.innerHTML = html;
+      document.body.appendChild(container);
+      var range = document.createRange();
+      range.selectNodeContents(container);
+      var sel = window.getSelection();
+      sel.removeAllRanges();
+      sel.addRange(range);
+      var ok = document.execCommand('copy');
+      sel.removeAllRanges();
+      document.body.removeChild(container);
+      return ok;
+    } catch (e) {
+      return false;
+    }
+  }
+
+  function writeCaptureToClipboard(capture) {
+    var refId = 'browser_' + Date.now() + '_' + Math.random().toString(36).slice(2, 8);
+    var html = encodeCaptureHtml(capture, refId);
+    var plainText = JSON.stringify(capture, null, 2);
+    var jsonStr = JSON.stringify(capture);
+    if (navigator.clipboard && navigator.clipboard.write && window.ClipboardItem) {
+      try {
+        var items = {
+          'text/html': new Blob([html], { type: 'text/html' }),
+          'text/plain': new Blob([plainText], { type: 'text/plain' }),
+        };
+        try { items[BEE_MIME] = new Blob([jsonStr], { type: BEE_MIME }); } catch (e) { }
+        return navigator.clipboard.write([new ClipboardItem(items)]).then(function () {
+          return 'clipboard.write';
+        }, function () { return execCommandCopy(html); }).catch(function () {
+          return execCommandCopy(html);
+        });
+      } catch (e) { }
+    }
+    var result = execCommandCopy(html);
+    if (result) return Promise.resolve('execCommand');
+    if (navigator.clipboard && navigator.clipboard.writeText) {
+      return navigator.clipboard.writeText(html);
+    }
+    return Promise.reject(new Error('Clipboard API not available'));
+  }
+
+  function install() {
+    if (window.__bee_capture_installed) return;
+
+    var highlight = document.createElement('div');
+    highlight.id = '__bee_highlight';
+    highlight.style.cssText = 'position:fixed;pointer-events:none;z-index:2147483647;border:2px solid #3b82f6;background:rgba(59,130,246,0.1);display:none;transition:all 0.08s ease;';
+    document.documentElement.appendChild(highlight);
+
+    var currentTarget = null;
+
+    document.addEventListener('mouseover', function (e) {
+      if (!enabled) return;
+      if (e.target === highlight) return;
+      currentTarget = e.target;
+      var r = e.target.getBoundingClientRect();
+      highlight.style.left = r.left + 'px';
+      highlight.style.top = r.top + 'px';
+      highlight.style.width = r.width + 'px';
+      highlight.style.height = r.height + 'px';
+      highlight.style.display = 'block';
+    }, true);
+
+    document.addEventListener('mouseout', function (e) {
+      if (e.target === currentTarget) {
+        highlight.style.display = 'none';
+        currentTarget = null;
+      }
+    }, true);
+
+    document.addEventListener('keydown', function (e) {
+      if (!enabled) return;
+      if ((e.ctrlKey || e.metaKey) && e.key === 'c') {
+        var el = currentTarget || document.activeElement;
+        if (!el || el === document.body || el === document.documentElement) return;
+        var capture = buildCapture(el);
+        if (!capture) return;
+        e.preventDefault();
+        e.stopPropagation();
+        writeCaptureToClipboard(capture).then(function (method) {
+          highlight.style.border = '2px solid #22c55e';
+          highlight.style.background = 'rgba(34,197,94,0.2)';
+          setTimeout(function () {
+            highlight.style.border = '2px solid #3b82f6';
+            highlight.style.background = 'rgba(59,130,246,0.1)';
+          }, 300);
+        }).catch(function () { });
+      }
+    }, true);
+
+    window.addEventListener('scroll', function () {
+      highlight.style.display = 'none';
+      currentTarget = null;
+    }, true);
+
+    window.__bee_capture_installed = true;
+  }
+
+  if (document.documentElement && document.body) {
+    install();
+    return;
+  }
+  document.addEventListener('DOMContentLoaded', install, { once: true });
+})();

package/browser-op/webplater/scripts/publish-extension.mjs

@@ -0,0 +1,176 @@
+#!/usr/bin/env node
+// WebPlater 浏览器插件发布脚本。
+// 构建 → wxt zip → 上传到对象存储 → 写版本元信息。
+//
+// 产物形态：zip 包（manifest.json 在根目录），消费方是 flashbox host 的
+// browser feature（load unpacked）。不走 catalog，用"单向最新指针"
+// （webplater-latest.zip + webplater-manifest.json），与 flashbox host-update
+// 的 latest.yml 同构。
+//
+// Usage:
+//   node scripts/publish-extension.mjs                       # 发布当前 wxt build 版本
+//   node scripts/publish-extension.mjs --note "修复 popup"   # 附 changelog
+//   node scripts/publish-extension.mjs --keep-history         # 保留历史 zip 不删
+//
+// 上传到 bucket 的 key 布局：
+//   browser-extension/webplater-<version>.zip      带版本号的 zip（可追溯）
+//   browser-extension/webplater-latest.zip          固定名指针（总是最新，host 拉这个）
+//   browser-extension/webplater-manifest.json       版本元信息（version/sha256/size/url）
+import { spawnSync } from 'node:child_process'
+import { existsSync, readFileSync, readdirSync, statSync, rmSync } from 'node:fs'
+import { resolve, dirname, basename } from 'node:path'
+import { fileURLToPath, pathToFileURL } from 'node:url'
+import { createHash } from 'node:crypto'
+
+const __filename = fileURLToPath(import.meta.url)
+const __dirname = dirname(__filename)
+const ROOT = resolve(__dirname, '..')
+
+// ── 加载 .env.local ──
+const envPath = resolve(ROOT, '.env.local')
+if (existsSync(envPath)) {
+  for (const line of readFileSync(envPath, 'utf8').split('\n')) {
+    const m = line.match(/^([A-Z_]+)=(.*)$/)
+    if (m && process.env[m[1]] === undefined) process.env[m[1]] = m[2]
+  }
+}
+
+// ── 解析命令行参数 ──
+const notes = []
+let keepHistory = false
+for (let i = 2; i < process.argv.length; i++) {
+  const a = process.argv[i]
+  if (a === '--note' || a === '-n') {
+    notes.push(process.argv[++i])
+  } else if (a === '--keep-history') {
+    keepHistory = true
+  } else if (a === '--help' || a === '-h') {
+    console.log(`usage: node scripts/publish-extension.mjs [--note "..." ...] [--keep-history]
+
+  --note <text>      追加一条 changelog（可多次），写入 webplater-manifest.json
+  --keep-history     保留 bucket 上的历史 zip（默认删旧只留最新 + latest 指针）
+`)
+    process.exit(0)
+  }
+}
+
+function run(cmd, args) {
+  const r = spawnSync(cmd, args, { cwd: ROOT, stdio: 'inherit', shell: true })
+  if (r.status !== 0) {
+    console.error(`failed: ${cmd} ${args.join(' ')}`)
+    process.exit(r.status ?? 1)
+  }
+}
+
+// ── 1. wxt zip（含 build）→ dist/webplater-<version>-chrome.zip ──
+console.log('=== wxt build + zip ===')
+run('pnpm', ['run', 'zip'])
+
+// ── 2. 找产出的 zip + 读 manifest 拿版本号 ──
+const DIST_DIR = resolve(ROOT, 'dist')
+const zipFiles = readdirSync(DIST_DIR).filter((f) => f.startsWith('webplater-') && f.endsWith('-chrome.zip'))
+if (zipFiles.length === 0) {
+  console.error('wxt zip 没产出 zip 文件（期望 dist/webplater-<version>-chrome.zip）')
+  process.exit(1)
+}
+// 取最新的（按 mtime）
+let zipFile = zipFiles[0]
+let zipMtime = 0
+for (const f of zipFiles) {
+  const mtimeMs = statSync(resolve(DIST_DIR, f)).mtimeMs
+  if (mtimeMs > zipMtime) {
+    zipMtime = mtimeMs
+    zipFile = f
+  }
+}
+const ZIP_PATH = resolve(DIST_DIR, zipFile)
+
+const manifest = JSON.parse(readFileSync(resolve(DIST_DIR, 'chrome-mv3', 'manifest.json'), 'utf8'))
+const version = manifest.version
+if (!version) {
+  console.error('manifest.version 缺失（wxt.config 的 buildVersion 没生效？）')
+  process.exit(1)
+}
+// extensionId 由 manifest.key 稳定算出（见 wxt.config 注释），固定值，用于 host 端校验
+const EXTENSION_ID = 'npkapgkjeaaipldb'
+console.log(`version: ${version}`)
+console.log(`extensionId: ${EXTENSION_ID}`)
+console.log(`zip: ${zipFile}`)
+
+// ── 3. 加载 miniapp-tools（复用 flashbox 主仓库的工具函数）──
+// 候选路径：webplater 是独立仓库，flashbox 主仓库在同级目录 ../flashbox
+const toolsCandidates = [
+  resolve(ROOT, '../flashbox/packages/miniapp-tools/dist/index.js'),
+  resolve(ROOT, '../../flashbox/packages/miniapp-tools/dist/index.js'),
+]
+const toolsPath = toolsCandidates.find((p) => existsSync(p))
+if (!toolsPath) {
+  console.error('miniapp-tools 未找到。尝试过：')
+  toolsCandidates.forEach((p) => console.error('  ' + p))
+  console.error('请确保 flashbox 主仓库已 build miniapp-tools（pnpm --filter @flashbox/miniapp-tools build）')
+  process.exit(1)
+}
+const tools = await import(pathToFileURL(toolsPath).href)
+const cfg = tools.s3ConfigFromEnv()
+
+// ── 4. 计算 sha256 + size ──
+const zipBuf = readFileSync(ZIP_PATH)
+const sha256 = createHash('sha256').update(zipBuf).digest('hex')
+const size = zipBuf.length
+console.log(`sha256: ${sha256.slice(0, 16)}...`)
+console.log(`size: ${size} bytes`)
+
+// ── 5. 上传带版本号 zip ──
+console.log('=== upload versioned zip ===')
+const versionedKey = `browser-extension/webplater-${version}.zip`
+await tools.uploadFile(cfg, versionedKey, ZIP_PATH, 'application/zip')
+console.log('  ' + tools.publicUrl(cfg, versionedKey))
+
+// ── 6. 覆盖 latest 指针（固定名，host 总是拉这个）──
+console.log('=== upload latest pointer ===')
+const latestKey = 'browser-extension/webplater-latest.zip'
+await tools.uploadFile(cfg, latestKey, ZIP_PATH, 'application/zip')
+console.log('  ' + tools.publicUrl(cfg, latestKey))
+
+// ── 7. 写版本元信息 manifest.json（host 端先拉这个拿 sha256 校验）──
+console.log('=== upload version meta ===')
+const meta = {
+  extensionId: EXTENSION_ID,
+  version,
+  sha256,
+  size,
+  packageUrl: tools.publicUrl(cfg, versionedKey),
+  latestUrl: tools.publicUrl(cfg, latestKey),
+  publishedAt: new Date().toISOString(),
+  changelog: notes.length > 0 ? notes : undefined,
+}
+const metaKey = 'browser-extension/webplater-manifest.json'
+await tools.uploadText(cfg, metaKey, JSON.stringify(meta, null, 2) + '\n', 'application/json')
+console.log('  ' + tools.publicUrl(cfg, metaKey))
+
+// ── 8. 删旧版本 zip（默认只留 latest + 当前版本）──
+if (!keepHistory) {
+  const allKeys = await tools.listObjectKeys(cfg, 'browser-extension/')
+  const oldKeys = allKeys.filter(
+    (k) =>
+      k.startsWith('browser-extension/webplater-') &&
+      k.endsWith('.zip') &&
+      k !== versionedKey &&
+      k !== latestKey,
+  )
+  if (oldKeys.length > 0) {
+    console.log(`=== 清理旧版本 zip (${oldKeys.length}) ===`)
+    for (const k of oldKeys) console.log('  - ' + k)
+    await tools.deleteKeys(cfg, oldKeys)
+  } else {
+    console.log('=== 无旧版本 zip 需要清理 ===')
+  }
+}
+
+// ── 9. 清理本地 wxt zip 产物（发布完不再需要本地副本）──
+rmSync(ZIP_PATH, { force: true })
+
+console.log(`\n=== publish webplater@${version} OK ===`)
+console.log(`\nhost 端接入（webplater-constants.ts）：`)
+console.log(`  WEBPLATER_MANIFEST_URL = '${tools.publicUrl(cfg, metaKey)}'`)
+console.log(`  或固定下载地址: ${tools.publicUrl(cfg, latestKey)}`)

package/browser-op/webplater/tsconfig.json

@@ -0,0 +1,19 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "lib": ["ES2022", "DOM", "DOM.Iterable"],
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true,
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "noEmit": true,
+    "types": ["wxt/types"]
+  },
+  "include": ["entrypoints/**/*.ts", "entrypoints/**/*.tsx"]
+}

package/browser-op/webplater/wxt.config.ts

@@ -0,0 +1,34 @@
+import { defineConfig } from 'wxt'
+
+// 构建版本号：主.次.补丁.YYMMDDHHMM。每次 build 不同，重载后能从 chrome://extensions
+// 卡片的 version 肉眼确认是不是新构建（避免 0.0.1 一成不变无法区分）。
+function buildVersion() {
+  const d = new Date()
+  const p = (n) => String(n).padStart(2, '0')
+  const stamp = `${p(d.getFullYear() % 100)}${p(d.getMonth() + 1)}${p(d.getDate())}${p(d.getHours())}${p(d.getMinutes())}`
+  return `0.0.1.${stamp}`
+}
+const VERSION = buildVersion()
+
+// https://wxt.dev/api/config.html
+// 通用浏览器自动化扩展，不做任何域名限制。
+export default defineConfig({
+  extensionApi: 'chrome',
+  outDir: 'dist',
+  modules: [],
+  manifest: {
+    name: 'WebPlater',
+    description: 'Generic browser automation bridge — Playwright alternative layer',
+    version: VERSION,
+    // 固定 extensionId=npkapgkjeaaipldb。
+    // key 是 RSA 公钥 DER 的 base64，Chrome 据此稳定算出 id（不再随 load 路径变）。
+    // 供 bee 启动前检测插件是否装在本 profile（按固定 id 命中，比 name 匹配稳）。
+    // ⚠️ 私钥存仓库 keys/extension-key.pem（本仓库为 PRIVATE）。未来发 Chrome Web Store
+    //    或 CRX 签名分发时用私钥；load unpacked 只验公钥算 id，不验签名。
+    key:
+      'MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAlljeBdeINKB8ouCR6euqG5iegaoSZY3c/uubW1AJoJzoVNyiB8UPzpL98zfWXW5nMF+KTdGa1Vb19sBACMVxO8gXEbxS/gobfqJHddfe0qZpNDEBrM7lwVJtocPb9lYJK3rHASx2VSkRFRPoymaaNDaeEO/uiu9uCG2dut/V00UvUAaeMDM9bwiWxD8aJ5IINRFIk+UniZsPB0kY3tbcmqayGYsjYpwZmU9RXoLSBZjWa8CfFjTNeyPBtLpkj2groQN/Ytk1RWf5AEwAPIahfz/hn2kDOnL1OSNGyQfswL8GuWJZs9h2bvDQMKwCRUQ/iUuqypNQfbin42rpD1kz9QIDAQAB',
+    permissions: ['tabs', 'scripting', 'cookies', 'storage', 'offscreen', 'webNavigation', 'downloads'],
+    // 全域名，无任何限制。这是一个通用插件。
+    host_permissions: ['<all_urls>'],
+  },
+})

package/dist/actions.md

@@ -0,0 +1,102 @@
+# operate action 清单
+
+`BrowserClient.operate({ pageHandle, action, params })` 的全部 action 取值与参数。
+
+> 自动生成，来自 `browser-op/backend/browserd.cjs` 的 `@action` 标注。这是 browser 内核的公开契约，始终最新。
+
+## 约定
+
+- **pageHandle**：所有 action 都需要，由 `newTab()` / `listTabs()` 返回的 `tab.pageHandle` 提供。
+- **selector 语法**：CSS / `aria-ref=eN`（来自 snapshot 的 ref）/ `.cls>>nth(n)` / `.cls>>last`。
+- **ext 列**：action 在双路由（CDP / WebPlater 扩展）的可用性。
+  - ✓ = CDP 与扩展均支持
+  - ✗ = 仅 CDP（扩展路不支持，如 `waitForFunction`，因扩展路 CSP 拦截 eval）
+  - 仅 ext = 仅扩展路（如 `setDialogHandler`、`listDownloads`，依赖扩展 API）
+
+### 交互
+
+| action | params | returns | description | ext |
+| --- | --- | --- | --- | --- |
+| `clickAt` | `x`:number, `y`:number, `button`?:string=left, `clickCount`?:number=1 | {ok,x,y,route} | 坐标点击(绕过selector,CDP路真实鼠标/扩展路合成事件) | ✓ |
+| `clickByText` | `text`:string, `exact`?:boolean=false, `index`?:number=0, `offsetX`?:number=0, `offsetY`?:number=0 | {ok,text,x,y,match,route} | 定位可见文本后立即点击(原子,防DOM重渲染) | ✓ |
+| `click` | `selector`:string, `x`?:number, `y`?:number | {ok,selector} | 点击元素(或坐标x,y) | ✓ |
+| `fill` | `selector`:string, `value`:string | {ok,selector,value} | 在selector元素填入文本(先清空) | ✓ |
+| `type` | `selector`:string, `value`:string, `delay`?:number=0 | {ok,selector} | 逐字输入(带延迟,模拟键盘) | ✓ |
+| `press` | `selector`:string, `key`:string | {ok,selector,key} | 在元素上按键 | ✓ |
+| `hover` | `selector`:string, `x`?:number, `y`?:number | {ok,selector} | 悬停元素(或坐标) | ✓ |
+| `focus` | `selector`:string | {ok,selector} | 聚焦元素 | ✓ |
+| `check` | `selector`:string | {ok,selector} | 勾选checkbox/radio | ✓ |
+| `uncheck` | `selector`:string | {ok,selector} | 取消勾选 | ✓ |
+| `selectOption` | `selector`:string, `value`:string | {ok,selector,value} | 选择option | ✓ |
+| `dblclick` | `selector`:string | {ok,selector} | 双击元素 | ✓ |
+| `mouseMove` | `x`:number, `y`:number | {ok,x,y} | 移动鼠标到坐标 | ✓ |
+| `clickAt` | `x`:number, `y`:number, `button`?:string=left, `clickCount`?:number=1 | {ok,x,y,route} | 坐标点击(CDP路page.mouse真实鼠标) | ✓ |
+| `clickByText` | `text`:string, `exact`?:boolean=false, `index`?:number=0, `offsetX`?:number=0, `offsetY`?:number=0 | {ok,text,x,y,match,route} | 定位可见文本后立即点击(CDP路原子) | ✓ |
+| `dragTo` | `source`:string, `target`:string | {ok,source,target} | 拖拽source到target(双兼容mouse+HTML5) | ✓ |
+
+### 读取
+
+| action | params | returns | description | ext |
+| --- | --- | --- | --- | --- |
+| `locateVisibleText` | `text`:string, `exact`?:boolean=false, `index`?:number=0 | {ok,matches:[{text,x,y,width,height,centerX,centerY,visible}]} | 定位可见文本节点返回bbox(不返回DOM handle) | ✓ |
+| `locateVisibleText` | `text`:string, `exact`?:boolean=false, `index`?:number=0 | {ok,matches:[{text,x,y,width,height,centerX,centerY,visible}]} | 定位可见文本节点返回bbox | ✓ |
+| `innerHTML` | `selector`:string | {ok,selector,value} | 读元素innerHTML | ✓ |
+| `innerText` | `selector`:string | {ok,selector,value} | 读元素innerText | ✓ |
+| `textContent` | `selector`:string | {ok,selector,value} | 读元素textContent | ✓ |
+| `getAttribute` | `selector`:string, `name`:string | {ok,selector,name,value} | 读元素属性 | ✓ |
+| `inputValue` | `selector`:string, `timeout`?:number=10000 | {ok,selector,value} | 读input/select当前值 | ✓ |
+| `boundingBox` | `selector`:string | {ok,selector,x,y,width,height} | 读元素包围盒(坐标+尺寸) | ✓ |
+| `count` | `selector`:string | {ok,selector,count} | 统计selector匹配数 | ✓ |
+| `snapshot` | `depth`?:number, `timeout`?:number=15000 | {ok,yaml,totalChars} | aria无障碍快照(返回yaml) | ✓ |
+
+### 进阶
+
+| action | params | returns | description | ext |
+| --- | --- | --- | --- | --- |
+| `operateSequence` | `steps`:array | {ok,results} | 原子序列执行(locate/click/wait在同一页面上下文串行) | ✓ |
+| `setDialogHandler` | `handler`:string | {ok} | 设置JS对话框处理 | 仅 ext |
+| `operateSequence` | `steps`:array | {ok,results} | 原子序列执行 | ✓ |
+| `evaluate` | `source`:string, `args`?:any | 由函数返回值决定 | 执行页面JS函数(返回其结果) | ✓ |
+| `setInputFiles` | `selector`:string, `files`:array, `timeout`?:number=10000 | {ok,selector,count} | 上传文件到file input | ✓ |
+
+### 导航
+
+| action | params | returns | description | ext |
+| --- | --- | --- | --- | --- |
+| `goto` | `url`:string | {ok,url} | 导航到URL,等待DOMContentLoaded | ✓ |
+| `goBack` | `timeout`?:number=15000 | {ok,url} | 后退一页 | ✓ |
+| `goForward` | `timeout`?:number=15000 | {ok,url} | 前进一页 | ✓ |
+| `reload` | `timeout`?:number=15000 | {ok,url} | 刷新当前页 | ✓ |
+| `status` | — | {ok,url,title,readyState,textLength} | 读当前页状态(url/title/readyState) | ✓ |
+
+### 等待
+
+| action | params | returns | description | ext |
+| --- | --- | --- | --- | --- |
+| `waitForLoadState` | `state`?:string=load, `timeout`?:number=30000 | {ok} | 等待指定加载状态 | ✓ |
+| `waitForSelector` | `selector`:string, `timeout`?:number=30000 | {ok,selector,visible,inViewport} | 等待selector元素可见 | ✓ |
+| `waitForFunction` | `source`:string, `timeout`?:number=30000 | 由函数返回值决定 | 等待页面函数返回truthy | ✗ (extension路CSP拦截eval) |
+| `waitForURL` | `url`:string, `timeout`?:number=30000 | {ok,url} | 等待URL匹配 | ✓ |
+| `waitForTimeout` | `ms`?:number=1000 | {ok,ms} | 固定等待 | ✓ |
+
+### 标签页
+
+| action | params | returns | description | ext |
+| --- | --- | --- | --- | --- |
+| `closeTab` | — | {ok} | 关闭当前page | ✓ |
+| `activate` | — | {ok} | 切到最前(仅可视) | ✓ |
+
+### 截图
+
+| action | params | returns | description | ext |
+| --- | --- | --- | --- | --- |
+| `screenshot` | — | {ok,format,dataUrl} | 截整页PNG(返回dataUrl) | ✓ |
+
+### 存储
+
+| action | params | returns | description | ext |
+| --- | --- | --- | --- | --- |
+| `getLocalStorage` | `keys`?:array | {ok,storage} | 读localStorage(不传keys读全部) | ✓ |
+| `setLocalStorage` | `items`:object | {ok,count} | 写localStorage | ✓ |
+| `removeLocalStorage` | `keys`?:array | {ok,count} | 删localStorage(不传keys删全部) | ✓ |
+| `clearLocalStorage` | — | {ok} | 清空localStorage | ✓ |

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}