WhiteNightShadow /firefox-reverse

🦊 内置 AI 逆向 Agent 的 Firefox — 通用 JS/JSVMP/WASM/签名逆向工作站,SpiderMonkey 引擎层非侵入 trace,把加密参数从黑盒还原成不依赖浏览器的纯算法

★ 997⑂ 212👁 5⑃ 29● 16▤ 25
JavaScriptAGPL-3.0Created 2026-06-04
下载:Firefox-Reverse v0.27.2Firefox-Reverse-0.27.2 ↓0.27.22026-11-09
+5
日增长
997
stars
212
forks
5
watchers
29
prs
16
issues
25
releases

README

Firefox‑Reverse

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

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



!Firefox
!Windows
!macOS
!Linux

!AI
!Engine
!License



📥 下载安装(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)或全部会话(.frx-chats.json,一个文件),换电脑后用「导入」一次导回,导入过的不会重复导入;导入会创建静止的新会话,不会自动执行历史任务,也不会携带 API Key、工作目录和环境绑定。
- 输入框可以直接粘贴截图或拖入图片(一条消息最多8张),发给能看图的模型;图片在本机缩到长边2000px以内再发,存在本地profile里,导出会话时一起导出。
- 模型设置支持命名配置,同一渠道可以保存多组账号、端点、模型与思考等级,后续直接从历史配置切换;每个配置可以设置模型能不能看图。
- 侧栏设置支持编辑全局附加 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 | 适用于 AR

Top issues

Latest release

Firefox-Reverse v0.27.2 v0.27.2 2026-11-09
Firefox-Reverse v0.27.2

v0.27.1之后的修订版,合入pr 41、42、43。

 更新内容

 长任务不再忘结论、从头重做、绕圈(41,issue 5)

模型“失忆”主要出在上下文压缩上:

- 交接摘要以前只看执行记录的前6万字,记录一长就看不到最新进展;现在留开头和最新的部分,并带上当前任务、任务之前的对话和上一份存档。
- 用户发「继续」之后一压缩,上下文里只剩这句「继续」;现在这条任务之前用户最近发的几条消息原文附在压缩后的续跑说明里,注明只作参考,被手动停止过的任务会标出来。
- 任务到轮数上限自动续跑后,引擎加的续跑提示被当成了任务,一压缩,上一段的工作和原来的任务都从上下文里消失;现在任务还是用户发的那条,上一段的工作一起总结。
- 交接摘要被截断或没生成出来时,最近一份完整的交接账本原样带进新存档(只在行与行之间截,不留半句),当时的「下一步」不带;连续几次都这样也不会越带越少。

重复和循环:

- 只读的查询(读文件、搜代码、列请求、页面快照等)用完全相同的参数再做一遍、结果也一样,工具结果里会提示;最近计入的12次调用里有8次是这样的重复先提醒一次,提醒之后还这样就停下这一轮,不再自动续跑,停下的原因显示在侧栏里。模型收到提醒后直接汇报卡在哪,这一轮也就此收尾。
- 点击、导航、开关trace、清站点数据、跑脚本这类操作重复做不

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON