跳转到内容
GBGrok Build Architecture

xai-grok-sampler

Agent 与推理

xai-grok-sampler

以 actor 形式管理模型采样、HTTP 流、重试、取消和领域事件。

Cargo description: Actor-based sampling/inference layer for xAI grok (HTTP streaming + retry, no shell coupling)

21生产文件
26Rust 文件总数
9,040生产代码行
30收录公开符号

职责与架构位置

xai-grok-sampler 位于“Agent 与推理”层。它的首要职责是：以 actor 形式管理模型采样、HTTP 流、重试、取消和领域事件。。源码图谱把 crate 看成一个编译和所有权边界，而不是文件夹标签：直接依赖表示它可以调用的下层能力，反向依赖表示哪些上层模块把它当作稳定接缝。

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

关键入口

SOURCElib.rscrates/codegen/xai-grok-sampler/src/lib.rs:1–1155 行 · 模块入口SOURCECOST_USD_TICKS_METADATA_KEYcrates/codegen/xai-grok-sampler/src/client.rs:182–1922,746 行 · 公开符号入口SOURCEresponses_event_has_meaningful_contentcrates/codegen/xai-grok-sampler/src/stream/responses.rs:21–311,026 行 · 公开符号入口SOURCECompletionResultcrates/codegen/xai-grok-sampler/src/actor/request_task.rs:40–50862 行 · 公开符号入口SOURCERATE_LIMIT_RETRY_THRESHOLDcrates/codegen/xai-grok-sampler/src/retry.rs:41–51857 行 · 公开符号入口SOURCEstream_chat_completionscrates/codegen/xai-grok-sampler/src/stream/chat_completions.rs:34–44775 行 · 公开符号入口

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

依赖与调用者

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

关键公开符号

类型符号文件与行号
structSamplerActorcrates/codegen/xai-grok-sampler/src/actor/mod.rs:27
fnspawncrates/codegen/xai-grok-sampler/src/actor/mod.rs:42
typeCompletionResultcrates/codegen/xai-grok-sampler/src/actor/request_task.rs:42
fnrun_request_taskcrates/codegen/xai-grok-sampler/src/actor/request_task.rs:77
structActiveRequestcrates/codegen/xai-grok-sampler/src/actor/state.rs:20
structActorStatecrates/codegen/xai-grok-sampler/src/actor/state.rs:25
fnnewcrates/codegen/xai-grok-sampler/src/actor/state.rs:32
fnregistercrates/codegen/xai-grok-sampler/src/actor/state.rs:43
fnremovecrates/codegen/xai-grok-sampler/src/actor/state.rs:54
fncancelcrates/codegen/xai-grok-sampler/src/actor/state.rs:59
fnupdate_configcrates/codegen/xai-grok-sampler/src/actor/state.rs:70
enumSamplingConsumercrates/codegen/xai-grok-sampler/src/attribution.rs:39
fnas_endpointcrates/codegen/xai-grok-sampler/src/attribution.rs:59
constSENT_BEARER_PREFIX_LENcrates/codegen/xai-grok-sampler/src/attribution.rs:82
traitAuth401AttributionCallbackcrates/codegen/xai-grok-sampler/src/attribution.rs:100
typeSharedAttributionCallbackcrates/codegen/xai-grok-sampler/src/attribution.rs:120
constCOST_USD_TICKS_METADATA_KEYcrates/codegen/xai-grok-sampler/src/client.rs:184
structSamplingClientcrates/codegen/xai-grok-sampler/src/client.rs:279
fnuser_agent_string_forcrates/codegen/xai-grok-sampler/src/client.rs:361
fnnewcrates/codegen/xai-grok-sampler/src/client.rs:401
fnapi_backendcrates/codegen/xai-grok-sampler/src/client.rs:545
fnauth_infocrates/codegen/xai-grok-sampler/src/client.rs:658
fnchat_completioncrates/codegen/xai-grok-sampler/src/client.rs:839
fnchat_completion_streamcrates/codegen/xai-grok-sampler/src/client.rs:889
fncreate_responsecrates/codegen/xai-grok-sampler/src/client.rs:1108
fncreate_response_streamcrates/codegen/xai-grok-sampler/src/client.rs:1235
fncreate_messagecrates/codegen/xai-grok-sampler/src/client.rs:1477
fncreate_message_streamcrates/codegen/xai-grok-sampler/src/client.rs:1584
fnconversation_streamcrates/codegen/xai-grok-sampler/src/client.rs:1789
fnconversationcrates/codegen/xai-grok-sampler/src/client.rs:1810

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

关联深度文章

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

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

进程、Actor 与并发模型解释进程边界、actor 邮箱、异步任务、取消和背压如何共同工作。

Agentic Loop追踪 Turn、Sampler、流式事件、工具回路和终止条件。

Sampler Actor、流式事件与重试深入 actor 命令、HTTP 流、重试边界和采样事件转换。

完整 Rust 文件索引

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

生产源码crates/codegen/xai-grok-sampler/src/actor/mod.rs146 行 · 2 个公开符号生产源码crates/codegen/xai-grok-sampler/src/actor/request_task.rs862 行 · 2 个公开符号生产源码crates/codegen/xai-grok-sampler/src/actor/state.rs149 行 · 7 个公开符号生产源码crates/codegen/xai-grok-sampler/src/attribution.rs121 行 · 5 个公开符号生产源码crates/codegen/xai-grok-sampler/src/client.rs2,746 行 · 12 个公开符号生产源码crates/codegen/xai-grok-sampler/src/commands.rs48 行 · 1 个公开符号生产源码crates/codegen/xai-grok-sampler/src/config.rs247 行 · 8 个公开符号生产源码crates/codegen/xai-grok-sampler/src/doom_loop.rs230 行 · 6 个公开符号生产源码crates/codegen/xai-grok-sampler/src/events.rs368 行 · 5 个公开符号生产源码crates/codegen/xai-grok-sampler/src/handle.rs158 行 · 10 个公开符号生产源码crates/codegen/xai-grok-sampler/src/lib.rs55 行 · 0 个公开符号生产源码crates/codegen/xai-grok-sampler/src/metrics.rs247 行 · 4 个公开符号生产源码crates/codegen/xai-grok-sampler/src/retry.rs857 行 · 10 个公开符号生产源码crates/codegen/xai-grok-sampler/src/sampling_log.rs38 行 · 3 个公开符号生产源码crates/codegen/xai-grok-sampler/src/shared_http.rs157 行 · 2 个公开符号生产源码crates/codegen/xai-grok-sampler/src/stream/chat_completions.rs775 行 · 1 个公开符号生产源码crates/codegen/xai-grok-sampler/src/stream/collect.rs183 行 · 1 个公开符号测试crates/codegen/xai-grok-sampler/src/stream/messages_tests.rs656 行 · 0 个公开符号生产源码crates/codegen/xai-grok-sampler/src/stream/messages.rs531 行 · 2 个公开符号生产源码crates/codegen/xai-grok-sampler/src/stream/mod.rs20 行 · 0 个公开符号生产源码crates/codegen/xai-grok-sampler/src/stream/responses.rs1,026 行 · 2 个公开符号生产源码crates/codegen/xai-grok-sampler/src/types.rs76 行 · 3 个公开符号测试crates/codegen/xai-grok-sampler/tests/shared_http_kill_switch.rs30 行 · 0 个公开符号测试crates/codegen/xai-grok-sampler/tests/shared_http_wire.rs83 行 · 0 个公开符号测试crates/codegen/xai-grok-sampler/tests/support/mod.rs33 行 · 2 个公开符号测试crates/codegen/xai-grok-sampler/tests/test_actor.rs952 行 · 0 个公开符号

覆盖说明

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

GBA / 2026

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