Sessy 是一款面向 AWS SES 的开源邮件可观测性平台，帮你免费看到每一封邮件发出后发生了什么：送达、退信、投诉、打开、点击。而它内置的Setup 向导（Setup Wizard），正是把 AWS SES 事件接入 Sessy 的最快路径——不需要手写 IAM 角色，也不需要背下四条 CLI 命令，3 步就能让邮件事件实时流入你的面板。

📋 3步向导总览：Setup 流程一图看懂

打开任一 Source（邮件来源）页面，你会看到 Overview、Activity、Setup、Settings 四个标签页（见 app/views/sources/_tabs.html.erb）。Setup 页面采用「一次只显示一步」的渐进式设计，顶部有进度条，每一步完成后会自动推进到下一步，整个过程如下：

每一步的状态都由服务端记录在数据源上（waiting→connected→complete，逻辑见 app/models/source/setup_status.rb），所以刷新页面也不会丢进度，而且向导会自动轮询并在状态变化时无缝翻页，你甚至不需要手动刷新。

第 1 步：一键 Launch Stack 连接 SES（无需配置 IAM）

向导第一步的核心是一个Launch Stack按钮（界面源码见 app/views/setups/_step_connect.html.erb）。点击后它会在你的 AWS 账号里打开一个预制好的 CloudFormation 审查页面，核对无误后点击Create stack即可。这个堆栈会在你的 AWS 账号中创建 4 个资源：

• 一个Configuration Set（SES 配置集）
• 一个SNS topic（消息主题）
• 指向 Sessy webhook 的HTTPS 订阅
• 覆盖所有 SES 事件类型的Event Destination

⚠️ 全程不创建任何 IAM 角色或用户——Sessy 不接触你的 AWS 凭据，每条事件都经过密码学签名校验，页面上也有这句安全说明。

不知道自己的 SES Region？不用填

Region（区域）选择器被折叠在 "More options" 里，作为可选项而非必填项。原因很实用：

• 未选 Region 时，Launch Stack 会直接在 AWS 控制台的上次使用区域打开——刚配置过 SES 的人，那里几乎就是正确区域；
• 堆栈创建后，Sessy 会从 SNS topic 的 ARN 中自动推断并保存 Region（解析逻辑见 app/models/source/launch_stack.rb），你手动选过的值永远不会被覆盖。

如果你偏好命令行，向导也内置了折叠的 "Set up manually" 区域，提供了等价的 4 条 AWS CLI 命令（create-configuration-set、create-topic、subscribe、create-configuration-set-event-destination），并支持通过ExistingConfigurationSetName参数挂到你已有的 Configuration Set 上。另外还有一个 "Copy instructions for your AI agent" 按钮，一键复制给 Claude Code 等 AI 代理的搭建指令，让 AI 帮你完成接入。

完整的 SES 前置准备（生产权限、域名验证、DKIM）可以参考官方指南：docs/aws-ses-setup.md。

第 2 步：发送测试邮件，验证事件管道

堆栈创建成功后，页面会自动翻到第 2 步：发送一封测试邮件。这一步只需通过你在第 1 步创建的 Configuration Set 发出任意邮件（发给自己就行），页面底部会实时显示 "Waiting for the first event"，事件到达后自动跳转。

向导贴心地提供了 3 种方式的代码示例（见 app/views/setups/_step_send.html.erb）：

💡 如果测试邮件发出去没反应，向导的 "More options" 里也给出了排查命令：用aws sns list-subscriptions-by-topic确认 HTTPS 订阅已确认、用get-configuration-set-event-destinations确认事件目的地存在。

第 3 步：完成 ✅ 邮件事件实时上屏

收到第一个事件后，向导进入终态 "You're all set"，并给出一行汇总：连接时间、Region、首个事件时间。此时 Sessy 已经开始持续记录，Deliveries（送达）、Bounces（退信）、Complaints（投诉）、Opens（打开）、Clicks（点击）都会实时出现在 Activity 页面，支持按事件类型筛选、按邮箱和主题搜索。

❓ 常见问题

Q：Region 选错了怎么办？在 "More options" 里重新选择即可，Launch Stack 链接和 CLI 示例都会随之更新。找不到 Region 时，可以看应用代码里的AWS_REGION环境变量、SMTP 主机名（email-smtp.eu-west-1.amazonaws.com→eu-west-1），或 SES 控制台顶栏显示的区域。

Q：Sessy 需要我的 AWS 密钥吗？不需要。整个接入基于 SNS webhook + 事件签名验证，没有任何凭据共享，安全实践详见 docs/ses-security-best-practices.md。

Q：自己部署 Sessy 难吗？一条 Docker 命令即可启动，完整配置见 docs/docker-deployment.md。

📚 延伸阅读

• 接入向导页面：app/views/setups/show.html.erb
• 状态推进逻辑：app/models/source/setup_status.rb
• Launch Stack 与 Region 处理：app/models/source/launch_stack.rb
• AWS SES 完整配置指南：docs/aws-ses-setup.md
• 向导设计规划文档：docs/plans/2026-10-02-001-feat-setup-wizard-plan.md

从点击 Launch Stack 到看见第一封事件，整个过程通常只要几分钟。现在就去你的 Sessy 实例里试试 Setup 向导吧！