snail-mail

Snail Mail 是一款专为 Agent 与操作员设计的"慢通道"通信工具，旨在解决传统即时通知带来的干扰问题。它提供了一个优雅的中间地带，让 Agent 能够记录重要但非紧急的事件，而操作员可以在合适的时间统一查看处理，实现真正高效的人机协作。

核心用法

该 Skill 通过本地 CLI 脚本提供完整的消息生命周期管理。Agent 可以使用 inbox.js add 命令创建消息，根据紧急程度标记为 [URGENT]、[IMPORTANT] 或普通级别。消息内容应简洁明了，包含事件描述、影响评估及所需行动。操作员通过 render 命令查看消息，支持 HTML、Markdown 和纯文本三种格式，可自动适配不同聊天渠道（如 Telegram 用 HTML，Discord 用 Markdown）。此外，Skill 支持心跳集成，可在定期检查中主动推送未读的紧急消息，确保关键事项不被遗漏。

显著优点

首先，Snail Mail 采用零依赖设计，仅使用 Node.js 内置模块，彻底消除了供应链攻击风险。其次，数据完全本地存储，通过原子写入机制（先写临时文件再重命名）确保数据完整性，即使系统崩溃也不会损坏消息文件。安全性方面，HTML 输出经过转义处理，有效防止 XSS 攻击。功能设计上，它完美填补了"实时聊天"与"完全静默"之间的空白，通过分级优先级系统（urgent/important/normal）确保真正紧急的事务仍能得到及时处理，同时避免 routine success 等低价值信息的噪音干扰。

潜在缺点与局限性

该 Skill 设计为单写入者模式，不支持多 Agent 并发写入，在分布式或多 Agent 协作场景中可能成为瓶颈。数据存储仅依赖本地 JSON 文件，缺乏加密机制，不适合存储敏感信息如密码或密钥。错误处理相对简单，当存储文件损坏时会静默重置，可能导致历史数据丢失。此外，没有内置的远程同步或备份机制，如果工作目录丢失，消息将永久消失，需要用户自行建立备份策略。

适合的目标群体

Snail Mail 特别适合需要长时间自主运行的自动化 Agent 开发者，以及注重工作流连续性的知识工作者。对于运营监控场景（如服务器状态、社交媒体提及、异常检测），它提供了比即时通知更优雅的通知方式。同样适合作为个人助理 Agent 的"备忘录"系统，记录需要日后关注但当前无需立即响应的事项，帮助用户保持专注。

使用风险

虽然采用原子写入，但文件系统级的损坏仍可能导致数据丢失，建议定期手动备份 {workspace}/inbox/messages.json。随着长期使用，存储文件可能膨胀，需要考虑归档策略（Skill 提供了 archive 功能）。最大的风险在于消息分级的主观性——如果将真正紧急的事件误判为 normal 级别，可能导致响应延迟。此外，由于输入参数缺乏严格类型验证，异常输入可能导致脚本行为不可预测，建议在使用时进行参数预检查。