tools

README

tools

外部工具接入——CLI 编码 agent 统一调用/公开资料检索/git 工作副本沙箱/确定性 SAST 扫描 —— oagentkit 模块矩阵 tier 2（集成层，依赖 tier0/tier1 + 重第三方地板）。

go get github.com/oagentkit/tools

包	职责
acpx	CLI 编码 agent 统一调用（claude / codex / gemini / kimi / mcode 等）
websearch	公开资料检索抽象，接口可插拔（缺省 SearXNG 自建实例）
workcopy	Git 工作副本沙箱：隔离环境 + merge-base 校验
sast	确定性 SAST 前置扫描（不执行被扫代码）

定位

tier 2 — 集成层，依赖 tier0/tier1 + 重第三方地板。

• 本仓依赖的矩阵内仓：guardx、runtime、textx。

外部依赖地板

• github.com/cloudwego/eino

与 oekit 的关系

本矩阵（oagentkit，Agent/LLM 编排工具链）依赖 oekit（Open Easy Kit，Go 微服务工具链）： oekit/pkg / oekit/concurrency / oekit/logx 等。oekit 是另一套独立矩阵，不是子品牌。

开发

go test ./... -race
go vet ./...
gofmt -l .

规范见 AGENTS.md。

License

MIT

• CLI 编码 agent 调用必须隔离环境（用 runtime.ChildEnv 构造最小环境）， 不得继承完整宿主环境 —— 凭据泄漏面。
• workcopy 的 git 操作必须限制在沙箱目录内，EnsureMergeBase 失败要显式报错， 不得跳过继续。
• SAST 扫描是确定性前置扫描，不执行被扫代码。