メニュー
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コマンドは1行のまま表示されます。コピー前に横へスクロールして全体を確認してください。
ローカルで確認しますか？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 端点与真实操作是否成功。