safe-shell（安全壳）

Safe Shell

一个极度安全的命令行操作 Skill，支持 macOS/Linux/Windows，仅允许读取和查询类命令。

🚀 安装

npx clawhub@latest install safe-shell

设计理念

本 Skill 专为以下场景设计：

• 只读监控：查看文件、系统状态、网络配置
• 零破坏风险：完全禁止任何修改、删除、执行危险操作
• AI 防护：让 AI 可以安全地查询信息，无需担心误操作
• 跨平台：统一策略适用于 macOS/Linux/Windows

✅ 允许的命令（纯读取）

📁 文件查看（只读）

🔍 系统状态（只读）

🌐 网络诊断（只读）

📋 信息查询

🔧 硬件/系统信息

❌ 禁止的命令

通用危险命令（所有平台）

🪟 Windows 专用危险命令

🍎 macOS 专用危险命令

🐧 Linux 专用危险命令

PowerShell 安全限制

✅ 允许的 PowerShell 只读命令

# 文件操作
Get-ChildItem, Get-Content, Get-Item, Get-ItemProperty

# 系统信息
Get-ComputerInfo, Get-CimInstance, Get-WmiObject
Get-Process, Get-Service, Get-EventLog
Get-Location, Get-Date, Get-Culture

# 网络
Get-NetIPAddress, Get-NetTCPConnection, Get-NetUDPEndpoint
Get-DnsClientCache, Resolve-DnsName, Test-Connection

# 硬件
Get-Disk, Get-Volume, Get-PSDrive
Get-PnPDevice, Get-Hardware

❌ 禁止的 PowerShell 操作

# 绝对禁止
Invoke-Expression, Invoke-Command, Invoke-WebRequest
Start-Process, Start-Service, Stop-Process, Stop-Service
New-Item, New-Service, New-Object (动态代码)
Remove-Item, Remove-ItemProperty, Remove-Service
Set-Item, Set-ItemProperty, Set-Content
Copy-Item, Move-Item
Set-Service, Set-ExecutionPolicy
Set-NetFirewallRule, New-NetFirewallRule
Add-Type (动态编译)

核心原则

1. 只读优先：只允许不影响系统的查询操作
2. 零执行：禁止任何脚本/代码执行
3. 零修改：禁止任何文件或系统配置修改
4. 零网络下载：禁止从网络下载或执行内容
5. 平台感知：自动识别系统，使用对应安全命令
6. 命令链拦截：禁止 | xargs, ; && || 等命令链接

使用示例

用户：帮我看看当前目录有什么文件
→ macOS/Linux: ls -la
→ Windows: dir

用户：查看系统内存使用
→ macOS/Linux: free -h
→ Windows: systeminfo | findstr "Total Physical"

用户：查看网络配置
→ macOS/Linux: ifconfig
→ Windows: ipconfig /all

用户：安装一个软件
→ 拒绝：禁止执行安装命令

用户：删除这个文件
→ 拒绝：禁止删除操作

用户：帮我运行一个脚本
→ 拒绝：禁止执行任何脚本或解释器

用户：查看Windows服务状态
→ Windows: Get-Service | Select-Object Name,Status

平台检测与适配

系统自动检测当前平台并应用对应规则：

# 伪代码示例
def get_allowed_commands(platform):
    if platform == "windows":
        return WINDOWS_ALLOWED_COMMANDS
    elif platform == "macos":
        return MACOS_ALLOWED_COMMANDS
    elif platform == "linux":
        return LINUX_ALLOWED_COMMANDS
    else:
        return MINIMAL_ALLOWED_COMMANDS  # 未知系统仅允许最基本查询

适用场景

• AI 助手安全查询
• 监控系统状态
• 排查网络问题
• 读取日志和配置
• 完全零风险的命令行交互
• 跨平台统一安全策略

版本: 2.0.0 作者: Cheng Yusheng 许可证: MIT 更新: 添加 Windows 支持和 PowerShell 安全限制