Refactor GPC plus flow to page recharge

2026-05-29 10:09:26 +08:00
parent 9ef9cb4c46
commit 56f52cb858
40 changed files with 1278 additions and 5203 deletions
@@ -28,7 +28,7 @@
 | 06 | PayPal 注册与绑卡使用教程 | `PayPal`、注册、绑卡、钱包、身份认证、右上角通知 | `docs/使用教程/分部分/06-PayPal-注册与绑卡使用教程.md` |
 | 07 | ChatGPT Plus 订阅说明（待人工审核） | `ChatGPT Plus`、订阅说明、支付流程说明、人工审核 | `docs/使用教程/分部分/07-0元试用-ChatGPT-Plus-教程.md` |
 | 08 | Clash Verge 非港轮询配置 | `Clash Verge`、`非港轮询`、扩展脚本、规则模式、系统代理 | `docs/使用教程/分部分/08-Clash-Verge-非港轮询配置.md` |
-| 09 | GPC 卡密与 API 使用说明 | `GPC`、充值卡密、`API` 卡密、`API Key`、自动化扩展、短信 `Helper` | `docs/使用教程/分部分/09-GPC-卡密与-API-使用说明.md` |
+| 09 | GPC 卡密页面充值说明 | `GPC`、充值卡密、卡密余额、网页充值、`ChatGPT Plus` | `docs/使用教程/分部分/09-GPC-卡密页面充值说明.md` |

 ---

@@ -69,7 +69,7 @@
 3. 根据你当前使用的邮箱方案，选择 `03`、`04`、`05`
 4. 如果需要支付和订阅，再看 `06`、`07`
 5. 如果需要代理配置，再看 `08`
-6. 如果需要 `GPC` 卡密、`API Key` 或自动化接入，再看 `09`
+6. 如果需要使用 `GPC` 卡密网页充值，再看 `09`

 ---

@@ -78,7 +78,7 @@ AI 维护时默认按下面的范围归类：
 | 06 | PayPal 注册与绑卡使用教程 | `PayPal`、注册、绑卡、钱包、身份认证、右上角通知 | `docs/使用教程/分部分/06-PayPal-注册与绑卡使用教程.md` |
 | 07 | ChatGPT Plus 订阅说明（待人工审核） | `ChatGPT Plus`、订阅说明、支付流程说明、人工审核 | `docs/使用教程/分部分/07-0元试用-ChatGPT-Plus-教程.md` |
 | 08 | Clash Verge 非港轮询配置 | `Clash Verge`、`非港轮询`、扩展脚本、规则模式、系统代理 | `docs/使用教程/分部分/08-Clash-Verge-非港轮询配置.md` |
-| 09 | GPC 卡密与 API 使用说明 | `GPC`、充值卡密、`API` 卡密、`API Key`、自动化扩展、短信 `Helper` | `docs/使用教程/分部分/09-GPC-卡密与-API-使用说明.md` |
+| 09 | GPC 卡密页面充值说明 | `GPC`、充值卡密、卡密余额、网页充值、`ChatGPT Plus` | `docs/使用教程/分部分/09-GPC-卡密页面充值说明.md` |

 ---

@@ -1,129 +0,0 @@
-# 第九部分：GPC 卡密与 API 使用说明
-
-## 部分信息
-
- `section_slug`: `gpc-card-code-and-api`
- `适用主题`: `GPC`、充值卡密、`API` 卡密、`API Key`、自动化扩展、短信 `Helper`
- `维护方式`: `直接更新本文件`
-
-## 适用场景
-
- 需要区分 `GPC` 充值卡密和 `API` 卡密
- 号商需要给指定账号直接开通 `ChatGPT Plus`
- 自动化扩展插件需要接入 `GPC` 模式
- 中转站、账号系统或反代系统需要批量自动注册、补号和订阅
- 需要配合短信 `Helper` 自动补号、自动提交验证码
-
-## 准备内容
-
- 已获取对应类型的 `GPC` 卡密
- 可以打开 `GPC` 前台
- 如果使用 `API` 模式，需要准备自动化扩展插件
- 如果需要全自动补号，需要准备并配置短信 `Helper`
- 如果还没有 `API` 次数套餐，可以先打开购买页面：[https://pay.ldxp.cn/item/9u90k7](https://pay.ldxp.cn/item/9u90k7)
-
-## 核心区别
-
-| 类型 | 适合对象 | 主要用途 | 使用方式 |
-|---|---|---|---|
-| 充值卡密 | 号商、人工直冲用户 | 给指定账号直接开通 `ChatGPT Plus` | 在 `GPC` 前台选择充值卡密登录后创建充值任务 |
-| `API` 卡密 | 自动化插件、中转站、反代系统 | 批量自动补号、自动注册、自动订阅 | 先兑换成 `API Key`，再填入自动化扩展或系统 |
-
-简单理解：
-
- 充值卡密 = 给某个账号直接充值 `Plus`
- `API` 卡密 = 兑换接口额度，用于自动化扩展或系统集成
-
-## 核心优势
-
- 私有协议链路，流程更稳定
- 授权 `CODEX` 后，99% 场景不风控、不弹 `add-phone`
- 无需额外接码平台，配合短信 `Helper` 即可自动处理验证码
- `API` 模式适合自动化补号、批量注册、批量订阅和反代系统接入
- 充值卡密适合单账号直冲，`API` 卡密适合系统化批量接入
-
-## 操作步骤
-
-### 方案一：使用充值卡密直冲
-
-充值卡密主要用于给指定账号直接开通 `ChatGPT Plus`，适合人工或半自动的账号直冲场景。客户只需要提供要充值账号的授权信息，不需要自己准备 `GoPay`。
-
-#### 第一步：获取充值卡密
-
-先确认手里拿到的是充值卡密，而不是 `API` 卡密。
-
-#### 第二步：打开 `GPC` 前台
-
-进入 `GPC` 前台页面后，选择充值卡密相关入口。
-
-#### 第三步：选择充值卡密登录
-
-在登录方式中选择 `充值卡密登录`，然后输入充值卡密。
-
-#### 第四步：填写要充值账号的授权信息
-
-按照页面提示输入需要开通 `Plus` 的账号授权信息。
-
-#### 第五步：创建充值任务
-
-确认账号信息无误后创建充值任务，并等待系统执行。
-
-#### 第六步：确认任务结果
-
-任务成功后，会扣减 1 次卡密次数。此时对应账号的 `ChatGPT Plus` 开通流程即完成。
-
-### 方案二：使用 `API` 卡密接入自动化扩展
-
-`API` 卡密本身不是直接拿来请求任务接口的。使用前需要先兑换出 `API Key`，后续由自动化插件或系统使用 `API Key` 调用。
-
-#### 第一步：购买 `API` 次数套餐
-
-打开下面页面购买对应次数套餐：
-
-[https://pay.ldxp.cn/item/9u90k7](https://pay.ldxp.cn/item/9u90k7)
-
-#### 第二步：兑换 `API Key`
-
-购买后打开下面页面兑换：
-
-[https://gpc.qlhazycoder.top/兑换](https://gpc.qlhazycoder.top/%E5%85%91%E6%8D%A2)
-
-输入 `API` 卡密后，会获得一个 `API Key`。
-
-#### 第三步：填写到自动化扩展
-
-打开自动化扩展插件后，按下面顺序配置：
-
-1. 启用 `GPC 模式`
-2. 填写兑换得到的 `API Key`
-3. 填写 `GPC` 相关参数
-4. 如需全自动补号，开启并配置短信 `Helper`
-5. 保存配置
-
-配置保存后，自动化扩展即可开始执行注册账号和开通流程。
-
-## 常见问题
-
-### 充值卡密可以填到自动化扩展里吗？
-
-不建议。充值卡密主要用于 `GPC` 前台的账号直冲流程；自动化扩展应使用 `API` 卡密兑换出来的 `API Key`。
-
-### `API` 卡密可以直接请求任务接口吗？
-
-不可以。`API` 卡密需要先到兑换页面换成 `API Key`，后续请求接口或填写扩展配置时使用的是 `API Key`。
-
-### 忘记 `API Key` 怎么办？
-
-可以回到兑换页面，用原来的 `API` 卡密再次查看对应的 `API Key`。
-
-### 什么时候会扣减次数？
-
-充值卡密通常在充值任务成功后扣减 1 次。`API` 模式的次数扣减以接口任务执行结果和系统记录为准。
-
-## 注意事项
-
- 充值卡密和 `API` 卡密用途不同，请不要混用
- `API` 卡密需要先兑换成 `API Key`，再填入自动化扩展
- `API Key` 请妥善保存，不要公开泄露
- 忘记 `API Key` 时，可以回到兑换页面用原 `API` 卡密再次查看
- 全自动补号场景需要同时确认短信 `Helper` 已正确启用
@@ -0,0 +1,66 @@
+# 第九部分：GPC 卡密页面充值说明
+
+## 部分信息
+
+- `section_slug`: `gpc-card-page-recharge`
+- `适用主题`: `GPC`、充值卡密、卡密余额、网页充值、`ChatGPT Plus`
+- `维护方式`: `直接更新本文件`
+
+## 适用场景
+
+- 需要在扩展中使用 `GPC` 卡密开通 `ChatGPT Plus`
+- 需要自动打开 `GPC` 页面、填写卡密和 ChatGPT session
+- 需要在充值前查看卡密格式、状态和剩余次数
+
+## 准备内容
+
+- 一个格式类似 `GPC-6C9F1A32-45734795-914E6F00` 的 `GPC` 卡密
+- 当前浏览器中可访问 [https://gpc.qlhazycoder.top/](https://gpc.qlhazycoder.top/)
+- 当前 ChatGPT 账号已经登录，并能正常访问 `https://chatgpt.com/api/auth/session`
+- 如果还没有卡密，可以通过侧边栏的 `购买卡密` 按钮打开购买入口
+
+## 扩展中的配置
+
+1. 打开侧边栏并启用 `Plus 模式`
+2. 在 `Plus 支付` 中选择 `GPC`
+3. 在 `GPC 卡密` 输入框填写卡密
+4. 停止输入 1 秒后，扩展会自动检查格式并查询剩余次数
+5. 状态显示正常后，再启动自动流程或手动执行 GPC 步骤
+
+## 自动流程
+
+### 第六步：打开 GPC 页面并准备
+
+扩展会打开或复用 `GPC` 页面，确认页面中的卡密输入框内容和侧边栏保存的卡密一致；如果不一致，会直接覆盖为当前卡密。
+
+同一步还会异步读取 ChatGPT session 的完整 JSON 内容，并填入 `GPC` 页面左下角的文本框；如果页面里已有旧内容，也会覆盖为本轮读取到的 session。
+
+准备完成后，流程进入下一步。
+
+### 第七步：启动并等待 GPC 完成
+
+扩展会点击 `开始plus充值`，页面按钮会进入 `任务进行中` 状态。随后扩展持续读取右侧日志和按钮文案：
+
+- 如果日志出现 `订阅完成`，并且按钮恢复为 `开始plus充值`，本轮 GPC 充值完成
+- 如果没有出现 `订阅完成`，但按钮恢复为 `开始plus充值`，扩展会再次点击启动
+- 如果日志出现 `该账户没有试用资格`，当前轮直接失败
+- 如果长时间没有完成，会按后台超时规则结束当前 GPC 页面流程
+
+## 常见问题
+
+### 卡密格式不正确怎么办？
+
+扩展只接受 `GPC-XXXXXXXX-XXXXXXXX-XXXXXXXX` 这种格式，其中 `X` 为大写或小写的十六进制字符。输入后扩展会自动转成大写。
+
+### 为什么没有自动查询余额？
+
+余额检测会在停止输入约 1 秒后触发。没有填写卡密、格式不正确、页面接口不可用或网络失败时，状态区会显示对应错误。
+
+### GPC 页面已有旧卡密或旧 session 会怎样？
+
+第六步会以侧边栏当前保存的卡密和本轮读取到的 ChatGPT session 为准，页面已有内容会被覆盖。
+
+## 注意事项
+
+- 当前扩展只保留 `GPC` 网页充值链路和卡密余额检测
+- 充值是否成功以 `GPC` 页面日志中的 `订阅完成` 为准