Firefox‑Reverse

一个内置 AI 逆向 Agent 与指纹环境管理器的 Firefox

既能把网页里的加密 / 签名 / 风控参数从「黑盒」做成可独立运行的 Node.js / Python 算法，也能用独立 profile、独立进程管理隔离的浏览器指纹环境。

📥 下载安装（Releases）　·　快速开始　·　指纹环境　·　工具大全　·　从源码构建

---

概述

很多网站发请求时会带一个加密参数——签名 sign、令牌 token、风控指纹等。想在浏览器之外（你自己的 Node / Python 脚本里）复现这个请求，就得搞清楚这个参数是怎么算出来的。这就是 JS 逆向，而它通常很难：逻辑被混淆、塞进 JSVMP（JS 虚拟机保护）、或编译成 WASM，还深度依赖一堆浏览器环境指纹。传统做法要在 DevTools 里手动下断点、补环境、反复试值，耗时且容易兜圈。

Firefox‑Reverse 把这套活儿交给一个内置的 AI Agent。 它住在浏览器侧边栏里，能像一名专业逆向工程师那样自己抓包、读代码、在引擎 C++ 内核层观测、补环境、写脚本、实打接口验证——目标是把一个加密参数还原成你能在 Node.js / Python 里独立运行的算法。

除了逆向 Agent，浏览器还内置了指纹环境管理：每个环境使用独立 profile、独立 Firefox 进程和独立 Marionette 端口，可在侧边栏完成新建、导入、编辑、打开、关闭与删除；环境配置在进程启动时交给 C++ 配置层读取。

与「AI + 普通浏览器自动化」最大的不同：关键观测工具（签名器入参追踪 / JSVMP 逐指令 trace / WASM import 边界 / 引擎级分支差分）深入 SpiderMonkey/Gecko 的 C++ 引擎，不依赖页面内 monkey patch，页面 JS 很难通过常规反射干扰这些观测点。

---

功能预览

内置 AI Agent

• Agent 常驻浏览器侧边栏，当前精确注册 76 个工具，覆盖页面操作、网络抓包与离线回放、固定随机数、代码搜索、Cookie、WebAPI trace、JSVMP、WASM、文件读写、Skills、扩展与环境管理及 Node/Python 实打验证。
• 支持全自动与AI辅助两种工作方式：既可以让 worker 独立推进，也可以由人或外部 MCP director 分阶段领航。
• 工作目录、会话、阶段结论与生成脚本均落在本地；切换标签页或收起侧边栏不会中断正在运行的父进程 Agent。
• 历史抽屉支持单会话 .frx-chat.json 导入/导出；导入会创建静止的新会话，不会自动执行历史任务，也不会携带 API Key、工作目录和环境绑定。
• 模型设置支持命名配置，同一渠道可以保存多组账号、端点、模型与思考等级，后续直接从历史配置切换。
• 侧栏设置支持编辑全局附加 system 提示词，保存在本机浏览器 prefs，同一 profile 的所有模型配置与会话共享；点击“保存并使用”后从下一轮对话生效，留空使用内置提示词。
• 手动停止会留下明确的取消边界，下一条消息默认按新任务处理；只有明确要求继续时才恢复上一项任务。
• 支持从用户目录和工作区发现通用 SKILL.md，用户说“使用某个 Skill”后，Agent 会按需读取方法与附加资源。
• 支持搜索 AMO 扩展、查看已安装状态，并经 Firefox 原生 AddonManager 安装、启停、卸载和打开配置页；配置页可继续用现有页面工具自动填写。

指纹环境管理

• 一个环境对应一个独立 Firefox profile + 独立浏览器进程 + 独立 Marionette 端口，Cookie、历史记录、LocalStorage、缓存和配置互不混用。
• 在侧边栏中可新建、重命名、打开、关闭、删除和导入环境，并查看运行状态、端口、profile 与当前主进程指纹。
• 新建环境只生成与当前 Gecko 内核一致的 Firefox 指纹，浏览器版本和系统跟随实际构建；默认中国大陆简体中文，也可编辑语言、地区与时区。
• 支持粘贴导入 fingerprint.json，非 Firefox 采集结果会规范化为 Firefox 身份；也可修改当前主进程指纹并一键还原默认，配置在进程启动时由 C++ 层读取。
• 当前 C++ 配置覆盖面包括 Navigator、Screen、DPR、语言/时区、UA 与 Accept-Language，以及 WebGL unmasked vendor/renderer 等字段。
• 环境能力同时暴露为内置 env_* 工具；frx-director-mcp 通过对应的 frx_env_* MCP 工具查询、创建、导入和启动指定环境。

当前采用环境级隔离，不是标签页级切换。新建和重新生成不再产出 Chrome-like 指纹，避免浏览器声明与 Gecko 内核能力不一致；历史环境不会被自动迁移或重写。指纹配置按进程启动读取，修改运行中环境后需关闭并重新打开才会完整生效。

---

🚀 快速开始（5 步）

① 下载安装 到本仓库的 Releases 页，按你的系统下载安装包：

系统	文件	安装
Windows	firefox-reverse-v*-windows-x86_64-installer.exe 或 .zip	运行安装器，或解压 ZIP 后双击 firefox.exe（若 SmartScreen 拦截 → 「更多信息」→「仍要运行」）
macOS (Apple Silicon)	firefox-reverse-*-macos-arm64.dmg	打开 → 拖进「应用程序」；首次打开若提示「已损坏」见下方 ⚠️
macOS (Intel)	firefox-reverse-*-macos-x86_64.dmg	适用于 Intel Mac（macOS 10.15+）；安装方式同上
Linux (x86_64)	firefox-reverse-v*-linux-x86_64.tar.xz	解压，运行 ./firefox
Linux (ARM64)	firefox-reverse-*-linux-arm64.tar.xz	适用于 ARM64 / AArch64 Linux；解压，运行 ./firefox

⚠️ macOS 首次打开提示「"Firefox Reverse" 已损坏，无法打开」？ 这不是真的损坏 —— 本浏览器是自签名应用、未做 Apple 付费公证（$99/年），从浏览器下载后会被系统打上「隔离」标记，Apple Silicon 上就报这个。打开「终端」执行一行去掉隔离即可正常打开：

xattr -dr com.apple.quarantine "/Applications/Firefox Reverse.app"

（路径换成你的实际安装位置；或：系统设置 → 隐私与安全性 → 拉到底点「仍要打开」。）

② 打开 AI 侧边栏 启动浏览器 → 点击浏览器右上角的 Firefox‑Reverse 星光图标，打开 Agent 面板。若图标暂时不可见，先点地址栏左侧的侧栏按钮展开侧栏。

③ 配置模型账号（配置一次，后续直接切换） 点面板右上角 ⚙️ 设置 → 新建或选择一个命名配置，再填写供应商、API Key 和模型：

• 内置支持 DeepSeek、智谱 GLM、Kimi（Moonshot）、MiniMax、通义千问（Qwen）；自定义端点可选择 OpenAI Chat Completions / OpenAI Responses / Anthropic Messages / Gemini GenerateContent，接入 OpenAI、Claude、Gemini 或兼容服务。
• 同一个渠道可以保存多个账号，例如“GPT 工作账号”“GPT 个人账号”，选择后从下一轮对话开始生效。

💡 模型选型建议：简单 / 小站点用便宜模型（如 DeepSeek）即可上手；遇到复杂 / 大站点，弱模型在长链路里容易走弯路——这类目标建议用「自定义模型」端点接入 Opus 4.8 或最新旗舰模型，逆向推进更稳、少绕路。

④ 新建会话 → 选模式 点「新对话」，会弹出选择卡：

• ⚡ 全自动 —— 给它目标接口/参数，它一条龙自己搞定（适合放着跑）；
• 🧭 AI辅助 —— 它先出方案、每做完一个阶段就停下、给你方向选项，你来拍板、逐步推进（适合边看边学、复杂目标）。

⑤ 把目标告诉它 按下面这个格式把任务说清楚（信息越具体，AI 越少走弯路）：

【站点URL】https://example.com/list          # 能看到目标请求的页面
【接口URL】GET https://example.com/api/v1/list?page=1   # 你最终想复现的请求
【目标参数】请求头里的 X-Sign（签名）。若还有其他动态参数（时间戳 / 设备指纹 / token 等）一并列出
【输出目标】① 黑盒可用版：用 Node.js 还原参数生成算法，脱离浏览器独立把接口请求成功
　　　　　　② 白盒纯算版：进一步把它还原成不依赖原始混淆代码的纯 JS 实现（可选）

然后看它自己抓包、定位、补环境、实打验证。产物（脚本、还原代码、笔记）都会落到你为这个会话指定的工作目录里。

• 签名 / 加密参数：请求里一段算出来的字符串（如 sign token X-Bogus），服务端用它校验请求是否合法。
• 补环境：签名算法常依赖浏览器特有的东西（navigator、DOM、crypto 等）。在 Node 里把这些「假装」提供出来，让算法能跑，就叫补环境。
• JSVMP：把 JS 编译成自定义「字节码 + 解释器」，看不到原始逻辑、极难读，是常见的强保护。
• WASM：把算法编译成二进制模块，浏览器直接执行，源码不可见。
• 白盒纯算：彻底搞懂算法、用普通代码重写，最终不再需要原始的 JSVMP/WASM 二进制。
• 工作目录：你为一个会话指定的本地文件夹，Agent 的抓取脚本 / trace / 还原代码 / 进度笔记都存这里。

🪪 使用指纹环境（可选）

1. 打开 Agent 侧边栏，点击醒目的环境管理入口。
2. 点击一键新建环境，或把外部浏览器采集到的 JSON 粘贴导入；已建环境可继续重命名和编辑指纹配置。
3. 选择环境后打开。Firefox-Reverse 会为它分配独立 profile、独立进程和可用的 Marionette 端口；再次打开同一环境会继续使用原 profile 中的 Cookie、历史记录、收藏与站点存储。
4. 修改已运行环境的指纹后，先关闭该环境再重新打开。修改当前主进程指纹后，完整退出并重新启动 Firefox-Reverse。

环境数据默认保存在 ~/.firefox-reverse/environments，其中 manifest.json 记录环境索引，每个环境目录保存 env.json、fingerprint.json、proxy.json、profile/、traces/、control/、captures/ 和 logs/。删除环境会同时删除其独立 profile，请先确认不再需要其中的登录态和站点数据。

---

✨ 核心亮点

• 🧠 内置自主 Agent —— 不是聊天框，是能连续调用 76 个工具、自己跑完「抓包→定位→验证→补环境→实打」全流程的逆向智能体。
• 🪪 指纹环境隔离 —— 一个环境一个 profile + 独立进程，支持环境 CRUD、指纹生成/导入、主进程指纹与 MCP 指定环境启动。
• 🔬 引擎层观测工具 —— 签名器入参、JSVMP 逐指令、WASM import 边界、浏览器真值 vs Node 复刻的分支差分深入 C++ 引擎，减少页面内 hook 和反调试对分析过程的干扰。
• 🎛 两种工作模式 —— 全自动一条龙 / AI辅助逐阶段（你领航），按会话持久化、随时切换。
• 🌐 站点无关 —— 面向通用 JS / JSVMP / WASM / 签名逆向，不为任何特定网站定制；案例只是测试样例。
• 🔌 任意大模型 —— DeepSeek / 智谱GLM / Kimi / MiniMax / 通义千问，以及自定义 OpenAI Chat Completions、OpenAI Responses、Anthropic Messages 和 Gemini GenerateContent 端点；Key 保存在本地并直连所选服务。
• 🗂 会话与配置迁移 —— 单会话 JSON 导入/导出，模型账号按命名配置保存和切换；导出的会话文件不包含模型 API Key。
• 🧰 通用 Skills —— 从 ~/.firefox-reverse/skills、工作区 .agents/skills 和 .firefox-reverse/skills 发现 SKILL.md，按任务需要加载正文和 references。
• 🧩 Firefox 扩展管理 —— Agent 可搜索 AMO、查看安装状态、管理用户扩展生命周期并打开配置页；安装只接受 AMO 记录且继续经过 Firefox 哈希、兼容性、阻止列表与签名校验。
• 💾 跨会话记忆 —— 确认过的事实 / 踩过的坑沉淀进内置 SQLite，下次不再兜圈。
• 🧩 常驻引擎 —— 对话引擎跑在父进程系统模块，切换标签页或收起侧边栏不会中断，多窗口工作目录互相隔离。

---

🤖 两种工作模式

首次新建会话时选择，整条会话沿用（顶部模式标可随时切换）：

	⚡ 全自动	🧭 AI辅助
节奏	给目标 → 一条龙跑到底	先出方案 → 逐阶段停下 → 你选方向
打扰	中途不打扰，只在真需要你（登录态/验证码/纯业务决策）或完成时停	每做完一个阶段（入口定位 / 字节trace / DOM-API分析 / 构造实现）就停下汇报、给 2–3 个方向选项
适合	放着跑、目标清晰、信任模型	复杂目标、想边看边学、想自己把控方向
价值	省心	弱模型 + 人类领航 = 少走死路，复杂案例更稳

🧭 AI辅助模式的「领航」可以是人，也可以是另一个强模型 —— 两种玩法：

• ① 人工领航 —— 你读它每个阶段的结论、给方向修正，手把手把它从弯路里带出来。

• ② MCP 自动领航（成本拆分） —— 让一个强模型 director（Claude / GPT 等最新旗舰）通过 MCP 自动「指挥」浏览器里这个内置逆向 Agent：浏览器 Agent 由一个便宜的 worker 模型（如 DeepSeek / 通义千问 / GLM）在 AI辅助模式下实操、磨所有工具活；director 只读阶段结论、做方向修正，不亲自跑工具。贵模型的判断力 + 便宜模型不知疲倦地磨工具，按 token 成本拆分（贵模型每轮只花一点点，便宜模型付掉所有 grinding）。 配套 MCP 仓库 → frx-director-mcp（开箱即用：接好 MCP 后，把它 README 里的「🟢 一键贴给你的 AI」那一整段复制给你的 director，它会自己自检环境、缺啥用一句话引导你补齐、然后自动建目录 / 选 AI辅助 / 新建会话 / 下任务 / 读结论 / 回怼方向、循环到出结果——你只需在它问的时候给目标站）。

  💡 worker 模型选型（重要）：MCP 这种长工具循环里，worker 务必用标准 / 快速档，推荐 deepseek-v4-flash —— 实测零漂移、约 2–3 分钟/阶段、配合最顺。切勿用推理档（如 deepseek-v4-pro）：推理档在长循环里易退化成「只吐纯文本计划、不再调用工具」而中断，是 worker 的首要失败模式。可在浏览器 Agent ⚙️ 设置里把 worker 设为该档，或让 director 在 agent_start({ model: "deepseek-v4-flash" }) 里临时指定（同一个 Key、无需改配置）。

  Windows 工具接入自检：若外部 AI 的函数列表里只有 open_url，这是宿主自己的工具，表示 frx-director-mcp 没有完成初始化；升级到 MCP v0.3.6+。正常顶层工具应包含 frx_status、agent_tools、agent_call_tool；notes_add、net_get、page_click、run_node、fs_* 等浏览器内核工具通过 agent_tools 查询并由 agent_call_tool 直调。

---

🎯 二阶段：黑盒可用 → 白盒纯算

Agent 的推进遵循一条务实路线——先拿到能用的，再追求吃透的：

1. 黑盒可用版：Node 补环境跑原始 WASM/JSVMP，以「本地生成的签名实打目标接口、服务端返回有效数据」为准。✅ JSVMP / WASM 两种载体都成熟。
2. 白盒纯算：把内部算法抠出来、纯代码重写，彻底不依赖原始二进制。✅ JSVMP 工具链齐全且实战验证；WASM 提供反汇编（WAT）+ 引擎级分支诊断，可深入分析。

---

🧰 工具大全（76）

当前版本由 Tools.sys.mjs 精确注册 76 个工具，下表与代码声明一一对应：

类别	工具	说明
页面自动化（14）	page_navigate page_click page_scroll page_type page_eval page_screenshot page_elements page_info page_automation_scan page_frames page_snapshot page_find page_determinism page_console	导航、交互、执行 JS、截图、元素与自动化特征自检；语义定位、短引用、跨域嵌套 iframe；固定页面随机数，node复刻能拿到同一串值（说明）；读页面控制台消息和脚本错误
网络 / 入口定位（6）	net_capture net_list net_get net_replay hook_inject find_param_entry	抓包、读取请求详情与发起者调用栈、用录好的响应离线回放（可存取har）、document-start 注入 hook、定位动态参数入口
代码 / 脚本（4）	code_search scripts_list scripts_save scripts_capture_all	搜索页面语料和工作目录、枚举与落盘脚本
签名器 / 闭包追踪（3）	signer_trace closure_read debug_breakpoint	从引擎调试通道读取签名函数真实入参与闭包变量真值；按源码片段、行号或请求下快照断点，命中不暂停，抓实参、作用域变量和调用栈（说明）
WebAPI trace（2）	webapi_trace webapi_query	记录并查询页面读取过的 Navigator、DOM、Canvas 等 WebAPI
JSVMP 白盒（5）	jsvmp_trace jsvmp_query jsvmp_status jsvmp_split_dispatcher jsvmp_disassemble	逐指令 trace、查询状态、拆分派发器、解码字节并反汇编
密码学识别（1）	crypto_scan	识别 RC4、XXTEA、MD5/SHA、AES、SM4 与自定义 Base64 等常量特征
WASM（2）	wasm_probe wasm_disasm	观测 WASM import 边界并把二进制反汇编为 WAT

---

🖥 平台与下载

平台	架构	状态
Windows	x86_64	✅ 提供安装包（持续完善中，欢迎反馈）
macOS	Apple Silicon (arm64)	✅ 提供安装包
macOS	Intel (x86_64)	✅ 提供安装包
Linux	x86_64	✅ 提供安装包
Linux	ARM64 (AArch64)	✅ 提供安装包

安装包在 Linux 构建机上交叉编译（macOS arm64 / macOS x86_64 / Windows64 / Linux x86_64 / Linux ARM64）后发布到 Releases。macOS 两种架构使用独立对象目录构建，并在发布前校验 DMG 内主程序架构与签名；Linux 包会校验 ELF 架构和内置 Agent / 指纹环境模块。

---

🏗 从源码构建

只想用的话直接去 Releases 下载即可，无需自己编译。

本仓库是 Firefox 的「补丁集」（additions/），不含 Firefox 源码本身。构建流程：

# 1. 取得锁定的 Firefox 153.0a1 源码到 upstream/（首次）
bash scripts/bootstrap.sh

# 2. 应用补丁集：git 补丁、侧栏 bundle、additions 同步、指纹与 phase-b 源码补丁（可重复执行）
bash scripts/apply-patches.sh

# 3. 编译 + 打包
cd upstream && ./mach build && ./mach package

• 侧边栏与父进程后端：additions/browser/components/agent-sidebar/；React UI、Agent 引擎、76 个工具声明、AddonBackend.sys.mjs 和 EnvironmentBackend.sys.mjs 均在此维护，前端通过 npm run build 生成 bundle。
• 指纹配置层：additions/dom/base/FrxFingerprintConfig.*、NavigatorUAData.* 及 scripts/apply-fingerprint-config.py 写入的 Gecko / Necko 接入点。
• 引擎观测层：additions/js/... 的 SpiderMonkey trace 与 additions/dom/bindings/... 的 WebAPI trace。
• 环境数据不写进仓库或构建目录，运行时默认落在 ~/.firefox-reverse/environments。
• 正式包由编译机上的 scripts/release-build.sh 出，编译机准备见 docs/build-host.md，发布流程见 docs/release-process.md；五个目标的编译选项在 configs/mozconfig.*。push / PR 时 .github/workflows/ci.yml 跑自测，并在锁定基线上把补丁流程跑两遍。

---

🏛 架构

┌─────────────────────────── Firefox‑Reverse ───────────────────────────┐
│                                                                          │
│  侧边栏 React UI (omni.ja)                                               │
│  ├ Agent 对话 / 模式选择 / 工作目录                                      │
│  ├ 指纹环境列表 / 配置编辑 / 主进程指纹                                  │
│  └ 订阅父进程快照，面板重载不丢 Agent 会话                               │
│                                                                          │
│  常驻引擎（父进程系统模块, .sys.mjs）                                     │
│  ├ AgentSession / AgentLoop   会话、工具循环、上下文压缩                  │
│  ├ ToolRouter / Tools         76 个工具的声明与路由                       │
│  ├ AddonBackend               AMO 搜索、扩展生命周期与配置页              │
│  ├ EnvironmentBackend         环境 CRUD、配置、进程与端口状态             │
│  └ ConfigStore / Memory       本地配置与 SQLite 跨会话记忆                │
│                                                                          │
│  环境运行时 (~/.firefox-reverse/environments)                            │
│  ├ manifest.json + 每环境 env/fingerprint/proxy/control/traces/logs      │
│  └ 每环境独立 profile + Firefox 进程 + Marionette 端口                    │
│                                                                          │
│  Gecko / SpiderMonkey C++                                                │
│  ├ FrxFingerprintConfig       启动读取，覆盖 Navigator/Screen/Intl/HTTP   │
│  │                            UA-CH/WebGL 等已接入字段                     │
│  ├ JSVMP 逐指令 trace         SpiderMonkey 解释器观测                     │
│  ├ WebAPI trace               DOM binding 边界观测                        │
│  └ whitebox_diff              覆盖率与分支差分                            │
└────────────────────────────────────────────────────────────────────────┘

输出一：隔离、可复用、可由 UI / Agent / MCP 管理的指纹浏览器环境
输出二：经过实打验证、可脱离浏览器运行的 Node.js / Python 算法

---

❓ FAQ

• 要不要懂编译 / 配环境？ 不用。下载 Releases 安装包即可，配个大模型 Key 就能用。
• 支持哪些大模型？ 内置 DeepSeek / 智谱GLM / Kimi（Moonshot）/ MiniMax / 通义千问（Qwen）；自定义端点支持 OpenAI Chat Completions、OpenAI Responses、Anthropic Messages 和 Gemini GenerateContent。Key 只存本地。
• 我的 Key / 数据会上传吗？ Key 保存在本地并由 Firefox-Reverse 直连你选择的模型服务，不经过项目作者的中转服务器。Agent 工作时会按任务需要把提示词、页面片段和工具结果发送给该模型服务；敏感任务请使用你信任或自托管的兼容端点。
• 环境之间真的隔离吗？ 每个环境拥有独立 profile、进程和 Marionette 端口，Cookie、历史记录、收藏、LocalStorage 与缓存分别持久化。它们仍运行在同一台操作系统上，不等同于虚拟机级隔离。
• 为什么保存指纹后页面没有立刻变化？ C++ 配置按进程启动读取。普通环境需要关闭后重新打开；当前主进程需要完整退出并重新启动 Firefox-Reverse。
• 还能新建 Chrome-like 环境吗？ 不再支持。新建、重新生成和采集导入都会收敛为与当前内核一致的 Firefox 身份；已经存在的历史环境文件保持原样，不会被自动改写。
• 可以由外部 AI 管理环境吗？ 可以。内置 Agent 具备 18 个 env_* 工具；配套 frx-director-mcp 提供 frx_env_* 工具用于列表、新建、打开、关闭、删除与导入，并可用 FRX_ENV_ID 绑定指定环境启动。
• 全自动和 AI辅助选哪个？ 目标清晰、信任模型 → 全自动；复杂 / 想把控方向 / 想学 → AI辅助。
• 能保证破解任何站点吗？ 不能。强保护（深度 JSVMP / 自带密钥的 WASM）依然很难；本工具是把分析效率拉满，不是银弹。

---

⚖️ 法律与授权声明

本项目是面向安全研究、接口对接、授权测试的逆向分析工具。使用者须对自己的行为负责：

• 仅在你拥有合法授权的目标上使用（你自己的平台、获得授权的测试对象、CTF / 教学等）。
• 不得用于未授权访问、绕过他人系统的安全机制、大规模抓取或任何违反目标方服务条款 / 当地法律的行为。
• 作者与贡献者不对任何滥用行为负责。下载即表示你已理解并同意上述条款。

---

📝 版本更新记录

main（尚未发布）

• 页面交互走原生输入：page_click、page_type改走firefox原生输入通道（与webdriver同一条路）：鼠标沿曲线移到元素上再按下抬起，页面收到isTrusted的pointer/mouse/click序列；逐字按键，大写和符号按住shift，中文走输入法提交，submit发原生回车。只点元素露在最上层的位置，被盖住时返回target_obscured并写明遮挡物。旧的selector/text写法照常可用。（说明）
• 离线回放与固定随机数：net_capture可录响应体（解码后），net_replay用录制回答之后的请求、不走网络，没录到的默认拦截，可存取har；page_determinism固定页面的Math.random和crypto随机数，同输入得到同一个签名，replica把同一串随机数的node版写进工作目录给复刻用。都在引擎层实现，页面看到的仍是原生函数。（说明）
• 模型协议：自定义模型端点新增 OpenAI Responses API 与 Gemini 原生 GenerateContent；支持流式文本、function calling、图片输入、工具循环和思考摘要（模型或网关不认时自动去掉重发并记住）。Gemini 的工具声明走标准 JSON Schema（parametersJsonSchema），思考预算随模型默认；并行同名调用、被输出上限截断的调用、服务端判定无效的调用都有专门处理，不会静默丢调用。Responses 只在开启思考时带 include，非推理模型照常可用。感谢 @awaxiaoyu 实现两个协议。
• 调试工具：debug_breakpoint按源码片段、行号或请求url下快照断点，命中不暂停页面，抓实参、作用域变量、指定变量的深序列化和调用栈；page_console读页面的console消息和脚本错误；clear_site_data按站点清cookie、存储、缓存、权限和认证状态。（说明）
• 出包：release-build.sh为每个目标写build-record.<目标>.json（提交、基线、l10n、mozconfig哈希、configure参数、工具链版本、产物哈希），也能在mac上出mac包；五个目标的mozconfig入库。内置逆向skill补了反混淆（webcrack）和弹窗、等待条件的处理。工具现为76个。

v0.26.2（正式版，2026-10-24）

• macos数据目录（issue #18）：默认的~/Library/Application Support/Firefox被系统拒绝访问时（如macos 27），改用独立目录FirefoxReverse：已有profile就原地接续，没有就新建配置并在侧栏提示一次；旧目录不读、不复制、不删除。磁盘满、i/o错误、只读卷、路径被文件占用、注册表损坏，以及显式MOZ_APP_DATA不可读时仍停止并给出诊断。感谢@leihualiang报告问题、@odtu945定位根因并在真实macos 27拦截环境中实测预览版（社区记录，启动说明）。
• 环境关闭：先走环境内退出通道，外部mcp/webdriver占着环境的marionette时也能让环境浏览器正常退出，cookie、localstorage照常落盘，runtime.closedBy记录走了哪条路。环境进程只认命令行里本环境的profile，pid被复用时一个信号都不发。windows上修复了找不到系统工具导致主浏览器重启后环境状态卡住、无法重开的问题。
• 侧栏与工具：流式回复按块增量渲染，长回复时主线程最大卡顿从56–71ms降到17–18ms。多窗口下查看外部agent会话改为只读并可接管。需确认的工具补齐run_node、run_python、npm_install、fs_write、fs_copy和改环境配置的env_*，会在宿主node里执行页面代码的js_trace、wasm_probe也需要确认；scripts_save只抓http(s)、data、blob。
• 指纹与构建：指纹配置保存前按引擎约束校验，关闭指纹覆盖时仍隐藏webdriver，native环境的tls/quic恢复出厂值。windows默认关闭内容沙箱，与macos、linux一致；apply-patches.sh可重复执行，ci在锁定基线上把补丁流水线跑两遍。
• 最终包验收：五目标六包统一SourceStamp adeb5100a6d43382bd0e26e9ab8461dcadbdbd79、BuildID 20261024082441。mac arm64/intel、windows x86_64、linux x86_64/arm64指纹回归分别通过213/197/212/182/182项，各通过33项页面/agent检查和8类提示词场景/11条合成请求（原生ci）。mac arm64另通过15个数据目录场景（含#18两类情况）、环境退出通道和从v0.26.1原位升级检查；windows另在真机上通过退出通道、进程身份核对和重启后状态恢复。验证摘要。
• 安装包：v0.26.2 Release提供五目标六个安装/便携包；升级前完整退出旧应用，替换原位置的应用，保留现有profile与指纹环境目录。macos包为ad-hoc签名，未做apple developer id公证。

v0.26.2-preview.1（macOS 启动候选修复）

• Issue #18：为 macOS 默认数据目录增加受限恢复，访问拒绝时可原地接续已有 FirefoxReverse 独立 profile，并记住选择与独立缓存；可用旧目录和显式覆盖保持兼容，不搬迁、清空或解锁用户数据。
• 边界与诊断：权限错误不再当成目录缺失；磁盘故障、路径冲突、备用注册表损坏不自动换目录。只读诊断补充 MOZ_APP_DATA/MOZ_LOCAL_APP_DATA 和独立目录状态。
• 预览范围：本轮先提供 ARM64 候选验证，macOS 27 原问题仍待反馈用户实机确认，不替换 v0.26.1 稳定版推荐。详见启动说明。
• 最终包验收：macOS 26.7.1 ARM64 通过 15 项原生目录/故障场景、5 项旧启动边界、213 项指纹检查、33 项页面/Agent 检查，以及 8 类全局提示词场景（11 条合成模型请求）。验证摘要；ARM64 预览安装包。实际 macOS 27 TCC 行为尚待报告者确认，Issue #18 保持开放。

v0.26.1（正式版，2026-10-12）

• 全局附加 system 提示词（PR #21）：感谢 @awaxiaoyu 的贡献。侧栏设置可保存多行提示词，同一 profile 的模型配置和会话共享；追加到内置 system 后，从下一轮用户对话生效，当前任务与自动续跑保持原快照，避免重复追加。默认留空或清空后沿用内置提示词，不迁移旧用户配置。
• 最终包验收：五个平台均通过 8 类提示词场景、11 条本地合成模型请求，包内资源前后未修改且与固定源码一致。原有指纹检查按 Mac ARM64/Intel、Windows x86_64、Linux x86_64/ARM64 分别通过 213/197/212/182/182 项，各另通过 33 项页面/Agent 检查。原生 CI 与报告。
• 升级与范围：Mac 完成 5 类启动边界和 7 项隔离升级检查，保留旧会话、模型配置、书签、cookie/localStorage；Windows 完成 6 次截图/退出与 Ledger 回归。新提示词仅作用于浏览器内 Agent，不改网页、指纹或外部 CLI 自身的 system。无头 Intel/Linux 的 GPU/MSAA、Linux 缺失字体及真实付费模型不在本次验证范围内，详见验收说明。
• 安装包：v0.26.1 Release 仅提供五目标六个安装/便携包；升级前完整退出旧应用，保留现有 profile 与指纹环境目录。

v0.26.0（正式版，2026-10-11）

• 页面定位（Issue #15）：新增 page_frames/page_snapshot/page_find，支持 role/name/label、open shadow root 和跨域嵌套 iframe；page_click/type/scroll 可使用短引用，跳转后旧引用失效。坐标点击使用选定 frame 的 viewport CSS 像素，截图返回坐标系与缩放信息。旧 selector/text 调用保持兼容，工具总数 71。见页面定位。
• 启动兼容（Issue #18 排查支持）：独立环境补充有效的 -new-instance；默认 profile 确认丢失时提供原生管理器供用户选择，不自动迁移、重置或解锁。增加只读环境/安装默认项诊断。报告者 macOS 27 根因仍未确认，不把相关日志或启动参数当作完整修复证明。
• 品牌构建校验：显式选择 Firefox Reverse 品牌目录，校验构建配置与最终包内名称、首页/关于页图标、字标、语言品牌名及 macOS 图标；发现 Nightly 回退时阻止发布。只收集当前对象目录产物，详见品牌构建说明。
• 配套 MCP v0.4.0：启动分组 all/direct/delegate，默认 23 个入口不变；工具目录支持按需过滤，不强制 Agent 工作流。
• 多平台验收：macOS ARM64/Intel、Windows x86_64、Linux x86_64/ARM64 原生指纹检查分别通过 213/197/212/182/182 项，每个平台另通过 33 项页面/Agent 检查。Mac ARM64 与 Linux x86_64 各通过 5 类启动边界；Windows 另通过 6 次截图/退出及 Ledger 回归。CI 记录与报告。Intel Mac/两种 Linux 的无头 runner 未验证 GPU/MSAA，Linux 缺少 Arial/Times 字体用例；结果不代表第三方网站通过率或 macOS 27 原问题已解决。
• 正式安装包：v0.26.0 Release 提供五目标六包，附件仅保留安装/便携包。macOS 为 ad-hoc 签名，未作 Apple Developer ID 公证。覆盖安装前完整退出旧应用，保留原有 profile 与指纹环境目录。

v0.25.0（2026-09-17）

• 侧栏文字大小（Issue #17）：设置中新增 90%–180% 字号比例及默认复位，覆盖聊天、Markdown、设置和环境编辑；按 profile 持久化，不修改网页缩放或指纹 DPR。
• 启动诊断（Issue #18 排查支持）：新增只读 macOS 启动诊断，区分用户数据目录、指纹 JSON 和应用包缺失；保留用户 profile，不自动重置。macOS 27 专属问题尚缺复现信息，未标为已解决。
• 原生一致指纹：新环境默认跟随实际 Firefox 身份和 Screen/DPR/GPU，旧环境保留历史策略；新增一次性配置缓存、父子快照和 Windows Unicode 读取，修正生成的 appVersion。侧栏提供 Canvas software、WebGL MSAA、已安装字体白名单和 opt-in Offline Audio seed；完整显示模拟与跨内核身份暂不开放。见原生一致策略。
• 快速退出边界：移植 Mozilla 已重新落地的 HiddenXULWindow 退出处理，避免窗口初始化等待在退出时悬挂；本机 Mac 与 Windows runner 各通过六次新 profile 截图/退出，补充扩展后台、DevTools 描述符和卸载回归。此项不代表已经确认 #18 的根因。
• 本轮验收范围：macOS ARM64 213 项、Intel Mac 197 项、Windows 212 项、Linux x86_64/ARM64 各 182 项原生检查通过；68 个浏览器工具注册正常，抽样执行 Agent 文件/页面/环境管理及 cookie 隔离，配套 MCP v0.3.8 验证 23 个入口工具。Intel Mac/两种 Linux 的无头 runner 未验证 GPU/MSAA，Linux 缺少 Arial/Times 字体用例；详见验证报告与CI 记录。
• AI 结果 Markdown（Issue #14）：历史结果、已完成步骤、执行中的正文和思考段统一支持标题、加粗、列表、任务清单、引用、代码块和 GFM 表格；代码与宽表格在侧栏内横向滚动，支持深浅主题和未闭合的流式 Markdown。
• 展示与链接边界：原始对话、导出 JSON 和模型上下文不变；原始 HTML 作为文本显示，网页链接打开普通标签页，内部/可执行/文件链接不启用，Markdown 图片显示为可点击说明，工具截图沿用原展示方式。
• OpenCode Go 请求兼容（Issue #13）：访问官方 OpenCode API 时自动发送自身 User-Agent 和每个会话稳定的 x-opencode-session；普通对话、工具循环、流式/重试、交接摘要和 ContextProjection 共用持久会话 ID。其它供应商的请求头保持原行为。
• 配置方式：模型设置选择“自定义”，Base URL 填 https://opencode.ai/zen/go/v1，按 OpenCode 官方端点表 选择 OpenAI Chat Completions 或 Anthropic Messages 协议及模型名，并填写 Go Key；无需手填 UA 或 Session ID。当前版本可为支持 Responses API 的其它端点选择 OpenAI Responses 协议；OpenCode Go 的 Responses 兼容性未验证。自建转发域名不自动识别为 OpenCode。
• 验证范围：本地 HTTP 协议回归覆盖同/不同会话、历史重载、导入、流式、重试及摘要请求；真实 Firefox 临时 profile 验证请求头能在网页指纹 UA 启用时正确发出。尚未使用 Go 付费账号进行线上推理验证。

v0.24.1（2026-09-04）

• Ledger SQL 防御性加固：确认外部 PR 报告不是当前可利用的 SQL 注入；workspace/site 列名原本只来自内部固定枚举，所有业务值也已参数绑定。本版进一步改为完整固定 SQL allowlist，未知作用域列直接 fail-closed，消除静态扫描歧义。
• 去重删除保持原子性：ID 列表仍通过单条 DELETE ... IN (?,...) 数组绑定执行；SQL 文本只按内部结果数量生成占位符，不拼接任何 ID 值，保持原有单语句语义和性能。
• 回归门禁：新增作用域 SQL、恶意值、多 ID 批量删除和非法数量专项自测，并纳入 Agent 全量自测。
• 兼容性：不改变账本数据库结构、记忆内容、去重规则、120/60 容量限制、Agent 工具接口或浏览器指纹能力。

v0.24.0-beta.2（2026-09-02）

• 多端构建一致性修复：补回干净 Firefox 基线中 Agent 侧栏的 makeSidebar 注册块，并增加构建门禁，避免长期增量源码树可见、全新源码树却缺少侧栏入口的差异。
• 发布溯源一致性：强制刷新各对象目录的 buildid.h 与 source-repo.h，避免增量构建出现新 BuildID 搭配旧 SourceStamp；五端产物必须同时匹配本次提交和统一 BuildID。
• 兼容性：不改变扩展工具、ContextProjection、历史会话、模型配置、指纹环境或 C++ 行为；beta.1 的功能与文件协议保持兼容。
• 多端复验：使用同一锁定基线重新构建并验证 macOS ARM64/Intel、Windows x86_64、Linux x86_64/ARM64 产物。

v0.24.0-beta.1（2026-09-02）

• Firefox 扩展 Agent 能力：新增 addons_query / addons_manage，支持 AMO 搜索、列出已安装扩展、查看状态、安装、启用、禁用、卸载与打开配置页面；打开后继续复用 page_info / page_elements / page_click / page_type 做配置自动化。
• 最小权限边界：安装只接受 AMO slug/GUID/数字 id，强制透传 AMO SHA-256 并要求 Firefox 返回有效签名状态；任意 XPI URL、系统/应用内置扩展修改和任意扩展内部业务 API 不开放。扩展管理沿用工具确认，安装和卸载还必须显式传 confirm:true。
• Token 与缓存优化 beta：增加多 Provider Usage 统计、稳定提示前缀和 OpenAI/Anthropic 原生缓存；长会话使用持久化 ContextProjection，大工具输出折叠到 .frx-context/tool-results/，完整 UI 历史不删除。设置中可随时切回“旧完整历史”。
• 兼容性：原 66 个工具名称和参数不变，仅追加 2 个扩展工具；会话导入导出、环境管理、Agent/MCP 工具循环及 C++ 指纹行为保持原协议。
• 可复现构建：修复全新源码树遗漏 browser/components/agent-sidebar 父级注册的问题；Release workflow 固定 Firefox cebc55aab4d 基线并停止吞掉补丁失败，避免不同构建机误用更新后的 Mozilla main。

v0.23.1（2026-08-20）

• Windows MCP 工具接入兼容：配套 frx-director-mcp v0.3.6 将 stdio 注册提前到环境解析、端口分配和 Firefox 冷启动之前，修复外部 AI/CLI 超时后只剩宿主 open_url 的问题。
• 66 工具目录一致性：MCP 改为读取浏览器真实 backend 注册表，agent_tools 返回完整 66/66，并通过 missingDeclared 暴露打包或后端缺失；顶层 MCP 工具与浏览器内核工具的调用边界已在文档中明确。
• 可核验发布标记：安装包内置 extensions.firefox-reverse.version=0.23.1，五端统一使用新 BuildID；新增 force-build-id-relink.sh，避免增量构建只更新 ini、运行时 XUL 仍携带旧 BuildID。
• 兼容性说明：Firefox v0.23.0 浏览器包本身未丢工具，问题来自配套 MCP 的启动顺序与旧目录 stub；本版不改变指纹、profile、Agent 执行或 C++ 行为，仅同步版本、排障说明并重新验证多端安装包。

v0.23.0（2026-08-14）

• 会话迁移：历史抽屉支持单会话 .frx-chat.json 导入/导出；导入会生成新的静止会话，不携带模型配置中的 API Key、工作目录、环境绑定和运行状态，也不会自动重放历史任务（对话正文及其中用户自行粘贴的内容会保留）。
• 多账号模型配置：模型设置支持命名配置的新建、复制、删除和即时切换，同一个 GPT/DeepSeek/Anthropic 渠道可以分别保存多组账号、端点、模型和思考等级；旧版当前配置自动迁移并继续兼容。
• 手动取消边界：停止任务后持久记录 cancelled 状态，下一条消息默认作为新任务，不再自动续做已取消事项；用户明确说“继续上一项任务”时仍可恢复。
• 通用 Skills：新增 skill_list、按名 skill_get 和 skill_read_resource，发现用户目录及工作区 .agents/skills / .firefox-reverse/skills；无参数 skill_get 保持原内置逆向方法论行为。
• 多端发布：同步提供 macOS Apple Silicon / Intel、Windows x86_64、Linux x86_64 / ARM64 安装包与统一 SHA256 校验文件。

v0.22.4（2026-07-29）

• 新环境回归 Firefox 指纹：新建、重新生成和外部采集导入只产出与当前 Gecko 版本及真实操作系统一致的 Firefox 身份，不再新建 Chrome-like 环境。
• 中国大陆中文默认值：新环境默认 zh-CN、Asia/Shanghai 和简体中文语言组，环境详情仍可自定义语言、地区与时区；浏览器界面和右键菜单随安装包提供简体中文资源。
• 原生菜单坐标修复：指纹中的 screen.* 与 devicePixelRatio 只覆盖网页内容，不再污染浏览器 chrome/XUL 的真实显示器坐标；修复多屏和缩放场景下右键菜单远离鼠标的问题。
• 历史环境保持兼容：已有环境不自动迁移、不覆盖原 fingerprint.json，原有 profile、Cookie、收藏、历史记录和自动化链路继续沿用。
• 环境接口同步：内置 Agent 与 frx-director-mcp 的新建环境参数统一支持语言、语言组、locale 和 timezone，并补充 Firefox-only 回归测试。

v0.22.3（2026-07-15）

• 自定义模型思考等级：自定义 OpenAI 兼容端点新增 自动 / none / minimal / low / medium / high / xhigh / max 选项；“自动”保持原请求行为，显式等级才发送 reasoning_effort，Anthropic 协议不会误传该字段。
• 品牌显示补齐：补齐 Firefox-Reverse 新标签页、隐私窗口和 Windows 快捷方式所需的品牌图标与 wordmark，减少回退显示 Nightly 名称或原始图标的情况。
• README 操作指引更新：重新截取当前构建的 Agent 与指纹环境管理界面，增加侧栏按钮、星光入口、一键新建、环境状态和指纹导入的编号标记。
• 四端安装包：同步发布 macOS ARM64、macOS Intel、Windows x86_64 和 Linux x86_64 构建及 SHA256 校验文件。
• Linux ARM64 补充包（2026-07-21）：新增原生 AArch64 构建 firefox-reverse-v0.22.3-linux-arm64.tar.xz，并更新 Release 的 SHA256SUMS。

v0.22.2（2026-07-13）

• 新增 Intel Mac Release：增加 x86_64-apple-darwin 独立构建配置和 macos-x86_64 DMG，支持 Intel Mac（macOS 10.15+）。
• macOS 架构防错：发布流程分别构建 arm64 / x86_64，并在 DMG 校验时核对真实 Mach-O 架构；新增跨平台产物在 macOS 上 ad-hoc 重签与重打包脚本。
• 环境启动卡顿修复：打开指纹环境后等待 Marionette 端口真实就绪再显示“运行中”，正确通过 Marionette pref 分配端口，并持续消费子进程输出，避免 Windows 冷启动期间误判和管道阻塞。

v0.22.1（2026-07-13）

• Windows 环境状态修复：tasklist.exe / taskkill.exe 改用绝对路径，浏览器已经打开后不再被环境管理误判为“已停止”。
• PID 三态探测：进程状态区分 alive、dead、unknown，系统探测异常时保留原运行状态，不再破坏 runtime 数据。
• 多环境端口避让：分配 Marionette 端口前执行真实 loopback 绑定检查，同时优先使用当前后端进程句柄，减少重复查询和端口冲突导致的启动卡顿。
• Windows 回归测试：新增系统命令解析、状态刷新、进程句柄优先和多环境端口分配测试，并纳入一键 Agent 工具自测。

v0.22.0（2026-07-07）

• 指纹浏览器环境管理：新增环境实体与独立 profile / 独立进程运行链路，支持环境列表、新建、重命名、打开、关闭、删除、导入指纹 JSON。
• 侧边栏环境管理：Agent 侧边栏新增明显的环境管理入口，可维护环境状态、编辑当前主进程指纹、保存后重启生效，并支持一键还原默认。
• C++ 指纹配置覆盖：启动时读取环境或当前 profile 的 fingerprint.json，覆盖 Navigator、Screen、DPR、locale / timezone、User-Agent / Accept-Language、UA-CH 与 WebGL unmasked vendor / renderer 等已接入字段。
• Chrome-like 指纹生成与导入：支持按 OS、版本、语言、分辨率、DPR、时区生成一致组合；支持外部浏览器控制台采集 JSON 后粘贴导入。
• MCP 环境联动：配合 frx-director-mcp 通过 FRX_ENV_ID 启动指定环境，并保留无环境时的主进程 profile 指纹模式。
• macOS 包修复：修复本地覆盖安装后的签名/启动问题，重新生成签名 DMG 与 SHA256 校验文件。

v0.19（2026-06-10）

• 新增模型：Kimi（Moonshot，kimi-k2.6）、MiniMax（MiniMax-M3）、通义千问（Qwen，qwen3-max）—— 连同原有 DeepSeek / 智谱 GLM / Claude / OpenAI，主流大模型基本覆盖。
• MCP 外部驱动可见性：新增 AgentSession.listRunning() + 侧栏「空闲自动跟随 / 忙时横幅」——外部（如 MCP director）驱动的会话能在侧栏自动切到、实时流式、并显示绑定的工作目录（配套 frx-director-mcp 成本拆分玩法，见「两种工作模式」）。
• 「停止」即时生效（框架级修复）：run_node / run_python 卡住时点停止会立刻杀掉子进程（之前要干等到超时才结束）；run_node 默认超时 300s → 30s（正常 JS 加载足够，hang 住能更快释放）。
• 工具补齐（当时）：加入密码学常量识别、引擎层闭包真值读取、document-start hook 和结构无关派发器探测，工具数由 40+ 扩展到 44+；派发器探测后来合并进 JSVMP 工具链，当前版本以「工具大全」中的 76 个为准。
• 方法论 / 健壮性：简单站「快车道」判型（先 hook 对比标准算法、不硬扣混淆）、page_eval 全权 + 大输出 saveTo 落盘、SSR 站识别、长任务护栏对强模型软化（硬限制转软提示、随上下文窗口缩放）。

v0.17 – v0.18（2026-06-08 起）

• 三端（Windows / macOS / Linux）正式构建并发布到 Releases；上下文窗口按所选模型自动缩放（modelBudget，长逆向不再轻易截断）；持续打磨 skill 方法论、工具稳定性与长任务健壮性。

更早（v0.12 – v0.16）

• JSVMP 离线工具链（派发器拆分 / 字节反汇编）封成一等工具；通用 WebAPI 指纹 tracer（C++ 引擎层、页面无感）；WASM 边界探测 wasm_probe + 反汇编 wasm_disasm；通用 JS 逐函数 trace js_trace；签名器入参追踪 signer_trace；白盒分支差分 whitebox_diff；内置逆向方法论 skill_get + 跨会话 SQLite 记忆 + 反绕圈护栏；对话引擎挪到父进程常驻（切窗 / 关侧栏不中断）。

---

🔑 外部支持 · 模型 Key 申请

Firefox‑Reverse Key 直连你选的模型，Key 只存本地、不经第三方。下面整理了各模型的 Key 申请入口，按需自取：

模型 / 服务	说明
DeepSeek	性价比高，Agent 默认推荐
智谱 GLM
Kimi（Moonshot）
MiniMax
通义千问（Qwen）	阿里云百炼

接入方式：以上均为 Agent ⚙️ 设置里的内置供应商，选中、填 Key 即可用；其它 OpenAI / Anthropic 兼容端点选 「自定义」，填入 baseUrl + Key + 模型名即可。

---

📮 反馈 / 联系

使用中遇到问题、想反馈 bug、或交流逆向思路，欢迎加微信或进群反馈：

微信号：han8888v8888（加好友请备注「Firefox-Reverse」）

也可以扫码加入 AI爬盒 微信群，交流 Firefox-Reverse、Agent、指纹环境和 JS 逆向实践：

---

License

MPL‑2.0 —— 与上游 Firefox 一致。本项目为 Firefox 的衍生作品，相关商标归 Mozilla 所有。