Block/Goose 项目安装与配置完全指南
项目地址: https://gitcode.com/GitHub_Trending/goose3/goose 前言
Block/Goose 是一款功能强大的开发辅助工具，提供 CLI 和桌面两种使用方式。本文将详细介绍如何在不同操作系统上安装和配置 Goose，帮助开发者快速上手使用。
系统环境要求
Goose 支持以下操作系统环境：
- macOS (Intel 和 Apple Silicon 芯片)
- Linux 发行版
- Windows (通过 WSL 子系统)
macOS 安装指南
桌面版安装
macOS 用户有两种方式安装 Goose 桌面版：
方法一：直接下载安装
- 从官方网站下载最新版本的 Goose 压缩包
- 解压下载的 zip 文件
- 运行可执行文件启动 Goose 桌面应用
更新提示：建议定期重新运行安装步骤以保持 Goose 为最新版本
方法二：使用 Homebrew 安装
对于习惯使用包管理器的开发者，可以通过 Homebrew 安装：
brew install --cask block-goose
Homebrew 会自动处理后续更新，简化维护流程。
权限注意事项： 在 Apple M3 芯片的 Mac 上，如果 Goose 桌面应用启动后不显示窗口，请检查并确保 ~/.config 目录具有读写权限。Goose 需要此权限来创建日志目录和文件。
CLI 版本安装
对于偏好命令行的开发者，可以通过以下命令安装 Goose CLI：
curl -fsSL https://github.com/block/goose/releases/download/stable/download_cli.sh | bash
如需跳过交互式配置，可添加环境变量：
curl -fsSL https://github.com/block/goose/releases/download/stable/download_cli.sh | CONFIGURE=false bash
更新方法： 保持 CLI 版本更新的命令非常简单：
goose update
Linux 安装指南
Linux 用户可以通过单一命令完成安装：
curl -fsSL https://github.com/block/goose/releases/download/stable/download_cli.sh | bash
同样支持非交互式安装：
curl -fsSL https://github.com/block/goose/releases/download/stable/download_cli.sh | CONFIGURE=false bash
Windows 安装指南
虽然 Windows 没有原生支持，但可以通过 WSL (Windows Subsystem for Linux) 运行：
- 以管理员身份打开 PowerShell，安装 WSL 和默认的 Ubuntu 发行版：
wsl --install
- 根据提示重启计算机
- 在 WSL 中运行 Goose 安装脚本：
curl -fsSL https://github.com/block/goose/releases/download/stable/download_cli.sh | bash
常见问题解决： 如果下载遇到问题，可能需要先安装 bzip2：
sudo apt update && sudo apt install bzip2 -y
LLM 提供商设置
Goose 支持多种大型语言模型提供商，首次使用时需要配置 API 密钥。
桌面版配置
安装完成后会自动显示提供商设置界面：
- 从列表中选择您的 LLM 提供商
- 输入相应的 API 密钥
- 点击提交完成设置
CLI 版配置
CLI 版本会自动进入配置界面，按照提示操作即可：
◇ What would you like to configure?
│ Configure Providers
│
◇ Which model provider should we use?
│ OpenAI
│
◇ Provider openai requires OPENAI_API_KEY, please enter a value
│▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪
│
◇ Enter a model from that provider:
│ gpt-4o
Windows 用户注意： 在 WSL 中首次运行时可能会遇到密钥环相关错误，可以手动设置环境变量：
export OPENAI_API_KEY=your_api_key
为使设置持久化，建议将以下内容添加到 ~/.bashrc 文件中：
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
echo 'export OPENAI_API_KEY=your_api_key' >> ~/.bashrc
source ~/.bashrc
更新提供商设置
桌面版更新
- 点击右上角三点菜单
- 选择"Provider Settings"
- 从列表中选择新提供商
- 点击编辑，输入 API 密钥后设为活动状态
CLI 版更新
运行配置命令并按照提示操作：
goose configure
启动与使用
桌面版使用
安装配置完成后，直接在输入框中输入问题或指令即可开始使用。
CLI 版使用
在终端中导航到目标目录后运行：
goose session
配置共享机制
Goose CLI 和桌面版共享核心配置，包括：
- LLM 提供商设置
- 模型选择
- 扩展配置
这些配置存储在 ~/.config/goose/config.yaml 文件中，确保两种界面体验一致。
注意：虽然核心配置共享，但某些扩展可能使用自己的认证凭证存储方式。
访问共享配置
桌面版：
- 点击右上角"..."菜单
- 选择"Advanced Settings"
CLI 版： 使用配置命令：
goose configure
扩展功能
Goose 支持通过扩展增强功能，包括添加新扩展或启用/禁用现有扩展。详细使用方法请参考官方扩展指南。
最佳实践建议
- 定期更新 Goose 以获得最新功能和改进
- 对于团队使用，建议统一配置 LLM 提供商以减少重复工作
- 在 WSL 环境中，考虑将常用命令添加到 shell 配置文件中
- 注意 API 调用的速率限制，合理安排使用频率
通过本指南，您应该已经完成了 Goose 的安装和基本配置，可以开始体验它强大的开发辅助功能了。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
