自托管的 IM 传输层。换出口不会断、凭据不出服务边界、发送失败会告诉你为什么。
A self-hosted IM transport layer. It knows what a platform lets you do — not what you want to do with it.
| 平台 | 入站 | 出站能力 | 依据 |
|---|---|---|---|
| 企微 · 智能机器人 | wss | url-keyed | |
| 企微 · 自建应用 | cb | ip-gated | |
| 企微 · 群机器人 | — | url-keyed | |
| 公众号 | cb | ip-gated | |
| 飞书 / Lark | wss | url-keyed | |
| Slack | cb | url-keyed | |
| Telegram | poll | url-keyed |
★ 零入站主动发送实测成功。 url-keyed = 凭据在 URL/body/header 里,无调用方 IP 白名单,换出口不受影响。
实测WHY THIS LAYER EXISTS
协议代码原先住在每个应用进程里。改一句群文案要走出片链,加一个平台要改契约与闸三处,每个实例各自连平台。
搬出来之后:加一个平台 = 一个模块 + 一次重启。fd-bot 知道这个平台允许你做什么,不知道你要拿它做什么。
它只拥有一条语义——能力披露:每个适配器必须声明自己的出流形态,声明与发送代码同处一文件,服务启动即校验。缺声明不是警告,是进程起不来。这条规矩是被一次真实事故逼出来的:某条腿漏了声明,面板把一个能发的机器人报成了「寄不回去」。
MEASURED, NOT DECLARED
企微智能机器人原先只有 HTTP 回调:只能在一小时的被动窗口内回复,且受「企业可信 IP」约束——出口一漂,回答全部寄不出去。换成长连接之后,我们主动外连,没有调用方地址可供平台加白,也没有被动窗口。
媒体同样经得起查:一条含图片的消息产出信封,信封里的取件地址返回 234,816 字节的真实 JPEG(magic ffd8ffe0)。篡改的票据与格式非法的票据都回 410。删掉正在跑的 pod,新 pod 无人值守地把两条长连接重新建立,绑定从 Postgres 回来,受理队列补发期间到达的消息。
SIX ENDPOINTS, ONE ENVELOPE
| 方法 | 路径 | 做什么 |
|---|---|---|
| POST | /v1/bindings | 建一条腿;返回能力与回调地址 |
| GET | /v1/bindings | 列出,带连接健康 |
| DELETE | /v1/bindings/:id | 停连接再退休(不硬删) |
| POST | /v1/send | 发送;失败带分类,不带 5xx |
| POST | /v1/callbacks/:p/:s | 平台回调(POST 与 GET 握手) |
| GET | /v1/media/:ticket | 短期取件地址 |
事件信封 · 调用方不必按平台分支解析
THREE QUESTIONS
七条腿已经跑在生产上。源码、实测与运维手册都在仓库里。
打开仓库