Apron 聊天协议:一种用于自托管服务器的极简 JSON 聊天协议
Apron 是一种用于自托管聊天的极简协议,由 Hacker News 用户 shazow 在 apron.chat 上发布。其核心主张是一种刻意的权衡:核心足够小,以至于一个可用的服务器可以用大约 100 行代码编写,而可选功能则将其扩展到房间、线程、机器人、反应等。
该项目作为 Show HN 发布,在撰写本文时,Hacker News 线程上有 30 分且无评论。
该协议是 JSON 通过任何传输方式(包括 WebSocket)运行
Apron 没有定义自己的帧或传输方式。消息是通过任何传输方式发送的 JSON 对象,其中 WebSocket 作为示例给出。核心非常小,附加功能是可选的且渐进的,并具有优雅的回退机制,以便客户端或服务器可以忽略其未实现的功能。
该项目声明的设计原则是“只构建你需要的”。
发布示例中的会话如下所示。服务器首先自我通告:
{"method": "server", "params": {"apron": 10, "auth": ["guest"]}}
然后客户端进行身份验证:
{"method": "auth", "id": "c1", "params": {"scheme": "guest", "name": "Ada"}}
{"id": "c1", "result": {"you": {"user_id": "guest_1234", "name": "Ada"}}}
并发送一条消息:
{"method": "message", "id": "c2", "params": {"body": {"text": "Hello"}}}
{"method": "message", "params": {"room_id": "general", "from": {"user_id": "guest_1234"}, ...}}
{"id": "c2", "result": {"message_id": "1724803200042"}}
在该交换中可以看到三个结构细节。请求带有 method 和可选的 id;响应回显 id 并带有 result。服务器握手通告 "apron": 10 以及支持的身份验证方案,示例使用带有显示名称的 guest 方案。示例中的消息 ID 是毫秒风格的数字字符串,例如 1724803200042。
Apron 旨在供 AI 代理阅读和实现
该项目在 apron.chat/llms.txt 发布了一个面向代理的入口点。该文件链接了 Markdown 格式的规范、参考服务器、客户端、JSON Schema 以及用于测试的线缆夹具。
对于聊天协议来说,这是一个值得注意的选择:Apron 不是只向实现者提供散文文档,而是提供机器可检查的工件——一个 schema 和线缆夹具——以便生成的客户端或服务器可以根据实际消息格式进行验证。
公共演示展示了三种部署形态
该网站托管了一个公共演示服务器和一个 Apron Web 客户端,可以指向任何服务器。展示了三种场景以说明协议的范围:
- 团队聊天。 房间、线程、直接消息、机器人、回复、提及、终端、反应和在线状态。
- 家庭聊天。 私人房间、线程、回复、反应、头像和输入指示器。
- 支持服务台。 一群机器人,每个工单一个线程,以及一个在所有线程之间共享的单一答案。
这些场景是项目的论据,即极简核心不会限制功能上限:在线状态、输入指示器、线程和反应都可以作为可选功能层叠在相同的 JSON 消息形状上。
服务器和客户端是独立、可替换的部分
Apron 的结构使得服务器和客户端是独立的。该网站列出了参考服务器实现,旨在针对特定用例运行或修改,以及可以加入任何服务器的客户端。声明的目标是用户可以使用首选客户端加入任何服务器,或构建新的客户端。
由于协议是通过通用传输方式运行的 JSON,并且核心刻意保持较小,参考实现作为起点,而不是唯一支持的堆栈。
FAQ 列出了项目预期会被问到的问题
Apron FAQ 托管在项目的 GitHub 仓库中,解决了一系列反复出现的反对意见。发布的问题列表是:
- 你是谁?
- 你为什么制作 Apron 聊天协议?
- 有加密吗?安全吗?
- 为什么不用 XMPP/Matrix/IRCv3 等?
- 为什么不用 Slack/Discord/Zulip 等?
- 为什么又是另一个标准?XKCD 927!
- AI 是如何用于创建 Apron 的?这是垃圾吗?
- Apron 是一门生意吗?
- 为什么命名为 Apron?
- 好吧,我怎样才能试用它?
XKCD 927 问题(关于竞争标准的漫画)和“这是垃圾吗?”问题的存在表明作者预料到了两个具体的批评:新的聊天协议增加了碎片化而不是减少碎片化,以及 AI 辅助的项目可能不是严肃的工程努力。答案本身位于链接的 FAQ 中,而不是在落地页上。
源材料未确立的内容
落地页和 Hacker News 提交没有说明许可证、治理模型、安全或加密设计,或者除了握手示例中的 "apron": 10 值之外的版本历史。Hacker News 线程在收集时没有评论,因此这里没有社区讨论、反驳或维护者回应可以综合。评估 Apron 用于生产环境的读者应查阅从 apron.chat/llms.txt 链接的规范、JSON Schema 和线缆夹具,以及 GitHub 仓库中的 FAQ,而不是仅依赖落地页。