核心功能
snail-mail 是一个"慢通道"消息收件箱系统，专为 AI Agent 与操作者之间的非即时沟通设计。它在 {workspace}/inbox/messages.json 中持久化存储消息，通过 CLI 脚本提供完整的增删查改能力。
核心用法
写入时机：仅当事件"值得操作者知晓但不值得打断"时写入——需要人类决策的事项、异常情况、有趣的机会点、可能有后续价值的背景信息。明确排除日常成功日志、已口头告知的内容、无意义的重复事件。
三级优先级：[URGENT]（数小时内处理）、[IMPORTANT]（今日查看）、无前缀（常规）。标题要求包含 WHO/WHAT，正文 1-3 句话说明事件、意义与待办。
呈现方式：根据渠道自动选择 HTML（Telegram/webchat）、Markdown（Discord/Slack）或纯文本（SMS）。支持 render、list、read、archive 等完整生命周期管理。
显著优点
1. 注意力管理哲学：区分"通知"与"中断"，尊重操作者深度工作需求
2. 结构化优先级：强制分类避免"所有消息都是紧急"的警报疲劳
3. 原子写入安全：使用 tmp+rename 模式防止 JSON 损坏
4. 多格式渲染：原生适配不同通讯渠道
5. 心跳集成：可在定时任务中自动检查并上报紧急事项
局限性与风险
- 单写者假设：设计假定仅 Agent 写入，多进程并发需外部协调
- 无内置加密：消息明文存储于工作目录
- 无远程同步：依赖文件系统，跨设备场景需额外同步机制
- 无保留策略：长期运行可能积累大量归档消息
- JSON 单文件：高并发写入场景存在性能瓶颈
适合人群
长期运行 AI Agent 的开发者、需要异步监督自动化流程的操作者、重视"非打扰式沟通"的专业用户。
安全评估
存储路径可控（工作目录内），无网络外连，无代码执行能力。主要风险在于文件权限配置不当导致敏感信息泄露。