Hermes/FlowPilot
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat: 新增 YYDS Mail 邮箱服务端点

Browse Source
This commit is contained in:
Q3CC
2026-05-16 21:58:14 +08:00
parent cfd2ac14e5
commit b2c8280476
14 changed files with 1211 additions and 3 deletions
Download Patch File Download Diff File Expand all files Collapse all files
background.js
+120
View File
@@ -58,6 +58,8 @@ importScripts(
'cloudflare-temp-email-utils.js',
'cloudmail-utils.js',
'background/cloudmail-provider.js',
'yyds-mail-utils.js',
'background/yyds-mail-provider.js',
'icloud-utils.js',
'mail-provider-utils.js',
'content/activation-utils.js'
@@ -261,6 +263,19 @@ const {
normalizeCloudMailDomains,
normalizeCloudMailMailApiMessages,
} = self.CloudMailUtils;
const {
DEFAULT_YYDS_MAIL_BASE_URL,
YYDS_MAIL_PROVIDER,
buildYydsMailHeaders,
joinYydsMailUrl,
normalizeYydsMailAddress,
normalizeYydsMailApiKey,
normalizeYydsMailBaseUrl,
normalizeYydsMailCurrentInbox,
normalizeYydsMailInbox,
normalizeYydsMailMessageDetail,
normalizeYydsMailMessages,
} = self.YydsMailUtils;
const {
findIcloudAliasByEmail,
getConfiguredIcloudHostPreference,
@@ -405,6 +420,7 @@ const CLOUDFLARE_TEMP_EMAIL_PROVIDER = 'cloudflare-temp-email';
const CLOUDFLARE_TEMP_EMAIL_GENERATOR = 'cloudflare-temp-email';
const CLOUD_MAIL_PROVIDER = 'cloudmail';
const CLOUD_MAIL_GENERATOR = 'cloudmail';
const YYDS_MAIL_GENERATOR = YYDS_MAIL_PROVIDER;
const CUSTOM_EMAIL_POOL_GENERATOR = 'custom-pool';
const HOTMAIL_MAILBOXES = ['INBOX', 'Junk'];
const STOP_ERROR_MESSAGE = '流程已被用户停止。';
@@ -1003,6 +1019,8 @@ const PERSISTED_SETTING_DEFAULTS = {
cloudMailReceiveMailbox: '',
cloudMailDomain: '',
cloudMailDomains: [],
yydsMailApiKey: '',
yydsMailBaseUrl: DEFAULT_YYDS_MAIL_BASE_URL,
hotmailAccounts: [],
mail2925Accounts: [],
paypalAccounts: [],
@@ -1139,6 +1157,7 @@ const DEFAULT_STATE = {
luckmailPreserveTagName: DEFAULT_LUCKMAIL_PRESERVE_TAG_NAME,
currentLuckmailPurchase: null,
currentLuckmailMailCursor: null,
currentYydsMailInbox: null,
currentPhoneActivation: null,
phoneNumber: '',
currentPhoneVerificationCode: '',
@@ -2114,6 +2133,9 @@ function normalizeEmailGenerator(value = '') {
const gmailAliasGenerator = typeof GMAIL_ALIAS_GENERATOR === 'string'
? GMAIL_ALIAS_GENERATOR
: 'gmail-alias';
const yydsMailGenerator = typeof YYDS_MAIL_GENERATOR === 'string'
? YYDS_MAIL_GENERATOR
: 'yyds-mail';
if (normalized === 'custom' || normalized === 'manual') {
return 'custom';
}
@@ -2129,6 +2151,7 @@ function normalizeEmailGenerator(value = '') {
if (normalized === 'cloudflare') return 'cloudflare';
if (normalized === CLOUDFLARE_TEMP_EMAIL_GENERATOR) return CLOUDFLARE_TEMP_EMAIL_GENERATOR;
if (normalized === 'cloudmail') return 'cloudmail';
if (normalized === yydsMailGenerator) return yydsMailGenerator;
return 'duck';
}
@@ -2303,6 +2326,15 @@ async function markCurrentRegistrationAccountUsed(state = {}, options = {}) {
}
}
if (typeof isYydsMailProvider === 'function' && isYydsMailProvider(latestState)) {
const currentInbox = normalizeYydsMailCurrentInbox(latestState.currentYydsMailInbox);
if (currentInbox?.address) {
await clearYydsMailRuntimeState({ clearEmail: true });
await addLog(`${reasonPrefix}：YYDS Mail 邮箱 ${currentInbox.address} 运行态已清空。`, options.level || 'warn');
updated = true;
}
}
if (String(latestState.mailProvider || '').trim().toLowerCase() === '2925' && latestState.currentMail2925AccountId) {
await patchMail2925Account(latestState.currentMail2925AccountId, {
lastUsedAt: Date.now(),
@@ -2355,6 +2387,9 @@ function normalizePanelMode(value = '') {
function normalizeMailProvider(value = '') {
const normalized = String(value || '').trim().toLowerCase();
const yydsMailProvider = typeof YYDS_MAIL_PROVIDER === 'string'
? YYDS_MAIL_PROVIDER
: 'yyds-mail';
switch (normalized) {
case 'custom':
case ICLOUD_PROVIDER:
@@ -2363,6 +2398,7 @@ function normalizeMailProvider(value = '') {
case LUCKMAIL_PROVIDER:
case CLOUDFLARE_TEMP_EMAIL_PROVIDER:
case CLOUD_MAIL_PROVIDER:
case yydsMailProvider:
case '163':
case '163-vip':
case '126':
@@ -2600,6 +2636,32 @@ const {
pollCloudMailVerificationCode,
resolveCloudMailPollTargetEmail,
} = cloudMailProvider;
const yydsMailProvider = self.MultiPageBackgroundYydsMailProvider.createYydsMailProvider({
addLog,
buildYydsMailHeaders,
DEFAULT_YYDS_MAIL_BASE_URL,
getState,
joinYydsMailUrl,
normalizeYydsMailAddress,
normalizeYydsMailApiKey,
normalizeYydsMailBaseUrl,
normalizeYydsMailCurrentInbox,
normalizeYydsMailInbox,
normalizeYydsMailMessageDetail,
normalizeYydsMailMessages,
persistRegistrationEmailState,
pickVerificationMessageWithTimeFallback,
setEmailState,
setState,
sleepWithStop,
throwIfStopped,
YYDS_MAIL_PROVIDER,
});
const {
clearYydsMailRuntimeState,
fetchYydsMailAddress,
pollYydsMailVerificationCode,
} = yydsMailProvider;
function normalizeSub2ApiGroupNames(value = '') {
const source = Array.isArray(value)
@@ -2964,6 +3026,10 @@ function normalizePersistentSettingValue(key, value) {
return normalizeCloudMailDomain(value);
case 'cloudMailDomains':
return normalizeCloudMailDomains(value);
case 'yydsMailApiKey':
return normalizeYydsMailApiKey(value);
case 'yydsMailBaseUrl':
return normalizeYydsMailBaseUrl(value);
case 'hotmailAccounts':
return normalizeHotmailAccounts(value);
case 'mail2925Accounts':
@@ -3814,6 +3880,8 @@ async function resetState() {
'luckmailUsedPurchases',
'luckmailPreserveTagId',
'luckmailPreserveTagName',
'yydsMailApiKey',
'yydsMailBaseUrl',
'preferredIcloudHost',
'automationWindowId',
...CONTRIBUTION_RUNTIME_KEYS,
@@ -3879,6 +3947,9 @@ async function resetState() {
luckmailPreserveTagName: String(prev.luckmailPreserveTagName || '').trim() || DEFAULT_LUCKMAIL_PRESERVE_TAG_NAME,
currentLuckmailPurchase: null,
currentLuckmailMailCursor: null,
yydsMailApiKey: normalizeYydsMailApiKey(prev.yydsMailApiKey ?? persistedSettings.yydsMailApiKey),
yydsMailBaseUrl: normalizeYydsMailBaseUrl(prev.yydsMailBaseUrl ?? persistedSettings.yydsMailBaseUrl),
currentYydsMailInbox: null,
// Keep reusable phone activation across round resets so the same number can be reactivated up to maxUses.
reusablePhoneActivation,
// Keep free reuse phone activation until the user clears or the flow retires it.
@@ -4014,6 +4085,16 @@ function isLuckmailProvider(stateOrProvider) {
return provider === LUCKMAIL_PROVIDER;
}
function isYydsMailProvider(stateOrProvider) {
const provider = typeof stateOrProvider === 'string'
? stateOrProvider
: stateOrProvider?.mailProvider;
const yydsMailProvider = typeof YYDS_MAIL_PROVIDER === 'string'
? YYDS_MAIL_PROVIDER
: 'yyds-mail';
return provider === yydsMailProvider;
}
function isCustomMailProvider(stateOrProvider) {
const provider = typeof stateOrProvider === 'string'
? stateOrProvider
@@ -10545,6 +10626,9 @@ function getEmailGeneratorLabel(generator) {
const gmailAliasGenerator = typeof GMAIL_ALIAS_GENERATOR === 'string'
? GMAIL_ALIAS_GENERATOR
: 'gmail-alias';
const yydsMailGenerator = typeof YYDS_MAIL_GENERATOR === 'string'
? YYDS_MAIL_GENERATOR
: 'yyds-mail';
if (generator === 'custom') {
return '自定义邮箱';
}
@@ -10560,6 +10644,7 @@ function getEmailGeneratorLabel(generator) {
if (generator === 'cloudflare') return 'Cloudflare 邮箱';
if (generator === CLOUDFLARE_TEMP_EMAIL_GENERATOR) return 'Cloudflare Temp Email';
if (generator === CLOUD_MAIL_GENERATOR) return 'Cloud Mail';
if (generator === yydsMailGenerator) return 'YYDS Mail';
return 'Duck 邮箱';
}
const mail2925SessionManager = self.MultiPageBackgroundMail2925Session?.createMail2925SessionManager({
@@ -10736,7 +10821,20 @@ async function fetchDuckEmail(options = {}) {
async function fetchGeneratedEmail(state, options = {}) {
const currentState = state || await getState();
const yydsMailProvider = typeof YYDS_MAIL_PROVIDER === 'string'
? YYDS_MAIL_PROVIDER
: 'yyds-mail';
const yydsMailGenerator = typeof YYDS_MAIL_GENERATOR === 'string'
? YYDS_MAIL_GENERATOR
: 'yyds-mail';
const requestedMailProvider = normalizeMailProvider(options.mailProvider ?? currentState.mailProvider);
if (requestedMailProvider === yydsMailProvider) {
return fetchYydsMailAddress(currentState, options);
}
const generator = normalizeEmailGenerator(options.generator ?? currentState.emailGenerator);
if (generator === yydsMailGenerator) {
return fetchYydsMailAddress(currentState, options);
}
if (generator === CLOUD_MAIL_GENERATOR) {
return fetchCloudMailAddress(currentState, options);
}
@@ -11294,6 +11392,12 @@ async function ensureAutoEmailReady(targetRun, totalRuns, attemptRuns) {
return purchase.email_address;
}
if (isYydsMailProvider(currentState)) {
const email = await fetchYydsMailAddress(currentState, { generateNew: true });
await addLog(`=== 目标 ${targetRun}/${totalRuns} 轮：YYDS Mail 邮箱已就绪：${email}（第 ${attemptRuns} 次尝试）===`, 'ok');
return email;
}
if (isGeneratedAliasProvider(currentState)) {
if (currentState.mailProvider === GMAIL_PROVIDER) {
if (!currentState.emailPrefix) {
@@ -11425,6 +11529,12 @@ async function ensureAutoEmailReady(targetRun, totalRuns, attemptRuns) {
return purchase.email_address;
}
if (isYydsMailProvider(currentState)) {
const email = await fetchYydsMailAddress(currentState, { generateNew: true });
await addLog(`=== 目标 ${targetRun}/${totalRuns} 轮：YYDS Mail 邮箱已就绪：${email}（第 ${attemptRuns} 次尝试）===`, 'ok');
return email;
}
if (isGeneratedAliasProvider(currentState)) {
if (isReusableGeneratedAliasEmail(currentState)) {
await addLog(`=== 目标 ${targetRun}/${totalRuns} 轮：当前已复用 ${currentState.email}，将直接继续执行（第 ${attemptRuns} 次尝试）===`, 'info');
@@ -12168,12 +12278,14 @@ const verificationFlowHelpers = self.MultiPageBackgroundVerificationFlow?.create
isRetryableContentScriptTransportError,
isStopError,
LUCKMAIL_PROVIDER,
YYDS_MAIL_PROVIDER,
MAIL_2925_VERIFICATION_INTERVAL_MS,
MAIL_2925_VERIFICATION_MAX_ATTEMPTS,
pollCloudflareTempEmailVerificationCode,
pollCloudMailVerificationCode,
pollHotmailVerificationCode,
pollLuckmailVerificationCode,
pollYydsMailVerificationCode,
sendToContentScript,
sendToContentScriptResilient,
sendToMailContentScriptResilient,
@@ -12565,6 +12677,7 @@ const messageRouter = self.MultiPageBackgroundMessageRouter?.createMessageRouter
clearAutoRunTimerAlarm,
clearFreeReusablePhoneActivation,
clearLuckmailRuntimeState,
clearYydsMailRuntimeState,
clearStopRequest,
closeLocalhostCallbackTabs,
closeTabsByUrlPrefix,
@@ -12621,6 +12734,7 @@ const messageRouter = self.MultiPageBackgroundMessageRouter?.createMessageRouter
isHotmailProvider,
isLocalhostOAuthCallbackUrl,
isLuckmailProvider,
isYydsMailProvider,
isStopError,
isTabAlive,
launchAutoRunTimerPlan,
@@ -12833,6 +12947,9 @@ async function executeStep3(state) {
function getMailConfig(state) {
const provider = state.mailProvider || 'qq';
const yydsMailProvider = typeof YYDS_MAIL_PROVIDER === 'string'
? YYDS_MAIL_PROVIDER
: 'yyds-mail';
if (provider === 'custom') {
return { provider: 'custom', label: '自定义邮箱' };
}
@@ -12881,6 +12998,9 @@ function getMailConfig(state) {
if (provider === 'cloudmail') {
return { provider: 'cloudmail', label: 'Cloud Mail' };
}
if (provider === yydsMailProvider) {
return { provider: yydsMailProvider, label: 'YYDS Mail' };
}
if (provider === '163') {
return { source: 'mail-163', url: 'https://mail.163.com/js6/main.jsp?df=mail163_letter#module=mbox.ListModule%7C%7B%22fid%22%3A1%2C%22order%22%3A%22date%22%2C%22desc%22%3Atrue%7D', label: '163 邮箱' };
}
background/message-router.js
+10
View File
@@ -18,6 +18,7 @@
clearAutoRunTimerAlarm,
clearFreeReusablePhoneActivation,
clearLuckmailRuntimeState,
clearYydsMailRuntimeState,
clearStopRequest,
closeLocalhostCallbackTabs,
closeTabsByUrlPrefix,
@@ -125,6 +126,7 @@
isHotmailProvider,
isLocalhostOAuthCallbackUrl,
isLuckmailProvider,
isYydsMailProvider = () => false,
isStopError,
isTabAlive,
launchAutoRunTimerPlan,
@@ -572,6 +574,14 @@
await clearLuckmailRuntimeState({ clearEmail: true });
await addLog('当前 LuckMail 邮箱运行态已清空，下轮将优先复用未用邮箱或重新购买邮箱。', 'ok');
}
if (
typeof markCurrentRegistrationAccountUsed !== 'function'
&& isYydsMailProvider(latestState)
&& typeof clearYydsMailRuntimeState === 'function'
) {
await clearYydsMailRuntimeState({ clearEmail: true });
await addLog('当前 YYDS Mail 邮箱运行态已清空，下轮将重新创建邮箱。', 'ok');
}
const localhostPrefix = buildLocalhostCleanupPrefix(payload.localhostUrl);
if (localhostPrefix) {
await closeTabsByUrlPrefix(localhostPrefix, {
background/runtime-state.js
+1
View File
@@ -105,6 +105,7 @@
luckmail: Object.freeze([
'currentLuckmailPurchase',
'currentLuckmailMailCursor',
'currentYydsMailInbox',
]),
identity: Object.freeze([
'resolvedSignupMethod',
background/verification-flow.js
+9
View File
@@ -24,12 +24,14 @@
isMail2925LimitReachedError,
isStopError,
LUCKMAIL_PROVIDER,
YYDS_MAIL_PROVIDER = 'yyds-mail',
MAIL_2925_VERIFICATION_INTERVAL_MS,
MAIL_2925_VERIFICATION_MAX_ATTEMPTS,
pollCloudflareTempEmailVerificationCode,
pollCloudMailVerificationCode,
pollHotmailVerificationCode,
pollLuckmailVerificationCode,
pollYydsMailVerificationCode,
sendToContentScript,
sendToContentScriptResilient,
sendToMailContentScriptResilient,
@@ -985,6 +987,13 @@
}, cleanPollOverrides, `轮询${getVerificationCodeLabel(step)}验证码邮箱`);
return pollCloudMailVerificationCode(step, state, timedPoll.payload);
}
if (mail.provider === YYDS_MAIL_PROVIDER) {
const timedPoll = await applyMailPollingTimeBudget(step, {
...getVerificationPollPayload(step, state),
...cleanPollOverrides,
}, cleanPollOverrides, `轮询${getVerificationCodeLabel(step)}验证码邮箱`);
return pollYydsMailVerificationCode(step, state, timedPoll.payload);
}
if (Number(pollOverrides.resendIntervalMs) > 0) {
return pollFreshVerificationCodeWithResendInterval(step, state, mail, pollOverrides);
background/yyds-mail-provider.js
+330
View File
@@ -0,0 +1,330 @@
(function yydsMailProviderModule(root, factory) {
root.MultiPageBackgroundYydsMailProvider = factory();
})(typeof self !== 'undefined' ? self : globalThis, function createYydsMailProviderModule() {
function createYydsMailProvider(deps = {}) {
const {
addLog = async () => {},
buildYydsMailHeaders,
DEFAULT_YYDS_MAIL_BASE_URL = 'https://maliapi.215.im/v1',
fetchImpl = typeof fetch === 'function' ? fetch.bind(globalThis) : null,
getState = async () => ({}),
joinYydsMailUrl,
normalizeYydsMailAddress,
normalizeYydsMailApiKey,
normalizeYydsMailBaseUrl,
normalizeYydsMailCurrentInbox,
normalizeYydsMailInbox,
normalizeYydsMailMessageDetail,
normalizeYydsMailMessages,
persistRegistrationEmailState = null,
pickVerificationMessageWithTimeFallback,
setEmailState = async () => {},
setState = async () => {},
sleepWithStop = async () => {},
throwIfStopped = () => {},
YYDS_MAIL_PROVIDER = 'yyds-mail',
} = deps;
async function persistResolvedEmailState(state = null, email, options = {}) {
if (typeof persistRegistrationEmailState === 'function') {
await persistRegistrationEmailState(state, email, options);
return;
}
await setEmailState(email, options);
}
function getYydsMailConfig(state = {}) {
return {
apiKey: normalizeYydsMailApiKey(state.yydsMailApiKey),
baseUrl: normalizeYydsMailBaseUrl(state.yydsMailBaseUrl || DEFAULT_YYDS_MAIL_BASE_URL),
currentInbox: normalizeYydsMailCurrentInbox(state.currentYydsMailInbox),
};
}
function ensureYydsMailConfig(state = {}, options = {}) {
const { requireApiKey = false, requireInbox = false } = options;
const config = getYydsMailConfig(state);
if (!config.baseUrl) {
throw new Error('YYDS Mail API 地址为空或格式无效。');
}
if (requireApiKey && !config.apiKey) {
throw new Error('YYDS Mail API Key 为空，请先在侧边栏填写。');
}
if (requireInbox && (!config.currentInbox?.address || !config.currentInbox?.token)) {
throw new Error('YYDS Mail 当前没有可用邮箱，请先获取邮箱。');
}
return config;
}
async function requestYydsMailJson(config, path, options = {}) {
if (!fetchImpl) {
throw new Error('YYDS Mail 当前运行环境不支持 fetch。');
}
const {
method = 'GET',
payload,
params,
timeoutMs = 20000,
auth = 'temp',
} = options;
const url = joinYydsMailUrl(config.baseUrl, path, params);
const controller = new AbortController();
const timeoutId = setTimeout(() => controller.abort(new Error('timeout')), timeoutMs);
let response;
try {
response = await fetchImpl(url, {
method,
headers: buildYydsMailHeaders(config, {
apiKey: auth === 'apiKey' ? config.apiKey : '',
tempToken: auth === 'temp' ? config.currentInbox?.token : '',
includeConfigApiKey: auth === 'apiKey',
json: payload !== undefined,
}),
body: payload !== undefined ? JSON.stringify(payload || {}) : undefined,
signal: controller.signal,
});
} catch (err) {
const errorMessage = err?.name === 'AbortError'
? `YYDS Mail 请求超时（>${Math.round(timeoutMs / 1000)} 秒）`
: `YYDS Mail 请求失败：${err.message}`;
throw new Error(errorMessage);
} finally {
clearTimeout(timeoutId);
}
const text = await response.text();
let parsed = {};
try {
parsed = text ? JSON.parse(text) : {};
} catch {
parsed = text;
}
if (!response.ok) {
const payloadError = parsed && typeof parsed === 'object'
? (parsed.error || parsed.message || parsed.msg || parsed.errorCode)
: '';
throw new Error(`YYDS Mail 请求失败：${payloadError || text || `HTTP ${response.status}`}`);
}
if (parsed && typeof parsed === 'object' && parsed.success === false) {
throw new Error(`YYDS Mail 业务错误：${parsed.error || parsed.message || parsed.errorCode || 'unknown_error'}`);
}
if (parsed && typeof parsed === 'object' && Object.prototype.hasOwnProperty.call(parsed, 'data')) {
return parsed.data;
}
return parsed;
}
function generateYydsMailLocalPart() {
const letters = 'abcdefghijklmnopqrstuvwxyz';
const digits = '0123456789';
const chars = [];
for (let i = 0; i < 6; i += 1) chars.push(letters[Math.floor(Math.random() * letters.length)]);
for (let i = 0; i < 4; i += 1) chars.push(digits[Math.floor(Math.random() * digits.length)]);
for (let i = chars.length - 1; i > 0; i -= 1) {
const j = Math.floor(Math.random() * (i + 1));
[chars[i], chars[j]] = [chars[j], chars[i]];
}
return chars.join('');
}
async function fetchYydsMailAddress(state, options = {}) {
throwIfStopped();
const latestState = state || await getState();
const config = ensureYydsMailConfig(latestState, { requireApiKey: true });
const localPart = String(options.localPart || options.name || '').trim().toLowerCase()
|| generateYydsMailLocalPart();
const data = await requestYydsMailJson(config, '/accounts', {
method: 'POST',
auth: 'apiKey',
payload: { localPart },
});
const inbox = normalizeYydsMailInbox(data);
if (!inbox.address || !inbox.token) {
throw new Error('YYDS Mail 创建邮箱成功，但未返回可用 address/token。');
}
await setState({ currentYydsMailInbox: inbox });
await persistResolvedEmailState(latestState, inbox.address, {
source: `generated:${YYDS_MAIL_PROVIDER}`,
preserveAccountIdentity: Boolean(options?.preserveAccountIdentity),
});
await addLog(`YYDS Mail：已创建邮箱 ${inbox.address}`, 'ok');
return inbox.address;
}
function resolveYydsMailInbox(state = {}) {
const config = getYydsMailConfig(state);
if (config.currentInbox?.address && config.currentInbox?.token) {
return config.currentInbox;
}
return null;
}
function resolveYydsMailPollTargetEmail(state = {}, pollPayload = {}) {
return normalizeYydsMailAddress(pollPayload.targetEmail)
|| resolveYydsMailInbox(state)?.address
|| normalizeYydsMailAddress(state.email);
}
async function listYydsMailMessages(state, options = {}) {
const latestState = state || await getState();
const inbox = resolveYydsMailInbox(latestState);
const config = {
...ensureYydsMailConfig(latestState, { requireInbox: true }),
currentInbox: inbox,
};
const address = normalizeYydsMailAddress(options.address) || inbox.address;
const payload = await requestYydsMailJson(config, '/messages', {
method: 'GET',
auth: 'temp',
params: {
address,
limit: Number(options.limit) || 20,
},
});
return {
config,
messages: normalizeYydsMailMessages(payload),
};
}
async function getYydsMailMessageDetail(state, messageId, options = {}) {
const latestState = state || await getState();
const inbox = resolveYydsMailInbox(latestState);
const config = {
...ensureYydsMailConfig(latestState, { requireInbox: true }),
currentInbox: inbox,
};
const address = normalizeYydsMailAddress(options.address) || inbox.address;
const payload = await requestYydsMailJson(config, `/messages/${encodeURIComponent(messageId)}`, {
method: 'GET',
auth: 'temp',
params: { address },
});
return normalizeYydsMailMessageDetail(payload);
}
function summarizeYydsMailMessagesForLog(messages) {
return (messages || [])
.slice()
.sort((left, right) => {
const leftTime = Date.parse(left.receivedDateTime || '') || 0;
const rightTime = Date.parse(right.receivedDateTime || '') || 0;
return rightTime - leftTime;
})
.slice(0, 3)
.map((message) => {
const receivedAt = message?.receivedDateTime || '未知时间';
const sender = message?.from?.emailAddress?.address || '未知发件人';
const subject = message?.subject || '（无主题）';
const preview = String(message?.bodyPreview || '').replace(/\s+/g, ' ').trim().slice(0, 80);
return `${receivedAt} | ${sender} | ${subject} | ${preview}`;
})
.join(' || ');
}
async function hydrateYydsMailMessageDetails(state, messages, address) {
const details = [];
for (const message of (messages || []).slice(0, 8)) {
throwIfStopped();
if (!message?.id) {
details.push(message);
continue;
}
try {
details.push(await getYydsMailMessageDetail(state, message.id, { address }));
} catch (err) {
await addLog(`YYDS Mail：读取邮件详情 ${message.id} 失败：${err.message}`, 'warn');
details.push(message);
}
}
return details.filter(Boolean);
}
async function pollYydsMailVerificationCode(step, state, pollPayload = {}) {
const latestState = state || await getState();
const targetEmail = resolveYydsMailPollTargetEmail(latestState, pollPayload);
if (!targetEmail) {
throw new Error('YYDS Mail 轮询前缺少目标邮箱地址，请先获取邮箱。');
}
await addLog(`步骤 ${step}：正在轮询 YYDS Mail 邮件（${targetEmail}）...`, 'info');
const maxAttempts = Number(pollPayload.maxAttempts) || 5;
const intervalMs = Number(pollPayload.intervalMs) || 3000;
let lastError = null;
for (let attempt = 1; attempt <= maxAttempts; attempt += 1) {
throwIfStopped();
try {
const { messages } = await listYydsMailMessages(latestState, {
address: targetEmail,
limit: pollPayload.limit || 20,
});
const detailedMessages = await hydrateYydsMailMessageDetails(latestState, messages, targetEmail);
const matchResult = pickVerificationMessageWithTimeFallback(detailedMessages, {
afterTimestamp: pollPayload.filterAfterTimestamp || 0,
senderFilters: pollPayload.senderFilters || [],
subjectFilters: pollPayload.subjectFilters || [],
requiredKeywords: pollPayload.requiredKeywords || [],
codePatterns: pollPayload.codePatterns || [],
excludeCodes: pollPayload.excludeCodes || [],
});
const match = matchResult.match;
if (match?.code) {
if (matchResult.usedRelaxedFilters) {
const fallbackLabel = matchResult.usedTimeFallback ? '宽松匹配 + 时间回退' : '宽松匹配';
await addLog(`步骤 ${step}：严格规则未命中，已改用 ${fallbackLabel} 并命中 YYDS Mail 验证码。`, 'warn');
}
return {
ok: true,
code: match.code,
emailTimestamp: match.receivedAt || Date.now(),
mailId: match.message?.id || '',
};
}
lastError = new Error(`步骤 ${step}：暂未在 YYDS Mail 中找到匹配验证码（${attempt}/${maxAttempts}）。`);
await addLog(lastError.message, attempt === maxAttempts ? 'warn' : 'info');
const sample = summarizeYydsMailMessagesForLog(detailedMessages.length ? detailedMessages : messages);
if (sample) {
await addLog(`步骤 ${step}：最近邮件样本：${sample}`, 'info');
}
} catch (err) {
lastError = err;
await addLog(`步骤 ${step}：YYDS Mail 轮询失败：${err.message}`, 'warn');
}
if (attempt < maxAttempts) {
await sleepWithStop(intervalMs);
}
}
throw lastError || new Error(`步骤 ${step}：未在 YYDS Mail 中找到新的匹配验证码。`);
}
async function clearYydsMailRuntimeState(options = {}) {
await setState({
currentYydsMailInbox: null,
...(options.clearEmail ? { email: null } : {}),
});
}
return {
clearYydsMailRuntimeState,
ensureYydsMailConfig,
fetchYydsMailAddress,
getYydsMailConfig,
getYydsMailMessageDetail,
listYydsMailMessages,
pollYydsMailVerificationCode,
requestYydsMailJson,
resolveYydsMailPollTargetEmail,
};
}
return {
createYydsMailProvider,
};
});
mail-provider-utils.js
+6
View File
@@ -11,6 +11,7 @@
})(typeof self !== 'undefined' ? self : globalThis, function createMailProviderUtils() {
const HOTMAIL_PROVIDER = 'hotmail-api';
const GMAIL_PROVIDER = 'gmail';
const YYDS_MAIL_PROVIDER = 'yyds-mail';
const NETEASE_LIST_PATH = '/js6/main.jsp?df=mail163_letter#module=mbox.ListModule%7C%7B%22fid%22%3A1%2C%22order%22%3A%22date%22%2C%22desc%22%3Atrue%7D';
const ICLOUD_TARGET_MAILBOX_TYPE_INBOX = 'icloud-inbox';
const ICLOUD_TARGET_MAILBOX_TYPE_FORWARD = 'forward-mailbox';
@@ -26,6 +27,7 @@
const normalized = String(value || '').trim().toLowerCase();
switch (normalized) {
case HOTMAIL_PROVIDER:
case YYDS_MAIL_PROVIDER:
case '163':
case '163-vip':
case '126':
@@ -76,6 +78,9 @@
if (provider === HOTMAIL_PROVIDER) {
return { provider: HOTMAIL_PROVIDER, label: 'Hotmail（微软 Graph）' };
}
if (provider === YYDS_MAIL_PROVIDER) {
return { provider: YYDS_MAIL_PROVIDER, label: 'YYDS Mail' };
}
if (provider === '163') {
return {
source: 'mail-163',
@@ -121,6 +126,7 @@
return {
GMAIL_PROVIDER,
HOTMAIL_PROVIDER,
YYDS_MAIL_PROVIDER,
getIcloudForwardMailConfig,
getIcloudForwardMailProviderOptions,
getMailProviderConfig,
sidepanel/sidepanel.html
+25
View File
@@ -420,6 +420,7 @@
<option value="custom">自定义邮箱</option>
<option value="hotmail-api">Hotmail（账号池）</option>
<option value="luckmail-api">LuckMail（API 购邮）</option>
<option value="yyds-mail">YYDS Mail</option>
<option value="icloud">iCloud 邮箱</option>
<option value="163">163 邮箱 (mail.163.com) 版本老旧，请自行维护使用</option>
<option value="163-vip">163 VIP 邮箱 (vip.163.com) 版本老旧，请自行维护使用</option>
@@ -778,6 +779,29 @@
<input type="text" id="input-cloud-mail-domain" class="data-input" placeholder="例如 mail.example.com" />
</div>
</div>
<div id="yyds-mail-section" class="data-card hotmail-card" style="display:none;">
<div class="section-mini-header">
<div class="section-mini-copy">
<span class="section-label">YYDS Mail</span>
<span class="data-value">自动创建临时邮箱并通过 API 收取验证码</span>
</div>
</div>
<div class="data-row">
<span class="data-label">API Key</span>
<div class="input-with-icon">
<input type="password" id="input-yyds-mail-api-key" class="data-input data-input-with-icon mono"
placeholder="请输入 YYDS Mail API Key（AC-...）" />
<button id="btn-toggle-yyds-mail-api-key" class="input-icon-btn" type="button"
data-password-toggle="input-yyds-mail-api-key" data-show-label="显示 YYDS Mail API Key"
data-hide-label="隐藏 YYDS Mail API Key" aria-label="显示 YYDS Mail API Key" title="显示 YYDS Mail API Key"></button>
</div>
</div>
<div class="data-row">
<span class="data-label">Base URL</span>
<input type="text" id="input-yyds-mail-base-url" class="data-input mono"
placeholder="https://maliapi.215.im/v1" />
</div>
</div>
<div id="hotmail-section" class="data-card hotmail-card" style="display:none;">
<div class="section-mini-header">
<div class="section-mini-copy">
@@ -1764,6 +1788,7 @@
<script src="../mail-provider-utils.js"></script>
<script src="../hotmail-utils.js"></script>
<script src="../luckmail-utils.js"></script>
<script src="../yyds-mail-utils.js"></script>
<script src="../shared/flow-capabilities.js"></script>
<script src="../data/step-definitions.js"></script>
<script src="update-service.js"></script>
sidepanel/sidepanel.js
+97 -3
View File
@@ -274,6 +274,9 @@ const inputCloudMailAdminEmail = document.getElementById('input-cloud-mail-admin
const inputCloudMailAdminPassword = document.getElementById('input-cloud-mail-admin-password');
const inputCloudMailReceiveMailbox = document.getElementById('input-cloud-mail-receive-mailbox');
const inputCloudMailDomain = document.getElementById('input-cloud-mail-domain');
const yydsMailSection = document.getElementById('yyds-mail-section');
const inputYydsMailApiKey = document.getElementById('input-yyds-mail-api-key');
const inputYydsMailBaseUrl = document.getElementById('input-yyds-mail-base-url');
const hotmailSection = document.getElementById('hotmail-section');
const mail2925Section = document.getElementById('mail2925-section');
const luckmailSection = document.getElementById('luckmail-section');
@@ -971,9 +974,11 @@ const ICLOUD_PROVIDER = 'icloud';
const GMAIL_PROVIDER = 'gmail';
const GMAIL_ALIAS_GENERATOR = 'gmail-alias';
const LUCKMAIL_PROVIDER = 'luckmail-api';
const YYDS_MAIL_PROVIDER = 'yyds-mail';
const CUSTOM_EMAIL_POOL_GENERATOR = 'custom-pool';
const DEFAULT_LUCKMAIL_BASE_URL = 'https://mails.luckyous.com';
const DEFAULT_LUCKMAIL_EMAIL_TYPE = 'ms_graph';
const DEFAULT_YYDS_MAIL_BASE_URL = window.YydsMailUtils?.DEFAULT_YYDS_MAIL_BASE_URL || 'https://maliapi.215.im/v1';
const DISPLAY_TIMEZONE = 'Asia/Shanghai';
const DEFAULT_ACCOUNT_RUN_HISTORY_HELPER_BASE_URL = 'http://127.0.0.1:17373';
const CONTRIBUTION_UPLOAD_URL = 'https://flowpilot.qlhazycoder.top/';
@@ -1210,6 +1215,17 @@ function getCurrentRegistrationEmailUiCopy() {
if (isCustomMailProvider()) {
return getCustomMailProviderUiCopy();
}
const useYydsMail = typeof isYydsMailProvider === 'function'
? isYydsMailProvider()
: String(selectMailProvider.value || '').trim().toLowerCase() === 'yyds-mail';
if (useYydsMail) {
return {
buttonLabel: '获取',
placeholder: '点击获取 YYDS Mail 邮箱，或手动粘贴邮箱',
successVerb: '获取',
label: 'YYDS Mail',
};
}
if (usesGeneratedAliasMailProvider()) {
return getManagedAliasProviderUiCopy();
}
@@ -1554,6 +1570,11 @@ const MAIL_PROVIDER_LOGIN_CONFIGS = {
url: 'https://github.com/QLHazyCoder/cloudflare_temp_email',
buttonLabel: '部署',
},
[YYDS_MAIL_PROVIDER]: {
label: 'YYDS Mail',
url: 'https://vip.215.im/docs',
buttonLabel: '文档',
},
'2925': {
label: '2925 邮箱',
url: 'https://2925.com/#/mailList',
@@ -2860,8 +2881,12 @@ function restoreCustomEmailPoolEntriesFromState(state = {}) {
}
function usesCustomEmailPoolGenerator(provider = selectMailProvider.value) {
const providerUsesYydsMail = typeof isYydsMailProvider === 'function'
? isYydsMailProvider(provider)
: String(provider || '').trim().toLowerCase() === 'yyds-mail';
return !isCustomMailProvider(provider)
&& !isLuckmailProvider(provider)
&& !providerUsesYydsMail
&& getSelectedEmailGenerator() === CUSTOM_EMAIL_POOL_GENERATOR;
}
@@ -3207,10 +3232,25 @@ function applyCloudMailSettingsState(state = {}) {
}
}
function applyYydsMailSettingsState(state = {}) {
const normalizeYydsBaseUrlValue = typeof normalizeYydsMailBaseUrl === 'function'
? normalizeYydsMailBaseUrl
: ((value) => String(value || '').trim() || 'https://maliapi.215.im/v1');
if (inputYydsMailApiKey) {
inputYydsMailApiKey.value = state?.yydsMailApiKey || '';
}
if (inputYydsMailBaseUrl) {
inputYydsMailBaseUrl.value = normalizeYydsBaseUrlValue(state?.yydsMailBaseUrl);
}
}
function collectSettingsPayload() {
const defaultGpcHelperApiUrl = typeof DEFAULT_GPC_HELPER_API_URL !== 'undefined'
? DEFAULT_GPC_HELPER_API_URL
: 'https://gpc.qlhazycoder.top';
const normalizeYydsBaseUrlValue = typeof normalizeYydsMailBaseUrl === 'function'
? normalizeYydsMailBaseUrl
: ((value) => String(value || '').trim() || 'https://maliapi.215.im/v1');
const { domains, activeDomain } = getCloudflareDomainsFromState();
const selectedCloudflareDomain = normalizeCloudflareDomainValue(
!cloudflareDomainEditMode ? selectCfDomain.value : activeDomain
@@ -3981,6 +4021,8 @@ function collectSettingsPayload() {
cloudMailAdminPassword: (typeof inputCloudMailAdminPassword !== 'undefined' && inputCloudMailAdminPassword) ? inputCloudMailAdminPassword.value : '',
cloudMailReceiveMailbox: normalizeCloudMailReceiveMailboxInput((typeof inputCloudMailReceiveMailbox !== 'undefined' && inputCloudMailReceiveMailbox) ? inputCloudMailReceiveMailbox.value : ''),
cloudMailDomain: normalizeCloudMailDomainInput((typeof inputCloudMailDomain !== 'undefined' && inputCloudMailDomain) ? inputCloudMailDomain.value : ''),
yydsMailApiKey: (typeof inputYydsMailApiKey !== 'undefined' && inputYydsMailApiKey) ? inputYydsMailApiKey.value.trim() : '',
yydsMailBaseUrl: normalizeYydsBaseUrlValue((typeof inputYydsMailBaseUrl !== 'undefined' && inputYydsMailBaseUrl) ? inputYydsMailBaseUrl.value : ''),
autoRunSkipFailures: inputAutoSkipFailures.checked,
autoRunFallbackThreadIntervalMinutes: normalizeAutoRunThreadIntervalMinutes(inputAutoSkipFailuresThreadIntervalMinutes.value),
step6CookieCleanupEnabled: typeof inputStep6CookieCleanupEnabled !== 'undefined' && inputStep6CookieCleanupEnabled
@@ -9359,8 +9401,11 @@ function applySettingsState(state) {
}
inputCodex2ApiUrl.value = state?.codex2apiUrl || '';
inputCodex2ApiAdminKey.value = state?.codex2apiAdminKey || '';
const yydsMailProvider = typeof YYDS_MAIL_PROVIDER === 'string'
? YYDS_MAIL_PROVIDER
: 'yyds-mail';
const restoredMailProvider = isCustomMailProvider(state?.mailProvider)
|| [ICLOUD_PROVIDER, 'hotmail-api', GMAIL_PROVIDER, 'luckmail-api', '163', '163-vip', '126', 'qq', 'inbucket', '2925', 'cloudflare-temp-email', 'cloudmail'].includes(String(state?.mailProvider || '').trim())
|| [ICLOUD_PROVIDER, 'hotmail-api', GMAIL_PROVIDER, 'luckmail-api', yydsMailProvider, '163', '163-vip', '126', 'qq', 'inbucket', '2925', 'cloudflare-temp-email', 'cloudmail'].includes(String(state?.mailProvider || '').trim())
? String(state?.mailProvider || '163').trim()
: (String(state?.emailGenerator || '').trim().toLowerCase() === 'custom'
|| String(state?.emailGenerator || '').trim().toLowerCase() === 'manual'
@@ -9442,6 +9487,9 @@ function applySettingsState(state) {
if (typeof applyCloudMailSettingsState === 'function') {
applyCloudMailSettingsState(state);
}
if (typeof applyYydsMailSettingsState === 'function') {
applyYydsMailSettingsState(state);
}
renderCloudflareDomainOptions(state?.cloudflareDomain || '');
setCloudflareDomainEditMode(false, { clearInput: true });
inputAutoSkipFailures.checked = Boolean(state?.autoRunSkipFailures);
@@ -10157,6 +10205,13 @@ function isLuckmailProvider(provider = selectMailProvider.value) {
return String(provider || '').trim().toLowerCase() === LUCKMAIL_PROVIDER;
}
function isYydsMailProvider(provider = selectMailProvider.value) {
const yydsMailProvider = typeof YYDS_MAIL_PROVIDER === 'string'
? YYDS_MAIL_PROVIDER
: 'yyds-mail';
return String(provider || '').trim().toLowerCase() === yydsMailProvider;
}
function isIcloudMailProvider(provider = selectMailProvider.value) {
return String(provider || '').trim().toLowerCase() === ICLOUD_PROVIDER;
}
@@ -10188,6 +10243,29 @@ function normalizeLuckmailEmailType(value = '') {
: DEFAULT_LUCKMAIL_EMAIL_TYPE;
}
function normalizeYydsMailBaseUrl(value = '') {
if (window.YydsMailUtils?.normalizeYydsMailBaseUrl) {
return window.YydsMailUtils.normalizeYydsMailBaseUrl(value);
}
const trimmed = String(value || '').trim();
if (!trimmed) {
return DEFAULT_YYDS_MAIL_BASE_URL;
}
const candidate = /^[a-zA-Z][a-zA-Z\d+\-.]*:\/\//.test(trimmed) ? trimmed : `https://${trimmed}`;
try {
const parsed = new URL(candidate);
if (!['http:', 'https:'].includes(parsed.protocol)) {
return DEFAULT_YYDS_MAIL_BASE_URL;
}
parsed.hash = '';
parsed.search = '';
parsed.pathname = parsed.pathname === '/' ? '' : parsed.pathname.replace(/\/+$/, '');
return `${parsed.origin}${parsed.pathname}` || DEFAULT_YYDS_MAIL_BASE_URL;
} catch {
return DEFAULT_YYDS_MAIL_BASE_URL;
}
}
function getSelectedEmailGenerator() {
const generator = String(selectEmailGenerator.value || '').trim().toLowerCase();
if (generator === 'custom' || generator === 'manual') {
@@ -10678,10 +10756,13 @@ function updateMailProviderUI() {
const useInbucket = selectMailProvider.value === 'inbucket';
const useHotmail = selectMailProvider.value === 'hotmail-api';
const useLuckmail = canShowLuckmail && isLuckmailProvider();
const useYydsMail = typeof isYydsMailProvider === 'function'
? isYydsMailProvider()
: String(selectMailProvider.value || '').trim().toLowerCase() === 'yyds-mail';
const useCustomEmail = isCustomMailProvider();
const useCustomMailProviderPool = useCustomEmail && usesCustomMailProviderPool(selectMailProvider.value);
const useIcloudProvider = isIcloudMailProvider();
const useEmailGenerator = !useHotmail && !useLuckmail && !useCustomEmail && (!useGeneratedAlias || useGmail);
const useEmailGenerator = !useHotmail && !useLuckmail && !useYydsMail && !useCustomEmail && (!useGeneratedAlias || useGmail);
const useCloudflareTempEmailProvider = selectMailProvider.value === 'cloudflare-temp-email';
const useCloudMailProvider = selectMailProvider.value === 'cloudmail';
const aliasUiCopy = useGeneratedAlias
@@ -10751,6 +10832,9 @@ function updateMailProviderUI() {
if (typeof cloudMailSection !== 'undefined' && cloudMailSection) {
cloudMailSection.style.display = showCloudMailSettings ? '' : 'none';
}
if (typeof yydsMailSection !== 'undefined' && yydsMailSection) {
yydsMailSection.style.display = useYydsMail ? '' : 'none';
}
if (typeof rowCloudMailBaseUrl !== 'undefined' && rowCloudMailBaseUrl) rowCloudMailBaseUrl.style.display = showCloudMailSettings ? '' : 'none';
if (typeof rowCloudMailAdminEmail !== 'undefined' && rowCloudMailAdminEmail) rowCloudMailAdminEmail.style.display = showCloudMailSettings ? '' : 'none';
if (typeof rowCloudMailAdminPassword !== 'undefined' && rowCloudMailAdminPassword) rowCloudMailAdminPassword.style.display = showCloudMailSettings ? '' : 'none';
@@ -10818,7 +10902,7 @@ function updateMailProviderUI() {
}
inputEmailPrefix.style.display = '';
inputEmailPrefix.readOnly = false;
selectEmailGenerator.disabled = useHotmail || useLuckmail || useCustomEmail || (useGeneratedAlias && !useGmail);
selectEmailGenerator.disabled = useHotmail || useLuckmail || useYydsMail || useCustomEmail || (useGeneratedAlias && !useGmail);
if (useGmail) {
labelEmailPrefix.textContent = 'Gmail 原邮箱';
inputEmailPrefix.placeholder = '例如 yourname@gmail.com';
@@ -12945,6 +13029,16 @@ inputVpsPassword.addEventListener('blur', () => {
});
});
[inputYydsMailApiKey, inputYydsMailBaseUrl].forEach((input) => {
input?.addEventListener('input', () => {
markSettingsDirty(true);
scheduleSettingsAutoSave();
});
input?.addEventListener('blur', () => {
saveSettings({ silent: true }).catch(() => { });
});
});
selectLuckmailEmailType?.addEventListener('change', () => {
markSettingsDirty(true);
saveSettings({ silent: true }).catch(() => { });
tests/background-luckmail.test.js
+14
View File
@@ -688,12 +688,15 @@ test('resetState preserves LuckMail session config, used map, and preserve tag c
" luckmailBaseUrl: 'https://mails.luckyous.com',",
" luckmailEmailType: 'ms_graph',",
" luckmailDomain: '',",
" yydsMailApiKey: '',",
" yydsMailBaseUrl: 'https://maliapi.215.im/v1',",
" panelMode: 'cpa',",
' luckmailUsedPurchases: {},',
' luckmailPreserveTagId: 0,',
" luckmailPreserveTagName: '保留',",
" currentLuckmailPurchase: { token: 'stale' },",
" currentLuckmailMailCursor: { messageId: 'stale' },",
" currentYydsMailInbox: { address: 'stale@example.com', token: 'stale-token' },",
' currentPhoneActivation: null,',
' reusablePhoneActivation: null,',
' email: null,',
@@ -725,6 +728,12 @@ test('resetState preserves LuckMail session config, used map, and preserve tag c
'function normalizeLuckmailUsedPurchases(value) {',
' return value || {};',
'}',
'function normalizeYydsMailApiKey(value) {',
" return String(value || '').trim();",
'}',
'function normalizeYydsMailBaseUrl(value) {',
" return (String(value || '').trim() || 'https://maliapi.215.im/v1').replace(/\\/$/, '');",
'}',
'async function getPersistedSettings() {',
" return { mailProvider: '163' };",
'}',
@@ -752,6 +761,8 @@ test('resetState preserves LuckMail session config, used map, and preserve tag c
" luckmailUsedPurchases: { 88: true },",
' luckmailPreserveTagId: 9,',
" luckmailPreserveTagName: '保留',",
" yydsMailApiKey: 'AC-session',",
" yydsMailBaseUrl: 'https://maliapi.215.im/v1/',",
' };',
' },',
' async clear() {',
@@ -786,6 +797,9 @@ test('resetState preserves LuckMail session config, used map, and preserve tag c
assert.equal(snapshot.storedPayload.luckmailPreserveTagName, '保留');
assert.equal(snapshot.storedPayload.currentLuckmailPurchase, null);
assert.equal(snapshot.storedPayload.currentLuckmailMailCursor, null);
assert.equal(snapshot.storedPayload.yydsMailApiKey, 'AC-session');
assert.equal(snapshot.storedPayload.yydsMailBaseUrl, 'https://maliapi.215.im/v1');
assert.equal(snapshot.storedPayload.currentYydsMailInbox, null);
assert.deepStrictEqual(snapshot.storedPayload.reusablePhoneActivation, {
activationId: 'rx-001',
phoneNumber: '66951112222',
tests/background-verification-flow-module.test.js
+35
View File
@@ -15,3 +15,38 @@ test('verification flow module exposes a factory', () => {
assert.equal(typeof api?.createVerificationFlowHelpers, 'function');
});
test('verification flow routes YYDS Mail provider to background poller', async () => {
const source = fs.readFileSync('background/verification-flow.js', 'utf8');
const globalScope = {};
const api = new Function('self', `${source}; return self.MultiPageBackgroundVerificationFlow;`)(globalScope);
const pollCalls = [];
const helpers = api.createVerificationFlowHelpers({
addLog: async () => {},
buildVerificationPollPayload: () => ({ maxAttempts: 1, intervalMs: 1 }),
getState: async () => ({}),
getTabId: async () => 1,
isStopError: () => false,
pollYydsMailVerificationCode: async (step, state, payload) => {
pollCalls.push({ step, state, payload });
return { ok: true, code: '123456', emailTimestamp: 1, mailId: 'msg-1' };
},
sendToContentScript: async () => ({}),
setState: async () => {},
sleepWithStop: async () => {},
throwIfStopped: () => {},
YYDS_MAIL_PROVIDER: 'yyds-mail',
});
const result = await helpers.pollFreshVerificationCode(
4,
{ mailProvider: 'yyds-mail' },
{ provider: 'yyds-mail', label: 'YYDS Mail' },
{ disableTimeBudgetCap: true }
);
assert.equal(result.code, '123456');
assert.equal(pollCalls.length, 1);
assert.equal(pollCalls[0].step, 4);
assert.equal(pollCalls[0].payload.maxAttempts, 1);
});
tests/mail-provider-utils.test.js
+12
View File
@@ -3,6 +3,7 @@ const assert = require('node:assert/strict');
const {
HOTMAIL_PROVIDER,
YYDS_MAIL_PROVIDER,
getIcloudForwardMailConfig,
getIcloudForwardMailProviderOptions,
getMailProviderConfig,
@@ -14,6 +15,7 @@ const {
test('normalizeMailProvider accepts 126 and falls back to 163', () => {
assert.equal(normalizeMailProvider('126'), '126');
assert.equal(normalizeMailProvider('163-vip'), '163-vip');
assert.equal(normalizeMailProvider(YYDS_MAIL_PROVIDER), YYDS_MAIL_PROVIDER);
assert.equal(normalizeMailProvider('unknown-provider'), '163');
});
@@ -38,6 +40,16 @@ test('getMailProviderConfig preserves the hotmail provider sentinel', () => {
);
});
test('getMailProviderConfig preserves the YYDS Mail provider sentinel', () => {
assert.deepEqual(
getMailProviderConfig({ mailProvider: YYDS_MAIL_PROVIDER }),
{
provider: YYDS_MAIL_PROVIDER,
label: 'YYDS Mail',
}
);
});
test('iCloud forward mailbox helpers normalize and expose supported providers', () => {
assert.equal(normalizeIcloudTargetMailboxType('forward-mailbox'), 'forward-mailbox');
assert.equal(normalizeIcloudTargetMailboxType('unknown'), 'icloud-inbox');
tests/yyds-mail-provider.test.js
+185
View File
@@ -0,0 +1,185 @@
const test = require('node:test');
const assert = require('node:assert/strict');
const utils = require('../yyds-mail-utils.js');
require('../background/yyds-mail-provider.js');
function createProviderApi(options = {}) {
const {
state = {
yydsMailApiKey: 'AC-demo',
yydsMailBaseUrl: 'https://maliapi.215.im/v1',
currentYydsMailInbox: null,
email: '',
},
fetchImpl,
} = options;
let currentState = { ...state };
const logs = [];
const persistCalls = [];
const stateUpdates = [];
const calls = [];
const api = globalThis.MultiPageBackgroundYydsMailProvider.createYydsMailProvider({
addLog: async (message, level) => logs.push({ message, level }),
buildYydsMailHeaders: utils.buildYydsMailHeaders,
DEFAULT_YYDS_MAIL_BASE_URL: utils.DEFAULT_YYDS_MAIL_BASE_URL,
fetchImpl: fetchImpl || (async (url, request = {}) => {
calls.push({
url: String(url),
method: request.method,
headers: request.headers,
body: request.body ? JSON.parse(request.body) : undefined,
});
if (String(url).endsWith('/accounts')) {
return {
ok: true,
text: async () => JSON.stringify({
success: true,
data: {
id: 'inbox-1',
address: 'fresh@example.com',
token: 'temp-token',
expiresAt: '2026-03-15T12:00:00Z',
},
}),
};
}
if (String(url).includes('/messages/msg-1')) {
return {
ok: true,
text: async () => JSON.stringify({
success: true,
data: {
id: 'msg-1',
from: { address: 'noreply@tm.openai.com' },
subject: 'OpenAI verification code',
text: 'Your ChatGPT code is 987654.',
createdAt: '2026-03-14T12:30:00Z',
},
}),
};
}
if (String(url).includes('/messages')) {
return {
ok: true,
text: async () => JSON.stringify({
success: true,
data: {
messages: [{
id: 'msg-1',
from: { address: 'noreply@tm.openai.com' },
subject: 'OpenAI verification code',
createdAt: '2026-03-14T12:30:00Z',
}],
},
}),
};
}
throw new Error(`unexpected URL ${url}`);
}),
getState: async () => currentState,
joinYydsMailUrl: utils.joinYydsMailUrl,
normalizeYydsMailAddress: utils.normalizeYydsMailAddress,
normalizeYydsMailApiKey: utils.normalizeYydsMailApiKey,
normalizeYydsMailBaseUrl: utils.normalizeYydsMailBaseUrl,
normalizeYydsMailCurrentInbox: utils.normalizeYydsMailCurrentInbox,
normalizeYydsMailInbox: utils.normalizeYydsMailInbox,
normalizeYydsMailMessageDetail: utils.normalizeYydsMailMessageDetail,
normalizeYydsMailMessages: utils.normalizeYydsMailMessages,
persistRegistrationEmailState: async (callState, email, persistOptions) => {
persistCalls.push({ state: callState, email, options: persistOptions });
currentState = { ...currentState, email };
},
pickVerificationMessageWithTimeFallback: (messages) => {
const match = messages.find((message) => message.verification_code);
return match
? {
match: {
code: match.verification_code,
receivedAt: Date.parse(match.receivedDateTime),
message: match,
},
usedRelaxedFilters: false,
usedTimeFallback: false,
}
: { match: null, usedRelaxedFilters: false, usedTimeFallback: false };
},
setState: async (updates) => {
stateUpdates.push(updates);
currentState = { ...currentState, ...updates };
},
sleepWithStop: async () => {},
throwIfStopped: () => {},
YYDS_MAIL_PROVIDER: utils.YYDS_MAIL_PROVIDER,
});
return {
...api,
snapshot() {
return { calls, currentState, logs, persistCalls, stateUpdates };
},
};
}
test('fetchYydsMailAddress creates an inbox with localPart only and stores the returned address/token', async () => {
const api = createProviderApi();
const email = await api.fetchYydsMailAddress(null, { localPart: 'fresh' });
const snapshot = api.snapshot();
assert.equal(email, 'fresh@example.com');
assert.equal(snapshot.calls[0].url, 'https://maliapi.215.im/v1/accounts');
assert.equal(snapshot.calls[0].method, 'POST');
assert.deepEqual(snapshot.calls[0].body, { localPart: 'fresh' });
assert.equal(snapshot.calls[0].headers['X-API-Key'], 'AC-demo');
assert.equal(snapshot.calls[0].headers.Authorization, undefined);
assert.equal(snapshot.currentState.currentYydsMailInbox.address, 'fresh@example.com');
assert.equal(snapshot.currentState.currentYydsMailInbox.token, 'temp-token');
assert.equal(snapshot.persistCalls[0].email, 'fresh@example.com');
});
test('pollYydsMailVerificationCode lists messages with temp token and reads detail before matching code', async () => {
const api = createProviderApi({
state: {
yydsMailApiKey: 'AC-demo',
yydsMailBaseUrl: 'https://maliapi.215.im/v1',
currentYydsMailInbox: {
id: 'inbox-1',
address: 'fresh@example.com',
token: 'temp-token',
},
email: 'fresh@example.com',
},
});
const result = await api.pollYydsMailVerificationCode(4, null, {
maxAttempts: 1,
intervalMs: 1,
senderFilters: ['openai'],
subjectFilters: ['code'],
});
const snapshot = api.snapshot();
const listCall = snapshot.calls.find((call) => call.url.includes('/messages?'));
const detailCall = snapshot.calls.find((call) => call.url.includes('/messages/msg-1'));
assert.equal(result.code, '987654');
assert.equal(listCall.headers.Authorization, 'Bearer temp-token');
assert.equal(listCall.headers['X-API-Key'], undefined);
assert.match(listCall.url, /address=fresh%40example\.com/);
assert.equal(detailCall.headers.Authorization, 'Bearer temp-token');
});
test('clearYydsMailRuntimeState clears current inbox and optionally current email', async () => {
const api = createProviderApi({
state: {
currentYydsMailInbox: { address: 'fresh@example.com', token: 'temp-token' },
email: 'fresh@example.com',
},
});
await api.clearYydsMailRuntimeState({ clearEmail: true });
assert.deepEqual(api.snapshot().stateUpdates.at(-1), {
currentYydsMailInbox: null,
email: null,
});
});
tests/yyds-mail-utils.test.js
+91
View File
@@ -0,0 +1,91 @@
const test = require('node:test');
const assert = require('node:assert/strict');
const {
DEFAULT_YYDS_MAIL_BASE_URL,
buildYydsMailHeaders,
joinYydsMailUrl,
normalizeYydsMailBaseUrl,
normalizeYydsMailInbox,
normalizeYydsMailMessageDetail,
normalizeYydsMailMessages,
} = require('../yyds-mail-utils.js');
test('normalizeYydsMailBaseUrl defaults to official v1 endpoint and trims trailing slash', () => {
assert.equal(normalizeYydsMailBaseUrl(''), DEFAULT_YYDS_MAIL_BASE_URL);
assert.equal(normalizeYydsMailBaseUrl('maliapi.215.im/v1/'), DEFAULT_YYDS_MAIL_BASE_URL);
assert.equal(normalizeYydsMailBaseUrl('http://127.0.0.1:8787/v1/'), 'http://127.0.0.1:8787/v1');
});
test('buildYydsMailHeaders separates API key creation auth from temp-token read auth', () => {
assert.deepEqual(buildYydsMailHeaders({ apiKey: 'AC-demo' }, { json: true }), {
'X-API-Key': 'AC-demo',
'Content-Type': 'application/json',
Accept: 'application/json',
});
assert.deepEqual(
buildYydsMailHeaders(
{ apiKey: 'AC-demo', token: 'temp-token' },
{ tempToken: 'temp-token', includeConfigApiKey: false }
),
{
Authorization: 'Bearer temp-token',
Accept: 'application/json',
}
);
});
test('joinYydsMailUrl appends query parameters to the normalized base URL', () => {
assert.equal(
joinYydsMailUrl('https://maliapi.215.im/v1/', '/messages', { address: 'a+b@example.com', limit: 20 }),
'https://maliapi.215.im/v1/messages?address=a%2Bb%40example.com&limit=20'
);
});
test('normalizeYydsMailInbox keeps the final returned address and temp token', () => {
assert.deepEqual(normalizeYydsMailInbox({
id: 'inbox-1',
address: 'User@Example.com',
token: 'jwt-token',
expiresAt: '2026-03-15T12:00:00Z',
}), {
id: 'inbox-1',
address: 'user@example.com',
token: 'jwt-token',
expiresAt: '2026-03-15T12:00:00Z',
isActive: true,
createdAt: null,
raw: {
id: 'inbox-1',
address: 'User@Example.com',
token: 'jwt-token',
expiresAt: '2026-03-15T12:00:00Z',
},
});
});
test('normalizeYydsMailMessages and detail expose Graph-like fields for verification matching', () => {
const messages = normalizeYydsMailMessages({
messages: [{
id: 'msg-1',
from: { address: 'noreply@tm.openai.com' },
to: [{ address: 'User@Example.com' }],
subject: 'OpenAI verification code',
createdAt: '2026-03-14T12:30:00Z',
}],
});
assert.equal(messages[0].id, 'msg-1');
assert.equal(messages[0].address, 'user@example.com');
assert.equal(messages[0].from.emailAddress.address, 'noreply@tm.openai.com');
const detail = normalizeYydsMailMessageDetail({
id: 'msg-1',
subject: 'OpenAI verification code',
from: { address: 'noreply@tm.openai.com' },
text: 'Your ChatGPT code is 654321.',
createdAt: '2026-03-14T12:30:00Z',
});
assert.equal(detail.verification_code, '654321');
assert.match(detail.bodyPreview, /654321/);
});
yyds-mail-utils.js
+276
View File
@@ -0,0 +1,276 @@
(function yydsMailUtilsModule(root, factory) {
if (typeof module !== 'undefined' && module.exports) {
module.exports = factory();
return;
}
root.YydsMailUtils = factory();
})(typeof self !== 'undefined' ? self : globalThis, function createYydsMailUtils() {
const DEFAULT_YYDS_MAIL_BASE_URL = 'https://maliapi.215.im/v1';
const YYDS_MAIL_PROVIDER = 'yyds-mail';
function firstNonEmptyString(values) {
for (const value of values) {
if (value === undefined || value === null) continue;
const normalized = String(value).trim();
if (normalized) return normalized;
}
return '';
}
function normalizeYydsMailBaseUrl(rawValue = '') {
const value = String(rawValue || '').trim();
if (!value) return DEFAULT_YYDS_MAIL_BASE_URL;
const candidate = /^[a-zA-Z][a-zA-Z\d+\-.]*:\/\//.test(value)
? value
: `https://${value}`;
try {
const parsed = new URL(candidate);
if (!['http:', 'https:'].includes(parsed.protocol)) {
return DEFAULT_YYDS_MAIL_BASE_URL;
}
parsed.hash = '';
parsed.search = '';
const pathname = parsed.pathname === '/' ? '' : parsed.pathname.replace(/\/+$/, '');
return `${parsed.origin}${pathname}` || DEFAULT_YYDS_MAIL_BASE_URL;
} catch {
return DEFAULT_YYDS_MAIL_BASE_URL;
}
}
function normalizeYydsMailApiKey(value = '') {
return String(value || '').trim();
}
function normalizeYydsMailAddress(value = '') {
return String(value || '').trim().toLowerCase();
}
function buildYydsMailHeaders(config = {}, options = {}) {
const headers = {};
const apiKey = firstNonEmptyString([
options.apiKey,
options.includeConfigApiKey === false ? '' : config.apiKey,
options.includeConfigApiKey === false ? '' : config.yydsMailApiKey,
]);
const tempToken = firstNonEmptyString([
options.tempToken,
config.tempToken,
config.token,
]);
if (apiKey) {
headers['X-API-Key'] = apiKey;
}
if (tempToken) {
headers.Authorization = /^bearer\s+/i.test(tempToken)
? tempToken
: `Bearer ${tempToken}`;
}
if (options.json) {
headers['Content-Type'] = 'application/json';
}
if (options.acceptJson !== false) {
headers.Accept = 'application/json';
}
return headers;
}
function joinYydsMailUrl(baseUrl, path, params = {}) {
const normalizedBase = normalizeYydsMailBaseUrl(baseUrl);
const normalizedPath = String(path || '').trim();
const url = new URL(`${normalizedBase}${normalizedPath.startsWith('/') ? '' : '/'}${normalizedPath}`);
for (const [key, value] of Object.entries(params || {})) {
if (value === undefined || value === null || value === '') continue;
url.searchParams.set(key, String(value));
}
return url.toString();
}
function normalizeYydsMailInbox(payload = {}) {
const safePayload = payload && typeof payload === 'object' ? payload : {};
return {
id: firstNonEmptyString([safePayload.id, safePayload.inbox_id, safePayload.inboxId]),
address: normalizeYydsMailAddress(firstNonEmptyString([safePayload.address, safePayload.email])),
token: firstNonEmptyString([safePayload.token, safePayload.tempToken, safePayload.accessToken]),
expiresAt: firstNonEmptyString([safePayload.expiresAt, safePayload.expires_at]) || null,
isActive: safePayload.isActive !== undefined ? Boolean(safePayload.isActive) : true,
createdAt: firstNonEmptyString([safePayload.createdAt, safePayload.created_at]) || null,
raw: safePayload,
};
}
function normalizeYydsMailCurrentInbox(value = null) {
if (!value || typeof value !== 'object') return null;
const inbox = normalizeYydsMailInbox(value);
return inbox.address && inbox.token ? inbox : null;
}
function getYydsMailRows(payload) {
if (Array.isArray(payload)) return payload;
if (!payload || typeof payload !== 'object') return [];
const candidates = [
payload.messages,
payload.items,
payload.list,
payload.records,
payload.data?.messages,
payload.data?.items,
payload.data?.list,
payload.data?.records,
];
for (const candidate of candidates) {
if (Array.isArray(candidate)) {
return candidate;
}
}
return [];
}
function stripHtmlTags(value = '') {
return String(value || '')
.replace(/<style[\s\S]*?<\/style>/gi, ' ')
.replace(/<script[\s\S]*?<\/script>/gi, ' ')
.replace(/<[^>]+>/g, ' ')
.replace(/&nbsp;/gi, ' ')
.replace(/&amp;/gi, '&')
.replace(/&lt;/gi, '<')
.replace(/&gt;/gi, '>')
.replace(/\s+/g, ' ')
.trim();
}
function normalizeYydsMailSender(value = {}) {
if (typeof value === 'string') {
return { name: '', address: value };
}
const safeValue = value && typeof value === 'object' ? value : {};
return {
name: firstNonEmptyString([safeValue.name]),
address: firstNonEmptyString([safeValue.address, safeValue.email]),
};
}
function normalizeYydsMailRecipients(value) {
const list = Array.isArray(value) ? value : (value ? [value] : []);
return list.map((item) => {
if (typeof item === 'string') return { name: '', address: normalizeYydsMailAddress(item) };
const safeItem = item && typeof item === 'object' ? item : {};
return {
name: firstNonEmptyString([safeItem.name]),
address: normalizeYydsMailAddress(firstNonEmptyString([safeItem.address, safeItem.email])),
};
}).filter((item) => item.address);
}
function normalizeYydsMailCreatedAt(value = '') {
const source = firstNonEmptyString([value]);
if (!source) return '';
const parsed = Date.parse(source);
return Number.isFinite(parsed) ? new Date(parsed).toISOString() : source;
}
function normalizeYydsMailMessage(row = {}) {
if (!row || typeof row !== 'object') return null;
const from = normalizeYydsMailSender(row.from || row.sender);
const to = normalizeYydsMailRecipients(row.to || row.recipients || row.recipient);
const htmlValue = Array.isArray(row.html)
? row.html.join('\n')
: firstNonEmptyString([row.html, row.bodyHtml, row.body_html]);
const textValue = firstNonEmptyString([row.text, row.bodyText, row.body_text, row.bodyPreview, row.preview]);
const raw = firstNonEmptyString([row.raw, row.source]);
const bodyPreview = (textValue || stripHtmlTags(htmlValue) || stripHtmlTags(raw))
.replace(/\s+/g, ' ')
.trim();
return {
id: firstNonEmptyString([row.id, row.message_id, row.messageId]),
address: normalizeYydsMailAddress(firstNonEmptyString([
row.address,
row.mailbox,
to[0]?.address,
])),
inboxId: firstNonEmptyString([row.inboxId, row.inbox_id]),
subject: firstNonEmptyString([row.subject, row.title]),
from: {
name: from.name,
emailAddress: {
address: from.address,
},
},
to,
seen: Boolean(row.seen),
bodyPreview,
raw: raw || htmlValue || textValue || '',
text: textValue,
html: htmlValue,
receivedDateTime: normalizeYydsMailCreatedAt(firstNonEmptyString([
row.createdAt,
row.created_at,
row.receivedDateTime,
row.date,
])),
};
}
function normalizeYydsMailMessages(payload) {
return getYydsMailRows(payload)
.map((row) => normalizeYydsMailMessage(row))
.filter(Boolean);
}
function extractYydsMailVerificationCode(text) {
const source = String(text || '');
const matchCn = source.match(/(?:代码为|验证码[^0-9]*?)[\s：:]*(\d{6})/i);
if (matchCn) return matchCn[1];
const matchOpenAiLogin = source.match(/(?:chatgpt\s+log-?in\s+code|enter\s+this\s+code)[^0-9]{0,24}(\d{6})/i);
if (matchOpenAiLogin) return matchOpenAiLogin[1];
const matchChatGPT = source.match(/your\s+chatgpt\s+code\s+is\s+(\d{6})/i);
if (matchChatGPT) return matchChatGPT[1];
const matchEn = source.match(/code(?:\s+is|[\s:])+(\d{6})/i);
if (matchEn) return matchEn[1];
const matchStandalone = source.match(/\b(\d{6})\b/);
return matchStandalone ? matchStandalone[1] : null;
}
function normalizeYydsMailMessageDetail(payload = {}) {
const message = normalizeYydsMailMessage(payload);
if (!message) return null;
const combined = [
message.subject,
message.from?.emailAddress?.address,
message.bodyPreview,
message.text,
message.html,
message.raw,
].filter(Boolean).join(' ');
return {
...message,
bodyPreview: message.bodyPreview || stripHtmlTags(combined),
verification_code: extractYydsMailVerificationCode(combined) || '',
};
}
return {
DEFAULT_YYDS_MAIL_BASE_URL,
YYDS_MAIL_PROVIDER,
buildYydsMailHeaders,
extractYydsMailVerificationCode,
firstNonEmptyString,
joinYydsMailUrl,
normalizeYydsMailAddress,
normalizeYydsMailApiKey,
normalizeYydsMailBaseUrl,
normalizeYydsMailCurrentInbox,
normalizeYydsMailInbox,
normalizeYydsMailMessage,
normalizeYydsMailMessageDetail,
normalizeYydsMailMessages,
stripHtmlTags,
};
});