@lingxiao-office/sdk 1.0.0

package/dist/core/BrowserRuntime.d.ts

@@ -0,0 +1,178 @@
+import type { Page } from 'playwright';
+import { type BrowserHealth } from './BrowserProvider.js';
+export interface BrowserViewport {
+    width: number;
+    height: number;
+    deviceScaleFactor: number;
+}
+export interface BrowserSessionSummary {
+    id: string;
+    url: string;
+    title: string;
+    createdAt: number;
+    lastUsedAt: number;
+    viewport: BrowserViewport;
+}
+export interface BrowserElementSelection {
+    browserSessionId: string;
+    url: string;
+    title: string;
+    selector: string;
+    xpath: string;
+    role?: string;
+    ariaLabel?: string;
+    tag: string;
+    text?: string;
+    htmlSnippet: string;
+    rect: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+    viewport: BrowserViewport;
+    screenshotUrl?: string;
+}
+export interface DomTreeNode {
+    tag: string;
+    attrs: Record<string, string>;
+    text?: string;
+    rect: {
+        x: number;
+        y: number;
+        w: number;
+        h: number;
+    };
+    childCount: number;
+    children?: DomTreeNode[];
+}
+interface CreateBrowserSessionOptions {
+    url?: string;
+    viewport?: Partial<BrowserViewport>;
+}
+export declare class BrowserRuntime {
+    private browser;
+    private sessions;
+    private cleanupTimer;
+    constructor();
+    createSession(options?: CreateBrowserSessionOptions): Promise<BrowserSessionSummary>;
+    checkHealth(options?: {
+        launch?: boolean;
+    }): Promise<BrowserHealth>;
+    listSessions(): BrowserSessionSummary[];
+    navigate(id: string, url: string): Promise<BrowserSessionSummary>;
+    /**
+     * 调整 session 视口尺寸，使其匹配前端预览区的实际宽高比，
+     * 避免 object-fit: contain 产生大面积留边（画面显示太小）。
+     * 入参经 toViewport 夹紧到 [360..1920] x [320..1400]。
+     */
+    resizeViewport(id: string, input: Partial<BrowserViewport>): Promise<BrowserViewport>;
+    screenshot(id: string): Promise<Buffer>;
+    inspect(id: string, point: {
+        x: number;
+        y: number;
+    }): Promise<BrowserElementSelection>;
+    buildComment(input: {
+        selection: BrowserElementSelection;
+        comment: string;
+        intent?: string;
+    }): {
+        type: string;
+        prompt: string;
+        context: {
+            type: string;
+            intent: string;
+            comment: string;
+            selection: BrowserElementSelection;
+        };
+    };
+    /** 获取页面信息 */ /** 获取 session 的 page 对象（供 screencast 等内部模块使用） */
+    getPage(id: string): Page | undefined;
+    getPageInfo(id: string): Promise<{
+        url: string;
+        title: string;
+    }>;
+    /** 坐标点击：模拟真实用户点击 */
+    click(id: string, point: {
+        x: number;
+        y: number;
+    }): Promise<{
+        ok: true;
+        url: string;
+        title: string;
+    }>;
+    /** 选择器点击 */
+    clickSelector(id: string, selector: string): Promise<{
+        ok: true;
+        url: string;
+        title: string;
+    }>;
+    /** 填充输入框 */
+    fill(id: string, selector: string, value: string): Promise<{
+        ok: true;
+    }>;
+    /** 在当前焦点元素输入文字 */
+    type(id: string, text: string): Promise<{
+        ok: true;
+    }>;
+    /** 按键 */
+    press(id: string, key: string): Promise<{
+        ok: true;
+    }>;
+    /** 在指定坐标的元素上输入文字 */
+    typeAt(id: string, x: number, y: number, text: string): Promise<{
+        ok: true;
+    }>;
+    /** 聚焦并清空输入框 */
+    focusAndClear(id: string, selector: string): Promise<{
+        ok: true;
+    }>;
+    /** 滚动页面 */
+    scroll(id: string, delta: {
+        x?: number;
+        y?: number;
+    }): Promise<{
+        ok: true;
+        scrollX: number;
+        scrollY: number;
+    }>;
+    /** 执行 JavaScript */
+    evalJs<T = unknown>(id: string, script: string): Promise<{
+        ok: true;
+        result: T;
+    }>;
+    /** 获取页面 HTML */
+    getHtml(id: string): Promise<{
+        html: string;
+        url: string;
+        title: string;
+    }>;
+    /** 设置页面 HTML（直接修改页面内容） */
+    setHtml(id: string, html: string): Promise<{
+        ok: true;
+        url: string;
+        title: string;
+    }>;
+    /** 获取简化 DOM 树（用于文件画布联动） */
+    getDomTree(id: string, maxDepth?: number): Promise<DomTreeNode>;
+    /** 按选择器修改元素 HTML（评论直接改 HTML 的底层实现） */
+    patchElement(id: string, selector: string, patch: {
+        html?: string;
+        text?: string;
+        style?: string;
+        attr?: Record<string, string>;
+        remove?: boolean;
+    }): Promise<{
+        ok: true;
+        applied: boolean;
+    }>;
+    closeSession(id: string): Promise<boolean>;
+    destroy(): Promise<void>;
+    private getBrowser;
+    private getSession;
+    private summary;
+    private enforceSessionLimit;
+    private cleanupIdle;
+}
+export {};
+//# sourceMappingURL=BrowserRuntime.d.ts.map

package/dist/core/BrowserRuntime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BrowserRuntime.d.ts","sourceRoot":"","sources":["../../src/core/BrowserRuntime.ts"],"names":[],"mappings":"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"}

package/dist/core/BrowserRuntime.js

@@ -0,0 +1,487 @@
+import { checkBrowserHealth, launchManagedChromium } from './BrowserProvider.js';
+const DEFAULT_VIEWPORT = {
+    width: 1280,
+    height: 820,
+    // 高分屏下用 2x 设备像素采样，screencast 位图按物理像素渲染，
+    // canvas 以 CSS 尺寸显示时由浏览器降采样，画面清晰不糊。
+    deviceScaleFactor: 2,
+};
+const MAX_SESSIONS = 3;
+const IDLE_TTL_MS = 25 * 60_000;
+function normalizeUrl(raw) {
+    const trimmed = raw.trim();
+    if (!trimmed)
+        return 'about:blank';
+    const withProtocol = /^[a-zA-Z][a-zA-Z\d+.-]*:/.test(trimmed) ? trimmed : `http://${trimmed}`;
+    const url = new URL(withProtocol);
+    if (url.protocol !== 'http:' && url.protocol !== 'https:' && url.protocol !== 'about:') {
+        throw new Error('Only http/https URLs are supported by the browser workbench');
+    }
+    return url.toString();
+}
+function toViewport(input) {
+    const width = Math.min(1920, Math.max(360, Math.round(input?.width ?? DEFAULT_VIEWPORT.width)));
+    const height = Math.min(1400, Math.max(320, Math.round(input?.height ?? DEFAULT_VIEWPORT.height)));
+    const deviceScaleFactor = Math.min(3, Math.max(1, Number(input?.deviceScaleFactor ?? DEFAULT_VIEWPORT.deviceScaleFactor)));
+    return { width, height, deviceScaleFactor };
+}
+function buildElementCommentPrompt(input) {
+    const { selection, comment } = input;
+    const intent = input.intent || 'fix';
+    return [
+        '用户在浏览器工作台选中了一个页面元素并留下评论，请结合代码实现处理。',
+        '',
+        `意图: ${intent}`,
+        `URL: ${selection.url}`,
+        `Title: ${selection.title || 'unknown'}`,
+        `Selector: ${selection.selector}`,
+        `XPath: ${selection.xpath}`,
+        `Tag: ${selection.tag}`,
+        selection.role ? `Role: ${selection.role}` : '',
+        selection.ariaLabel ? `ARIA Label: ${selection.ariaLabel}` : '',
+        selection.text ? `Text: ${selection.text}` : '',
+        `Rect: x=${Math.round(selection.rect.x)}, y=${Math.round(selection.rect.y)}, width=${Math.round(selection.rect.width)}, height=${Math.round(selection.rect.height)}`,
+        '',
+        'HTML Snippet:',
+        selection.htmlSnippet,
+        '',
+        '用户评论:',
+        comment.trim(),
+    ].filter(Boolean).join('\n');
+}
+export class BrowserRuntime {
+    browser = null;
+    sessions = new Map();
+    cleanupTimer = null;
+    constructor() {
+        this.cleanupTimer = setInterval(() => void this.cleanupIdle(), 5 * 60_000);
+        this.cleanupTimer.unref?.();
+    }
+    async createSession(options = {}) {
+        await this.enforceSessionLimit();
+        const browser = await this.getBrowser();
+        const viewport = toViewport(options.viewport);
+        const context = await browser.newContext({
+            viewport: { width: viewport.width, height: viewport.height },
+            deviceScaleFactor: viewport.deviceScaleFactor,
+            ignoreHTTPSErrors: true,
+        });
+        const page = await context.newPage();
+        const id = `browser-${Date.now()}-${Math.random().toString(36).slice(2, 10)}`;
+        const session = {
+            id,
+            context,
+            page,
+            url: 'about:blank',
+            title: '',
+            createdAt: Date.now(),
+            lastUsedAt: Date.now(),
+            viewport,
+        };
+        this.sessions.set(id, session);
+        if (options.url) {
+            await this.navigate(id, options.url);
+        }
+        return this.summary(session);
+    }
+    async checkHealth(options) {
+        return checkBrowserHealth(options);
+    }
+    listSessions() {
+        return Array.from(this.sessions.values()).map((session) => this.summary(session));
+    }
+    async navigate(id, url) {
+        const session = this.getSession(id);
+        const normalized = normalizeUrl(url);
+        session.lastUsedAt = Date.now();
+        if (normalized !== 'about:blank') {
+            await session.page.goto(normalized, { waitUntil: 'domcontentloaded', timeout: 20_000 });
+            await session.page.waitForLoadState('networkidle', { timeout: 4_000 }).catch(() => { });
+        }
+        session.url = session.page.url();
+        session.title = await session.page.title().catch(() => '');
+        return this.summary(session);
+    }
+    /**
+     * 调整 session 视口尺寸，使其匹配前端预览区的实际宽高比，
+     * 避免 object-fit: contain 产生大面积留边（画面显示太小）。
+     * 入参经 toViewport 夹紧到 [360..1920] x [320..1400]。
+     */
+    async resizeViewport(id, input) {
+        const session = this.getSession(id);
+        session.lastUsedAt = Date.now();
+        const next = toViewport({ ...session.viewport, ...input });
+        // 尺寸无变化时跳过，避免无谓重排
+        if (next.width === session.viewport.width && next.height === session.viewport.height) {
+            return session.viewport;
+        }
+        await session.page.setViewportSize({ width: next.width, height: next.height });
+        session.viewport = next;
+        return next;
+    }
+    async screenshot(id) {
+        const session = this.getSession(id);
+        session.lastUsedAt = Date.now();
+        return session.page.screenshot({
+            type: 'png',
+            fullPage: false,
+            animations: 'disabled',
+        });
+    }
+    async inspect(id, point) {
+        const session = this.getSession(id);
+        session.lastUsedAt = Date.now();
+        const x = Math.max(0, Math.min(session.viewport.width - 1, Math.round(point.x)));
+        const y = Math.max(0, Math.min(session.viewport.height - 1, Math.round(point.y)));
+        const result = await session.page.evaluate(({ x: pageX, y: pageY }) => {
+            const target = document.elementFromPoint(pageX, pageY);
+            if (!target || !(target instanceof Element))
+                return null;
+            const esc = (value) => {
+                const css = window.CSS;
+                if (css?.escape)
+                    return css.escape(value);
+                return value.replace(/[^a-zA-Z0-9_-]/g, (char) => `\\${char}`);
+            };
+            const stableAttr = (el) => {
+                const attrs = ['data-testid', 'data-test', 'data-cy', 'aria-label', 'name', 'title'];
+                for (const attr of attrs) {
+                    const value = el.getAttribute(attr);
+                    if (value && value.trim())
+                        return `[${attr}="${value.replace(/"/g, '\\"')}"]`;
+                }
+                return null;
+            };
+            const selectorFor = (el) => {
+                if (el.id)
+                    return `#${esc(el.id)}`;
+                const attr = stableAttr(el);
+                if (attr)
+                    return `${el.tagName.toLowerCase()}${attr}`;
+                const parts = [];
+                let current = el;
+                while (current && current.nodeType === Node.ELEMENT_NODE && parts.length < 6) {
+                    const tag = current.tagName.toLowerCase();
+                    if (current.id) {
+                        parts.unshift(`#${esc(current.id)}`);
+                        break;
+                    }
+                    const currentAttr = stableAttr(current);
+                    if (currentAttr) {
+                        parts.unshift(`${tag}${currentAttr}`);
+                        break;
+                    }
+                    let sameTagIndex = 1;
+                    let sibling = current.previousElementSibling;
+                    while (sibling) {
+                        if (sibling.tagName === current.tagName)
+                            sameTagIndex++;
+                        sibling = sibling.previousElementSibling;
+                    }
+                    const className = typeof current.getAttribute('class') === 'string'
+                        ? current.getAttribute('class').split(/\s+/).filter(Boolean).slice(0, 2).map(esc).join('.')
+                        : '';
+                    parts.unshift(`${tag}${className ? `.${className}` : ''}:nth-of-type(${sameTagIndex})`);
+                    current = current.parentElement;
+                }
+                return parts.join(' > ');
+            };
+            const xpathFor = (el) => {
+                const parts = [];
+                let current = el;
+                while (current && current.nodeType === Node.ELEMENT_NODE) {
+                    let index = 1;
+                    let sibling = current.previousElementSibling;
+                    while (sibling) {
+                        if (sibling.tagName === current.tagName)
+                            index++;
+                        sibling = sibling.previousElementSibling;
+                    }
+                    parts.unshift(`${current.tagName.toLowerCase()}[${index}]`);
+                    current = current.parentElement;
+                }
+                return `/${parts.join('/')}`;
+            };
+            const rect = target.getBoundingClientRect();
+            const role = target.getAttribute('role') || undefined;
+            const ariaLabel = target.getAttribute('aria-label') || undefined;
+            const text = (target.textContent || '').replace(/\s+/g, ' ').trim().slice(0, 500) || undefined;
+            const htmlSnippet = target.outerHTML.replace(/\s+/g, ' ').trim().slice(0, 1800);
+            return {
+                selector: selectorFor(target),
+                xpath: xpathFor(target),
+                role,
+                ariaLabel,
+                tag: target.tagName.toLowerCase(),
+                text,
+                htmlSnippet,
+                rect: {
+                    x: rect.x,
+                    y: rect.y,
+                    width: rect.width,
+                    height: rect.height,
+                },
+                viewport: {
+                    width: window.innerWidth,
+                    height: window.innerHeight,
+                    deviceScaleFactor: window.devicePixelRatio || 1,
+                },
+                url: window.location.href,
+                title: document.title,
+            };
+        }, { x, y });
+        if (!result) {
+            throw new Error('No element found at that point');
+        }
+        const selection = {
+            browserSessionId: id,
+            url: result.url,
+            title: result.title,
+            selector: result.selector,
+            xpath: result.xpath,
+            role: result.role,
+            ariaLabel: result.ariaLabel,
+            tag: result.tag,
+            text: result.text,
+            htmlSnippet: result.htmlSnippet,
+            rect: result.rect,
+            viewport: result.viewport,
+        };
+        session.url = result.url;
+        session.title = result.title;
+        session.viewport = result.viewport;
+        return selection;
+    }
+    buildComment(input) {
+        return {
+            type: 'browser_element_comment',
+            prompt: buildElementCommentPrompt(input),
+            context: {
+                type: 'browser_element_comment',
+                intent: input.intent || 'fix',
+                comment: input.comment.trim(),
+                selection: input.selection,
+            },
+        };
+    }
+    // ============================================================
+    // v1.0.5 剑阁大改：真实交互能力
+    // ============================================================
+    /** 获取页面信息 */ /** 获取 session 的 page 对象（供 screencast 等内部模块使用） */
+    getPage(id) {
+        return this.sessions.get(id)?.page;
+    }
+    async getPageInfo(id) {
+        const session = this.getSession(id);
+        session.lastUsedAt = Date.now();
+        return { url: session.page.url(), title: await session.page.title().catch(() => '') };
+    }
+    /** 坐标点击：模拟真实用户点击 */
+    async click(id, point) {
+        const session = this.getSession(id);
+        session.lastUsedAt = Date.now();
+        const x = Math.max(0, Math.round(point.x));
+        const y = Math.max(0, Math.round(point.y));
+        await session.page.mouse.click(x, y);
+        await session.page.waitForLoadState('domcontentloaded', { timeout: 3_000 }).catch(() => { });
+        session.url = session.page.url();
+        session.title = await session.page.title().catch(() => '');
+        return { ok: true, url: session.url, title: session.title };
+    }
+    /** 选择器点击 */
+    async clickSelector(id, selector) {
+        const session = this.getSession(id);
+        session.lastUsedAt = Date.now();
+        await session.page.click(selector, { timeout: 5_000 });
+        await session.page.waitForLoadState('domcontentloaded', { timeout: 3_000 }).catch(() => { });
+        session.url = session.page.url();
+        session.title = await session.page.title().catch(() => '');
+        return { ok: true, url: session.url, title: session.title };
+    }
+    /** 填充输入框 */
+    async fill(id, selector, value) {
+        const session = this.getSession(id);
+        session.lastUsedAt = Date.now();
+        await session.page.fill(selector, value, { timeout: 5_000 });
+        return { ok: true };
+    }
+    /** 在当前焦点元素输入文字 */
+    async type(id, text) {
+        const session = this.getSession(id);
+        session.lastUsedAt = Date.now();
+        await session.page.keyboard.type(text, { delay: 10 });
+        return { ok: true };
+    }
+    /** 按键 */
+    async press(id, key) {
+        const session = this.getSession(id);
+        session.lastUsedAt = Date.now();
+        await session.page.keyboard.press(key);
+        return { ok: true };
+    }
+    /** 在指定坐标的元素上输入文字 */
+    async typeAt(id, x, y, text) {
+        const session = this.getSession(id);
+        session.lastUsedAt = Date.now();
+        await session.page.mouse.click(Math.max(0, Math.round(x)), Math.max(0, Math.round(y)));
+        await session.page.keyboard.type(text, { delay: 10 });
+        return { ok: true };
+    }
+    /** 聚焦并清空输入框 */
+    async focusAndClear(id, selector) {
+        const session = this.getSession(id);
+        session.lastUsedAt = Date.now();
+        await session.page.focus(selector, { timeout: 5_000 });
+        await session.page.keyboard.press('Control+a');
+        await session.page.keyboard.press('Delete');
+        return { ok: true };
+    }
+    /** 滚动页面 */
+    async scroll(id, delta) {
+        const session = this.getSession(id);
+        session.lastUsedAt = Date.now();
+        const dx = Math.round(delta.x ?? 0);
+        const dy = Math.round(delta.y ?? 0);
+        await session.page.mouse.wheel(dx, dy);
+        const pos = await session.page.evaluate(() => ({ x: window.scrollX, y: window.scrollY }));
+        return { ok: true, scrollX: pos.x, scrollY: pos.y };
+    }
+    /** 执行 JavaScript */
+    async evalJs(id, script) {
+        const session = this.getSession(id);
+        session.lastUsedAt = Date.now();
+        const result = await session.page.evaluate(script);
+        session.url = session.page.url();
+        session.title = await session.page.title().catch(() => '');
+        return { ok: true, result };
+    }
+    /** 获取页面 HTML */
+    async getHtml(id) {
+        const session = this.getSession(id);
+        session.lastUsedAt = Date.now();
+        const html = await session.page.content();
+        return { html, url: session.page.url(), title: await session.page.title().catch(() => '') };
+    }
+    /** 设置页面 HTML（直接修改页面内容） */
+    async setHtml(id, html) {
+        const session = this.getSession(id);
+        session.lastUsedAt = Date.now();
+        await session.page.setContent(html, { waitUntil: 'domcontentloaded', timeout: 10_000 });
+        session.url = session.page.url();
+        session.title = await session.page.title().catch(() => '');
+        return { ok: true, url: session.url, title: session.title };
+    }
+    /** 获取简化 DOM 树（用于文件画布联动） */
+    async getDomTree(id, maxDepth = 5) {
+        const session = this.getSession(id);
+        session.lastUsedAt = Date.now();
+        const tree = await session.page.evaluate((depth) => {
+            function buildNode(el, currentDepth, maxDepth) {
+                const tag = el.tagName.toLowerCase();
+                const rect = el.getBoundingClientRect();
+                const attrs = {};
+                for (const attr of Array.from(el.attributes)) {
+                    attrs[attr.name] = attr.value.slice(0, 200);
+                }
+                const text = (el.textContent || '').replace(/\s+/g, ' ').trim().slice(0, 100);
+                const node = {
+                    tag,
+                    attrs,
+                    text: text || undefined,
+                    rect: { x: Math.round(rect.x), y: Math.round(rect.y), w: Math.round(rect.width), h: Math.round(rect.height) },
+                    childCount: el.children.length,
+                };
+                if (currentDepth < maxDepth && el.children.length > 0 && el.children.length <= 50) {
+                    node.children = Array.from(el.children).slice(0, 30).map(c => buildNode(c, currentDepth + 1, maxDepth)).filter(Boolean);
+                }
+                return node;
+            }
+            return buildNode(document.documentElement, 0, depth);
+        }, maxDepth);
+        return tree;
+    }
+    /** 按选择器修改元素 HTML（评论直接改 HTML 的底层实现） */
+    async patchElement(id, selector, patch) {
+        const session = this.getSession(id);
+        session.lastUsedAt = Date.now();
+        const applied = await session.page.evaluate(({ sel, p }) => {
+            const el = document.querySelector(sel);
+            if (!el)
+                return false;
+            if (p.remove) {
+                el.remove();
+                return true;
+            }
+            if (p.html !== undefined)
+                el.innerHTML = p.html;
+            if (p.text !== undefined)
+                el.textContent = p.text;
+            if (p.style !== undefined)
+                el.setAttribute('style', p.style);
+            if (p.attr) {
+                for (const [k, v] of Object.entries(p.attr))
+                    el.setAttribute(k, v);
+            }
+            return true;
+        }, { sel: selector, p: patch });
+        return { ok: true, applied };
+    }
+    async closeSession(id) {
+        const session = this.sessions.get(id);
+        if (!session)
+            return false;
+        this.sessions.delete(id);
+        await session.context.close().catch(() => { });
+        return true;
+    }
+    async destroy() {
+        if (this.cleanupTimer) {
+            clearInterval(this.cleanupTimer);
+            this.cleanupTimer = null;
+        }
+        const sessions = Array.from(this.sessions.keys());
+        await Promise.all(sessions.map((id) => this.closeSession(id)));
+        if (this.browser) {
+            await this.browser.close().catch(() => { });
+            this.browser = null;
+        }
+    }
+    async getBrowser() {
+        if (this.browser && this.browser.isConnected())
+            return this.browser;
+        const launched = await launchManagedChromium();
+        this.browser = launched.browser;
+        return this.browser;
+    }
+    getSession(id) {
+        const session = this.sessions.get(id);
+        if (!session)
+            throw new Error(`Browser session not found: ${id}`);
+        return session;
+    }
+    summary(session) {
+        return {
+            id: session.id,
+            url: session.url,
+            title: session.title,
+            createdAt: session.createdAt,
+            lastUsedAt: session.lastUsedAt,
+            viewport: session.viewport,
+        };
+    }
+    async enforceSessionLimit() {
+        if (this.sessions.size < MAX_SESSIONS)
+            return;
+        const oldest = Array.from(this.sessions.values()).sort((a, b) => a.lastUsedAt - b.lastUsedAt)[0];
+        if (oldest)
+            await this.closeSession(oldest.id);
+    }
+    async cleanupIdle() {
+        const now = Date.now();
+        const stale = Array.from(this.sessions.values())
+            .filter((session) => now - session.lastUsedAt > IDLE_TTL_MS)
+            .map((session) => session.id);
+        await Promise.all(stale.map((id) => this.closeSession(id)));
+    }
+}
+//# sourceMappingURL=BrowserRuntime.js.map