diff --git a/docs/使用教程/使用教程.md b/docs/使用教程/使用教程.md new file mode 100644 index 0000000..dcc8110 --- /dev/null +++ b/docs/使用教程/使用教程.md @@ -0,0 +1,70 @@ +# 使用教程总索引 + +本目录用于维护 `Codex 注册扩展` 的分部分使用教程。 +从现在开始,教程正文不再直接堆到这一个文件里,而是拆到 `分部分/` 目录下分别维护。 + +--- + +## 1. 当前目录说明 + +- `使用教程.md` + - 总索引、部分清单、维护规则 +- `使用教程书写模板.md` + - 给 AI 的固定维护模板 +- `分部分/*.md` + - 每个独立主题的正文文件 + +--- + +## 2. 当前已拆分部分 + +| 序号 | 部分标题 | 主要覆盖主题 | 文件 | +|---|---|---|---| +| 01 | 相关项目地址与部署说明 | `cpa`、`sub2api`、项目地址、部署前提、部署环境 | `docs/使用教程/分部分/01-相关项目地址与部署说明.md` | +| 02 | 更新扩展 | `git pull`、`GitHub Desktop`、手动覆盖更新、扩展重新加载 | `docs/使用教程/分部分/02-更新扩展.md` | +| 03 | Cloudflare Temp Email 使用说明 | `Cloudflare Temp Email`、`Admin Auth`、`Custom Auth`、随机子域、邮件接收 | `docs/使用教程/分部分/03-Cloudflare-Temp-Email-使用说明.md` | +| 04 | iCloud 隐私邮箱使用方法 | `iCloud+`、`隐藏邮件地址`、Apple ID、转发邮箱、刷新隐私邮箱 | `docs/使用教程/分部分/04-iCloud-隐私邮箱使用方法.md` | +| 05 | QQ 邮箱切换邮箱使用教程 | `QQ 邮箱`、英文邮箱、`Foxmail`、删除后重建 | `docs/使用教程/分部分/05-QQ-邮箱切换邮箱使用教程.md` | +| 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` | + +--- + +## 3. 当前还未落成独立部分、但后续可能要新开的主题 + +下面这些主题在旧总述里已经提到过,但目前还没有单独的部分文件: + +- `HeroSMS` 手机接码扩展使用教程 +- 节点检测与纯净度检查网站使用教程 + +如果后续收到这些主题的新增内容,优先新开部分,而不是硬塞到现有 8 个文件里。 + +--- + +## 4. 维护规则 + +1. `使用教程.md` 只维护总览和部分清单 +2. 具体正文只维护到 `分部分/*.md` +3. 更新已有主题时,直接改对应分部分文件 +4. 新增主题且无法归到现有部分时,创建新的分部分文件 +5. 新建部分后,必须同步更新本文件的部分清单 + +--- + +## 5. 不再继续放进教程正文的内容 + +旧版 `使用教程.md` 末尾的“破限提示词”不属于面向终端用户的使用教程正文。 +后续如果还需要保留这类内部提示词,请单独放到“内部资料”目录中管理,不要继续混在公开使用教程里,也不要继续让前台教程 AI 把它当作用户教程的一部分。 + +--- + +## 6. 建议阅读顺序 + +如果是第一次使用,推荐按下面顺序阅读: + +1. `01-相关项目地址与部署说明.md` +2. `02-更新扩展.md` +3. 根据你当前使用的邮箱方案,选择 `03`、`04`、`05` +4. 如果需要支付和订阅,再看 `06`、`07` +5. 如果需要代理配置,再看 `08` diff --git a/docs/使用教程/使用教程书写模板.md b/docs/使用教程/使用教程书写模板.md new file mode 100644 index 0000000..95c3d0d --- /dev/null +++ b/docs/使用教程/使用教程书写模板.md @@ -0,0 +1,278 @@ +# 使用教程书写与拆分模板 + +本文件用于约束 AI 后续维护 `docs/使用教程/` 目录时的判断方式、拆分规则和输出格式。 + +这套教程已经从“单一大文件”改成了“总索引 + 分部分正文文件”的结构。 +后续不要再把所有内容直接堆回 `使用教程.md`。 + +--- + +## 1. 目录结构 + +当前目录固定使用下面这套结构: + +- `docs/使用教程/使用教程.md` + - 作用:总索引、部分清单、维护规则 +- `docs/使用教程/使用教程书写模板.md` + - 作用:本模板,专门给 AI 使用 +- `docs/使用教程/分部分/*.md` + - 作用:每一个独立教程部分的正文文件 + +维护原则: + +1. `使用教程.md` 只放总览和部分列表 +2. 具体教程正文只放在 `分部分/*.md` +3. 新增教程主题时,优先判断是否属于现有部分 +4. 如果不属于现有部分,再新开一个部分文件 + +--- + +## 2. AI 维护流程 + +每次收到“更新教程”的任务时,必须先做下面 4 步: + +1. 先读取 `docs/使用教程/使用教程.md` +2. 再读取 `docs/使用教程/分部分/` 下现有文件 +3. 判断本次内容属于哪个已有部分 +4. 如果没有匹配部分,再新建部分文件,并同步更新 `使用教程.md` + +不要一上来直接写正文。 + +--- + +## 3. 先输出更新判断 + +AI 在真正改文档前,必须先给出一段“更新判断”。 + +固定格式如下: + +```md +## 更新判断 + +- 操作类型:`更新现有部分` / `新建部分` / `只更新总索引` +- 目标部分标题:`...` +- 目标文件:`docs/使用教程/分部分/xx-xxx.md` +- 判断理由:`...` +- 是否需要同步更新使用教程.md:`是` / `否` +``` + +要求: + +- 如果能明确归到已有部分,就选 `更新现有部分` +- 如果现有部分都不合适,就选 `新建部分` +- 只有在修改部分列表、排序、说明文字时,才选 `只更新总索引` + +--- + +## 4. 当前部分清单 + +AI 维护时默认按下面的范围归类: + +| 序号 | 部分标题 | 主要覆盖主题 | 文件 | +|---|---|---|---| +| 01 | 相关项目地址与部署说明 | `cpa`、`sub2api`、项目地址、部署前提、部署环境 | `docs/使用教程/分部分/01-相关项目地址与部署说明.md` | +| 02 | 更新扩展 | `git pull`、`GitHub Desktop`、手动覆盖更新、扩展重新加载 | `docs/使用教程/分部分/02-更新扩展.md` | +| 03 | Cloudflare Temp Email 使用说明 | `Cloudflare Temp Email`、`Admin Auth`、`Custom Auth`、随机子域、邮件接收 | `docs/使用教程/分部分/03-Cloudflare-Temp-Email-使用说明.md` | +| 04 | iCloud 隐私邮箱使用方法 | `iCloud+`、`隐藏邮件地址`、Apple ID、转发邮箱、刷新隐私邮箱 | `docs/使用教程/分部分/04-iCloud-隐私邮箱使用方法.md` | +| 05 | QQ 邮箱切换邮箱使用教程 | `QQ 邮箱`、英文邮箱、`Foxmail`、删除后重建 | `docs/使用教程/分部分/05-QQ-邮箱切换邮箱使用教程.md` | +| 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` | + +--- + +## 5. 什么时候要新建部分 + +满足任意一条,就应该新建部分,而不是硬塞到旧文件里: + +1. 新内容的主题和现有 8 个部分都不匹配 +2. 新内容会让已有文件明显跑题 +3. 新内容已经形成独立功能块,后续大概率会继续单独维护 +4. 新内容虽然在总述里提到过,但当前还没有专门的部分文件 + +典型需要新开的例子: + +- `HeroSMS` 手机接码扩展使用教程 +- 节点检测与纯净度检查网站使用教程 +- 新的邮箱方案使用教程 +- 新的代理配置方案 + +不应该新开的例子: + +- 只是补充 `PayPal` 一个报错说明 +- 只是更新 `Cloudflare Temp Email` 一个字段解释 +- 只是修改 `Clash Verge` 脚本中的几行配置说明 + +--- + +## 6. 新建部分时的文件命名规则 + +如果需要新开部分,使用下面规则: + +1. 放到 `docs/使用教程/分部分/` +2. 文件名格式: + +```text +NN-部分标题.md +``` + +例如: + +- `09-HeroSMS-手机接码扩展使用教程.md` +- `10-节点检测与纯净度检查网站使用教程.md` + +规则要求: + +- `NN` 使用两位数字 +- 按当前排序往后递增 +- 文件名直接使用中文标题,便于人工识别 +- 新建后必须同步更新 `使用教程.md` 的部分清单 + +--- + +## 7. 每个部分文件的固定结构 + +每个分部分正文文件都按下面结构写: + +```md +# 第X部分:部分标题 + +## 部分信息 + +- `section_slug`: `english-slug` +- `适用主题`: `主题 1`、`主题 2` +- `维护方式`: `直接更新本文件` + +## 适用场景 + +- ... + +## 准备内容 + +- ... + +## 操作步骤 + +### 第一步:... + +说明。 + +### 第二步:... + +说明。 + +## 常见问题 + +### 问题 1 + +说明。 + +## 注意事项 + +- ... +``` + +要求: + +- 继续使用标准 Markdown +- 不使用 HTML +- 命令、路径、按钮、文件名要用反引号 +- 操作步骤按真实顺序来写 +- 重要提示写在 `常见问题` 或 `注意事项` + +--- + +## 8. 更新已有部分时的要求 + +如果本次属于已有部分: + +1. 直接修改对应的分部分文件 +2. 保持原有标题和主题边界 +3. 如果只是补充小知识点,不要新开大段无关章节 +4. 如果文件标题已经不够覆盖新内容,再考虑是否需要拆成新部分 + +更新已有部分时,优先做这几件事: + +- 补充步骤 +- 修正常见问题 +- 更新注意事项 +- 调整准备内容 + +--- + +## 9. 同步更新总索引时要改什么 + +以下情况必须同步修改 `docs/使用教程/使用教程.md`: + +- 新增了部分文件 +- 删除了部分文件 +- 调整了部分顺序 +- 修改了部分标题 +- 新增了“待补充主题” + +以下情况通常不需要改总索引: + +- 只是补充某个部分里的正文 +- 只是修正文案 +- 只是补充 FAQ + +--- + +## 10. 输出格式要求 + +AI 最终输出必须分成两段: + +### 第一段:更新判断 + +固定使用本模板第 3 节的格式。 + +### 第二段:文档结果 + +根据情况二选一: + +1. 如果是更新已有部分 + 输出“修改后的完整分部分文件正文” + +2. 如果是新建部分 + 输出: + - 新文件路径 + - 新文件完整正文 + - 需要补到 `使用教程.md` 清单中的新表格行 + +不要只输出零散段落。 +要输出可直接覆盖文件的完整 Markdown。 + +--- + +## 11. 固定指令 + +把下面这段直接发给 AI: + +```md +请按 `docs/使用教程/使用教程书写模板.md` 执行。 + +你必须先读取: + +1. `docs/使用教程/使用教程.md` +2. `docs/使用教程/分部分/` 下现有文件 + +然后先输出“更新判断”,判断本次内容属于: + +- 更新现有部分 +- 新建部分 +- 只更新总索引 + +如果属于已有部分,就直接输出该部分文件的完整新版本。 +如果不属于已有部分,就新开一个部分文件,并同时给出需要补到 `使用教程.md` 的部分清单项。 + +要求: + +1. 输出必须是 Markdown +2. 不要使用 HTML +3. 不要把所有内容重新堆回 `使用教程.md` +4. 每个教程主题优先归到已有分部分文件 +5. 只有在现有部分都不合适时,才允许新开部分 +6. 文件名、路径、接口、按钮名称要用反引号包裹 +7. 面向第一次使用的人来写 +8. 步骤必须按真实顺序写 +``` diff --git a/docs/使用教程/分部分/01-相关项目地址与部署说明.md b/docs/使用教程/分部分/01-相关项目地址与部署说明.md new file mode 100644 index 0000000..299b487 --- /dev/null +++ b/docs/使用教程/分部分/01-相关项目地址与部署说明.md @@ -0,0 +1,62 @@ +# 第一部分:相关项目地址与部署说明 + +## 部分信息 + +- `section_slug`: `project-and-deployment` +- `适用主题`: `cpa`、`sub2api`、项目地址、部署前提、部署环境 +- `维护方式`: `直接更新本文件` + +## 适用场景 + +- 需要拉取并部署 `cpa` 项目 +- 需要拉取并部署 `sub2api` 项目 +- 需要先确认项目地址和部署前提 + +## 准备内容 + +- 可以访问 `GitHub` +- 一个可用的本地目录或服务器目录 +- 基础的 `git` 使用能力,或者可以手动下载压缩包 +- 如果要部署 `cpa`,部署环境必须可以访问 `OpenAI` + +## 操作步骤 + +### 第一步:确认项目地址 + +- `cpa` 项目地址:`https://github.com/router-for-me/CLIProxyAPI` +- `sub2api` 项目地址:`https://github.com/Wei-Shaw/sub2api` + +先确认你本次要部署的是哪个项目,再决定后续拉取和配置范围。 + +### 第二步:拉取项目到本地 + +可以用 `git clone` 拉取,也可以直接下载压缩包后解压。 +如果你准备后续持续更新,建议优先使用 `git clone`。 + +### 第三步:确认部署方式 + +本教程只负责把项目地址和部署前提说明清楚,不在这里展开完整部署命令。 +项目拉取到本地后,可以再让 AI 结合当前环境继续完成部署。 + +### 第四步:确认 `cpa` 的环境要求 + +如果你部署的是 `cpa`,部署所在环境必须可以访问 `OpenAI`。 +如果环境本身访问不到 `OpenAI`,后续认证流程可能会异常。 + +## 常见问题 + +### 为什么部署前要先分清 `cpa` 和 `sub2api`? + +因为两者仓库不同、运行方式不同、后续配置项也不同。 +如果一开始就搞混,后面让 AI 继续部署时很容易走错方向。 + +### 为什么认证看起来成功了,但没有生成认证文件? + +常见原因是 `cpa` 部署环境无法访问 `OpenAI`。 +这种情况下,前面看起来像是执行完成了,但关键结果并没有真正落盘。 + +## 注意事项 + +- 先确认本次目标项目,再继续部署 +- 需要长期维护时,尽量用 `git` 拉取,而不是每次手动覆盖 +- 部署 `cpa` 前,先确认环境确实能访问 `OpenAI` diff --git a/docs/使用教程/分部分/02-更新扩展.md b/docs/使用教程/分部分/02-更新扩展.md new file mode 100644 index 0000000..56f7086 --- /dev/null +++ b/docs/使用教程/分部分/02-更新扩展.md @@ -0,0 +1,77 @@ +# 第二部分:更新扩展 + +## 部分信息 + +- `section_slug`: `update-extension` +- `适用主题`: `git pull`、`GitHub Desktop`、手动下载覆盖、扩展重新加载 +- `维护方式`: `直接更新本文件` + +## 适用场景 + +- 已经安装过扩展,想更新到最新版本 +- 想知道哪种更新方式更省事 +- 更新完成后不知道浏览器里还要不要再操作一次 + +## 准备内容 + +- 当前扩展的本地文件夹 +- 可以打开浏览器的 `扩展程序管理` 页面 +- 至少具备下面 3 种更新方式中的一种: + - `GitHub Desktop` + - `git` + - 手动下载最新压缩包 + +## 操作步骤 + +### 第一步:选择更新方式 + +推荐优先级如下: + +1. `git pull` +2. `GitHub Desktop` +3. 手动下载覆盖 + +### 第二步:使用 `GitHub Desktop` 更新 + +如果你已经把仓库交给 `GitHub Desktop` 管理,后续只需要在软件里拉取最新提交即可。 +这种方式适合不想直接敲命令的人。 + +### 第三步:使用 `git pull` 更新 + +这是最方便、最推荐的方式。 + +1. 先安装 `git` +2. 打开终端 +3. 执行 `cd 扩展文件夹路径` +4. 再执行 `git pull` + +### 第四步:手动下载覆盖更新 + +如果你不用 `git`,也可以直接下载最新版本到本地,然后覆盖现有扩展文件夹。 +这种方式适合临时更新,但不适合频繁维护。 + +### 第五步:重新加载扩展 + +不论你用了哪种更新方式,更新完成后都必须: + +1. 打开浏览器的 `扩展程序管理` +2. 找到当前扩展 +3. 手动点击一次 `重新加载` + +## 常见问题 + +### 为什么我已经更新文件了,但浏览器里还是旧版本? + +因为浏览器不会自动重新读取本地扩展目录。 +如果你没有点击 `重新加载`,浏览器可能仍在继续使用旧版本。 + +### 哪种方式最推荐? + +推荐使用 `git pull`。 +它最省事,也最适合长期更新。 + +## 注意事项 + +- 更新完成后一定要手动 `重新加载` 扩展 +- 频繁维护时,尽量不要只靠手动下载覆盖 +- 如果本地改动较多,执行 `git pull` 前先确认是否需要备份本地修改 diff --git a/docs/使用教程/分部分/03-Cloudflare-Temp-Email-使用说明.md b/docs/使用教程/分部分/03-Cloudflare-Temp-Email-使用说明.md new file mode 100644 index 0000000..ad33232 --- /dev/null +++ b/docs/使用教程/分部分/03-Cloudflare-Temp-Email-使用说明.md @@ -0,0 +1,95 @@ +# 第三部分:Cloudflare Temp Email 使用说明 + +## 部分信息 + +- `section_slug`: `cloudflare-temp-email` +- `适用主题`: `Cloudflare Temp Email`、`Admin Auth`、`Custom Auth`、随机子域、邮件接收 +- `维护方式`: `直接更新本文件` + +## 适用场景 + +- 需要把 `Cloudflare Temp Email` 用作 `邮箱生成` +- 需要把 `Cloudflare Temp Email` 用作 `邮箱服务` +- 需要同时配置 `Temp API`、认证信息、域名和收件邮箱 + +## 准备内容 + +- 一个可用的 `Cloudflare Temp Email` 后端地址 +- 如果要使用随机子域,对应域名解析已经提前配置好 +- 后端的 `admin auth` +- 如果站点额外设置了访问密码,对应的访问认证信息 +- 一个真正用于接收转发邮件的收件邮箱 + +## 操作步骤 + +### 第一步:先确认当前用途 + +`Cloudflare Temp Email` 可以同时承担两类角色: + +- `邮箱生成` +- `邮箱服务` + +如果两边都选择了它,就需要把两套配置都填完整。 + +### 第二步:填写 `Temp API` + +在插件中先填写 `Temp API`,例如: + +- `https://your-worker-domain` + +不论你把它用于 `邮箱生成` 还是 `邮箱服务`,这一项都必须先配好。 + +### 第三步:按需填写 `Admin Auth` + +如果你把 `邮箱生成` 选择成 `Cloudflare Temp Email`,就需要填写 `Admin Auth`。 +它对应后端配置里的 `admin auth`。 + +### 第四步:按需填写 `Custom Auth` + +`Custom Auth` 只有在站点额外开启访问密码时才需要填写。 +如果没有这层额外访问密码,留空即可。 +它不会替代 `Admin Auth`。 + +### 第五步:配置 `Temp 域名` + +这里填写允许创建邮箱的基础域名。 +即使你开启了 `随机子域`,这里仍然填写基础域名,而不是随机出来的子域名。 + +### 第六步:按需开启 `随机子域` + +只有在 `邮箱生成 = Cloudflare Temp Email` 时,这一项才会生效。 +启用前需要先确认: + +- 后端已经配置 `RANDOM_SUBDOMAIN_DOMAINS` +- Cloudflare DNS 已经设置 `MX *` + +### 第七步:作为 `邮箱服务` 时填写 `邮件接收` + +如果 `邮箱服务` 也选了 `Cloudflare Temp Email`,还需要填写真正的收件邮箱。 +后续转发邮件会送到这里。 + +### 第八步:查看后端搭建参考 + +如果你还没有部署后端,可以参考: + +- `https://linux.do/t/topic/316819` + +## 常见问题 + +### 为什么我明明配了 `Temp API`,还是不能生成邮箱? + +先确认: + +- `邮箱生成` 是否真的选了 `Cloudflare Temp Email` +- `Admin Auth` 是否正确 +- `Temp 域名` 是否正确 + +### 为什么随机子域没有生效? + +通常是因为后端没有配置 `RANDOM_SUBDOMAIN_DOMAINS`,或者 Cloudflare DNS 没有完成 `MX *` 设置。 + +## 注意事项 + +- 如果同时把它用作 `邮箱生成` 和 `邮箱服务`,要把两边相关字段都检查一遍 +- `Custom Auth` 只有额外访问密码场景才需要填写 +- 开启随机子域前,先确认后端和 DNS 已经准备好 diff --git a/docs/使用教程/分部分/04-iCloud-隐私邮箱使用方法.md b/docs/使用教程/分部分/04-iCloud-隐私邮箱使用方法.md new file mode 100644 index 0000000..2d806ea --- /dev/null +++ b/docs/使用教程/分部分/04-iCloud-隐私邮箱使用方法.md @@ -0,0 +1,112 @@ +# 第四部分:iCloud 隐私邮箱使用方法 + +## 部分信息 + +- `section_slug`: `icloud-private-email` +- `适用主题`: `iCloud+`、`隐藏邮件地址`、Apple ID、转发邮箱、插件刷新 +- `维护方式`: `直接更新本文件` + +## 适用场景 + +- 需要把 `iCloud+` 的 `隐藏邮件地址` 用作隐私邮箱 +- 需要先在 Apple 设备上开通 `iCloud 邮件` +- 需要在插件中读取已经创建好的隐私邮箱 + +## 准备内容 + +- 一个已开通 `iCloud+` 的 Apple ID +- 一台可登录该 Apple ID 的 `iPhone`、`iPad` 或 `Mac` +- 一个真正用于接收转发邮件的邮箱 +- 插件中可正常使用的邮箱服务配置 + +## 操作步骤 + +### 第一步:准备 Apple ID + +如果条件允许,建议使用非日常主力 Apple ID。 +这样即使后续触发风控,也不会影响你平时常用的账号。 + +### 第二步:在 `iPhone` 或 `iPad` 上启用 `iCloud 邮件` + +1. 打开 `设置` +2. 点击顶部你的姓名 +3. 进入 `iCloud` +4. 找到 `邮件` +5. 打开右侧开关 + +如果是首次开通,按提示创建一个 `@icloud.com` 主邮箱地址。 + +### 第三步:在 `Mac` 上确认 `iCloud 邮件` 已开启 + +1. 打开苹果菜单 +2. 进入 `系统设置` +3. 点击你的姓名 +4. 进入 `iCloud` +5. 确认 `iCloud 邮件` 已启用 + +### 第四步:进入 `隐藏邮件地址` + +在 `iCloud` 页面往下找到 `iCloud+`,然后进入 `隐藏邮件地址`。 + +### 第五步:先手动创建一批隐私邮箱 + +建议先手动创建一批,例如 `20` 个左右。 +这样插件后续读取时更稳定,也更容易判断整个流程有没有打通。 + +同时确认 `转发至` 已经设置为你真正接收邮件的邮箱。 + +### 第六步:配置插件中的邮箱服务 + +在插件里把 `邮箱服务` 设置为你真正接收转发邮件的邮箱,并确认它能正常收信。 + +### 第七步:配置插件中的邮箱生成 + +1. 将 `邮件生成` 选择为 `iCloud 隐私邮箱` +2. 先在网页中登录你的 `iCloud` +3. 回到插件的隐私邮箱配置区域 +4. 点击刷新 +5. 等待插件读取你已经创建好的地址 + +### 第八步:选择邮箱使用方式 + +建议优先使用 `复用未使用的`。 +如果你希望释放数量,可以勾选 `使用后删除`。 +如果不删除,这些地址可以保留为长期邮箱。 + +### 第九步:控制创建频率 + +建议每天最多新增 `3` 个左右。 +测试中一天创建过多容易触发 `iCloud` 风控。 + +### 第十步:查看官方说明 + +- `Create a primary email address for iCloud Mail` +- `Create and edit Hide My Email addresses on iCloud.com` + +## 常见问题 + +### 插件刷新后没有看到任何邮箱怎么办? + +先确认: + +- 你已经在网页里登录了 `iCloud` +- 你已经手动创建过隐私邮箱 +- `转发至` 已经设置好 + +确认后,再回插件里刷新一次。 + +### 要不要勾选 `使用后删除`? + +如果你想及时释放可用数量,可以勾选。 +如果你想把地址当长期邮箱保留,可以不勾选。 + +### 为什么不建议大量新建? + +因为短时间创建过多容易触发 `iCloud` 风控,后面会影响正常使用。 + +## 注意事项 + +- 优先使用非日常主力 Apple ID +- 建议先手动创建一批地址,再让插件读取 +- 一天不要大量新建,建议控制在 `3` 个左右 +- 如果长期不删除,数量可能会较快达到上限 diff --git a/docs/使用教程/分部分/05-QQ-邮箱切换邮箱使用教程.md b/docs/使用教程/分部分/05-QQ-邮箱切换邮箱使用教程.md new file mode 100644 index 0000000..570c388 --- /dev/null +++ b/docs/使用教程/分部分/05-QQ-邮箱切换邮箱使用教程.md @@ -0,0 +1,58 @@ +# 第五部分:QQ 邮箱切换邮箱使用教程 + +## 部分信息 + +- `section_slug`: `qq-mail-switch` +- `适用主题`: `QQ 邮箱`、英文邮箱、`Foxmail`、删除后重建 +- `维护方式`: `直接更新本文件` + +## 适用场景 + +- 当前 `QQ 邮箱` 地址需要切换 +- 想继续复用同一个 `QQ 邮箱` 主账号 +- 需要创建和删除英文邮箱、`Foxmail` 邮箱 + +## 准备内容 + +- 一个可以正常登录的 `QQ 邮箱` +- 可以访问 `账号与安全` 页面 + +## 操作步骤 + +### 第一步:登录 `QQ 邮箱` + +先登录你当前正在使用的 `QQ 邮箱`。 + +### 第二步:进入 `账号与安全` + +打开: + +- `https://wx.mail.qq.com/account/index?sid=zdd4Voy7S04uZjBnAKhFZQAA#/` + +### 第三步:进入 `账号管理` + +在 `账号与安全` 页面中找到 `账号管理` 入口。 + +### 第四步:创建英文邮箱和 `Foxmail` 邮箱 + +在 `账号管理` 中: + +1. 创建一个英文邮箱地址 +2. 再创建一个 `Foxmail` 邮箱地址 + +### 第五步:使用后删除并重新创建 + +这两个地址使用完后,可以直接删除。 +删除后重新创建新的英文邮箱和 `Foxmail` 邮箱,就可以继续使用。 + +## 常见问题 + +### 这些地址删除后还能继续重复创建吗? + +可以。 +按原流程删除后,再创建新的英文邮箱和 `Foxmail` 邮箱即可继续使用。 + +## 注意事项 + +- 使用完成后尽量及时删除,避免混淆当前正在使用的地址 +- 建议每次切换后都确认插件里使用的是最新邮箱地址 diff --git a/docs/使用教程/分部分/06-PayPal-注册与绑卡使用教程.md b/docs/使用教程/分部分/06-PayPal-注册与绑卡使用教程.md new file mode 100644 index 0000000..88802d2 --- /dev/null +++ b/docs/使用教程/分部分/06-PayPal-注册与绑卡使用教程.md @@ -0,0 +1,114 @@ +# 第六部分:PayPal 注册与绑卡使用教程 + +## 部分信息 + +- `section_slug`: `paypal-registration-and-card-binding` +- `适用主题`: `PayPal`、个人账户注册、绑卡、钱包、身份认证、通知处理 +- `维护方式`: `直接更新本文件` + +## 适用场景 + +- 需要注册 `PayPal` 个人账户 +- 需要给 `PayPal` 绑卡 +- 绑卡后需要处理通知或身份认证 + +## 准备内容 + +- 一个可正常接收短信的手机号 +- 一张可在线支付的借记卡或信用卡 +- 能正常访问 `PayPal` + +## 操作步骤 + +### 第一步:打开注册页面 + +打开: + +- `https://www.paypal.com/signin` + +然后点击 `注册`。 + +### 第二步:选择账户类型 + +选择 `个人账户`。 + +### 第三步:选择国家或地区 + +如果你按中国大陆居民流程注册,直接在 `国家/地区` 中选择 `中国`。 + +### 第四步:输入手机号并继续 + +按页面提示输入手机号。 +如果出现短信验证,就先完成验证。 + +### 第五步:填写登录信息和个人信息 + +按页面提示填写: + +- 邮箱 +- 密码 +- 姓名 +- 出生日期 +- 地址 +- 联系方式 + +中国大陆居民注册时,姓名建议按身份证上的中文姓名填写,不要使用拼音。 + +### 第六步:完成邮箱确认 + +注册成功后,按页面或邮件提示确认邮箱地址。 +如果页面继续要求验证手机号,也一并完成。 + +### 第七步:进入 `钱包` 或主页开始绑卡 + +注册完成后,进入主页或 `钱包` 页面,找到 `关联卡或银行账户`。 + +### 第八步:选择关联借记卡或信用卡 + +点击 `关联借记卡或信用卡`,进入绑卡流程。 + +### 第九步:填写银行卡信息 + +按页面提示填写: + +- 卡号 +- 有效期 +- 安全代码 +- 账单地址 + +如果卡背面分成两段数字,安全代码通常取三位数那一段。 + +### 第十步:完成绑卡并检查结果 + +点击 `关联卡`。 +有时页面会提示报错,但卡实际上已经绑定成功,所以还要再回 `钱包` 页面确认一次。 + +### 第十一步:查看右上角通知并完成认证 + +如果页面右上角通知标红,或者提示账户需要认证,请按提示补交资料。 +常见情况是上传身份证件。 + +## 常见问题 + +### 绑卡时报错怎么办? + +先去 `钱包` 页面再确认一次。 +有时页面虽然提示失败,但实际已经绑定成功。 + +如果还没成功,再检查: + +- 账单地址是否正确 +- 卡片是否支持在线支付 +- 银行是否拦截了临时授权验证 + +### 右上角通知标红怎么办? + +先点开通知,看具体要求。 +如果要求 `Confirm your Identity` 或类似身份认证,就按提示补交资料。 + +## 注意事项 + +- 中国大陆居民注册时,姓名建议使用身份证上的中文姓名 +- 新绑卡时可能会触发最高 `1 USD` 或等值货币的临时授权验证 +- 更稳妥的做法是使用单独管理、余额较低的借记卡 +- 绑卡后记得同时检查 `钱包` 页面和右上角通知 diff --git a/docs/使用教程/分部分/07-0元试用-ChatGPT-Plus-教程.md b/docs/使用教程/分部分/07-0元试用-ChatGPT-Plus-教程.md new file mode 100644 index 0000000..bdfd010 --- /dev/null +++ b/docs/使用教程/分部分/07-0元试用-ChatGPT-Plus-教程.md @@ -0,0 +1,58 @@ +# 第七部分:ChatGPT Plus 订阅说明(待人工审核) + +## 部分信息 + +- `section_slug`: `chatgpt-plus-subscription-review-needed` +- `适用主题`: `ChatGPT Plus`、订阅说明、支付流程说明、人工审核 +- `维护方式`: `暂不交给前台教程 AI 自动维护` + +## 适用场景 + +- 需要整理 `ChatGPT Plus` 相关订阅说明 +- 需要区分“公开用户教程”和“内部测试脚本或特殊链路” + +## 当前状态说明 + +旧版总教程里,这一部分包含了脚本、支付参数、地区参数和非常规 checkout 链路。 +这类内容不适合继续作为普通用户教程正文自动扩写,也不适合继续直接喂给前台教程 AI。 + +## 后续处理建议 + +### 第一条:不要继续把这部分当作普通用户教程维护 + +后续如果只是要维护公开教程,请不要在这里继续追加脚本、参数构造或非常规支付链路。 + +### 第二条:如确需保留,转入内部资料目录 + +如果团队内部仍然需要保留原始测试材料,请单独移动到内部资料目录中管理,并加上人工审核说明。 + +### 第三条:如要面向普通用户写订阅说明,只能基于官方公开入口 + +后续如果要补一版“普通用户可读的 Plus 订阅说明”,建议只基于: + +- 官方公开入口 +- 官方帮助中心 +- 常规支付与账户说明 + +不要继续沿用旧版中的非常规流程描述。 + +## 常见问题 + +### 为什么这一部分没有继续按旧内容拆成可直接发布的教程? + +因为旧内容已经超出了普通用户教程的范围,不适合继续作为公开教程自动维护。 + +### 如果以后确实要补这部分,应该怎么做? + +先人工确认范围,再决定: + +- 是写“公开用户教程” +- 还是写“内部资料” + +这两类内容不能继续混写在同一个分部分文件里。 + +## 注意事项 + +- 本文件当前是“待人工审核”的占位说明 +- 不要把脚本、非常规支付链路或特殊参数继续并入公开教程 +- 如果未来重写本部分,请优先采用官方公开资料 diff --git a/docs/使用教程/分部分/08-Clash-Verge-非港轮询配置.md b/docs/使用教程/分部分/08-Clash-Verge-非港轮询配置.md new file mode 100644 index 0000000..0502b59 --- /dev/null +++ b/docs/使用教程/分部分/08-Clash-Verge-非港轮询配置.md @@ -0,0 +1,165 @@ +# 第八部分:Clash Verge 非港轮询配置 + +## 部分信息 + +- `section_slug`: `clash-verge-non-hk-rotation` +- `适用主题`: `Clash Verge`、`非港轮询`、扩展脚本、规则模式、系统代理 +- `维护方式`: `直接更新本文件` + +## 适用场景 + +- 需要在 [Clash Verge](https://github.com/clash-verge-rev/clash-verge-rev) 中启用 `🔁 非港轮询` +- 需要给现有订阅注入负载均衡分组 +- 需要确保 `规则模式` 和 `系统代理` 生效 + +## 准备内容 + +- 已安装 [Clash Verge](https://github.com/clash-verge-rev/clash-verge-rev) +- 已导入可用订阅 +- 可以打开 `订阅` 和 `代理` 页面 + +## 操作步骤 + +### 第一步:进入 `订阅` 并打开全局扩展脚本 + +1. 打开 `Clash Verge` +2. 进入左侧 `订阅`(`Profiles`) +3. 找到并打开 `全局扩展脚本` + +### 第二步:替换脚本内容 + +先清空旧内容,再粘贴下面脚本,然后保存。 + +```javascript +function uniqPrepend(arr, items) { + if (!Array.isArray(arr)) arr = []; + for (var i = items.length - 1; i >= 0; i--) { + var item = items[i]; + var exists = false; + for (var j = 0; j < arr.length; j++) { + if (arr[j] === item) { + exists = true; + break; + } + } + if (!exists) arr.unshift(item); + } + return arr; +} + +function upsertGroup(groups, group) { + for (var i = 0; i < groups.length; i++) { + if (groups[i] && groups[i].name === group.name) { + groups[i] = group; + return groups; + } + } + groups.unshift(group); + return groups; +} + +function main(config, profileName) { + if (!config) return config; + + if (!Array.isArray(config["proxy-groups"])) { + config["proxy-groups"] = []; + } + + var groups = config["proxy-groups"]; + var LB_NAME = "🔁 非港轮询"; + + var excludeRegex = + "(?i)(" + + "香港|hong[ -]?kong|\\bhk\\b|\\bhkg\\b|🇭🇰" + + "|剩余流量|套餐到期|下次重置剩余|重置剩余|到期时间|流量重置" + + "|traffic|expire|expiration|subscription|subscribe|reset|plan" + + ")"; + + groups = upsertGroup(groups, { + name: LB_NAME, + type: "load-balance", + strategy: "round-robin", + "include-all-proxies": true, + "exclude-filter": excludeRegex, + url: "https://www.gstatic.com/generate_204", + interval: 300, + lazy: true, + "expected-status": 204 + }); + + var injected = false; + var entryNameRegex = /节点选择|代理|Proxy|PROXY|默认|GLOBAL|全局|选择/i; + + for (var i = 0; i < groups.length; i++) { + var g = groups[i]; + if (!g || g.type !== "select") continue; + + if (entryNameRegex.test(g.name || "")) { + if (!Array.isArray(g.proxies)) g.proxies = []; + g.proxies = uniqPrepend(g.proxies, [LB_NAME]); + injected = true; + } + } + + if (!injected) { + for (var k = 0; k < groups.length; k++) { + var g2 = groups[k]; + if (g2 && g2.type === "select") { + if (!Array.isArray(g2.proxies)) g2.proxies = []; + g2.proxies = uniqPrepend(g2.proxies, [LB_NAME]); + break; + } + } + } + + config["proxy-groups"] = groups; + return config; +} +``` + +### 第三步:保存脚本 + +使用右上角保存按钮,或者按 `Ctrl+S` 保存。 + +### 第四步:切换到 `代理` + +回到左侧 `代理`(`Proxies`)页面,也就是首页。 + +### 第五步:选择 `🔁 非港轮询` + +在顶部常见的分组里,例如: + +- `节点选择` +- `Proxy` +- `当前节点` + +找到对应下拉框,然后选择 `🔁 非港轮询`。 + +### 第六步:确认运行模式 + +继续确认以下两项: + +1. `代理模式` 已设置为 `规则模式`(`Rule`) +2. `系统代理`(`System Proxy`)已经开启 + +## 常见问题 + +### 为什么没有看到 `🔁 非港轮询`? + +先确认: + +- 脚本已经完整粘贴并保存 +- 当前订阅本身可用 +- 当前模式是 `规则模式` +- `系统代理` 已开启 + +### 粘贴脚本后报格式错误怎么办? + +先确认是否把旧内容完全清空,再重新完整粘贴。 +如果仍然报错,可以让 AI 只帮你修复脚本格式,不要同时改动脚本逻辑。 + +## 注意事项 + +- 粘贴新脚本前,先把旧脚本清空 +- 必须完整保存后再去 `代理` 页面检查 +- 如果更新了脚本逻辑,优先检查 `🔁 非港轮询` 是否仍被正确注入到选择分组中 diff --git a/docs/使用教程书写模板.md b/docs/使用教程书写模板.md deleted file mode 100644 index 080a52f..0000000 --- a/docs/使用教程书写模板.md +++ /dev/null @@ -1,312 +0,0 @@ -# 使用教程书写模板 - -本文件用于约束 AI 生成“账号贡献站 / Codex 注册扩展”使用教程时的 Markdown 格式。 - -使用方式: - -- 先把这份文件发给 AI -- 再告诉 AI 本次要写哪一部分教程 -- 让 AI 严格按本文格式输出 -- 输出结果直接复制到管理端“使用教程”编辑区 - ---- - -## 1. 教程用途 - -使用教程用于说明: - -- 页面怎么用 -- 上传文件怎么准备 -- 上传步骤是什么 -- 常见错误怎么理解 -- 注意事项有哪些 - -教程不是公告,所以要: - -- 结构完整 -- 步骤清楚 -- 能让第一次接触的人看懂 - ---- - -## 2. 教程总体要求 - -AI 生成教程时必须满足: - -1. 使用标准 Markdown -2. 不使用 HTML -3. 章节分明 -4. 按用户实际操作顺序来写 -5. 重点步骤必须编号 -6. 文件名、路径、接口、按钮名要用反引号包裹 -7. 语言要清楚,不要写废话 - ---- - -## 3. 标准结构 - -教程建议按这个结构输出: - -```md -# 教程标题 - -一句话说明这份教程是教什么的。 - -## 适用场景 - -- 场景 1 -- 场景 2 - -## 准备内容 - -- 需要准备的内容 1 -- 需要准备的内容 2 - -## 操作步骤 - -### 第一步:... - -说明。 - -### 第二步:... - -说明。 - -### 第三步:... - -说明。 - -## 常见问题 - -### 问题 1 - -说明。 - -### 问题 2 - -说明。 - -## 注意事项 - -- 注意项 1 -- 注意项 2 -``` - ---- - -## 4. 标题规范 - -标题必须直接说清主题。 - -推荐示例: - -- `# 账号贡献页使用教程` -- `# 如何准备可上传的 JSON 文件` -- `# 账号贡献上传操作说明` - -不推荐: - -- `# 使用方法` -- `# 教你怎么弄` -- `# 说明一下` - ---- - -## 5. 正文写法规范 - -### 5.1 先讲适用场景 - -教程开头要先告诉用户: - -- 这份教程适合谁 -- 能解决什么问题 - -示例: - -```md -本教程适用于首次使用账号贡献页的用户,帮助你完成文件准备、上传和结果查看。 -``` - -### 5.2 步骤必须按顺序写 - -不要跳步,不要先写报错再写操作。 - -推荐: - -```md -## 操作步骤 - -### 第一步:准备 JSON 文件 - -... - -### 第二步:打开贡献页面 - -... - -### 第三步:填写昵称并上传 - -... -``` - -### 5.3 命令、按钮、文件名要加反引号 - -例如: - -- `验证并上传` -- `codex-*.json` -- `sub2api-account-*.json` -- `POST /api/upload` - ---- - -## 6. 常见问题写法 - -常见问题建议用二级或三级标题展开: - -```md -## 常见问题 - -### 为什么按钮没有出现? - -如果后台没有开启教程显示,前台不会显示“使用教程”按钮。 - -### 为什么文件上传失败? - -请先检查文件命名、文件大小和内容格式是否符合要求。 -``` - ---- - -## 7. 禁止项 - -AI 生成教程时禁止: - -- 使用 HTML -- 写内部开发实现细节 -- 写成公告语气 -- 写成 PR 说明 -- 大段堆文字不分章节 -- 用“应该”“可能”“大概”这种模糊表达描述核心步骤 - -不要写: - -- “这里我做了一个功能” -- “你应该差不多知道怎么操作” -- “这个问题暂时先这样” - ---- - -## 8. 推荐语气 - -推荐风格: - -- 清楚 -- 分步骤 -- 面向第一次使用的人 -- 说明明确,不省略关键动作 - -推荐表达: - -- “先准备” -- “然后打开” -- “接着点击” -- “如果出现以下情况” -- “请确认” - ---- - -## 9. AI 生成教程时的固定指令 - -把下面这段直接发给 AI: - -```md -请帮我写一份“账号贡献站 / Codex 注册扩展”的使用教程,严格遵守以下要求: - -1. 输出必须是 Markdown -2. 不要使用 HTML -3. 面向第一次使用的人来写 -4. 结构必须清楚,章节明确 -5. 操作步骤必须按顺序写 -6. 文件名、接口、按钮名称、路径要用反引号包裹 -7. 不要写内部开发过程 -8. 重要部分要短句、短段落,不要写成大段废话 - -请按以下结构输出: - -# 标题 - -一句话说明 - -## 适用场景 - -- ... - -## 准备内容 - -- ... - -## 操作步骤 - -### 第一步:... - -... - -### 第二步:... - -... - -## 常见问题 - -### ... - -... - -## 注意事项 - -- ... -``` - ---- - -## 10. 可直接替换变量模板 - -你每次可以这样发给 AI: - -```md -请按“账号贡献站使用教程模板”帮我写一份 Markdown 教程。 - -本次教程主题: -[这里写主题] - -目标读者: -[例如:第一次使用贡献页的用户] - -希望教程覆盖的内容: -- [内容 1] -- [内容 2] -- [内容 3] - -必须出现的步骤: -1. [步骤 1] -2. [步骤 2] -3. [步骤 3] - -希望补充的常见问题: -- [问题 1] -- [问题 2] -``` - ---- - -## 11. 结果验收标准 - -生成后的教程 Markdown 必须满足: - -- 复制到管理端后能直接显示 -- 标题和章节清楚 -- 教程导航能识别出标题结构 -- 步骤顺序合理 -- 没有 HTML -- 没有明显 AI 套话 -- 普通用户能直接照着做 diff --git a/项目文件结构说明.md b/项目文件结构说明.md index 1f3bed2..6903257 100644 --- a/项目文件结构说明.md +++ b/项目文件结构说明.md @@ -108,7 +108,10 @@ - `docs/仓库协作者AI分析PR与合并标准流程.md`:仓库协作者进行 AI 分析 PR 与合并时的流程说明。 - `docs/ip-proxy-module.md`:IP Proxy 模块说明,记录模块定位、后台/侧栏代码结构、当前功能范围、711Proxy 参数联动、操作方式、发布策略与已知限制。 -- `docs/使用教程.md`:面向使用者的补充教程文档,当前说明扩展更新流程与 Clash Verge 的“非港轮询”配置步骤。 +- `docs/使用教程.md`:旧版完整使用教程,保留尚未完全拆分的 HeroSMS、IP 代理、GoPay 等补充章节。 +- `docs/使用教程/使用教程.md`:分部分使用教程总索引。 +- `docs/使用教程/使用教程书写模板.md`:后续维护分部分教程时使用的书写与拆分模板。 +- `docs/使用教程/分部分/*.md`:按主题拆分后的使用教程正文。 - `docs/images/交流群.jpg`:README 中展示的官网 / QQ 交流群入口图片。 - `docs/refactor/2026-04-16-architecture-refactor-plan.md`:本轮重构阶段的结构设计与迁移计划记录。 - `docs/superpowers/plans/2026-04-10-hotmail-oauth-mail-pool.md`:Hotmail OAuth 邮箱池实现计划文档。