SuperAPI AI 工具集

customware-email

办公与效率

查看项目

更新于 10-15 20:30

技能介绍

用途:为 Customware 生成的 React Router 与 Hono 应用实现统一的客户邮件能力,通过已配置的 Postmark 入站 webhook 接收客户回复,并通过同一开发 Postmark 服务器的 HTTPS API 发送面向客户的消息。

主要能力:入站路由固定为 POST /api/email/inbound,使用 HTTP Basic Auth(用户名 customware,密码来自 POSTMARK_INBOUND_WEBHOOK_SECRET);出站直接调用 Postmark Email API,使用 X-Postmark-Server-Token 与 MessageStream: "outbound",From 与 ReplyTo 使用任务提供的地址。要求先持久化入站投递再返回 200,用数据库约束保证 MessageID 唯一,并支持崩溃或重启后的恢复处理。

使用方式:先阅读 references/common-architecture.md、inbound.md、outbound.md、common-quality.md,以及目标仓库的 AGENTS.md 和现有数据库/路由/服务契约。复用现有 Hono 路由、Drizzle schema、SQLite、日志与 Result 模式,建立小型服务端邮件配置模块,将 Postmark 调用封装在适配器中。入站路由需注册在静态服务和 SPA 回退之前。

适用场景:Customware 生成应用需要接收客户回复并发送客户邮件的开发环境实现。

限制:两个 Postmark 凭据仅限服务端使用,不得进入浏览器代码、VITE_*、HTML、JSON 响应、日志或客户端状态;不得使用 SMTP、POSTMARK_ACCOUNT_TOKEN、生产分支或 Customware 发送网关;不得创建或配置 Postmark 服务器;地址与凭据缺失时应返回 action_required,不得编造。生产服务器、发布与环境分支行为不在本技能范围内。