Releases: WhiteNightShadow/firefox-reverse
Release list
Firefox-Reverse v0.23.1
Firefox-Reverse v0.23.1 —— Windows MCP 工具注册兼容复验版。
问题结论
- Firefox v0.23.0 Windows 包内的
Tools.sys.mjs、ToolRouter、AgentSession、Backends均完整,浏览器真实工具面为 66;没有发生“最新版删掉工具”。 - MCP stdio 握手等待浏览器的问题从 frx-director-mcp 初版就存在;
agent_tools的旧静态 backend stub 从首次加入时也只返回部分有说明工具。 - v0.23 引入独立环境 profile/端口后,Windows 冷启动更慢,且工具总数扩到 66,因此旧问题更容易集中暴露。外部 AI 只看到
open_url时,那是宿主自己的工具,表示 MCP 未初始化。
修复
- 配套 frx-director-mcp v0.3.6 先注册 23 个顶层 MCP 工具,再异步解析
FRX_ENV_ID、分配端口和启动 Firefox。 agent_tools读取浏览器实际 backend 注册表,返回完整 66/66,missingDeclared=[]。- 本浏览器包新增
extensions.firefox-reverse.version=0.23.1发布标记;五端统一运行时 BuildID20260820033210。 - 新增确定性 BuildID 重链接脚本,避免增量构建出现 ini 已更新但 XUL 仍为旧 BuildID。
本版不改变指纹、profile、Agent 执行或 C++ 覆盖行为。使用外部 MCP 的用户需要同时升级 frx-director-mcp v0.3.6,并完整重启外部 AI/CLI。
下载
- macOS Apple Silicon:
firefox-reverse-v0.23.1-macos-arm64.dmg - macOS Intel:
firefox-reverse-v0.23.1-macos-x86_64.dmg - Windows x86_64 安装器:
firefox-reverse-v0.23.1-windows-x86_64-installer.exe - Windows x86_64 便携包:
firefox-reverse-v0.23.1-windows-x86_64.zip - Linux x86_64:
firefox-reverse-v0.23.1-linux-x86_64.tar.xz - Linux ARM64:
firefox-reverse-v0.23.1-linux-arm64.tar.xz
验证
- Firefox Agent 全量自测通过。
- MCP 24 项测试通过;Windows/Ubuntu GitHub Actions 均通过。
- macOS 双架构与深度签名验证通过;Linux 双架构、Windows PE 架构与包内 66 工具验证通过。
- 本机覆盖安装后主进程及子进程均上报 BuildID
20260820033210;MCP 真机握手 85ms、顶层 23 工具、浏览器 66 工具、page_info直调成功。
Firefox-Reverse v0.23.0
Firefox-Reverse v0.23.0 —— 内置 AI 逆向 Agent 的 Firefox。
按系统下载安装包,使用说明见 README。
Firefox Reverse v0.22.4
Firefox Reverse v0.22.4
本版本新增和完善 Firefox 指纹环境的地区语言一致性,并修复原生菜单坐标问题。
主要变化
- 新建、重新生成和外部采集导入只产出与当前 Gecko 内核及真实操作系统一致的 Firefox 身份,不再新建 Chrome-like 环境。
- 新环境默认中国大陆简体中文:
zh-CN、Asia/Shanghai和中文语言组;语言、地区与时区仍可在环境详情中自定义。 - 安装包包含简体中文界面资源,新 profile 默认显示中文浏览器界面和右键菜单。
- 修复多显示器、Retina/缩放场景下右键菜单远离鼠标的问题。网页仍读取环境中的
screen.*/ DPR 指纹,浏览器原生界面使用真实显示器坐标。 - 保持历史环境兼容:已有
fingerprint.json、profile、Cookie、收藏、历史记录和自动化链路不会被自动迁移或覆盖。 - 内置 Agent 与
frx-director-mcp的环境创建参数统一支持语言、语言组、locale 和 timezone。
发布包
- macOS Apple Silicon (ARM64) DMG
- macOS Intel (x86_64) DMG
- Linux x86_64 tar.xz
- Linux ARM64 tar.xz
- Windows x86_64 安装器与便携 ZIP
SHA256SUMS
请根据 CPU/系统选择对应文件,并使用 SHA256SUMS 校验下载完整性。
Firefox-Reverse v0.22.3
Firefox-Reverse v0.22.3 —— 内置 AI 逆向 Agent 与指纹环境管理能力的 Firefox。
按系统下载安装包,使用说明见 README。
补充发布(2026-07-21):
- 新增 Linux ARM64 / AArch64 原生编译包:
firefox-reverse-v0.22.3-linux-arm64.tar.xz - SHA-256:
93a4eb917572079010beb06746c63c105d86a8af7da7d15b6499c0b013d111d8 - 本次未提供 Docker 镜像。
Firefox-Reverse v0.22.2
Firefox-Reverse v0.22.2 —— 内置 AI 逆向 Agent 的 Firefox。
按系统下载安装包,使用说明见 README。
Firefox Reverse v0.22.1
Windows 指纹环境管理热修
- Windows 系统命令通过 Subprocess.pathSearch() 解析 tasklist.exe / taskkill.exe 绝对路径。
- PID 探测升级为 alive / dead / unknown 三态;探测异常不再把运行环境误写为停止。
- 优先复用当前后端进程句柄,减少重复 tasklist 调用和环境启动卡顿。
- Marionette 端口分配增加真实 loopback 占用检查,避免多个环境复用同一端口。
- 新增 Windows 状态判断、多环境端口分配回归测试,并接入 Agent 工具一键自测。
安装包
- macOS arm64: firefox-153.0a1.en-US.mac.dmg
- Windows x64: firefox-153.0a1.en-US.win64.zip
- Linux x86_64: firefox-153.0a1.en-US.linux-x86_64.tar.xz
- SHA-256: SHA256SUMS
macOS 包已完成 ad-hoc 签名、DMG 验签和隔离 profile 启动测试。Windows / Linux / macOS 包内 BuildID 均为 20260713023952,侧栏与环境后端和 v0.22.1 源码一致。
Firefox-Reverse v0.22.0
Firefox-Reverse v0.22.0
新增指纹浏览器修改能力:
- 环境管理:一个环境一个 profile + 独立进程,支持新建、重命名、打开、关闭、删除、导入 JSON。
- 指纹配置:侧边栏编辑/生成/导入 fingerprint.json,支持 Chrome-like/Firefox 桌面组合。
- C++ 覆盖:navigator、WorkerNavigator、screen、devicePixelRatio、Intl locale/timezone、User-Agent/Accept-Language/UA-CH、WebGL 基础项、webdriver 自动化暴露。
- 当前主进程:支持修改主进程指纹并记住到当前 profile,手动重启生效,一键还原默认。
- MCP:配套 frx-director-mcp v0.3.0 支持环境列表、新建、打开、关闭、导入和 FRX_ENV_ID 启动。
校验:
004e8eb3c33b6d94a494dce4a00b37a72a2b11cb944994b32bf1ac72df385bcf firefox-153.0a1.en-US.mac.dmg
766e06d71f83cb6667c92351bddcc99114869a1c03e668bf454da164faded8db firefox-153.0a1.en-US.linux-x86_64.tar.xz
04b19c4b49afc3a1849cf180f808046a007fbe13e64247c6c2d5ffc942f89f2f firefox-153.0a1.en-US.win64.zip
Firefox-Reverse v0.21.1
v0.21.1 热修说明
本版是 Firefox-Reverse Agent 浏览器的三端热修包,基线仍为 Firefox 153.0a1。
修复内容
- Windows:修复用户已安装 Node/nvm、管理员权限正常,但
run_node报PathUtils.join: NS_ERROR_FILE_UNRECOGNIZED_PATH的问题。现在会规范化D:/...盘符路径、正确处理 Windows PATH 分隔符、展开%NVM_HOME%/%NVM_SYMLINK%,并跳过未展开的注册表 PATH 项,避免无效路径把工具链直接打断。 - Ubuntu/Linux:修复 GTK 文件选择器在“选择工作目录”时只能选中文件、导致工作目录被绑定成文件路径的问题。若目录选择器返回文件,Agent 会自动取其父目录作为工作目录。
- 测试:新增
scripts/selftest-agent-tools.sh作为发布前工具能力门禁,覆盖侧栏构建、provider/LLM 协议 dry-run、ToolRouter/AgentLoop、会话/线程预留、workspace 路径安全等。
验证记录
- 本地和服务器均通过
bash scripts/selftest-agent-tools.sh。 - 服务器三端增量构建并打包成功:macOS arm64 dmg、Linux x86_64 tar.xz、Windows x64 zip。
- 本机覆盖安装 macOS 包后,
/Applications/Firefox Reverse.app/Contents/MacOS/firefox --version正常返回Mozilla Firefox 153.0a1。 - macOS 安装版、Linux 包均完成 headless
example.com截图烟测。 - Windows zip 已做包内
omni.ja标记校验,确认包含本次WorkspaceBackendWindows PATH 修复和目录选择兜底 bundle。
下载
- macOS Apple Silicon:
firefox-153.0a1.en-US.mac.dmg - Linux x86_64:
firefox-153.0a1.en-US.linux-x86_64.tar.xz - Windows x64:
firefox-153.0a1.en-US.win64.zip - 校验:见
SHA256SUMS
Firefox-Reverse v0.21.0
Firefox-Reverse v0.21.0 —— 内置 Cookie 管理
新增
- Cookie 管理工具
cookies(回应 GitHub issue:增 / 删 / 改 cookie)。单个 action 工具,经引擎nsICookieManager直接读写 cookie 存储——含 httpOnly(page_eval的document.cookie拿不到 httpOnly)、可跨域、可管理登录态:action: list—— 列出 cookie(可按domain(host 子串)/name过滤);action: set—— 新增 / 修改(httpOnly/secure/sameSite/ 有效期expires(unix 秒) 或maxAge(相对秒);同 host+path+name 覆盖,写后读回确认);action: remove—— 删除(name+domain删单个 / 只给domain删该 host 全部 /all:true清空所有)。
- 纯新增:不触碰任何现有工具 / backend。工具数 44 → 45。
真机 marionette 实测:set 一个 httpOnly cookie → list 能看到(isHttpOnly:true)→ remove 删除,往返一致。
下载安装
| 系统 | 文件 | 安装 |
|---|---|---|
| Windows | firefox-*.win64.zip |
解压双击 firefox.exe(SmartScreen 拦截 → 「更多信息」→「仍要运行」) |
| macOS (Apple Silicon) | firefox-*.mac.dmg |
拖进「应用程序」;首次打开若提示「已损坏」见下方 |
| Linux (x86_64) | firefox-*.linux-x86_64.tar.xz |
解压运行 ./firefox |
⚠️ macOS 首次打开提示「已损坏」? 自签名未公证所致,终端执行:xattr -dr com.apple.quarantine "/Applications/Firefox Reverse.app"从旧版升级:本版内部 build ID 已更新,重装后会自动刷新缓存、无需手动清理。
引擎基线 Firefox 153.0a1。完整改版见 CHANGELOG。
Firefox-Reverse v0.20.0
Firefox-Reverse v0.20.0 —— 引擎工具 raw MCP 直通
新增
- 引擎工具 raw MCP 直通:配合 frx-director-mcp 0.2.0 的新工具
agent_call_tool,让 Claude / Cursor 等强 director 跳过 DeepSeek worker、亲自直调浏览器内置的 44 个工具——尤其 16 个引擎级逆向工具(signer_trace/jsvmp_trace/closure_read/webapi_trace/whitebox_diff/wasm_probe等,页面检测不到)。成本拆分由「强制委派」改为「可选」:默认仍可委派便宜 worker 省钱,强 director 直驱是可选新增。 - 浏览器侧
AgentSession.callTool()/listTools():纯新增,与 Agent 用同一个全局 ToolRouter 单例;不走 confirm(director 即审批者);任一会话运行中即拒绝直调(共享页面/hook 状态的安全闸)。不动任何现有方法,对现有 Agent 流零影响。
真机 marionette + 经 MCP
MarionetteBridge.callTool端到端实测:列全工具、page_eval/page_navigate/ 文件读写 /net_capture/run_node/code_search/skill_get经callTool全部跑通。
下载安装
| 系统 | 文件 | 安装 |
|---|---|---|
| Windows | firefox-*.win64.zip |
解压,双击 firefox.exe(SmartScreen 拦截 → 「更多信息」→「仍要运行」) |
| macOS (Apple Silicon) | firefox-*.mac.dmg |
打开 → 拖进「应用程序」;首次打开若提示「已损坏」见下方 |
| Linux (x86_64) | firefox-*.linux-x86_64.tar.xz |
解压,运行 ./firefox |
⚠️ macOS 首次打开提示「"Firefox Reverse" 已损坏,无法打开」? 不是真损坏——本浏览器自签名、未做 Apple 付费公证,从浏览器下载后被打上隔离标记。终端执行一行去隔离即可:xattr -dr com.apple.quarantine "/Applications/Firefox Reverse.app"
引擎基线 Firefox 153.0a1(锁定)。完整改版记录见 CHANGELOG。