القائمة
BadBoy / browser-harness / Hermes browser / anything-analyzer 四路分流。解决何时直控真实 Chrome，何时走 AA CDP，何时走 Hermes 中介取证，何时仅用 AA 离线分析。
يُحدَّد Prompt الذي يراجع المصدر أولًا بشكل افتراضي. يمكنك التبديل إلى أمر مباشر أو تنزيل نسخة محلية.
اقرأ SKILL.md وأي ملفات مرافقة يعرضها SkillsMP قبل أن تقرر التثبيت.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
يتجاوز الأمر المباشر Prompt المخصّص للمراجعة. افحص المصدر قبل تشغيله.
npx skills add https://github.com/Undermybelt/hermes-skills --skill badboy-br-aa-routingيبقى الأمر في سطر واحد. مرّر أفقيًا لمراجعته كاملًا قبل النسخ.
تفضّل نسخة محلية؟ نزّل الملفات المتاحة حاليًا لدى SkillsMP.
Use when retiring old logic, collapsing duplicate owners, removing fallbacks, or touching schema, persistence, or source-of-truth boundaries while deciding whether to delete old paths, retain compatibility, or stop for confirmation.
Use when defining new features, product behavior, UI/component design, architecture choices, contract changes, or ambiguous medium/high-complexity work before implementation.
Use when the user asks for caveman mode, fewer tokens, brief responses, compressed communication, or otherwise explicitly requests a much shorter answer.
استنادا إلى تصنيف SOC المهني
عرض SKILL.md
| name | badboy-br-aa-routing |
| description | BadBoy / browser-harness / Hermes browser / anything-analyzer 四路分流。解决何时直控真实 Chrome，何时走 AA CDP，何时走 Hermes 中介取证，何时仅用 AA 离线分析。 |
| triggers | ["badboy","badboy browser","badboy analyzer","AA","anything-analyzer","browser harness","真实 chrome","真实浏览器","cdp","当前页面","登录态分析","华容道脚本","tampermonkey 脚本","userscript 调试","给 aa","提供给 aa","browser + aa"] |
| category | devops |
先问自己三件事：
用 browser-harness-real-chrome，若：
典型任务：
一句话：
用 aa-ana-wo-direct-auth，若：
典型任务：
一句话：
用 aa-human-auth-cdp-flow + anything-analyzer-mcp，若：
典型任务：
一句话：
用 anything-analyzer-mcp，若：
默认优先：
open -a 拉起窗口。若先前 browser-harness / CDP 握手报 HTTP 403，且用户说已经开了 remote debugging，但仍未通，优先让用户在真实 Chrome 中：
chrome://inspect/#remote-debuggingEnable remote debuggingAllow经验：很多场景不是端口没开，而是 Chrome 还没完成一次人工授权；点错或没点 Allow 时，agent 侧会持续像“工具坏了”。
对 browser-harness 场景，http://127.0.0.1:9222/json/version 或 /json/list 返回 404，不能单独证明真实 Chrome 接管失败。
经验：browser-harness 可能通过自身桥接链连到真实 Chrome，而不是直接暴露传统 9222/json/* 端点。若 uv run browser-harness 下的 page_info() 能返回当前真实标签页 URL / title / viewport，则应视为“接管已通”，不要被 9222 的 404 误导。
优先跑极小探针确认是否已接到用户眼前页面：
print(page_info())
若能读到当前真实页面 URL/title，再继续 DOM/交互；先别浪费时间争论 CDP 细节。
若 browser-harness 的通用点击/输入手段在富文本或动态评论框上不稳，直接退到页面 JS：
querySelector 找真实编辑器div[contenteditable="true"] / #contenteditable-root / textarea 手工 focus()textContent 或 valuedispatchEvent(new InputEvent('input', {bubbles:true,...}))此法对 YouTube 评论框一类富文本输入尤其有效；比盲点坐标或反复 type_text 更稳。
如 YouTube 分享 按钮可点但未出现弹层：
button, a, input 看是否已有新控件出现不要仅凭“按钮点击返回成功”就认定分享弹窗已出现。
真实浏览器里做 YouTube comment、Reddit comment、share/comment engagement 时，先执行一次小幅下滚，再判断编辑器是否可用。
固定顺序：
经验：这些区域常见“已点击但无变化”并非 selector 错，而是 viewport 未触发 hydration/refresh。先滚一下，常直接恢复。
若无变化：
若 bb-browser 依赖 BB_BROWSER_HOST / BB_BROWSER_PORT 或同类环境变量，不要只写裸命令；优先在 mcp_servers 中这样配：
mcp_servers:
badboy-browser:
command: /bin/sh
args:
- -lc
- BB_BROWSER_HOST=127.0.0.1 BB_BROWSER_PORT=19825 exec /Users/xxx/.npm-global/bin/bb-browser mcp
理由：有些 CLI 在直配 command 时不会按预期吃到外层环境，shell wrapper 更稳。
即便本地 19825 端口可连，若该端口不提供标准 Chrome DevTools 端点（如 /json/version、/json/list），bb-browser 仍会报：
Cannot find a Chromium-based browser故障判定顺序：
http://127.0.0.1:<port>/json/version 是否返回标准 CDP 信息bb-browser site ... 可用，只说明 adapter/抓取链可用bb-browser open/snapshot/click ... 仍可能因真实 Chrome / CDP 不合规而失败因此验收需分两步：
bb-browser site listbb-browser open ... 或 snapshot前者过，不代表后者已通。
127.0.0.1 404、localhost/[::1] 正常，要两边都试实战里，Chrome 已启 --remote-debugging-port=19825 时，可能出现：
http://127.0.0.1:19825/json/version → 404http://localhost:19825/json/version → 200http://[::1]:19825/json/version → 200原因通常是监听/路由落在 IPv6 或 localhost，而不是纯 IPv4 回环。
排障顺序改为：
http://localhost:<port>/json/versionhttp://[::1]:<port>/json/version127.0.0.1不要因 127.0.0.1 的 404 就误判 “CDP 没起”。
bb-browser status 可能假阴性，直接命令更可信实战里出现过：
bb-browser status --json → {"running":false}bb-browser daemon status → Daemon not runningBB_BROWSER_CDP_URL=http://localhost:19825 bb-browser tab list/open/snapshot 全部成功结论：
status / daemon status 不能单独作为可用性判据tab list、open、snapshot、screenshot 是否成功推荐探针：
BB_BROWSER_CDP_URL=http://localhost:19825 bb-browser tab list --json
BB_BROWSER_CDP_URL=http://localhost:19825 bb-browser open https://example.com --json
BB_BROWSER_CDP_URL=http://localhost:19825 bb-browser snapshot --tab <tab> --json
bind() failed 不必立刻判死实战里，先杀净 Chrome 后再起：
pkill -f 'Google Chrome' || true
pkill -f 'Chrome Helper' || true
'/Applications/Google Chrome.app/Contents/MacOS/Google Chrome' \
--remote-debugging-port=19825 \
--user-data-dir=/tmp/bb-browser-profile
日志可能同时出现：
bind() failed: Address already in use (48)DevTools listening on ws://[::1]:19825/...这类情况常见于 IPv4 绑定失败但 IPv6 仍成功。应以 /json/version 或 tab list 验证，不要只看一行 error 就停。
某些站点（如 YouTube）刚 open 完时：
snapshot 可能只返回 URL，几乎无 DOMsnapshot，才拿到完整 refs / 页面结构做法：
opensnapshot不要把首帧空 snapshot 误判成页面不可控。
macOS 上若只是为了接管真实 Chrome 做 CDP/bb-browser/现场取证，优先用降噪版启动：
pkill -f 'Google Chrome' || true
pkill -f 'Chrome Helper' || true
sleep 2
'/Applications/Google Chrome.app/Contents/MacOS/Google Chrome' \
--remote-debugging-port=19825 \
--user-data-dir=/tmp/bb-browser-profile \
--disable-crash-reporter \
--disable-breakpad \
--disable-background-networking \
--disable-component-update \
--disable-features=MediaRouter \
2>/tmp/chrome-cdp.log
用途：
Crashpad settings.dat 噪声google_apis/gcm ... DEPRECATED_ENDPOINT / connection_factory_impl 噪声常见仍可忽略的残余噪声：
google_apis/gcm/engine/connection_factory_impl.cc:483] ConnectionHandler failed with net error: -2net/socket/ssl_client_socket_impl.cc:924] handshake failed ... net_error -100chrome://newtab/ for incorrect profile typeIPH_ExtensionsZeroStatePromo before browser initialization complete这些日志本身不构成故障；只要下列探针仍通过，就继续执行，不要停在报错字样：
http://localhost:19825/json/versionhttp://localhost:19825/json/listBB_BROWSER_CDP_URL=http://localhost:19825 bb-browser tab list --jsonopen/snapshot/screenshot 实测成功不要因后台噪声消失与否改变可用性判断；判据仍是 CDP 端点与真实操作是否成功。