# 🛡️ OmniFlow 最佳使用指南

OmniFlow 是专为跨境养号、社交媒体多开运营（如 X/Twitter、Facebook、Discord）、多账户管理等场景打造的**防关联指纹隔离与 Session 免密克隆引擎**。它通过物理级代理接管、WebRTC 阻断、V8 引擎时区劫持以及 Session 物理级克隆，实现隔离。

---

## 🧩 核心功能大解析与配置说明

### 1. 代理服务器配置 (Proxy Controller)
*   **作用**：接管浏览器底层的全部网络流量，强行让当前分身走隔离代理通道。
*   **模式支持**：
    *   **HTTP 代理**：标准代理模式，适合绝大多数静态 IP 或住宅 IP。
    *   **SOCKS5 代理**：更底层的网络协议，传输性能更高，对于防关联对抗更优。
*   **🔒 IP 泄漏锁 (IP Leak Lock)**：
    *   **终极守护机制**：当你的代理地址留空、未配置或配置出错时，OmniFlow 会**自动拉起物理网络隔离网**（将流量导向拒绝响应的 `127.0.0.1:65535`），直接阻断当前分身的一切出网网络！这能**彻底杜绝因为代理失效而导致你的真实国内 IP 暴露给平台**。

### 2. 防关联指纹遮罩
*   **WebRTC 泄露防护**：
    *   *作用*：强行禁用非代理的 WebRTC UDP 传输，防止网站通过 WebRTC 协议直接穿透代理、获取你电脑在局域网和宽带下的真实 IP。
*   **浏览器语言同步**：
    *   *作用*：根据代理 IP 的时区和地理位置，动态劫持并自动将浏览器语言调整为当地官方语言（如代理在美国，语言自动设为 `en-US`），防止“IP 在美国，浏览器语言是中文”的低级关联破绽。
*   **硬件指纹标准化**：
    *   *作用*：将当前分身的 CPU 核心数统一锁定为 `8核`，内存大小锁定为 `8GB`。防止平台利用你的物理硬件独特性生成唯一的设备指纹标识。
*   **Webdriver 自动标记屏蔽**：
    *   *作用*：将 `navigator.webdriver` 强行改写为 `false`，并抹除一切自动化测试（如 Puppeteer、Selenium）的特征痕迹，完美绕过平台的防爬虫与防机器人人机校验。
*   **时区伪装劫持**：
    *   *作用*：重写 V8 引擎底层的 `Date` 与 `Intl` 原型链方法（如 `getTimezoneOffset`、`toString`、`toLocaleString` 等）。让网页端通过任何 JS 脚本检测你的浏览器时间时，返回的都是**完美的代理当地时区时间**，消灭系统时区与 IP 时区的偏差。

### 3. 实时风控环境报告
*   **作用**：模拟 `ping0.cc`，在控制台内部进行实时的环境体检。
*   **检测项目**：
    *   *出口公网 IP*：实时检查当前出网的 IP。
    *   *地理归属*：显示代理所在的国家和城市。
    *   *时区对齐状态*：对比你的“浏览器 JS 运行时间”与“出口 IP 地理时区”是否 **100% 对齐**。绿灯代表完美伪装。
    *   *WebRTC 状态*：显示是否处于“安全锁定”防护中。

### 4. 环境迁移与备份 
*   **备份当前环境**：
    *   *作用*：一键打包当前分身保存的**代理指纹设置**以及**全网所有已登录网站的加密 Cookies**，下载存为 `[IP]_[端口].json` 文件。
*   **还原环境备份**：
    *   *作用*：在新的分身中导入该 JSON，插件会**自动强力洗净新分身的旧 Cookies**，并完美注入新配置与全套 Cookies，实现**跨分身、跨电脑一键登录，免去输入账号密码或二次短信验证**！
*   **一键彻底重置与销毁分身**：
    *   *作用*：卸载插件前或彻底废弃分身前的**终极安全机制**。一键将全网已登录 Cookies 全部抹除，粉碎本地所有配置并重置代理，确保不留一丝痕迹。

---

## ⚙️ 必填项与配置规范

为了让插件生效，在面板中配置时请严格遵循以下规范：

| 配置项 | 是否必填 | 格式要求 / 示例 | 避坑提醒 |
| :--- | :--- | :--- | :--- |
| **智能一键解析填充** | 选填 | `149.119.153.220:443:XDkFWJrOYydL:ENUFzyBq99` | **最推荐使用**！直接粘贴常规代理格式或 URL，点击“智能填充”，自动提取协议、IP、端口、账号、密码并直接触发自动时区对齐。 |
| **代理 IP / 主机名** | **必填** | `64.50.132.240` 或 `us.proxydomain.com` | 不能包含 `http://` 或 `socks5://` 前缀。如果使用了“智能解析”，此处将被自动填入。 |
| **端口** | **必填** | `8080` 或 `1080` 等 | 必须为纯数字，且与你的代理类型端口一致。如果使用了“智能解析”，此处将被自动填入。 |
| **用户名 (可选)** | 选填 | `user1234` | 如果你的代理 IP 绑定了白名单，此项可留空。如果使用了“智能解析”，此处将被自动填入。 |
| **密码 (可选)** | 选填 | `myPassword123` | 点击右侧小眼睛图标 👁️ 可以切换显示或隐藏密码。如果使用了“智能解析”，此处将被自动填入。 |
| **伪装时区名** | **建议启用** | `America/New_York` 或 `Europe/London` | **无需手动填写**。智能填充已自动为您调用检测服务并填入与 IP 完美对应的时区！ |
| **防关联指纹遮罩** | **建议全开** | 保持所有开关处于开启（蓝色）状态 | 这是你对抗平台设备指纹检测的“金身盾牌”，非特殊调试不建议关闭。 |

---

## 🚀 使用场景

### 场景一：新浏览器分身（Profile）初始化配置

这是你在一台新电脑，或建立一个新的 Chrome 多开分身后，首次激活防关联环境的步骤：

1.  **新建分身**：在 Chrome 右上角头像处，点击“添加”创建一个全新的浏览器分身。
2.  **载入插件**：在 `chrome://extensions/` 开启开发者模式，点击“加载已解压的扩展程序”，选中 `chromeTools` 文件夹。
3.  **智能一键配置代理与时区**：
    *   点击右上角 OmniFlow 拼图图标打开面板。
    *   在顶部的 **`智能一键解析填充`** 输入框中，直接粘贴代理厂商提供给您的格式（支持 `IP:端口:账号:密码`、URL 或带有协议头的格式）。
    *   点击 **`智能填充`** 按钮。
    *   *注*：按钮将闪过 `解析成功` 绿灯。此时，插件不仅将全部配置瞬间填入下方，**还会自动链式触发【自动识别 IP 时区】逻辑**，为您完成最关键的时区对齐伪装。整个流程只需一键！
4.  **应用保存**：点击下方的 **`应用配置并保存`** 激活盾牌。
5.  **环境体检**：检查“实时风控环境报告”中的 IP、地址和时区状态是否均处于**绿灯（✅ 100% 对齐成功）**。
6.  **安全运营**：现在你可以放心在当前分身中打开 `x.com` 或其他平台进行登录运营，你的真实 IP 与系统指纹已处于严密保护中。

---

### 场景二：跨电脑/跨分身一键克隆（Session 免密导入）

当你需要把一个分身中的已登录账号（如 X.com）安全地迁移给你的员工、同伴，或者克隆到另外一台电脑上时：

1.  **在源分身中导出**：
    *   打开源分身的 OmniFlow 面板，点击 **`📤 备份当前环境`**。
    *   插件会瞬间扫描当前分身的所有 Cookies 和代理设置，并在你的系统下载目录中直接生成并下载一个名为 `[IP]_[端口].json` 的备份文件。
2.  **分发备份**：将这个 `.json` 文件通过安全渠道发送给接收方。
3.  **在目标分身中导入**：
    *   在接收方的 Chrome 分身中，同样安装好 OmniFlow 插件。
    *   打开 OmniFlow 面板，点击 **`📥 还原环境备份`**，选择你刚刚发送过去的 `.json` 文件。
4.  **见证奇迹**：
    *   插件会提示：`正在恢复 X 个全新免密 Sessions...` 随后亮起绿灯。
    *   在接收方的分身里直接输入 `https://x.com` 打开网页 —— **你会发现账号已经直接处于登录状态，头像、私信、关注完全同步，完全不需要输入任何账号密码，完美避开异地登录风控！**

---

### 场景三：日常无感平滑升级（零数据丢失）

当你收到我们的新版升级大包（如 `OmniFlow_1.0.0.zip` 新迭代版本）时，如何进行升级才最省心？

*   **极简操作**：
    1.  将最新的 zip 压缩包解压。
    2.  全选解压出来的所有文件，直接**复制并替换覆盖**你原有的插件文件夹中的同名文件。
    3.  打开浏览器的 `chrome://extensions/` 页面，在 OmniFlow 卡片底部点击一下 **“顺时针圆形刷新箭头 ⟳”**。
*   **为什么不用担心数据**：
    *   我们已经在 `manifest.json` 中为你**锁死了永久特征公钥 (`key`)**。
    *   无论你替换多少次文件，插件的 ID 永远是 `gldlmlfmokaoacfblahhakikkocofihp` 保持不变。
    *   你的所有代理配置、保存的密码、以及当前已经登录的账号 Session 都会**自动 100% 继承**，升级完全无感、不需要任何导入导出！

---

### 场景四：安全撤离与一键无痕销毁

当你的某个账号被弃用、当前分身不再需要运营，或者你需要完全卸载插件并退回本机 Raw 环境时，为了防止你的国内真实 IP 泄露给残留的登录 Session，必须执行此操作：

1.  **一键销毁**：打开 OmniFlow 面板，点击最下方的 **`🔥 一键彻底重置与销毁分身`** 按钮。
2.  **二次确认**：在弹出的系统警告框中点击“确认”。
3.  **深度抹除中**：插件会在毫秒内触发强力清洗程序：
    *   物理清除当前浏览器 Profile 下的所有网站的已登录 Cookies（强行全网登出所有账号，切断与平台的连接）。
    *   清空 `chrome.storage.local` 里的所有本地代理与指纹草稿。
    *   彻底清除代理接管，将网络环境安全归还给系统默认。
4.  **安全移除**：此时，你可以放心地在 `chrome://extensions/` 页面中将插件点击 **“移除”**。由于浏览器里已没有任何登录会话，你的真实 IP 绝对不会暴露给平台，实现了 100% 完美的无痕撤离！

---

## ⚠️ 跨境运营准则（风控红线）

为了保障你的账号资产安全，请所有运营人员严格遵守以下黄金红线：

1.  **【强隔离准则】一个 Chrome 分身，只用一个代理 IP，登录一个主账号！**
    *   *解释*：绝对不要在同一个 Chrome 分身（Profile）里频繁切换代理 IP 去登录不同的 X 账号。IP 的高频变动和 Cookies 的交叉感染是平台封号的第一大杀手。
2.  **【绿灯准则】未亮绿灯，绝不登录！**
    *   *解释*：每次打开浏览器分身时，第一件事是点击右上角插件面板，检查风控报告中的 **`时区对齐状态`** 是否显示为 **`✅ 100% 对齐成功 (亮绿灯)`**。如果显示为红灯（系统时区与代理时区不一致），请点击保存重新自动获取时区，直到绿灯亮起才可访问平台网站！
3.  **【先重置，后卸载】绝对不可在未清除 Cookies 的情况下直接移除插件！**
    *   *解释*：如果直接点移除插件，未过期的 Cookies 会立刻在你国内的真实 IP 下重载，导致异地登录被秒封。必须遵循【场景四】先点火苗销毁，再点移除。
4.  **【慎用登出】在多开分身运营时，不需要时直接关闭浏览器即可，不要点击网页上的“Logout (退出登录)”！**
    *   *解释*：点击网页上的 Logout 会向平台服务器发送主动销毁 Session 的请求，可能会增加设备指纹的比对频次。正常使用时直接关闭浏览器窗口即可，下次打开分身，OmniFlow 会自动带你秒回登录状态。
