介绍：这是什么

🤖 本页要点已收录进 llms.txt——AI 代理可直接读取。

goagent-kernel 是多智能体编排的通用内核。 一句话定位：编排是代码，LLM 只做单环节—— 它只提供确定性编排的机制面，不认识任何领域概念。

所谓机制面，是这些与「给谁干活」无关的东西：

• 报告协议（protocol）：模型输出怎么变成可信的结构化报告；
• 工具判定环（tooldisclose / guardset / toolfail / policy / dispatch）： 一次工具调用从披露、守卫、审计到派发拓扑的完整判定链；
• 编排契约与续跑（contract / statemachine / checkpoint / commitgate）： 环节状态怎么流转、崩了怎么接着跑、终态怎么独占；
• 上下文预算（budget / spill / offload）：有限的上下文窗口怎么不被撑爆；
• 执行沙箱（ptc / sandbox）：模型写程序、沙箱执行、原始数据不过模型面。

机制 vs 资产：什么不属于本仓

左列全部「与领域无关」，右列全部「换宿主就变」——这条线由门禁守，不由 review 守。

判定口诀：「这个包需要知道自己在给谁干活吗？」需要 → 属于宿主。

再直白一点：换个宿主，这段代码要不要改？要改的就不该在内核里。

你会拿到什么

内核的接口设计原则是：内核只判定，不处置——它告诉你「该阻断」「该重试」「不可归类」， 动作由宿主执行。所以每个能力包要你提供的都是你的基础设施（存储、通道、拓扑）， 而不是业务逻辑。

在依赖链上的位置

依赖链单向：本仓 import 上游，宿主 import 本仓——反向依赖是门禁红线。

两个上游都是公开的 Go 模块矩阵，各有文档站，值得一并了解：

oekit — Open Easy Kit（开源 · 易用 · 工具集合） 一套按「框架耦合分层」组织的 Go 模块矩阵：37 个独立发版单元（微工具库、日志/追踪/ 指标门面、注册发现、HTTP/Kitex 框架生态、应用引导），依赖严格自底向上，每仓独立 SemVer + 独立 CI。本仓站在它上面的是三块基础件：oekit/pkg（errors / stringx / encoding 等微工具）、oekit/concurrency（GoSafe 等并发原语）、oekit/logx（日志门面）。🤖 AI 直读：oekit.github.io/llms.txt。

oagentkit — Open Agent Kit（Agent / LLM 编排工具链 模块矩阵）13 个独立发版的 Go 模块：模型客户端、MCP 工具池、技能库、知识检索、 Agent 编排、运行时基础设施；与 oekit 是姊妹项目（依赖其 pkg / concurrency / logx）， 同为「框架耦合分层」组织。本仓的判定语义核心多落在它上面——派发守卫核心在 oagentkit/agent/dispatch、判定环与沙箱在 oagentkit/guardx（invoke / sandbox / injectband）、审计门在 oagentkit/toolgate、进程原语在 oagentkit/runtime/procx； 本仓的门面包（dispatch / policy / reminder / toolfail / sandbox）只做 调用面转发，核心实现在上游——跨宿主必须一致的判定语义不放两份实现。 🤖 AI 直读：oagentkit.github.io/llms.txt。

• 独立发版、版本化引入、零 replace：go.mod 含 replace 即门禁红（公开 module， replace 会让下游 go get 整体失败）。本地多仓并行开发走 make devlink 的 workspace。
• 依赖全部为 public 模块（github.com/oekit/*、github.com/oagentkit/*）。
• 按包引入：contract / statemachine 是零外部依赖的叶子包——只想要状态机， 不必拖进 goja、jsonschema。
• 平台支持：linux/amd64、linux/arm64、darwin/arm64 每次 make check 交叉构建验证； windows/amd64 可编译，进程树语义降级（无进程组信号，TERM 优雅退出降级为整树硬终止）。

文档地图