it ok

2026-04-19 03:44:38 +08:00
parent 914dd8f2a5
commit a92455bb5f
6 changed files with 753 additions and 321 deletions
@@ -0,0 +1,87 @@
+# 163 Mail Body Fallback Implementation Plan
+
+> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
+
+**Goal:** Let the 163 mailbox provider read verification codes from opened email bodies when the inbox list does not show the code inline.
+
+**Architecture:** Keep the existing list-first polling flow in `content/mail-163.js`, then add a provider-local fallback that opens candidate messages, reads body text, and returns to the inbox before continuing. Do not add `targetEmail` filtering in this change.
+
+**Tech Stack:** Manifest V3 Chrome extension, plain JavaScript content scripts, Node built-in test runner
+
+---
+
+### Task 1: Lock the regression with a failing test
+
+**Files:**
+- Create: `D:\github\codex-oauth-automation-extension-Pro2.0\tests\mail-163-content.test.js`
+- Test: `D:\github\codex-oauth-automation-extension-Pro2.0\tests\mail-163-content.test.js`
+
+- [ ] **Step 1: Write the failing test**
+
+```js
+test('handlePollEmail opens a matching 163 message and reads the body when the list row has no inline code', async () => {
+  const bundle = extractFunction('handlePollEmail');
+  const api = new Function(`...`)();
+  const result = await api.handlePollEmail(8, {
+    senderFilters: ['openai'],
+    subjectFilters: ['chatgpt'],
+    maxAttempts: 1,
+    intervalMs: 1,
+  });
+  assert.equal(result.code, '480382');
+});
+```
+
+- [ ] **Step 2: Run test to verify it fails**
+
+Run: `node --test tests/mail-163-content.test.js`
+Expected: FAIL because `handlePollEmail` never opens the message body.
+
+### Task 2: Add the 163 opened-mail fallback
+
+**Files:**
+- Modify: `D:\github\codex-oauth-automation-extension-Pro2.0\content\mail-163.js`
+- Test: `D:\github\codex-oauth-automation-extension-Pro2.0\tests\mail-163-content.test.js`
+
+- [ ] **Step 1: Add minimal helpers**
+
+```js
+function findInboxLink() { /* find the 163 inbox entry */ }
+async function returnToInbox() { /* restore inbox list view */ }
+function readOpenedMailText() { /* read visible detail text and iframe text */ }
+async function openMailAndGetMessageText(item) { /* open, read, return */ }
+```
+
+- [ ] **Step 2: Update `handlePollEmail`**
+
+```js
+if (!code) {
+  const openedText = await openMailAndGetMessageText(item);
+  const bodyCode = extractVerificationCode(openedText);
+  if (bodyCode) {
+    return { ok: true, code: bodyCode, emailTimestamp: Date.now(), mailId: id };
+  }
+}
+```
+
+- [ ] **Step 3: Run the targeted test**
+
+Run: `node --test tests/mail-163-content.test.js`
+Expected: PASS
+
+### Task 3: Verify no regressions in adjacent polling logic
+
+**Files:**
+- Test: `D:\github\codex-oauth-automation-extension-Pro2.0\tests\mail-163-content.test.js`
+- Test: `D:\github\codex-oauth-automation-extension-Pro2.0\tests\verification-flow-polling.test.js`
+
+- [ ] **Step 1: Run the local regression slice**
+
+Run: `node --test tests/mail-163-content.test.js tests/verification-flow-polling.test.js`
+Expected: PASS
+
+- [ ] **Step 2: Update docs only if behavior scope changed**
+
+```md
+No root docs update is required if the change stays inside existing 163 polling behavior and does not alter the documented top-level flow.
+```