tools
外部工具接入——CLI 编码 agent 统一调用/公开资料检索/git 工作副本沙箱/确定性 SAST 扫描/Shell 命令静态裁决
概况
| 项 | 值 |
|---|---|
| 层 | tier 2 · 集成层（依赖 tier 0/1 + 重第三方地板） |
| oekit 对应 | kitex-examples |
| 仓内依赖 | textx、runtime、guardx |
| 被依赖 | —（矩阵叶子） |
| 第三方地板 | github.com/cloudwego/eino、mvdan.cc/sh/v3 |
| 包数 | 5 |
安装
bash
go get github.com/oagentkit/tools@latest源码与该仓 AGENTS.md：oagentkit/tools
包
| 包 | 说明 |
|---|---|
acpx | CLI 编码 agent 统一调用（claude / codex / gemini / kimi / mcode 等） |
websearch | 公开资料检索抽象，接口可插拔（缺省 SearXNG 自建实例） |
workcopy | Git 工作副本沙箱：隔离环境 + merge-base 校验 |
sast | 确定性 SAST 前置扫描（不执行被扫代码） |
bashguard | Shell 命令静态风险裁决（自 guardx/bashguard 迁入）：经真 shell AST 判定只读性，不执行命令 |
本仓硬规则
以下约束出自该仓 AGENTS.md。改代码前先读仓库根目录的 AGENTS.md，此处是摘要，不是替代。
- CLI 编码 agent 调用必须隔离环境（用
runtime.ChildEnv构造最小环境）， 不得继承完整宿主环境 —— 凭据泄漏面。 workcopy的 git 操作必须限制在沙箱目录内，EnsureMergeBase失败要显式报错， 不得跳过继续。- SAST 扫描是确定性前置扫描，不执行被扫代码。
bashguard自guardx/bashguard迁入（v0.10.0）：它依赖mvdan.cc/sh/v3（真 shell AST 解析），而 guardx 是 tier 0 零依赖底层。语义不变（静态解析、不执行命令），只是 import 路径变了。
日志约定
- 日志走
oekit/logx，组件 logger 用logx.Delegating("oagentkit-tools")。 - 子进程输出落日志前过
guardx/logredact—— 外部 CLI 的输出不可信。