13 个独立发版模块
每仓独立 SemVer + 独立 CI，依赖严格自底向上。不用被最慢的那个依赖拖住升级节奏。
oagentkitOpen Agent Kit
Agent / LLM 编排工具链模块矩阵
Skip to content
模块矩阵
13 个独立发版的 Go 模块，按框架耦合度分四层。tier N 不得依赖 tier > N。
悬停看依赖 · 点击进模块页
纯 Go 模块直接依赖 eino（框架层）箭头方向 = 依赖方 → 被依赖方 · tier N 不得依赖 tier > N
| 模块 | 层 | 说明 | 仓内依赖 |
|---|---|---|---|
guardx | tier 0 | 安全围栏——凭据脱敏/URL 出口 SSRF 防护/工具许可判定链/提示注入卫生（tier0 零外部依赖底座） | — |
runtime | tier 0 | Agent 进程运行时——LLM token 流式节控/泛型事件总线/子进程最小环境/运行时热插拔/生命周期钩子 | — |
textx | tier 0 | 文本与差异处理——增量切片/unified diff 解析/代码符号索引/会话滚动窗口与压缩/评审报告指纹 | — |
promptx | tier 1 | 提示词上下文——system prompt 分段组装/运行中转向队列/文件读后写一致性状态 | runtime、textx |
llm | tier 2 | 模型客户端——多模型降级链/任务级预算/成本记账/分阶段路由/LLM 调用观测 | textx |
mcpkit | tier 2 | MCP 工具池——客户端封装/工具目录/建连单飞/自愈与租约管理 | runtime |
obs | tier 2 | 观测与审计——Langfuse 追踪客户端/敏感操作结构化审计（不引 eino 框架） | guardx |
queue | tier 2 | DB 即队列 + Postgres Lease 选主——任务表驱动的工作池与主备单活回调 | — |
rag | tier 2 | 知识检索——向量化/混合召回/重排，向量后端可插拔 | textx |
skillkit | tier 2 | 技能与资产契约——SKILL.md 渐进披露/领域包布局契约/装配血缘图 | textx、guardx |
toolgate | tier 2 | 工具治理——优先级三层约束/注解驱动并发调度/操作审计门/构造期不可绕过的工具调用链 | guardx、mcpkit |
tools | tier 2 | 外部工具接入——CLI 编码 agent 统一调用/公开资料检索/git 工作副本沙箱/确定性 SAST 扫描/Shell 命令静态裁决 | textx、runtime、guardx |
agent | tier 3 | Agent 编排——ReAct 运行样板/计划先行/反思循环/意图路由/多专家黑板/派发守卫 | llm、textx |
别引门面仓
安装一律用上表的模块路径。不要引门面仓 oagentkit/agentkit —— 它只是原单仓的 re-export 兼容层（46 包零逻辑转发），按 README 写死的期限在 v1.x 后退役。
基建
| 仓 | 作用 |
|---|---|
.github | org profile + 全 org 共享 CI 门禁（reusable workflow） |
matrix-tools | 版本矩阵生成 / 依赖方向审计 / import 改写 / 建仓 |
versions.json | 机器可读版本矩阵（由 matrix-tools/scripts/gen_versions.py 生成） |
llms.txt | LLM 模块索引，46 包映射 |
与 oekit 的关系
oagentkit 与 oekit（Open Easy Kit，Go 微服务工具链）是两套独立矩阵， 不是子品牌。两者只共享 o / kit 元素。
oagentkit 依赖 oekit 的三个包：
github.com/oekit/pkg— 微工具集（errors / stringx / encoding / mathx）github.com/oekit/concurrency— goroutine 池 / 单飞 / 重试 / 令牌桶 / 滑动窗口 / 时间轮github.com/oekit/logx— 日志门面
反过来不成立。要看微服务侧的 24 个模块怎么分层，直接去 oekit 文档站或它的架构总览。
姊妹项目详解 → —— 两套矩阵的定位对比、依赖边界、24 模块分层与易混点。
撞名提醒
按包名对齐会做错。两边都有 progress 和 breaker，但语义相反或不同族—— oekit/concurrency/progress 是长任务阶段进度追踪器， oagentkit/runtime/progress 是泛型事件总线。详见架构总览。