rucora-tools 0.1.5

Built-in tools for rucora (shell, file, HTTP, git, web search, etc.)
Documentation

rucora Tools

rucora 的内置工具实现。

概述

本 crate 包含 rucora 的 16+ 种工具的具体实现。每个工具提供一种特定能力，可以在 Agent 执行期间被调用。

可用工具

工具 分类 说明
EchoTool 基础 回显输入内容
ShellTool 系统 执行 Shell 命令
CmdExecTool 系统 受限的命令执行
GitTool 系统 Git 操作
FileReadTool 文件 读取文件内容
FileWriteTool 文件 写入文件内容
FileEditTool 文件 编辑文件内容
HttpRequestTool 网络 HTTP 请求
WebFetchTool 网络 抓取网页内容
BrowseTool 浏览器 浏览网页
BrowserOpenTool 浏览器 打开浏览器
MemoryStoreTool 记忆 存储信息
MemoryRecallTool 记忆 检索信息
DatetimeTool 工具 日期时间操作
GithubTrendingTool GitHub GitHub 趋势
SerpapiTool 搜索 SerpAPI 搜索
TavilyTool 搜索 Tavily 搜索
GlobSearchTool 搜索 Glob 文件搜索
ContentSearchTool 搜索 文件内容搜索
CalculatorTool 数学 数学计算
ImageInfoTool 媒体 图片信息读取

安装

[dependencies]

rucora-tools = "0.1"

或通过主 rucora crate：

[dependencies]

rucora = { version = "0.1", features = ["tools"] }

使用方式

Shell 工具

use rucora_tools::ShellTool;
use rucora_core::tool::Tool;

let tool = ShellTool::new();
let result = tool.call(serde_json::json!({
    "command": "echo hello"
})).await?;

文件工具

use rucora_tools::{FileReadTool, FileWriteTool};

let read_tool = FileReadTool::new();
let content = read_tool.call(serde_json::json!({
    "path": "/path/to/file.txt"
})).await?;

HTTP 请求工具

use rucora_tools::HttpRequestTool;

let http_tool = HttpRequestTool::new();
let response = http_tool.call(serde_json::json!({
    "method": "GET",
    "url": "https://api.example.com/data"
})).await?;

记忆工具

use rucora_tools::{MemoryStoreTool, MemoryRecallTool};
use std::sync::Arc;
use rucora_core::memory::InMemoryMemory;

let memory = Arc::new(InMemoryMemory::new());
let store_tool = MemoryStoreTool::new(memory.clone());
let recall_tool = MemoryRecallTool::new(memory);

模块结构

模块 说明
file 文件读、写、编辑工具
basic Echo 等基础工具
system Shell、受限命令执行、日期时间、Git 工具
web HTTP、网页抓取、浏览、SerpAPI、Tavily、GitHub Trending
search Glob 文件搜索、内容搜索
math 数学计算
media 图片信息读取
memory 记忆存储和检索

当前 crate 默认编译全部内置工具；Cargo.toml 暂未定义按模块裁剪的 feature。

安全说明

ShellTool

  • 命令通过 Shell 执行（Windows 使用 cmd /C，Linux/macOS 使用 sh -c）
  • 默认阻止危险的 Shell 操作符
  • 环境变量会被清除，只保留安全变量

文件工具

  • 检测路径遍历攻击
  • 可配置路径验证

HTTP 工具

  • URL 验证（必须以 http:// 或 https:// 开头）
  • 可配置最大重定向次数
  • 支持超时设置

许可证

MIT