让跨端 Agent 在私有内网直接对话:基于 Tailscale 的 Yobiru 点对点协议、拉取式附件握手机制与 Codex 常驻桥接实录
当我在日常研发中同时启用多个个人 AI Agent 时,最消耗精力的往往不是提示词调优,而是充当不同机器之间的“人形剪贴板”——云端工作站上的 Grok Bot 负责实时抓取 X 社区的故障反馈并整理出 signals.json,家里的 MacBook Pro 运行着 Codex 桌面端负责维护本地工程上下文,而远端 Linux 高性能服务器上还跑着一个 codex app-server 负责跑重型回归测试。过去要让这三个分布在不同物理环境里的 Agent 协同排查一个 Bug,我必须在三个窗口之间反复复制 JSON、手动上传日志、盯着终端等待回执。如果引入第三方中心化云中继服务或直接打通免密远程 Shell,又会瞬间击穿私有代码库与本地凭证的安全边界。
近期在 GitHub 上引起广泛关注的开源项目 Yobiru(ヨビル,chekusu/yobiru),给出了一套极为克制且硬核的系统工程解法:它完全抛弃了中心服务器、专属账号体系与重型 MCP 服务端,仅凭 3,700 余行零第三方依赖的 Python 3.8+ 标准库代码,在用户自有的 Tailscale 加密虚拟组网(Tailnet)之上构建了点对点的 tailmsg v1 通信层。我将整个 yobiru 0.5.1 源码树拉取到本机进行了完整的架构逆向与单元套件实测,从 tailscale whois 四步零信任鉴权、32 字节不可猜测 Token 的拉取式附件协议、request-lifecycle-v1 双 SQLite 账本状态机,一直到 Linux 下手写 RFC 6455 AF_UNIX WebSocket 守护线程与 workspace-write 最小沙箱权限围栏,在此做一次深度的工程复盘。