安装备用方式：版本直链、静默安装与 Linux 包

上一课走的是主路线：打开下载页，拿最新版，装上。但当你想固定装某个测过的版本、给一批电脑无人值守安装，或者在 Linux 上让升级跟着包管理器走，主路线就不够用了——这节课讲官方文档为脚本化获取 Grok Bot 安装包准备的三条备用路线：版本直链、Windows 静默安装、Linux 包。8 分钟，全部走一遍。

学完你能做什么

用官方发布源一条 curl 查出当前版本号和安装包地址（2026-11-03 实测：0.78.1）
用版本化直链模板下载指定版本的 Grok Bot 安装包（macOS / Windows 全平台）
完成一次 Grok Bot 静默安装：Grok_Bot_{version}_Setup.exe /S，并知道它装进 %LOCALAPPDATA%\Programs
在 Linux 上安装 .deb / .rpm 包（自动配好签名仓库）或直接运行 AppImage
用 apt / dnf 命令升级 Linux 上的 Grok Bot，并用 apt-mark hold 控制升级时机

你现在的困境

公司要求全组装同一个测过的版本，可下载页永远只有「最新版」
IT 要给几十台 Windows 装 Grok Bot，总不能每台都有人点一遍「下一步」
Linux 上所有软件都走 apt / dnf，就 Grok Bot 要下个 AppImage 扔在桌面自己管更新

什么时候用这一招

当你需要：

固定下载你测过的那个版本，而不是永远「最新版」
用脚本拿地址、批量下载安装包
Windows 批量部署，安装过程无人值守
Linux 用包管理器安装，升级时机自己定

而且不想：

每台电脑都打开下载页手动点一遍
装完以后版本不受控地自动跳新版——Linux 的 deb / rpm 是唯一升级由你的包管理器说了算的安装方式

🎒 开始前的准备

完成了 1.3 安装：5 分钟装好桌面版——主路线已走通，这一课全部是备用路线
知道自己的平台和架构：macOS（Apple silicon / Intel）、Windows（x64 / Arm64）、Linux（x64 / Arm64）
会用终端跑命令（macOS / Linux 用终端，Windows 用 PowerShell 或 cmd）
给公司部署的：确认你们用什么装机工具（Intune、Jamf、Configuration Manager、Ansible……），并准备一台试点设备

核心思路

主路线的问题：下载页只列「当前安装包」，而且 app 装好后自己检查更新。备用路线解决两件事——版本受控（装我测过的版本）和批量安装（无人值守）。

官方为脚本化下载准备了一个「发布源」（release feed）：每个平台一个 JSON 地址，https://api2.cursor.sh/updates/api/download/stable/{platform}/sand，里面有 version、commitSha、downloadUrl（Linux 还多出 debUrl / rpmUrl）。

四条路线对比：

路线	怎么拿安装包	装完后谁管升级	适合谁
下载页（上一课）	cursor.com/download/bot	app 自动检查更新	个人用户，永远用最新版
版本直链	发布源查版本 + 直链模板	app 自动检查更新	想固定装某个版本
Windows 静默安装	直链下载 Setup `.exe` + `/S`	app 自动检查更新	IT 批量部署
Linux `.deb` / `.rpm`	发布源的 `debUrl` / `rpmUrl`	你的包管理器	Linux 用户 / 运维

Linux 还有 AppImage 格式，升级方式和 macOS / Windows 一样由 app 自己检查——所以管批量机器时，官方推荐优先用包而不是 AppImage。

一个必须先知道的事实：桌面 app 的更新检查关不掉。官方文档明说：macOS、Windows、AppImage 安装没有任何设备策略、安装参数或 dashboard 设置能关掉更新检查；版本超过 14 天且已有新版，app 会用 Update required 全屏拦住你。所以「固定版本」固定的是你装哪个版本，不是 app 停在哪个版本。唯一例外是 Linux 的 deb / rpm：app 不自己升级，新版本通过包管理器到达。

跟我做

三条路线互相独立：个人锁版本走第 1–2 步，IT 装 Windows 走第 3 步，Linux 用户走第 4–5 步。步骤编号连续，方便交叉引用。

第 1 步：从官方发布源查当前版本与下载地址

为什么：下载页永远只给「最新版」；脚本化下载和固定版本都需要先拿到「当前版本号 + 精确文件地址」，官方发布源一次给全。

bash

curl -s https://api2.cursor.sh/updates/api/download/stable/darwin-arm64/sand

把 URL 里的 {platform} 换成你的平台：

`{platform}`	平台
`darwin-arm64`	macOS，Apple silicon
`darwin-x64`	macOS，Intel
`win32-x64-user`	Windows x64
`win32-arm64-user`	Windows Arm64
`linux-x64`	Linux x64
`linux-arm64`	Linux Arm64

你应该看到：一整行 JSON（2026-11-03 实测，macOS Apple silicon）：

json

{"downloadUrl":"https://downloads.cursor.com/grokbot/stable/darwin-arm64/0.78.1/Grok_Bot_0.78.1.dmg","version":"0.78.1","commitSha":"72e130b4e6be3fdc47b97e809b6b420908ce2dd8"}

响应里可能还有其他字段（如实测中的 rehUrl）；装桌面 app 用不到它们，下面只看需要的字段。

字段对照：

字段	含义
`version`	当前版本号（实测 0.78.1，以你查询时为准）
`commitSha`	这个构建对应的提交号；Linux 下载地址里包含它
`downloadUrl`	安装包地址：macOS `.dmg`、Windows Setup `.exe`、Linux AppImage
`debUrl` / `rpmUrl`	仅 Linux 有：`.deb` 和 `.rpm` 包的地址

我拿到了 version 和 downloadUrl，也知道自己的平台该查哪个 {platform}

第 2 步：用版本直链下载指定版本的 Grok Bot 安装包

为什么：macOS 和 Windows 的每个版本都保留一个固定格式的直链。把 {version} 换成你要的版本号就能下载——这是「固定装测过的版本」的基础。

text

# macOS，Apple silicon
https://downloads.cursor.com/grokbot/stable/darwin-arm64/{version}/Grok_Bot_{version}.dmg

# macOS，Intel
https://downloads.cursor.com/grokbot/stable/darwin-x64/{version}/Grok_Bot_{version}_x64.dmg

# Windows x64
https://downloads.cursor.com/grokbot/stable/win32-x64/{version}/Grok_Bot_{version}_Setup.exe

# Windows Arm64
https://downloads.cursor.com/grokbot/stable/win32-arm64/{version}/Grok_Bot_{version}_Setup.exe

比如下载 0.78.1 的 macOS Apple silicon 安装包（地址就是发布源里 downloadUrl 的值）：

bash

curl -LO https://downloads.cursor.com/grokbot/stable/darwin-arm64/0.78.1/Grok_Bot_0.78.1.dmg

你应该看到：开始下载一个文件名里带版本号的安装包，如 Grok_Bot_0.78.1.dmg。

⚠️ Linux 别套这个模板

Linux 包不在版本号路径下，而在 commitSha 路径下（https://downloads.cursor.com/grokbot/stable/{commitSha}/linux/x64/ 或 .../linux/arm64/）。不要自己拼地址——从 Linux 发布源的 downloadUrl、debUrl、rpmUrl 复制完整 URL，第 4 步有实测示例。

💡 固定版本的正确姿势

官方没公布旧版本直链保留多久，固定的构建也只在它还有支持期间可用。要固定版本，就把测过的安装包存进你自己的软件仓库或 MDM 包存储，以后从自己的副本部署——每台新设备拿到的都是同一个构建。

安装包下载完成，文件名里的版本号和我要的一致

第 3 步：Windows 静默安装 Grok Bot（/S）

为什么：批量部署时不能每台电脑都有人点「下一步」。Grok Bot 的 Windows 安装包支持静默参数 /S——这是官方文档给 IT 的部署口径。

在安装包所在目录运行（PowerShell 或 cmd），把版本号换成你下载的版本：

text

Grok_Bot_0.78.1_Setup.exe /S

三个必须知道的细节：

细节	说明
按用户安装	装进当前用户的 `%LOCALAPPDATA%\Programs`，不是全机器的 Program Files
用用户上下文部署	因为是按用户安装，MDM 推送时要在用户上下文跑，不能用 SYSTEM
先试点	官方要求推全量之前，先在一台试点设备上测试安装

你应该看到：没有安装向导弹出；稍等片刻，开始菜单里出现 Grok Bot，程序文件在 %LOCALAPPDATA%\Programs 下。

试点设备上静默安装成功，Grok Bot 能从开始菜单打开

💡 没有 MSI / PKG

官方 FAQ 明确：发布的安装包只有 macOS .dmg、Windows Setup .exe、Linux .deb / .rpm / AppImage。如果你的管理工具必须要 MSI 或 PKG 格式，把 .exe / .dmg 包进它要求的格式里。

第 4 步：Linux 安装 deb / rpm 包（或直接运行 AppImage）

为什么：deb / rpm 是 Linux 上唯一「升级跟着包管理器走」的安装方式——官方也推荐管理的机器集群优先用包，而不是 AppImage。

从 Linux 发布源拿包地址（{platform} 用 linux-x64；Arm64 机器用 linux-arm64，地址路径变成 /linux/arm64/）。2026-11-03 实测（0.78.1，x64）：

text

# AppImage（downloadUrl）
https://downloads.cursor.com/grokbot/stable/72e130b4e6be3fdc47b97e809b6b420908ce2dd8/linux/x64/Grok_Bot_0.78.1.AppImage

# deb（debUrl）
https://downloads.cursor.com/grokbot/stable/72e130b4e6be3fdc47b97e809b6b420908ce2dd8/linux/x64/grok-bot_0.78.1_amd64.deb

# rpm（rpmUrl）
https://downloads.cursor.com/grokbot/stable/72e130b4e6be3fdc47b97e809b6b420908ce2dd8/linux/x64/grok-bot-0.78.1-1.x86_64.rpm

注意文件名：deb / rpm 的包名是小写的 grok-bot——第 5 步升级命令里的包名就是它。

安装方式按系统对号入座：

你的系统	装哪个包	怎么装
Debian / Ubuntu	`.deb`	用你现有的配置管理工具安装（Ansible、Puppet、Chef）；单机就用系统包管理器装下载的文件
Fedora / 其他 RPM 系统	`.rpm`	同上
任何发行版	AppImage	下载后直接运行，和上一课一样

官方部署文档面向企业批量场景，没有给单机安装命令；装完之后，重点看下面这个验证点。

你应该看到：安装完成后，签名仓库文件出现了——

装 .deb：/etc/apt/sources.list.d/grok-bot.sources（签名 apt 仓库）
装 .rpm：/etc/yum.repos.d/grok-bot.repo（签名仓库）

有了它们，设备跑例行包升级时就会顺带拿到 Grok Bot 新版本——第 5 步的升级命令靠的就是这个仓库。

对应的仓库文件出现了（deb → grok-bot.sources；rpm → grok-bot.repo）

第 5 步：Linux 用 apt / dnf 升级 Grok Bot

为什么：deb / rpm 安装的 Grok Bot 不会自己升级——app 不安装更新，新版本通过包管理器到达。这是它和 macOS / Windows / AppImage 安装最大的区别。

升级命令（Update required 全屏上显示的也是这两条，带 Copy command 按钮）：

bash

# Debian / Ubuntu（deb 安装）
sudo apt update && sudo apt install --only-upgrade grok-bot

# Fedora 或其他 RPM 系统
sudo dnf upgrade --refresh grok-bot

你应该看到：包管理器拉取 grok-bot 新版本并完成安装；重启 Grok Bot 后，账户菜单 Support → About 里的版本号变成新版本。

想控制「什么时候升级」，官方给了两个办法：

办法	操作	效果
锁包	`apt-mark hold grok-bot`	包被 hold 住，你想升级时再释放
关仓库	deb 在 `grok-bot.sources` 里设 `Enabled: no`；rpm 在 `grok-bot.repo` 里设 `enabled=0`	新版本不再自动到达，由你自己分发测过的包

两个细节：包在每次安装 / 升级时会重写这些仓库文件，并保留你的选择；被 hold 的包版本太旧时照样会看到 Update required 全屏——所以别 hold 太久，在版本失去支持前升级。关了仓库之后遇到 Update required，屏幕会提示你改为下载安装最新包并附链接，装完重启 Grok Bot 即可。

升级命令跑完，Support → About 显示新版本号

检查点 ✅

我能用官方发布源查出当前版本号和安装包地址（2026-11-03 实测为 0.78.1）
我知道 macOS / Windows 的版本直链模板；Linux 包地址在 commitSha 路径下，从发布源复制
Windows 静默安装 /S 我在试点设备上试过，装进了 %LOCALAPPDATA%\Programs
Linux 上 deb / rpm 装好后，对应的签名仓库文件出现了
我会用 apt / dnf 升级 grok-bot，也知道 apt-mark hold 和关仓库两个控制办法

踩坑提醒

❌ 以为「固定版本」=「app 停在这个版本」

官方明说：macOS、Windows、AppImage 安装没有任何设备策略、安装参数或 dashboard 设置能关掉更新检查。固定版本只决定你装哪个版本；装完 app 照样检查并提示新版，版本超过 14 天且已有新版就被 Update required 全屏拦住。想自己控制升级节奏，只有 Linux 的 deb / rpm。

❌ Windows 静默安装用 SYSTEM 账户跑

/S 是按用户安装，装进 %LOCALAPPDATA%\Programs，用 SYSTEM 跑会装错地方。官方要求在用户上下文部署，并且推全量前先在一台试点设备上测试。

❌ Linux 直链自己拼版本号

macOS / Windows 直链是 {version} 路径，Linux 包在 {commitSha} 路径下。别拿 macOS 模板套 Linux——从 Linux 发布源的 downloadUrl / debUrl / rpmUrl 复制完整地址，并把完整 URL 和版本号一起记录（官方建议）。

❌ 找 MSI / PKG 安装包

官方 FAQ：发布的安装包只有 .dmg、Setup .exe、.deb / .rpm / AppImage，没有 MSI、没有 PKG。管理工具必须要这些格式，就把 .exe / .dmg 包进它要求的格式里。

进阶技巧（可选）

公司批量部署整套：macOS 用 Jamf Pro、Kandji、Intune 推 .dmg；Windows 用 Intune、Configuration Manager 推 .exe；Linux 用 Ansible、Puppet、Chef 装包。网络放行、SSO 分配、管理员控制一并在企业 IT 部署讲全。

查设备当前版本：app 账户菜单 → Support → About，对话框显示 Version；Copy version info 一键复制版本、发布通道和操作系统。

版本门槛速查：功能对版本起步的要求（如 Vault 需 0.75.2+）见版本与更新。

本课小结

✅ 你能用官方发布源一条 curl 查出当前版本和各平台的 Grok Bot 安装包地址（2026-11-03 实测 0.78.1）。

✅ 你会用版本直链模板下载指定版本（macOS / Windows）；Linux 包从发布源的 debUrl / rpmUrl 拿 commitSha 路径下的精确地址。

✅ 你会在 Windows 上静默安装：/S、按用户装进 %LOCALAPPDATA%\Programs、用户上下文部署、先试点。

✅ 你会在 Linux 上装 deb / rpm（自动配好签名仓库）或直接运行 AppImage，并用 apt / dnf 升级。

关键信息回顾：

项目	要点
官方发布源	`https://api2.cursor.sh/updates/api/download/stable/{platform}/sand`
`{platform}` 取值	darwin-arm64 / darwin-x64 / win32-x64-user / win32-arm64-user / linux-x64 / linux-arm64
macOS / Windows 直链	`https://downloads.cursor.com/grokbot/stable/{platform}/{version}/Grok_Bot_{version}…`
Linux 包地址	`…/stable/{commitSha}/linux/x64/` 或 `…/linux/arm64/`，从发布源复制
Windows 静默安装	`Grok_Bot_{version}_Setup.exe /S`，按用户装进 `%LOCALAPPDATA%\Programs`
Linux 升级	`sudo apt update && sudo apt install --only-upgrade grok-bot` / `sudo dnf upgrade --refresh grok-bot`
当前版本	0.78.1（2026-11-03 官方发布源实测）

下一课预告

装与升级的路线都齐了。哪里卡住——登录循环、装不上、打不开——下一课专治：起步排错：登录循环、装不上、打不开。

你会学到：

sign-in 卡住不完成时的官方自查步骤，登录循环的解法（清 cookie、隐身窗口、等 30–60 分钟）
app 启动卡死怎么办
Update required 全屏出现时该点哪里

如果你一切顺利，也可以直接跳去 1.5 第一个 Bot 给它派第一件活。

安装备用方式：版本直链、静默安装与 Linux 包 ​

学完你能做什么 ​

你现在的困境 ​

什么时候用这一招 ​

🎒 开始前的准备 ​

核心思路 ​

跟我做 ​

第 1 步：从官方发布源查当前版本与下载地址 ​

第 2 步：用版本直链下载指定版本的 Grok Bot 安装包 ​

第 3 步：Windows 静默安装 Grok Bot（/S） ​

第 4 步：Linux 安装 deb / rpm 包（或直接运行 AppImage） ​

第 5 步：Linux 用 apt / dnf 升级 Grok Bot ​

检查点 ✅ ​

踩坑提醒 ​

❌ 以为「固定版本」=「app 停在这个版本」 ​

❌ Windows 静默安装用 SYSTEM 账户跑 ​

❌ Linux 直链自己拼版本号 ​

❌ 找 MSI / PKG 安装包 ​

进阶技巧（可选） ​

本课小结 ​

下一课预告 ​

安装备用方式：版本直链、静默安装与 Linux 包

学完你能做什么

你现在的困境

什么时候用这一招

🎒 开始前的准备

核心思路

跟我做

第 1 步：从官方发布源查当前版本与下载地址

第 2 步：用版本直链下载指定版本的 Grok Bot 安装包

第 3 步：Windows 静默安装 Grok Bot（/S）

第 4 步：Linux 安装 deb / rpm 包（或直接运行 AppImage）

第 5 步：Linux 用 apt / dnf 升级 Grok Bot

检查点 ✅

踩坑提醒

❌ 以为「固定版本」=「app 停在这个版本」

❌ Windows 静默安装用 SYSTEM 账户跑

❌ Linux 直链自己拼版本号

❌ 找 MSI / PKG 安装包

进阶技巧（可选）

本课小结

下一课预告