用途
本技能提供 GrepAI 在任意平台上的完整安装方法，适用于以下场景：首次安装 GrepAI、升级已有的 GrepAI 安装、从源码构建 GrepAI、验证安装是否成功。
前置条件
- macOS/Linux：需要终端访问权限
- Windows：需要 PowerShell
- 从源码构建：需要安装 Go 1.24 或更高版本
安装方式
方式一：Homebrew（macOS，推荐）
macOS 上最简单的安装方式：
# 添加 tap 并安装
brew install yoanbernabeu/tap/grepai
# 验证安装
grepai version
优势：可通过 brew upgrade grepai 自动更新；可通过 brew uninstall grepai 干净卸载；自动管理依赖。
方式二：Shell 脚本（Linux/macOS）
通用安装脚本：
# 下载并运行安装程序
curl -sSL https://raw.githubusercontent.com/yoanbernabeu/grepai/main/install.sh | sh
# 验证安装
grepai version
脚本会执行的操作：检测操作系统与架构、下载对应的二进制文件、安装到 /usr/local/bin/、设置可执行权限。
方式三：PowerShell（Windows）
Windows 原生安装：
# 在 PowerShell 中运行（建议以管理员身份）
irm https://raw.githubusercontent.com/yoanbernabeu/grepai/main/install.ps1 | iex
# 验证安装
grepai version
注意：可能需要调整执行策略：
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
方式四：从源码构建
面向开发者或自定义构建：
# 克隆仓库
git clone https://github.com/yoanbernabeu/grepai.git
cd grepai
# 构建二进制文件
make build
# 全局安装
sudo mv ./bin/grepai /usr/local/bin/
# 验证安装
grepai version
要求：Go 1.24 或更高版本；Make（可选，也可直接使用 go build）。
验证安装
安装完成后，验证一切正常：
# 检查版本
grepai version
# 输出：grepai version 0.24.0
# 查看可用命令
grepai --help
更新 GrepAI
检查更新：
grepai update --check
执行更新：
# 自动更新（下载并安装最新版）
grepai update
# 或通过 Homebrew
brew upgrade grepai
卸载
Homebrew：
brew uninstall grepai
手动卸载：
# 删除二进制文件
sudo rm /usr/local/bin/grepai
# 可选：删除配置目录
rm -rf ~/.grepai
后续步骤
安装完成后：安装 Ollama 以使用本地嵌入（参见 grepai-ollama-setup 技能）；使用 grepai init 初始化项目；使用 grepai watch 开始索引。
常见安装问题
- 问题：command not found: grepai。解决：确保 /usr/local/bin 在 PATH 中：
export PATH="$PATH:/usr/local/bin" - 问题：安装时提示 Permission denied。解决：对安装命令使用 sudo，或安装到用户目录
- 问题：找不到 Homebrew tap。解决：先添加 tap：
brew tap yoanbernabeu/tap然后brew install grepai
输出格式
安装成功后输出示例：
✅ GrepAI installed successfully
Version: 0.24.0
Location: /usr/local/bin/grepai
Next steps:
1. Install Ollama: brew install ollama
2. Initialize project: grepai init
3. Start indexing: grepai watch