sixel-email 是一个专为代理（agent）与人工操作员之间建立一对一通信通道而设计的工具。它通过电子邮件实现异步、安全的双向通信，确保代理在运行过程中能够及时上报状态、请求决策或获取指导，同时避免不必要的资源浪费。该服务采用严格的访问控制机制：每个代理仅能向一个预设的操作员地址发送邮件，且只有该操作员可以向代理发送邮件，从而有效防止信息泄露和误操作。 为了实现持续连接和可靠性保障，sixel-email 引入了心跳机制——即定期轮询 `/inbox` 接口以证明代理仍处于活跃状态。若长时间未轮询，系统将向操作员发出警报，提醒其检查代理运行情况。这种设计特别适用于需要长期运行、无人值守的任务场景，例如自动化部署、监控脚本或批处理作业等。此外，所有通信均基于 API 密钥进行身份验证，并建议使用背景轮询器（background poller）来减少对大语言模型（LLM）调用次数，从而节省 token 开销。 整体来看，sixel-email 提供了一种轻量级但高度可控的人机交互方式，既满足了现代 AI 代理对外部干预的需求，又兼顾了安全性与效率。无论是用于任务完成通知、错误报告、审批流程，还是作为调试阶段的辅助手段，它都能帮助构建更加健壮和可维护的自动化系统。
核心功能特点
- 一对一加密邮件通道：仅允许代理与指定操作员之间收发邮件，杜绝无关干扰和信息泄露风险。
- 内置心跳检测机制：通过定时轮询维持连接活性，超时未响应将触发操作员告警。
- 支持附件传输功能：可附加最多10个文件，总解码后大小不超过10MB，适用于日志、配置文件等数据传递。
- 低开销异步通信模式：推荐使用后台轮询脚本而非频繁调用 LLM 检查收件箱，显著降低 token 消耗。
- 严格的身份验证与安全策略：基于 API Token 认证，支持 Door Knock 一次性令牌保护，禁止明文传输敏感信息。
适用场景
sixel-email 最典型的应用场景是那些需要人类介入但又希望保持自动化的工作流。例如，当一个自动化任务即将执行关键操作（如数据库迁移、生产环境发布）时，代理可以通过发送一封简明扼要的邮件请求操作员批准；一旦获得许可，即可继续执行后续步骤。这种方式既保证了控制权掌握在人类手中，又避免了完全手动操作的繁琐性。 另一个常见用例是在长时间运行的服务或批处理任务中定期汇报进展。比如某项数据分析任务预计耗时数小时甚至几天，在此期间，代理可以每隔一段时间发送一次状态更新，内容包括当前进度、遇到的风险点以及下一步计划。这样操作员无需时刻盯着屏幕，只需在有新消息时查看即可掌握全局动态。 当代理陷入困境无法自行解决时（如遇到意外错误、依赖缺失或逻辑死循环），也可以主动求助。此时只需撰写一封包含详细上下文信息的邮件，说明问题现象、已尝试的解决方案及所需协助类型，等待操作员回复指引。由于整个过程是非阻塞的，代理可以在等待期间处理其他事务，提高整体工作效率。 最后，对于需要跨团队协作的项目而言，sixel-email 提供了一种标准化的沟通桥梁。不同角色的操作员可通过各自独立的账户管理对应的代理实例，形成清晰的责任边界，便于审计追踪和问题定位。