mirror of
https://github.com/Silentely/eSIM-Tools.git
synced 2026-09-03 06:24:20 +08:00
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` 相关文件引用
3.7 KiB
3.7 KiB
giffgaff 使用教程
1. 打开giffgaff的eSIM更换网页
访问eSIM Tools网站，选择Giffgaff eSIM工具。
2. 选择登录方式
选择 OAuth 或者 Cookies 方式登录（推荐 OAuth 方式）
OAuth方式登录
OAuth方式需要获取回调URL，获取方式参考页面说明：
- 首先请在新标签页打开giffgaff官网的登录页面：'https://www.giffgaff.com' 进行登录
- 登录完成后返回eSIM更换页面，打开开发者工具：按 F12 或右键选择"检查"切换到"控制台"（Console）标签页
- 点击下方"开始OAuth登录"按钮，新窗口打开后切换回eSIM更换页面
- 在控制台中查找错误信息：Failed to launch 'giffgaff://auth/callback/...'，复制该行中的回调URL
- 将获取到的回调URL输入到eSIM更换网页相应的输入框中，点击"处理回调"
3. MFA认证
处理回调后会自动跳转到第二步，选择邮件/手机验证码方式获取MFA认证：
输入获取到的验证码，点击"验证"：
4. 获取会员信息
验证通过后会自动跳转到第三步，获取giffgaff会员信息页面：
点击"获取会员信息"，跳转到第四步转换/激活eSIM：
5. 选择并激活eSIM
第四步提供三种激活方式，请根据自身情况选择：
方式一：短信验证码激活（推荐）
选择短信验证码激活并输入短信验证码，会自动完成更换eSIM并生成QR码和LPA信息：
方式二：已支付直取 eSIM（已付款用户专用）
⚠️ 作者因条件不符未能实测此功能。如遇到问题，请打开浏览器开发者工具（F12 → Console），复制完整日志后到 GitHub Issues 提交反馈。
如果您已在 Giffgaff 官方 App 完成 10 英镑付款，但 App 未成功生成 eSIM，可以选择此方式：
- 点击"已支付直取 eSIM"卡片
- 点击"拉取我的 eSIM"按钮
- 系统将直接拉取账户上已存在的 eSIM 并生成二维码
- 如果账户存在多个可下载的 eSIM，系统会显示选择列表，请选择需要的 eSIM 后点击确认
此方式无需短信验证码，跳过 reserveESim / swapSim 流程，直接获取 QR 码。
方式三：手动激活（已暂停）
官方已暂停手动激活通道，请使用上述两种方式。
交换成功将跳转第五步显示QR码和LPA信息：
6. 使用原生 eSIM 手机完成扫码
- 打开手机的设置 → 蜂窝网络 / 移动网络
- 选择添加 eSIM / 扫描二维码
- 扫描页面上显示的 QR 码
- 确认安装，等待 eSIM 激活完成
- 激活成功后可在蜂窝网络设置中看到新的号码
附录：视频教程
⚠️ 视频教程未更新，其中 OAuth 获取回调 URL 的方式请以上方文字教程为准。