ppxc-leads-mcp 0.1.5 → 0.1.7

package/README.md

@@ -128,6 +128,26 @@ macOS 或 Windows，Node.js 18+，以及一个 PPXC 账号。目标平台账号
 
 详见 [`docs/开发手册.md` §8](./docs/开发手册.md)。小红书/快手初版比抖音更保守。
 
+## 网络代理
+
+平台网页登录窗口（抖音 / 小红书 / 快手）会单独设置 Electron 代理策略。抖音 / 小红书默认 `direct`，避免被系统 HTTP 代理或代理软件拖慢登录二维码加载；快手默认 `system`，因为实测快手在部分 Clash/TUN 网络下走 `direct` 会导航超时，而系统代理配合直连规则更稳定。该设置只影响平台 BrowserWindow，不影响 MCP stdio 或 PPXC 后端 API 调用。
+
+如需恢复系统代理：
+
+```bash
+PPXC_MCP_PLATFORM_PROXY=system npx -y ppxc-leads-mcp
+```
+
+可选值：`direct`（默认）、`system`、`auto_detect`。如果 VPN 是全局 TUN / 全局路由模式，应用内 `direct` 不能绕过 VPN，需要在 VPN 客户端里配置分流或临时关闭全局路由。
+
+也可以只覆盖单个平台：
+
+```bash
+PPXC_MCP_PLATFORM_PROXY_KUAISHOU=direct npx -y ppxc-leads-mcp
+PPXC_MCP_PLATFORM_PROXY_XIAOHONGSHU=system npx -y ppxc-leads-mcp
+PPXC_MCP_PLATFORM_PROXY_DOUYIN=system npx -y ppxc-leads-mcp
+```
+
 ## 仓库关系（重要）
 
 本仓库**独立**，不与 `/Users/jianshi/ppxc`（网页 + 后端）、`/Users/jianshi/ppxc-desktop`（桌面客户端稳定线）共享代码、分支、git 历史。

package/dist/browser/kernel/runner-page-session.js

@@ -136,6 +136,77 @@ const DOUYIN_SEARCH_HOOK_BINDING = "__OPC1_DOUYIN_SEARCH_CAPTURE__";
 const MAX_PAGE_HOOK_PAYLOAD_CHARS = 5 * 1024 * 1024;
 const ENABLE_SEARCH_SNIFFER = process.env.OPC1_DISABLE_DOUYIN_SEARCH_SNIFFER !== "1";
 const ENABLE_PAGE_SEARCH_HOOK = process.env.OPC1_DISABLE_DOUYIN_PAGE_SEARCH_HOOK !== "1";
+function normalizePlatformProxyMode(rawValue) {
+    const raw = String(rawValue ?? "").trim().toLowerCase();
+    if (!raw)
+        return null;
+    if (raw === "direct" || raw === "system" || raw === "auto_detect")
+        return raw;
+    if (raw === "auto-detect" || raw === "auto")
+        return "auto_detect";
+    if (raw === "off" || raw === "0" || raw === "false")
+        return "system";
+    return null;
+}
+function platformProxyEnvKey(partition) {
+    if (partition.includes("kuaishou"))
+        return "PPXC_MCP_PLATFORM_PROXY_KUAISHOU";
+    if (partition.includes("xhs"))
+        return "PPXC_MCP_PLATFORM_PROXY_XIAOHONGSHU";
+    if (partition.includes("douyin"))
+        return "PPXC_MCP_PLATFORM_PROXY_DOUYIN";
+    return null;
+}
+function defaultPlatformProxyMode(partition) {
+    if (partition.includes("kuaishou"))
+        return "system";
+    return "direct";
+}
+function resolvePlatformProxyMode(partition) {
+    const platformKey = platformProxyEnvKey(partition);
+    const platformOverride = platformKey
+        ? normalizePlatformProxyMode(process.env[platformKey])
+        : null;
+    if (platformOverride)
+        return platformOverride;
+    const globalOverride = normalizePlatformProxyMode(process.env.PPXC_MCP_PLATFORM_PROXY);
+    if (globalOverride)
+        return globalOverride;
+    const raw = String(process.env.PPXC_MCP_PLATFORM_PROXY ?? "")
+        .trim()
+        .toLowerCase();
+    if (raw) {
+        log.warn("unknown PPXC_MCP_PLATFORM_PROXY value, use platform default", {
+            value: raw,
+            partition,
+        });
+    }
+    if (platformKey) {
+        const platformRaw = String(process.env[platformKey] ?? "").trim().toLowerCase();
+        if (platformRaw) {
+            log.warn("unknown platform proxy override, use platform default", {
+                key: platformKey,
+                value: platformRaw,
+                partition,
+            });
+        }
+    }
+    return defaultPlatformProxyMode(partition);
+}
+async function applyPlatformProxyPolicy(ses, slotId, partition) {
+    const mode = resolvePlatformProxyMode(partition);
+    try {
+        await ses.setProxy({ mode });
+        log.info(`slot ${slotId} platform proxy applied`, { mode, partition });
+    }
+    catch (err) {
+        log.warn(`slot ${slotId} platform proxy apply failed`, {
+            mode,
+            partition,
+            msg: err instanceof Error ? err.message : String(err),
+        });
+    }
+}
 function readBoundedIntEnv(name, fallback, min, max) {
     const parsed = Math.floor(Number(process.env[name]));
     if (!Number.isFinite(parsed))
@@ -273,6 +344,7 @@ class RunnerPageSession {
                 backgroundThrottling: false,
             },
         });
+        this._networkPolicyReady = applyPlatformProxyPolicy(this._win.webContents.session, this._slotId, this._partition);
         this._win.webContents.setAudioMuted(true);
         this._win.webContents.on("did-attach-webview", (_e, attached) => {
             try {
@@ -523,6 +595,7 @@ class RunnerPageSession {
     async loadUrl(url) {
         return await withDouyinNavigationPermit(this._slotId, async () => {
             this._assertAlive();
+            await this._networkPolicyReady;
             const wc = this._win.webContents;
             const timeoutMs = this._navigationTimeoutMs;
             let timer = null;
@@ -586,7 +659,8 @@ class RunnerPageSession {
     }
     navigateNoWait(url) {
         this._assertAlive();
-        this._win.webContents.loadURL(url).catch((err) => {
+        const wc = this._win.webContents;
+        void this._networkPolicyReady.then(() => wc.loadURL(url)).catch((err) => {
             const raw = err instanceof Error ? err : new Error(String(err));
             if (isNavigationAbortedError(raw)) {
                 log.info(`slot ${this._slotId} navigateNoWait aborted url=${url} msg=${raw.message}`);

package/dist/browser/platforms/xiaohongshu/comments.js

@@ -148,12 +148,41 @@ exports.XHS_PROBE_SCRIPT = `(async () => {
 exports.XHS_OPEN_LOGIN_SCRIPT = `(async () => {
   try {
     const sleep = (ms) => new Promise(r => setTimeout(r, ms));
-    const clickables = Array.from(document.querySelectorAll('button, a, [role="button"], div'));
+    const visible = (el) => {
+      const rect = el && el.getBoundingClientRect ? el.getBoundingClientRect() : null;
+      const style = el ? window.getComputedStyle(el) : null;
+      return !!rect && rect.width > 0 && rect.height > 0 && style && style.visibility !== 'hidden' && style.display !== 'none';
+    };
+    const clickables = Array.from(document.querySelectorAll('button, [role="button"], a'));
     for (const el of clickables) {
-      const t = String(el.innerText || el.textContent || '').trim();
-      if (/^登录$|扫码登录|手机号登录/.test(t)) { el.click(); await sleep(800); break; }
+      if (!visible(el)) continue;
+      const t = String(el.innerText || el.textContent || el.getAttribute('aria-label') || '').trim();
+      const href = String(el.getAttribute('href') || '');
+      if (/发布|创作|publish|creator/i.test(t + ' ' + href)) continue;
+      if (/^(登录|扫码登录|手机号登录)$/.test(t)) {
+        el.click();
+        await sleep(800);
+        return { ok: true, clicked: true, text: t };
+      }
     }
-    return { ok: true };
+    const exactTextNodes = [];
+    const walker = document.createTreeWalker(document.body, NodeFilter.SHOW_TEXT);
+    while (exactTextNodes.length < 20) {
+      const node = walker.nextNode();
+      if (!node) break;
+      if (String(node.nodeValue || '').trim() === '登录') exactTextNodes.push(node);
+    }
+    for (const node of exactTextNodes) {
+      const el = node.parentElement && node.parentElement.closest('button, [role="button"], a, div');
+      if (!el || !visible(el)) continue;
+      const href = String(el.getAttribute('href') || '');
+      const text = String(el.innerText || el.textContent || '').trim();
+      if (/发布|创作|publish|creator/i.test(text + ' ' + href)) continue;
+      el.click();
+      await sleep(800);
+      return { ok: true, clicked: true, text };
+    }
+    return { ok: true, clicked: false };
   } catch (e) { return { ok: false }; }
 })();`;
 exports.XHS_SCROLL_COMMENTS_SCRIPT = `(async () => {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "ppxc-leads-mcp",
   "productName": "PPXC Leads MCP",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "description": "PPXC 找客户能力的 MCP 工具包：智能体可调用的抖音/小红书/快手评论客户发现工具",
   "license": "UNLICENSED",
   "homepage": "https://opc1.me/download/mcp",