@routerhub/agent-rules 1.5.198 → 1.5.199

package/AGENTS.base.md

@@ -706,14 +706,16 @@ Chrome Helper 会越积越多，表现为“agent-browser 用着用着越来越
 1. 每次 `agent-browser tab new` 后必须记录本次任务创建的 tab id；任务结束前，必须关闭
     本任务打开的所有 tab，禁止把 Cloud Console、GitHub、Slack、Google 登录页等任务页面
     长期留在 agent-browser Chrome 里。
-2. 每次浏览器自动化任务结束前，必须执行一次内存收尾检查：
-    `agent-browser-cleanup status`（或仓库源码内 `bash scripts/agent-browser-cleanup.sh status`）。
-3. `9226` 无头 Chrome 优先用于 agent 自动化；若 `9226` 的 tab 数 > 10，或 RSS > 1500MB，
-    必须执行 `agent-browser-cleanup auto` 或 `agent-browser-cleanup hard` 释放内存。释放后下次
-    需要浏览器时再重新启动，不要为了“可能等会用”长期占着内存。
+2. 每次浏览器自动化任务结束前，**执行任务的 Agent 必须自动运行** `agent-browser-cleanup auto`
+    （或仓库源码内 `bash scripts/agent-browser-cleanup.sh auto`），禁止把这一步交给用户手动判断。
+    用户只负责提出任务，Agent 负责判断是否该释放内存。
+3. `9226` 无头 Chrome 优先用于 agent 自动化；`agent-browser-cleanup auto` 会在 `9226` 的 tab 数
+    > 10，或 RSS > 1500MB 时自动释放它。释放后下次需要浏览器时再重新启动，不要为了“可能等会用”
+    长期占着内存。
 4. `9223` 有头 Chrome 只在需要用户手动登录、手动查看动态效果、或必须共享可见页面时启动；
-    任务结束且用户不再需要查看时，必须关闭本任务 tab，并在确认没有人工操作中的页面后再
-    `agent-browser-cleanup hard`。
+    任务结束且用户不再需要查看时，必须关闭本任务 tab；`auto` 默认不会关闭 `9223`，避免误关用户
+    正在看的页面。只有明确确认 `9223` 没有人工操作中的页面时，才允许设置
+    `AGENT_BROWSER_CLEANUP_INCLUDE_HEADED=1 agent-browser-cleanup auto` 或执行 `agent-browser-cleanup hard`。
 5. 禁止长期同时保留 `9223` + `9226` 两套 agent-browser Chrome 实例，除非当前任务明确需要。
     多会话并行时也必须各自用 namespace 隔离，任务完成各自清理自己创建的 tab。
 6. 禁止用 `kill -9` / `pkill -9` 强杀 Chrome；清理只能使用 `agent-browser-cleanup`、

package/CHANGELOG.md

@@ -2,6 +2,12 @@
 
 所有对 @routerhub/agent-rules 的重大更改都会记录在这个文件中。
 
+## [1.5.199] - 2026-09-08
+
+### Changed
+
+- **agent-browser 收尾从“手动命令”升级为“Agent 自动判断”**：规则明确要求每次浏览器自动化任务结束前，由执行任务的 Agent 自动运行 `agent-browser-cleanup auto`，禁止把判断交给用户。`auto` 模式同步调整为默认只自动释放超阈值的 `9226` 无头 Chrome；`9223` 有头 Chrome 默认只提示，需设置 `AGENT_BROWSER_CLEANUP_INCLUDE_HEADED=1` 才会自动关闭，避免误关用户正在看的页面。
+
 ## [1.5.198] - 2026-09-08
 
 ### Added

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@routerhub/agent-rules",
-  "version": "1.5.198",
+  "version": "1.5.199",
   "description": "Shared Copilot agent rules and guidelines for RouterHub projects",
   "main": "AGENTS.base.md",
   "bin": {

package/scripts/agent-browser-cleanup.sh

@@ -4,6 +4,7 @@ set -euo pipefail
 MODE="${1:-status}"
 TAB_LIMIT="${AGENT_BROWSER_TAB_LIMIT:-10}"
 RSS_LIMIT_MB="${AGENT_BROWSER_RSS_LIMIT_MB:-1500}"
+INCLUDE_HEADED="${AGENT_BROWSER_CLEANUP_INCLUDE_HEADED:-0}"
 
 profileForPort() {
   case "$1" in
@@ -21,11 +22,12 @@ Modes:
   status  只查看 9223/9226 的标签页数量与内存占用
   soft    关闭 about:blank、newtab、devtools 等无业务标签页
   hard    优雅退出 agent-browser 专用 Chrome（9223/9226），释放内存
-  auto    tab 数或 RSS 超阈值时自动执行 hard，否则只输出状态
+  auto    超阈值时自动释放 9226；9223 默认只提示，避免误关用户正在看的页面
 
 Env:
   AGENT_BROWSER_TAB_LIMIT      默认 10
   AGENT_BROWSER_RSS_LIMIT_MB   默认 1500
+  AGENT_BROWSER_CLEANUP_INCLUDE_HEADED=1 时，auto 也允许释放 9223
 USAGE
 }
 
@@ -77,17 +79,17 @@ printStatus() {
 closeChromeByPort() {
   local portNumber="$1"
   local profileDir=""
+  local profileArg=""
   local processIds=""
   profileDir=$(profileForPort "$portNumber")
-  processIds=$(ps -axo pid=,command= | awk -v portArg="--remote-debugging-port=${portNumber}" -v profileArg="--user-data-dir=${profileDir}" '
+  profileArg="--user-data-dir=${profileDir}"
+  processIds=$(ps -axo pid=,command= | awk -v profileArg="$profileArg" '
     {
-      hasPort = 0
       hasProfile = 0
       for (fieldIndex = 2; fieldIndex <= NF; fieldIndex++) {
-        if ($fieldIndex == portArg) hasPort = 1
         if ($fieldIndex == profileArg) hasProfile = 1
       }
-      if (hasPort && hasProfile) print $1
+      if (hasProfile) print $1
     }
   ')
   if [[ -z "$processIds" ]]; then
@@ -116,15 +118,25 @@ softCleanup() {
   rm -f "/tmp/agent-browser-tabs-${portNumber}.json"
 }
 
-needsHardCleanup() {
-  local overLimit="0"
+autoCleanup() {
   while read -r portNumber tabCount rssMb; do
-    if (( tabCount > TAB_LIMIT || rssMb > RSS_LIMIT_MB )); then
-      echo "port ${portNumber}: over limit tabs=${tabCount}/${TAB_LIMIT} rssMB=${rssMb}/${RSS_LIMIT_MB}"
-      overLimit="1"
+    if (( tabCount <= TAB_LIMIT && rssMb <= RSS_LIMIT_MB )); then
+      continue
+    fi
+
+    echo "port ${portNumber}: over limit tabs=${tabCount}/${TAB_LIMIT} rssMB=${rssMb}/${RSS_LIMIT_MB}"
+    if [[ "$portNumber" == "9226" ]]; then
+      closeChromeByPort "$portNumber"
+      continue
     fi
+
+    if [[ "$portNumber" == "9223" && "$INCLUDE_HEADED" == "1" ]]; then
+      closeChromeByPort "$portNumber"
+      continue
+    fi
+
+    echo "port ${portNumber}: headed Chrome skipped; set AGENT_BROWSER_CLEANUP_INCLUDE_HEADED=1 to close it automatically"
   done < <(portStatus 9223 && portStatus 9226)
-  [[ "$overLimit" == "1" ]]
 }
 
 case "$MODE" in
@@ -142,11 +154,6 @@ case "$MODE" in
     ;;
   auto)
     printStatus
-    if needsHardCleanup; then
-      closeChromeByPort 9223
-      closeChromeByPort 9226
-    else
-      echo "agent-browser Chrome is below cleanup thresholds"
-    fi
+    autoCleanup
     ;;
 esac