feat: 更新 Cloudflare Temp Email 使用说明，优化相关链接和配置步骤

docs/使用教程.md

@@ -1,11 +1,10 @@
-# Codex 注册扩展相关项目、更新、QQ 邮箱切换与 Clash Verge 配置教程
-
 本教程用于说明相关项目地址、扩展更新方式、`QQ 邮箱`切换邮箱的使用方法，以及 `Clash Verge` 的 `🔁 非港轮询` 配置方法。
 
 ## 适用场景
 
 - 需要拉取并部署 `cpa` 或 `sub2api` 项目
 - 已经安装本扩展，想更新到最新版本
+- 需要把 `Cloudflare Temp Email` 用作 `邮箱生成` 或 `邮箱服务`
 - 需要临时切换 `QQ 邮箱` 地址继续使用
 - 需要在 `Clash Verge` 中启用 `🔁 非港轮询`
 
@@ -14,6 +13,7 @@
 - 可以访问 `GitHub`
 - 已安装好的扩展文件夹
 - 可以打开浏览器的 `扩展程序管理` 页面
+- 已准备好 `Cloudflare Temp Email` 后端地址；如需随机子域，域名解析也已配置完成
 - 一个可正常登录的 `QQ 邮箱`
 - 如需部署 `cpa`，部署环境必须可以访问 `OpenAI`
 - 已安装 `Clash Verge`，并已导入可用订阅
@@ -60,7 +60,42 @@
    找到该扩展后，手动点击一次 `重新加载`。  
    这一步一定要做，否则浏览器可能仍在使用旧版本。
 
-### 第三部分：`QQ 邮箱`切换邮箱使用教程
+### 第三部分：`Cloudflare Temp Email` 使用说明
+
+1. 先确认当前用途  
+   `Cloudflare Temp Email` 可以作为 `邮箱生成`，也可以作为 `邮箱服务`。  
+   如果两边都选择了它，就需要把两套配置都填完整。
+
+2. 填写 `Temp API`  
+   这里填写 `Cloudflare Temp Email` 后端地址，例如 `https://your-worker-domain`。  
+   不论你是拿它来生成邮箱，还是接收转发邮件，这一项都需要先配好。
+
+3. 作为 `邮箱生成` 使用时填写 `Admin Auth`  
+   `Admin Auth` 对应后端的 `admin auth`。  
+   只有在 `邮箱生成 = Cloudflare Temp Email` 时，这一项才是必填。
+
+4. 按需填写 `Custom Auth`  
+   `Custom Auth` 只在站点额外开启访问密码时才需要填写。  
+   如果没有开启额外访问密码，留空即可。  
+   这一项不会替代 `Admin Auth`。
+
+5. 配置 `Temp 域名`  
+   这里填写允许创建邮箱的基础域名。  
+   即使开启了 `随机子域`，这里仍然填写基础域名，而不是随机出来的子域名。
+
+6. 按需开启 `随机子域`  
+   `随机子域` 只在 `邮箱生成 = Cloudflare Temp Email` 时使用。  
+   后端需要提前配置 `RANDOM_SUBDOMAIN_DOMAINS`，Cloudflare DNS 也需要设置 `MX *`。  
+   相关说明可参考 [Issue #942](https://github.com/dreamhunter2333/cloudflare_temp_email/issues/942)。
+
+7. 作为 `邮箱服务` 使用时填写 `邮件接收`  
+   只有在 `邮箱服务 = Cloudflare Temp Email` 时，这一项才需要填写。  
+   这里填写真正用于接收转发邮件的目标邮箱。
+
+8. 查看搭建参考  
+   如果你还没有部署后端，可参考 [LINUX DO 教程](https://linux.do/t/topic/316819)。
+
+### 第四部分：`QQ 邮箱`切换邮箱使用教程
 
 1. 登录 `QQ 邮箱`  
    先登录你当前正在使用的 `QQ 邮箱` 账号。
@@ -79,13 +114,15 @@
    这两个邮箱地址使用完成后，可以直接删除。  
    删除后再次创建新的英文邮箱和 `Foxmail` 邮箱，即可重复注册使用。
 
-### 第四部分：配置 `Clash Verge` 的 `🔁 非港轮询`
+### 第五部分：配置 `Clash Verge` 的 `🔁 非港轮询`
 
 #### 第一步：添加扩展脚本
 
 1. 打开 `Clash Verge`，进入左侧的 `订阅`（`Profiles`）界面。
-2. 在右上角或对应位置找到并双击打开 `全局扩展脚本`（`Merge/Script`）。
+2. 在右上角或对应位置找到并双击打开 `全局扩展脚本`。
+![05d15cd026ec21d0cffde04ad0d1a6c9](https://apikey.qzz.io/content-assets/library/2026/04/20260424-163252--05d15cd026ec21d0cffde04ad0d1a6c9--0a59ba73acff.png)
 3. 将里面的内容全部清空，替换为下方脚本代码。
+![2026 04 25 003728](https://apikey.qzz.io/content-assets/library/2026/04/20260424-163745--2026-04-25-003728--59bf89f34367.png)
 4. 点击保存，使用右上角保存按钮或按 `Ctrl+S`。
 
 💻 脚本代码（如果遇到格式错误，可让豆包帮你修复后再粘贴）
@@ -184,7 +221,7 @@ function main(config, profileName) {
 3. 在对应下拉框中选择 `🔁 非港轮询`。
 4. 确认右上角的 `代理模式`（`Mode`）已经设置为 `规则模式`（`Rule`）。
 5. 确认左侧 `设置` 中的 `系统代理`（`System Proxy`）已经开启。
-
+![2026 04 25 003703](https://apikey.qzz.io/content-assets/library/2026/04/20260424-163745--2026-04-25-003703--21e892504b82.png)
 ## 常见问题
 
 ### 为什么第十步显示认证成功，但没有认证文件？
@@ -206,6 +243,8 @@ function main(config, profileName) {
 ## 注意事项
 
 - 不论使用哪种方式更新扩展，更新完成后都必须在浏览器的 `扩展程序管理` 页面重新加载一次该扩展。
+- 如果同时把 `Cloudflare Temp Email` 用作 `邮箱生成` 和 `邮箱服务`，请同时检查 `Admin Auth`、`Custom Auth`、`Temp 域名` 和 `邮件接收` 是否都已配置。
+- 开启 `随机子域` 前，请先确认后端已经配置 `RANDOM_SUBDOMAIN_DOMAINS`，并且 Cloudflare DNS 已完成 `MX *` 设置。
 - 如需部署 `cpa`，请先确认部署环境可以访问 `OpenAI`，否则可能出现第十步认证成功但没有认证文件的问题。
 - `QQ 邮箱`切换邮箱时，建议在使用完成后及时删除，再重新创建，避免混淆当前正在使用的邮箱地址。
 - 使用 `git pull` 更新扩展是最方便、最推荐的方式。

sidepanel/sidepanel.js

@@ -629,8 +629,6 @@ const LOG_LEVEL_LABELS = {
 };
 
 const CLOUDFLARE_TEMP_EMAIL_REPOSITORY_URL = 'https://github.com/dreamhunter2333/cloudflare_temp_email';
-const CLOUDFLARE_TEMP_EMAIL_BUILD_TUTORIAL_URL = 'https://linux.do/t/topic/316819';
-const CLOUDFLARE_TEMP_EMAIL_RANDOM_SUBDOMAIN_ISSUE_URL = 'https://github.com/dreamhunter2333/cloudflare_temp_email/issues/942';
 
 function usesGeneratedAliasMailProvider(
   provider,
@@ -2257,45 +2255,12 @@ function openReleaseListPage() {
   openExternalUrl(getReleaseListUrl());
 }
 
-function buildCloudflareTempEmailUsageGuideModalConfig() {
-  const useCloudflareTempEmailProvider = String(selectMailProvider?.value || '').trim().toLowerCase() === 'cloudflare-temp-email';
-  const useCloudflareTempEmailGenerator = getSelectedEmailGenerator() === 'cloudflare-temp-email';
-  let alertText = '当前还没有把 Cloudflare Temp Email 选为邮箱服务或邮箱生成器。下面说明同时覆盖“生成邮箱”和“接收转发邮件”两种用法。';
-  if (useCloudflareTempEmailProvider && useCloudflareTempEmailGenerator) {
-    alertText = '当前同时把 Cloudflare Temp Email 用作“邮箱服务”和“邮箱生成器”。请同时配置生成邮箱和接收转发两套必填项。';
-  } else if (useCloudflareTempEmailProvider) {
-    alertText = '当前把 Cloudflare Temp Email 用作“邮箱服务”。重点填写 Temp API、Custom Auth 和 邮件接收。';
-  } else if (useCloudflareTempEmailGenerator) {
-    alertText = '当前把 Cloudflare Temp Email 用作“邮箱生成器”。重点填写 Temp API、Admin Auth 和 Temp 域名；随机子域按需开启。';
+function openCloudflareTempEmailUsageGuidePage() {
+  const targetUrl = getContributionPortalUrl();
+  if (!targetUrl) {
+    return;
   }
-
-  return {
-    title: 'Cloudflare Temp Email 使用教程',
-    alert: { text: alertText },
-    messageHtml: `Temp API：填写 Cloudflare Temp Email 后端地址。<br><br>
-Admin Auth：填写后端 admin auth。<br>
-仅在“邮箱生成 = Cloudflare Temp Email”时必填。<br><br>
-Custom Auth：仅当站点额外开启访问密码时填写。没有开启就留空。<br><br>
-Temp 域名：填写允许创建的基础域名。启用随机子域时，这里仍然填写基础域名。<br><br>
-随机子域：仅在“邮箱生成 = Cloudflare Temp Email”时使用。<br>
-后端需要已配置 RANDOM_SUBDOMAIN_DOMAINS。<br>
-CF DNS 需要设置 MX *，参考 <a href="${CLOUDFLARE_TEMP_EMAIL_RANDOM_SUBDOMAIN_ISSUE_URL}" target="_blank" rel="noopener noreferrer">Issue #942</a>。<br><br>
-邮件接收：仅在“邮箱服务 = Cloudflare Temp Email”时填写。<br>
-这里填写真正接收转发邮件的目标邮箱。<br><br>
-搭建教程：<a href="${CLOUDFLARE_TEMP_EMAIL_BUILD_TUTORIAL_URL}" target="_blank" rel="noopener noreferrer">LINUX DO 教程</a>。`,
-  };
-}
-
-function showCloudflareTempEmailUsageGuide() {
-  const modalConfig = buildCloudflareTempEmailUsageGuideModalConfig();
-  return openActionModal({
-    title: modalConfig.title,
-    messageHtml: modalConfig.messageHtml,
-    alert: modalConfig.alert,
-    actions: [
-      { id: 'ok', label: '知道了', variant: 'btn-primary' },
-    ],
-  });
+  openExternalUrl(targetUrl);
 }
 
 function openCloudflareTempEmailRepositoryPage() {
@@ -4243,7 +4208,7 @@ btnRepoHome?.addEventListener('click', () => {
 });
 
 btnCloudflareTempEmailUsageGuide?.addEventListener('click', () => {
-  showCloudflareTempEmailUsageGuide();
+  openCloudflareTempEmailUsageGuidePage();
 });
 
 btnCloudflareTempEmailGithub?.addEventListener('click', () => {

tests/sidepanel-cloudflare-temp-email-random-subdomain.test.js

@@ -70,68 +70,40 @@ test('sidepanel modal message preserves line breaks and supports inline links',
   assert.match(css, /\.modal-message a,\s*[\s\S]*\.modal-alert a/);
 });
 
-test('buildCloudflareTempEmailUsageGuideModalConfig returns a modal payload with inline links for generator mode', () => {
-  const bundle = extractFunction('buildCloudflareTempEmailUsageGuideModalConfig');
+test('openCloudflareTempEmailUsageGuidePage opens the contribution portal home page', () => {
+  const bundle = extractFunction('openCloudflareTempEmailUsageGuidePage');
 
   const api = new Function(`
-const selectMailProvider = { value: '163' };
-const selectEmailGenerator = { value: 'cloudflare-temp-email' };
-const CLOUDFLARE_TEMP_EMAIL_BUILD_TUTORIAL_URL = 'https://linux.do/t/topic/316819';
-const CLOUDFLARE_TEMP_EMAIL_RANDOM_SUBDOMAIN_ISSUE_URL = 'https://github.com/dreamhunter2333/cloudflare_temp_email/issues/942';
-function getSelectedEmailGenerator() { return String(selectEmailGenerator.value || '').trim().toLowerCase(); }
+const openedUrls = [];
+function getContributionPortalUrl() { return 'https://apikey.qzz.io'; }
+function openExternalUrl(url) { openedUrls.push(url); }
 ${bundle}
 return {
-  buildCloudflareTempEmailUsageGuideModalConfig,
+  openedUrls,
+  openCloudflareTempEmailUsageGuidePage,
 };
   `)();
 
-  const modalConfig = api.buildCloudflareTempEmailUsageGuideModalConfig();
-  assert.equal(typeof modalConfig.title, 'string');
-  assert.equal(typeof modalConfig.messageHtml, 'string');
-  assert.equal(typeof modalConfig.alert?.text, 'string');
-  assert.equal(modalConfig.title.length > 0, true);
-  assert.equal(modalConfig.messageHtml.length > 0, true);
-  assert.equal(modalConfig.alert.text.length > 0, true);
-  assert.equal(modalConfig.messageHtml.includes('<a '), true);
-  assert.equal(modalConfig.messageHtml.includes('Issue #942'), true);
-  assert.equal(modalConfig.messageHtml.includes('LINUX DO 教程'), true);
+  api.openCloudflareTempEmailUsageGuidePage();
+  assert.deepEqual(api.openedUrls, ['https://apikey.qzz.io']);
 });
 
-test('buildCloudflareTempEmailUsageGuideModalConfig returns a distinct alert for provider mode', () => {
-  const bundle = extractFunction('buildCloudflareTempEmailUsageGuideModalConfig');
+test('openCloudflareTempEmailUsageGuidePage skips opening when the contribution portal URL is empty', () => {
+  const bundle = extractFunction('openCloudflareTempEmailUsageGuidePage');
 
   const api = new Function(`
-const selectMailProvider = { value: 'cloudflare-temp-email' };
-const selectEmailGenerator = { value: 'duck' };
-const CLOUDFLARE_TEMP_EMAIL_BUILD_TUTORIAL_URL = 'https://linux.do/t/topic/316819';
-const CLOUDFLARE_TEMP_EMAIL_RANDOM_SUBDOMAIN_ISSUE_URL = 'https://github.com/dreamhunter2333/cloudflare_temp_email/issues/942';
-function getSelectedEmailGenerator() { return String(selectEmailGenerator.value || '').trim().toLowerCase(); }
+const openedUrls = [];
+function getContributionPortalUrl() { return ''; }
+function openExternalUrl(url) { openedUrls.push(url); }
 ${bundle}
 return {
-  buildCloudflareTempEmailUsageGuideModalConfig,
+  openedUrls,
+  openCloudflareTempEmailUsageGuidePage,
 };
   `)();
 
-  const providerConfig = api.buildCloudflareTempEmailUsageGuideModalConfig();
-
-  const generatorApi = new Function(`
-const selectMailProvider = { value: '163' };
-const selectEmailGenerator = { value: 'cloudflare-temp-email' };
-const CLOUDFLARE_TEMP_EMAIL_BUILD_TUTORIAL_URL = 'https://linux.do/t/topic/316819';
-const CLOUDFLARE_TEMP_EMAIL_RANDOM_SUBDOMAIN_ISSUE_URL = 'https://github.com/dreamhunter2333/cloudflare_temp_email/issues/942';
-function getSelectedEmailGenerator() { return String(selectEmailGenerator.value || '').trim().toLowerCase(); }
-${bundle}
-return {
-  buildCloudflareTempEmailUsageGuideModalConfig,
-};
-  `)();
-
-  const generatorConfig = generatorApi.buildCloudflareTempEmailUsageGuideModalConfig();
-  assert.equal(typeof providerConfig.alert?.text, 'string');
-  assert.equal(typeof providerConfig.messageHtml, 'string');
-  assert.equal(providerConfig.alert.text.length > 0, true);
-  assert.equal(providerConfig.messageHtml.length > 0, true);
-  assert.notEqual(providerConfig.alert.text, generatorConfig.alert.text);
+  api.openCloudflareTempEmailUsageGuidePage();
+  assert.deepEqual(api.openedUrls, []);
 });
 
 test('openCloudflareTempEmailRepositoryPage opens the upstream repository', () => {