agentkit

README

agentkit（门面仓）

⚠️ 本仓是兼容门面，不是开发目标。 原单仓已拆分为 github.com/oagentkit/* 下 13 个独立发版的仓。 本仓只把 47 个包的导出符号做成别名转发，让下游只需改 import 前缀、无需改调用点。 另有 1 个包（breaker）已退役，不在此列——见 MIGRATION.md。 v1.x 后本仓退役。

为什么还有这个仓

原 module path 是 git.enjoye.top/enjoydream/agentkit。拆分意味着所有下游的 go.mod 都得改。直接 archive 会让下游在 go get 时拿到 404，破坏面比留一个门面大得多 —— 留门面至少给一个平滑过渡期。

代价是本仓会成为垃圾场：每个人都往里加东西，一年后又变回单体。所以设死退役时间表， 并且本仓不接受任何新功能，只做别名转发。

迁移

# 迁移前
import "git.enjoye.top/enjoydream/agentkit/textutil"

# 迁移后（47 个包的完整映射见 MIGRATION.md）
import "github.com/oagentkit/textx/textutil"

包名全部保留，只加了模块前缀，所以调用点一行都不用改。

一次性改写：

# 建议按 MIGRATION.md 的映射表逐包替换，逐条核对而不是一条通配。
# 通配 sed 的坑：新路径的模块段不是旧包名（worker/pglease -> queue/pglease、
# knowledge/rag -> rag），正则很难覆盖；且改写会打乱 import 组内字母序，
# 必须让 gofmt 重排，否则挂 CI 门禁。
#
# 用 matrix-tools 的脚本（只改 import 块内的引号字符串，改完自动 gofmt）：
python3 -c "import urllib.request;exec(urllib.request.urlopen('https://raw.githubusercontent.com/oagentkit/matrix-tools/main/scripts/rewrite_imports.py').read())" --org oagentkit --print-rules

推荐做法：按 MIGRATION.md 的映射表直接换到最终路径，不要先引门面 —— 门面只是过渡手段。

门面覆盖不到的东西

3 个泛型函数无法用变量别名转发（Go 的泛型函数不能赋值给变量）， 需要直接引用上游：

符号	上游路径
hotplug.NewHolder	github.com/oagentkit/runtime/hotplug
progress.NewBus	github.com/oagentkit/runtime/progress
reportutil.Aggregate	github.com/oagentkit/textx/reportutil

未导出符号（内部实现）不在门面范围内，这是 Go 包机制的固有边界。

模块矩阵

13 个仓，按 tier 严格自底向上：

tier	模块
0	textx runtime guardx queue
1	promptx obs skillkit mcpkit rag
2	llm toolgate tools
3	agent

License

MIT