以下是您提供的所有内容的完整中文翻译：

超级壳（Super Shell）

介绍

超级壳（Super Shell）是一个功能强大的命令外壳工具，专为提升开发人员和系统管理员的工作效率而设计。它支持跨平台操作（Windows、macOS 和 Linux），提供丰富的功能模块，包括命令管理、权限控制、日志记录和远程配置等。

安装与配置

安装

1. 通过 npm 安装：

   npm install -g super-shell-mcp
   

2. 手动安装： 将压缩包解压到指定目录，并确保可执行文件具有正确的权限。

配置

超级壳可以通过配置文件 config.json 进行个性化设置。以下是常用的配置选项：

{
  "shellType": "auto", // 自动检测 shell 类型，支持 "cmd"、"bash" 和 "powershell"
  "timeout": 30000,    // 命令执行超时时间（毫秒）
  "whitelist": ["ls", "cd", "cp", "rm"], // 允许的命令列表
  "blacklist": ["sudo", "su"], // 禁止的命令列表
  "logLevel": "INFO" // 日志级别：INFO、DEBUG、ERROR
}

核心功能

命令管理

超级壳提供强大的命令控制功能，支持以下操作：

• 黑白名单策略：通过 whitelist 和 blacklist 配置，限制或允许特定的命令执行。
• 超时控制：防止长时间未响应的命令占用系统资源。

权限控制

超级壳基于用户角色和环境变量提供灵活的权限管理：

1. 用户鉴权：
   • 支持多种身份验证方式（如令牌认证、OAuth）。
2. 访问控制列表（ACL）：
   • 定义细粒度的资源访问权限。

日志系统

超级壳内置了完善的日志记录功能，便于调试和监控服务器状态：

1. 日志文件位置：
   • 默认路径：logs/super-shell-mcp.log
   • 自动创建日志目录，并包含 .gitkeep 文件以跟踪该目录。
2. 日志级别：
   • INFO：记录一般操作信息。
   • DEBUG：详细调试信息。
   • ERROR：记录错误条件和异常。

跨平台支持

超级壳支持以下操作系统：

• Windows：
  • 使用 cmd.exe 或 PowerShell 执行命令。
  • 注意路径分隔符（反斜杠 \）需要在 JSON 中转义为双反斜杠 (\\)。
• macOS/Linux：
  • 默认使用 /bin/bash 或用户指定的 shell。

命令执行示例

配置 Shell

# 示例：配置超级壳使用 PowerShell 在 Windows 上运行
{
  "shellType": "powershell",
  "workingDirectory": "C:\\Users\\CurrentUser\\Documents"
}

执行命令

# 示例：执行简单文件操作
super-shell-mcp.exe -c "ls" // 列出当前目录下的文件
super-shell-mcp.exe -c "cd .." // 返回上一级目录

故障排除

Windows 系统

• 问题：路径分隔符错误。
  • 解决方法：在 JSON 配置中，路径分隔符应使用双反斜杠 (\\)。

macOS/Linux 系统

• 问题：找不到命令。
  • 解决方法：检查环境变量配置是否正确，并确保命令存在于系统 PATH 中。

许可证

超级壳遵循 MIT 许可证协议：

MIT License

Copyright (c) [year] [copyright holder]

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

总结

超级壳（Super Shell）是一款功能丰富、易于配置的命令外壳工具，适用于多种操作系统和开发环境。通过灵活的权限控制和日志记录功能，能够显著提升工作效率并简化系统管理。

希望这段翻译对您有帮助！如果需要进一步调整或补充，请随时告知。