Grok 构建
Hacker News 摘要原标题：Grok Build
Grok Build（简称 grok）是 SpaceXAI 开发的一款基于终端的 AI 编程智能体。它以全屏终端用户界面（TUI）的形式运行，具备理解代码库、编辑文件、执行 shell 命令、进行网页搜索以及管理长期运行任务的能力。
该工具支持多种运行模式，包括交互式操作、用于脚本或持续集成的无头模式，以及通过智能体客户端协议（ACP）嵌入到编辑器中使用。
安装方式
官方为 macOS、Linux 和 Windows 提供了预编译的二进制文件。
• 对于 macOS、Linux 或 Git Bash 用户，可以使用 curl 命令下载并运行安装脚本。
• 对于 Windows PowerShell 用户，可以使用 irm 命令获取安装脚本并执行。
• 安装完成后，可以通过运行 grok --version 来验证。
从源码构建
构建 Grok Build 需要以下环境：
• Rust 语言环境：工具链版本由项目中的配置文件固定，首次构建时会自动安装。
• protoc：用于协议生成的工具，项目会尝试使用内置的启动器，或者调用系统环境变量中的路径。
• 操作系统支持：目前支持在 macOS 和 Linux 上构建，Windows 构建目前处于尽力而为的状态，尚未在当前代码树中经过完整测试。
具体的构建命令包括：使用 cargo 运行 pager-bin 包来启动 TUI 界面，或者编译 release 版本的二进制文件。生成的二进制文件名为 xai-grok-pager，但在官方安装包中通常被命名为 grok。
文档与用户指南
完整的在线文档可在官方网站查看。此外，pager 相关的包内也附带了用户指南，涵盖了入门教程、键盘快捷键、斜杠命令、配置选项、主题定制、MCP 服务器、技能扩展、插件、勾子函数、无头模式以及沙盒环境等内容。
仓库布局与目录结构
• crates/codegen/xai-grok-pager-bin：组合根包，用于构建最终的二进制文件。
• crates/codegen/xai-grok-pager：TUI 核心组件，负责滚动回溯、提示符、模态窗口和界面渲染。
• crates/codegen/xai-grok-shell：智能体运行时环境，包括引导程序、标准输入输出处理和无头模式入口。
• crates/codegen/xai-grok-tools：具体工具的实现，如终端操作、文件编辑和搜索功能。
• crates/codegen/xai-grok-workspace：管理宿主文件系统、版本控制系统、执行任务、检查点等。
• 其他子目录：包含配置管理、MCP 协议支持、Markdown 处理、沙盒等功能组件。
• third_party/：包含第三方源代码，如 Mermaid 图表栈。
注意：根目录下的 Cargo.toml 文件是自动生成的，应视为只读，开发者应修改各子包内的 Cargo.toml 文件。
开发与贡献
• 开发建议：为了提高速度，建议针对特定包进行编译和测试，而不是进行全工作区构建。
• 代码规范：项目使用特定的 lint 配置和格式化规则。
• 贡献限制：该项目目前不接受外部代码贡献。
许可证信息
本仓库中的原创代码采用 Apache License 2.0 许可证。第三方代码和引用的代码保留其原始许可证，具体细节记录在第三方通知文件中。