ppxc-leads-mcp 0.1.3 → 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/dist/main.js

@@ -36,8 +36,10 @@ function quitAfterStdioClose(reason) {
     });
     setTimeout(() => electron_1.app.exit(0), 1500).unref();
 }
-process.stdin.on("end", () => quitAfterStdioClose("end"));
-process.stdin.on("close", () => quitAfterStdioClose("close"));
+if (!process.env.PPXC_MCP_STDIN_FD) {
+    process.stdin.on("end", () => quitAfterStdioClose("end"));
+    process.stdin.on("close", () => quitAfterStdioClose("close"));
+}
 const gotLock = electron_1.app.requestSingleInstanceLock();
 if (!gotLock) {
     log.error("another PPXC Leads MCP instance is already running, exiting");
@@ -53,7 +55,7 @@ else {
         .whenReady()
         .then(async () => {
         log.info(`electron ready, starting MCP stdio server (ppxc-leads-mcp v${version_1.OWN_VERSION})`);
-        await (0, server_1.startMcpServer)();
+        await (0, server_1.startMcpServer)(quitAfterStdioClose);
         log.info("MCP server connected over stdio");
     })
         .catch((err) => {

package/dist/mcp/diagnostics.js

@@ -27,6 +27,9 @@ function readLogTail() {
     }
 }
 function pickOutputDir() {
+    const override = process.env.PPXC_MCP_DIAGNOSTICS_DIR?.trim();
+    if (override)
+        return override;
     for (const name of ["desktop", "downloads"]) {
         try {
             const dir = electron_1.app.getPath(name);

package/dist/mcp/server.js

@@ -4,6 +4,7 @@ exports.createMcpServer = createMcpServer;
 exports.startMcpServer = startMcpServer;
 const mcp_js_1 = require("@modelcontextprotocol/sdk/server/mcp.js");
 const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
+const node_fs_1 = require("node:fs");
 const zod_1 = require("zod");
 const platform_runner_1 = require("../browser/platform-runner");
 const detect_platform_1 = require("../browser/platforms/detect-platform");
@@ -822,9 +823,22 @@ function createMcpServer() {
     });
     return server;
 }
-async function startMcpServer() {
+function mcpInputStream(onInputClosed) {
+    const fdRaw = process.env.PPXC_MCP_STDIN_FD?.trim();
+    if (!fdRaw)
+        return process.stdin;
+    const fd = Number(fdRaw);
+    if (!Number.isInteger(fd) || fd < 0) {
+        throw new Error(`invalid PPXC_MCP_STDIN_FD: ${fdRaw}`);
+    }
+    const stream = (0, node_fs_1.createReadStream)("", { fd, autoClose: false });
+    stream.on("end", () => onInputClosed?.(`fd${fd}-end`));
+    stream.on("close", () => onInputClosed?.(`fd${fd}-close`));
+    return stream;
+}
+async function startMcpServer(onInputClosed) {
     const server = createMcpServer();
-    const transport = new stdio_js_1.StdioServerTransport();
+    const transport = new stdio_js_1.StdioServerTransport(mcpInputStream(onInputClosed), process.stdout);
     await server.connect(transport);
 }
 //# sourceMappingURL=server.js.map

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "ppxc-leads-mcp",
   "productName": "PPXC Leads MCP",
-  "version": "0.1.3",
+  "version": "0.1.7",
   "description": "PPXC 找客户能力的 MCP 工具包：智能体可调用的抖音/小红书/快手评论客户发现工具",
   "license": "UNLICENSED",
   "homepage": "https://opc1.me/download/mcp",
@@ -34,7 +34,8 @@
     "smoke:e2e": "npm run build && electron dist/scripts/smoke-e2e-main.js",
     "smoke:backend": "npm run build && electron dist/scripts/smoke-backend-tools-main.js",
     "regression:static": "npm run build && node dist/scripts/regression-static-main.js",
-    "spike:probe": "npm run build && PPXC_MCP_PAGE_VISIBLE=${PPXC_MCP_PAGE_VISIBLE:-1} electron dist/scripts/spike-platform-probe-main.js"
+    "spike:probe": "npm run build && PPXC_MCP_PAGE_VISIBLE=${PPXC_MCP_PAGE_VISIBLE:-1} electron dist/scripts/spike-platform-probe-main.js",
+    "smoke:published-mcp": "node scripts/smoke-published-mcp.cjs"
   },
   "devDependencies": {
     "@types/node": "^25.5.0",

package/scripts/launch-mcp.cjs

@@ -88,11 +88,39 @@ if (!existsSync(mainJs)) {
 const env = { ...process.env };
 delete env.ELECTRON_RUN_AS_NODE;
 
+const useAuxStdinPipe = process.platform === "win32";
+if (useAuxStdinPipe) {
+  env.PPXC_MCP_STDIN_FD = "3";
+}
+
 const child = spawn(electronBin, [mainJs], {
-  stdio: "inherit",
+  // Windows 上 GUI 形态的 Electron 读取 fd0 可能立刻收到 EOF，导致 MCP server
+  // 启动后马上退出。Windows 改用额外 fd3 承载 MCP 输入；stdout/stderr 仍
+  // 直接继承，stdout 完整保留给 MCP 协议输出。
+  stdio: useAuxStdinPipe ? ["ignore", "inherit", "inherit", "pipe"] : ["pipe", "inherit", "inherit"],
   env,
 });
 
+const mcpInput = useAuxStdinPipe ? child.stdio[3] : child.stdin;
+if (!mcpInput) {
+  process.stderr.write("[ppxc-leads-mcp] 启动失败：无法建立 MCP 输入管道。\n");
+  process.exit(1);
+}
+
+process.stdin.resume();
+process.stdin.on("data", (chunk) => {
+  mcpInput.write(chunk);
+});
+process.stdin.on("end", () => {
+  mcpInput.end();
+});
+process.stdin.on("close", () => {
+  mcpInput.end();
+});
+mcpInput.on("error", () => {
+  /* child 已退出或 stdin 已关闭，忽略 EPIPE 等清理期错误 */
+});
+
 let exiting = false;
 
 function exitWithChild(code, signal) {

package/skills/ppxc-find-customers/SKILL.md

@@ -31,7 +31,7 @@ description: 用 PPXC 找客户小组件（MCP）从抖音/小红书/快手评
 
 3. **告诉用户**：「我把 PPXC 找客户小组件的配置加好了，重启/刷新一下智能体就能用。首次使用会自动下载运行环境（约一两分钟，取决于网络）。」
 4. **重启后验证**：调 `check_status_and_login` 确认工具就位，然后从第 1 步继续。
-5. **你没有文件编辑能力时**：把上面那段配置原样发给用户，告诉他贴进自己智能体的 MCP 设置里，并附 PPXC 官网接入页（有逐家图文步骤）。
+5. **你没有文件编辑能力时**：把上面那段配置原样发给用户，告诉他贴进自己智能体的 MCP 设置里，并附 PPXC 官网接入页 https://opc1.me/download/mcp（有逐家图文步骤）。
 
 ## 标准流程（按顺序）