lywsvip/eSIM-Tools

Fork 0

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

Files

Abner c754dca22f 📝 docs(readme): README 增加 GitHub FAQ Issue #88 链接

2026-08-06 14:26:06 +08:00

9.7 KiB

Raw Permalink Blame History

eSIM Tools 🚀

🇺🇸 English Version

📱 这是什么？

eSIM Tools 是一个免费的在线工具，帮助 已有 Giffgaff 或 Simyo 号码的用户：

🔄 将物理 SIM 卡转换为 eSIM（无需换卡）
📲 更换设备时快速转移 eSIM
📷 生成 eSIM 二维码，扫码即可激活

💡 1-2 分钟即可完成，无需联系客服，全程自动化

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

🎁 新用户优惠

如果你还没有号码，可以通过以下链接注册并获得话费赠送：

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

✨ 适合谁用？

🇬🇧 Giffgaff 用户

✅ 已有 Giffgaff 号码（英国运营商）
✅ 想把物理 SIM 卡换成 eSIM
✅ 换新手机需要重新激活 eSIM
❌ 新用户申请号码（需先通过官方或第三方获取号码）

🇳🇱 Simyo 用户

✅ 已有 Simyo 号码（荷兰运营商，06 开头）
✅ 需要更换设备或转换为 eSIM
❌ 新用户申请号码（需先通过官方 APP 注册）

🚀 快速开始

在线使用（推荐）

👉 访问：https://esim.cosr.eu.org

✅ 无需安装，打开即用
✅ 支持所有功能，定期更新
✅ 支持离线使用，数据本地处理

使用流程

🇬🇧 Giffgaff（推荐：短信验证码激活）

登录账户 - 选择安全登录方式
邮件/短信验证 - 输入收到的验证码
短信验证码激活 - 输入 6 位短信验证码
获取二维码 - 自动生成，扫码即可激活

📖 图文教程：Giffgaff 使用教程（含视频演示）

🇳🇱 Simyo

账户登录 - 输入手机号（06 开头）和密码
选择服务 - 设备更换或获取现有 eSIM
验证码确认 - 输入短信验证码
扫码安装 - 使用生成的二维码在新设备上安装

🖼️ 界面预览

主页

Giffgaff eSIM 工具

Simyo eSIM 工具

❓ 常见问题

📌 更多用户反馈与排查方案，详见 GitHub FAQ Issue #88（使用前建议先查阅）

Giffgaff 相关

Q: 推荐使用哪种激活方式？

A: 推荐"短信验证码激活"，全自动流程，只需输入短信验证码即可完成所有步骤。

Q: 需要多久完成？

A: 通常 1-2 分钟。发送验证码 → 输入验证码 → 自动激活 → 获取二维码。

Q: 手动激活方式还能用吗？

A: 手动激活已于 2025 年 10 月 8 日被 Giffgaff 官方停用，请使用短信验证码激活。

Q: 误关页面怎么办？

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

Q: 什么时间可以激活？

A: Giffgaff 服务窗口为英国时间 04:30 - 21:30。窗口外操作可能失败，页面会显示本地时间与英国时间对比。

Q: 支持哪些设备？

Apple: iPhone XS/XR 及更新机型、iPhone SE 2 及更新
Android: Samsung Galaxy S20+、Google Pixel 3+、部分 OnePlus/华为机型
详细兼容性请查看设备说明书

Simyo 相关

Q: 支持哪些手机号格式？

A: 仅支持荷兰手机号（06 开头的 10 位数字）。

Q: 验证码收不到怎么办？

A: 可选择客服验证码选项，或检查短信拦截设置。

安全与隐私

Q: 数据安全吗？

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

🛠️ 本地部署（开发者）

点击展开查看部署说明

快速开始

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

# 2. 安装依赖
npm install

# 3. 配置环境变量
cp env.example .env
# 编辑 .env 填写必要配置

# 4. 启动开发服务器
npm run dev

# 5. 访问 http://localhost:3000

环境要求

Node.js >= 18.0.0
npm >= 8.0.0
现代浏览器: Chrome 88+, Firefox 85+, Safari 14+, Edge 88+

Netlify 部署

Fork 此仓库到你的 GitHub 账户
在 Netlify 中连接 GitHub 仓库
构建设置：
- Build command: npm run build
- Publish directory: dist
配置环境变量（参考 env.example）
部署完成

📚 详细文档

使用教程
- Giffgaff 使用教程 | English
技术参考（开发者）
- 通知系统使用指南
- 安全指南

🔧 技术特性

🚀 极简设计 - 原生 JavaScript，无框架依赖，打包体积小
⚡ 快速响应 - 全球 CDN 加速，首屏加载 < 1.2 秒
🔒 隐私安全 - 所有数据本地处理，不上传服务器
📦 离线可用 - 支持断网使用，网络波动不影响操作
🎯 现代标准 - PWA、Web Vitals 优化，移动端友好

💻 开发者文档: 查看通知系统指南和安全指南

🤝 贡献指南

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

参与方式

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

提交规范

# 格式：<emoji> <type>(scope): <中文描述>
✨ feat(auth): 新增登录态自动续期
🐛 fix(simyo): 修复验证码重试逻辑
📝 docs(readme): 更新安装说明

可用命令：

npm run hooks:install - 安装 Git 钩子
npm test - 运行测试
npm run quality-check - 代码质量检查
npm run security-check - 安全扫描

📞 支持与反馈

遇到问题或有建议？

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

📈 Star History

🤝 贡献者公约

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

许可证

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

免责声明

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

_{Made with ❤️ by Silentely}

9.7 KiB Raw Permalink Blame History Unescape Escape