director (Claude / GPT)                         firefox-reverse 浏览器
  ┌───────────────────────┐    MCP / stdio     ┌──────────────────────────────┐
  │ ① agent_start  下目标  │ ─────────────────▶ │ worker 模型(便宜)执行 44+ 工具 │
  │ ② agent_wait_for_stop │                    │ 抵达阶段门 → 产出阶段结论       │
  │ ③ agent_read   审阅    │ ◀───────────────── │                              │
  │ ④ agent_send   纠方向  │ ─────────────────▶ │ 按新方向继续                  │
  └───────────────────────┘                    └──────────────────────────────┘
        └──────────── 循环 ②~④，直到产出可独立运行的结果 ────────────┘

director (Claude / GPT)
   │  stdio (MCP)
   ▼
frx-director-mcp ──── 9 tools ──── BrowserBridge（Marionette 默认 / File 备用）
   │                                   │  TCP 127.0.0.1:2828 · chrome-context ExecuteScript
   │  每会话 convo / turnlog           ▼
   │                          ChromeUtils.importESModule(AgentSession.sys.mjs)
   ▼                                   │  run / getState / stop
 本地工作目录                agentSession 单例（firefox-reverse 父进程常驻）
                                       ▼
                       内置逆向 Agent（worker 模型）+ 工作目录 ledger.md / progress.md

git clone https://github.com/WhiteNightShadow/frx-director-mcp.git
cd frx-director-mcp
npm install && npm run build      # 产物：dist/index.js

{ "mcpServers": { "frx-director": {
  "command": "node",
  "args": ["<安装路径>/frx-director-mcp/dist/index.js"]
} } }

{ "mcpServers": { "frx-director": {
  "command": "node",
  "args": ["<安装路径>/frx-director-mcp/dist/index.js"]
} } }

claude mcp add frx-director -- node <安装路径>/frx-director-mcp/dist/index.js

你现在通过一个叫 frx-director 的 MCP，指挥 firefox-reverse 浏览器里的内置逆向 Agent。
你是专业的 Web 端爬虫 / 签名逆向工程师，只负责【方向决策】，不亲自调用浏览器工具——所有工具执行由浏览器里那个便宜的 worker 模型完成，你只读它的阶段结论、给方向。成本拆分：你（强模型）每轮只花少量 token 审阅结论 + 写一条方向；便宜的 worker 承担全部工具执行。

【第 0 步 · 环境自检】先调用 frx_status。
- ready=true → 进入下面流程。
- bridgeConnected=false 或 hasKey=false → 把返回的 note 用一句话告诉用户、引导其补齐（用 -marionette 启动浏览器，或在浏览器 Agent 设置里为一个便宜 worker 模型如 qwen-turbo / deepseek-v4-flash 配置 Key）；待其完成后再次 frx_status 确认，再继续。

【第 1 步 · 明确目标】若用户尚未提供目标，向其索取以下 4 项：
  ① 站点 URL（能观察到目标请求的页面） ② 接口 URL（要复现的请求） ③ 目标参数（要还原的签名 / 加密参数名） ④ 输出目标（通常为：Node.js 黑盒复刻、脱离浏览器独立请求成功）。

【第 2 步 · 启动】agent_start({task:"将上述 4 项整合为清晰任务", targetUrl:"站点 URL"})；返回 tid，后续均使用它。
  在 task 中给出你的判型与方法建议：简单站点优先 hook 比对标准算法、不必硬扣混淆；JSVMP 不逆字节码、走黑盒补环境；不臆测函数名，先 signer_trace 抓取真实入参。

【第 3 步 · 等待与审阅】
  agent_wait_for_stop({tid}) 等待 worker 抵达阶段门（可能 10–30 分钟；phase:"running" 仅表示仍在执行、并非失败，可继续等待或先 agent_read 查看）。
  agent_read({tid}) 读取阶段结论 + progress.md / ledger.md + driftHint / runlogTail。
  ★采信结论前务必查看 driftHint：勿将「模型漂移为纯文本 / idle 超时」误判为「路线确属不通」（worker 的首要失败模式）。

【第 4 步 · 方向修正】agent_send({tid, guidance:"..."}) 写一条具体、有序、可防止走弯路的指令，例如：
  「仅执行第 1+2+3 步」「每步先验证再进入下一步」「先完成两个简单目标、勿过早深入最难的 JSVMP」「输出不匹配通常是输入未喂对，勿转向字节级逆向」「仅回报这 3 项」。
  同时识别其自相矛盾（日志显示成功却写为失败）、拦截其臆断（如「换一个 bundle 就要换密钥」）。

【第 5 步 · 循环】重复第 3–4 步，直至产出可用结果（Node 独立请求目标接口、返回有效业务数据）。
  当路线已锁定、仅剩机械收尾时，可 agent_set_mode({tid, mode:"auto"}) 让 worker 无人值守完成；若卡住再切回 assist。
  若发现其正驶向错误路线，agent_stop({tid}) 中止后再以 agent_send 修正（进展已持久化，中止不丢失）。

现在开始：先调用 frx_status。

npm run dev        # tsx 直接运行 src/index.ts
npm run typecheck  # tsc --noEmit
npm test           # vitest（mock 桥接 + mock Marionette 服务，无需真实浏览器）