Freebuff 多开控制器 / Freebuff Multi-Instance Controller

一个 Windows 桌面小工具：让 Freebuff 桌面版支持多开，并且每个窗口可以登录不同的账号。

A small Windows utility that lets the Freebuff desktop app run multiple instances simultaneously — each with its own independent account.

纯第三方工具，不修改 Freebuff 本体，与 Freebuff 官方无关。 A third-party tool. It does not modify the Freebuff app itself.

功能 / Features

• 多开：主实例 + 实例 1~9，互不干扰
• 多账号：每个实例独立 Chromium 配置和登录态，可分别登录不同账号
• 状态一览：实时显示每个实例的运行状态和当前登录的账号邮箱
• 额度显示：每个账号每日高级会话剩余额度（调用官方会话接口，启动时与手动刷新时更新，另有 5 分钟自动刷新）
• 版本检测：显示本机 Freebuff 版本，自动对比官方更新源；发现新版本可一键下载官方安装包（能取得更新源的 latest.yml 时先做 SHA512 校验再运行；取不到时改用官方下载直链并在状态栏明示跳过了校验），下载失败时退回浏览器下载页
• 网络路径：检查更新、下载安装包、额度查询按「本地代理 → 系统代理 → 直连」依次尝试，并记住上次成功的路由优先重试。本地代理自动探测常见端口（7890 / 7897 / 10808 / 10809 / 1080），且为功能级探测——经代理真实请求 204 端点确认可用，SOCKS-only 端口不会误判（socks5:// 地址仅用于启动的实例，控制器自身请求会自动跳过）。启动 Freebuff 实例同样接入：代理在运行时为实例加 --proxy-server（覆盖界面与内置更新器的流量）并注入 HTTP(S)_PROXY 环境变量（后端 orchestrator 若读取则同样走代理；回环地址始终直连），代理未运行或 off 时按原样启动，实例自行回落系统代理。主窗口右上角「代理设置」：实时状态、逐端口探测结果（✓ = 端口可达且功能探测通过）、修改地址、停用（off）、恢复默认——与手编 %APPDATA%\FreebuffController\proxy.txt 等价，保存立即生效
• 一键操作：启动 / 停止 / 重置账号 / 停止全部；双击表格行直接启动
• 两种初始化方式：启动未初始化的实例时弹窗选择——全新登录（每个窗口用不同账号），或复制其他已登录实例的账号（下拉框只列出真正登录过的实例，并显示其邮箱），免重复登录
• 重置换号：清空某个实例即可换登录另一个账号
• 汉化集成：自动检测 Freebuff 是否已应用汉化包（独立仓库），可一键应用 / 还原——Freebuff 更新覆盖汉化后，点一下即恢复中文界面
• 暗色主题 UI，单文件 exe（约 22 KB，无运行时依赖）；最小化进任务栏，关闭即完全退出

使用 / Usage

1. 双击 Freebuff多开控制器.exe（或按下面步骤自行编译）
2. 双击（或选中后点「启动」）一个未初始化的实例，在弹窗里选「全新登录」
3. 在弹出的 Freebuff 窗口里登录该窗口要用的账号 —— 登录态会固定在这个实例
4. 想换某个实例的账号：选中 → 「重置账号」→ 再启动登录新账号

原理 / How it works

Freebuff 是 Electron 应用，用 requestSingleInstanceLock() 限制单开。本工具不修改任何应用文件，而是给每个实例分配独立的数据目录：

• --user-data-dir=<APPDATA>\Freebuff-slot-N — 独立 Chromium 配置文件与单实例锁
• FREEBUFF_DESKTOP_STATE_PATH=<user>\.config\freebuff-desktop\slots\slot-N\state.json — 独立后端 orchestrator 状态（避开其 SQLite 文件锁）

因此 Freebuff 应用升级不会使本工具失效。

The app is an Electron app that enforces a single-instance lock. This tool gives each instance its own --user-data-dir and its own orchestrator state file via an environment variable, so instances don't share locks — no app files are touched, and app updates don't break it.

汉化集成 / Localization

Freebuff 的自动更新会用原版文件覆盖汉化包的产物。控制器在窗口底部显示汉化状态， 并提供「应用汉化 / 还原英文」一键操作（首次应用自动备份英文原版，与 apply.sh 的备份/还原机制完全兼容）。

汉化仓库的查找顺序：

1. exe 同级或上一级的 hanhua/ 目录（monorepo 布局）
2. exe 同级或上一级的 freebuff-zh/ 目录（汉化仓库独立克隆）
3. 上次在对话框里选择并记住的路径（%APPDATA%\FreebuffController\hanhua-path.txt）

控制器还会对比本机 Freebuff 版本与 hanhua/manifest.json 的 targetVersion： 本机版本更新时提醒先更新词典并重新构建，避免把过时的汉化产物打上去。

汉化包本身也可以作为 GitHub Release 分发（hanhua/tools/release.sh 发布）：控制器 每 30 分钟检查一次 pack Release（与 Freebuff 更新检查共用同一条代理链），当包的 targetVersion 与本机 Freebuff 版本一致且 packVersion 比已装/已暂存的新时，自动下载、 SHA512 校验并落到 hanhua/output/，状态栏提示后点「应用汉化」即可换上新包。

Freebuff 的 automatic updates overwrite the localization pack's patched files. The controller shows the localization status at the bottom of its window and offers one-click apply / restore (the first apply backs up the pristine English files, compatible with apply.sh's backup mechanism).

编译 / Build

不想编译？直接从 Releases 下载单文件 exe 即可。发新版：改 FreebuffController.cs 里的 AssemblyVersion 后跑 bash release.sh（编译 + 打 tag + 上传）。

不需要安装任何 SDK，Windows 自带的 .NET Framework C# 编译器即可：

build.bat

或手动：

%SystemRoot%\Microsoft.NET\Framework64\v4.0.30319\csc.exe -nologo -target:winexe ^
  -optimize+ -codepage:65001 ^
  -r:System.dll -r:System.Core.dll -r:System.Drawing.dll -r:System.Windows.Forms.dll -r:System.Management.dll ^
  -win32icon:app.ico -out:FreebuffController.exe FreebuffController.cs

源码需兼容 C# 5（系统自带编译器的语言版本）。

项目结构 / Structure

├── FreebuffController.cs   # 全部源码（UI + 逻辑）
├── build.bat               # 一键编译脚本
├── make-icon.ps1           # 图标生成脚本（多尺寸 PNG-in-ICO）
└── app.ico                 # 应用图标

License

MIT