From c36a3f4a5069950b7e1d48273c1a6d3f899f9a7c Mon Sep 17 00:00:00 2001 From: maogeigei Date: Fri, 9 Oct 2026 07:20:03 +0800 Subject: [PATCH] =?UTF-8?q?browser-harness=20=E7=AC=AC=E4=B8=80=E5=B1=8F?= =?UTF-8?q?=EF=BC=9A=E6=8A=8A=E3=80=8C=E8=B5=B7=E5=AE=9E=E4=BE=8B=E8=A6=81?= =?UTF-8?q?=E4=B8=A2=E5=90=8E=E5=8F=B0=E4=BB=BB=E5=8A=A1=E3=80=8D=E6=8F=90?= =?UTF-8?q?=E4=B8=8A=E6=9D=A5=EF=BC=88=E7=94=A8=E6=88=B7=E7=82=B9=E7=A0=B4?= =?UTF-8?q?=E3=80=8C=E6=AF=8F=E4=BC=9A=E5=BC=80=E6=B5=8F=E8=A7=88=E5=99=A8?= =?UTF-8?q?=E9=83=BD=E8=A6=81=E9=94=99=E4=B8=80=E6=AC=A1=E3=80=8D=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 用户原话：「后台任务开启 浏览器，这个是不是也要写入规则，每会开浏览器都要错一次」。 核实结论：**规则本来就写了** ——「### 1. 🔴 浏览器要由常驻后台任务开着」写得很细（沙箱连带杀子进程、 同步调用起的会立刻死、做法是常驻任务守端口）。**问题在位置**：它挂在 「## 用 browser-harness 调 AI 工具（ChatGPT 等）的提问方法」下面，标题把适用范围限成了"调 AI 工具" ⇒ 干别的活（如③段闸门取证）按目录根本翻不到 ⇒ 每次重踩。本轮又踩一次：用同步方式起实例， `netstat` 查不到 9223、`curl` 无响应。 改法（两处）： 1、第一屏「本机（用户明令）」段加 🔴🔴 一条 —— 起实例＝丢进常驻后台任务，⛔ 别在同步调用里起； 写明症状（`netstat` 查不到 9223 ／ `curl` 报 `WinError 10061`）与做法，细节指向 §1，⛔ 不复述。 2、顺带修一处**上轮编辑留下的结构错位**：`⇒ 必须起独立实例：BU_CDP_URL=…` 原属 「⛔ 不附着用户日常 Chrome」那条的收尾，上轮被接到了"一类任务一个标签"条下面 ⇒ 已归位。 --- browser-harness/SKILL.md | 9 ++++++--- 1 file changed, 6 insertions(+), 3 deletions(-) diff --git a/browser-harness/SKILL.md b/browser-harness/SKILL.md index 91b1d93..718031b 100644 --- a/browser-harness/SKILL.md +++ b/browser-harness/SKILL.md @@ -17,11 +17,14 @@ Direct browser control via CDP. For task-specific edits, use `agent-workspace/ag `agent-browser` / `playwright-cli` 插件已置 `false`。 - ⛔ **不附着用户日常 Chrome**。下面「Local Chrome」一节说的"默认附着正在运行的 Chrome" 在本机**不适用** —— 那样会弹「允许远程调试？」去动用户自己的浏览器（2026-09-26 实际踩到）。 + ⇒ 必须起**独立实例**：`BU_CDP_URL=127.0.0.1:9223`（不要用用户 Chrome 默认的 9222）。 +- 🔴🔴 **起实例 ＝ 丢进常驻后台任务，⛔ 别在同步调用里起**（2026-10-09 用户点破「每会开浏览器都要错一次」）。 + 本机沙箱**父进程一退就连带杀子进程** ⇒ 同步调用（含 PowerShell `Start-Process`）里起的 Chrome **会立刻死**， + 症状是 `netstat` 查不到 9223、`curl` 报 `WinError 10061`（2026-10-09 实测踩到一次）。 + 做法：**先用常驻后台任务把浏览器开着（守端口），之后每次操作只连不起**；细节见「调 AI 工具」§1，⛔ 本处不复述。 - 🔴🔴 **一类任务只开一个标签页并复用，⛔ 禁止反复开**（2026-10-09 用户令）。 反复开页会把共享实例堆到**整机卡死**（端口不应答、进程不死，保活脚本也救不回 —— 见下面那条的实测读数）。 - 细则（什么叫"一类任务"、换路由／换视口／换页面各怎么办）**只写在下面那颗同名的 🔴🔴 子弹里**， - ⛔ 本处不复述 —— 但要记住它**优先于任何"顺手再开一个"的念头**。 - ⇒ 必须起**独立实例**：`BU_CDP_URL=127.0.0.1:9223`（不要用用户 Chrome 默认的 9222）。 + 细则**只写在下面那颗同名的 🔴🔴 子弹里**，⛔ 本处不复述 —— 但它**优先于任何"顺手再开一个"的念头**。 - 🔴 **先探测、能复用就复用**（2026-10-08 用户当场点破：「为什么要重新开浏览器，先检查之前是否开过浏览能否复用」）。 动手第一件事是查 `9223` 上**有没有已经在跑的实例**；有 ⇒ 直接连，⛔ 不要再起一个。 ⛔ 「量个尺寸 / 截个图 / 取个数」这类小活最容易犯这个错 —— 为了量一次就另起一个 headless 实例，