这是一个基于网页的 iCloud Hide My Email 应用，允许用户通过网页界面管理 iCloud 的隐藏邮箱地址服务。

• 🔐 iCloud 认证：支持 iCloud 账户登录和认证
• 📧 邮箱生成：生成新的隐藏邮箱地址
• 💾 邮箱管理：查看、保留、停用、重新激活和删除隐藏邮箱地址
• 🔍 搜索功能：搜索邮箱地址、标签和备注
• ⚙️ 设置管理：配置转发邮箱地址和自动填充选项
• 🌐 跨平台：支持全球版和中国版 iCloud 服务
• 📱 响应式设计：适配桌面和移动设备

• 前端框架：React 18 + TypeScript
• 构建工具：Vite
• 样式框架：Tailwind CSS
• 图标库：Font Awesome
• 路由：React Router
• 状态管理：React Hooks

• Node.js 18+
• npm 或 yarn

cd web-app
npm install

npm run dev

应用将在 http://localhost:3000 启动。

npm run build

构建文件将生成在 dist 目录中。

npm run preview

1. 访问应用首页
2. 选择您的 iCloud 区域（全球版或中国版）
3. 点击"前往 iCloud 登录"按钮
4. 在新窗口中完成 iCloud 登录流程：
   • 输入 Apple ID 和密码
   • 完成双重认证
   • 选择"信任此浏览器"
   • 勾选"保持登录状态"
5. 返回应用页面，点击"检查登录状态"

1. 在首页点击"生成新邮箱"按钮
2. 生成的邮箱地址将显示在页面上
3. 可以添加标签和备注（可选）
4. 点击"复制"按钮复制邮箱地址
5. 点击"保留此邮箱"将其保存到您的账户

1. 点击导航栏中的"邮箱管理"
2. 查看所有已保存的隐藏邮箱地址
3. 使用搜索功能查找特定邮箱
4. 对邮箱地址执行以下操作：
   • 复制邮箱地址
   • 停用/重新激活邮箱
   • 删除邮箱

1. 点击导航栏中的"设置"
2. 选择转发邮箱地址
3. 配置自动填充选项
4. 点击"保存设置"

web-app/
├── src/
│   ├── components/          # 可复用组件
│   │   └── Header.tsx      # 页面头部组件
│   ├── lib/                # 核心库文件
│   │   ├── iCloudClient.ts # iCloud API 客户端
│   │   └── storage.ts      # 本地存储管理
│   ├── pages/              # 页面组件
│   │   ├── Dashboard.tsx   # 首页/仪表板
│   │   ├── EmailManager.tsx # 邮箱管理页面
│   │   ├── Settings.tsx    # 设置页面
│   │   └── SignIn.tsx      # 登录页面
│   ├── App.tsx             # 主应用组件
│   ├── main.tsx            # 应用入口
│   └── index.css           # 全局样式
├── public/                 # 静态资源
├── package.json            # 项目配置
├── vite.config.ts          # Vite 配置
├── tailwind.config.js      # Tailwind 配置
└── README.md               # 项目说明

1. 在 src/lib/iCloudClient.ts 中添加新的 API 方法
2. 在相应的页面组件中实现 UI 逻辑
3. 更新类型定义和错误处理

• 使用 Tailwind CSS 类名进行样式定制
• 在 src/index.css 中添加全局样式
• 在组件中使用 className 属性应用样式

• 所有 API 调用都包含 try-catch 错误处理
• 错误信息显示在用户界面上
• 使用 TypeScript 进行类型检查

1. 认证要求：用户需要先在 iCloud 网站完成登录
2. 跨域限制：由于浏览器安全策略，应用需要与 iCloud 在同一域名下或使用代理
3. Cookie 管理：应用依赖 iCloud 的认证 cookies
4. 数据存储：设置和状态保存在浏览器的 localStorage 中

• 确保已在 iCloud 网站完成完整登录流程
• 检查浏览器是否启用了 cookies
• 尝试清除浏览器缓存和 cookies

• 检查网络连接
• 确认 iCloud 服务状态
• 查看浏览器控制台的错误信息

• 确保 Node.js 版本符合要求
• 清除 node_modules 并重新安装依赖
• 检查 TypeScript 配置

MIT License

欢迎提交 Issue 和 Pull Request！

本应用不是由 Apple 官方开发、维护或支持的。使用本应用需要遵守 iCloud 的服务条款和隐私政策。