Grok 切换器 (Grok Switch)

一款 Chrome / Edge (Chromium) 扩展，帮助你 一键切换多个 Grok 账号。所有账号数据仅保存在你本地浏览器，不会上传到任何服务器。

---

✨ 功能

1. 多账号管理 — 本地存储多个 Grok 账号的浏览器会话，无需重复登录
2. 一键切换 — 在 popup 中点「切换」即可还原对应账号的登录态
3. 账号导入 / 导出 — 一键备份为 JSON，换机或重装后恢复
4. 文件夹导入 — 直接选择账号文件夹，自动批量识别并导入
5. 批量删除 — 选择模式批量清理不再使用的账号
6. 多语言 — 中文 / 英文界面切换

---

🚀 安装（开发者模式）

1. 打开 Chrome / Edge，访问 chrome://extensions/（Edge 为 edge://extensions/）
2. 右上角开启 开发者模式 (Developer mode)
3. 点击 加载已解压的扩展程序 (Load unpacked)，选择本目录 grok-account-helper/
4. 固定扩展图标到工具栏

---

📖 使用

1. 在浏览器里登录你的一个 Grok 账号（需先登录 X / grok.com）
2. 点击扩展图标 → 捕获当前会话 → 填写账号名称保存（这会备份当前登录态 Cookie）
3. 用同样方法登录并捕获第二个、第三个账号
4. 之后点列表里的 切换 即可一键还原对应账号，无需重新登录

文件夹导入

点击 popup 中的 导入，选择一个文件夹，扩展会递归扫描其中所有 .json 文件，并自动识别以下格式：

• 本扩展自身导出的备份文件（app: grok-account-helper）
• grok-switch 的 registrar cookie 文件（含 cookies 数组，即真实浏览器登录态）
• grok-switch 的 pool 文件（内含 accounts 数组）
• grok-switch 的单条 token 账号文件（accounts/*.json）

识别成功后会自动合并去重导入。

一键导入并直接切换（registrar cookie 文件）

如果你的账号来自 grok-switch 的 registrar 导出（~/.grok_switch/registrar/cookies/*.json），这些文件里保存的是 真实的浏览器 Cookie（x.ai / auth.x.ai / accounts.x.ai / grok.com 等域的 SSO 登录态，含 sso / sso-rw 等）。直接选 registrar/cookies 文件夹即可批量导入：

• ✅ 这些账号导入后无需再登录，可直接在 grok.com 一键切换
• 扩展会自动按账号实际包含的域名清+写 Cookie，并兼容 first-party partition（partitionKey.topLevelSite → sourceOrigin）
• 插件已在 manifest 声明 x.ai / auth.x.ai / accounts.x.ai / grok.com 的 host 权限，可正常写入

实测前提：这些 Cookie 未过期（文件里 expires 时间戳仍在未来）、且 x.ai 的 SSO 仍有效。导入后建议在 grok.com 上确认是否真的免登录。

从 grok-switch 导入（仅 Token 账号，不可直接切换）

如果你的账号是 grok-switch 的 pool / accounts token 文件（~/.grok_switch/grok_pool/accounts/*.json 或 cpa_auths/*.json），选择对应文件夹导入即可。

⚠️ 重要限制：这些 JSON 里存的是 OAuth / API token（access_token、local_api_key），不是浏览器 Cookie。官网 grok.com 的登录态依赖 x.ai 的 SSO Cookie，token 和网站登录态是两套独立的认证体系。因此：

• ✅ 导入会把账号（邮箱 / 健康状态等元数据）加进列表
• ⚠️ 导入的账号标记为「仅 Token」，无法直接用于官网切换
• 🔧 要让它能在官网切换：用该浏览器在 grok.com 登录这个账号后，点该账号的 编辑 → 保存（或在 grok.com 登录后「捕获当前会话」），扩展会覆盖写入真实浏览器 Cookie

注意区分：同样是 grok-switch 的数据，registrar/cookies/*.json 是可用的浏览器会话；grok_pool/accounts/*.json、cpa_auths/*.json 是不可用的 token 文件。扩展会自动判断，可直接切换的账号不会出现「需捕获会话」提示。

---

🧱 工程结构

grok-account-helper/
├── manifest.json              # MV3 清单
├── lib/
│   ├── i18n.js                # 中英文案切换
│   └── store.js               # 账号/设置读写、导入导出、格式识别
├── popup/                     # 工具栏弹窗（主界面）
├── options/                   # 设置页
├── background/
│   └── service-worker.js      # 账号切换、捕获会话
├── icons/                     # 16/48/128 扩展图标
├── scripts/
│   └── gen_icons.py           # 图标生成脚本
├── docs/
│   ├── README.md              # 详细文档
│   └── images/
│       └── screenshot.png     # 界面截图
└── README.md                  # 本文件

---

⚠️ 已知限制与实测建议

• Cookie 切换成功率：取决于 x.com 对 cookie 的保护。实测前请准备两个已登录账号，验证切换后是否真的免登录。若失败，工程日志会在后台 chrome://extensions 的 Service Worker 控制台打印 set cookie failed。
• 数据安全：账号 Cookie 明文存在浏览器本地存储。不要在有恶意软件或被他人物理访问的设备上使用；本扩展不上传任何数据。

---

🔗 友链

• 学 AI，上 L 站

---

📄 许可

MIT — 仅供学习与个人使用。使用本扩展请遵守 X / Grok 的服务条款。