diff --git a/README.md b/README.md index 420da3d..6e88e08 100644 --- a/README.md +++ b/README.md @@ -19,10 +19,11 @@ ### 🇬🇧 Giffgaff eSIM工具 - **OAuth 2.0 PKCE认证** - 安全的身份验证流程 - **智能Cookie登录** - 支持免OAuth快速登录 -- **MFA多因子验证** - 邮件验证码支持 -- **手动激活引导** - 安全的官方激活流程 +- **MFA多因子验证** - 邮件/短信验证码支持 +- **短信验证码激活** - 全自动eSIM申请与激活(✅ 推荐) - **GraphQL API集成** - 完整的API调用链 - **LPA二维码生成** - 标准eSIM激活码 +- ~~**手动激活引导**~~ - 已于2025年10月8日停用 ### 🇳🇱 Simyo eSIM工具 - **账户登录验证** - 荷兰手机号格式验证 @@ -60,6 +61,37 @@ - **Simyo用户**: 新开卡享受[额外5欧元话费赠送](https://vriendendeal.simyo.nl/prepaid/AZzwPzb) - **Giffgaff用户**: 新开卡享受[额外5英镑话费赠送](https://www.giffgaff.com/orders/affiliate/mowal44_1653194386268) +## 📋 使用指南 + +### 🇬🇧 Giffgaff eSIM申请流程(推荐:短信验证码激活) +1. **身份验证** - OAuth登录或Cookie快速登录 +2. **邮件/短信验证** - 输入收到的MFA验证码 +3. **获取会员信息** - 自动获取账户信息 +4. **短信验证码激活** - 选择"短信验证码激活"(推荐) + - 点击"发送验证码" + - 输入收到的6位短信验证码 + - 系统自动完成预订、交换和激活 +5. **获取二维码** - 自动生成LPA激活码和二维码 + +> ✅ **推荐使用短信验证码激活**:全自动流程,无需手动操作 +> +> ⚠️ **已停用功能**:手动激活方式已于2025年10月8日被官方修复停用 +> +> 📖 **详细教程**:查看 [Giffgaff使用教程](./docs/User_Guide.md) 获取图文并茂的完整操作指南 + +### 🇳🇱 Simyo eSIM申请流程 +1. **账户登录** - 输入荷兰手机号(06开头)和密码 +2. **选择服务** - 新申请或设备更换 +3. **验证码处理** - 短信或客服验证码验证 +4. **获取配置** - 系统生成eSIM配置信息 +5. **扫码安装** - 使用生成的二维码在新设备上安装 + +### 📚 详细文档 +- **[Giffgaff使用教程](./docs/User_Guide.md)** - 图文并茂的完整操作指南(推荐优先阅读) +- [Giffgaff详细说明](./docs/reference/README_giffgaff_esim.md) +- [Simyo详细说明](./docs/reference/README_simyo_esim.md) +- [性能优化指南](./docs/PERFORMANCE.md) + ## 🚀 本地部署 ### 快速开始 @@ -151,41 +183,17 @@ npm start # 访问 http://localhost:3000 ``` -## 📋 使用指南 - -### 🇬🇧 Giffgaff eSIM申请流程 -1. **身份验证** - OAuth登录或Cookie快速登录 -2. **邮件验证** - 输入收到的MFA验证码 -3. **申请eSIM** - 系统预留RESERVED状态的eSIM卡 -4. **手动激活** - 访问 `https://www.giffgaff.com/activate` - - 输入显示的 `activationCode` - - 点击"Activate your SIM" - - 确认"Yes, I want to replace my SIM" -5. **获取二维码** - 返回页面完成LPA激活码生成 - -> ⚠️ **重要提示**: 激活过程中请保持页面开启,避免会话过期 - -### 🇳🇱 Simyo eSIM申请流程 -1. **账户登录** - 输入荷兰手机号(06开头)和密码 -2. **选择服务** - 新申请或设备更换 -3. **验证码处理** - 短信或客服验证码验证 -4. **获取配置** - 系统生成eSIM配置信息 -5. **扫码安装** - 使用生成的二维码在新设备上安装 - -### 📚 详细文档 -- [Giffgaff详细说明](./docs/reference/README_giffgaff_esim.md) -- [Simyo详细说明](./docs/reference/README_simyo_esim.md) -- [性能优化指南](./docs/PERFORMANCE.md) -- [Giffgaff使用教程](./docs/User_Guide.md) - ## ❓ 常见问题 ### Giffgaff相关 -**Q: 为什么需要手动激活?** -A: 出于安全合规考虑,eSIM激活需在官方页面完成。工具会展示激活码并提供详细引导。 +**Q: 推荐使用哪种激活方式?** +A: 推荐使用"短信验证码激活",全自动流程,只需输入短信验证码即可完成所有步骤。 -**Q: 激活后多久能获得二维码?** -A: 通常数十秒至几分钟。完成手动激活后返回页面,系统自动生成LPA二维码。 +**Q: 短信验证码激活需要多久?** +A: 通常1-2分钟即可完成。发送验证码→输入验证码→自动完成预订、交换和激活→获取二维码。 + +**Q: 手动激活方式还能用吗?** +A: 手动激活方式已于2025年10月8日被Giffgaff官方修复停用,请使用短信验证码激活。 **Q: 误关页面怎么办?** A: 重新登录后系统会从可恢复节点继续。建议激活完成前保持页面开启。 diff --git a/docs/User_Guide.md b/docs/User_Guide.md index 13528f9..a6242d5 100644 --- a/docs/User_Guide.md +++ b/docs/User_Guide.md @@ -45,32 +45,17 @@ OAuth方式需要获取回调URL,获取方式参考页面说明: 点击"获取会员信息",跳转到第四步申请/激活eSIM: -![申请/激活eSIM](image/108.jpg) +![申请/激活eSIM](image/114.jpg) ## 5. 选择并激活eSIM -选择手动激活并选择预定eSIM,会自动预定新空卡: +选择短信验证码激活并输入短信验证码,会自动完成更换eSIM并生成QR码和LPA信息: -![选择eSIM](image/109.jpg) +![验证码页面](image/115.jpg) -然后按照提示打开激活页面进行操作: +交换成功将跳转第五步显示QR码和LPA信息: -![激活页面](image/110.jpg) +![eSIM信息](image/116.jpg) +![eSIM信息1](image/117.jpg) -在激活页面输入上一步获取到的6位激活码并点击"激活": - -![输入激活码](image/111.jpg) - -然后会跳转新页面确认旧卡信息和新卡信息: - -![确认卡信息](image/112.png) - -再次确认信息: - -![再次确认信息](image/113.png) - -## 6. 完成激活 - -会跳转到giffgaff首页,此刻返回eSIM更换网页,点击"我已完成手动激活,继续下一步"。 - -会自动跳转到第五步,获取eSIM的LPA信息和QR码。 \ No newline at end of file +## 6. 使用原生eSIM手机完成扫码 \ No newline at end of file diff --git a/docs/image/114.jpg b/docs/image/114.jpg new file mode 100644 index 0000000..34bbb93 Binary files /dev/null and b/docs/image/114.jpg differ diff --git a/docs/image/115.jpg b/docs/image/115.jpg new file mode 100644 index 0000000..208ea54 Binary files /dev/null and b/docs/image/115.jpg differ diff --git a/docs/image/116.jpg b/docs/image/116.jpg new file mode 100644 index 0000000..0163a95 Binary files /dev/null and b/docs/image/116.jpg differ diff --git a/docs/image/117.jpg b/docs/image/117.jpg new file mode 100644 index 0000000..c003b00 Binary files /dev/null and b/docs/image/117.jpg differ