npm - mooncat-browser - Versions diffs - 0.1.0 - Mend

mooncat-browser 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (117) hide show

package/README.md +213 -0
package/browser-op/backend/browserd.cjs +1004 -0
package/browser-op/backend/rpc-client.cjs +64 -0
package/browser-op/backend/state.cjs +51 -0
package/browser-op/cdp/capture-inject.js +426 -0
package/browser-op/cdp/capture-inject.ts +426 -0
package/browser-op/cdp/capture-service.cjs +172 -0
package/browser-op/cdp/chrome-launcher.cjs +370 -0
package/browser-op/cdp/chrome-path.cjs +57 -0
package/browser-op/cdp/state.cjs +89 -0
package/browser-op/extension/extension-detect.cjs +228 -0
package/browser-op/extension/server.cjs +197 -0
package/browser-op/extension/service.cjs +228 -0
package/browser-op/extension/state.cjs +78 -0
package/browser-op/index.cjs +389 -0
package/browser-op/package.json +17 -0
package/browser-op/py/behavior.py +138 -0
package/browser-op/py/browser.py +340 -0
package/browser-op/py/captcha.py +115 -0
package/browser-op/py/crawler.py +125 -0
package/browser-op/py/examples/01_open_and_probe.py +48 -0
package/browser-op/py/examples/02_reuse_and_probe.py +66 -0
package/browser-op/py/examples/03_interact.py +66 -0
package/browser-op/py/find.py +150 -0
package/browser-op/py/honeypot.py +73 -0
package/browser-op/py/humanize.py +392 -0
package/browser-op/py/image.py +186 -0
package/browser-op/py/interact.py +193 -0
package/browser-op/py/markdown.py +38 -0
package/browser-op/py/pyproject.toml +32 -0
package/browser-op/py/ready.py +208 -0
package/browser-op/py/scroll.py +180 -0
package/browser-op/py/upload.py +103 -0
package/browser-op/py/visual_target.py +47 -0
package/browser-op/py/visualize.py +91 -0
package/browser-op/state.cjs +63 -0
package/browser-op/web/behavior.js +153 -0
package/browser-op/web/browser.js +231 -0
package/browser-op/web/captcha.js +85 -0
package/browser-op/web/crawler.js +109 -0
package/browser-op/web/find.js +147 -0
package/browser-op/web/honeypot.js +68 -0
package/browser-op/web/humanize.js +522 -0
package/browser-op/web/image.js +177 -0
package/browser-op/web/interact.js +169 -0
package/browser-op/web/markdown.js +80 -0
package/browser-op/web/ready.js +295 -0
package/browser-op/web/scroll.js +167 -0
package/browser-op/web/upload.js +116 -0
package/browser-op/web/visual-runtime.inject.cjs +6 -0
package/browser-op/webplater/.env.example +7 -0
package/browser-op/webplater/ARCHITECTURE.md +102 -0
package/browser-op/webplater/dist/chrome-mv3/assets/popup-BUZEUmsx.css +1 -0
package/browser-op/webplater/dist/chrome-mv3/background.js +2 -0
package/browser-op/webplater/dist/chrome-mv3/capture.js +310 -0
package/browser-op/webplater/dist/chrome-mv3/chunks/_virtual_wxt-html-plugins-DPbbfBKe.js +1 -0
package/browser-op/webplater/dist/chrome-mv3/chunks/offscreen-CFXYw9Mo.js +1 -0
package/browser-op/webplater/dist/chrome-mv3/chunks/popup-C-lpxZZO.js +1 -0
package/browser-op/webplater/dist/chrome-mv3/content-scripts/content.js +7 -0
package/browser-op/webplater/dist/chrome-mv3/manifest.json +1 -0
package/browser-op/webplater/dist/chrome-mv3/offscreen.html +16 -0
package/browser-op/webplater/dist/chrome-mv3/popup.html +31 -0
package/browser-op/webplater/entrypoints/background.ts +938 -0
package/browser-op/webplater/entrypoints/content.ts +1150 -0
package/browser-op/webplater/entrypoints/offscreen/index.html +15 -0
package/browser-op/webplater/entrypoints/offscreen/main.ts +161 -0
package/browser-op/webplater/entrypoints/popup/index.html +29 -0
package/browser-op/webplater/entrypoints/popup/main.ts +61 -0
package/browser-op/webplater/entrypoints/popup/style.css +100 -0
package/browser-op/webplater/lib/snapshot.ts +352 -0
package/browser-op/webplater/package.json +29 -0
package/browser-op/webplater/pnpm-lock.yaml +3411 -0
package/browser-op/webplater/public/capture.js +310 -0
package/browser-op/webplater/scripts/publish-extension.mjs +176 -0
package/browser-op/webplater/tsconfig.json +19 -0
package/browser-op/webplater/wxt.config.ts +34 -0
package/dist/actions.md +102 -0
package/dist/cli.d.ts +2 -0
package/dist/cli.d.ts.map +1 -0
package/dist/cli.js +278 -0
package/dist/cli.js.map +1 -0
package/dist/client.d.ts +94 -0
package/dist/client.d.ts.map +1 -0
package/dist/client.js +277 -0
package/dist/client.js.map +1 -0
package/dist/config.d.ts +61 -0
package/dist/config.d.ts.map +1 -0
package/dist/config.js +119 -0
package/dist/config.js.map +1 -0
package/dist/protocol.d.ts +195 -0
package/dist/protocol.d.ts.map +1 -0
package/dist/protocol.js +11 -0
package/dist/protocol.js.map +1 -0
package/dist/server.d.ts +66 -0
package/dist/server.d.ts.map +1 -0
package/dist/server.js +259 -0
package/dist/server.js.map +1 -0
package/package.json +78 -0
package/schemas/browser.clearCookies.schema.json +13 -0
package/schemas/browser.close.schema.json +9 -0
package/schemas/browser.getCookies.schema.json +13 -0
package/schemas/browser.getDownload.schema.json +15 -0
package/schemas/browser.health.schema.json +9 -0
package/schemas/browser.listDownloads.schema.json +16 -0
package/schemas/browser.listTabs.schema.json +9 -0
package/schemas/browser.newTab.schema.json +15 -0
package/schemas/browser.open.schema.json +15 -0
package/schemas/browser.operate.schema.json +15 -0
package/schemas/browser.reuseTab.schema.json +15 -0
package/schemas/browser.setCookies.schema.json +15 -0
package/schemas/browser.waitFor.schema.json +15 -0
package/schemas/browser.waitForDownload.schema.json +15 -0
package/skills/browser/SKILL.md +110 -0
package/skills/browser/references/collect.md +163 -0
package/skills/browser/references/high-risk.md +161 -0
package/skills/browser/references/operate-actions.md +92 -0
package/skills/browser/references/probing.md +302 -0

package/browser-op/webplater/entrypoints/offscreen/index.html ADDED Viewed

@@ -0,0 +1,15 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <title>WebPlater Offscreen</title>
+  </head>
+  <body>
+    <!--
+      offscreen document：常驻宿主，持有到 browserd 的 WebSocket 长连接。
+      页面本身无 UI，仅承载 main.ts 的 WS 桥接逻辑。
+      由 background.ts 的 ensureOffscreen() 创建。
+    -->
+    <script type="module" src="./main.ts"></script>
+  </body>
+</html>

package/browser-op/webplater/entrypoints/offscreen/main.ts ADDED Viewed

@@ -0,0 +1,161 @@
+// offscreen main — 持有到 browserd 的 WebSocket 长连接，把 host 命令桥接到 background。
+//
+// 动机：MV3 service worker 会被 Chrome 回收（约 30s 空闲，单事件最长 5min），
+// 把 WS 长连接放在 SW 里会随回收断开、长任务中断。offscreen document 常驻到关闭，
+// 是 WS 的可靠宿主。
+//
+// 命令链路：
+//   browserd :17321 ⇿ offscreen (WS) ⇿ background (chrome.runtime message)
+//
+// background 负责 ensureOffscreen() 建本 document；本文件只做 WS 持有 + 双向桥接。
+//
+// 注意：本文件作为 offscreen/index.html 的内嵌 module script，必须用顶层副作用执行
+// （与 popup/main.ts 一致）。不要用 `export default defineUnlistedScript`——那会被
+// wxt 识别成独立 unlisted-script 入口并从本 html 抽走，导致脚本不被加载。
+interface CommandMessage {
+  id: number
+  type: 'command'
+  method: string
+  params?: Record<string, unknown>
+}
+interface ResponseMessage {
+  id: number
+  type: 'response'
+  ok: boolean
+  result?: unknown
+  error?: string
+}
+interface BackgroundResponse {
+  ok: boolean
+  result?: unknown
+  error?: string
+}
+const HOST_WS_URL = 'ws://127.0.0.1:17321'
+const RECONNECT_DELAY_MS = 1000
+const PING_INTERVAL_MS = 20000
+let socket: WebSocket | null = null
+let reconnectTimer: ReturnType<typeof setTimeout> | null = null
+let pingTimer: ReturnType<typeof setInterval> | null = null
+function connect() {
+  if (socket?.readyState === WebSocket.CONNECTING || socket?.readyState === WebSocket.OPEN) {
+    return
+  }
+  socket = new WebSocket(HOST_WS_URL)
+  socket.addEventListener('open', () => {
+    if (reconnectTimer) {
+      clearTimeout(reconnectTimer)
+      reconnectTimer = null
+    }
+    console.log('[WebPlater/offscreen] connected to host', HOST_WS_URL)
+    // hello 只需 type：host server.cjs 只看消息 type 判活，name/version/extensionId
+    // 是装饰字段，且 chrome.runtime.getManifest/id 在 offscreen 不可用，故不取。
+    send({ type: 'hello', name: 'bee-web-plugin' })
+    startPing()
+  })
+  socket.addEventListener('message', async (event) => {
+    let msg: CommandMessage | undefined
+    try {
+      msg = JSON.parse(String(event.data))
+    } catch {
+      console.error('[WebPlater/offscreen] invalid JSON from host', event.data)
+      return
+    }
+    if (!msg || msg.type !== 'command' || typeof msg.id !== 'number') return
+    try {
+      const result = await sendToBackground(msg.id, msg.method, msg.params ?? {})
+      respond(msg.id, { ok: true, result })
+    } catch (err) {
+      respond(msg.id, {
+        ok: false,
+        error: err instanceof Error ? err.message : String(err),
+      })
+    }
+  })
+  socket.addEventListener('close', () => {
+    console.log('[WebPlater/offscreen] disconnected, reconnecting...')
+    socket = null
+    stopPing()
+    scheduleReconnect()
+  })
+  socket.addEventListener('error', () => {
+    // close 事件会随后触发，由它负责重连
+    socket?.close()
+  })
+}
+function send(payload: unknown): void {
+  if (socket?.readyState === WebSocket.OPEN) {
+    socket.send(JSON.stringify(payload))
+  }
+}
+function respond(id: number, response: { ok: boolean; result?: unknown; error?: string }): void {
+  const msg: ResponseMessage = { id, type: 'response', ...response }
+  send(msg)
+}
+/**
+ * 把命令转发给 background 执行并等回包。
+ * chrome.runtime.sendMessage 会唤醒休眠的 service worker；SW 在 message handler
+ * pending（sendResponse 未调用）期间保持活跃，长任务（如 evaluate 300s）不会因 SW
+ * 回收而中断连接本身（连接在本 offscreen 持有）。
+ */
+function sendToBackground(
+  id: number,
+  method: string,
+  params: Record<string, unknown>,
+): Promise<unknown> {
+  return new Promise((resolve, reject) => {
+    chrome.runtime.sendMessage(
+      { source: 'offscreen-command', id, method, params },
+      (response) => {
+        if (chrome.runtime.lastError) {
+          reject(new Error(chrome.runtime.lastError.message))
+          return
+        }
+        const r = response as BackgroundResponse | undefined
+        if (r && typeof r === 'object' && r.ok === false) {
+          reject(new Error(r.error ?? 'background error'))
+          return
+        }
+        resolve(r?.result)
+      },
+    )
+  })
+}
+function startPing(): void {
+  stopPing()
+  pingTimer = setInterval(() => {
+    send({ type: 'ping', time: Date.now() })
+  }, PING_INTERVAL_MS)
+}
+function stopPing(): void {
+  if (pingTimer) {
+    clearInterval(pingTimer)
+    pingTimer = null
+  }
+}
+function scheduleReconnect(): void {
+  if (reconnectTimer) return
+  reconnectTimer = setTimeout(() => {
+    reconnectTimer = null
+    connect()
+  }, RECONNECT_DELAY_MS)
+}
+connect()

package/browser-op/webplater/entrypoints/popup/index.html ADDED Viewed

@@ -0,0 +1,29 @@
+<!doctype html>
+<html lang="zh-CN">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>WebPlater</title>
+  </head>
+  <body>
+    <div id="app">
+      <header>
+        <h1>WebPlater</h1>
+        <p id="status" class="status">checking...</p>
+      </header>
+      <section>
+        <h2>调试</h2>
+        <div class="row">
+          <button id="btn-tabs">List Tabs</button>
+          <button id="btn-status">Page Status</button>
+          <button id="btn-reconnect">Reconnect</button>
+        </div>
+      </section>
+      <pre id="result">Ready</pre>
+    </div>
+    <script type="module" src="./main.ts"></script>
+  </body>
+</html>

package/browser-op/webplater/entrypoints/popup/main.ts ADDED Viewed

@@ -0,0 +1,61 @@
+import './style.css'
+const result = document.getElementById('result') as HTMLPreElement
+const statusEl = document.getElementById('status') as HTMLParagraphElement
+function render(data: unknown): void {
+  result.textContent = typeof data === 'string' ? data : JSON.stringify(data, null, 2)
+}
+// popup 无法直接接触 background 的 WebSocket 私有变量，
+// 这里只做命令级调试：通过一条 runtime 消息让 background 回包。
+// status 文本仅反映扩展是否响应，不反映 WebSocket 真实连接态（那只在 background 内）。
+async function pingBackground(): Promise<boolean> {
+  return new Promise((resolve) => {
+    chrome.runtime.sendMessage({ source: 'bee-plugin-popup', method: 'listTabs' }, (resp) => {
+      if (chrome.runtime.lastError) {
+        resolve(false)
+        return
+      }
+      resolve(!!resp)
+    })
+  })
+}
+document.getElementById('btn-tabs')!.addEventListener('click', async () => {
+  result.textContent = 'loading...'
+  chrome.runtime.sendMessage({ source: 'bee-plugin-popup', method: 'listTabs' }, (resp) => {
+    if (chrome.runtime.lastError) {
+      render(chrome.runtime.lastError.message)
+      return
+    }
+    render(resp)
+  })
+})
+document.getElementById('btn-status')!.addEventListener('click', async () => {
+  result.textContent = 'loading...'
+  chrome.runtime.sendMessage({ source: 'bee-plugin-popup', method: 'status' }, (resp) => {
+    if (chrome.runtime.lastError) {
+      render(chrome.runtime.lastError.message)
+      return
+    }
+    render(resp)
+  })
+})
+document.getElementById('btn-reconnect')!.addEventListener('click', () => {
+  // offscreen 持有 WS 并自重连；这里确保 offscreen document 存在
+  chrome.runtime.sendMessage({ source: 'bee-plugin-popup', method: 'reconnect' }, (resp) => {
+    if (chrome.runtime.lastError) {
+      render(chrome.runtime.lastError.message)
+      return
+    }
+    render(resp?.ok ? 'offscreen ensured; WS (re)connects automatically' : resp)
+  })
+})
+;(async () => {
+  const ok = await pingBackground()
+  statusEl.textContent = ok ? 'background responsive' : 'background no response'
+})()

package/browser-op/webplater/entrypoints/popup/style.css ADDED Viewed

@@ -0,0 +1,100 @@
+* {
+  box-sizing: border-box;
+}
+body {
+  margin: 0;
+  padding: 0;
+  font-family: system-ui, -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
+  font-size: 13px;
+  color: #333;
+  background: #f5f5f5;
+}
+#app {
+  width: 440px;
+  min-height: 300px;
+  padding: 16px;
+}
+header h1 {
+  margin: 0 0 4px;
+  font-size: 16px;
+}
+.status {
+  margin: 0 0 12px;
+  font-size: 12px;
+  color: #888;
+}
+section {
+  background: #fff;
+  border-radius: 8px;
+  padding: 12px;
+  margin-bottom: 12px;
+  box-shadow: 0 1px 3px rgba(0, 0, 0, 0.06);
+}
+section h2 {
+  font-size: 13px;
+  margin: 0 0 10px;
+  color: #666;
+}
+.row {
+  display: flex;
+  gap: 8px;
+  flex-wrap: wrap;
+}
+button {
+  padding: 6px 12px;
+  border: 1px solid #d9d9d9;
+  border-radius: 4px;
+  background: #fff;
+  cursor: pointer;
+  font-size: 12px;
+}
+button:hover {
+  border-color: #40a9ff;
+  color: #1890ff;
+}
+input[type='text'],
+textarea {
+  width: 100%;
+  padding: 6px 8px;
+  margin-bottom: 8px;
+  border: 1px solid #d9d9d9;
+  border-radius: 4px;
+  font-family: monospace;
+  font-size: 12px;
+}
+textarea {
+  resize: vertical;
+}
+.inline {
+  display: flex;
+  align-items: center;
+  gap: 6px;
+  font-size: 12px;
+  color: #666;
+  margin-top: 6px;
+}
+#result {
+  background: #f6f8fa;
+  border: 1px solid #e1e4e8;
+  border-radius: 4px;
+  padding: 10px;
+  max-height: 280px;
+  overflow: auto;
+  font-size: 11px;
+  line-height: 1.5;
+  white-space: pre-wrap;
+  word-break: break-all;
+}