Linux 命令中文解释器

将 Linux 命令拆解为中文解释，逐项说明命令用途、每个选项含义、参数作用，以及整体命令的执行效果。支持从简单命令（ls -la）到复杂管道链（find . -type f | xargs grep pattern | sort | uniq -c）的完整解释。

核心能力

• 命令识别：覆盖 100+ 常用 Linux 命令（ls, grep, find, sed, awk, tar, curl, wget, ps, kill, chmod, chown, chroot, systemctl, journalctl, docker, git, ssh, scp, rsync, crontab, dmesg, iptables, ss, netstat 等）
• 选项解析：逐项解释短选项（-r, -i, -v, -f）和长选项（--recursive, --ignore-case, --verbose）的含义和常见组合
• 管道链拆解：将管道（|）、重定向（>, >>, <, 2>&1）、命令替换（$()）、逻辑链（&&, ||）按数据流顺序逐步解析
• 安全提示：对 rm -rf, dd, chmod 777, mkfs, :(){ :|:& };:, 重定向到 /dev/sda 等高风险操作发出警告
• 跨平台标注：注明 GNU/Linux 与 BSD/macOS（如 sed, date, stat）以及 busybox 环境的差异
• 退出码解释：解释命令可能返回的退出码含义（0=成功, 1=一般错误, 127=命令未找到, 139=段错误等）

工作流程

1. 接收命令 — 获取用户提供的 Linux 命令字符串
2. 拆解分析 — 识别主命令、子命令、选项、参数、管道和重定向
3. 生成解释 — 按结构化模板输出中文解释
4. 附加安全提示 — 高危操作附带警告和安全替代方案
5. 提供示例 — 给出类似场景的实用示例

输入与输出

输入: 一个 Linux 命令字符串

tar -xzf project.tar.gz --exclude=node_modules -C /output
ps aux | grep nginx | awk '{print $2}'
find /logs -name "*.log" -mtime +7 -exec rm {} \;

输出: 结构化中文解释，包含以下部分：

## 命令：tar（磁带归档）

**中文名**：打包压缩工具

**作用**：创建、查看或解压 tar 归档文件

**语法**：tar [选项] [归档文件] [要处理的文件/目录]

**选项详解**：
  -x, --extract         解压/提取文件
  -z, --gzip            通过 gzip 压缩/解压（处理 .tar.gz/.tgz）
  -f, --file=ARCHIVE    指定归档文件名（后必须紧跟文件名）
  --exclude=PATTERN     排除匹配模式的文件
  -C, --directory=DIR   先切换到目标目录再操作

**整体含义**：
将 project.tar.gz 解压到 /output 目录，解压时排除 node_modules 文件夹。

高级解释模板

管道链解释

## 命令链

find /logs -name "*.log" -mtime +7  |  xargs rm -f

整体含义：在 /logs 下查找 7 天前的 .log 文件并批量删除。

逐步拆解：
  第 1 步 | find /logs -name "*.log" -mtime +7
          → 在 /logs 目录下查找名称匹配 *.log 且修改时间超过 7 天的文件
          → -name "*.log": 文件名模式匹配
          → -mtime +7: 最后修改时间在 7 天前（+ 表示超过）
  
  第 2 步 | xargs rm -f
          → 将 find 找到的文件路径作为 rm 的参数传入
          → rm -f: 强制删除（不提示确认）

复杂重定向解释

## 命令链

./app.sh > /var/log/app.log 2>&1 &

整体含义：后台运行 app.sh 脚本，将标准输出和标准错误都重定向到日志文件。

逐步拆解：
  1. ./app.sh         → 执行当前目录下的 app.sh 脚本
  2. > /var/log/app.log → 将标准输出（stdout）写入日志文件（覆盖）
  3. 2>&1             → 将标准错误（stderr）重定向到标准输出（即也写入日志文件）
  4. &                → 放入后台执行（不阻塞终端）

命令速查

文件操作

文本处理

系统管理

网络工具

包管理

常用符号解释

不适用场景

以下情况不应使用此 skill：

• 命令是 Windows CMD、PowerShell 或 SQL 查询（应使用相应工具）
• 用户要求执行该命令而非解释它
• 输入是编程语言代码片段（Python、JavaScript、Go 等）
• 用户询问的是 Linux 内核原理而非具体命令语法
• 用户只在闲聊中提及某个命令名称而不需要解释

安全警告规则

检测到以下模式时，必须在解释末尾附加安全警告：

Resources

• references/gnu-bsd-diff.md — GNU (Linux) 与 BSD (macOS) 工具差异对照表
• references/exit-codes.md — Linux 退出码完整含义表
• references/command-patterns.md — 常见实用命令链模式（日志分析、批量处理、系统诊断等）
• references/danger-commands.md — 高危命令详解与安全替代方案