Struct ShellTool 

pub struct ShellTool { /* private fields */ }

Shell 工具：执行系统命令。

支持超时和输出限制，防止命令执行时间过长或输出过大。

安全机制

• 命令黑名单检查
• 危险操作符检测
• 路径遍历防护
• 安全的环境变量（清除敏感变量）
• 超时和输出大小限制

适用场景：

• 执行系统命令
• 运行脚本

输入格式：

{
  "command": "要执行的命令",
  "args": ["命令参数"],
  "timeout": 60,  // 可选，超时时间（秒）
  "working_dir": "/path/to/dir"  // 可选，工作目录
}

Implementations

impl ShellTool

pub fn new() -> Self

创建一个新的 ShellTool 实例（使用默认安全配置）。

pub fn with_allowed_commands(self, commands: Vec<String>) -> Self

设置允许的命令白名单。

如果设置了白名单，只有白名单中的命令可以执行。

pub fn with_forbidden_commands(self, commands: Vec<String>) -> Self

添加额外的禁止命令。

Trait Implementations

impl Default for ShellTool

fn default() -> Self

Returns the “default value” for a type.

impl Tool for ShellTool

fn name(&self) -> &str

工具名称（必须唯一）

fn description(&self) -> Option<&str>

工具描述（可选）

fn categories(&self) -> &'static [ToolCategory]

工具分类

fn input_schema(&self) -> Value

工具输入参数的 schema

fn call<'life0, 'async_trait>( &'life0 self, input: Value, ) -> Pin<Box<dyn Future<Output = Result<Value, ToolError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

执行工具

fn definition(&self) -> ToolDefinition

获取工具定义 (ToolDefinition)