SuperAPI AI 工具集

newsletter-campaign-workflow

营销与增长

查看项目

更新于 10-16 03:36

技能介绍

这是一个面向 AIProDaily 新闻通讯平台的 campaign 工作流技能指南,用于处理 RSS 处理、文章生成、多租户数据管理与自动化发布。当涉及活动创建与管理、RSS 订阅源处理与文章生成、工作流步骤与自动化、新闻通讯发布与发送、MailerLite 集成、多租户活动操作、软文与广告管理、活动状态流转时会自动激活。

系统架构为多租户结构:Newsletter(slug 如 accounting)对应 publication_id,其下分 Campaigns、RSS Posts、Articles、Email。所有数据库查询必须按 publication_id 过滤,否则会造成数据泄漏。

状态生命周期:draft → processing → ready → approved → sent,出错则为 failed。代码中 Issue 已取代 campaign,issues 表原为 newsletter_campaigns。

核心为 10 步 RSS 处理工作流,位于 src/lib/workflows/process-rss-workflow.ts,基于 Vercel Workflows,每步超时 800 秒,由 /api/cron/trigger-workflow 每 5 分钟触发。步骤包括:Setup 创建次日活动并分配 24 篇文章、生成 6 条主标题、两批各 3 篇主文章正文、事实核查(存 fact_check_score 0-10)、生成 6 条次标题、两批各 3 篇次文章正文、事实核查、最终化(每区自动选前 3、生成欢迎语与主题行、设为 draft、取消未用文章分配)。

AI 调用使用 callAIWithPrompt(),从 app_settings 读取完整 JSON 提示,替换占位符后调用 OpenAI 或 Claude 并返回解析后的 JSON;所有参数存数据库。还有多类 cron:如 ingest-rss 每 15 分钟、send-review 与 send-final 每 5 分钟等,部分已注册但未实现。

关键规则包括:多租户隔离、日期比较使用本地日期字符串而非 UTC 转换、遵守 Vercel 的 800 秒步骤超时等限制。故障排查涵盖活动卡在 processing、文章未评分、工作流失败等。更多细节见项目根目录的 claude.md。