Help us shape the future of Go! Take the 2026 Go Developer Survey

tools

module
v0.10.1 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Oct 20, 2026 License: MIT

README

tools

外部工具接入——CLI 编码 agent 统一调用/公开资料检索/git 工作副本沙箱/确定性 SAST 扫描/Shell 命令静态裁决 —— 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 前置扫描(不执行被扫代码)
bashguard Shell 命令静态风险裁决(自 guardx/bashguard 迁入 v0.10.0):经真 shell AST 判定只读性,不执行命令

定位

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 扫描是确定性前置扫描,不执行被扫代码。

Directories

Path Synopsis
Package acpx 统一调用 CLI Coding Agent(claude / zcode / codex / opencode / minimax / kimi / gemini / qwen / mimo / pi / dsh 共 11 家,另有 GenericAgent 通用出口)。
Package acpx 统一调用 CLI Coding Agent(claude / zcode / codex / opencode / minimax / kimi / gemini / qwen / mimo / pi / dsh 共 11 家,另有 GenericAgent 通用出口)。
Package bashguard bash 命令静态风险解析:不执行命令,经真 shell AST (mvdan.cc/sh)解析成调用序列,按策略表判定只读性。
Package bashguard bash 命令静态风险解析:不执行命令,经真 shell AST (mvdan.cc/sh)解析成调用序列,按策略表判定只读性。
Package sast 确定性 SAST 前置扫描(收编自 argus internal/sastscan,v0.10.39, 对标 CodeRabbit 的 Semgrep/Snyk 集成):在工作副本上执行 gitleaks / semgrep, 产出归一为结构化 Finding——全程零 LLM,作为独立信号注入嵌入方的合并/裁决层。
Package sast 确定性 SAST 前置扫描(收编自 argus internal/sastscan,v0.10.39, 对标 CodeRabbit 的 Semgrep/Snyk 集成):在工作副本上执行 gitleaks / semgrep, 产出归一为结构化 Finding——全程零 LLM,作为独立信号注入嵌入方的合并/裁决层。
Package websearch 公开资料检索抽象:接口可插拔,缺省实现 SearXNG 自建实例 (免 API key、零调用成本)。
Package websearch 公开资料检索抽象:接口可插拔,缺省实现 SearXNG 自建实例 (免 API key、零调用成本)。
deepen.go 浅克隆工作副本的按需历史补全(收编自 argus internal/gitdeepen, v0.10.39)。
deepen.go 浅克隆工作副本的按需历史补全(收编自 argus internal/gitdeepen, v0.10.39)。

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL