十个实用网站网址网站开发前端课程
1. 什么是 sgpt？
sgpt 是一个基于 OpenAI API 的命令行工具，允许用户在终端中与 AI 进行交互，支持自然语言对话、代码生成、Shell 命令生成等功能。本文将介绍 sgpt 的安装方法、基本用法、配置文件路径及修改方式，并提供完整的配置示例，特别是如何切换到 DeepSeek API。
1.1 sgpt 的主要用途
- 直接在终端与 AI 对话。
- 生成 Shell 命令并执行。
- 生成代码示例。
- 进入交互模式，保持持续对话。
2. 如何安装 sgpt？
2.1 在 Linux/macOS 安装
使用 pip 进行安装：
pip install shell-gpt
如果安装了多个大版本的 python，并且 pip 默认是低版本，那么安装的时候大概是会报错，推荐使用下面的命令安装：
pip3 install shell-gpt
pip3 install shell-gpt 命令失败了，错误是 “externally-managed-environment”，这表示 Python 由 macOS 或 Homebrew 管理，不能直接使用 pip 安装全局包。pipx 允许在独立环境中安装 Python 应用，避免影响系统环境：
brew install pipx # 先安装 pipx
pipx ensurepath # 确保 pipx 的路径可用
pipx install shell-gpt # 使用 pipx 安装 shell-gpt
安装完成后，可以使用 sgpt --help 查看命令用法。
2.2 在 Windows 安装
Windows 用户可以使用 pip 进行安装，推荐在 PowerShell 或 WSL (Windows Subsystem for Linux) 中执行：
pip install shell-gpt
安装成功后，运行以下命令检查是否可用：
sgpt --help
如果 sgpt 命令无法识别，请检查 Python 是否正确安装，并确保 pip 目录已添加到 PATH。
3. 如何在终端使用 sgpt？
3.1 进行 AI 对话
sgpt "你好，今天的天气怎么样？"
3.2 生成 Shell 命令
sgpt -s "列出当前目录的所有文件"
-s选项让sgpt生成 Shell 命令。
3.3 代码生成
sgpt -c "写一个 Python 斐波那契数列函数"
-c选项让sgpt仅返回代码。
3.4 进入交互模式
sgpt --chat temp
--chat temp让sgpt进入临时对话模式，可进行多轮对话。
4. 如何找到 sgpt 的配置文件？
sgpt 需要 API Key 进行访问，配置文件通常存储在 ~/.config/shell_gpt/.sgptrc (Linux/macOS) 或 C:\Users\你的用户名\.config\shell_gpt\.sgptrc (Windows)。
4.1 查找配置文件
echo $HOME/.config/shell_gpt/.sgptrc # Linux/macOS
echo $env:APPDATA\shell_gpt\.sgptrc # Windows
4.2 通过源码配置文件
在 sgpt 的 Python 源码中，可以看到默认的 配置文件路径 为：
CONFIG_FOLDER = os.path.expanduser("~/.config")
SHELL_GPT_CONFIG_FOLDER = Path(CONFIG_FOLDER) / "shell_gpt"
SHELL_GPT_CONFIG_PATH = SHELL_GPT_CONFIG_FOLDER / ".sgptrc"
📌 也就是说，配置文件在：~/.config/shell_gpt/.sgptrc
5. 如何修改 API 以使用 DeepSeek？
默认情况下，sgpt 使用 OpenAI 的 API (https://api.openai.com/v1/chat/completions)，如果要使用 DeepSeek，需要修改配置文件。
5.1 修改 .sgptrc 配置文件
打开 ~/.config/shell_gpt/.sgptrc (Linux/macOS) 或 C:\Users\你的用户名\.config\shell_gpt\.sgptrc (Windows)，修改以下内容：
API_BASE_URL=https://api.deepseek.com/v1
DEFAULT_MODEL=deepseek-chat
OPENAI_API_KEY=你的密钥
DEFAULT_MODEL需要与 DeepSeek 支持的模型名称一致。
6. 完整的配置示例（适用于 DeepSeek）
CHAT_CACHE_PATH=/tmp/chat_cache
CACHE_PATH=/tmp/cache
CHAT_CACHE_LENGTH=100
CACHE_LENGTH=100
REQUEST_TIMEOUT=60
DEFAULT_MODEL=deepseek-chat
DEFAULT_COLOR=magenta
ROLE_STORAGE_PATH=$HOME/.config/shell_gpt/roles
DEFAULT_EXECUTE_SHELL_CMD=false
DISABLE_STREAMING=false
CODE_THEME=dracula
OPENAI_FUNCTIONS_PATH=$HOME/.config/shell_gpt/functions
OPENAI_USE_FUNCTIONS=true
SHOW_FUNCTIONS_OUTPUT=false
API_BASE_URL=https://api.deepseek.com/v1
PRETTIFY_MARKDOWN=true
USE_LITELLM=false
SHELL_INTERACTION=true
OS_NAME=auto
SHELL_NAME=auto
OPENAI_API_KEY=your-deepseek-api-key
7. 常见问题及解决方案
7.1 sgpt 命令未找到
- 确保
pip install shell-gpt已正确执行。 - 在 Linux/macOS 上，检查
~/.local/bin是否在PATH中：export PATH=$HOME/.local/bin:$PATH - 在 Windows 上，检查
Python目录是否在PATH中。
7.2 API Key 无效
- 确保
OPENAI_API_KEY或DeepSeek API Key配置正确。 - 在
.sgptrc文件中正确设置API_BASE_URL。
7.3 如何更新 sgpt
pip install --upgrade shell-gpt
这样，你就可以在终端中高效地使用 sgpt 了！
