@skrillex1224/android-toolkit 0.1.2 → 0.1.8

package/src/share.js

@@ -0,0 +1,644 @@
+import {
+    compressImageBufferToBase64,
+    resolveImageCompression,
+} from './internals/compression.js';
+import {ActorInfo} from './constants.js';
+import {Device} from './device.js';
+import {Logger, sleep} from './logger.js';
+
+const DEFAULT_SCREENSHOT_MAX_HEIGHT = 8000;
+const DEFAULT_SCREENSHOT_SETTLE_MS = 900;
+const DEFAULT_SHARE_TIMEOUT_MS = 50000;
+const DEFAULT_POLL_INTERVAL_MS = 800;
+
+const normalizePrefix = (value) => String(value || '').trim();
+
+const normalizeActorInfo = (value) => {
+    if (value && typeof value === 'object') return value;
+    const key = String(value || '').trim();
+    return ActorInfo[key] || null;
+};
+
+const normalizeShare = (share, actorInfo) => {
+    const source = share && typeof share === 'object' ? share : actorInfo?.share || {};
+    const modeRaw = String(source.mode || 'clipboard').trim().toLowerCase();
+    const mode = ['clipboard', 'custom'].includes(modeRaw) ? modeRaw : 'clipboard';
+    return {
+        mode,
+        prefix: normalizePrefix(source.prefix),
+        xurl: Array.isArray(source.xurl) ? source.xurl : [],
+    };
+};
+
+const parseLinks = (text, options = {}) => {
+    const prefix = normalizePrefix(options.prefix);
+    const raw = String(text || '');
+    if (!raw) return [];
+    const urls = raw.match(/https?:\/\/[^\s"'<>，。]+/g) || [];
+    const normalized = [];
+    for (const candidate of urls) {
+        const clean = candidate.replace(/[)\].,，。；;!?！？]+$/g, '');
+        if (prefix && !clean.startsWith(prefix)) continue;
+        if (!normalized.includes(clean)) normalized.push(clean);
+    }
+    return normalized;
+};
+
+const toSnapshot = (value, maxLen = 500) => {
+    const text = String(value || '');
+    if (!text) return '';
+    return text.replace(/\s+/g, ' ').trim().slice(0, maxLen);
+};
+
+const abortReason = (signal) => {
+    const reason = signal?.reason;
+    if (reason instanceof Error) return reason.message;
+    return reason ? String(reason) : 'aborted';
+};
+
+const raceWithTimeout = async (promiseFactory, timeoutMs, signal) => {
+    const timeoutDisabled = timeoutMs === 0 || timeoutMs === Infinity;
+    let timer = null;
+    let abortCleanup = null;
+
+    const actionPromise = Promise.resolve()
+        .then(() => promiseFactory())
+        .then((result) => ({type: 'done', result}))
+        .catch((error) => ({type: 'error', error}));
+
+    const racers = [actionPromise];
+
+    if (!timeoutDisabled) {
+        racers.push(new Promise((resolve) => {
+            timer = setTimeout(() => resolve({type: 'timeout'}), Math.max(0, timeoutMs));
+        }));
+    }
+
+    if (signal) {
+        racers.push(new Promise((resolve) => {
+            if (signal.aborted) {
+                resolve({type: 'aborted', reason: abortReason(signal)});
+                return;
+            }
+            const onAbort = () => resolve({type: 'aborted', reason: abortReason(signal)});
+            abortCleanup = () => signal.removeEventListener('abort', onAbort);
+            signal.addEventListener('abort', onAbort, {once: true});
+        }));
+    }
+
+    const result = await Promise.race(racers);
+    if (timer) clearTimeout(timer);
+    if (abortCleanup) abortCleanup();
+    return result;
+};
+
+const clampInt = (value, min, max) => {
+    const n = Math.round(Number(value) || 0);
+    return Math.max(min, Math.min(max, n));
+};
+
+const estimateScrollableHeightScript = () => `
+Java.perform(function () {
+  function emit(payload) { console.log('ANDROID_TOOLKIT_SCRIPT_JSON ' + JSON.stringify(payload)); }
+  var JavaObject = Java.use('java.lang.Object');
+  function text(value) {
+    if (value === null || value === undefined) return '';
+    try { return Java.cast(value, JavaObject).toString() + ''; } catch (_) {}
+    try { return value.toString.overload().call(value) + ''; } catch (_) {}
+    try { return value.toString() + ''; } catch (_) {}
+    return '';
+  }
+  function walk(view, out, depth) {
+    if (!view || depth > 32 || out.length > 8000) return;
+    out.push(view);
+    try {
+      var ViewGroup = Java.use('android.view.ViewGroup');
+      var group = Java.cast(view, ViewGroup);
+      for (var i = 0; i < group.getChildCount(); i++) walk(group.getChildAt(i), out, depth + 1);
+    } catch (_) {}
+  }
+  function activeActivities() {
+    var ActivityThread = Java.use('android.app.ActivityThread');
+    var Activity = Java.use('android.app.Activity');
+    var ArrayMap = Java.use('android.util.ArrayMap');
+    var thread = ActivityThread.currentActivityThread();
+    var field = thread.getClass().getDeclaredField('mActivities');
+    field.setAccessible(true);
+    var map = Java.cast(field.get(thread), ArrayMap);
+    var out = [];
+    for (var i = 0; i < map.size(); i++) {
+      var record = map.valueAt(i);
+      var rc = record.getClass();
+      var af = rc.getDeclaredField('activity');
+      var pf = rc.getDeclaredField('paused');
+      af.setAccessible(true);
+      pf.setAccessible(true);
+      if (!pf.getBoolean(record)) out.push(Java.cast(af.get(record), Activity));
+    }
+    return out;
+  }
+  function idOf(view) {
+    try {
+      var id = view.getId();
+      if (id <= 0) return '';
+      return text(view.getResources().getResourceName(id));
+    } catch (_) {
+      return '';
+    }
+  }
+  function descOf(view) {
+    try { return text(view.getContentDescription()); } catch (_) { return ''; }
+  }
+  function classOf(view) {
+    try { return text(view.getClass().getName()); } catch (_) { return ''; }
+  }
+  function boundsOf(view) {
+    try {
+      var Rect = Java.use('android.graphics.Rect');
+      var rect = Rect.$new();
+      view.getGlobalVisibleRect(rect);
+      return {
+        left: rect.left.value,
+        top: rect.top.value,
+        right: rect.right.value,
+        bottom: rect.bottom.value,
+        width: Math.max(0, rect.right.value - rect.left.value),
+        height: Math.max(0, rect.bottom.value - rect.top.value)
+      };
+    } catch (_) {
+      return { left: 0, top: 0, right: 0, bottom: 0, width: 0, height: 0 };
+    }
+  }
+  Java.scheduleOnMainThread(function () {
+    try {
+      var displayHeight = 0;
+      var displayWidth = 0;
+      var views = [];
+      var activities = activeActivities();
+      for (var a = 0; a < activities.length; a++) {
+        try {
+          var decor = activities[a].getWindow().getDecorView();
+          displayHeight = Math.max(displayHeight, decor.getHeight());
+          displayWidth = Math.max(displayWidth, decor.getWidth());
+          walk(decor, views, 0);
+        } catch (_) {}
+      }
+      var candidates = [];
+      var maxWantedHeight = displayHeight;
+      for (var i = 0; i < views.length; i++) {
+        var view = views[i];
+        try { if (!view.isShown()) continue; } catch (_) {}
+        var bounds = boundsOf(view);
+        if (bounds.width <= 0 || bounds.height <= 0) continue;
+        var range = 0;
+        var extent = 0;
+        var offset = 0;
+        var canScroll = false;
+        try { canScroll = Boolean(view.canScrollVertically(1)) || Boolean(view.canScrollVertically(-1)); } catch (_) {}
+        try { range = Math.max(0, view.computeVerticalScrollRange()); } catch (_) {}
+        try { extent = Math.max(0, view.computeVerticalScrollExtent()); } catch (_) {}
+        try { offset = Math.max(0, view.computeVerticalScrollOffset()); } catch (_) {}
+        if (!canScroll && range <= extent + 2) continue;
+        var wantedHeight = Math.max(displayHeight, bounds.top + range);
+        maxWantedHeight = Math.max(maxWantedHeight, wantedHeight);
+        candidates.push({
+          className: classOf(view),
+          resourceId: idOf(view),
+          description: descOf(view),
+          bounds: bounds,
+          scrollRange: range,
+          scrollExtent: extent,
+          scrollOffset: offset,
+          wantedHeight: wantedHeight
+        });
+      }
+      candidates.sort(function (a, b) { return b.wantedHeight - a.wantedHeight; });
+      emit({
+        ok: true,
+        displayWidth: displayWidth,
+        displayHeight: displayHeight,
+        height: maxWantedHeight,
+        scrollableCount: candidates.length,
+        candidates: candidates.slice(0, 12)
+      });
+    } catch (error) {
+      emit({ ok: false, error: String(error), stack: String(error.stack || '') });
+    }
+  });
+});
+`;
+
+const resetScrollablePositionsScript = () => `
+Java.perform(function () {
+  function emit(payload) { console.log('ANDROID_TOOLKIT_SCRIPT_JSON ' + JSON.stringify(payload)); }
+  function walk(view, out, depth) {
+    if (!view || depth > 32 || out.length > 8000) return;
+    out.push(view);
+    try {
+      var ViewGroup = Java.use('android.view.ViewGroup');
+      var group = Java.cast(view, ViewGroup);
+      for (var i = 0; i < group.getChildCount(); i++) walk(group.getChildAt(i), out, depth + 1);
+    } catch (_) {}
+  }
+  function activeActivities() {
+    var ActivityThread = Java.use('android.app.ActivityThread');
+    var Activity = Java.use('android.app.Activity');
+    var ArrayMap = Java.use('android.util.ArrayMap');
+    var thread = ActivityThread.currentActivityThread();
+    var field = thread.getClass().getDeclaredField('mActivities');
+    field.setAccessible(true);
+    var map = Java.cast(field.get(thread), ArrayMap);
+    var out = [];
+    for (var i = 0; i < map.size(); i++) {
+      var record = map.valueAt(i);
+      var rc = record.getClass();
+      var af = rc.getDeclaredField('activity');
+      var pf = rc.getDeclaredField('paused');
+      af.setAccessible(true);
+      pf.setAccessible(true);
+      if (!pf.getBoolean(record)) out.push(Java.cast(af.get(record), Activity));
+    }
+    return out;
+  }
+  Java.scheduleOnMainThread(function () {
+    try {
+      var views = [];
+      var activities = activeActivities();
+      for (var a = 0; a < activities.length; a++) {
+        try { walk(activities[a].getWindow().getDecorView(), views, 0); } catch (_) {}
+      }
+      var resetCount = 0;
+      for (var i = 0; i < views.length; i++) {
+        var view = views[i];
+        var canScroll = false;
+        var offset = 0;
+        try { canScroll = Boolean(view.canScrollVertically(-1)) || Boolean(view.canScrollVertically(1)); } catch (_) {}
+        try { offset = Math.max(0, view.computeVerticalScrollOffset()); } catch (_) {}
+        if (!canScroll && offset <= 0) continue;
+        try {
+          view.scrollTo(0, 0);
+          resetCount += 1;
+          continue;
+        } catch (_) {}
+        try {
+          if (offset > 0) {
+            view.scrollBy(0, -offset);
+            resetCount += 1;
+          }
+        } catch (_) {}
+      }
+      emit({ ok: true, resetCount: resetCount });
+    } catch (error) {
+      emit({ ok: false, error: String(error), stack: String(error.stack || '') });
+    }
+  });
+});
+`;
+
+const clipboardLinkProbeScript = () => `
+Java.perform(function () {
+  function emit(payload) { console.log('ANDROID_TOOLKIT_SCRIPT_JSON ' + JSON.stringify(payload)); }
+  var JavaObject = Java.use('java.lang.Object');
+  function text(value) {
+    if (value === null || value === undefined) return '';
+    try { return Java.cast(value, JavaObject).toString() + ''; } catch (_) {}
+    try { return value.toString.overload().call(value) + ''; } catch (_) {}
+    try { return value.toString() + ''; } catch (_) {}
+    return '';
+  }
+  function addCandidate(out, source, value) {
+    var s = text(value);
+    if (!s) return;
+    var matches = s.match(/https?:\\/\\/[^\\s"'<>，。]+/g) || [];
+    for (var i = 0; i < matches.length; i++) {
+      var link = matches[i].replace(/[)\\].,，。；;!?！？]+$/g, '');
+      var exists = false;
+      for (var j = 0; j < out.length; j++) {
+        if (out[j].link === link) {
+          exists = true;
+          break;
+        }
+      }
+      if (!exists) out.push({ source: source, link: link, payload: s.slice(0, 1000) });
+    }
+  }
+  Java.scheduleOnMainThread(function () {
+    try {
+      var ActivityThread = Java.use('android.app.ActivityThread');
+      var app = ActivityThread.currentApplication();
+      var candidates = [];
+      if (app) {
+        var manager = app.getSystemService('clipboard');
+        var ClipboardManager = Java.use('android.content.ClipboardManager');
+        var clip = manager ? Java.cast(manager, ClipboardManager).getPrimaryClip() : null;
+        var count = clip ? clip.getItemCount() : 0;
+        for (var i = 0; i < count; i++) {
+          var item = clip.getItemAt(i);
+          try { addCandidate(candidates, 'clipboard.text', item.getText()); } catch (_) {}
+          try { addCandidate(candidates, 'clipboard.html', item.getHtmlText()); } catch (_) {}
+          try { addCandidate(candidates, 'clipboard.uri', item.getUri()); } catch (_) {}
+          try { addCandidate(candidates, 'clipboard.intent', item.getIntent()); } catch (_) {}
+          try { addCandidate(candidates, 'clipboard.coerceToText', item.coerceToText(app)); } catch (_) {}
+        }
+      }
+      emit({
+        ok: candidates.length > 0,
+        link: candidates.length > 0 ? candidates[0].link : '',
+        source: candidates.length > 0 ? candidates[0].source : 'clipboard',
+        candidates: candidates,
+        error: candidates.length > 0 ? '' : 'share link not found in clipboard'
+      });
+    } catch (error) {
+      emit({ ok: false, error: String(error), stack: String(error.stack || '') });
+    }
+  });
+});
+`;
+
+async function estimateScrollableHeight(ctx, options = {}) {
+    const Frida = options.Frida || options.frida;
+    const size = await Device.screenSize(ctx).catch(() => ({width: 720, height: 1280}));
+    if (!Frida?.runScript) {
+        throw new Error('Share.captureScreen requires Frida.runScript to inspect Android View scroll ranges');
+    }
+
+    const event = await Frida.runScript(ctx, estimateScrollableHeightScript(), {
+        label: 'android-share-estimate-scrollable-height',
+        timeoutMs: Number(options.timeoutMs || 10000),
+        fridaTimeoutSeconds: Number(options.fridaTimeoutSeconds || 8),
+        maxLines: 2000,
+    }).catch((error) => ({
+        ok: false,
+        error: error?.message || String(error),
+    }));
+
+    if (!event?.ok) {
+        throw new Error(`Share.captureScreen failed to inspect Android View tree: ${event?.error || 'unknown error'}`);
+    }
+
+    return {
+        height: Math.max(size.height, Math.round(Number(event.height || 0))),
+        width: Math.max(size.width, Math.round(Number(event.displayWidth || size.width || 0))),
+        scrollableCount: Number(event.scrollableCount || 0),
+        candidates: Array.isArray(event.candidates) ? event.candidates : [],
+        source: 'frida-view-tree',
+    };
+}
+
+async function resetScrollablePositions(ctx, options = {}) {
+    const Frida = options.Frida || options.frida;
+    if (!Frida?.runScript) return {ok: false, resetCount: 0};
+    return Frida.runScript(ctx, resetScrollablePositionsScript(), {
+        label: 'android-share-reset-scrollable-positions',
+        timeoutMs: Number(options.timeoutMs || 10000),
+        fridaTimeoutSeconds: Number(options.fridaTimeoutSeconds || 8),
+        maxLines: 1000,
+    }).catch((error) => ({
+        ok: false,
+        resetCount: 0,
+        error: error?.message || String(error),
+    }));
+}
+
+async function probeClipboardLinks(ctx, options = {}) {
+    const Frida = options.Frida || options.frida;
+    if (!Frida?.runScript) {
+        throw new Error('Share.captureLink clipboard mode requires Frida.runScript');
+    }
+    return Frida.runScript(ctx, clipboardLinkProbeScript(), {
+        label: options.label || 'android-share-read-clipboard-link',
+        timeoutMs: Number(options.timeoutMs || 9000),
+        fridaTimeoutSeconds: Number(options.fridaTimeoutSeconds || 8),
+        maxLines: Number(options.maxLines || 1500),
+    });
+}
+
+export const Share = {
+    /**
+     * Android 单次高视口截图。
+     *
+     * API 形态对齐 playwright-toolkit 的 Share.captureScreen：
+     * - 默认返回 base64 image；
+     * - 默认压缩阈值与 playwright-toolkit 一致；
+     * - 通过临时 wm size 拉高视口，避免滚动拼接重复 fixed 元素。
+     */
+    async captureScreen(ctx, options = {}) {
+        const startedAt = Date.now();
+        const Frida = options.Frida || options.frida;
+        if (!Frida?.runScript) {
+            throw new Error('Share.captureScreen requires Frida.runScript to inspect Android View scroll ranges');
+        }
+        const actorInfo = normalizeActorInfo(options.actorInfo || options.actor || options.actorKey);
+        const compression = resolveImageCompression(options);
+        const maxHeight = Math.max(1, Math.round(Number(options.maxHeight || DEFAULT_SCREENSHOT_MAX_HEIGHT)));
+        const settleMs = Math.max(0, Math.round(Number(options.settleMs ?? DEFAULT_SCREENSHOT_SETTLE_MS)));
+        const restore = options.restore !== false;
+        const originalSize = await Device.screenSize(ctx).catch(() => ({width: 720, height: 1280}));
+        const originalDensity = await Device.screenDensity(ctx).catch(() => 0);
+        const estimated = await estimateScrollableHeight(ctx, options);
+        const targetWidth = Math.max(1, Math.round(Number(options.width || estimated.width || originalSize.width)));
+        const targetHeight = clampInt(
+            Number(options.height || estimated.height || originalSize.height),
+            originalSize.height,
+            maxHeight
+        );
+
+        Logger.info('captureScreen 准备高视口截图', {
+            serial: ctx.serial,
+            actor: actorInfo?.key || '',
+            original: `${originalSize.width}x${originalSize.height}`,
+            target: `${targetWidth}x${targetHeight}`,
+            density: originalDensity || '',
+            scrollableCount: estimated.scrollableCount || 0,
+            source: estimated.source,
+        });
+
+        let pngBuffer;
+        try {
+            if (targetHeight > originalSize.height + 2 || targetWidth !== originalSize.width) {
+                await Device.overrideScreenSize(ctx, targetWidth, targetHeight);
+                if (settleMs > 0) await sleep(settleMs);
+            }
+            if (options.scrollToTop !== false) {
+                const resetEvent = await resetScrollablePositions(ctx, options);
+                Logger.info('captureScreen 已尝试重置滚动位置', {
+                    ok: Boolean(resetEvent?.ok),
+                    resetCount: Number(resetEvent?.resetCount || 0),
+                    error: resetEvent?.error || '',
+                });
+                if (settleMs > 0) await sleep(Math.min(settleMs, 500));
+            }
+            pngBuffer = await Device.screenshotPng(ctx);
+        } finally {
+            if (restore) {
+                await Device.resetScreenSize(ctx).catch((error) => {
+                    Logger.warn('captureScreen 恢复 wm size 失败', {message: error?.message || String(error)});
+                });
+            }
+        }
+
+        const base64 = await compressImageBufferToBase64(pngBuffer, compression);
+        Logger.success('captureScreen 完成', {
+            duration: Logger.duration(startedAt),
+            pngBytes: pngBuffer.length,
+            base64Chars: base64.length,
+        });
+        return base64;
+    },
+
+    /**
+     * 捕获分享链接。
+     *
+     * Android 当前主模式是 clipboard：业务层负责点击分享/复制链接，
+     * toolkit 负责按 ActorInfo.share.prefix 轮询和校验剪贴板结果。
+     */
+    async captureLink(ctx, options = {}) {
+        const actorInfo = normalizeActorInfo(options.actorInfo || options.actor || options.actorKey);
+        const share = normalizeShare(options.share, actorInfo);
+        const timeoutMs = Math.max(0, Number(options.timeoutMs ?? DEFAULT_SHARE_TIMEOUT_MS));
+        const pollIntervalMs = Math.max(100, Number(options.pollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS));
+        const payloadSnapshotMaxLen = Number(options.payloadSnapshotMaxLen || 500);
+        const performActions = typeof options.performActions === 'function' ? options.performActions : async () => {};
+        const signal = options.signal;
+        const isAborted = () => Boolean(signal?.aborted);
+        const timeoutDisabled = timeoutMs === 0;
+        const deadline = timeoutDisabled ? Infinity : Date.now() + timeoutMs;
+        const getRemainingMs = () => timeoutDisabled ? Infinity : Math.max(0, deadline - Date.now());
+
+        if (!share.prefix) {
+            throw new Error('Share.captureLink requires options.share.prefix or actorInfo.share.prefix');
+        }
+        if (share.mode !== 'clipboard' && share.mode !== 'custom') {
+            throw new Error(`Share.captureLink unsupported share.mode: ${share.mode}`);
+        }
+
+        Logger.start('captureLink', {
+            mode: share.mode,
+            prefix: share.prefix,
+            timeoutMs,
+        });
+
+        if (isAborted()) {
+            const reason = abortReason(signal);
+            Logger.warn('captureLink 已取消', {reason});
+            return {
+                link: null,
+                payloadText: '',
+                payloadSnapshot: reason,
+                source: 'none',
+            };
+        }
+
+        const actionResult = await raceWithTimeout(
+            () => performActions(),
+            getRemainingMs(),
+            signal
+        );
+        if (actionResult.type === 'error') {
+            Logger.fail('captureLink.performActions', actionResult.error);
+            throw actionResult.error;
+        }
+        if (actionResult.type === 'aborted') {
+            Logger.warn('captureLink 已取消', {reason: actionResult.reason});
+            return {
+                link: null,
+                payloadText: '',
+                payloadSnapshot: actionResult.reason,
+                source: 'none',
+            };
+        }
+        const actionTimedOut = actionResult.type === 'timeout';
+        if (actionTimedOut) {
+            Logger.warn('captureLink.performActions 超时，继续轮询已有剪贴板结果', {timeoutMs});
+        }
+        const actionValue = actionResult.type === 'done' ? actionResult.result : undefined;
+        if (share.mode === 'custom') {
+            const customLink = typeof actionValue === 'string'
+                ? actionValue
+                : actionValue?.link || actionValue?.payloadText || '';
+            const [link] = parseLinks(customLink, {prefix: share.prefix});
+            return {
+                link: link || null,
+                payloadText: String(customLink || ''),
+                payloadSnapshot: toSnapshot(customLink, payloadSnapshotMaxLen),
+                source: link ? 'custom' : 'none',
+            };
+        }
+
+        let attempt = 0;
+        let lastPayload = '';
+        while (Date.now() < deadline) {
+            if (isAborted()) {
+                const reason = abortReason(signal);
+                Logger.warn('captureLink 已取消', {reason});
+                return {
+                    link: null,
+                    payloadText: lastPayload,
+                    payloadSnapshot: reason,
+                    source: 'none',
+                };
+            }
+            attempt += 1;
+            const probeTimeoutMs = timeoutDisabled
+                ? 9000
+                : Math.max(100, Math.min(9000, getRemainingMs()));
+            const event = await probeClipboardLinks(ctx, {
+                ...options,
+                label: `android-share-read-clipboard-link-${attempt}`,
+                timeoutMs: probeTimeoutMs,
+            }).catch((error) => ({
+                ok: false,
+                error: error?.message || String(error),
+            }));
+            const payloadText = JSON.stringify(event || {});
+            lastPayload = payloadText;
+
+            const candidates = [];
+            if (event?.link) candidates.push(event.link);
+            if (Array.isArray(event?.candidates)) {
+                for (const candidate of event.candidates) {
+                    if (candidate?.link) candidates.push(candidate.link);
+                    if (candidate?.payload) candidates.push(candidate.payload);
+                }
+            }
+            candidates.push(payloadText);
+
+            for (const candidate of candidates) {
+                const [link] = parseLinks(candidate, {prefix: share.prefix});
+                if (!link) continue;
+                Logger.success('captureLink 完成', {
+                    source: event?.source || 'clipboard',
+                    attempt,
+                    link,
+                });
+                return {
+                    link,
+                    payloadText,
+                    payloadSnapshot: toSnapshot(payloadText, payloadSnapshotMaxLen),
+                    source: event?.source || 'clipboard',
+                };
+            }
+
+            if (attempt === 1 || attempt % 5 === 0) {
+                Logger.info('captureLink 等待剪贴板', {
+                    attempt,
+                    candidateCount: Array.isArray(event?.candidates) ? event.candidates.length : 0,
+                    error: event?.error || '',
+                });
+            }
+            await sleep(Math.min(pollIntervalMs, Math.max(0, deadline - Date.now())));
+        }
+
+        Logger.warn('captureLink 超时未拿到链接', {
+            mode: share.mode,
+            prefix: share.prefix,
+            attempts: attempt,
+        });
+        return {
+            link: null,
+            payloadText: lastPayload,
+            payloadSnapshot: toSnapshot(lastPayload, payloadSnapshotMaxLen),
+            source: 'none',
+        };
+    },
+};