Firestone2Green 是一个面向 Firestone / Overwolf / Hearthstone Tracker 的 Windows 一键本地恢复工具。
一键完成 本地授权修复、左下角登录头像修复、全功能网络恢复、静默持续修复任务安装，适合需要快速恢复 Firestone 本地运行环境的普通用户。
📺 视频教程
- 一键处理：提供 WPF 图形界面，常用功能可直接点击执行。
- 单文件分发：最终下载物是一个约 1 MiB 的 EXE；WPF 主程序、PowerShell 脚本与默认头像资源都嵌入其中。
- 路径自适应：支持自动搜索或手动选择 Overwolf 根目录；正确目录必须直接包含
OverwolfLauncher.exe或Overwolf.exe，不再依赖固定盘符或固定安装目录。 - 本地授权：完成授权状态修复后，恢复 Firestone / Overwolf 正常网络能力。
- 头像修复：仅替换 Firestone 左下角登录 / 账户头像。
- 避免误伤：不会替换酒馆战旗英雄头像、环境套牌图标、套牌图标或卡牌图片。
- 静默持续修复：支持安装计划任务，在系统重启或 Firestone 更新后自动补授权；安装本身不会主动启动 Firestone。
- 快捷方式启动：可创建桌面快捷方式
Firestone2Green 启动 Firestone，用于日常无弹窗启动。 - 自动更新检查：启动后自动对比 GitHub Releases，右上角提示是否已是最新版；网络不可用时会提示更新检查失败。
- 运行环境检测：启动器会先检测 .NET 10 Desktop Runtime；缺失时只显示引导页面，并提供按钮直达微软官方下载页面，安装后可重新检测。
- 日志错误解释：运行失败时保留原始异常、类型、代码行和命令，并为常见错误自动追加简单原因和处理建议。
- 首次启动免责声明：首次打开会提醒“本项目仅用于交流学习，有能力者请多多支持正版”。
- 响应式高 DPI 界面：针对 100%～200% 缩放、窄窗口和小屏工作区重新排版；小窗口会精简次要文案并保持底栏紧凑固定，GitHub 入口位于左侧、版本号位于最右侧。
- 数据稳定：启动前恢复 AuthOnlyOnline 网络，避免套牌 / 环境数据在启动断网窗口里加载失败。
Note
v0.2.8 保持现有 WPF 界面不变，并继续沿用已通过的 100% 实际窗口几何测试与 125%～200% DPI 布局审计；左侧功能顺序固定为 一键处理 → 持续化与打包 → 精细控制。
- 从 GitHub Releases 下载
Firestone2Green_v???.exe。 - 右键
Firestone2Green_v???.exe，选择 以管理员身份运行。首次启动会自动检测 .NET 10 Desktop Runtime；如果缺失，按提示点击 前往官方下载，安装后点击 重新检测。 - 在 路径设置 区域确认路径；如果没有自动识别，点击 自动搜索 或 选择路径，选择 Overwolf 根目录（打开后能直接看到
OverwolfLauncher.exe或Overwolf.exe的那一层目录）。选到子目录或上级目录时程序会弹窗提示正确位置。若用户只安装了 Overwolf（狼头）但还没安装 Firestone，请先在 Overwolf 中安装并正常打开一次 Firestone。 - 点击 一键重启并授权。
- 等待日志显示退出码
0。 - 点击 验证状态，确认网络模式与授权状态正常。
- 如需重启后自动维持授权，点击 安装持续修复。
Tip
安装持续修复后，建议以后都通过桌面的 Firestone2Green 启动 Firestone 快捷方式启动 Firestone。
快捷方式启动后不会弹出完成提示，请等待 Firestone 主界面加载完成并额外等待约 30 到 60 秒，后台会自动完成授权、头像修复和网络恢复。
Firestone 的授权状态属于运行时状态。Windows 重启、Firestone 完全退出或 Overwolf 更新后，运行时状态可能回到默认值。
Firestone2Green 的持久化方式是 后台自动补授权，不会修改 Firestone 的签名文件。
点击 安装持续修复 后，程序只会创建持续修复项、启动后台监听、创建桌面快捷方式并应用网络规则，不会主动启动或重启 Firestone。需要立即完成本次授权时，请点击 一键重启并授权；日常使用建议通过桌面 Firestone2Green 启动 Firestone 快捷方式启动：
| 名称 | 类型 | 作用 |
|---|---|---|
Firestone2Green |
后台事件监听任务 | 登录后常驻监听 Firestone 手动启动事件；检测到 -launchapp 后只探测当前有效的 Automation 端口，成功时补授权，失败时仅维持网络规则，不会主动拉起或反复重启 Firestone。 |
Firestone2Green Launch |
后台按需任务 | 由桌面快捷方式触发，静默启动 Firestone 并完成授权、头像修复和网络恢复。 |
Firestone2Green 启动 Firestone.lnk |
桌面快捷方式 | 普通用户日常启动 Firestone 的入口。 |
%LOCALAPPDATA%\Firestone2Green\LaunchFirestone2Green.vbs |
隐藏启动脚本 | 负责无窗口触发后台按需任务。 |
持续修复模式的行为：
- 不弹 PowerShell 窗口。
- 不弹授权完成提示。
- 不弹额外确认窗口。
- 重启电脑后仍可通过启动事件监听自动维持本地授权。
- 如果用原始 Firestone 图标启动但本次没有有效 Automation 接口，后台监听只维持网络规则并等待下一次启动事件，不会结束或反复重启 Firestone。需要稳定自动授权时请使用桌面 Firestone2Green 启动 Firestone 快捷方式。
桌面 Firestone2Green 启动 Firestone 快捷方式不是直接打开 Firestone，而是无窗口触发后台任务 Firestone2Green Launch。
该任务会按顺序执行：
- 校验 Firestone 本地文件完整性。
- 清理异常缓存和旧进程。
- 在 Firestone 启动前切换到
AuthOnlyOnline网络模式，保证套牌、环境数据和记牌器数据可以正常联网加载。 - 先检测默认 Automation 端口
18765。端口空闲时优先恢复 v0.2.7 已验证的兼容命令OverwolfLauncher.exe -launchapp <AppId> -from-desktop --automation 18765 --enable-automation；端口被占用或启动后验证失败时，只按顺序尝试18766～18770。尚未启动 Firestone 时，备用流程会先启动 Automation runtime、紧接着发送一次标准启动命令，再验证pingServer；如果兼容启动请求已经发出，备用端口只初始化 runtime，不会再次启动 Firestone。程序不会结束端口占用进程。 - 等待 Firestone 后台窗口和主窗口授权服务初始化。
- 同时补齐后台窗口与主窗口的本地授权状态。
- 修复左下角登录头像。
- 保持全功能网络恢复状态。
Important
快捷方式启动是静默流程，不会弹出“完成授权”窗口。正常情况下从点击快捷方式到授权完全生效大约需要 30 到 60 秒，取决于 Firestone / Overwolf 启动速度。
自动授权成功后，主窗口中的会员锁、我的套牌、环境套牌、环境套牌类型、统计数据、等级和构筑套牌等依赖授权的入口应恢复可用。
部分 Overwolf 版本只会在 v0.2.7 使用的直接兼容命令中正确建立 Automation 接口；最初的 v0.2.8 只使用两段式启动，因此这些用户会正常打开 Firestone，却无法完成自动授权。当前修复已恢复直接兼容路径，但只在目标端口空闲时使用，并且必须通过标准 pingServer 验证；失败后才进入有限备用端口流程。
如果 18765 已经是有效 Automation 会直接复用；未监听时先尝试 v0.2.7 兼容启动；被普通 HTTP、非 HTTP 服务或其他程序占用，或兼容启动未通过验证时，会自动尝试 18766～18770。每次流程最多接受一次 Firestone 启动请求，备用端口只做有限 Automation 初始化，不会制造重启循环。全部候选端口都失败但 Firestone 已启动时，流程会记录 LaunchOnlyDegraded：网络保持 AuthOnlyOnline，本次仅跳过运行时补授权，不返回笼统退出码 1。程序不会结束 NetHost.exe、System 或任何未知端口占用进程。
如果点击快捷方式后没有自动授权：
- 等待至少
60秒。 - 确认是通过桌面的 Firestone2Green 启动 Firestone 快捷方式启动，而不是原始 Firestone 图标。
- 如果刚升级过 Firestone2Green，管理员运行新版
Firestone2Green_v???.exe并点击一次 一键重启并授权。新版会安全刷新已经安装的 Firestone2Green 后台监听器，不需要手工结束系统进程；如需重建桌面快捷方式，可再点击一次 安装持续修复。 - 点击 一键重启并授权 立即重启并补授权。
- 点击 验证状态，确认报告中显示
NetworkMode = AuthOnlyOnline。
推荐给普通用户分发 GitHub Releases 中的单文件 EXE：
Firestone2Green_v???.exe
也可以分发完整压缩包：
Firestone2Green_v???_dist.zip
Firestone2Green_v???.exe 已内置：
scripts/Firestone2Green.ps1assets/avatar.jpgassets/app.ico
因此在常规使用场景下，用户不需要额外携带 .ps1 文件或头像文件。
单独分发 Firestone2Green_v???.exe 时，程序首次运行会自动释放内置脚本和默认头像资源；如果目录里没有 assets/avatar.jpg，会使用 EXE 内置头像并写入本地运行目录，保证其他用户也能完成左下角登录头像替换。
Firestone2Green/
├─ assets/
│ ├─ app.ico
│ └─ avatar.jpg
├─ docs/
│ └─ 使用教程.md
├─ scripts/
│ └─ Firestone2Green.ps1
├─ src/
│ ├─ app.manifest
│ └─ Firestone2Green.cs
├─ .editorconfig
├─ .gitattributes
├─ .gitignore
├─ LICENSE
├─ README.en.md
└─ README.md
可以。Firestone2Green_v???.exe 已经内置脚本、头像和图标，普通用户只需要这个 EXE。
安装 持续修复 后不需要每次手动打开 GUI。推荐重启后使用桌面的 Firestone2Green 启动 Firestone 快捷方式。如果使用原始图标手动启动，后台监听会在检测到 -launchapp 后探测本次有效 Automation 端口：接口可用时补授权，不可用时仅维持网络规则，不会反复重启 Firestone；持续任务本身也不会在你未启动时主动拉起 Firestone。
不会。持续修复与快捷方式启动都会隐藏 PowerShell 窗口，也不会弹出完成提示。
授权状态属于运行时状态。Firestone2Green 通过后台任务在启动后补齐本地授权状态，避免直接改动 Firestone 的签名文件。
新版会读取 Windows 注册表中的实际 hosts 目录，不再只认固定路径；缺少无扩展名 hosts 时会自动创建，hosts 不存在、为零字节或只有空白内容时，会先恢复 Windows 默认 HOSTS 模板，再加入 Firestone2Green 阻断段。只有 hosts.txt 时会复制内容并保留原文件；如果 hosts.txt 也是空的，目标 hosts 同样会恢复默认模板。已有非空 hosts 内容不会被覆盖。写入前还会自动解除只读、重试短时占用、临时修复文件 ACL，并把原内容备份到 %LOCALAPPDATA%\Firestone2Green\hosts-backups（最多保留 10 份）。
v0.2.8 起，如果日志出现 HOSTS_PROTECTION_ACTIVE、HOSTS_FILE_BUSY、HOSTS_CREATE_FAILED 或 HOSTS_WRITE_VERIFY_FAILED，程序会先回滚 hosts，再自动改用 Windows 防火墙精确域名阻断：优先使用动态 FQDN 规则；旧系统不支持时改用解析后的 IP 规则。成功创建后会复用现有规则，不再每次启动重复写入受保护的 hosts。一般不需要关闭火绒、360 或电脑管家的 Hosts 保护，也不要下载所谓“hosts 修复文件”或手工给 Everyone / Users 完全控制权限。只有 hosts 与防火墙都被系统策略禁止时，报告才会显示 UnprotectedRuntime；程序仍会继续本地启动与授权，但会明确提示精确端点阻断未生效。
从 v0.2.3 开始，日志会直接显示 F2G_ERROR、F2G_ERROR_TYPE、F2G_ERROR_LINE 和 F2G_ERROR_COMMAND，对应真正的异常内容、类型、原始代码行和命令，不会再把最外层错误处理代码误报为故障位置。需要进一步排查时，点击 打开报告，查看最新的 FirestoneOfflineReport_*.json。
在 GUI 中点击 恢复全功能网络，再点击 验证状态。报告中应显示：
NetworkMode = AuthOnlyOnline
当前版本只允许命中左下角登录 / 账户头像，并会排除英雄、套牌、卡牌等内容图片。出现异常时可点击 刷新授权+头像。
见 docs/使用教程.md。
本项目使用 MIT License。
【感谢Linux.do社区及GitHub社区各位开发者对项目的支持与贡献】
