> ## Documentation Index
> Fetch the complete documentation index at: https://docs.readdy.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# CONTEXT ARCHIVE

# Mintlify 文档自动化项目 - 上下文存档

**存档时间**: 2026-01-22
**项目路径**: `/tmp/mintlify-docs-main`
**本地预览地址**: [http://localhost:3000](http://localhost:3000)

***

## 项目概述

这是一个基于 Mintlify 的文档自动化项目，为 Readdy（AI 网站构建工具）创建集成文档。

当前任务：为 **Resend 邮件服务集成** 编写帮助文档。

***

## 当前工作状态

### ✅ 已完成的工作

1. **创建了 Resend 集成文档**
   * 文件路径：`/tmp/mintlify-docs-main/integrations/resend.mdx`
   * 已添加到导航菜单（在 `docs.json` 中）
   * 文档位置：Integrations 分组，位于 Supabase 之后，Shopify 之前

2. **文档结构（4个主要部分）**
   * 第1节：基础配置（注册、连接 Supabase、获取 API Key）
   * 第2节：测试和验证（测试邮件 + 数据库验证 = 流程闭环）
   * 第3节：品牌化设置（可选 - 购买域名、DNS 验证）
   * 第4节：高级功能（可选 - AI Agent、日历预约）

3. **本地预览服务器**
   * 启动命令：`cd /tmp/mintlify-docs-main && npx mint dev`
   * 访问地址：[http://localhost:3000](http://localhost:3000)
   * 后台进程 ID：bb42076（可能已停止，需重新启动）

***

## 文档风格参考

项目位于：`/Users/shikexin/Downloads/mintlify-docs-main.zip`

### Mintlify 组件使用规范

```markdown theme={null}
# Frontmatter（必需）
---
title: "页面标题"
description: "页面描述"
sidebarTitle: "侧边栏显示的简短标题"
---

# 常用组件

## 1. 步骤引导
<Steps>
  <Step title="步骤标题">
    步骤内容...

    <Frame>
      <img src="/images/image-file.png" alt="图片描述" />
    </Frame>
  </Step>
</Steps>

## 2. 提示框
<Tip>提示内容</Tip>
<Info>信息内容</Info>
<Warning>警告内容</Warning>
<Danger>危险提示</Danger>
<Note>注意事项</Note>

## 3. 卡片
<Card title="卡片标题" href="链接地址">
  卡片描述内容...
</Card>

<CardGroup cols={2}>
  <Card title="卡片1">内容1</Card>
  <Card title="卡片2">内容2</Card>
</CardGroup>

## 4. 折叠区域
<Accordion title="标题">
  折叠内容...
</Accordion>

## 5. 帧容器（用于图片/视频）
<Frame caption="图片说明">
  <img src="/path/to/image.png" alt="描述" />
</Frame>

## 6. 视频嵌入
<Frame>
  <video
    autoPlay
    loop
    muted
    playsInline
    src="/images/video-file.mp4"
    alt="视频描述"
  />
</Frame>

## 7. 代码块
直接使用 markdown 的三个反引号
```

代码...

```

## 8. 表格
<table>
<thead>
  <tr>
    <th width="200">列1</th>
    <th width="300">列2</th>
  </tr>
</thead>
<tbody>
  <tr>
    <td>内容1</td>
    <td>内容2</td>
  </tr>
</tbody>
</table>

## 9. 多列布局
<Columns cols={3} className="gap-y-4">
  <Frame caption="说明1">
    <img src="/images/img1.png" />
  </Frame>
  <Frame caption="说明2">
    <img src="/images/img2.png" />
  </Frame>
  <Frame caption="说明3">
    <img src="/images/img3.png" />
  </Frame>
</Columns>

## 10. 外部链接
使用 markdown 语法，添加 target 和 rel：
<a href="URL" target="_blank" rel="noopener noreferrer">链接文本</a>

## 11. 更新日志组件
<Update label="December 2025" description="简短描述">
  ✨ **New Features**
  - 新功能列表

  🚀 **Improvements**
  - 改进列表

  🐛 **Bug Fixes**
  - 修复列表
</Update>
```

***

## Resend 文档内容大纲

### 文件：`integrations/resend.mdx`

```markdown theme={null}
---
title: "Integrate with Resend"
description: "Add email functionality to your Readdy website using Resend for transactional emails and notifications"
sidebarTitle: "Resend"
---

## What is Resend?
- 介绍 Resend 是什么
- 可以实现的功能（预约确认邮件、预订通知等）

## Before You Start
- 需要准备的条件（Resend 账号、Supabase 连接）

## 1. Basic Configuration
<Steps>
  Step 1: Sign Up for Resend
  Step 2: Connect Supabase Database
  Step 3: Get Your Resend API Key
  Step 4: Connect Resend to Readdy
</Steps>

## 2. Testing and Verification（包含流程闭环）
<Steps>
  Step 1: Enable Email in Readdy
  Step 2: Test the Booking Flow
  Step 3: Verify Email Delivery（流程闭环第一步）
  Step 4: Check Database Records（流程闭环第二步）
</Steps>

## 3. Branding Setup (Optional)
<Accordion title="Why Verify Your Domain?">
  品牌域名的优势
</Accordion>

<Steps>
  Step 1: Purchase a Domain
  Step 2: Add Domain in Resend
  Step 3: Configure DNS Records
  Step 4: Verify Domain
  Step 5: Update Email Sender in Readdy
</Steps>

## 4. Advanced Features (Optional)
### AI Agent Integration
### Calendar Scheduling

## Troubleshooting
### Email Not Sending
### Email Not Arriving
### Database Not Recording Bookings

## Need Help?
联系方式
```

***

## 待完成的任务

### 📋 必需任务

1. **准备图片资源**

   * 需要的截图列表（当前都使用了占位路径）：
     * `/images/resend-signup.png` - Resend 注册页面
     * `/images/resend-api-key.png` - API Key 创建界面
     * `/images/resend-integration-entry.png` - 集成入口
     * `/images/resend-connect-api.png` - 连接 API 界面
     * `/images/resend-test-booking.png` - 测试预约表单
     * `/images/resend-email-received.png` - 收到确认邮件
     * `/images/resend-supabase-records.png` - Supabase 数据库记录
     * `/images/resend-add-domain.png` - 添加域名
     * `/images/resend-dns-records.png` - DNS 记录
     * `/images/resend-verify-domain.png` - 验证域名
     * `/images/resend-logs.png` - Resend 日志

   **操作**：将截图放入 `/tmp/mintlify-docs-main/images/` 目录

2. **测试文档预览**
   * 确保所有链接可点击
   * 验证组件正确渲染
   * 检查移动端显示效果

### 🔄 可选优化

1. **内容精简**
   * 根据实际需求调整内容详细程度
   * 添加更具体的示例

2. **样式调整**
   * 优化表格显示
   * 调整图片大小和说明

3. **SEO 优化**
   * 检查 meta description
   * 添加关键词

***

## 重要配置文件

### docs.json 配置

```json theme={null}
{
  "navigation": {
    "groups": [
      {
        "group": "Integrations",
        "pages": [
          "integrations/readdy-agent",
          "integrations/supabase",
          "integrations/resend",    // ← 新添加的
          "integrations/shopify",
          "integrations/stripe",
          // ... 其他集成
        ]
      }
    ]
  }
}
```

***

## 下次工作指南

### 如何继续工作

1. **打开项目**
   ```bash theme={null}
   cd /tmp/mintlify-docs-main
   ```

2. **启动预览服务器**
   ```bash theme={null}
   npx mint dev
   ```

3. **访问预览**
   * 打开浏览器访问：[http://localhost:3000](http://localhost:3000)
   * 导航到：Integrations → Resend

4. **在 Cursor 中编辑**
   * 使用 Cursor 打开整个 `/tmp/mintlify-docs-main` 目录
   * 编辑 `integrations/resend.mdx` 文件
   * 保存后浏览器会自动刷新

### 给 AI 的提示

如果下次需要继续编辑这个文档，请这样告诉 AI：

```
我正在继续之前的 Mintlify 文档项目。项目位于 /tmp/mintlify-docs-main

请阅读以下文件：
1. /tmp/mintlify-docs-main/integrations/resend.mdx（当前正在编辑的文档）
2. /tmp/mintlify-docs-main/integrations/stripe.mdx（参考格式）
3. /tmp/mintlify-docs-main/integrations/calendly.mdx（参考格式）

帮我：[具体需求]
```

***

## 项目文件结构

```
/tmp/mintlify-docs-main/
├── docs.json                          # 主配置文件（已更新）
├── README.md
├── intro.mdx
├── welcome.mdx
├── firstapp.mdx
├── changelog.mdx
├── favicon.svg
├── logo/
│   ├── light.svg
│   └── dark.svg
├── images/                            # 图片资源目录（需添加截图）
├── integrations/                      # 集成文档目录
│   ├── readdy-agent.mdx
│   ├── supabase.mdx
│   ├── resend.mdx                     # ← 新创建的文档
│   ├── shopify.mdx
│   ├── stripe.mdx                      # ← 参考格式
│   ├── figma.mdx
│   ├── ga.mdx
│   ├── calendly.mdx                    # ← 参考格式
│   ├── mailchimp.mdx
│   └── google-login.mdx
├── features/
├── tricks/
├── account/
├── cases/
├── troubleshooting/
└── more/
```

***

## 相关文档参考

### 优秀的集成文档示例

1. **Stripe 集成** (`integrations/stripe.mdx`)
   * 详细的步骤说明
   * 清晰的权限表格
   * 完整的注意事项

2. **Calendly 集成** (`integrations/calendly.mdx`)
   * 简洁的步骤
   * 丰富的图片演示
   * 清晰的操作流程

3. **Supabase 集成** (`integrations/supabase.mdx`)
   * 复杂集成的完整示例
   * 多个功能模块

***

## 技术栈

* **文档框架**: Mintlify
* **格式**: MDX (Markdown + JSX)
* **本地预览**: `npx mint dev`
* **配置文件**: docs.json

***

## 联系方式与支持

* 项目支持邮箱：[hi@readdy.ai](mailto:hi@readdy.ai)
* Mintlify 官方文档：[https://mintlify.com/docs](https://mintlify.com/docs)

***

## 快速命令参考

```bash theme={null}
# 启动预览
cd /tmp/mintlify-docs-main && npx mint dev

# 停止预览：在终端按 Ctrl+C

# 查看项目结构
ls -la /tmp/mintlify-docs-main/

# 查看集成文档
ls -la /tmp/mintlify-docs-main/integrations/

# 查看图片资源
ls -la /tmp/mintlify-docs-main/images/
```

***

## 最后更新

* **日期**: 2026-01-22
* **状态**: Resend 文档初稿已完成，等待图片资源和测试
* **下一步**: 准备截图，完善视觉内容

***

*此文件用于在 Cursor 中打开，以便 AI 读取上下文并继续工作*