﻿FB ROAS 客户端 0.2.2

首次使用（Windows 10 / 11，64 位）
1. 将整个压缩包解压到一个固定目录，不要在压缩包里直接双击。
2. 双击“ 双击安装.cmd ”。不需要管理员权限，不需要安装 Node.js，也不需要填写端口。
3. 在指纹浏览器的扩展管理页打开开发者模式，选择“加载已解压的扩展程序”，选择本包的 extension 文件夹。
   也可选择安装窗口显示的固定插件目录。浏览器的首次加载步骤需在浏览器内完成。
4. 打开插件，输入与控制台相同的用户名和密码，点击“登录并开启同步”。
5. 在同一浏览器保持 Meta 登录，并打开目标计划的“广告”层级。插件自动识别本机连接，采集有效实时数据后同步控制台。

已经装过插件
双击安装入口即可安装或修复代理。安装器不会修改浏览器已加载插件的原路径；需要升级插件时，加载本包新版 extension，或在原路径替换新版插件后点击浏览器“重新加载”。

以后使用
Windows 用户登录后代理会自动运行。保持指纹浏览器与 Ads Manager 登录即可；不需要手动启动代理、选择端口或反复绑定。
Meta 要求重新登录时，在浏览器完成登录，插件会继续尝试采集；采集成功前不会把历史数据当作实时数据。
安装代理成功只表示本机程序已运行，插件连接、真实数据回传与暂停验证均以插件及控制台状态为准。

多个浏览器
本机代理自动探测支持的指纹浏览器端口。每个窗口需单独加载插件并登录控制台账号，数据进入对应用户账户；保留 Meta 登录态在本浏览器。

排查与修复
“本机代理尚未就绪”：双击安装入口修复，回到插件重新登录。
“等待广告数据”：进入目标计划的广告层级，并检查 Meta 登录是否有效。
“历史数据”：说明尚未收到最新有效采集结果，不代表广告今日花费为零。
支持的指纹浏览器需提供本机调试端口。未开启本机调试接口的浏览器，请在浏览器中启用该接口。
代理运行日志：%LOCALAPPDATA%\FbRoasClient\bridge.log
安装备份与中文记录：%LOCALAPPDATA%\FbRoasClientBackups

卸载
关闭本机代理及本产品启动任务后，删除 %LOCALAPPDATA%\FbRoasClient。安装器只管理本产品的程序和启动项，保留每次升级备份。

运行程序许可见 runtime\LICENSE。
