Bash

概述

bash 工具在工作目录中执行 shell 命令。它使用自动分类器来判定命令是只读，还是需要写入/执行权限。

参数	类型	必填	说明
`command`	string	是	要执行的 shell 命令
`timeout`	integer	否	超时时间（秒，默认 120）

Rusty 会对 bash 命令进行分类，以自动判定权限要求。

这些命令被自动允许并绕过写入权限：

文件检查： ls、cat、head、tail、wc、find、file、stat、du

Git 读操作： git status、git log、git diff、git show、git branch、git remote

构建与测试： cargo check、cargo test、cargo clippy、cargo build、npm test、yarn test、pytest

包信息： npm list、cargo tree、pip list

系统信息： uname、whoami、pwd、which、env、date

这些命令在 default 模式下需要显式权限：

Git 写操作： git commit、git push、git checkout、git merge、git rebase、git stash

文件操作： rm、mv、cp、chmod、chown、mkdir、touch

包管理： npm install、pip install、cargo install

执行： docker、ssh、curl、wget、python、node

当命令通过管道连接时，分类器会检查整条管道。若所有组成部分都是只读的，则该命令被分类为只读：

# 只读：ls 管道给 grep
ls -la | grep ".rs"

# 写入：重定向到文件
echo "hello" > output.txt

bash 工具在执行命令前通过 check_bash_paths() 进行路径校验：

# 允许：项目内的相对路径
cat src/main.rs

# 阻止：沙箱外的绝对路径
cat /etc/passwd

# 阻止：沙箱外的重定向目标
echo "data" > /tmp/output.txt

{
  "command": "cargo check --workspace"
}

{
  "command": "git diff --stat HEAD~5",
  "timeout": 30
}

{
  "command": "python -m pytest tests/ -v",
  "timeout": 300
}