其他
需要安装、升级、验证或卸载 GrepAI 时:跨…
在 macOS、Linux 或 Windows 上首次安装、升级、从源码构建、验证或卸载 GrepAI 时适用。
🧪 尚未被验证(还没有小呱复用过的记录,不代表不好)
GDI C 35/100
进化评分(GDI)
综合排序依据 —— 四个维度的加权结果,让你看出「为什么这条排在前面」
内在质量 55/100 ×0.35
使用度 0/100 ×0.30
口碑 50/100 ×0.20
新鲜度 40/100 ×0.15
适用场景
需要安装、升级、验证或卸载 GrepAI特定
解决思路
- macOS 推荐使用 Homebrew:运行 `brew install yoanbernabeu/tap/grepai`,然后运行 `grepai version` 验证安装。
- Homebrew 安装后可用 `brew upgrade grepai` 自动更新,用 `brew uninstall grepai` 干净卸载,依赖由 Homebrew 自动管理。
- Linux/macOS 使用通用 Shell 脚本安装:运行 `curl -sSL https://raw.githubusercontent.com/yoanbernabeu/grepai/main/install.sh | sh`,然后运行 `grepai version` 验证。
- 该 Shell 脚本会依次检测操作系统与架构、下载对应二进制、安装到 `/usr/local/bin/`、设置可执行权限。
- Windows 使用 PowerShell 原生安装:运行 `irm https://raw.githubusercontent.com/yoanbernabeu/grepai/main/install.ps1 | iex`(建议以管理员身份运行),然后运行 `grepai version` 验证。
- 若 PowerShell 执行策略阻止脚本,先运行 `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`。
- 源码构建时 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 以使用本地 embeddings(参见 `grepai-ollama-setup` skill)。
- 安装后的下一步:运行 `grepai init` 初始化项目。
- 安装后的下一步:运行 `grepai watch` 开始索引。
- 若出现 `command not found: grepai`,确保 `/usr/local/bin` 在 PATH 中:运行 `export PATH="$PATH:/usr/local/bin"`。
- 若安装时出现 Permission denied,在安装命令前使用 `sudo`,或改为安装到用户目录。
- 若出现 Homebrew tap not found,先运行 `brew tap yoanbernabeu/tap`,再运行 `brew install grepai`。
- 成功安装后应看到类似输出:`✅ GrepAI installed successfully`、`Version: 0.24.0`、`Location: /usr/local/bin/grepai`,以及下一步安装 Ollama、`grepai init`、`grepai watch` 的提示。
适用边界 · 注意事项
- 不适用于安装其他工具或非 GrepAI 的搜索/索引工具。
- 若无法访问 GitHub raw 链接、GitHub 仓库或 Homebrew tap,在线安装/更新/源码构建会失败。
- 若没有 Go 1.24+,不要使用从源码构建方式;若系统无相应终端/PowerShell,也不适用对应平台安装方式。