publishport-opencli 1.8.5-pp.2 → 1.8.5-pp.21

package/dist/src/browser/page.js

@@ -1,453 +1,15 @@
-/**
- * Page abstraction — implements IPage by sending commands to the daemon.
- *
- * All browser operations are ultimately 'exec' (JS evaluation via CDP)
- * plus a few native Chrome Extension APIs (tabs, cookies, navigate).
- *
- * IMPORTANT: After goto(), we remember the page identity (targetId) returned
- * by the navigate action and pass it to all subsequent commands. This ensures
- * page-scoped operations target the correct page without guessing.
- */
-import { sendCommand, sendCommandFull } from './daemon-client.js';
-import { buildEvaluateExpression } from './utils.js';
-import { saveBase64ToFile } from '../utils.js';
-import { generateStealthJs } from './stealth.js';
-import { waitForDomStableJs } from './dom-helpers.js';
-import { BasePage } from './base-page.js';
-import { classifyBrowserError } from './errors.js';
-import { log } from '../logger.js';
-function isUnsupportedNetworkCaptureError(err) {
-    const message = err instanceof Error ? err.message : String(err);
-    const normalized = message.toLowerCase();
-    return (normalized.includes('unknown action') && normalized.includes('network-capture'))
-        || (normalized.includes('network capture') && normalized.includes('not supported'));
-}
-// The extension throws "Page not found: <id> — stale page identity" when our cached
-// `_page` targetId no longer maps to a live tab — e.g. the user closed the automation
-// window, or a long-running script left the cache pointing at an evicted target.
-// Detect that signature so goto() can drop the stale id and let resolveTab fall back
-// to the session lease (or create a fresh tab).
-function isStalePageIdentityError(err) {
-    const message = err instanceof Error ? err.message : String(err);
-    return message.includes('stale page identity') || /^Page not found:\s*\S+\s*$/.test(message);
-}
-/**
- * Page — implements IPage by talking to the daemon via HTTP.
- */
-export class Page extends BasePage {
-    session;
-    contextId;
-    windowMode;
-    surface;
-    siteSession;
-    _idleTimeout;
-    constructor(session, idleTimeout, contextId, windowMode, surface = 'browser', siteSession) {
-        super();
-        this.session = session;
-        this.contextId = contextId;
-        this.windowMode = windowMode;
-        this.surface = surface;
-        this.siteSession = siteSession;
-        this._idleTimeout = idleTimeout;
-    }
-    /** Active page identity (targetId), set after navigate and used in all subsequent commands */
-    _page;
-    _networkCaptureUnsupported = false;
-    _networkCaptureWarned = false;
-    /** Helper: spread session into command params */
-    _sessionOpts() {
-        return {
-            session: this.session,
-            surface: this.surface,
-            ...(this.contextId && { contextId: this.contextId }),
-            ...(this._idleTimeout != null && { idleTimeout: this._idleTimeout }),
-            ...(this.windowMode && { windowMode: this.windowMode }),
-            ...(this.siteSession && { siteSession: this.siteSession }),
-        };
-    }
-    /** Helper: spread session + page identity into command params */
-    _cmdOpts() {
-        return {
-            session: this.session,
-            surface: this.surface,
-            ...(this.contextId && { contextId: this.contextId }),
-            ...(this._page !== undefined && { page: this._page }),
-            ...(this._idleTimeout != null && { idleTimeout: this._idleTimeout }),
-            ...(this.windowMode && { windowMode: this.windowMode }),
-            ...(this.siteSession && { siteSession: this.siteSession }),
-        };
-    }
-    async goto(url, options) {
-        let result;
-        try {
-            result = await sendCommandFull('navigate', {
-                url,
-                ...this._cmdOpts(),
-            });
-        }
-        catch (err) {
-            // If our cached targetId went stale (tab closed externally, identity evicted),
-            // drop the dead id and retry without it — the extension will resolve through the
-            // session lease or open a fresh automation tab. Without this, every subsequent
-            // adapter call in the same process keeps re-sending the same dead targetId and
-            // cascades into "Page not found:" failures across concurrent calls.
-            if (!isStalePageIdentityError(err) || this._page === undefined)
-                throw err;
-            this._page = undefined;
-            result = await sendCommandFull('navigate', {
-                url,
-                ...this._cmdOpts(),
-            });
-        }
-        // Remember the page identity (targetId) for subsequent calls
-        if (result.page) {
-            this._page = result.page;
-        }
-        this._lastUrl = url;
-        // Inject stealth + settle in a single round-trip instead of two sequential exec calls.
-        // The stealth guard flag prevents double-injection; settle uses DOM stability detection.
-        if (options?.waitUntil !== 'none') {
-            const maxMs = options?.settleMs ?? 1000;
-            const combinedCode = `${generateStealthJs()};\n${waitForDomStableJs(maxMs, Math.min(500, maxMs))}`;
-            const combinedOpts = {
-                code: combinedCode,
-                ...this._cmdOpts(),
-            };
-            try {
-                await sendCommand('exec', combinedOpts);
-            }
-            catch (err) {
-                const advice = classifyBrowserError(err);
-                // Only settle-retry on target navigation (SPA client-side redirects).
-                // Extension/daemon errors are already retried by sendCommandRaw —
-                // retrying them here would silently swallow real failures.
-                if (advice.kind !== 'target-navigation')
-                    throw err;
-                try {
-                    await new Promise((r) => setTimeout(r, advice.delayMs));
-                    await sendCommand('exec', combinedOpts);
-                }
-                catch (retryErr) {
-                    if (classifyBrowserError(retryErr).kind !== 'target-navigation')
-                        throw retryErr;
-                }
-            }
-        }
-        else {
-            // Even with waitUntil='none', still inject stealth (best-effort)
-            try {
-                await sendCommand('exec', {
-                    code: generateStealthJs(),
-                    ...this._cmdOpts(),
-                });
-            }
-            catch {
-                // Non-fatal: stealth is best-effort
-            }
-        }
-    }
-    /** Get the active page identity (targetId) */
-    getActivePage() {
-        return this._page;
-    }
-    /** Bind this Page instance to a specific page identity (targetId). */
-    setActivePage(page) {
-        this._page = page;
-        this._lastUrl = null;
-    }
-    _markUnsupportedNetworkCapture() {
-        this._networkCaptureUnsupported = true;
-        if (this._networkCaptureWarned)
-            return;
-        this._networkCaptureWarned = true;
-        log.warn('Browser Bridge extension does not support network capture; continuing without it. ' +
-            'Explore output may miss API endpoints until you reload or reinstall the extension.');
-    }
-    async evaluate(input, ...args) {
-        const code = buildEvaluateExpression(input, args);
-        try {
-            return await sendCommand('exec', { code, ...this._cmdOpts() });
-        }
-        catch (err) {
-            const advice = classifyBrowserError(err);
-            if (advice.kind !== 'target-navigation')
-                throw err;
-            await new Promise((resolve) => setTimeout(resolve, advice.delayMs));
-            return sendCommand('exec', { code, ...this._cmdOpts() });
-        }
-    }
-    async getCookies(opts = {}) {
-        const result = await sendCommand('cookies', { ...this._sessionOpts(), ...opts });
-        return Array.isArray(result) ? result : [];
-    }
-    /** Release the current browser session lease in the extension */
-    async closeWindow() {
-        try {
-            await sendCommand('close-window', { ...this._sessionOpts() });
-        }
-        catch {
-            // Window may already be closed or daemon may be down
-        }
-        finally {
-            this._page = undefined;
-            this._lastUrl = null;
-            this._networkCaptureUnsupported = false;
-            this._networkCaptureWarned = false;
-        }
-    }
-    async tabs() {
-        const result = await sendCommand('tabs', { op: 'list', ...this._sessionOpts() });
-        return Array.isArray(result) ? result : [];
-    }
-    async newTab(url) {
-        const result = await sendCommandFull('tabs', {
-            op: 'new',
-            ...(url !== undefined && { url }),
-            ...this._sessionOpts(),
-        });
-        this._lastUrl = null;
-        return result.page;
-    }
-    async closeTab(target) {
-        const params = { op: 'close', ...this._sessionOpts() };
-        if (typeof target === 'number')
-            params.index = target;
-        else if (typeof target === 'string')
-            params.page = target;
-        else if (this._page !== undefined)
-            params.page = this._page;
-        const result = await sendCommand('tabs', params);
-        const closedPage = typeof result?.closed === 'string' ? result.closed : undefined;
-        if ((closedPage && closedPage === this._page) || (!closedPage && (target === undefined || target === this._page))) {
-            this._page = undefined;
-            this._lastUrl = null;
-        }
-    }
-    async selectTab(target) {
-        const result = await sendCommandFull('tabs', {
-            op: 'select',
-            ...(typeof target === 'number' ? { index: target } : { page: target }),
-            ...this._sessionOpts(),
-        });
-        if (result.page)
-            this._page = result.page;
-        this._lastUrl = null;
-    }
-    /**
-     * Capture a screenshot via CDP Page.captureScreenshot.
-     */
-    async screenshot(options = {}) {
-        const base64 = await sendCommand('screenshot', {
-            ...this._cmdOpts(),
-            format: options.format,
-            quality: options.quality,
-            fullPage: options.fullPage,
-            width: options.width,
-            height: options.height,
-        });
-        if (options.path) {
-            await saveBase64ToFile(base64, options.path);
-        }
-        return base64;
-    }
-    async startNetworkCapture(pattern = '') {
-        if (this._networkCaptureUnsupported)
-            return false;
-        try {
-            await sendCommand('network-capture-start', {
-                pattern,
-                ...this._cmdOpts(),
-            });
-            return true;
-        }
-        catch (err) {
-            if (!isUnsupportedNetworkCaptureError(err))
-                throw err;
-            this._markUnsupportedNetworkCapture();
-            return false;
-        }
-    }
-    async readNetworkCapture() {
-        if (this._networkCaptureUnsupported)
-            return [];
-        try {
-            const result = await sendCommand('network-capture-read', {
-                ...this._cmdOpts(),
-            });
-            return Array.isArray(result) ? result : [];
-        }
-        catch (err) {
-            if (!isUnsupportedNetworkCaptureError(err))
-                throw err;
-            this._markUnsupportedNetworkCapture();
-            return [];
-        }
-    }
-    async waitForDownload(pattern = '', timeoutMs = 30_000) {
-        const result = await sendCommand('wait-download', {
-            pattern,
-            timeoutMs,
-            ...this._cmdOpts(),
-        });
-        return result;
-    }
-    /**
-     * Set local file paths on a file input element via CDP DOM.setFileInputFiles.
-     * Chrome reads the files directly from the local filesystem, avoiding the
-     * payload size limits of base64-in-evaluate.
-     */
-    async setFileInput(files, selector) {
-        const result = await sendCommand('set-file-input', {
-            files,
-            selector,
-            ...this._cmdOpts(),
-        });
-        if (!result?.count) {
-            throw new Error('setFileInput returned no count — command may not be supported by the extension');
-        }
-    }
-    async insertText(text) {
-        const result = await sendCommand('insert-text', {
-            text,
-            ...this._cmdOpts(),
-        });
-        if (!result?.inserted) {
-            throw new Error('insertText returned no inserted flag — command may not be supported by the extension');
-        }
-    }
-    async frames() {
-        const result = await sendCommand('frames', { ...this._cmdOpts() });
-        return Array.isArray(result) ? result : [];
-    }
-    async evaluateInFrame(js, frameIndex) {
-        const code = buildEvaluateExpression(js);
-        return sendCommand('exec', { code, frameIndex, ...this._cmdOpts() });
-    }
-    async cdp(method, params = {}) {
-        return sendCommand('cdp', {
-            cdpMethod: method,
-            cdpParams: params,
-            ...this._cmdOpts(),
-        });
-    }
-    async handleJavaScriptDialog(accept, promptText) {
-        await this.cdp('Page.handleJavaScriptDialog', {
-            accept,
-            ...(promptText !== undefined && { promptText }),
-        });
-    }
-    /** CDP native click fallback — called when JS el.click() fails */
-    async tryNativeClick(x, y) {
-        try {
-            await this.nativeClick(x, y);
-            return true;
-        }
-        catch {
-            return false;
-        }
-    }
-    /** Precise click using DOM.getContentQuads/getBoxModel for inline elements */
-    async clickWithQuads(ref) {
-        const safeRef = JSON.stringify(ref);
-        const cssSelector = `[data-opencli-ref="${ref.replace(/"/g, '\\"')}"]`;
-        // Scroll element into view first
-        await this.evaluate(`
+import{sendCommand as L,sendCommandFull as Y}from"./daemon-client.js";import{buildEvaluateExpression as $}from"./utils.js";import{saveBase64ToFile as N}from"../utils.js";import{generateStealthJs as j}from"./stealth.js";import{waitForDomStableJs as O}from"./dom-helpers.js";import{BasePage as U}from"./base-page.js";import{classifyBrowserError as _}from"./errors.js";import{log as R}from"../logger.js";function J(A){const G=(A instanceof Error?A.message:String(A)).toLowerCase();return G.includes("unknown action")&&G.includes("network-capture")||G.includes("network capture")&&G.includes("not supported")}function h(A){const D=A instanceof Error?A.message:String(A);return D.includes("stale page identity")||/^Page not found:\s*\S+\s*$/.test(D)}export class Page extends U{session;contextId;windowMode;surface;siteSession;_idleTimeout;constructor(A,D,G,H,V="browser",Q){super();this.session=A;this.contextId=G;this.windowMode=H;this.surface=V;this.siteSession=Q;this._idleTimeout=D}_page;_networkCaptureUnsupported=!1;_networkCaptureWarned=!1;_sessionOpts(){return{session:this.session,surface:this.surface,...this.contextId&&{contextId:this.contextId},...this._idleTimeout!=null&&{idleTimeout:this._idleTimeout},...this.windowMode&&{windowMode:this.windowMode},...this.siteSession&&{siteSession:this.siteSession}}}_cmdOpts(){return{session:this.session,surface:this.surface,...this.contextId&&{contextId:this.contextId},...this._page!==void 0&&{page:this._page},...this._idleTimeout!=null&&{idleTimeout:this._idleTimeout},...this.windowMode&&{windowMode:this.windowMode},...this.siteSession&&{siteSession:this.siteSession}}}async goto(A,D){let G;try{G=await Y("navigate",{url:A,...this._cmdOpts()})}catch(H){if(!h(H)||this._page===void 0)throw H;this._page=void 0;G=await Y("navigate",{url:A,...this._cmdOpts()})}if(G.page)this._page=G.page;this._lastUrl=A;if(D?.waitUntil!=="none"){const H=D?.settleMs??1000,Q={code:`${j()};
+${O(H,Math.min(500,H))}`,...this._cmdOpts()};try{await L("exec",Q)}catch(W){const K=_(W);if(K.kind!=="target-navigation")throw W;try{await new Promise((X)=>setTimeout(X,K.delayMs));await L("exec",Q)}catch(X){if(_(X).kind!=="target-navigation")throw X}}}else try{await L("exec",{code:j(),...this._cmdOpts()})}catch{}}getActivePage(){return this._page}setActivePage(A){this._page=A;this._lastUrl=null}_markUnsupportedNetworkCapture(){this._networkCaptureUnsupported=!0;if(this._networkCaptureWarned)return;this._networkCaptureWarned=!0;R.warn("Browser Bridge extension does not support network capture; continuing without it. Explore output may miss API endpoints until you reload or reinstall the extension.")}async evaluate(A,...D){const G=$(A,D);try{return await L("exec",{code:G,...this._cmdOpts()})}catch(H){const V=_(H);if(V.kind!=="target-navigation")throw H;await new Promise((Q)=>setTimeout(Q,V.delayMs));return L("exec",{code:G,...this._cmdOpts()})}}async getCookies(A={}){const D=await L("cookies",{...this._sessionOpts(),...A});return Array.isArray(D)?D:[]}async closeWindow(){try{await L("close-window",{...this._sessionOpts()})}catch{}finally{this._page=void 0;this._lastUrl=null;this._networkCaptureUnsupported=!1;this._networkCaptureWarned=!1}}async tabs(){const A=await L("tabs",{op:"list",...this._sessionOpts()});return Array.isArray(A)?A:[]}async newTab(A){const D=await Y("tabs",{op:"new",...A!==void 0&&{url:A},...this._sessionOpts()});this._lastUrl=null;return D.page}async closeTab(A){const D={op:"close",...this._sessionOpts()};if(typeof A==="number")D.index=A;else if(typeof A==="string")D.page=A;else if(this._page!==void 0)D.page=this._page;const G=await L("tabs",D),H=typeof G?.closed==="string"?G.closed:void 0;if(H&&H===this._page||!H&&(A===void 0||A===this._page)){this._page=void 0;this._lastUrl=null}}async selectTab(A){const D=await Y("tabs",{op:"select",...typeof A==="number"?{index:A}:{page:A},...this._sessionOpts()});if(D.page)this._page=D.page;this._lastUrl=null}async screenshot(A={}){const D=await L("screenshot",{...this._cmdOpts(),format:A.format,quality:A.quality,fullPage:A.fullPage,width:A.width,height:A.height});if(A.path)await N(D,A.path);return D}async startNetworkCapture(A=""){if(this._networkCaptureUnsupported)return!1;try{await L("network-capture-start",{pattern:A,...this._cmdOpts()});return!0}catch(D){if(!J(D))throw D;this._markUnsupportedNetworkCapture();return!1}}async readNetworkCapture(){if(this._networkCaptureUnsupported)return[];try{const A=await L("network-capture-read",{...this._cmdOpts()});return Array.isArray(A)?A:[]}catch(A){if(!J(A))throw A;this._markUnsupportedNetworkCapture();return[]}}async waitForDownload(A="",D=30000){return await L("wait-download",{pattern:A,timeoutMs:D,...this._cmdOpts()})}async setFileInput(A,D){if(!(await L("set-file-input",{files:A,selector:D,...this._cmdOpts()}))?.count)throw Error("setFileInput returned no count — command may not be supported by the extension")}async insertText(A){if(!(await L("insert-text",{text:A,...this._cmdOpts()}))?.inserted)throw Error("insertText returned no inserted flag — command may not be supported by the extension")}async frames(){const A=await L("frames",{...this._cmdOpts()});return Array.isArray(A)?A:[]}async evaluateInFrame(A,D){const G=$(A);return L("exec",{code:G,frameIndex:D,...this._cmdOpts()})}async cdp(A,D={}){return L("cdp",{cdpMethod:A,cdpParams:D,...this._cmdOpts()})}async handleJavaScriptDialog(A,D){await this.cdp("Page.handleJavaScriptDialog",{accept:A,...D!==void 0&&{promptText:D}})}async tryNativeClick(A,D){try{await this.nativeClick(A,D);return!0}catch{return!1}}async clickWithQuads(A){const D=JSON.stringify(A),G=`[data-opencli-ref="${A.replace(/"/g,"\\\"")}"]`;await this.evaluate(`
       (() => {
-        const el = document.querySelector('[data-opencli-ref="' + ${safeRef} + '"]');
+        const el = document.querySelector('[data-opencli-ref="' + ${D} + '"]');
         if (el) el.scrollIntoView({ behavior: 'instant', block: 'center' });
         return !!el;
       })()
-    `);
-        try {
-            // Find DOM node via CDP
-            const doc = await this.cdp('DOM.getDocument', {});
-            const result = await this.cdp('DOM.querySelectorAll', {
-                nodeId: doc.root.nodeId,
-                selector: cssSelector,
-            });
-            if (!result.nodeIds?.length)
-                throw new Error('DOM node not found');
-            const nodeId = result.nodeIds[0];
-            // Try getContentQuads first (precise for inline elements)
-            try {
-                const quads = await this.cdp('DOM.getContentQuads', { nodeId });
-                if (quads.quads?.length) {
-                    const q = quads.quads[0];
-                    const cx = (q[0] + q[2] + q[4] + q[6]) / 4;
-                    const cy = (q[1] + q[3] + q[5] + q[7]) / 4;
-                    await this.nativeClick(Math.round(cx), Math.round(cy));
-                    return;
-                }
-            }
-            catch { /* fallthrough */ }
-            // Try getBoxModel
-            try {
-                const box = await this.cdp('DOM.getBoxModel', { nodeId });
-                if (box.model?.content) {
-                    const c = box.model.content;
-                    const cx = (c[0] + c[2] + c[4] + c[6]) / 4;
-                    const cy = (c[1] + c[3] + c[5] + c[7]) / 4;
-                    await this.nativeClick(Math.round(cx), Math.round(cy));
-                    return;
-                }
-            }
-            catch { /* fallthrough */ }
-        }
-        catch { /* fallthrough */ }
-        // Final fallback: regular click
-        await this.evaluate(`
+    `);try{const H=await this.cdp("DOM.getDocument",{}),V=await this.cdp("DOM.querySelectorAll",{nodeId:H.root.nodeId,selector:G});if(!V.nodeIds?.length)throw Error("DOM node not found");const Q=V.nodeIds[0];try{const W=await this.cdp("DOM.getContentQuads",{nodeId:Q});if(W.quads?.length){const K=W.quads[0],X=(K[0]+K[2]+K[4]+K[6])/4,Z=(K[1]+K[3]+K[5]+K[7])/4;await this.nativeClick(Math.round(X),Math.round(Z));return}}catch{}try{const W=await this.cdp("DOM.getBoxModel",{nodeId:Q});if(W.model?.content){const K=W.model.content,X=(K[0]+K[2]+K[4]+K[6])/4,Z=(K[1]+K[3]+K[5]+K[7])/4;await this.nativeClick(Math.round(X),Math.round(Z));return}}catch{}}catch{}await this.evaluate(`
       (() => {
-        const el = document.querySelector('[data-opencli-ref="' + ${safeRef} + '"]');
-        if (!el) throw new Error('Element not found: ' + ${safeRef});
+        const el = document.querySelector('[data-opencli-ref="' + ${D} + '"]');
+        if (!el) throw new Error('Element not found: ' + ${D});
         el.click();
         return 'clicked';
       })()
-    `);
-    }
-    async nativeClick(x, y) {
-        await this.cdp('Input.dispatchMouseEvent', {
-            type: 'mouseMoved',
-            x,
-            y,
-        });
-        await this.cdp('Input.dispatchMouseEvent', {
-            type: 'mousePressed',
-            x, y,
-            button: 'left',
-            clickCount: 1,
-        });
-        await this.cdp('Input.dispatchMouseEvent', {
-            type: 'mouseReleased',
-            x, y,
-            button: 'left',
-            clickCount: 1,
-        });
-    }
-    async nativeType(text) {
-        // Use Input.insertText for reliable Unicode/CJK text insertion
-        await this.cdp('Input.insertText', { text });
-    }
-    async nativeKeyPress(key, modifiers = []) {
-        let modifierFlags = 0;
-        for (const mod of modifiers) {
-            if (mod === 'Alt')
-                modifierFlags |= 1;
-            if (mod === 'Ctrl' || mod === 'Control')
-                modifierFlags |= 2;
-            if (mod === 'Meta')
-                modifierFlags |= 4;
-            if (mod === 'Shift')
-                modifierFlags |= 8;
-        }
-        await this.cdp('Input.dispatchKeyEvent', {
-            type: 'keyDown',
-            key,
-            modifiers: modifierFlags,
-        });
-        await this.cdp('Input.dispatchKeyEvent', {
-            type: 'keyUp',
-            key,
-            modifiers: modifierFlags,
-        });
-    }
-}
+    `)}async nativeClick(A,D){await this.cdp("Input.dispatchMouseEvent",{type:"mouseMoved",x:A,y:D});await this.cdp("Input.dispatchMouseEvent",{type:"mousePressed",x:A,y:D,button:"left",clickCount:1});await this.cdp("Input.dispatchMouseEvent",{type:"mouseReleased",x:A,y:D,button:"left",clickCount:1})}async nativeType(A){await this.cdp("Input.insertText",{text:A})}async nativeKeyPress(A,D=[]){let G=0;for(const H of D){if(H==="Alt")G|=1;if(H==="Ctrl"||H==="Control")G|=2;if(H==="Meta")G|=4;if(H==="Shift")G|=8}await this.cdp("Input.dispatchKeyEvent",{type:"keyDown",key:A,modifiers:G});await this.cdp("Input.dispatchKeyEvent",{type:"keyUp",key:A,modifiers:G})}}

package/dist/src/browser/profile.d.ts

@@ -1,14 +1,96 @@
 export declare const DEFAULT_CONTEXT_ID = "default";
+/** [pp-only] 每环境独立代理。auth（username/password）走生成的 helper 扩展注入，
+ *  不写进 --proxy-server flag（flag 不支持账密，且会明文出现在进程列表里）。 */
+export type ProxyConfig = {
+    scheme: 'http' | 'https' | 'socks5';
+    host: string;
+    port: number;
+    username?: string;
+    password?: string;
+};
+/** [pp-only] 每环境指纹。创建时用 seed 一次性解析并存盘——之后每次启动都必须一致，
+ *  指纹漂移本身就是最强的风控信号。字段缺省表示「不改写、用真实值」。 */
+export type FingerprintConfig = {
+    /** 关掉时整套指纹改写不生效（仍可有 proxy / 时区跟随） */
+    enabled: boolean;
+    /** 决定所有噪声/派生值的随机种子，保证跨启动一致 */
+    seed: number;
+    /** IANA 时区，如 America/New_York；走启动 TZ 环境变量注入 */
+    timezone?: string;
+    /** navigator.language(s) + Accept-Language，如 en-US */
+    locale?: string;
+    /** 覆盖 navigator.userAgent（谨慎用；真实 UA 通常已足够干净） */
+    userAgent?: string;
+    /** navigator.platform，如 Win32 / MacIntel */
+    platform?: string;
+    hardwareConcurrency?: number;
+    /** navigator.deviceMemory（GB） */
+    deviceMemory?: number;
+    screen?: {
+        width: number;
+        height: number;
+    };
+    /** WebGL UNMASKED_VENDOR/RENDERER 改写（跨账号去关联的关键项） */
+    webglVendor?: string;
+    webglRenderer?: string;
+    /** 给 Canvas/WebGL 读像素加确定性噪声，打散 canvas 指纹哈希 */
+    canvasNoise?: boolean;
+};
+export type ManagedProfileEntry = {
+    /** Chrome --user-data-dir 指向的目录（绝对路径） */
+    userDataDir: string;
+    /** 固定分配的 CDP 调试端口 */
+    port: number;
+    /** 显式指定浏览器可执行文件；缺省时自动发现 Chrome/Chromium */
+    browserPath?: string;
+    createdAt?: string;
+    /** [pp-only] 用户自定义显示名/备注（UI 展示，不影响 CLI 名字/隔离） */
+    label?: string;
+    /** [pp-only] 每环境独立代理 */
+    proxy?: ProxyConfig;
+    /** [pp-only] 每环境指纹 */
+    fingerprint?: FingerprintConfig;
+    /** [pp-only] WebRTC 防泄漏（禁用非代理 UDP，防真实 IP 泄露）。缺省 = 开。 */
+    webrtc?: boolean;
+    /** [pp-only] 精简启动（关后台遥测/组件更新/登录诱导等）。缺省 = 开。 */
+    clean?: boolean;
+};
 export type ProfileConfig = {
     version: 1;
     defaultContextId?: string;
     aliases: Record<string, string>;
+    /** [pp-only] 托管 profile 表，键为 profile 名（与 aliases 命名空间共享，不可撞名） */
+    managed?: Record<string, ManagedProfileEntry>;
+};
+/** profile 解析结果：走扩展（daemon 按 contextId 路由）还是托管 Chrome（CDP 直连） */
+export type ResolvedProfile = {
+    kind: 'extension';
+    contextId?: string;
+} | {
+    kind: 'managed';
+    name: string;
+    entry: ManagedProfileEntry;
 };
+export declare function managedProfilesBaseDir(): string;
 export declare function normalizeContextId(value: string | undefined | null): string | undefined;
 export declare function emptyProfileConfig(): ProfileConfig;
 export declare function loadProfileConfig(): ProfileConfig;
 export declare function saveProfileConfig(config: ProfileConfig): void;
+/**
+ * [pp-only] 统一 profile 解析：flag → OPENCLI_PROFILE → 配置默认，
+ * 名字命中托管表则走托管 Chrome，否则按扩展 alias/contextId 解析。
+ */
+export declare function resolveProfile(profile?: string): ResolvedProfile;
 export declare function resolveProfileContextId(profile?: string): string | undefined;
+export declare function getManagedProfile(name: string): ManagedProfileEntry | undefined;
+export declare function listManagedProfiles(): Array<{
+    name: string;
+    entry: ManagedProfileEntry;
+}>;
+export declare function addManagedProfile(name: string, entry: ManagedProfileEntry): ProfileConfig;
+/** [pp-only] 覆盖写已存在托管 profile 的配置（label/proxy/fingerprint 等），保留其 name。 */
+export declare function updateManagedProfile(name: string, entry: ManagedProfileEntry): ProfileConfig;
+export declare function removeManagedProfileEntry(name: string): ManagedProfileEntry;
 export declare function aliasForContextId(config: ProfileConfig, contextId: string): string | undefined;
 export declare function renameProfile(contextId: string, alias: string): ProfileConfig;
 export declare function setDefaultProfile(profile: string): ProfileConfig;

package/dist/src/browser/profile.js

@@ -1,85 +1,2 @@
-import * as fs from 'node:fs';
-import * as os from 'node:os';
-import * as path from 'node:path';
-export const DEFAULT_CONTEXT_ID = 'default';
-function profileConfigPath() {
-    const baseDir = process.env.OPENCLI_CONFIG_DIR || path.join(os.homedir(), '.opencli');
-    return path.join(baseDir, 'browser-profiles.json');
-}
-export function normalizeContextId(value) {
-    const trimmed = value?.trim();
-    return trimmed || undefined;
-}
-export function emptyProfileConfig() {
-    return { version: 1, aliases: {} };
-}
-export function loadProfileConfig() {
-    try {
-        const raw = fs.readFileSync(profileConfigPath(), 'utf-8');
-        const parsed = JSON.parse(raw);
-        const aliases = parsed.aliases && typeof parsed.aliases === 'object'
-            ? Object.fromEntries(Object.entries(parsed.aliases).filter((entry) => {
-                const [key, value] = entry;
-                return typeof key === 'string' && key.trim().length > 0
-                    && typeof value === 'string' && value.trim().length > 0;
-            }))
-            : {};
-        return {
-            version: 1,
-            aliases,
-            ...(typeof parsed.defaultContextId === 'string' && parsed.defaultContextId.trim()
-                ? { defaultContextId: parsed.defaultContextId.trim() }
-                : {}),
-        };
-    }
-    catch {
-        return emptyProfileConfig();
-    }
-}
-export function saveProfileConfig(config) {
-    const target = profileConfigPath();
-    fs.mkdirSync(path.dirname(target), { recursive: true });
-    fs.writeFileSync(target, JSON.stringify(config, null, 2) + '\n', 'utf-8');
-}
-export function resolveProfileContextId(profile) {
-    const config = loadProfileConfig();
-    const requested = normalizeContextId(profile)
-        ?? normalizeContextId(process.env.OPENCLI_PROFILE)
-        ?? normalizeContextId(config.defaultContextId);
-    if (!requested)
-        return undefined;
-    return config.aliases[requested] ?? requested;
-}
-export function aliasForContextId(config, contextId) {
-    for (const [alias, id] of Object.entries(config.aliases)) {
-        if (id === contextId)
-            return alias;
-    }
-    return undefined;
-}
-export function renameProfile(contextId, alias) {
-    const normalizedContextId = normalizeContextId(contextId);
-    const normalizedAlias = normalizeContextId(alias);
-    if (!normalizedContextId)
-        throw new Error('profile contextId is required');
-    if (!normalizedAlias)
-        throw new Error('profile alias is required');
-    const config = loadProfileConfig();
-    for (const [existingAlias, existingContextId] of Object.entries(config.aliases)) {
-        if (existingAlias !== normalizedAlias && existingContextId === normalizedContextId) {
-            delete config.aliases[existingAlias];
-        }
-    }
-    config.aliases[normalizedAlias] = normalizedContextId;
-    saveProfileConfig(config);
-    return config;
-}
-export function setDefaultProfile(profile) {
-    const contextId = resolveProfileContextId(profile) ?? normalizeContextId(profile);
-    if (!contextId)
-        throw new Error('profile is required');
-    const config = loadProfileConfig();
-    config.defaultContextId = contextId;
-    saveProfileConfig(config);
-    return config;
-}
+import*as Q from"node:fs";import*as S from"node:os";import*as O from"node:path";export const DEFAULT_CONTEXT_ID="default";function U(){const F=process.env.OPENCLI_CONFIG_DIR||O.join(S.homedir(),".opencli");return O.join(F,"browser-profiles.json")}export function managedProfilesBaseDir(){const F=process.env.OPENCLI_CONFIG_DIR||O.join(S.homedir(),".opencli");return O.join(F,"chrome-profiles")}export function normalizeContextId(F){return F?.trim()||void 0}export function emptyProfileConfig(){return{version:1,aliases:{}}}function V(F){return typeof F==="object"&&F!==null&&typeof F.userDataDir==="string"&&F.userDataDir.trim().length>0&&typeof F.port==="number"&&Number.isInteger(F.port)}export function loadProfileConfig(){try{const F=Q.readFileSync(U(),"utf-8"),j=JSON.parse(F),B=j.aliases&&typeof j.aliases==="object"?Object.fromEntries(Object.entries(j.aliases).filter((J)=>{const[K,L]=J;return typeof K==="string"&&K.trim().length>0&&typeof L==="string"&&L.trim().length>0})):{},H=j.managed&&typeof j.managed==="object"?Object.fromEntries(Object.entries(j.managed).filter((J)=>{const[K,L]=J;return typeof K==="string"&&K.trim().length>0&&V(L)})):void 0;return{version:1,aliases:B,...typeof j.defaultContextId==="string"&&j.defaultContextId.trim()?{defaultContextId:j.defaultContextId.trim()}:{},...H&&Object.keys(H).length>0?{managed:H}:{}}}catch{return emptyProfileConfig()}}export function saveProfileConfig(F){const j=U();Q.mkdirSync(O.dirname(j),{recursive:!0});Q.writeFileSync(j,JSON.stringify(F,null,2)+`
+`,"utf-8")}function W(F){const j=loadProfileConfig();return normalizeContextId(F)??normalizeContextId(process.env.OPENCLI_PROFILE)??normalizeContextId(j.defaultContextId)}export function resolveProfile(F){const j=loadProfileConfig(),B=W(F);if(!B)return{kind:"extension"};const H=j.managed?.[B];if(H)return{kind:"managed",name:B,entry:H};return{kind:"extension",contextId:j.aliases[B]??B}}export function resolveProfileContextId(F){const j=resolveProfile(F);if(j.kind==="managed")return;return j.contextId}export function getManagedProfile(F){return loadProfileConfig().managed?.[normalizeContextId(F)??""]}export function listManagedProfiles(){const F=loadProfileConfig().managed??{};return Object.entries(F).map(([j,B])=>({name:j,entry:B})).sort((j,B)=>j.name.localeCompare(B.name))}const X=/^[A-Za-z0-9][A-Za-z0-9_-]{0,31}$/;export function addManagedProfile(F,j){const B=normalizeContextId(F);if(!B)throw Error("profile 名不能为空");if(!X.test(B))throw Error("profile 名只能包含字母/数字/下划线/连字符，且以字母或数字开头（最长 32 字符）");const H=loadProfileConfig();if(H.managed?.[B])throw Error(`托管 profile "${B}" 已存在`);if(H.aliases[B])throw Error(`"${B}" 已被扩展 profile 别名占用，换个名字`);H.managed={...H.managed,[B]:j};saveProfileConfig(H);return H}export function updateManagedProfile(F,j){const B=normalizeContextId(F);if(!B)throw Error("profile 名不能为空");const H=loadProfileConfig();if(!H.managed?.[B])throw Error(`托管 profile "${B}" 不存在`);H.managed={...H.managed,[B]:j};saveProfileConfig(H);return H}export function removeManagedProfileEntry(F){const j=normalizeContextId(F),B=loadProfileConfig(),H=j?B.managed?.[j]:void 0;if(!j||!H||!B.managed)throw Error(`托管 profile "${F}" 不存在`);delete B.managed[j];if(Object.keys(B.managed).length===0)delete B.managed;if(B.defaultContextId===j)delete B.defaultContextId;saveProfileConfig(B);return H}export function aliasForContextId(F,j){for(const[B,H]of Object.entries(F.aliases))if(H===j)return B;return}export function renameProfile(F,j){const B=normalizeContextId(F),H=normalizeContextId(j);if(!B)throw Error("profile contextId is required");if(!H)throw Error("profile alias is required");const J=loadProfileConfig();if(J.managed?.[H])throw Error(`"${H}" 已被托管 profile 占用，换个别名`);for(const[K,L]of Object.entries(J.aliases))if(K!==H&&L===B)delete J.aliases[K];J.aliases[H]=B;saveProfileConfig(J);return J}export function setDefaultProfile(F){const j=normalizeContextId(F);if(!j)throw Error("profile is required");const B=loadProfileConfig();B.defaultContextId=B.managed?.[j]?j:B.aliases[j]??j;saveProfileConfig(B);return B}