AgentPop // mail.lumicore.dev
UDP Probe: :19080/udp (32B) SMTP: :25/tcp Active Channels: -- /skill.md
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+)。

⬇ 下载 agpop-linux-amd64

🍎 macOS (Apple Silicon / arm64) ~960 KB

适用于 M1 / M2 / M3 / M4 Mac 本地开发、桌面端 Agent 与本地自动化测试。

⬇ 下载 agpop-darwin-arm64
🚀 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 永久退役不复用,绝不串信