xai-grok-shell-base

01

固定源码基线

公开仓库提交 8adf9013

查看快照 ↗

安全、扩展与运维

xai-grok-shell-base

封装 Shell 家族共享的环境、进程、文件系统和 profiling 基础能力。

Cargo description: Foundation modules for the grok shell crate family: environment presets, CPU profiling, and process/filesystem utilities.

10生产文件

10Rust 文件总数

2,674生产代码行

30收录公开符号

职责与架构位置

xai-grok-shell-base 位于“安全、扩展与运维”层。它的首要职责是：封装 Shell 家族共享的环境、进程、文件系统和 profiling 基础能力。。源码图谱把 crate 看成一个编译和所有权边界，而不是文件夹标签：直接依赖表示它可以调用的下层能力，反向依赖表示哪些上层模块把它当作稳定接缝。

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

关键入口

SOURCElib.rscrates/codegen/xai-grok-shell-base/src/lib.rs:1–88 行 · 模块入口↗SOURCEProfileArtifactFormatcrates/codegen/xai-grok-shell-base/src/cpu_profile.rs:20–301,172 行 · 公开符号入口↗SOURCEChangelogEntrycrates/codegen/xai-grok-shell-base/src/util/changelog.rs:26–36360 行 · 公开符号入口↗SOURCErandom_f64crates/codegen/xai-grok-shell-base/src/util/mod.rs:24–34304 行 · 公开符号入口↗SOURCEwrite_secure_filecrates/codegen/xai-grok-shell-base/src/util/secure_file.rs:48–58232 行 · 公开符号入口↗SOURCEgenerate_event_idcrates/codegen/xai-grok-shell-base/src/util/event_id.rs:22–32181 行 · 公开符号入口↗

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

依赖与调用者

直接依赖

xai-grok-configxai-grok-envxai-grok-sharedxai-grok-versionxai-tty-utils

直接调用者

xai-grok-shellxai-grok-shell-session-support

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

关键公开符号

类型	符号	文件与行号
enum	ProfileArtifactFormat	crates/codegen/xai-grok-shell-base/src/cpu_profile.rs:22
enum	ControlErrorCode	crates/codegen/xai-grok-shell-base/src/cpu_profile.rs:33
struct	ControlError	crates/codegen/xai-grok-shell-base/src/cpu_profile.rs:62
struct	CpuProfileStartOptions	crates/codegen/xai-grok-shell-base/src/cpu_profile.rs:92
enum	CpuProfileStatus	crates/codegen/xai-grok-shell-base/src/cpu_profile.rs:108
struct	CpuProfileStopResult	crates/codegen/xai-grok-shell-base/src/cpu_profile.rs:123
trait	ProfilerEngine	crates/codegen/xai-grok-shell-base/src/cpu_profile.rs:129
enum	ShutdownStopDisposition	crates/codegen/xai-grok-shell-base/src/cpu_profile.rs:154
struct	CpuProfileStopHandle	crates/codegen/xai-grok-shell-base/src/cpu_profile.rs:160
fn	finish	crates/codegen/xai-grok-shell-base/src/cpu_profile.rs:165
struct	CpuProfileManager	crates/codegen/xai-grok-shell-base/src/cpu_profile.rs:178
fn	new	crates/codegen/xai-grok-shell-base/src/cpu_profile.rs:203
fn	force_unsupported_for_test	crates/codegen/xai-grok-shell-base/src/cpu_profile.rs:208
fn	profiling_compiled_in	crates/codegen/xai-grok-shell-base/src/cpu_profile.rs:212
fn	runtime_cpu_profile	crates/codegen/xai-grok-shell-base/src/cpu_profile.rs:219
fn	profile_formats	crates/codegen/xai-grok-shell-base/src/cpu_profile.rs:226
fn	start	crates/codegen/xai-grok-shell-base/src/cpu_profile.rs:233
fn	stop	crates/codegen/xai-grok-shell-base/src/cpu_profile.rs:277
fn	take_stop_handle	crates/codegen/xai-grok-shell-base/src/cpu_profile.rs:284
fn	complete_stop	crates/codegen/xai-grok-shell-base/src/cpu_profile.rs:309
fn	subscribe_stop_completion	crates/codegen/xai-grok-shell-base/src/cpu_profile.rs:314
fn	status	crates/codegen/xai-grok-shell-base/src/cpu_profile.rs:318
fn	finalize_on_shutdown	crates/codegen/xai-grok-shell-base/src/cpu_profile.rs:345
fn	take_shutdown_stop_handle	crates/codegen/xai-grok-shell-base/src/cpu_profile.rs:357
fn	shutdown_stop_disposition	crates/codegen/xai-grok-shell-base/src/cpu_profile.rs:371
fn	start_with_engine_for_test	crates/codegen/xai-grok-shell-base/src/cpu_profile.rs:523
fn	profiling_compiled_in	crates/codegen/xai-grok-shell-base/src/cpu_profile.rs:650
fn	runtime_cpu_profile_supported	crates/codegen/xai-grok-shell-base/src/cpu_profile.rs:654
fn	profile_formats	crates/codegen/xai-grok-shell-base/src/cpu_profile.rs:658
fn	start_profiler	crates/codegen/xai-grok-shell-base/src/cpu_profile.rs:667

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

关联深度文章

Shell、Process、PTY 与后台命令解释命令构造、进程组、PTY 会话、输出流和后台生命周期。

Shared Foundations：配置、环境、路径与 Shell Base解释 leaf types、共享工具和依赖倒置如何稳定上层 crate。

完整 Rust 文件索引

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

生产源码crates/codegen/xai-grok-shell-base/src/cpu_profile.rs1,172 行 · 12 个公开符号生产源码crates/codegen/xai-grok-shell-base/src/env.rs101 行 · 4 个公开符号生产源码crates/codegen/xai-grok-shell-base/src/lib.rs8 行 · 0 个公开符号生产源码crates/codegen/xai-grok-shell-base/src/util/changelog.rs360 行 · 6 个公开符号生产源码crates/codegen/xai-grok-shell-base/src/util/event_id.rs181 行 · 3 个公开符号生产源码crates/codegen/xai-grok-shell-base/src/util/grok_home.rs6 行 · 0 个公开符号生产源码crates/codegen/xai-grok-shell-base/src/util/mod.rs304 行 · 9 个公开符号生产源码crates/codegen/xai-grok-shell-base/src/util/secure_file.rs232 行 · 3 个公开符号生产源码crates/codegen/xai-grok-shell-base/src/util/tips.rs153 行 · 1 个公开符号生产源码crates/codegen/xai-grok-shell-base/src/util/uname.rs157 行 · 1 个公开符号

覆盖说明

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