docs: document YYDS Mail provider integration

项目完整链路说明.md

@@ -172,6 +172,7 @@
 - 标签注册表
 - 最近打开的来源地址
 - LuckMail 当前运行时选择
+- YYDS Mail 当前运行时邮箱 `currentYydsMailInbox`，保存本轮创建得到的最终邮箱地址和临时 Bearer token
 - 2925 当前选中的账号 ID `currentMail2925AccountId`（运行时会同步到持久配置，用于重开浏览器后恢复同一个号池账号）
 
 补充：
@@ -190,6 +191,7 @@
 - PayPal 账号池配置 `paypalAccounts / currentPayPalAccountId`，以及供后台步骤兼容读取的 `paypalEmail / paypalPassword`
 - 邮箱 provider 配置
 - Cloud Mail / SkyMail API 配置：`cloudMailBaseUrl / cloudMailAdminEmail / cloudMailAdminPassword / cloudMailToken / cloudMailReceiveMailbox / cloudMailDomain / cloudMailDomains`
+- YYDS Mail API 配置：`yydsMailApiKey / yydsMailBaseUrl`；reset 会保留这两个持久配置，但清空 `currentYydsMailInbox`，确保下一轮重新创建临时邮箱
 - Hotmail 账号池
 - 2925 账号池
 - 2925 是否启用号池模式 `mail2925UseAccountPool`
@@ -681,6 +683,7 @@ Plus 模式可见步骤：
 - Cloudflare
 - Cloudflare Temp Email
 - Cloud Mail
+- YYDS Mail
 - 自定义邮箱池
 - iCloud 隐私邮箱
 
@@ -707,6 +710,26 @@ Plus 模式可见步骤：
 4. 邮件读取统一走 `/api/public/emailList`，返回数据先经 `cloudmail-utils.js` 归一化，再复用现有验证码匹配与时间窗过滤逻辑。
 5. 如果 Token 失效，后台会尝试重新登录刷新 Token 后重试当前 API 请求。
 
+### 7.1.2 YYDS Mail
+
+组成：
+
+- [yyds-mail-utils.js](c:/Users/projectf/Downloads/codex注册扩展/yyds-mail-utils.js)
+- [background/yyds-mail-provider.js](c:/Users/projectf/Downloads/codex注册扩展/background/yyds-mail-provider.js)
+- [background/verification-flow.js](c:/Users/projectf/Downloads/codex注册扩展/background/verification-flow.js)
+- [sidepanel/sidepanel.html](c:/Users/projectf/Downloads/codex注册扩展/sidepanel/sidepanel.html)
+- [sidepanel/sidepanel.js](c:/Users/projectf/Downloads/codex注册扩展/sidepanel/sidepanel.js)
+
+链路：
+
+1. 侧栏在 `Mail = YYDS Mail` 时只展示 `API Key` 与 `Base URL`，不展示普通邮箱生成、转发邮箱或账号池配置。
+2. 持久配置只保存 `yydsMailApiKey / yydsMailBaseUrl`；本轮真实邮箱和临时 token 只保存在运行态 `currentYydsMailInbox`。
+3. 手动点击“获取”、Step 3 需要生成邮箱、或 Auto 每轮准备邮箱时，后台通过 `POST /accounts` 创建邮箱，请求头使用 `X-API-Key`，请求体只发送自动生成或用户传入的 `localPart`。
+4. 创建成功后以后端返回的最终 `address` 为准回写 `email / registrationEmailState`，并把返回的 `token` 写入 `currentYydsMailInbox`，Step 8 `add-email` 的手机号身份链路仍通过共享注册邮箱状态持久化保留 `signupPhone* / accountIdentifier*`。
+5. Step 4 / Step 8 轮询验证码时，`background/verification-flow.js` 会把 `provider = yyds-mail` 路由到后台 provider；后台用临时 token 发送 `Authorization: Bearer <token>` 调用 `/messages` 与 `/messages/{id}`，再复用现有验证码匹配、时间窗、排除旧验证码等规则。
+6. 平台验证完成后的成功收尾会清空 `currentYydsMailInbox` 与当前邮箱运行态，下一轮重新创建新的 YYDS Mail 邮箱。
+7. `reset` 保留 YYDS Mail 的 API Key / Base URL 配置，但清空当前邮箱运行态，避免旧临时 token 被下一轮误用。
+
 ### 7.2 Hotmail
 
 组成：