xai-file-utils

01

固定源码基线

公开仓库提交 8adf9013

查看快照 ↗

工具与工作区

xai-file-utils

工具与工作区层的一方 crate；上游清单描述为：Local data collection: per-turn event tracking。

Cargo description: Local data collection: per-turn event tracking

13生产文件

15Rust 文件总数

14,651生产代码行

30收录公开符号

职责与架构位置

xai-file-utils 位于“工具与工作区”层。它的首要职责是：工具与工作区层的一方 crate；上游清单描述为：Local data collection: per-turn event tracking。。源码图谱把 crate 看成一个编译和所有权边界，而不是文件夹标签：直接依赖表示它可以调用的下层能力，反向依赖表示哪些上层模块把它当作稳定接缝。

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

关键入口

SOURCEwith_auth_retrycrates/codegen/xai-file-utils/src/lib.rs:10–2061 行 · 公开符号入口↗SOURCETraceExportSourcecrates/codegen/xai-file-utils/src/queue.rs:41–516,434 行 · 公开符号入口↗SOURCEAuth401AttributionCallbackcrates/codegen/xai-file-utils/src/storage_client.rs:60–703,463 行 · 公开符号入口↗SOURCEbuild_s3_clientcrates/codegen/xai-file-utils/src/s3.rs:97–1071,541 行 · 公开符号入口↗SOURCEMULTIPART_UPLOAD_THRESHOLDcrates/codegen/xai-file-utils/src/gcs.rs:19–29894 行 · 公开符号入口↗SOURCEEVENT_SCHEMA_VERSIONcrates/codegen/xai-file-utils/src/events/types.rs:2–12856 行 · 公开符号入口↗

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

依赖与调用者

直接依赖

xai-circuit-breakerxai-grok-authxai-grok-versionxai-test-utils

直接调用者

xai-grok-mcpxai-grok-pagerxai-grok-shellxai-grok-shell-session-supportxai-grok-telemetryxai-grok-toolsxai-grok-workspace

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

关键公开符号

类型	符号	文件与行号
struct	TracingObserver	crates/codegen/xai-file-utils/src/circuit_breaker_observer.rs:23
fn	new	crates/codegen/xai-file-utils/src/circuit_breaker_observer.rs:28
struct	EventWriter	crates/codegen/xai-file-utils/src/events/log.rs:23
fn	open	crates/codegen/xai-file-utils/src/events/log.rs:33
fn	noop	crates/codegen/xai-file-utils/src/events/log.rs:53
fn	emit	crates/codegen/xai-file-utils/src/events/log.rs:62
struct	EventTracker	crates/codegen/xai-file-utils/src/events/tracker.rs:10
fn	new	crates/codegen/xai-file-utils/src/events/tracker.rs:60
fn	writer	crates/codegen/xai-file-utils/src/events/tracker.rs:73
fn	emit	crates/codegen/xai-file-utils/src/events/tracker.rs:77
fn	begin_turn	crates/codegen/xai-file-utils/src/events/tracker.rs:82
fn	emit_turn_ended	crates/codegen/xai-file-utils/src/events/tracker.rs:88
fn	tool_started	crates/codegen/xai-file-utils/src/events/tracker.rs:105
fn	tool_count_this_turn	crates/codegen/xai-file-utils/src/events/tracker.rs:112
fn	has_active_tool	crates/codegen/xai-file-utils/src/events/tracker.rs:116
fn	tool_finished	crates/codegen/xai-file-utils/src/events/tracker.rs:120
fn	cancel_active_tool	crates/codegen/xai-file-utils/src/events/tracker.rs:126
fn	set_prior_interrupt_category	crates/codegen/xai-file-utils/src/events/tracker.rs:139
fn	take_prior_interrupt_category	crates/codegen/xai-file-utils/src/events/tracker.rs:144
fn	set_prior_redirect_kind	crates/codegen/xai-file-utils/src/events/tracker.rs:151
fn	take_prior_redirect_kind	crates/codegen/xai-file-utils/src/events/tracker.rs:156
fn	set_pending_interrupt_reminder	crates/codegen/xai-file-utils/src/events/tracker.rs:163
fn	take_pending_interrupt_reminder	crates/codegen/xai-file-utils/src/events/tracker.rs:168
fn	permission_requested	crates/codegen/xai-file-utils/src/events/tracker.rs:174
fn	permission_resolved	crates/codegen/xai-file-utils/src/events/tracker.rs:184
const	EVENT_SCHEMA_VERSION	crates/codegen/xai-file-utils/src/events/types.rs:4
enum	Event	crates/codegen/xai-file-utils/src/events/types.rs:13
enum	InterjectionSource	crates/codegen/xai-file-utils/src/events/types.rs:464
enum	RedirectKind	crates/codegen/xai-file-utils/src/events/types.rs:479
enum	McpErrorCategory	crates/codegen/xai-file-utils/src/events/types.rs:493

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

关联深度文章

文件、搜索与编辑工具追踪文件读取、代码搜索、补丁应用和 hunk 归因。

完整 Rust 文件索引

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

测试crates/codegen/xai-file-utils/src/circuit_breaker_observer_tests.rs281 行 · 0 个公开符号生产源码crates/codegen/xai-file-utils/src/circuit_breaker_observer.rs87 行 · 2 个公开符号生产源码crates/codegen/xai-file-utils/src/events/log.rs180 行 · 4 个公开符号生产源码crates/codegen/xai-file-utils/src/events/mod.rs13 行 · 0 个公开符号生产源码crates/codegen/xai-file-utils/src/events/tracker.rs262 行 · 12 个公开符号生产源码crates/codegen/xai-file-utils/src/events/types.rs856 行 · 12 个公开符号生产源码crates/codegen/xai-file-utils/src/gcs.rs894 行 · 7 个公开符号生产源码crates/codegen/xai-file-utils/src/lib.rs61 行 · 3 个公开符号生产源码crates/codegen/xai-file-utils/src/queue.rs6,434 行 · 12 个公开符号生产源码crates/codegen/xai-file-utils/src/s3.rs1,541 行 · 12 个公开符号测试crates/codegen/xai-file-utils/src/storage_client_breaker_tests.rs428 行 · 0 个公开符号生产源码crates/codegen/xai-file-utils/src/storage_client.rs3,463 行 · 12 个公开符号生产源码crates/codegen/xai-file-utils/src/trace_context.rs317 行 · 6 个公开符号生产源码crates/codegen/xai-file-utils/src/upload_config.rs167 行 · 12 个公开符号生产源码crates/codegen/xai-file-utils/src/workspace_classifier.rs376 行 · 1 个公开符号

覆盖说明

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