==========================================================
 Grok 账号自助换新工具 —— 使用说明（502 / token 过期救急）
==========================================================

一、什么时候用这个工具
----------------------------------------------------------
  你的号出现以下情况，基本都是 token 过期，重跑一次本工具即可：
    - 请求报 502 / 503
    - 提示 Invalid SSO / token expired / unauthorized
    - 突然连不上模型了
  不需要找卖家换号，账号还是你的账号，只是换一把新钥匙。

二、压缩包里有什么
----------------------------------------------------------
  grok_refresh.py       主程序（纯 Python 标准库，无需装第三方包）
  grok_refresh.bat      Windows 一键启动（双击它就行）
  grok_refresh_readme.txt  本说明

三、准备工作（一次性）
----------------------------------------------------------
  1. Windows 电脑
  2. 安装 Python（3.8 及以上）：
     官网 https://www.python.org/downloads/ 下载安装，
     安装时务必勾选【Add Python to PATH】
  3. 电脑能访问 x.ai（如果平时要开代理才能上外网，请开全局/TUN 模式）

四、换新步骤（每次 502 都这样做）
----------------------------------------------------------
  第 1 步：解压本压缩包，把提货下载的「账号 json 文件」和
          grok_refresh.py / grok_refresh.bat 放在同一个文件夹
          （也可以直接把账号 json 拖到 grok_refresh.bat 图标上）

  第 2 步：双击 grok_refresh.bat
          脚本会显示你的账号邮箱，并自动打开浏览器
          * 浏览器没弹出来？把黑窗口里显示的「授权链接」复制到浏览器打开

  第 3 步：在浏览器网页里：
          - 如果要求登录：输入你账号的邮箱和密码（提货时给你的那组）
          - 看到「允许 / Allow」授权页：点允许

  第 4 步：回到黑窗口等几秒，看到 [DONE] 即成功
          会在同目录生成「xxx_new.json」新文件
          把新文件重新导入你的工具（旧的删掉/覆盖），搞定！

五、常见问题
----------------------------------------------------------
  Q1: 双击 bat 提示 "找不到 python"？
      A: 没装 Python 或没勾 Add to PATH，重装并勾选（见第三节）。

  Q2: 提示 "没有找到账号文件"？
      A: 把提货下载的 json 文件放到和脚本同一个文件夹，或拖到 bat 上。

  Q3: 卡在"等待你在浏览器里完成授权"？
      A: 浏览器里还没点「允许」。点完几秒内会自动继续。
         超过 15 分钟会退出，重跑一次即可。

  Q4: 提示网络失败 / 切换备用通道？
      A: 脚本会自动尝试备用通道（首次可能自动安装 curl_cffi 小库）。
         仍失败：确认能上 x.ai；有本地代理的话，运行前设置：
         set GROK_REFRESH_PROXY=http://127.0.0.1:7890
         （7890 换成你自己的代理端口，Clon 一般 7890，v2rayN 一般 10809）

  Q5: 登录页说密码错误？
      A: 用提货信息里的原始邮箱+密码。邮箱 +N 后缀（如 +6）是同一账号
         的别名，登录时按提货给的完整邮箱输入。

  Q6: 换新成功但还是 502？
      A: 确认导入的是 xxx_new.json 新文件；并完全重启你的工具/软件。

  Q7: 一个文件里有多个账号？
      A: 脚本会让你选序号，一个一个换。

  Q8: 会泄露我的账号密码吗？
      A: 脚本不收集任何信息。登录发生在 x.ai 官方网页（accounts.x.ai），
         密码只在官方页面输入，脚本只接收 x.ai 返回的 token。

六、还是不行？
----------------------------------------------------------
  把黑窗口里的完整报错截图发给卖家客服。
==========================================================
