73 个一方 Crate 总索引
根 Cargo.toml 是 workspace 成员的权威入口。本附录只把 crates/codegen 与 crates/common 视为一方产品 crate；crates/build、prod 和 third_party 具有不同发布或来源边界，在另一篇附录单独说明。
固定基线共登记 73/73 个一方 crate，图谱覆盖 1,712 个生产 Rust 文件和 2,160 个 Rust 文件总量。
分层是面向阅读的归纳，不是上游声明的官方模块等级。每个 crate 仍以真实 Cargo 依赖、反向依赖和公开符号为证据；测试辅助 crate 会标记为“测试支持”，不会被误写成用户请求的生产主链。
ptyctl
控制无头伪终端、屏幕状态和子进程生命周期。
交互呈现ptyctl-cli
控制无头伪终端、屏幕状态和子进程生命周期。
会话运行时xai-acp-lib
会话运行时层的一方 crate；上游清单描述为：未提供 description，职责由公开模块和依赖关系归纳。
会话运行时xai-agent-lifecycle
负责 Agent 定义解析、构建和 system prompt 装配。
会话运行时xai-chat-state
以 actor 所有权维护聊天状态和可订阅的状态投影。
Agent 与推理xai-circuit-breaker
根据连续故障和恢复探测限制外部请求故障扩散。
工具与工作区xai-codebase-graph
使用 tree-sitter query 生成符号和代码关系图。
工具与工作区xai-computer-hub-core
定义 Computer Hub 的传输、注册表和解析器抽象。
工具与工作区xai-computer-hub-mcp-adapter
把 MCP 发现的工具适配并注册为原生 Computer Hub 工具。
工具与工作区xai-computer-hub-sdk
提供连接池、透明重连和工具服务器运行时 SDK。
会话运行时xai-crash-handler
处理跨平台崩溃信号并检测启动期连续崩溃。
工具与工作区xai-fast-worktree
使用 CoW 克隆快速创建隔离 Git worktree。
工具与工作区xai-file-utils
工具与工作区层的一方 crate；上游清单描述为：Local data collection: per-turn event tracking。
工具与工作区xai-fsnotify
把本地文件系统变化归一化为单一因果语义事件流。
工具与工作区xai-gix-status
在进程线程预算内安全执行共享 gix status 扫描。
Agent 与推理xai-grok-agent
负责 Agent 定义解析、构建和 system prompt 装配。
安全、扩展与运维xai-grok-announcements
安全、扩展与运维层的一方 crate；上游清单描述为：Shared announcement types, persistence, and formatting for Grok CLI apps。
Agent 与推理xai-grok-auth
通过 trait 提供 HTTP 认证与凭据提供者的依赖倒置接缝。
Agent 与推理xai-grok-compaction
实现与传输无关的上下文压缩、摘要提交和失败回退。
安全、扩展与运维xai-grok-config
加载 requirements、用户与受管配置并执行有序 TOML 合并。
安全、扩展与运维xai-grok-config-types
定义不依赖运行时的叶子配置值类型。
安全、扩展与运维xai-grok-env
安全、扩展与运维层的一方 crate；上游清单描述为：Backend environment presets for the Grok CLI crate family: endpoint URL defaults and env-var test support.。
安全、扩展与运维xai-grok-hooks
负责 hook 发现、命令执行、超时和策略拦截。
Agent 与推理xai-grok-http
集中构造共享 reqwest 客户端、User-Agent 和网络默认值。
交互呈现xai-grok-markdown
负责流式 Markdown 的增量解析、样式计算和终端呈现。
交互呈现xai-grok-markdown-core
提供与终端渲染器一致的无头 Markdown 解析和结构分析。
安全、扩展与运维xai-grok-mcp
隔离 MCP 传输依赖并负责 Server 生命周期、凭据和 OAuth 编排。
Agent 与推理xai-grok-memory
负责跨会话记忆的存储、切分、向量检索和后台整理。
交互呈现xai-grok-mermaid
把 Mermaid 文本通过可替换引擎转换为终端可展示图像。
Agent 与推理xai-grok-models
Agent 与推理层的一方 crate；上游清单描述为：Default model IDs for the grok CLI, loaded from the embedded default_models.json.。
交互呈现xai-grok-pager
承载主 TUI 的状态、事件、Effect、视图和用户输入循环。
会话运行时xai-grok-pager-bin
提供 Grok Build 终端程序的二进制入口与启动参数边界。
交互呈现xai-grok-pager-minimal
提供最小终端客户端，用较小依赖面验证核心交互与降级路径。
测试支持xai-grok-pager-pty-harness
提供 PTY 端到端场景、屏幕断言和性能基准所需的测试基础设施。
交互呈现xai-grok-pager-render
负责终端帧、图片覆盖层和渲染后端，将视图状态转为可提交的终端输出。
安全、扩展与运维xai-grok-paths
提供绝对/相对 UTF-8 路径包装并维持路径不变量。
安全、扩展与运维xai-grok-plugin-marketplace
解析和管理插件 Marketplace 元数据及扩展来源。
Agent 与推理xai-grok-sampler
以 actor 形式管理模型采样、HTTP 流、重试、取消和领域事件。
Agent 与推理xai-grok-sampling-types
定义采样请求、响应和流式事件使用的纯数据类型。
安全、扩展与运维xai-grok-sandbox
通过操作系统内核机制为工具执行建立最小能力沙箱。
安全、扩展与运维xai-grok-secrets
在遥测和错误上报前识别并清洗可能的秘密材料。
安全、扩展与运维xai-grok-shared
安全、扩展与运维层的一方 crate；上游清单描述为：未提供 description，职责由公开模块和依赖关系归纳。
会话运行时xai-grok-shell
承载 Leader、Session、Agentic Loop、权限与持久化的主要运行时。
安全、扩展与运维xai-grok-shell-base
封装 Shell 家族共享的环境、进程、文件系统和 profiling 基础能力。
安全、扩展与运维xai-grok-shell-session-support
提供 Session 的 MCP catalog、凭据缓存和文件访问跟踪支持。
Agent 与推理xai-grok-subagent-resolution
负责 Agent 定义解析、构建和 system prompt 装配。
安全、扩展与运维xai-grok-telemetry
聚合产品事件、Mixpanel 发射和错误上报。
测试支持xai-grok-test-support
集中提供密封测试环境、模拟服务和共享测试工具。
工具与工作区xai-grok-tools
实现 Grok Build 可调用的文件、Shell、任务和工作区工具集合。
工具与工作区xai-grok-tools-api
维护 Grok 工具的 Protobuf API 定义和生成边界。
安全、扩展与运维xai-grok-update
安全、扩展与运维层的一方 crate；上游清单描述为：未提供 description，职责由公开模块和依赖关系归纳。
安全、扩展与运维xai-grok-version
安全、扩展与运维层的一方 crate；上游清单描述为：Lockstepped grok CLI version.。
Agent 与推理xai-grok-voice
提供流式语音转文字和输入草稿更新能力。
工具与工作区xai-grok-workspace
提供本地主机工作区的文件、VCS、命令执行和项目发现能力。
工具与工作区xai-grok-workspace-client
提供经 Hub 代理调用远程 workspace RPC 的类型化客户端。
工具与工作区xai-grok-workspace-types
定义远程 workspace 请求、分块响应和事件的 wire types。
安全、扩展与运维xai-hooks-plugins-types
负责 hook 发现、命令执行、超时和策略拦截。
工具与工作区xai-hunk-tracker
追踪文件 diff hunk 并区分 Agent 与外部修改来源。
会话运行时xai-interjection-core
提供 mid-turn interjection 缓冲、顺序控制和格式化。
安全、扩展与运维xai-mixpanel
提供轻量 Mixpanel HTTP 事件发送客户端。
会话运行时xai-prompt-queue
定义跨 Shell 与 Pager 共享的 prompt queue 类型和队列语义。
交互呈现xai-ratatui-inline
支持在现有终端区域内嵌运行 ratatui 组件。
交互呈现xai-ratatui-textarea
实现 Unicode 感知的终端多行输入、选择和光标移动。
会话运行时xai-sqlite-journal
按文件系统能力选择安全的 SQLite journal 模式。
会话运行时xai-system-power
提供跨平台休眠和唤醒通知。
测试支持xai-test-utils
集中提供密封测试环境、模拟服务和共享测试工具。
Agent 与推理xai-token-estimation
提供纯 token 估算原语，为预算与压缩决策提供近似值。
工具与工作区xai-tool-protocol
定义 Computer Hub 工具调用的稳定传输协议类型。
工具与工作区xai-tool-runtime
定义统一 Tool trait、分派、错误分类、通知和搜索索引。
工具与工作区xai-tool-types
定义工具描述和 schema 等平台共享叶子类型。
安全、扩展与运维xai-tracing
提供跨模块共享的结构化 tracing 基础设施。
安全、扩展与运维xai-tracing-macros
提供基于 tracing 的时间戳和耗时记录宏。
交互呈现xai-tty-utils
封装 TTY 安全的子进程派生、pager 抑制和进程组回收。
非官方社区学习项目。Grok、xAI 及相关商标归其权利人所有；源码摘录来自 Apache-2.0 许可的公开仓库。
豫ICP备2026029221号-1