- **📝 Markdown 支持**：支持富文本格式，包括表格、TODO 列表、代码块、图片等 - **⏰ 智能定时**：基于北京时间（Asia/Shanghai）的精准定时投递 - **📊 状态追踪**：实时查看胶囊投递状态，带倒计时显示 - **🎲 快捷投递**：支持快捷选择（1/2/3/6个月、1年）和随机日期 - **🔐 管理面板**：支持查看胶囊列表、调整站点设置、导出数据 - **📈 统计面板**：丰富的数据可视化，包含状态分布、邮箱统计等 ## 使用手册 ### 第一步：注册 Resend 账号并获取 API Key 1. 打开浏览器访问 [https://resend.com](https://resend.com) 2. 点击 **Sign Up** 注册账号（可用 GitHub 或 Google 登录） 3. 登录后，点击左侧菜单 **API Keys** 4. 点击 **Create API Key**，输入名称（如 `timecapsule`），点击创建 5. **立即复制保存** 生成的 API Key（格式：`re_xxxxxxxxxx`），这个只显示一次！ ### 第二步：添加并验证发件域名 > [!IMPORTANT] > 您需要拥有一个自己的域名（如 `example.com`）才能正常发送邮件。 1. 在 Resend 控制台点击左侧 **Domains** 2. 点击 **Add Domain**，输入您的域名（如 `mail.example.com`） 3. Resend 会显示需要添加的 **DNS 记录**（通常是 3 条） 4. 登录您的域名 DNS 管理后台（如阿里云、Cloudflare），添加这些记录 5. 返回 Resend 点击 **Verify**，等待验证通过（可能需要几分钟到几小时） > [!TIP] > **如果没有域名，可暂时使用测试域名**： > - 发件邮箱填写：`Time Capsule <onboarding@resend.dev>` > - ⚠️ 测试域名只能向您 Resend 账户绑定的邮箱发送 ### 第三步：在懒猫微服中配置应用参数 安装时会弹出配置向导，按以下说明填写： | 参数 | 填写内容 | 示例 | |------|----------|------| | **Resend API 密钥** | 第一步获取的 API Key | `re_xxxxxxxxxxxx` | | **管理员密码** | 自己设置一个密码 | `admin123` | | **发件人邮箱** | 验证过的域名邮箱 | `Time Capsule <onboarding@resend.dev>` | | **联系邮箱** | 您的联系邮箱（可选） | `your@email.com` | | **其他限流参数** | 保持默认即可 | - | 保存配置后，等待应用启动完成（约 10-30 秒）。 ### 第四步：访问应用 通过懒猫分配的域名访问： ``` https://timecapsule.<your-box-name>.heiyu.space ``` ### 第五步：测试发送胶囊 1. 打开时间胶囊应用首页 2. 填写： - **收件人邮箱**：填您自己的邮箱（先测试） - **胶囊内容**：随便写点内容（支持 Markdown） - **投递时间**：选择最近的时间（如 1 分钟后） 3. 点击发送，记下返回的 **胶囊 ID** 4. 访问 `/status/胶囊ID` 查看状态 5. 到收件箱查看是否收到邮件（注意检查垃圾邮件） ### 第六步：访问管理面板 1. 在浏览器访问：`https://timecapsule.盒子名.heiyu.space/admin` 2. 输入第三步设置的 **管理员密码** 3. 登录后可以： - 📋 查看所有胶囊列表和状态 - ⚙️ 调整站点设置（限流参数、最小提前量等） - 📊 查看统计面板（数据可视化） - 📤 导出数据（CSV/JSON） - 🗑️ 删除胶囊 --- ## 配置 Webhook（可选） 如需追踪邮件投递状态（已送达/被拒收等），在 Resend 控制台添加 Webhook： 1. 登录 Resend，点击左侧 **Webhooks** 2. 点击 **Add Webhook** 3. URL 填写：`https://timecapsule.盒子名.heiyu.space/api/webhook/resend` 4. 选择需要监听的事件（如 `email.delivered`, `email.bounced`） 5. 复制 **Signing Secret**，填入应用配置的 **Webhook 密钥** 参数