Execute shell commands for system operations, directory creation, and script execution. When you need to run system commands, execute scripts, install packages, or manage processes. Note - if commands fail consecutively, try different approaches.
执行 Shell 命令。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| command | string | 是 | 要执行的 Shell 命令 |
| cwd | string | 否 | 工作目录（可选） |
| timeout | integer | 否 | 超时时间（秒），默认 60，范围 10-600 |
列出目录:
{"command": "ls -la"}
安装依赖:
{"command": "pip install requests", "timeout": 300}
在指定目录执行:
{"command": "npm install", "cwd": "/path/to/project"}
系统会自动将 PowerShell 命令通过 -EncodedCommand（Base64 UTF-16LE）编码执行，
避免 cmd.exe → PowerShell 的多层引号/特殊字符转义破坏。直接传入 PowerShell 命令即可。
| 场景 | 推荐方式 | 原因 |
|---|---|---|
| 简单系统查询（进程/服务/文件列表） | PowerShell cmdlet | Get-Process, Get-ChildItem 等一行搞定 |
| 复杂文本处理（正则、URL 提取、HTML/JSON 解析） | Python 脚本 | 避免 PowerShell 正则 one-liner 的复杂性 |
| 批量文件操作（重命名、过滤、转换） | Python 脚本 | 更可靠，不受 PowerShell 管道转义影响 |
| 网络下载/HTTP 请求 | Python 脚本 | requests/urllib 比 Invoke-WebRequest 更灵活 |
对于复杂文本处理任务，务必使用 write_file + run_shell 组合：
步骤 1: write_file 写入 data/temp/task_xxx.py
步骤 2: run_shell "python data/temp/task_xxx.py"
禁止：在 run_shell 中写包含复杂正则的 PowerShell one-liner，例如：
# 禁止这种写法
powershell -Command "Get-Content file.html | Select-String -Pattern '(?<=src=\")[^\"]+' | ForEach-Object { $_.Matches.Value } | Sort-Object -Unique | Out-File urls.txt"
应改为写 Python 脚本：
import re
from pathlib import Path
html = Path("file.html").read_text(encoding="utf-8")
urls = sorted(set(re.findall(r'src="([^"]+)"', html)))
Path("urls.txt").write_text("\n".join(urls), encoding="utf-8")
get_session_logs 查看详细日志write-file: 写入文件read-file: 读取文件