browser-harness：把「Windows 起浏览器」的可抄三步写进正文，启动器随包
其他会话反馈（用户转述）：「技能里写了，但说得不完整——这就是我反复踩坑的原因。
正文只写了『起实例 ＝ 丢进常驻后台任务』，没给能直接抄的命令，也没说 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`
仍是旧的非参数化版本；本次只把**源**落进技能包。
This commit is contained in:
admin committed
1 parent
5004909267
commit
fe37c94096
2 files changed
+155
-14
No files matched your search
+34
-14
@@ -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 实测用户当场投诉）：
|
||||
`"<py>/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`
|
||||
|
||||
@@ -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())
|
||||
Reference in new issue
Block a user