mirror of https://github.com/Silentely/eSIM-Tools.git synced 2026-09-06 07:47:27 +08:00

Files

Abner 3eb8550631 📝 docs: 精简用户文档并移除冗余技术参考

- 精简 README.md/README_EN.md 技术架构部分（-74%）
  - 移除详细技术栈列表（Webpack、Babel、Jest 等）
  - 改为 6 个用户友好的特性卖点
  - 保留开发者文档引导链接
- 修复中英文切换链接（添加 ./ 前缀）
- 更新 docs/CLAUDE.md 文档索引（根据实际存在文件）
- 移除冗余技术参考文档
  - 删除 docs/ARCHITECTURE.md
  - 删除 docs/FUTURE_ARCHITECTURE.md
  - 删除 docs/reference/ 目录（4 个文件）
  - 删除 docs/guides/CORS_SOLUTION.md
  - 删除 docs/fixes/ 目录（3 个文件）

变更影响：
- 用户 README 更简洁，聚焦功能价值
- docs/ 目录仅保留必要的用户教程和开发者指南
- 文档定位更清晰（用户文档 vs 开发者文档）

2026-06-13 21:57:13 +08:00

9.1 KiB

Raw Blame History

eSIM Tools 🚀

[🇺🇸 English Version](./README_EN.md)

📱 这是什么？

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

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

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

✨ 适合谁用？

🇬🇧 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 工具

❓ 常见问题

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: 数据安全吗？

✅ 所有数据在本地浏览器处理，不上传服务器
✅ 不存储用户密码或敏感信息
✅ 开源透明，代码可审计
✅ 建议在安全网络环境下使用

🎁 新用户优惠

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

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

⚠️ 注意：本工具不支持新用户直接申请号码，仅支持已有号码的 eSIM 转换和设备更换。

🛠️ 本地部署（开发者）

点击展开查看部署说明

快速开始

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

# 2. 安装依赖
npm install

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

# 4. 启动开发服务器
npm start

# 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
文档: CC BY-NC-SA 4.0
- 可自由复制、再发行，但需提供原作者信息及协议声明
- 不可用于商业用途（任何盈利活动均视为商业用途）

⚖️ 免责声明

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

_{Made with ❤️ by Silentely}

9.1 KiB Raw Blame History Unescape Escape