官方中文正文为项目官方提供的中文文档（原文转载），本站未作翻译、未改动文字，仅剔除图片与无关章节。

Grok App

专为 Grok Build CLI 打造的现代化桌面工作台

多项目管理 · 实时智能体流式会话 · 文件与代码闭环 · 全渠道远程 IM · 桌面伴侣与个性化

https://grok-app.com

✨ 核心亮点

• ⚡ 原生 Build 会话 — 通过 ACP 协议直接托管 grok agent stdio，支持 Ask（默认确认）、单次允许、本会话允许与 YOLO（完全自主）权限分级，默认启用 Grok 4.7 极高推理（xhigh），也可选 Grok 4.7 Fast。
• 🗂️ 多项目工作台 — 独立项目空间、智能体看板、Git 工作树（Worktree）一键无缝切换、从任意助手回复分叉（Fork）会话、将历史对话作为上下文一键引用。
• 📝 文件与创作闭环 — 内置 CodeMirror 代码与文本编辑器（支持实时保存与磁盘双向同步）、Git Diff 变更对比、图片/音视频/PDF/Office 丰富媒体预览，以及 Imagine 图像与视频生成。
• 📲 全渠道远程 IM 连接 — 内置远程控制桥接，支持飞书 (Lark)、Telegram、Discord、Slack、钉钉、企业微信、微信个人、QQ、Matrix、LINE 与微博；支持手机 Web 镜像及本地 REST API。
• 🐾 桌面伴侣与互动反馈 — 趣味置顶桌面宠物，实时感知智能体运行状态，提供灵动的交互反馈与气泡通知。
• 🔐 本地隐私与自定中转 — API Key 安全托管至系统钥匙串；支持官方 SuperGrok 额度与热力图监控，支持自定义中转提供商（OpenRouter、Requesty、DeepSeek、AI98PRO 等）并支持十五种界面语言。

🛠️ 功能全览

1. 现代化工作台与会话管理

• 项目与空间：文件夹信任机制、项目空间隔离、虚拟化高性能会话列表、归档与跨项目会话迁移、一键导入 CLI 历史会话。
• 并行任务流：多会话同时运行与后台持续流式输出，支持智能进程管理与闲置资源回收；直观看板分类（需要确认 / 正在执行 / 已完成）。
• Git 深度集成：自动识别项目绑定的 Git Worktrees，单会话一键切换工作目录，无缝应对多分支并行开发。
• 灵活分叉与引用：支持从任意助手回复处建立新分支会话（自动对齐截断上下文），支持通过 /attach-chat 或拖拽会话直接作为参考上下文。

2. Agent 交互与实时时间线

• 结构化时间线：思考过程、工具调用与最终回答按流式真实顺序展示，状态清晰，随时掌握 Agent 当前行为。
• 强大 Composer：执行中支持追加后续消息队列；Ctrl+Enter 实时插话引导；支持打字自动聚焦、历史提示词回溯、代码选区批注引用。
• 精细权限控制：默认 Ask 交互式审批；支持单次放行、当前会话信任、项目级默认策略与无人值守 YOLO 模式；支持工作区沙箱隔离。
• 任务与目标跟踪：实时显示多步执行计划与目标进度（Plan / Goal），支持在资源面板查看详细步骤与 Markdown 报告。

3. 文件、媒体与创作中心

• 内置编辑器：内置 CodeMirror 6，支持多标签页浏览与直接编辑保存代码/文本，Agent 生成修改后支持一键从磁盘重新载入。
• 变更与差异对比：会话级修改与工作区 Git Diff 可视化审查，支持单文件/批量接受、拒绝与版本还原。
• 全格式媒体预览：原生支持图片、视频、音频、PDF 以及 Word/Excel/PPT 等 Office 文档的高清预览与排版解析，支持一键导出精美分享长图。
• AI 创作能力：配合 Imagine 技能，直接在输入框生成高质量图片与视频；内置侧栏浏览器与设计模式，方便实时查看前端本地开发预览。

4. 扩展生态与自动化

• 斜杠指令与技能：全面对齐 Grok Build 斜杠指令集，支持行内技能快速调用与自定义工作流 (/workflow)。
• 扩展与插件中心：集成 MCP (Model Context Protocol) 服务管理，提供开放插件与技能生态（兼容 OpenAI 插件规范），所有扩展由用户自主管理。
• ChatCut 插件集成：内置推荐的 Codex 插件支持，统一管理授权刷新与浏览器协作。
• 定时与自动化：支持可视化查看定时任务列表，可通过自然语言对话直接设定自动化执行任务。

5. 远程连接与多端协作

• 全渠道 IM 桥接：支持绑定 11 大主流即时通讯平台，随时随地在手机群聊中唤醒并指挥本地 Agent（支持 /p 切换项目、/r 恢复会话）。
• 手机 Web 镜像：基于令牌验证的轻量移动端 Web 界面，支持配合 Cloudflare Quick Tunnel 实现内网穿透安全访问。
• 本地会话 API：提供标准 Loopback REST API (GET /v1/sessions、POST /v1/sessions/{id}/turns)，便于编写脚本或供第三方工具集成。

6. 账户、中转与个性化

• 多账号与用量追踪：支持多账号快速切换，内置 SuperGrok 额度进度条与消耗热力图统计，自定义提供商用量本地记录。
• 中转提供商配置：提供独立配置模式与共享模式（共享模式安全保护现有 ~/.grok 配置）；内置 OpenRouter、Requesty、DeepSeek、AI98PRO 等一键预设。
• 个性化视觉定制：支持浅色/深色/跟随系统主题，支持自定义皮肤、壁纸（本地图片/Unsplash/Imagine）、界面与终端字体。
• 多语言支持：原生内置 15 种语言（中、英、日、韩、德、法、俄、西、葡等），首次启动自动跟随操作系统语言。

📸 界面预览

🚀 快速开始与安装

1. 下载预编译包

从官网 grok-app.com 或 GitHub Releases 下载适合当前操作系统的安装包：

💡 提示：安装包名称为 Grok。预编译版本无需安装 Node.js、pnpm 或 Rust 等开发环境，开箱即用。

校验安装包完整性

每个 Release 均提供 SHA256SUMS 文件，下载后可通过以下命令校验：

# macOS / Linux
shasum -a 256 -c SHA256SUMS --ignore-missing

# Windows (PowerShell)
Get-FileHash .\Grok_*_x64-setup.exe -Algorithm SHA256

2. 首次运行与准备

1. 启动与环境检查：首次打开应用时，向导会自动检测本机是否已安装 Grok Build CLI（支持一键多源快速安装）。
2. 账号或中转配置：支持登录官方账号、绑定 API Key 或配置第三方中转。若本地 CLI 已完成登录，可直接选择 使用现有 CLI 登录，无需重复授权。
3. 添加项目：选择并信任本地工作目录。
4. 开始对话：连接 Agent，选择 Ask 或 YOLO 模式，开始享受高效的桌面开发辅助！

系统与依赖要求

• 本机已安装 Grok Build CLI（grok）0.2.112 或更高版本（可通过终端运行 grok update 进行更新）。
• Windows 环境需要 WebView2 Runtime（Windows 11 通常已内置；若缺失安装包会自动引导安装）。
• Linux AppImage：宿主需要 libEGL.so.1 以及 WebKitGTK 4.1 / Ayatana，见 Linux 运行时库。

网络代理设置（网络受限环境）

若所处网络无法直连 Grok 官方服务（如部分地区）：

• 进入 设置 → 运行环境 → 网络，配置 HTTP/SOCKS 代理（例如 http://127.0.0.1:7890）。
• 点击 测试连接 确认 auth.x.ai、grok.com 等端点连通性。应用会自动将代理环境变量无缝注入到所有 Agent 子进程中。

💡 平台说明与排查

macOS 提示「已损坏」或无法打开

官方 GitHub Releases 自 v0.2.19 起均已包含 Apple Developer ID 签名并完成 Apple 官方公证 (Notarization)。 若系统 Gatekeeper 仍出现拦截提示（如使用非官方编译版或隔离属性残留），可通过终端清除隔离标记：

xattr -cr /Applications/Grok.app
open /Applications/Grok.app

或在 系统设置 → 隐私与安全性 中找到拦截项并点击 仍要打开。

Windows SmartScreen 提示未知发布者

在运行未签名的社区版本时，Windows SmartScreen 可能会弹出提示。点击 更多信息 → 仍要运行 即可。建议通过 SHA256SUMS 校验下载包的哈希值。

卡巴斯基等第三方杀毒也可能把未签名的 Tauri 应用和随包 CLI 标成启发式威胁，这是社区构建的误报。请先核对安装包哈希，再把安装目录和应用数据目录（常见在 %LOCALAPPDATA%）加入排除项。根治需要 Windows 代码签名；应用无法在杀毒软件里给自己开白名单。

Linux 运行时库（AppImage）

官方 AppImage 不会打包宿主的 EGL / WebKit / 托盘库。在干净的 Debian / Ubuntu 上可能一启动就退出：

error while loading shared libraries: libEGL.so.1: cannot open shared object file

先装运行时包（.deb 已依赖 WebKit；再补 EGL/GLES）。已在 Debian 13（trixie）x86_64、官方 Grok_0.2.26_amd64.AppImage 上确认：

sudo apt-get install -y libegl1 libgles2 libwebkit2gtk-4.1-0 libayatana-appindicator3-1

然后 chmod +x 再运行 AppImage（或解压后的 usr/bin/grok-app）。.deb 已声明 libwebkit2gtk-4.1-0 与 libgtk-3-0。

这是进程启动时缺共享库，不是下面 Linux 渲染提示 的 Wayland / EGL_BAD_PARAMETER 情况。见 #899。

Linux 渲染提示 (WebKitGTK)

如果进程根本起不来，报错是 libEGL.so.1: cannot open shared object file，那是缺宿主库——见 Linux 运行时库。

部分运行 Wayland（如 Hyprland + AMD 显卡）的 Linux 环境下，AppImage 可能会因容器打包版本与主机 Mesa 驱动兼容性问题出现显示异常：

• 推荐方案：优先使用与系统包管理器契合的 .deb 或 .rpm 安装包（链接系统原生 WebKitGTK）。
• AppImage 若检测到本机 WebKitGTK 4.1（Arch：webkit2gtk-4.1，Debian/Ubuntu：libwebkit2gtk-4.1-0），会改用系统库，避免内置 WebKit 的 EGL_BAD_PARAMETER 黑屏（#539），以及 squashfs 卸载时残留 WebKitNetworkProcess 的 SIGBUS。可用 GROK_SKIP_SYSTEM_WEBKIT=1 退回内置库。
• 如使用 AppImage，可尝试添加环境变量运行：

  WEBKIT_DISABLE_DMABUF_RENDERER=1 ./Grok_*.AppImage

• 不要用 --appimage-mount 包一层再在 WebKit 子进程还活着时卸挂载，那会 SIGBUS。请用会解压到真实目录的 scripts/run-linux-appimage-system-webkit.sh。

Linux 工作区沙箱说明 (Ubuntu 24.04+)

Ubuntu 24.04+ 等现代发行版默认限制了非特权用户命名空间，可能导致 Agent 的 bubblewrap 沙箱无法启动：

• 方案一（推荐，保留系统级隔离）：启用非特权用户命名空间

  sudo sysctl -w kernel.apparmor_restrict_unprivileged_userns=0
  echo 'kernel.apparmor_restrict_unprivileged_userns=0' | sudo tee /etc/sysctl.d/99-userns.conf

• 方案二：在 设置 → 运行环境 → 沙箱 中将沙箱模式切换为 关闭 (off)。

📂 配置与数据目录

默认数据根目录如下（可通过环境变量 GROK_APP_HOME 自定义覆盖）：

目录结构一览：

<app-data>/
  projects.json          # 项目空间索引
  sessions_index.json    # 会话元数据与索引
  settings.json          # 应用通用设置
  secrets.json           # 密钥元数据（优先存入系统钥匙串，本地 0600 加密回退）
  automations.json       # 定时自动化配置
  projects/              # 项目专属数据
  sessions/              # 历史会话持久化
  logs/                  # 运行诊断日志
  agent-home/            # 独立模式专属 GROK_HOME

💻 源码构建与开发

如果你希望参与开发或从源码构建 Grok App：

环境要求

• Node.js: v22.0.0 或更高版本
• pnpm: v9.0.0 或更高版本
• Rust: 稳定版 (Stable Toolchain)
• C/C++ 构建工具：macOS Xcode CLT / Windows MSVC / Linux build-essential & webkit2gtk

本地开发

# 1. 安装项目依赖
pnpm install

# 2. 启动桌面开发模式（包含 Tauri 与前端热更新）
pnpm dev

# 3. 仅启动 Web 前端（开发调试 UI）
pnpm dev:ui

# 4. 无 CLI 环境的 Mock 联调模式
GROK_APP_ACP=mock pnpm dev

# 5. 代码质量检查与单元测试
pnpm typecheck && pnpm test
cd src-tauri && cargo test

# 6. 本机打包构建
pnpm build

pnpm dev 会 merge src-tauri/tauri.dev.conf.json（identifier 为 com.grokapp.desktop.dev，产品名 Grok Dev），可与已安装的 Grok 并排运行。会话/设置仍共用同一套 App data，除非设置 GROK_APP_HOME。裸跑 tauri dev（不带 --config）会用正式版 identifier，抢走已安装实例。

Windows（可选）：双击 install-latest.cmd 会把 main fast-forward 到 origin/main，并静默安装一份未签名的并排 grok-app-latest（不覆盖正式版 Grok）。需要 VS Build Tools + Rust MSVC；详见 docs/BUILD.md。

更多跨平台交叉编译与发版指南请参阅 docs/BUILD.md。

🤝 社区与贡献

欢迎通过 Issue 反馈问题或提交 Pull Request！

📄 开源协议与作者

本项目采用 MIT License 开源协议。

关注作者与社区

🌟 如果 Grok App 对你的日常开发有所帮助，请在 GitHub 上为我们点亮一颗 Star！