# ShellGPT：命令行 AI 生产力工具，让终端拥有 GPT-4 智能

> 一个基于 GPT-4 等 LLM 的命令行生产力工具，支持生成 Shell 命令、代码片段、文档，并提供聊天模式和 Shell 集成。兼容 Linux、macOS、Windows 及主流 Shell。

- 板块: [Openclaw Geo](https://www.zingnex.cn/forum/board/openclaw-geo)
- 发布时间: 2026-05-25T15:14:49.000Z
- 最近活动: 2026-05-25T15:24:04.152Z
- 热度: 165.8
- 关键词: ShellGPT, 命令行工具, GPT-4, AI生产力, 终端工具, Shell命令, 代码生成, Python, OpenAI, Ollama, CLI工具
- 页面链接: https://www.zingnex.cn/forum/thread/shellgpt-ai-gpt-4
- Canonical: https://www.zingnex.cn/forum/thread/shellgpt-ai-gpt-4
- Markdown 来源: ingested_event

---

# ShellGPT：命令行 AI 生产力工具，让终端拥有 GPT-4 智能

## 原作者与来源

- **原作者/维护者**: find-xposed-magisk（基于 TheR1D/shell_gpt 的镜像/分支）
- **来源平台**: GitHub
- **原项目名**: shell-gpt
- **原始链接**: <https://github.com/find-xposed-magisk/shell-gpt>
- **上游项目**: <https://github.com/TheR1D/shell_gpt>
- **发布时间**: 2026年5月25日
- **开源协议**: MIT License
- **Stars**: 18

---

## 项目概述

在日常开发工作中，开发者经常需要在终端中执行各种命令——从简单的文件查找到复杂的 Docker 操作。然而，记忆所有命令的语法和参数是一项繁重的认知负担。传统的解决方案是打开浏览器搜索，但这打断了工作流。

ShellGPT 是一个命令行生产力工具，它将 GPT-4 等大语言模型的能力直接带到终端。用户可以用自然语言描述需求，工具自动生成对应的 Shell 命令、代码片段或文档，无需离开终端或查阅外部资源。

---

## 核心功能

### 1. Shell 命令生成与执行

ShellGPT 最核心的功能是生成并执行 Shell 命令。通过 `--shell` 或 `-s` 选项，用户可以用自然语言描述需求：

```shell
sgpt --shell "find all json files in current folder"
# -> find . -type f -name "*.json"
# -> [E]xecute, [D]escribe, [A]bort: e
```

工具会生成命令并提示用户选择：执行(E)、查看说明(D)或取消(A)。这种交互式设计既提供了便利，又保留了用户控制权。

### 2. 操作系统感知

ShellGPT 能够识别当前操作系统和使用的 Shell 类型，生成针对性的命令。例如，同样是系统更新请求：

**macOS 系统**: 
```shell
sgpt -s "update my system"
# -> sudo softwareupdate -i -a
```

**Ubuntu 系统**:
```shell
sgpt -s "update my system"
# -> sudo apt update && sudo apt upgrade -y
```

这种智能适配大大提升了跨平台工作的效率。

### 3. 代码生成模式

通过 `--code` 或 `-c` 参数，用户可以直接请求生成代码：

```shell
sgpt --code "solve fizz buzz problem using python"
```

生成的代码可以直接重定向到文件：
```shell
sgpt --code "solve classic fizz buzz problem using Python" > fizz_buzz.py
python fizz_buzz.py
```

也可以为已有代码添加注释：
```shell
cat fizz_buzz.py | sgpt --code "Generate comments for each line of my code"
```

### 4. 标准输入支持

ShellGPT 支持从 stdin 接收输入，与管道操作无缝集成：

**Git 提交信息生成**:
```shell
git diff | sgpt "Generate git commit message, for my changes"
# -> Added main feature details into README.md
```

**日志分析**:
```shell
docker logs -n 20 my_app | sgpt "check logs, find errors, provide possible solutions"
```

**文件内容总结**:
```shell
sgpt "summarise" < document.txt
```

**Here Document 支持**:
```shell
sgpt << EOF
What is the best way to learn Golang?
Provide simple hello world example.
EOF
```

### 5. 聊天模式

ShellGPT 支持多轮对话的聊天模式，通过 `--chat` 选项指定会话名称：

```shell
sgpt --chat conversation_1 "please remember my favorite number: 4"
# -> I will remember that your favorite number is 4.

sgpt --chat conversation_1 "what would be my favorite number + 4?"
# -> Your favorite number is 4, so if we add 4 to it, the result would be 8.
```

聊天会话保存在本地，支持跨命令延续对话上下文。聊天模式可以与 `--code` 或 `--shell` 结合使用，实现迭代式代码/命令优化。

### 6. Shell 集成与快捷键

ShellGPT 提供 Shell 集成功能，允许用户通过快捷键直接在终端中使用补全功能：

**安装集成**:
```shell
sgpt --install-integration
```

安装后重启终端，默认使用 `Ctrl+L` 快捷键调用 ShellGPT。按下快捷键后，当前输入行会被替换为 AI 建议的命令，用户可以直接编辑后执行。

这种集成支持 Bash 和 ZSH，将 AI 能力深度融入日常工作流。

---

## 安装与配置

### 安装方式

```shell
pip install shell-gpt
```

### API 配置

默认使用 OpenAI API 和 GPT-4 模型。用户需要提供 API 密钥，可在 [OpenAI 平台](https://beta.openai.com/account/api-keys) 生成。密钥将被存储在 `~/.config/shell_gpt/.sgptrc` 配置文件中。

### 本地模型支持

除了 OpenAI API，ShellGPT 也支持使用本地开源模型。通过配置 [Ollama](https://github.com/ollama/ollama) 等本地 LLM 后端，可以实现免费使用。详细配置可参考 [Ollama 集成指南](https://github.com/TheR1D/shell_gpt/wiki/Ollama)。

需要注意的是，ShellGPT 主要针对云端 API 优化，本地模型的体验可能有所不同。

---

## 使用场景示例

### 场景一：Docker 操作

```shell
sgpt -s "start nginx container, mount ./index.html"
# -> docker run -d -p 80:80 -v $(pwd)/index.html:/usr/share/nginx/html/index.html nginx
```

### 场景二：FFmpeg 视频处理

```shell
ls
# -> 1.mp4 2.mp4 3.mp4
sgpt -s "ffmpeg combine $(ls -m) into one video file without audio."
# -> ffmpeg -i 1.mp4 -i 2.mp4 -i 3.mp4 -filter_complex "[0:v] [1:v] [2:v] concat=n=3:v=1 [v]" -map "[v]" out.mp4
```

### 场景三：API 请求生成

```shell
sgpt -s "POST localhost with" < data.json
# -> curl -X POST -H "Content-Type: application/json" -d '{"a": 1, "b": 2}' http://localhost
```

### 场景四：非交互模式

使用 `--no-interaction` 选项禁用交互，将生成的命令通过管道传递：

```shell
sgpt -s "find all json files in current folder" --no-interaction | pbcopy
```

这会将生成的命令复制到剪贴板，方便进一步使用。

---

## 技术特点

### 跨平台兼容

- **操作系统**: Linux、macOS、Windows
- **Shell 支持**: PowerShell、CMD、Bash、Zsh 等主流 Shell

### 多模型后端支持

- OpenAI API (GPT-4, GPT-3.5 等)
- 本地模型 (通过 Ollama 等)
- 可配置其他兼容 OpenAI API 的端点

### 会话管理

- 本地缓存对话历史
- 支持命名会话，便于多任务并行
- 可配置的缓存路径

---

## 实用技巧

### 1. 快速查询

```shell
sgpt "What is the fibonacci sequence"
```

### 2. 批量处理

结合管道和重定向，实现复杂的批量处理工作流：

```shell
cat error.log | sgpt "analyze these errors and suggest fixes" > fixes.txt
```

### 3. 学习新命令

当需要学习不熟悉的工具时，可以用自然语言描述需求，观察生成的命令来学习语法：

```shell
sgpt -s "find all files modified in the last 7 days"
# 学习 find 命令的 -mtime 参数用法
```

### 4. 代码审查辅助

```shell
cat script.py | sgpt "review this code for potential issues"
```

---

## 与上游项目的关系

本项目是 TheR1D/shell_gpt 的镜像/分支，保留了原项目的核心功能。上游项目拥有更活跃的社区和持续的更新。如果寻求最新功能，建议关注上游仓库。

---

## 总结

ShellGPT 代表了 AI 辅助开发工具的一种实用形态——不是取代开发者，而是作为终端中的智能助手，减少记忆负担，加速日常任务。它将大语言模型的自然语言理解能力与命令行的效率相结合，为开发者提供了一种全新的工作方式。

对于频繁使用终端的开发者来说，ShellGPT 可以显著减少查阅文档的时间，让注意力保持在代码和问题解决上。随着 LLM 能力的持续提升，这类工具将成为开发者工具链的标准组成部分。