RongleCat/grok-app

Grok App – 本地 Grok Build CLI 的桌面工作台

它是什么 – 一个开源、跨平台的桌面客户端（基于 Tauri 2 构建），让您可以在丰富的图形工作台内运行本地 grok 命令行代理（xAI 的“Grok Build”CLI）。它不附带任何专有模型；所有 LLM 推理、工具使用和权限处理都通过用户安装的 grok 二进制文件进行。

核心功能（根据 README 描述）

领域	您获得的功能
会话与项目管理	隔离的工作区、看板式状态板、Git 工作树切换、能够从任何助手轮次分叉会话，并附加最多三个参考会话。
实时代理交互	代理的思考、工具执行和最终答案的实时流式传输；细粒度的权限提示（询问、允许一次、允许会话、YOLO）；“Power Composer”可在代理忙碌时排队后续操作。
文件与媒体循环	集成的 CodeMirror 6 编辑器，与磁盘即时同步，可视化 Git 差异，预览图像、视频、音频、PDF 和 Office 文档，以及通过内置的 Imagine 技能进行 AI 图像/视频生成。
全渠道 IM 桥接	将本地代理连接到 11+ 个消息平台（飞书/Lark、Telegram、Discord、Slack、钉钉、企业微信、微信、QQ、Matrix、LINE、微博）以及一个令牌门控的移动网页镜像，用于远程控制。
桌面伴侣	可选的始终置顶“宠物”，显示代理状态并推送通知。
隐私与中继	API 密钥存储在操作系统钥匙串中，支持自定义提供商中继（OpenRouter、DeepSeek 等），官方 SuperGrok 服务的配额/热图跟踪。
自定义	浅色/深色/系统主题、自定义皮肤、字体、UI 语言（15 种内置语言环境）。

如何开始

1. 安装 Grok Build CLI（grok ≥ 0.2.112）。应用首次运行向导可以为您安装。
2. 下载预构建包，适用于 macOS、Windows 或 Linux，从网站或 GitHub 发布版获取。二进制文件不需要 Node.js 或 Rust 运行时。
3. 运行应用，按照设置向导链接 CLI（或使用 GROK_APP_ACP=mock 的模拟后端进行仅 UI 开发）。
4. 创建项目，信任文件夹，然后开始会话 – UI 将流式传输代理的输出，并允许您直接编辑文件。

技术说明（对高级用户有用）

• 基于 Tauri 2 构建 – 围绕 Vite 驱动的 Web UI 的轻量级原生包装器。
• ACP 协议 – 应用通过 Agent Communication Protocol 与 grok agent stdio 通信，实现细粒度的权限处理。
• 跨平台注意事项 – macOS 已公证，Windows 可能需要绕过 SmartScreen，Linux AppImage 需要主机 libEGL.so.1 和 WebKitGTK 4.1（或使用 .deb/.rpm）。
• 开发 – pnpm + Rust 工具链；pnpm dev 运行完整的桌面应用并支持热重载，GROK_APP_ACP=mock pnpm dev 跳过 CLI。

谁可能觉得它有用？

• 已经在本地使用 Grok Build CLI 并希望使用 GUI 来管理多个项目、查看文件更改并保留代理会话历史的开发人员。
• 需要一致的桌面环境进行 AI 辅助编码、内容创建或数据分析，同时保持所有数据在本地的团队。
• 希望将本地代理桥接到外部消息平台或通过内置 REST 会话 API 自动化任务的高级用户。

---

以上所有信息均直接取自仓库的 README；没有推断其他功能。