diff --git a/docs/使用教程.md b/docs/使用教程.md
index d23a634..d419c53 100644
--- a/docs/使用教程.md
+++ b/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. 在右上角或对应位置找到并双击打开 `全局扩展脚本`。
+
3. 将里面的内容全部清空，替换为下方脚本代码。
+
4. 点击保存，使用右上角保存按钮或按 `Ctrl+S`。
💻 脚本代码（如果遇到格式错误，可让豆包帮你修复后再粘贴）
@@ -184,7 +221,7 @@ function main(config, profileName) {
3. 在对应下拉框中选择 `🔁 非港轮询`。
4. 确认右上角的 `代理模式`（`Mode`）已经设置为 `规则模式`（`Rule`）。
5. 确认左侧 `设置` 中的 `系统代理`（`System Proxy`）已经开启。
-
+
## 常见问题
### 为什么第十步显示认证成功，但没有认证文件？
@@ -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` 更新扩展是最方便、最推荐的方式。
diff --git a/sidepanel/sidepanel.js b/sidepanel/sidepanel.js
index 4f47854..c7f7b63 100644
--- a/sidepanel/sidepanel.js
+++ b/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 后端地址。
-Admin Auth：填写后端 admin auth。
-仅在“邮箱生成 = Cloudflare Temp Email”时必填。
-Custom Auth：仅当站点额外开启访问密码时填写。没有开启就留空。
-Temp 域名：填写允许创建的基础域名。启用随机子域时，这里仍然填写基础域名。
-随机子域：仅在“邮箱生成 = Cloudflare Temp Email”时使用。
-后端需要已配置 RANDOM_SUBDOMAIN_DOMAINS。
-CF DNS 需要设置 MX *，参考 Issue #942。
-邮件接收：仅在“邮箱服务 = Cloudflare Temp Email”时填写。
-这里填写真正接收转发邮件的目标邮箱。
-搭建教程：LINUX DO 教程。`,
- };
-}
-
-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', () => {
diff --git a/tests/sidepanel-cloudflare-temp-email-random-subdomain.test.js b/tests/sidepanel-cloudflare-temp-email-random-subdomain.test.js
index e969761..afa859f 100644
--- a/tests/sidepanel-cloudflare-temp-email-random-subdomain.test.js
+++ b/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(' {
- 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', () => {