版本与兼容性
如何理解 ExecGo 与 execgo-runtime 的独立发布关系。
ExecGo 与 execgo-runtime 应继续独立发布。一个统一的网站可以把它们放在一起展示，但不应该强行要求两者共享同一个版本号。
兼容边界
兼容边界是 runtime HTTP API：
- ExecGo 的
runtimeexecutor 向/api/v1/tasks提交任务。 - 它通过
/api/v1/tasks/{id}轮询状态。 - 它通过
/api/v1/tasks/{id}/kill请求取消。 - 它可以从
/api/v1/runtime/info、/api/v1/runtime/capabilities、/api/v1/runtime/resources和/api/v1/runtime/config读取 runtime 元数据。
只要这些契约保持兼容，两个项目就不需要同步打同一个 tag。
推荐矩阵
| ExecGo 线 | Runtime 线 | 建议 |
|---|---|---|
release/agent-adapter-runtime | execgo-runtime 1.1.x | 默认集成路径 |
preview/distributed-runtime | runtime main 或 preview build | 用于分布式 runtime 验证 |
| 本地开发 | 本地源码 checkout | 在测试记录中固定两个 commit |
生产发布时，应在部署清单中同时记录两个版本。runtime 升级应按数据面 rollout 处理：先探测 readiness，再把控制面任务路由到升级后的 runtime。