Eventboat

v0.2.0-rc1

Fri, 04 Sep 2026 00:00:00 +0000

我们很高兴宣布 v0.2.0-rc1——Eventboat（Agent 原生事件路由器）的首个候选发布版本。

包含什么

Agent 原生：MCP 服务器 15 个工具覆盖完整生命周期（catalog → verify → test → explain → deploy → status → trigger → tail → 死信回放）
零自研语言：CEL 谓词（K8s 标准）+ Starlark 转换（Python 方言、沙箱、确定性）
可靠性引擎：spool + settle + checkpoint（SQLite），七条不变量测试， kill -9 从水位恢复，死信库可查可回放
作业管道：cron 调度、补偿窗口、重叠策略、类型化参数（回补）
扩展阶梯：CEL → Starlark → WASM（wazero）→ gRPC 进程外插件
CESQL 方言：CloudEvents 互操作（可选），官方 TCK 100%
LSP：编辑器诊断、补全、hover
CLI：11 个命令，基于 lynx-go/commands， --json 输出面向 Agent 和 CI

快速上手

go install github.com/eventboat/eventboat/cmd/eventboat@v0.2.0-rc1
eventboat help

→ 完整 CHANGELOG

安装

Mon, 01 Jan 0001 00:00:00 +0000

前提

Go 1.25+（从源码构建）
零运行时依赖——全部编译进一个二进制

安装

go install github.com/eventboat/eventboat/cmd/eventboat@latest

验证：

什么是 Eventboat？

Mon, 01 Jan 0001 00:00:00 +0000

Eventboat 通过有向无环图（DAG）路由事件——从源（Kafka、HTTP、cron、SQL、文件）到汇（Kafka、HTTP、文件），保证 at-least-once 投递、死信可查可回放。

CLI 参考

Mon, 01 Jan 0001 00:00:00 +0000

总览

eventboat [--json] verify --config <pipeline.yaml> [--strict]
eventboat [--json] test <testfile-or-dir> [...]
eventboat run --config <pipeline.yaml> [--data-dir DIR] [--ephemeral]
eventboat run --config-dir <dir> [--runtime runtime.yaml]
eventboat [--json] trigger --config <job.yaml> [--parameters '{"from":"..."}']
eventboat [--json] jobs list --config <job.yaml> [--limit N]
eventboat [--json] jobs show <run-id> --config <job.yaml>
eventboat [--json] explain --config <pipeline.yaml> [--message f.json] [--topology]
eventboat [--json] replay --config <pipeline.yaml> (--dlq | --spool --from N | --job <run-id>) [--dry-run]
eventboat repl [--message sample.json] [--cel 'expr' | --script f.star]
eventboat lsp
eventboat [--json] plugin catalog
eventboat [--json] plugin schema <name>
eventboat mcp (--stdio | --http) [--config-dir <dir>] [--data-dir DIR]

verify

静态验证管道。检查 schema、拓扑不变量（无环、无孤立节点、源无入边、汇无出边、至少一条源→汇通路）、CEL 谓词编译、Starlark 脚本编译、作业配置和语义 lint。

第一条管道

Mon, 01 Jan 0001 00:00:00 +0000

三段式格式

每个 Eventboat 管道是一个 YAML 文件，三个顶层段：sources、transforms、 sinks——通过 from 连边。

apiVersion: eventboat/v3
kind: Pipeline
metadata: { name: my-first-pipeline }

sources:
 ingest:
 cron: { expression: "*/5 * * * *" } # 每 5 分钟

transforms:
 hello:
 from: [ingest]
 script: |
 payload.greeting = "hello from eventboat"
 payload.timestamp = meta.ingest_time

sinks:
 console:
 from: [hello]
 drop: {} # 丢弃（演示用）

验证（关卡 1）

eventboat verify --config pipeline.yaml

输出：pipeline.yaml: 0 error(s), 0 warning(s)

架构

Mon, 01 Jan 0001 00:00:00 +0000

三层模型

YAML (+overlay) → Config（类型化）→ Static IR → Runtime Engine
 ↓
 Source → Transform → Sink 插件

Config 层：YAML 解析、严格 schema 校验、变量替换
Static IR：校验后的 DAG + 预编译 CEL 程序 + Starlark 程序 + schema
Runtime：spool + settle + checkpoint 引擎，只消费 IR

可靠性模型

source → [spool: 追加式持久队列] → 内存 DAG → sinks
 │ │
 └── checkpoint ←── settle 跟踪 ←── 终态

Spool：每条消息先落 SQLite 再进 DAG（不变量 1）
Settle：消息的全部分支到达终态即 settle
Checkpoint：只推进已 settle 的连续前缀（不变量 2）
崩溃恢复：kill -9 → 重启 → 从 checkpoint 重放，绝不丢（不变量 3）
死信：重试耗尽 → 死信库（可查询 + 可回放）

七条不变量测试

每条都有专属测试，CI 必须通过：