📦 FlashRev AI Mailer — FlashRev AI 邮件发送器

FlashRev AI Mailer 使用 flashrev-mailer CLI 运行个性化电子邮件活动，包括 FlashRev 邮箱池、收件人验证、节流调度和详细发送日志。

前提条件 这些项目必须由人类操作员设置。代理的角色是验证每一个并指导用户修复任何缺失的内容 —— 绝不尝试安装软件、生成 API 密钥或未经授权修改用户的 shell 环境。 Node.js ≥ 20 已安装并在 PATH 中。 CLI 已由用户全局安装：npm install -g flashrev-ai-mailer。 验证使用 flashrev-mailer --help。 FlashRev API 密钥由用户在 https://info.flashlabs.ai/settings/privateApps 生成，并作为 shell 环境变量导出（export FLASHREV_API_KEY="..."，可选地追加到 ~/.zshrc 或 ~/.bashrc 以实现持久性）。 要使用不同的变量名称，请在 .flashrev/config.json 中设置 flashrev.apiKeyEnv —— 但密钥值本身必须始终保持在环境中，而不是在任何配置文件中（请参阅安全规则）。 Base URL 初始化一次 per 工作空间。 代理可以在用户确认 URL 后运行 flashrev-mailer init --base-url ""；这将写入 .flashrev/config.json。 要覆盖现有的配置，请追加 --force。 对 FlashRev API 主机和每个邮箱返回的 SMTP 服务器（例如 smtp.gmail.com:465）的出站网络访问。 通过 nodemailer 直接通过 SMTP 发送。 工作空间可写 —— 活动状态、队列和发送日志在当前工作目录下持久化。 在任何活动步骤之前运行 flashrev-mailer doctor（或 flashrev-mailer doctor --check-api 以进行实时探测）。 如果检查失败，请停止工作流程，告诉用户缺失的确切先决条件以及修复它的命令或链接，然后等待 —— 直到用户报告它已解决，请勿继续导入/排队/发送。

所需确认 以下每个项目都是代理必须在继续之前与用户明确对齐的商业决策 —— 不要假设默认值。 联系来源已获批：CSV、TSV、公共 CSV URL、Google Sheets CSV/导出 URL 或 Clay CSV 导出。 电子邮件列和个性化字段已被理解（将它们列出以供用户确认）。 活动目标、优惠、语气、发件人身份和行动号召已获批。 发送时区、星期/窗口和频率已获批。 用户已审查草稿并明确批准实时发送。

工作流程 先决条件必须得到满足（请参见上文）。 所有命令假设 CAMPAIGN_ID 为小写-连字符（例如 launch-001）；CLI 将在内部对其他形式进行 slugify，但在命令之间混合样式会导致查找失败。 为每个活动选择一个 ID 并逐字重用。 确认发件人池 —— flashrev-mailer 邮箱列出了 FlashRev 提供的发件人邮箱。 确认至少存在一个可用的邮箱，并与用户对齐以确定哪个发件人身份将运行此活动。 如果列表为空，请停止并要求用户在继续之前在 FlashRev 中设置邮箱。 导入联系人：flashrev-mailer import --campaign CAMPAIGN_ID --source contacts.csv 将“电子邮件语法无效”的数量报告回给用户。 如果非零，请询问是否在继续之前清理源 CSV。 验证收件人：flashrev-mailer validate --campaign CAMPAIGN_ID --limit 200 对于超过 200 个联系人的列表，分批运行验证并在批次之间报告进度；这也可以避免在单个调用中耗尽 FlashRev 验证配额。 草拟个性化内容。 对于模板草拟：flashrev-mailer draft --campaign CAMPAIGN_ID --subject-template "..." --body-template "..." 仅对符合条件的联系人进行排队：flashrev-mailer queue --campaign CAMPAIGN_ID --require-validation --timezone Etc/GMT+5 --window 09:00-17:00 --min-interval 10 先进行小批量的 dry-run：flashrev-mailer send --campaign CAMPAIGN_ID --limit 5 --dry-run --yes 始终显式设置 --limit（CLI 默认值为 25）。 向用户显示一些渲染的草稿，并在任何实时发送之前让他们确认主题和正文的措辞。 仅在获得用户明确批准后，分小批量发送实时：flashrev-mailer send --campaign CAMPAIGN_ID --limit 10 --live --yes 在批次之间重新确认用户，然后增加 --limit。 绝不在一次调用中发送整个队列。 查看和导出结果：flashrev-mailer status --campaign CAMPAIGN_ID flashrev-mailer export --campaign CAMPAIGN_ID --format csv --out results.csv

个性化指南 将联系人字段用作模板变量，例如 {{first_name}}、{{company}} 和 {{focus}}。 使用 {{field|fallback}} 时，字段可能为空。 保持每个生成的电子邮件都基于可用的联系人字段或用户批准的研究。 当活动目标、优惠或语气不明确时，请请求批准。 不要对收件人发明私人事实。

安全规则 绝不在活动导出、日志或聊天输出中打印或存储 API 密钥。 仅将 API 密钥存储在环境变量中。 绝不将密钥写入 .flashrev/config.json（或任何其他磁盘配置）中。