d9dfc73986
- 简化 README.md 的标题和章节样式，移除冗余 emoji 图标，添加原生 ES6 模块架构说明，调整描述文字使其更简洁清晰 - 优化了四个语言版本的 QR Code API 文档（中英文 Giffgaff 和 Simyo），将原来的简单描述更新为详细的三级回退链说明，包含每个服务商的 5 超时机制和 LPA 字符串降级方案 - 在 docs/ARCHITECTURE.md 中新增模块依赖关系图和关键设计决策说明，补充 BFF 模式、无框架设计、中间件统一等架构要点 - 将英文用户指南中的视频和提示信息移至附录章节，改进文档阅读体验；删除中英文用户指南顶部的视频占位内容 - 修正 CORS_SOLUTION.md 中的脚本路径引用，添加 `scripts/` 前缀使其与实际文件结构一致 - 清理 SECURITY.md 中重复的 CSP 说明，精简为单条以 server.js 为基准的说明；在通知系统文档顶部增加快速摘要说明；在 CLAUDE.md 中补充缺失的 `cors.js` 相关文件引用
4.5 KiB
Giffgaff User Guide
🌐 中文版
1. Open Giffgaff eSIM Replacement Web Page
Visit the eSIM Tools website and select the Giffgaff eSIM tool.
2. Select Login Method
Choose OAuth or Cookies login method (OAuth method is recommended)
OAuth Login
OAuth method requires obtaining the callback URL. For instructions on how to get it, please refer to the page instructions:
- First, open the login page for the giffgaff website on a new tab:
https://www.giffgaff.comand log in. - After logging in, return to the eSIM replacement page and open the developer tools: press F12 or right-click and select “Inspect” to switch to the “Console” tab.
- Click the “Start OAuth Login” button at the bottom; once the new window opens, switch back to the eSIM replacement page.
- Look for the error message in the console: “Failed to launch ‘giffgaff://auth/callback/…’”. Copy the callback URL from that line.
- Enter the obtained callback URL into the corresponding input box on the eSIM replacement page and click "Process Callback"
3. MFA Authentication
After processing the callback, you will be automatically redirected to the second step, select email/SMS verification code method to obtain MFA authentication:
Enter the obtained verification code and click "Verify":
4. Get Member Information
After successful verification, you will be automatically redirected to the third step, the get Giffgaff member information page:
Click "Get Member Information" to go to the fourth step of converting/activating eSIM:
5. Select and Activate eSIM
Step 4 offers three activation methods. Choose the one that fits your situation:
Method 1: SMS Verification Code Activation (Recommended)
Select SMS verification code activation and enter the SMS verification code, the system will automatically complete the eSIM replacement and generate QR code and LPA information:
Method 2: Fetch eSIM Directly (For New-Purchase Users)
⚠️ This feature could not be fully tested by the author due to eligibility constraints. If you encounter issues, please open the browser console (F12 → Console), copy the full log, and submit it via GitHub Issues.
If you have already paid £10 in the official Giffgaff app but did not receive an eSIM, use this method:
- Click the "Fetch eSIM directly" card
- Click the "Fetch my eSIM" button
- The system will fetch the existing eSIM on your account and generate a QR code
- If multiple downloadable eSIMs are found on your account, a selection list will appear — pick the one you need and click confirm
This method requires no SMS verification code and skips the reserveESim / swapSim flow — it directly retrieves the QR code.
Method 3: Manual Activation (Paused)
Manual activation has been paused by Giffgaff. Please use one of the methods above.
After successful exchange, you will be redirected to the fifth step showing QR code and LPA information:
6. Use Native eSIM Phone to Complete Scanning
- Open your phone's Settings → Cellular / Mobile Network
- Select Add eSIM / Scan QR Code
- Scan the QR code displayed on the page
- Confirm installation and wait for eSIM activation to complete
- Once activated, you will see the new number in your cellular network settings
Appendix: Video Tutorial
⚠️ The video tutorial has not been updated. For information on how to obtain the OAuth callback URL, please refer to the text tutorial above.