admin/nanocode

Fork 0

Files

T

Ubuntu 32b43f85bd a

2026-07-03 16:58:28 +08:00

5.6 KiB

Raw Blame History

邮件发送技能

为nanobot提供完整的邮件发送功能，支持附件、HTML格式、抄送/密送等高级功能。

🚀 功能特性

核心功能

✅ 邮件发送：支持纯文本和HTML格式
✅ 附件支持：支持多种文件类型（文本、图片、PDF、压缩包等）
✅ 多收件人：支持抄送(CC)和密送(BCC)
✅ 中文支持：完整的中文内容支持
✅ 大文件支持：支持发送较大附件

高级功能

✅ 自动配置：从nanobot配置文件读取邮箱设置
✅ 错误处理：完善的错误处理和日志记录
✅ 进度显示：发送过程实时状态显示
✅ 测试模式：内置测试邮件生成功能

📋 使用方法

命令行工具

# 发送简单邮件
python3 /home/ubuntu/.nanobot/workspace/send_email_with_attachments.py \
  收件人邮箱 "邮件主题" "邮件正文"

# 发送带附件的邮件
python3 /home/ubuntu/.nanobot/workspace/send_email_with_attachments.py \
  收件人邮箱 "带附件的邮件" "请查看附件" \
  --attachments 文件1.txt 文件2.pdf 图片.png

# 发送带抄送的邮件
python3 /home/ubuntu/.nanobot/workspace/send_email_with_attachments.py \
  收件人邮箱 "会议通知" "请准时参加" \
  --cc 抄送人1@example.com 抄送人2@example.com

# 发送测试邮件（自动创建测试附件）
python3 /home/ubuntu/.nanobot/workspace/send_email_with_attachments.py \
  --test --test-to 2927951@qq.com

在nanobot中使用

# 导入邮件发送函数
from send_email_with_attachments import send_email

# 发送简单邮件
send_email(
    to_email="recipient@example.com",
    subject="邮件主题",
    body="邮件正文"
)

# 发送带附件的邮件
send_email(
    to_email="recipient@example.com",
    subject="带附件的邮件",
    body="请查看附件",
    attachment_paths=["file1.txt", "file2.pdf"]
)

⚙️ 配置要求

邮箱配置

邮件功能使用nanobot配置文件中的邮箱设置：

{
  "channels": {
    "email": {
      "enabled": true,
      "smtpHost": "smtp.163.com",
      "smtpPort": 465,
      "smtpUsername": "your-email@163.com",
      "smtpPassword": "your-auth-code",
      "smtpUseSsl": true,
      "fromAddress": "your-email@163.com"
    }
  }
}

支持的邮箱服务

163/126邮箱：推荐，配置简单
QQ邮箱：需要授权码
Gmail：需要应用专用密码
其他SMTP服务：支持标准SMTP协议

📁 文件结构

email-sender/
├── SKILL.md                    # 技能说明文档
├── send_email_with_attachments.py  # 主工具文件
└── examples/                   # 使用示例

🎯 使用示例

示例1：发送工作日报

python3 send_email_with_attachments.py \
  team@company.com \
  "工作日报 - $(date +%Y-%m-%d)" \
  "今日完成工作：\n1. 项目A开发\n2. 会议讨论\n3. 文档编写" \
  --attachments daily_report.txt progress_chart.png \
  --cc manager@company.com

示例2：发送项目文档

python3 send_email_with_attachments.py \
  client@example.com \
  "项目文档交付" \
  "尊敬的客户，\n\n附件中是项目相关文档，请查收。" \
  --attachments project_spec.pdf design_docs.zip \
  --html "<h1>项目文档</h1><p>请查看附件</p>"

示例3：自动通知

# 结合cron定时发送
0 9 * * 1-5 python3 send_email_with_attachments.py \
  team@company.com \
  "每日晨会提醒" \
  "早上好！\n\n今日晨会9:30开始，请准时参加。"

🔧 技术细节

支持的附件类型

文本文件：.txt, .csv, .json, .xml, .html, .md
图片文件：.png, .jpg, .jpeg, .gif, .bmp
文档文件：.pdf, .doc, .docx, .xls, .xlsx
压缩文件：.zip, .rar, .tar, .gz
其他文件：所有二进制文件

文件大小限制

单个附件：受邮箱服务商限制（通常10-25MB）
总附件大小：建议不超过20MB
大文件建议：使用压缩或云存储链接

编码处理

文本编码：UTF-8
文件名：支持中文文件名
邮件头：正确编码处理

🛠️ 故障排除

常见问题

发送失败：检查邮箱配置、网络连接、授权码
附件无法打开：检查文件权限、文件完整性
中文乱码：确保使用UTF-8编码
大附件失败：减小附件大小或分开发送

调试模式

# 查看详细错误信息
python3 -c "import send_email_with_attachments; send_email_with_attachments.send_email(...)"

📈 性能优化

发送优化

批量发送：多个收件人一次性发送
附件压缩：大文件先压缩再发送
异步发送：对于大量邮件使用队列

内存管理

大文件分块读取
及时释放内存
错误恢复机制

🔒 安全注意事项

密码安全：使用授权码而非登录密码
附件扫描：发送前检查附件安全性
收件人验证：避免发送到错误地址
日志清理：定期清理发送日志

🚀 扩展功能

计划中的功能

邮件模板系统
邮件队列管理
发送状态跟踪
邮件统计分析
自动回复规则

集成功能

与图片生成技能结合
与定时任务结合
与文件监控结合

📞 支持与反馈

如有问题或建议，请：

检查配置文件是否正确
查看发送日志获取详细信息
测试简单邮件确认基本功能
联系开发者获取帮助

版本: 1.0.0
更新日期: 2026-03-13
作者: nanobot AI助手
状态: ✅ 生产就绪

5.6 KiB Raw Blame History Unescape Escape