跳转到内容
GBGrok Build Architecture

xai-grok-workspace

工具与工作区

xai-grok-workspace

提供本地主机工作区的文件、VCS、命令执行和项目发现能力。

Cargo description: Core host-local workspace library (FS, VCS, execution, discovery) for xai-grok-shell and remote sampler

81生产文件
87Rust 文件总数
75,607生产代码行
30收录公开符号

职责与架构位置

xai-grok-workspace 位于“工具与工作区”层。它的首要职责是：提供本地主机工作区的文件、VCS、命令执行和项目发现能力。。源码图谱把 crate 看成一个编译和所有权边界，而不是文件夹标签：直接依赖表示它可以调用的下层能力，反向依赖表示哪些上层模块把它当作稳定接缝。

成员路径为 crates/codegen/xai-grok-workspace，清单位于 Cargo.toml。

关键入口

SOURCEinit_metricscrates/codegen/xai-grok-workspace/src/lib.rs:64–74207 行 · 公开符号入口SOURCEWORKSPACE_TERMINAL_BACKEND_ORPHANED_TOTALcrates/codegen/xai-grok-workspace/src/handle.rs:109–1199,484 行 · 公开符号入口SOURCEYOLOcrates/codegen/xai-grok-workspace/src/permission/manager.rs:26–365,634 行 · 公开符号入口SOURCEresolve_permission_config_with_fallbackcrates/codegen/xai-grok-workspace/src/permission/resolution.rs:310–3204,209 行 · 公开符号入口SOURCEERROR_CODE_DIFF_SIZE_EXCEEDEDcrates/codegen/xai-grok-workspace/src/session/git.rs:15–254,154 行 · 公开符号入口SOURCEto_creation_modecrates/codegen/xai-grok-workspace/src/worktree/mod.rs:38–483,098 行 · 公开符号入口

入口文件优先按 lib.rs/main.rs、公开符号密度和文件规模选择。这是一条面向阅读的路径，不表示其他文件不重要；下方完整文件索引覆盖该 crate 的全部 Rust 源码、测试、示例、基准与 Fuzz 文件。

依赖与调用者

依赖边来自固定提交中的 Cargo manifest，只表示编译期直接依赖。运行时控制流还需结合 trait 实现、构造位置和消息通道判断；反向依赖为空也不代表 crate 没有入口，它可能直接生成二进制或由外部协议调用。

关键公开符号

类型符号文件与行号
constPREVIEW_ACTIVITY_WINDOW_MScrates/codegen/xai-grok-workspace/src/activity.rs:28
structActivityTrackercrates/codegen/xai-grok-workspace/src/activity.rs:61
fnnewcrates/codegen/xai-grok-workspace/src/activity.rs:136
fnwith_prune_windowcrates/codegen/xai-grok-workspace/src/activity.rs:143
fnwith_prune_window_and_idle_holdcrates/codegen/xai-grok-workspace/src/activity.rs:149
fnwith_idle_ignores_backgroundcrates/codegen/xai-grok-workspace/src/activity.rs:182
fnwith_preview_activity_window_mscrates/codegen/xai-grok-workspace/src/activity.rs:189
fnset_event_writerscrates/codegen/xai-grok-workspace/src/activity.rs:199
fnset_upload_queue_statscrates/codegen/xai-grok-workspace/src/activity.rs:205
fnset_producer_taskscrates/codegen/xai-grok-workspace/src/activity.rs:211
fnnotify_handlecrates/codegen/xai-grok-workspace/src/activity.rs:216
fnnote_preview_activitycrates/codegen/xai-grok-workspace/src/activity.rs:223
fndrain_startedcrates/codegen/xai-grok-workspace/src/activity.rs:258
fntool_call_startedcrates/codegen/xai-grok-workspace/src/activity.rs:346
fntool_call_completedcrates/codegen/xai-grok-workspace/src/activity.rs:401
fnbackground_task_startedcrates/codegen/xai-grok-workspace/src/activity.rs:454
fnbackground_task_completedcrates/codegen/xai-grok-workspace/src/activity.rs:471
fnturn_startedcrates/codegen/xai-grok-workspace/src/activity.rs:485
fnturn_completedcrates/codegen/xai-grok-workspace/src/activity.rs:495
fncancel_all_session_callscrates/codegen/xai-grok-workspace/src/activity.rs:509
fnsession_endedcrates/codegen/xai-grok-workspace/src/activity.rs:527
fnis_turn_activecrates/codegen/xai-grok-workspace/src/activity.rs:535
fnsession_active_tool_callscrates/codegen/xai-grok-workspace/src/activity.rs:544
fnset_activecrates/codegen/xai-grok-workspace/src/activity.rs:550
fnset_drainingcrates/codegen/xai-grok-workspace/src/activity.rs:561
fnset_shutting_downcrates/codegen/xai-grok-workspace/src/activity.rs:573
fnis_drainingcrates/codegen/xai-grok-workspace/src/activity.rs:579
fnis_drainedcrates/codegen/xai-grok-workspace/src/activity.rs:592
fntools_idlecrates/codegen/xai-grok-workspace/src/activity.rs:598
fntotal_activecrates/codegen/xai-grok-workspace/src/activity.rs:602

公开符号用于快速判断 crate 对外暴露的数据、trait 和执行入口。私有实现仍会出现在完整文件索引中；本文不会仅凭 pub 推断某个符号就是长期稳定 API。

关联深度文章

什么是 Grok Build从公开 Rust 源码界定 terminal-native agentic coding system 的职责、入口与边界。

架构全景梳理 workspace、核心 crate 和端到端数据流，建立阅读源码的总地图。

一次请求的端到端链路从用户输入追踪到模型采样、工具调用、工作区变更和最终渲染。

System Prompt、项目规则与配置合并追踪 requirements、用户配置、AGENTS.md 和工作区上下文的优先级。

Workspace FS、Discovery 与项目规则说明工作区根、文件访问、忽略规则和项目规则发现。

Workspace Execution、VCS、FS Events 与 Gix Status串联命令执行、版本控制状态、语义文件事件和线程预算。

Worktree、Checkpoint 与 Hunk Tracking解释 CoW worktree、检查点和代码 hunk 归因怎样支持隔离与恢复。

完整 Rust 文件索引

共 87 个 Rust 文件，其中 81 个被覆盖校验认定为生产源码。测试、示例、基准和 Fuzz 文件不会从图谱删除，而是使用不同标签展示。

生产源码crates/codegen/xai-grok-workspace/src/activity.rs1,945 行 · 12 个公开符号生产源码crates/codegen/xai-grok-workspace/src/bin/workspace_server_probe.rs215 行 · 0 个公开符号生产源码crates/codegen/xai-grok-workspace/src/bin/workspace_server.rs600 行 · 0 个公开符号生产源码crates/codegen/xai-grok-workspace/src/capability.rs333 行 · 5 个公开符号生产源码crates/codegen/xai-grok-workspace/src/channel.rs20 行 · 4 个公开符号生产源码crates/codegen/xai-grok-workspace/src/config.rs1,086 行 · 12 个公开符号生产源码crates/codegen/xai-grok-workspace/src/daemonize.rs1,074 行 · 12 个公开符号生产源码crates/codegen/xai-grok-workspace/src/diag_server.rs555 行 · 12 个公开符号生产源码crates/codegen/xai-grok-workspace/src/discovery.rs588 行 · 5 个公开符号生产源码crates/codegen/xai-grok-workspace/src/envrc.rs286 行 · 3 个公开符号生产源码crates/codegen/xai-grok-workspace/src/error.rs87 行 · 2 个公开符号生产源码crates/codegen/xai-grok-workspace/src/file_system/acp_fs.rs180 行 · 3 个公开符号生产源码crates/codegen/xai-grok-workspace/src/file_system/adapter.rs90 行 · 2 个公开符号生产源码crates/codegen/xai-grok-workspace/src/file_system/attach_file.rs541 行 · 5 个公开符号生产源码crates/codegen/xai-grok-workspace/src/file_system/client_fs.rs776 行 · 6 个公开符号生产源码crates/codegen/xai-grok-workspace/src/file_system/codebase_index.rs307 行 · 6 个公开符号生产源码crates/codegen/xai-grok-workspace/src/file_system/content.rs274 行 · 3 个公开符号生产源码crates/codegen/xai-grok-workspace/src/file_system/ext_fs.rs561 行 · 0 个公开符号生产源码crates/codegen/xai-grok-workspace/src/file_system/file_tree.rs527 行 · 3 个公开符号生产源码crates/codegen/xai-grok-workspace/src/file_system/fs.rs144 行 · 12 个公开符号生产源码crates/codegen/xai-grok-workspace/src/file_system/fuzzy.rs480 行 · 12 个公开符号生产源码crates/codegen/xai-grok-workspace/src/file_system/git_status.rs291 行 · 2 个公开符号生产源码crates/codegen/xai-grok-workspace/src/file_system/index.rs1,567 行 · 12 个公开符号生产源码crates/codegen/xai-grok-workspace/src/file_system/jj_status.rs86 行 · 1 个公开符号生产源码crates/codegen/xai-grok-workspace/src/file_system/local_fs.rs51 行 · 2 个公开符号生产源码crates/codegen/xai-grok-workspace/src/file_system/mock_fs.rs59 行 · 2 个公开符号生产源码crates/codegen/xai-grok-workspace/src/file_system/mod.rs361 行 · 12 个公开符号生产源码crates/codegen/xai-grok-workspace/src/file_system/walk.rs345 行 · 12 个公开符号生产源码crates/codegen/xai-grok-workspace/src/folder_trust.rs976 行 · 12 个公开符号生产源码crates/codegen/xai-grok-workspace/src/foreign_sessions/capability/mod.rs309 行 · 12 个公开符号测试crates/codegen/xai-grok-workspace/src/foreign_sessions/capability/tests.rs224 行 · 0 个公开符号生产源码crates/codegen/xai-grok-workspace/src/foreign_sessions/capability/unix.rs241 行 · 5 个公开符号生产源码crates/codegen/xai-grok-workspace/src/foreign_sessions/capability/windows.rs167 行 · 8 个公开符号生产源码crates/codegen/xai-grok-workspace/src/foreign_sessions/claude.rs498 行 · 2 个公开符号生产源码crates/codegen/xai-grok-workspace/src/foreign_sessions/claude/projects.rs56 行 · 5 个公开符号测试crates/codegen/xai-grok-workspace/src/foreign_sessions/claude/tests.rs412 行 · 0 个公开符号测试crates/codegen/xai-grok-workspace/src/foreign_sessions/claude/windows_tests.rs122 行 · 0 个公开符号生产源码crates/codegen/xai-grok-workspace/src/foreign_sessions/codex/db.rs292 行 · 7 个公开符号生产源码crates/codegen/xai-grok-workspace/src/foreign_sessions/codex/files.rs360 行 · 7 个公开符号生产源码crates/codegen/xai-grok-workspace/src/foreign_sessions/codex/mod.rs195 行 · 2 个公开符号测试crates/codegen/xai-grok-workspace/src/foreign_sessions/codex/tests/db.rs898 行 · 0 个公开符号测试crates/codegen/xai-grok-workspace/src/foreign_sessions/codex/tests/files.rs446 行 · 0 个公开符号测试crates/codegen/xai-grok-workspace/src/foreign_sessions/codex/tests/mod.rs118 行 · 0 个公开符号生产源码crates/codegen/xai-grok-workspace/src/foreign_sessions/mod.rs764 行 · 12 个公开符号生产源码crates/codegen/xai-grok-workspace/src/fs_notify.rs366 行 · 7 个公开符号生产源码crates/codegen/xai-grok-workspace/src/handle.rs9,484 行 · 12 个公开符号生产源码crates/codegen/xai-grok-workspace/src/hub_auth.rs491 行 · 1 个公开符号生产源码crates/codegen/xai-grok-workspace/src/hub_channel.rs128 行 · 2 个公开符号生产源码crates/codegen/xai-grok-workspace/src/hub_ids.rs11 行 · 0 个公开符号生产源码crates/codegen/xai-grok-workspace/src/hub_server.rs3,002 行 · 3 个公开符号生产源码crates/codegen/xai-grok-workspace/src/hub.rs1,397 行 · 12 个公开符号生产源码crates/codegen/xai-grok-workspace/src/lib.rs207 行 · 8 个公开符号生产源码crates/codegen/xai-grok-workspace/src/mcp.rs221 行 · 8 个公开符号生产源码crates/codegen/xai-grok-workspace/src/permission/auto_mode.rs2,517 行 · 12 个公开符号生产源码crates/codegen/xai-grok-workspace/src/permission/bash_command_splitting.rs1,250 行 · 12 个公开符号生产源码crates/codegen/xai-grok-workspace/src/permission/claude_settings.rs555 行 · 11 个公开符号生产源码crates/codegen/xai-grok-workspace/src/permission/hub_permission.rs499 行 · 12 个公开符号生产源码crates/codegen/xai-grok-workspace/src/permission/manager.rs5,634 行 · 12 个公开符号生产源码crates/codegen/xai-grok-workspace/src/permission/mod.rs46 行 · 1 个公开符号生产源码crates/codegen/xai-grok-workspace/src/permission/policy.rs879 行 · 5 个公开符号生产源码crates/codegen/xai-grok-workspace/src/permission/prompter.rs1,666 行 · 12 个公开符号生产源码crates/codegen/xai-grok-workspace/src/permission/resolution.rs4,209 行 · 12 个公开符号生产源码crates/codegen/xai-grok-workspace/src/permission/rules.rs303 行 · 12 个公开符号生产源码crates/codegen/xai-grok-workspace/src/permission/shell_access.rs2,013 行 · 6 个公开符号生产源码crates/codegen/xai-grok-workspace/src/permission/state.rs591 行 · 4 个公开符号生产源码crates/codegen/xai-grok-workspace/src/permission/types.rs640 行 · 12 个公开符号生产源码crates/codegen/xai-grok-workspace/src/preview_supervisor.rs1,327 行 · 10 个公开符号生产源码crates/codegen/xai-grok-workspace/src/project_config.rs116 行 · 6 个公开符号生产源码crates/codegen/xai-grok-workspace/src/recovery.rs887 行 · 6 个公开符号生产源码crates/codegen/xai-grok-workspace/src/rpc_envelope.rs230 行 · 3 个公开符号生产源码crates/codegen/xai-grok-workspace/src/session/checkpoint_store.rs726 行 · 7 个公开符号生产源码crates/codegen/xai-grok-workspace/src/session/checkpoint.rs1,050 行 · 12 个公开符号生产源码crates/codegen/xai-grok-workspace/src/session/file_state.rs1,814 行 · 12 个公开符号生产源码crates/codegen/xai-grok-workspace/src/session/git.rs4,154 行 · 12 个公开符号生产源码crates/codegen/xai-grok-workspace/src/session/jj.rs228 行 · 6 个公开符号生产源码crates/codegen/xai-grok-workspace/src/session/mod.rs1,007 行 · 12 个公开符号生产源码crates/codegen/xai-grok-workspace/src/session/swap_policy.rs780 行 · 12 个公开符号生产源码crates/codegen/xai-grok-workspace/src/session/tool_config.rs1,206 行 · 12 个公开符号生产源码crates/codegen/xai-grok-workspace/src/status_config.rs629 行 · 3 个公开符号生产源码crates/codegen/xai-grok-workspace/src/telemetry.rs33 行 · 1 个公开符号生产源码crates/codegen/xai-grok-workspace/src/trust.rs1,564 行 · 12 个公开符号生产源码crates/codegen/xai-grok-workspace/src/upload/environment.rs443 行 · 11 个公开符号生产源码crates/codegen/xai-grok-workspace/src/upload/mod.rs646 行 · 10 个公开符号生产源码crates/codegen/xai-grok-workspace/src/util/mod.rs33 行 · 1 个公开符号生产源码crates/codegen/xai-grok-workspace/src/util/ripgrep.rs52 行 · 1 个公开符号生产源码crates/codegen/xai-grok-workspace/src/workspace_ops.rs2,188 行 · 12 个公开符号生产源码crates/codegen/xai-grok-workspace/src/worktree/mod.rs3,098 行 · 12 个公开符号

覆盖说明

该页面由固定源码基线生成。CI 会重新扫描 crates/codegen/xai-grok-workspace，验证文件数量、行数、公开符号、依赖和入口是否与提交到站点的数据一致。若上游基线升级而图谱没有重新生成，构建会失败，避免页面显示已经不存在的路径。

GBA / 2026

非官方社区学习项目。Grok、xAI 及相关商标归其权利人所有；源码摘录来自 Apache-2.0 许可的公开仓库。
豫ICP备2026029221号-1