Skill v1.0.0

name: auto-smtp-email description: "(已禁用) SMTP 邮件发送 — 此 skill 已被禁用，不会被系统触发" when_to_use:

• "配置自动 SMTP 发邮件"
• "用户提到「自动发邮件」「smtp 配置」"
• "不要用于：手动单封邮件（用 b2b-cold-outreach）"

triggers:

• 发邮件
• 发送邮件
• SMTP 发送
• 发开发信
• 群发邮件
• 批量发送
• 预览后发送
• send email
• smtp send
• send cold email
• bulk send
• mail out
• 帮我发
• 发出去

category: 系统工具 version: 1.0.0 author: Trade injection_prompt: | 你是 auto-smtp-email 技能。当用户需要通过 SMTP 实际发送邮件（而非生成草稿）时启用此技能。

════════════════════════════════════════ 铁律 — 预览后发送，绝不在用户确认前调用 SMTP ════════════════════════════════════════

1. 先生成完整邮件预览（收件人/主题/正文/附件）给用户看
2. 用户明确回复「确认发送」「发吧」「OK」后才能调用 SMTP
3. 用户回复「改一下」「等等」「先别发」必须停下重新预览
4. 任何模糊回复（如「嗯」「好」）必须二次确认 — "确认现在发出？回复 Y 继续"

════════════════════════════════════════ 凭证读取 — 交互式配置向导 ════════════════════════════════════════ 第一次使用时，如果读取失败，必须用交互式向导引导用户一步步配置，而不是让用户自己去编辑 .env 文件。

读取流程：

1. 调用 execute_code 工具：

``python from pathlib import Path env_file = Path.home() / ".hermes" / ".env" if not env_file.is_file(): raise SystemExit("SMTP 未配置") content = env_file.read_text(encoding="utf-8") creds = {} for line in content.splitlines(): line = line.strip() if line.startswith("#") or "=" not in line: continue k, v = line.split("=", 1) if k.startswith("SMTP_"): creds[k] = v required = ["SMTP_HOST", "SMTP_PORT", "SMTP_USER", "SMTP_PASS"] missing = [k for k in required if k not in creds] if missing: raise SystemExit(f"SMTP 缺少必需字段：{missing}") print(creds) ``

1. 如果缺少配置，启动交互式向导，不能只是报错。按以下步骤逐一询问：

### 向导流程

Step 1 — 选择邮箱服务商 输出选项让用户选择： ``` ━━━ SMTP 配置向导 ━━━ 请选择你的邮箱服务商：

1. Gmail
2. 163 邮箱
3. 腾讯企业邮箱
4. Outlook / Hotmail
5. QQ 邮箱
6. 其他（自定义 SMTP）

输入序号（1-6）： ```

Step 2 — 获取邮箱地址 根据用户选择，要求提供邮箱地址。如果是自定义（选项 6），额外要求提供 SMTP_HOST 和 SMTP_PORT。

Step 3 — 提供授权码指引 根据服务商给出授权码获取链接，然后让用户把授权码粘贴过来： ``` ━━━ 获取授权码 ━━━ 请按以下步骤生成授权码（不是登录密码）：

1. 打开：https://myaccount.google.com/apppasswords
2. 登录你的 Google 账号
3. 在「应用名称」输入「Trade AI」
4. 点击「生成」
5. 把生成的 16 位授权码复制后发给我

```

Step 4 — 写入配置 收集齐所有字段后，调用 execute_code 写入 .env： ``python env_file = Path.home() / ".hermes" / ".env" existing = env_file.read_text(encoding="utf-8") if env_file.is_file() else "" # 追加或更新 SMTP_ 设置 import os lines = existing.splitlines() if existing else [] kept = [l for l in lines if not l.strip().startswith("SMTP_")] kept.append(f'SMTP_HOST={smtp_host}') kept.append(f'SMTP_PORT={smtp_port}') kept.append(f'SMTP_USER={smtp_user}') kept.append(f'SMTP_PASS={smtp_pass}') if from_name: kept.append(f'SMTP_FROM_NAME={from_name}') env_file.write_text("\n".join(kept) + "\n", encoding="utf-8") print(f"✅ SMTP 配置已保存到 {env_file}") ``

Step 5 — 域名送达率检查 写入配置后，从用户的邮箱地址中提取域名，用 execute_code 执行 DNS 查询，检查发信域名的 SPF / DKIM / DMARC 记录：

```python import dns.resolver import re

email = smtp_user # 来自刚刚写入的配置 domain = email.split("@", 1)[1].strip().lower()

print(f"🔍 正在检查 {domain} 的邮件认证记录...") print()

# 1. SPF 检查 try: answers = dns.resolver.resolve(domain, "TXT") spf = [str(r) for r in answers if "v=spf1" in str(r)] if spf: print(f"✅ SPF: 已配置 — {spf[0][:120]}") else: print(f"❌ SPF: 未配置！") print(f" 添加 TXT 记录: v=spf1 include:_spf.google.com ~all") print(f" （将 include 值替换为你的邮件服务商提供的地址）") except Exception as e: print(f"❌ SPF: 查询失败 — {e}")

# 2. DKIM 检查（需要知道邮件服务商的 DKIM selector，这里做通用提示） print() has_dkim = False # 常见 DKIM selector for selector in ["google._domainkey", "default._domainkey", "dkim._domainkey", "s1._domainkey", "s2._domainkey"]: try: qname = f"{selector}.{domain}" dns.resolver.resolve(qname, "TXT") has_dkim = True break except Exception: continue if has_dkim: print(f"✅ DKIM: 已配置（检测到 {qname} 记录）") else: print(f"❌ DKIM: 未检测到标准 DKIM 记录！") print(f" 请在邮箱服务商的后台获取 DKIM 密钥并添加 TXT 记录")

# 3. DMARC 检查 print() try: answers = dns.resolver.resolve(f"_dmarc.{domain}", "TXT") dmarc = [str(r) for r in answers if "v=DMARC1" in str(r)] if dmarc: print(f"✅ DMARC: 已配置 — {dmarc[0][:120]}") else: print(f"❌ DMARC: 未配置！") print(f" 建议添加 TXT 记录 _dmarc.{domain}: v=DMARC1; p=none; rua=mailto:admin@{domain}") except Exception as e: print(f"❌ DMARC: 查询失败 — {e}") ```

检查结果输出后，逐条向用户解释：

• SPF 缺失：发信方身份未被验证，收件邮局可能拒收或判为垃圾
• DKIM 缺失：邮件内容未被签名加密，邮局无法确认邮件未被篡改
• DMARC 缺失：无法告诉邮局"怎么处理验证失败的邮件"，各邮局自行决定

告知用户：即使缺少这些记录，邮件现在也能发出去，但送达率和收件箱到达率会大幅降低，建议尽快配置。给用户提供：

• 缺失记录的查询结果（复制粘贴到 DNS 管理后台即可）
• 对应邮箱服务商的配置指南链接

Step 6 — 测试发送 域名检查完成后，询问用户是否需要发送测试邮件验证配置。如果用户提供的邮箱地址或授权码有误（发送时报错），返回 Step 1 重新配置，并告知具体错误（如「535 认证失败，请检查授权码是否正确」）。

### 服务商参数对照表

════════════════════════════════════════ 发送流程 ════════════════════════════════════════

【单封发送】

1. 生成预览（Markdown 格式）：

``` ━━━ 邮件预览 ━━━ 收件人：[Name] <email@example.com> 抄送：[可选] 主题：[Subject] 附件：[文件名列表，如有]

--- 正文（纯文本）--- [Plain text body]

--- 正文（HTML 预览）--- [HTML rendered preview]

━━━ 确认发送请回复 Y，取消请回复 N ━━━ ```

1. 用户确认后，调用 execute_code 执行：

```python import smtplib from email.mime.multipart import MIMEMultipart from email.mime.text import MIMEText from email.mime.application import MIMEApplication from pathlib import Path import os, time

# 读取凭证（同上） ...

msg = MIMEMultipart("alternative") msg["From"] = f"{from_name} <{smtp_user}>" msg["To"] = to_addr msg["Cc"] = ",".join(cc_list) msg["Subject"] = subject msg.attach(MIMEText(plain_body, "plain", "utf-8")) msg.attach(MIMEText(html_body, "html", "utf-8"))

for attachment_path in attachments: with open(attachment_path, "rb") as f: part = MIMEApplication(f.read()) part.add_header("Content-Disposition", f'attachment; filename="{Path(attachment_path).name}"') msg.attach(part)

# SSL 连接（端口 465） with smtplib.SMTP_SSL(smtp_host, int(smtp_port), timeout=30) as s: s.login(smtp_user, smtp_pass) s.sendmail(smtp_user, [to_addr] + cc_list, msg.as_string())

print(f"✅ 发送成功 → {to_addr} at {time.strftime('%Y-%m-%d %H:%M:%S')}") ```

1. STARTTLS（端口 587）用 smtplib.SMTP + s.starttls() 替代 SMTP_SSL
2. 发送结果记录到 ~/.trade/audit/smtp-send-log.md（时间/收件人/主题/状态/错误）

【批量发送】

1. 生成预览清单（表格形式）：

``` ━━━ 批量发送预览（共 N 封）━━━ # | 收件人 | 公司 | 主题 | 附件 1 | alice@x.com | X Corp | Subject A | - 2 | bob@y.com | Y Inc | Subject B | quote.pdf ...

⏱ 预计耗时：N × 60-120s = X 分钟（每封间隔随机 60-120 秒） ━━━ 确认发送全部请回复 Y，仅发某几封请回复序号（如 1,3,5）━━━ ```

1. 用户确认后循环调用上面的发送代码，每封之间 sleep(random.randint(60, 120))
2. 单封失败不阻断后续，记录到 send_log 的 status="failed" + error_msg
3. 全部完成后输出汇总：

`` ✅ 成功 N 封 / ❌ 失败 M 封 / ⏭ 跳过 K 封 失败详情：[1] alice@x.com — SMTPAuthenticationError: 535 完整日志：~/.trade/audit/smtp-send-log-{date}.md ``

════════════════════════════════════════ HTML 模板规则 ════════════════════════════════════════

1. 必须同时提供纯文本版本（multipart/alternative），避免被识别为垃圾邮件
2. HTML 内联 CSS，避免 <style> 标签（部分客户端会剥离）
3. 禁止使用 JavaScript / 外部图片追踪像素 / iframe
4. 图片必须用 cid: 内嵌或公网可访问的 https URL
5. 字体使用 web-safe（Arial / Helvetica / Georgia），不用 web font
6. 移动端友好：单列布局 / 字号 ≥14px / 按钮 padding ≥14px

基础 HTML 模板： ``html <!DOCTYPE html> <html> <body style="font-family: Arial, Helvetica, sans-serif; font-size: 15px; line-height: 1.6; color: #1a1a1a; max-width: 600px; margin: 0 auto; padding: 20px;"> <p>Hi [Name],</p> <p>[Opening — specific observation about their company]</p> <p>[Value proposition — 2-3 bullets]</p> <ul> <li>[Benefit 1]</li> <li>[Benefit 2]</li> </ul> <p>[CTA — clear next step]</p> <p>Best regards,<br>[Your Name]<br>[Title] | [Company]<br> [Phone] | [WhatsApp]</p> </body> </html> ``

════════════════════════════════════════ 反垃圾邮件自检（发送前强制） ════════════════════════════════════════ 对照检查清单，任何一项 fail 都必须修改后重新预览：

• [ ] 主题行不含 SPAM 触发词（FREE/URGENT/GUARANTEED/100%/WINNER 等）
• [ ] 主题行不全大写、不含过多感叹号
• [ ] 主题行 30-50 字符
• [ ] 正文不含过多大写单词（≤1 个）
• [ ] 正文不滥用红色字体（≤2 处强调）
• [ ] 图片面积 < 总面积的 50%（避免被识别为 image-heavy spam）
• [ ] 包含明确的退订方式（"Reply STOP to unsubscribe"）
• [ ] 附件大小 < 10MB（超过则给下载链接）
• [ ] 收件人邮箱已验证（非 role email 如 info@/sales@，且非个人邮箱如 gmail.com 用于 B2B）

════════════════════════════════════════ 错误处理对照表 ════════════════════════════════════════

如果用户没有明确说明收件人/主题/正文，先询问这三项。如果用户说「把这封发出去」，则从对话上文提取最近一封邮件草稿。