mirror of https://github.com/Silentely/eSIM-Tools.git synced 2026-09-03 06:24:20 +08:00

Files

Abner 500140cd1b ✨ feat: 添加 Netlify 徽章并引入贡献者公约

- 在页面底部添加 Netlify 部署徽章，包含悬停效果和无障碍访问支持
- 创建 CODE_OF_CONDUCT.md 文件，采用 Contributor Covenant 3.0 行为准则
- 更新英文 README 文件，添加行为准则链接说明
- 删除不再使用的 runtime-common.sh 脚本文件，简化项目结构

2026-05-19 10:28:41 +08:00

13 KiB

Raw Blame History

eSIM Tools 🚀

专为已有 Giffgaff 和 Simyo 号码的用户设计的现代化 eSIM 管理工具集，支持将物理 SIM 卡转换为 eSIM、设备更换和二维码生成。

🇺🇸 English Version

✨ 功能特性

🇬🇧 Giffgaff eSIM工具

OAuth 2.0 PKCE认证 - 安全的身份验证流程
智能Cookie登录 - 支持免OAuth快速登录
MFA多因子验证 - 邮件/短信验证码支持
短信验证码激活 - 全自动eSIM转换与激活（✅ 推荐）
GraphQL API集成 - 完整的API调用链
LPA二维码生成 - 标准eSIM激活码
~~手动激活引导~~ - 已于2025年10月8日停用

🇳🇱 Simyo eSIM工具

账户登录验证 - 荷兰手机号格式验证
设备更换支持 - 完整的SIM卡更换流程
短信验证码 - 自动发送和验证处理
即时二维码生成 - 一键生成可扫描激活码
安装确认 - 确保eSIM正确激活

🖼️ 界面预览

下方为主要页面的功能截图预览，便于快速了解工具界面与核心操作路径。

主页

Giffgaff eSIM 工具

Simyo eSIM 工具

🌐 在线使用

🚀 在线服务（推荐）

完整版本: https://esim.cosr.eu.org

✅ 支持所有eSIM操作和流程
✅ 性能优化，支持离线使用
✅ 定期更新维护

⚠️ 适用范围说明：本工具仅支持已有 Giffgaff 或 Simyo 号码的用户进行 eSIM 设备更换或物理 SIM 转 eSIM，不支持新用户直接申请号码。如需新开卡获取 eSIM，Giffgaff 用户可通过第三方修改版 APK/模块获取 eSIM 二维码后直接扫码激活，Simyo 用户请通过官方 APP 操作。

🎁 新用户优惠

Simyo用户: 新开卡享受额外5欧元话费赠送
Giffgaff用户: 新开卡享受额外5英镑话费赠送

📋 使用指南

🇬🇧 Giffgaff eSIM 转换流程（推荐：短信验证码激活）

身份验证 - OAuth登录或Cookie快速登录
邮件/短信验证 - 输入收到的MFA验证码
获取会员信息 - 自动获取账户信息
短信验证码激活 - 选择"短信验证码激活"（推荐）
- 点击"发送验证码"
- 输入收到的6位短信验证码
- 系统自动完成预订、交换和激活
获取二维码 - 自动生成LPA激活码和二维码

✅ 推荐使用短信验证码激活：全自动流程，无需手动操作

⚠️ 已停用功能：手动激活方式已于2025年10月8日被官方修复停用

📖 详细教程：查看 Giffgaff使用教程获取图文及视频完整操作指南

🇳🇱 Simyo eSIM 设备更换流程

账户登录 - 输入荷兰手机号(06开头)和密码
选择服务 - 设备更换或直接获取已有 eSIM
验证码处理 - 短信或客服验证码验证
获取配置 - 系统生成eSIM配置信息
扫码安装 - 使用生成的二维码在新设备上安装

📚 详细文档

🚀 本地部署

快速开始

克隆仓库

git clone https://github.com/Silentely/eSIM-Tools.git
cd eSIM-Tools

安装依赖
```
npm install
```
启动开发服务器
```
npm start
```
访问应用
```
http://localhost:3000
```

环境要求

现代浏览器: Chrome 88+, Firefox 85+, Safari 14+, Edge 88+
开发环境: Node.js >= 18.0.0, npm >= 8.0.0 (仅本地开发需要)

🔧 技术架构

前端技术栈

HTML5/CSS3 - 响应式设计，现代化UI
JavaScript ES6+ - 模块化架构，现代语法特性
Bootstrap 5 - 响应式UI框架
Service Worker - 离线支持和缓存优化

后端架构

生产环境: Netlify Functions - 无服务器函数处理API代理
开发环境: Node.js Express - 本地开发服务器
CORS处理 - 统一跨域请求解决方案
会话管理 - 安全的本地存储和自动过期机制

🚀 性能优化

资源压缩: Webpack + TerserPlugin，压缩率65%+
Service Worker: 离线缓存和网络状态监控
图片优化: WebP格式支持，自动压缩
代码分割: 自动分离第三方库，减少初始加载时间

详细性能优化说明请参考 ARCHITECTURE.md

服务时间说明

Giffgaff服务窗口: 英国时间 04:30 – 21:30 (Europe/London)
窗口外操作: 可能失败或不稳定，UI会显示本地时间与英国时间对比

📦 部署方式

🌟 推荐：在线服务

使用托管版本 https://esim.cosr.eu.org

无需部署配置，即开即用
自动更新，稳定可靠
完整功能支持

🔧 自建部署：Netlify

Fork此仓库到您的GitHub账户
在Netlify中连接GitHub仓库
构建设置：
- Build command: echo 'No build needed'
- Publish directory: .
部署完成，获得您的专属域名

⚙️ 本地开发

# 克隆仓库
git clone https://github.com/Silentely/eSIM-Tools.git
cd eSIM-Tools

# 安装依赖并启动
npm install
npm start

# 访问 http://localhost:3000

❓ 常见问题

Giffgaff相关

Q: 推荐使用哪种激活方式？ A: 推荐使用"短信验证码激活"，全自动流程，只需输入短信验证码即可完成所有步骤。

Q: 短信验证码激活需要多久？ A: 通常1-2分钟即可完成。发送验证码→输入验证码→自动完成预订、交换和激活→获取二维码。

Q: 手动激活方式还能用吗？ A: 手动激活方式已于2025年10月8日被Giffgaff官方修复停用，请使用短信验证码激活。

Q: 误关页面怎么办？ A: 重新登录后系统会从可恢复节点继续。建议激活完成前保持页面开启。

Simyo相关

Q: 支持哪些手机号格式？ A: 仅支持荷兰手机号（06开头的10位数字）。

Q: 验证码收不到怎么办？ A: 可选择客服验证码选项，或检查短信拦截设置。

⚠️ 重要说明

适用范围

Giffgaff: 英国已有号码用户，支持物理 SIM 转 eSIM 及设备更换。新用户需先通过官方或第三方方式获取号码和 eSIM 二维码。
Simyo: 荷兰已有号码用户（06开头手机号），支持设备更换。新用户需先通过官方渠道注册号码。

安全与隐私

✅ 所有数据处理均在本地进行
✅ 不存储用户凭据信息
✅ 建议在安全网络环境下使用
✅ 开源透明，代码可审计

📁 项目结构

eSIM-Tools/
├── 📄 index.html                 # 主页面
├── 🖥️ server.js                  # 本地开发服务器
├── 📦 package.json               # 项目配置
├── 📂 src/                       # 源代码
│   ├── 🇬🇧 giffgaff/             # Giffgaff工具
│   ├── 🇳🇱 simyo/                # Simyo工具
│   ├── 🎨 styles/                # 样式文件
│   └── ⚙️ js/                    # JavaScript模块
├── 🌐 netlify/                   # 无服务器函数
│   └── functions/                # API代理
├── 📚 docs/                      # 项目文档
│   ├── guides/                   # 使用指南
│   ├── reference/                # 参考文档
│   └── fixes/                    # 问题修复
├── 🧪 tests/                     # 测试文件
└── 🛠️ scripts/                   # 部署脚本

跨域解决方案

🌟 推荐: 使用在线服务 esim.cosr.eu.org
🔧 Netlify Functions: 自动API代理
💻 本地代理: Node.js开发服务器
📖 详细说明: CORS解决方案文档

🧪 测试

项目包含完整的测试套件：

单元测试 - 核心函数和模块测试
集成测试 - API调用和流程测试
端到端测试 - 完整用户流程验证

# 运行测试套件
npm test

# 在浏览器中测试
open tests/test_giffgaff_esim.html
open tests/test_simyo_esim.html

🤝 贡献指南

欢迎贡献代码和提出建议！

参与方式

🍴 Fork项目仓库
🌿 创建功能分支 (git checkout -b feature/AmazingFeature)
💾 按规范提交 (git commit -m '✨ feat(core): 新增二维码缓存逻辑')
📤 推送分支 (git push origin feature/AmazingFeature)
🔃 创建Pull Request

开发规范

遵循现有代码风格
添加必要的测试用例
更新相关文档

提交信息规范（emoji + 中文）

启用仓库钩子：npm run hooks:install
提交格式：<emoji> <type>(optional-scope): <中文描述>
type 可选值：feat、fix、docs、style、refactor、perf、test、build、ci、chore、revert
emoji 与 type 不强制匹配，但都必须来自支持列表

示例：

✨ feat(auth): 新增登录态自动续期
🐛 fix(simyo): 修复验证码重试逻辑
📝 docs(readme): 更新安装说明

当前 Git 钩子

pre-commit：提交前先同步远程更新（有 upstream 时自动 git pull --rebase --autostash），再格式化 staged 文件并执行 JS/JSON 语法检查与智能引号拦截
pre-push：默认快速模式（pre-commit + 相关测试），无差异文件时回退全量测试
prepare-commit-msg：提交信息为空时自动填充模板
commit-msg：校验提交信息格式（emoji + type + 中文描述，emoji/type 合法即可）

可用命令：

查看钩子列表：npm run hooks:list
手动执行提交前检查：npm run precommit:check
手动执行推送前全量检查：npm run prepush:check
手动执行推送前快速检查：npm run prepush:check:fast

📞 支持与反馈

遇到问题或有建议？

📋 提交Issue
📖 查看项目文档
💬 参与社区讨论

📈 历史 Star 数

贡献者公约

本项目遵循贡献者公约行为准则。

📄 许可证

本项目的所有代码除另有说明外,均按照 MIT License 发布。
本项目的README.md，wiki等资源基于 CC BY-NC-SA 4.0 这意味着你可以拷贝、并再发行本项目的内容，
但是你将必须同样提供原作者信息以及协议声明。同时你也不能将本项目用于商业用途，按照我们狭义的理解
(增加附属条款)，凡是任何盈利的活动皆属于商业用途。
请在遵守当地相关法律法规的前提下使用本项目。

⚖️ 免责声明

本工具仅供学习和个人使用，请遵守相关服务条款。使用本工具产生的任何问题，开发者不承担责任。请在遵守当地法律法规的前提下使用。

_{Made with ❤️ by Silentely}

13 KiB Raw Blame History Unescape Escape