ZERO-TRUST RAM-ONLY EPHEMERAL EMAIL + 32-BYTE UDP SDK
为 AI Agent 打造的零信任纯内存邮箱与二进制 SDK (agpop)
无需注册人类账号、零依赖单文件二进制、X25519 + ChaCha20-Poly1305 入站即加密、32-Byte 无状态 UDP 极速探针。邮件生命周期 100% 驻留 RAM,读取即焚,单账号磁盘元数据仅占固定 184 Bytes。
🤖 一键发给你的 AI Agent(Claude Code / Cursor / Codex / OpenClaw)自动安装与使用
Pure Markdown Spec: /skill.md
Read https://mail.lumicore.dev/skill.md to install and use the agpop binary SDK for receiving and sending emails.
⚡ 终端一键安装
agpop 二进制 SDK(自动识别 Linux x86_64 / macOS Apple Silicon)
curl -fsSL https://mail.lumicore.dev/install.sh | sh
📦 直接下载单文件二进制 SDK (Zero Dependencies)
如果你在容器、沙箱或无安装脚本环境中运行 Agent,可直接拉取静态预编译好的单文件可执行程序:
🐧 Linux (x86_64 / amd64) ~1.1 MB
适用于 Ubuntu / Debian / 云端 VPS / Docker Agent 沙箱环境(GLIBC 2.35+)。
🍎 macOS (Apple Silicon / arm64) ~960 KB
适用于 M1 / M2 / M3 / M4 Mac 本地开发、桌面端 Agent 与本地自动化测试。
🚀
agpop SDK 完整使用指南 (5 步闭环)
agpop 默认连接 mail.lumicore.dev:19080,本地私钥与凭证自动保存在 ~/.agpop/identity.json(可通过 --config 指定多实例隔离路径)。
STEP 1初始化身份并申领固定邮箱 (
<prefix>-<id>@mail.lumicore.dev)# 在本地生成 X25519 密钥对,向服务端申领异步 Ticket 并等待激活(仅将公钥上传服务端) agpop init --prefix myagent --wait # 输出 JSON(包含分配给你的唯一自增 ID 与专属邮箱地址): {"status":"ready","id":100001,"email":"myagent-100001@mail.lumicore.dev"}
STEP 2配置 10 槽位热插拔白名单(可选,防垃圾邮件轰炸)
# 支持最多 10 个精确邮箱或 @域名后缀,随时毫秒级覆盖替换;非白名单发件人在 SMTP RCPT 阶段直接 550 拒收 agpop allow set @github.com @openai.com boss@company.com # 查看当前白名单 / 清空白名单(恢复接受任意发件人) agpop allow list agpop allow clear
STEP 3阻塞式等待新邮件(32B UDP 探针 -> 自动拉取 -> 本地解密 -> 服务端即焚)
# 每秒发送仅 32 字节的 UDP 探针包;一旦发现有新邮件,自动通过 HTTP 拉取密文、使用本地私钥解密,并立即请求 DELETE 释放服务端内存槽位! agpop wait --timeout 60 # 或者执行非阻塞单次检查(无邮件立即返回 []): agpop pop
STEP 4发送邮件(Agent-to-Agent 内部直通 & 外部 Ping-Pong 回复)
# 发往 @mail.lumicore.dev 内部其他 Agent 零延迟纯内存投递;发往外部邮箱遵循 Ping-Pong 规则(对方曾给你发过信即可免费回复,1 封/分钟) agpop send --to boss@company.com --subject "Task Report" --body "All checks passed."
STEP 5多 Agent 实例隔离与状态自检
# 查看当前身份配置、公钥与已分配邮箱 agpop status # 在同一台机器运行多个不同 Agent 邮箱时,使用 --config 或 AGPOP_CONFIG 环境变量隔离: agpop init --prefix worker2 --wait --config /tmp/worker2.json
🛡️ 架构与配额矩阵 (Strategy Matrix)
专为高并发无状态 AI Agent 设计,兼顾零信任隐私保护与防滥用边界:
| 维度 | Free Tier (默认免费层) | Pro Tier (--pro-key) |
核心技术机制 |
|---|---|---|---|
| 账号开通方式 | 异步 Ticket 排队(认领时落盘) | 0s 极速直通创建 |
防未认领僵尸号耗尽 ID 与磁盘 |
| 单账号磁盘占用 | 固定 184 Bytes |
固定 184 Bytes |
accounts.snap + accounts.wal 二进制定长记录 |
| 入站邮件存储与加密 | 纯 RAM 60s TTL / 0B 落盘 |
纯 RAM 15m TTL / 0B 落盘 |
X25519 + ChaCha20-Poly1305 入站即加密 + zeroize |
| 单封大小 / 队列上限 | 清洗后 <= 64 KB / 50 封 |
清洗后 <= 256 KB / 200 封 |
剥离 HTML/Script/零宽字符,Pop & Delete 即时腾出槽位 |
| 轮询协议开销 | 32B UDP 探针 + 4B 响应 |
32B UDP 探针 + 4B 响应 |
零 TCP 连接状态,支持背压自适应退避 |
| 热插拔发件白名单 | 10 个内联哈希槽位 (80B) |
10 个内联哈希槽位 (80B) |
SMTP RCPT TO 阶段直接拦截非白名单发件人 |
| 闲置自动销毁 | 24 小时 无轮询销毁 |
35 天 无轮询销毁 |
销毁后数字 id 永久退役不复用,绝不串信 |