HERA 邮件系统

HERA 研究助理框架内用于智能体间通信的内部邮件系统。

快速开始

查看收件箱

python3 {baseDir}/scripts/list_inbox.py 

阅读邮件

python3 {baseDir}/scripts/read_mail.py  

发送邮件

python3 {baseDir}/scripts/send_mail.py   "" 

智能体名称

邮件格式

[FROM: agent-name]
[TO: agent-name]
[TIMESTAMP: YYYY-MM-DD HH:MM:SS]
[MAIL-ID: unique-id]
[SUBJECT: subject text]
[STATUS: unread]

---

邮件正文内容在此。
无需正式问候语——请直接、简洁地表达。

---
[END]

附件

附件存储于：

hera-agents//inbox/attachments//

支持类型：PDF、图像、数据文件、代码及任意文件类型。

工作流

工作流 1：检查并阅读邮件

1. 列出收件箱：list_inbox.py
2. 识别未读邮件（标记为 [○]）
3. 阅读指定邮件：read_mail.py
4. 邮件将自动标记为已读

工作流 2：发送带附件的邮件

# 向 Rough Reader 发送论文
python3 send_mail.py group-leader rough-reader "Review this paper" /path/to/paper.pdf

# 向 Report Writer 发送数据可视化结果
python3 send_mail.py intensive-reader report-writer "Analysis results" /path/to/figure.png /path/to/data.csv

工作流 3：交互式发送（邮件正文从标准输入读取）

cat <
邮件类型



类型
发送方
接收方
用途



Task Assignment
Group Leader
Any agent
分配新任务


Work Submission
Any agent
Coordinator/Leader
提交已完成的工作


Review Request
Any agent
Rough Checker
请求质量检查


Information Request
Any agent
Reader agents
请求分析支持


Data Transfer
Any agent
Any agent
共享文件或数据


最佳实践

直截了当——无需正式问候，开门见山
主题明确——主题行应准确概括任务或请求内容
附上相关文件——根据需要附加论文、数据、代码等
定期检查收件箱——各智能体应主动监控自身收件箱
标记重要邮件——使用邮件 ID 作为后续通信中的参考标识

目录结构
hera-agents/
├── /
│   ├── inbox/           # 收到的邮件
│   │   ├── *.md         # 邮件文件
│   │   ├── *.read       # 已读标记
│   │   └── attachments/ # 每封邮件对应的附件
│   └── outbox/          # 已发送邮件副本
│       └── *.md
└── skills/hera-mail/
    ├── scripts/
    │   ├── list_inbox.py
    │   ├── read_mail.py
    │   └── send_mail.py
    └── references/

示例
示例 1：Group Leader 向 Rough Reader 分配任务
cat <
示例 2：Intensive Reader 向 Report Writer 发送分析结果
python3 send_mail.py intensive-reader report-writer "Analysis complete: Quantum Error Correction" 
    /workspace/analysis/summary.md 
    /workspace/analysis/key_findings.csv 
    /workspace/figures/error_rates.png

示例 3：Coordinator 请求质量检查
python3 send_mail.py coordinator-1 rough-checker-1 "QC needed: Literature review draft" 
    /workspace/drafts/lit_review_v1.md

故障排查
找不到收件箱：请确认 hera-agents/ 下存在对应智能体的目录
邮件未送达：请检查收件方智能体名称是否正确
附件缺失：请确认文件路径为绝对路径且文件确实存在
权限被拒绝：请确保脚本具有可执行权限：
chmod +x /Users/zhaoruiwu/.openclaw/workspace/hera-agents/skills/hera-mail/scripts/*.py