feat: 增强 OAuth 认证流程，优化回调状态处理与错误解释

docs/使用教程.md

@@ -1,24 +1,41 @@
-# Codex 注册扩展更新与 Clash Verge 非港轮询配置教程
-
-本教程用于说明如何更新 `Codex 注册扩展`，以及如何在 `Clash Verge` 中配置 `🔁 非港轮询`。
+本教程用于说明相关项目地址、扩展更新方式，以及 `Clash Verge` 的 `🔁 非港轮询` 配置方法。
 
 ## 适用场景
 
+- 需要拉取并部署 `cpa` 或 `sub2api` 项目
 - 已经安装本扩展，想更新到最新版本
 - 想用更方便的方式长期同步扩展更新
 - 需要在 `Clash Verge` 中启用 `🔁 非港轮询`
 
 ## 准备内容
 
+- 可以访问 `GitHub`
 - 已安装好的扩展文件夹
 - 可以打开浏览器的 `扩展程序管理` 页面
-- 如需使用 `git pull`，本地已安装 `git`
-- 如需使用 `GitHub Desktop`，本地已安装 `GitHub Desktop`
+- 如需部署 `cpa`，部署环境必须可以访问 `OpenAI`
 - 已安装 `Clash Verge`，并已导入可用订阅
 
 ## 操作步骤
 
-### 第一部分：更新扩展
+### 第一部分：相关项目地址与部署说明
+
+1. 查看项目地址  
+   `cpa` 项目地址：<https://github.com/router-for-me/CLIProxyAPI>  
+   `sub2api` 项目地址：<https://github.com/Wei-Shaw/sub2api>
+
+2. 拉取项目到本地  
+   先将你需要的项目拉取到本地目录。  
+   可以使用 `git clone`，也可以直接下载项目压缩包后解压。
+
+3. 让 AI 直接协助部署  
+   部署教程这里不单独展开。  
+   将项目拉取下来后，直接让 AI 帮你部署即可。
+
+4. 确认 `cpa` 的部署环境  
+   如果你部署的是 `cpa`，部署所在环境必须可以访问 `OpenAI`。  
+   否则可能会出现第十步显示认证成功，但实际上没有生成认证文件的情况。
+
+### 第二部分：更新扩展
 
 1. 使用 `GitHub Desktop` 更新  
    先安装 `GitHub Desktop`。  
@@ -40,16 +57,16 @@
    找到该扩展后，手动点击一次 `重新加载`。  
    这一步一定要做，否则浏览器可能仍在使用旧版本。
 
-### 第二部分：配置 `Clash Verge` 的 `🔁 非港轮询`
+### 第三部分：配置 `Clash Verge` 的 `🔁 非港轮询`
 
 #### 第一步：添加扩展脚本
 
 1. 打开 `Clash Verge`，进入左侧的 `订阅`（`Profiles`）界面。
 2. 在右上角或对应位置找到并双击打开 `全局扩展脚本`（`Merge/Script`）。
-3. 将里面的内容全部清空，替换为下方格式化好的代码。
+3. 将里面的内容全部清空，替换为下方脚本代码。
 4. 点击保存，使用右上角保存按钮或按 `Ctrl+S`。
 
-💻 格式化后的代码（如果遇到格式错误，则让豆包修复一下）
+💻 脚本代码（如果遇到格式错误，可让豆包帮你修复后再粘贴）
 
 ```javascript
 function uniqPrepend(arr, items) {
@@ -146,10 +163,28 @@ function main(config, profileName) {
 4. 确认右上角的 `代理模式`（`Mode`）已经设置为 `规则模式`（`Rule`）。
 5. 确认左侧 `设置` 中的 `系统代理`（`System Proxy`）已经开启。
 
+## 常见问题
+
+### 为什么第十步显示认证成功，但没有认证文件？
+
+这通常是因为 `cpa` 部署所在环境无法访问 `OpenAI`。请先确认部署环境可以正常访问 `OpenAI`，然后再重新执行相关认证步骤。
+
+### 为什么更新完扩展后还是旧版本？
+
+如果你只是替换了本地文件，但没有去浏览器的 `扩展程序管理` 页面点击 `重新加载`，浏览器不会立即启用新版本。请更新完成后手动重新加载一次该扩展。
+
+### `git pull` 提示不是 Git 仓库怎么办？
+
+这通常说明你进入的不是正确目录，或者当前文件夹不是通过 `git` 管理的版本。此时可以改用 `GitHub Desktop`，或者直接使用手动下载覆盖的方式更新。
+
+### 为什么没有看到 `🔁 非港轮询`？
+
+请先确认脚本已经完整粘贴并保存，然后回到 `代理` 页面重新查看。若仍未出现，请继续确认当前订阅可用、`代理模式` 为 `规则模式`，并且 `系统代理` 已开启。
 
 ## 注意事项
 
 - 不论使用哪种方式更新扩展，更新完成后都必须在浏览器的 `扩展程序管理` 页面重新加载一次该扩展。
+- 如需部署 `cpa`，请先确认部署环境可以访问 `OpenAI`，否则可能出现第十步认证成功但没有认证文件的问题。
 - 如果你长期更新扩展，优先使用 `git pull`，这是最方便、最推荐的方式。
 - 使用手动覆盖更新时，请直接覆盖当前扩展文件夹，避免同时保留多份不同版本的目录。
-- 在 `Clash Verge` 中粘贴脚本时，请先清空旧内容，再完整粘贴新代码并保存。
+- 在 `Clash Verge` 中粘贴脚本时，请先清空旧内容，再完整粘贴新代码并保存。