valkryhx/google_adk_agent / skills/bash
Bash Tool
Flagged【系统级后备工具】仅用于网络诊断、进程管理等基础任务。代码搜索/数据分析等应使用专用 skill。
tools.py
View on GitHub"""
Shell Executor Skill - 系统命令执行工具集
提供系统命令执行、进程管理、网络诊断等功能。
无需外部 API,直接使用系统原生命令。
"""
import subprocess
import asyncio
import platform
import os
import re
import psutil
from typing import Optional, List
def validate_command(command: str) -> tuple[bool, str]:
"""
验证命令安全性
Args:
command: 要执行的命令
Returns:
(是否安全, 拒绝原因)
"""
dangerous_patterns = [
'rm -rf', 'rm -fr', 'rm -r -f', 'rm -f -r', # 递归强制删除
'mkfs', 'fdisk', 'dd if=', # 格式化/磁盘操作
':(){:|:&};:', # Fork炸弹
'> /dev/sda', '> /dev/hda', # 直接写设备
'mv /', 'chmod -R 777 /', # 系统级破坏
# Windows Specific
'del /s /q', 'rd /s /q', 'rmdir /s /q', # Windows 递归删除
'format c:', 'format d:', # 格式化
'diskpart', # 磁盘分区工具
'shutdown', 'restart-computer', # 关机/重启
'taskkill /F /IM python.exe', 'taskkill /im python', 'taskkill /f /im python', # 防误杀同服组件
'pkill -f python', 'killall python', # 防跨平台误杀
'reg delete', # 注册表删除
'net user', 'net localgroup', # 用户/组修改
'takeown', 'icacls /grant', # 权限修改
'powershell -enc', # 混淆执行
]
for pattern in dangerous_patterns:
if pattern.lower() in command.lower():
return False, f"Command contains dangerous pattern: {pattern}"
command_lower = command.lower()
dangerous_regex_patterns = [
(
r'proc\.send_signal\s*\(\s*signal\.ctrl_c_event\s*\)',
"Command contains dangerous pattern: proc.send_signal(signal.CTRL_C_EVENT)"
),
(
r'stop-process\s+-name\s+python(?:\.exe)?\b',
"Command contains dangerous pattern: Stop-Process -Name python"
),
(
r'get-process\s+python(?:\.exe)?\b.*stop-process',
"Command contains dangerous pattern: Get-Process python ... Stop-Process"
),
(
r'taskkill\s+/f\s+/im\s+python(?:\.exe)?\b',
"Command contains dangerous pattern: taskkill /F /IM python.exe"
),
(
r'pkill\s+-f\s+python(?:\b|[\'\"])',
"Command contains dangerous pattern: pkill -f python"
),
]
for pattern, reason in dangerous_regex_patterns:
if re.search(pattern, command_lower, re.IGNORECASE | re.DOTALL):
return False, reason
if '$!' in command and platform.system() == 'Windows':
return False, "Windows cmd/powershell do not support $! for getting background PID. Write a short Python script with subprocess.Popen to properly start/terminate unblocking test servers."
return True, ""
async def _terminate_process(process: asyncio.subprocess.Process, *, grace_seconds: float = 2.0) -> None:
"""尽量优雅地终止子进程,失败时强制 kill。"""
if process.returncode is not None:
return
try:
process.terminate()
except ProcessLookupError:
return
except Exception:
try:
process.kill()
except ProcessLookupError:
return
return
try:
await asyncio.wait_for(process.wait(), timeout=grace_seconds)
except asyncio.TimeoutError:
try:
process.kill()
except ProcessLookupError:
return
await process.wait()
except ProcessLookupError:
return
def _cleanup_temp_file(tmp_file) -> None:
if tmp_file is None:
return
try:
os.unlink(tmp_file.name)
except FileNotFoundError:
pass
except Exception:
pass
async def bash(
command: str,
restart: bool = False,
timeout: int = 60,
shell: bool = True,
cwd: Optional[str] = None,
interruption_queue = None # 🔑 新增: 中断队列
) -> str:
"""
执行系统 Shell 命令 (Bash Tool) - 异步版本,支持中断
Args:
command: 要执行的命令
restart: 重启会话 (当前无状态模式下仅作为兼容参数)
timeout: 超时时间(秒)
shell: 是否使用 shell 执行
cwd: 工作目录(可选)
interruption_queue: 中断信号队列(可选)
Returns:
命令输出结果
"""
if restart:
return "Bash session restarted (Stateless mode - no actual session reset needed)"
if not command:
return "[ERROR] Command content is empty"
# 安全检查
is_safe, reason = validate_command(command)
if not is_safe:
return f"[ERROR] Security Alert: {reason}"
process = None
_tmp_file = None
try:
# 🔑 使用异步 subprocess
if platform.system() == 'Windows':
# Windows cmd.exe 把字面换行当命令分隔符,含换行的命令需写入临时脚本执行
import tempfile
if '\n' in command:
# 判断是 Python 脚本还是通用 bat
if command.strip().startswith('python'):
# 提取 python -c "..." 中的脚本内容,改为临时 .py 文件执行
m = re.match(r'^(python\S*)\s+-c\s+["\']([\s\S]*)["\']\s*$', command.strip())
if m:
py_bin, script = m.group(1), m.group(2)
# 反转义转义序列
script = script.replace('\\n', '\n').replace('\\t', '\t').replace('\\"', '"').replace("\\'", "'")
_tmp_file = tempfile.NamedTemporaryFile(mode='w', suffix='.py', delete=False, encoding='utf-8')
_tmp_file.write(script)
_tmp_file.close()
command = f'{py_bin} "{_tmp_file.name}"'
else:
_tmp_file = tempfile.NamedTemporaryFile(mode='w', suffix='.bat', delete=False, encoding='utf-8')
_tmp_file.write('@echo off\n' + command)
_tmp_file.close()
command = f'cmd /c "{_tmp_file.name}"'
else:
_tmp_file = tempfile.NamedTemporaryFile(mode='w', suffix='.bat', delete=False, encoding='utf-8')
_tmp_file.write('@echo off\n' + command)
_tmp_file.close()
command = f'cmd /c "{_tmp_file.name}"'
env = os.environ.copy()
env['PYTHONIOENCODING'] = 'utf-8'
env['PYTHONUTF8'] = '1'
process = await asyncio.create_subprocess_shell(
command,
stdout=asyncio.subprocess.PIPE,
stderr=asyncio.subprocess.PIPE,
cwd=cwd,
env=env
)
else:
process = await asyncio.create_subprocess_shell(
command,
stdout=asyncio.subprocess.PIPE,
stderr=asyncio.subprocess.PIPE,
shell=shell,
cwd=cwd
)
# 手动解码策略
def decode_bytes(b: bytes) -> str:
if not b: return ""
try:
return b.decode('utf-8')
except UnicodeDecodeError:
try:
return b.decode(platform.system() == 'Windows' and 'mbcs' or 'utf-8')
except:
return b.decode('utf-8', errors='replace')
# 🔑 异步读取输出,并定期检查中断
stdout_chunks = []
stderr_chunks = []
start_time = asyncio.get_event_loop().time()
while True:
# 🔑 检查中断信号
if interruption_queue and not interruption_queue.empty():
try:
signal = interruption_queue.get_nowait()
if signal == "CANCEL":
await _terminate_process(process)
return "[INTERRUPTED] 命令执行被用户中断"
except:
pass
# 检查超时
if asyncio.get_event_loop().time() - start_time > timeout:
await _terminate_process(process)
return f"[ERROR] 命令执行超时(超过 {timeout} 秒)"
# 非阻塞读取
try:
stdout_chunk = await asyncio.wait_for(
process.stdout.read(4096),
timeout=0.2
)
if stdout_chunk:
stdout_chunks.append(stdout_chunk)
except asyncio.TimeoutError:
pass # 超时是正常的,继续下一轮
try:
stderr_chunk = await asyncio.wait_for(
process.stderr.read(4096),
timeout=0.2
)
if stderr_chunk:
stderr_chunks.append(stderr_chunk)
except asyncio.TimeoutError:
pass
# 检查进程是否结束
if process.returncode is not None:
break
# 避免 CPU 空转
await asyncio.sleep(0.1)
# 确保读取剩余输出
remaining_stdout, remaining_stderr = await process.communicate()
if remaining_stdout:
stdout_chunks.append(remaining_stdout)
if remaining_stderr:
stderr_chunks.append(remaining_stderr)
# 合并并解码
stdout_str = decode_bytes(b''.join(stdout_chunks))
stderr_str = decode_bytes(b''.join(stderr_chunks))
output_parts = []
if stdout_str:
output_parts.append(f"[标准输出]\n{stdout_str}")
if stderr_str:
output_parts.append(f"[错误输出]\n{stderr_str}")
if process.returncode != 0:
output_parts.append(f"[返回码] {process.returncode}")
if not output_parts:
result = ""
else:
result = "\n".join(output_parts)
return result
except asyncio.CancelledError:
if process is not None:
await _terminate_process(process)
raise
except FileNotFoundError:
return f"[ERROR] 命令未找到: {command.split()[0]}"
except Exception as e:
return f"[ERROR] 执行失败: {type(e).__name__}: {str(e)}"
finally:
_cleanup_temp_file(_tmp_file)
def get_system_info() -> str:
"""
获取系统基本信息
Returns:
系统信息字符串
"""
try:
info = []
# 操作系统信息
info.append("[操作系统]")
info.append(f" 系统: {platform.system()} {platform.release()}")
info.append(f" 版本: {platform.version()}")
info.append(f" 架构: {platform.machine()}")
info.append(f" 主机名: {platform.node()}")
# CPU 信息
info.append("\n[CPU]")
info.append(f" 处理器: {platform.processor()}")
info.append(f" 核心数: {psutil.cpu_count(logical=False)} 物理核 / {psutil.cpu_count()} 逻辑核")
info.append(f" 使用率: {psutil.cpu_percent(interval=1)}%")
# 内存信息
mem = psutil.virtual_memory()
info.append("\n[内存]")
info.append(f" 总量: {mem.total / (1024**3):.2f} GB")
info.append(f" 已用: {mem.used / (1024**3):.2f} GB ({mem.percent}%)")
info.append(f" 可用: {mem.available / (1024**3):.2f} GB")
# 磁盘信息
info.append("\n[磁盘]")
for partition in psutil.disk_partitions():
try:
usage = psutil.disk_usage(partition.mountpoint)
info.append(f" {partition.device}: {usage.total / (1024**3):.1f} GB, 已用 {usage.percent}%")
except:
pass
return "\n".join(info)
except Exception as e:
return f"[ERROR] 获取系统信息失败: {str(e)}"
def list_processes(top_n: int = 20, sort_by: str = "memory") -> str:
"""
列出当前运行的进程
Args:
top_n: 显示前 N 个进程
sort_by: 排序方式 (memory, cpu, name)
Returns:
进程列表
"""
try:
processes = []
for proc in psutil.process_iter(['pid', 'name', 'cpu_percent', 'memory_percent', 'status']):
try:
pinfo = proc.info
processes.append({
'pid': pinfo['pid'],
'name': pinfo['name'],
'cpu': pinfo['cpu_percent'] or 0,
'memory': pinfo['memory_percent'] or 0,
'status': pinfo['status']
})
except (psutil.NoSuchProcess, psutil.AccessDenied):
pass
# 排序
if sort_by == "memory":
processes.sort(key=lambda x: x['memory'], reverse=True)
elif sort_by == "cpu":
processes.sort(key=lambda x: x['cpu'], reverse=True)
else:
processes.sort(key=lambda x: x['name'].lower())
# 格式化输出
result = [f"[进程列表] (按 {sort_by} 排序,显示前 {top_n} 个)"]
result.append("-" * 60)
result.append(f"{'PID':>8} {'CPU%':>6} {'MEM%':>6} {'状态':>10} 名称")
result.append("-" * 60)
for p in processes[:top_n]:
result.append(f"{p['pid']:>8} {p['cpu']:>6.1f} {p['memory']:>6.1f} {p['status']:>10} {p['name']}")
return "\n".join(result)
except Exception as e:
return f"[ERROR] 获取进程列表失败: {str(e)}"
def get_network_info() -> str:
"""
获取网络配置信息
Returns:
网络信息字符串
"""
try:
info = []
# 网络接口信息
info.append("[网络接口]")
addrs = psutil.net_if_addrs()
stats = psutil.net_if_stats()
for iface, addr_list in addrs.items():
if iface in stats:
is_up = "UP" if stats[iface].isup else "DOWN"
speed = stats[iface].speed
info.append(f"\n {iface} ({is_up}, {speed}Mbps)")
else:
info.append(f"\n {iface}")
for addr in addr_list:
if addr.family.name == 'AF_INET':
info.append(f" IPv4: {addr.address}")
if addr.netmask:
info.append(f" 掩码: {addr.netmask}")
elif addr.family.name == 'AF_INET6':
info.append(f" IPv6: {addr.address}")
# 网络连接统计
info.append("\n[网络连接统计]")
conns = psutil.net_connections(kind='inet')
status_count = {}
for conn in conns:
status = conn.status
status_count[status] = status_count.get(status, 0) + 1
for status, count in sorted(status_count.items()):
info.append(f" {status}: {count}")
# 网络 IO 统计
io = psutil.net_io_counters()
info.append("\n[网络流量]")
info.append(f" 发送: {io.bytes_sent / (1024**2):.2f} MB ({io.packets_sent} 包)")
info.append(f" 接收: {io.bytes_recv / (1024**2):.2f} MB ({io.packets_recv} 包)")
return "\n".join(info)
except Exception as e:
return f"[ERROR] 获取网络信息失败: {str(e)}"
async def ping_host(host: str, count: int = 4) -> str:
"""
Ping 指定主机
Args:
host: 目标主机名或 IP
count: Ping 次数
Returns:
Ping 结果
"""
system = platform.system().lower()
if system == "windows":
cmd = f"ping -n {count} {host}"
else:
cmd = f"ping -c {count} {host}"
return await bash(cmd, timeout=count * 5 + 10)
def check_port(host: str, port: int, timeout: int = 5) -> str:
"""
检查端口是否开放
Args:
host: 目标主机
port: 端口号
timeout: 超时秒数
Returns:
检查结果
"""
import socket
try:
sock = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
sock.settimeout(timeout)
result = sock.connect_ex((host, port))
sock.close()
if result == 0:
return f"[OK] {host}:{port} 端口开放"
else:
return f"[WARN] {host}:{port} 端口关闭或无法连接"
except socket.gaierror:
return f"[ERROR] 无法解析主机名: {host}"
except socket.timeout:
return f"[ERROR] 连接超时"
except Exception as e:
return f"[ERROR] 检查失败: {str(e)}"
def get_environment_variables(filter_key: Optional[str] = None) -> str:
"""
获取环境变量
Args:
filter_key: 过滤关键字(可选)
Returns:
环境变量列表
"""
result = ["[环境变量]"]
env_vars = dict(os.environ)
if filter_key:
env_vars = {k: v for k, v in env_vars.items() if filter_key.lower() in k.lower()}
result[0] = f"[环境变量] (包含 '{filter_key}')"
for key in sorted(env_vars.keys()):
value = env_vars[key]
# 对于 PATH 类变量,换行显示
if 'PATH' in key.upper() and ';' in value:
result.append(f"\n{key}:")
for path in value.split(';'):
if path:
result.append(f" {path}")
else:
result.append(f"{key}={value}")
return "\n".join(result)
# 工具函数字典
bash_TOOLS = {
"bash": bash, # Renamed from bash
# "get_system_info": get_system_info,
# "list_processes": list_processes,
# "get_network_info": get_network_info,
# "ping_host": ping_host,
# "check_port": check_port,
# "get_environment_variables": get_environment_variables,
}
def get_tools(*args, **kwargs) -> List:
"""返回所有 Bash 工具函数列表"""
tools = list(bash_TOOLS.values())
# 检查是否传入了 interruption_queue
if 'interruption_queue' in kwargs:
queue = kwargs['interruption_queue']
# 找到 bash 函数并进行部分绑定
# 注意: 我们需要替换列表中的 original bash function with the bound one
# 但 dict.values() 返回的是新列表,修改它不会影响 bash_TOOLS
# 所以我们直接构建一个新的工具列表
bound_tools = []
for tool in tools:
if tool.__name__ == 'bash':
# 使用 partial 绑定 interruption_queue
import functools
bound_bash = functools.partial(bash, interruption_queue=queue)
# 关键: 恢复元数据, 否则 Agent 无法识别工具名称和文档
bound_bash.__name__ = bash.__name__
bound_bash.__doc__ = bash.__doc__
bound_tools.append(bound_bash)
else:
bound_tools.append(tool)
return bound_tools
return tools
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 469k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 321k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 321k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 321k | Updated | Claude CodeCodex | Verified | Install |