From fe37c940966d1bdd4c3a0cf427d06344bb164a4a Mon Sep 17 00:00:00 2001 From: maogeigei Date: Sat, 10 Oct 2026 16:26:18 +0800 Subject: [PATCH] =?UTF-8?q?browser-harness=EF=BC=9A=E6=8A=8A=E3=80=8CWindo?= =?UTF-8?q?ws=20=E8=B5=B7=E6=B5=8F=E8=A7=88=E5=99=A8=E3=80=8D=E7=9A=84?= =?UTF-8?q?=E5=8F=AF=E6=8A=84=E4=B8=89=E6=AD=A5=E5=86=99=E8=BF=9B=E6=AD=A3?= =?UTF-8?q?=E6=96=87=EF=BC=8C=E5=90=AF=E5=8A=A8=E5=99=A8=E9=9A=8F=E5=8C=85?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 其他会话反馈（用户转述）：「技能里写了，但说得不完整——这就是我反复踩坑的原因。 正文只写了『起实例 ＝ 丢进常驻后台任务』，没给能直接抄的命令，也没说 Windows 上该用哪个启动器； 真正能跑的入口在技能外的另一个文件里；我照正文起，没做永不退出的循环 ⇒ 任务一结束 Chrome 被连坐。」 真因（读到代码才看清，两节自相矛盾）： - §1 说「要丢进常驻后台任务、且一直不退出」，§2 却直接给了一条 **同步** 的 `chrome.exe` 命令。 照 §2 抄 ⇒ 父进程一退 Chrome 立刻死（实测 `WinError 10061`）。 - 起法真正落在**工作区根**的 `bh_chrome_keepalive.py`（`while True` 守端口那段），而那支脚本**不在技能包里**。 改动 - 新增 `agent-workspace/bh_chrome_keepalive.py`（随包的可复制启动器，行为沿用已实测那支）： 幂等（端口已在听 ⇒ 立刻退出）· `while True` 守子进程、退出就重起 · 僵死态**只记日志不自动重启**（保住现场）· 起 Chrome 前清代理 env · `DETACHED|NO_WINDOW|NEW_PROCESS_GROUP` · 参数化 `--port/--chrome/--profile/--log/--proxy`（默认值与线上一致；`--proxy` 对应文档里那条 socks5）。 - `SKILL.md` §1 改写成**可直接抄的三步**：复制启动器 → `pythonw.exe` 起 → 计划任务兜（动作也用 pythonw、 5 分钟一次、MultipleInstances=IgnoreNew；`schtasks.exe` 在本机黑名单 ⇒ 走 PowerShell ScheduledTasks）； 另给校验两条（netstat / curl --noproxy）。 - `SKILL.md` §2 加前置说明：那条 `chrome.exe` 是**启动器脚本内部的那一步**，用途是看懂与排障； 并补 `--proxy` 的用法。 - 顶部那颗「起实例」子弹由「细节见 §1，本处不复述」改成「三步见 §1」——**从"叮嘱"改成"给命令"**。 - 表述按 2026-10-09 的「一律用肯定表述」写：先写要什么（永不退出的循环 / 保住现场）， 把踩过的坑放括号里当依据；僵死态那两条由「别把 A 当成 B」改成正向判据「两条都过才叫可用」。 验证 - `--help` 正常；`--chrome Z:/不存在` ⇒ rc=2 且不起浏览器（守卫）。 - 真机幂等：9223 正在听 ⇒ 跑它 rc=0、日志 `port 9223 already listening ⇒ exit (idempotent)`、端口数不变（没新起浏览器）。 - ⚠️ 已知不一致（本次不改，见次日报告）：contentm_agent 工作区根的部署副本与 `tmp/bh_keep_chrome.py` 仍是旧的非参数化版本；本次只把**源**落进技能包。 --- browser-harness/SKILL.md | 48 +++++-- .../agent-workspace/bh_chrome_keepalive.py | 121 ++++++++++++++++++ 2 files changed, 155 insertions(+), 14 deletions(-) create mode 100644 browser-harness/agent-workspace/bh_chrome_keepalive.py diff --git a/browser-harness/SKILL.md b/browser-harness/SKILL.md index 718031b..6844106 100644 --- a/browser-harness/SKILL.md +++ b/browser-harness/SKILL.md @@ -21,7 +21,8 @@ Direct browser control via CDP. For task-specific edits, use `agent-workspace/ag - 🔴🔴 **起实例 ＝ 丢进常驻后台任务，⛔ 别在同步调用里起**（2026-10-09 用户点破「每会开浏览器都要错一次」）。 本机沙箱**父进程一退就连带杀子进程** ⇒ 同步调用（含 PowerShell `Start-Process`）里起的 Chrome **会立刻死**， 症状是 `netstat` 查不到 9223、`curl` 报 `WinError 10061`（2026-10-09 实测踩到一次）。 - 做法：**先用常驻后台任务把浏览器开着（守端口），之后每次操作只连不起**；细节见「调 AI 工具」§1，⛔ 本处不复述。 + 做法：**先用常驻守端口把浏览器开着，之后每次操作只连不起**。 + ✅ **可直接抄的三步（含启动器在哪、怎么起、计划任务怎么兜）见下面「调 AI 工具」§1** —— 那里给的是命令，不是叮嘱。 - 🔴🔴 **一类任务只开一个标签页并复用，⛔ 禁止反复开**（2026-10-09 用户令）。 反复开页会把共享实例堆到**整机卡死**（端口不应答、进程不死，保活脚本也救不回 —— 见下面那条的实测读数）。 细则**只写在下面那颗同名的 🔴🔴 子弹里**，⛔ 本处不复述 —— 但它**优先于任何"顺手再开一个"的念头**。 @@ -61,23 +62,41 @@ Direct browser control via CDP. For task-specific edits, use `agent-workspace/ag > 2026-10-07 用户定案。适用于「打开 ChatGPT / Claude 网页版求建议、核对方案、做结构评审」这类活。 -### 1. 🔴 浏览器要由**常驻后台任务**开着 +### 1. 🔴 起法：浏览器由**一个守端口的常驻循环**开着（三步照抄） -本机沙箱会在**父进程退出时连带杀掉子进程**。实测对照： +**要什么**：浏览器活在一个**永不退出的循环**里 —— 循环起完 Chrome 就守在端口上；循环不结束，Chrome 就不会被连坐杀掉。 +（避坑依据 2026-10-09 实测对照：同步调用里起 Chrome ⇒ 端口 1 秒内就绪、**调用一返回立刻死**，随后 `curl` 报 `WinError 10061`； +丢进「起完就守着端口、且一直不退出」的循环 ⇒ 浏览器全程常驻。） -- 普通（同步）调用里起 Chrome ⇒ 端口 1 秒内就绪，**调用一返回 Chrome 立刻死**（随后 `curl` 报 `WinError 10061`）。 -- 丢进**后台任务、且该任务一直不退出**（起完浏览器就守着端口）⇒ 浏览器**全程常驻**。 +- 🔴 **可直接抄的三步**（Windows 实测，2026-10-10）： -⇒ 做法：先起一个**常驻任务**把浏览器开着（守端口，掉了就写日志），之后每次操作**只连不起**。 -⛔ 别让每次调用各自起一遍浏览器 —— 父进程一退全没，而且多个实例会抢同一个 profile。 -- 🔴 **僵死态要会认**（2026-10-09 实测）：共享实例被堆爆后会进入「**端口不应答、进程还活着**」的僵死态 —— - 连接探不通，但 `tasklist` 里那个 chrome 进程仍在。⛔ **别把「端口在」当成「浏览器可用」，也别拿「进程还在」当没事**。 - 判据（**两条一起看**）：① `netstat -ano | grep 127.0.0.1:9223` **无 LISTENING**；② `tasklist | grep -i chrome` **仍有那个 pid**。 - ⇒ 处置：**只能重启实例**（关掉残留 chrome，再按第 2 节重起），⛔ 不要在原地反复重试连接 —— 那只会白等。 - ⚠️ **保活脚本兜不住它**：`bh_keep_chrome.py` 那类只做 `socket.create_connection` 探端口，对僵死态既不判、也不重启， - 实测它连续十几分钟只在写 `port 9223 not answering (pid alive=True)`（2026-10-09 `06:56:11` → `07:06:49` 进程才退出）。 + ① 把技能包里那份启动器复制到**工作区根**（⛔ 别放 `tmp/`：`tmp/` 会被清理，脚本一没、计划任务就静默失效）： + `cp "<技能包>/agent-workspace/bh_chrome_keepalive.py" "<工作区根>/bh_chrome_keepalive.py"` -### 2. 起独立实例（端口 9223） + ② 用 **`pythonw.exe`** 起它（⛔ 别用 `python.exe`：控制台程序会闪黑窗，2026-10-01 实测用户当场投诉）： + `"/pythonw.exe" "<工作区根>/bh_chrome_keepalive.py" --log "<工作区根>/tmp/_bh_chrome.log"` + + ③ 让**计划任务**兜住它（进程挂了自动拉起）—— 动作同样用 `pythonw.exe`，每 5 分钟一次、 + `MultipleInstances=IgnoreNew`。⚠️ `schtasks.exe` 在本机黑名单里（走 PowerShell 的 `ScheduledTasks` 模块）。 + +- ✅ **校验（两条一起看）**：`netstat -ano | grep -E "127\.0\.0\.1:9223 .*LISTENING"` 有 pid； + `curl --noproxy '*' -s http://127.0.0.1:9223/json/version` 回 JSON。 +- **起来之后，每次操作只连不起**（用第 2 节那条 env 连上去）—— 多个实例会抢同一个 profile。 + +- 🔴 **僵死态要会认**（避坑依据 2026-10-09 实测）：共享实例被堆爆后会进入「**端口不应答、进程还活着**」的僵死态 + —— 连接探不通，但 `tasklist` 里那个 chrome 进程仍在。 + **判据（两条一起看）**：① `netstat -ano | grep 127.0.0.1:9223` **无 LISTENING**；② `tasklist | grep -i chrome` **仍有那个 pid**。 + ⇒ 处置：**重启实例**（关掉残留 chrome，再按本节三步重起）；在原地反复重试连接只会白等。 + 两条要记牢：**「端口在」＝还要看进程**；**「进程在」＝还要看端口** —— 两条都过才叫可用。 +- ⚠️ **守端口脚本对僵死态只记日志、不自动重启**（正向目标：**保住现场**，交给会话按上面的判据处置）—— + 依据：自动重启会把正在被人排查的现场清掉。所以它只会连续写 + `port 9223 not answering (pid alive=True)`（2026-10-09 `06:56:11` → `07:06:49` 进程才退出）。 + +### 2. 起独立实例（端口 9223）—— 下面这条是**启动器脚本内部**那一步 + +> 🔴 **要它常驻，用第 1 节的三步**（复制启动器 → `pythonw.exe` 起 → 计划任务兜）。 +> 本节这条命令的用途是**看懂它在干什么**与**排障**：照抄它**同步**跑 ⇒ 父进程一退 Chrome 立刻死 +> （避坑依据 2026-10-09：端口 1 秒内就绪、调用一返回就死，随后 `curl` 报 `WinError 10061`）。 ```bash chrome.exe --remote-debugging-port=9223 \ @@ -86,6 +105,7 @@ chrome.exe --remote-debugging-port=9223 \ ``` - 端口用 **9223**（用户日常 Chrome 是 9222）；`--user-data-dir` 固定复用 ⇒ **登录态保留**。 +- 目标站点要走代理时给启动器加 `--proxy`（例 `--proxy socks5://127.0.0.1:10800`）；默认不带。 - `BU_CDP_URL` **必须带 scheme**：`http://127.0.0.1:9223`。 - 必须清掉沙箱代理变量（`HTTP_PROXY` / `HTTPS_PROXY` 会劫持本地 CDP ⇒ `502 Bad Gateway`）： `env -u HTTP_PROXY -u HTTPS_PROXY -u http_proxy -u https_proxy NO_PROXY=127.0.0.1,localhost BU_CDP_URL=http://127.0.0.1:9223 browser-harness` diff --git a/browser-harness/agent-workspace/bh_chrome_keepalive.py b/browser-harness/agent-workspace/bh_chrome_keepalive.py new file mode 100644 index 0000000..e3d15aa --- /dev/null +++ b/browser-harness/agent-workspace/bh_chrome_keepalive.py @@ -0,0 +1,121 @@ +# -*- coding: utf-8 -*- +"""常驻守端口：让本机有一个可用的独立 Chrome 实例（默认 9223，固定 profile ⇒ 登录态保留）。 + +## 它解决什么 + +本机沙箱**在父进程退出时连带杀子进程** ⇒ 会话/工具调用里起的浏览器，调用一返回就死 +（症状：`netstat` 查不到端口、`curl` 报 `WinError 10061`）。 +要的是：浏览器活在一个**永不退出的循环**里 —— 起完 Chrome 就守在端口上。 + +## 怎么用（三步，Windows 实测 2026-10-10） + +1、复制到**工作区根**（⛔ 别放 `tmp/`：`tmp/` 会被清理，脚本一没、计划任务就静默失效） +2、用 **`pythonw.exe`** 起（⛔ 别用 `python.exe`：控制台程序会闪黑窗） +3、让**计划任务**兜住它（进程挂了自动拉起） + +## 做法约定 + +- **幂等**：端口已在听 ⇒ 立刻退出。（避免叠加第二个实例、避免两个实例抢同一个 profile） +- **守**：`while True` 里看着子进程；它退出了就重新起。 +- **僵死态只记日志**：端口不应答而进程仍在时，脚本**不自动重启** —— 那会把正在被排查的现场清掉， + 留给人/会话按 SKILL.md 的判据处置。 +- **清代理 env**：`HTTP_PROXY` / `HTTPS_PROXY` 会劫持本地 CDP 连接（报 `502 Bad Gateway`）。 +- **只用独立实例**：⛔ 不附着用户日常 Chrome（那是 9222，会弹「允许远程调试？」动到用户浏览器）。 + +用法： + pythonw bh_chrome_keepalive.py --log "<工作区根>/tmp/_bh_chrome.log" +可选：`--port` `--chrome` `--profile`（都有默认值，见下） +""" +from __future__ import annotations + +import argparse +import io +import os +import socket +import subprocess +import sys +import time + +# 清掉会劫持本地 CDP 的代理变量（要在起 Chrome 之前做） +for _k in ("HTTP_PROXY", "HTTPS_PROXY", "http_proxy", "https_proxy"): + os.environ.pop(_k, None) +os.environ.setdefault("NO_PROXY", "127.0.0.1,localhost") + +DEFAULT_CHROME = r"C:\Program Files\Google\Chrome\Application\chrome.exe" +DEFAULT_PROFILE = r"E:/ProgramData/.workbuddy/tmp/bu-chatgpt-profile" +DEFAULT_PORT = 9223 + + +def _log(path, msg): + if not path: + return + try: + os.makedirs(os.path.dirname(path), exist_ok=True) + with io.open(path, "a", encoding="utf-8") as f: + f.write("[%s] %s\n" % (time.strftime("%m-%d %H:%M:%S"), msg)) + except Exception: + pass + + +def _listening(port: int) -> bool: + try: + s = socket.create_connection(("127.0.0.1", port), 1) + s.close() + return True + except Exception: + return False + + +def _launch(chrome: str, profile: str, port: int, proxy: str = ""): + cmd = [chrome, "--remote-debugging-port=%d" % port, + "--user-data-dir=%s" % profile, + "--no-first-run", "--no-default-browser-check"] + if proxy: + # 目标站点要走代理时才加（例：--proxy socks5://127.0.0.1:10800） + cmd.append("--proxy-server=%s" % proxy) + cmd.append("about:blank") + return subprocess.Popen( + cmd, + # DETACHED | CREATE_NO_WINDOW | CREATE_NEW_PROCESS_GROUP + creationflags=0x00000008 | 0x08000000 | 0x00000200, + ) + + +def main() -> int: + ap = argparse.ArgumentParser(add_help=True) + ap.add_argument("--port", type=int, default=DEFAULT_PORT) + ap.add_argument("--chrome", default=os.environ.get("BH_CHROME") or DEFAULT_CHROME) + ap.add_argument("--profile", default=os.environ.get("BH_PROFILE") or DEFAULT_PROFILE) + ap.add_argument("--log", default=os.environ.get("BH_LOG") or "") + ap.add_argument("--proxy", default=os.environ.get("BH_PROXY") or "", + help='目标站点要走代理时才给，例 --proxy socks5://127.0.0.1:10800') + a = ap.parse_args() + + if not os.path.isfile(a.chrome): + _log(a.log, "chrome 可执行体不存在：%s ⇒ 停（⛔ 不静默）" % a.chrome) + print("✗ 找不到 chrome：%s" % a.chrome, file=sys.stderr) + return 2 + + # ── 幂等前置：端口已在听 ⇒ 什么都不做 ────────────────────────── + if _listening(a.port): + _log(a.log, "port %d already listening ⇒ exit (idempotent)" % a.port) + return 0 + + p = _launch(a.chrome, a.profile, a.port, a.proxy) + _log(a.log, "launched pid=%s" % p.pid) + + # ── 守：循环不结束 ⇒ Chrome 不被连坐 ─────────────────────────── + while True: + time.sleep(5) + if p.poll() is not None: + _log(a.log, "chrome exited rc=%s ⇒ relaunch" % p.returncode) + p = _launch(a.chrome, a.profile, a.port, a.proxy) + _log(a.log, "relaunched pid=%s" % p.pid) + elif not _listening(a.port): + # ⚠️ 僵死态（端口不应答、进程还在）：只记日志，⛔ 不自动重启 —— + # 自动重启会把"正在被排查的现场"清掉。判据与处置见 SKILL.md §1。 + _log(a.log, "port %d not answering (pid alive=True)" % a.port) + + +if __name__ == "__main__": + sys.exit(main())