# PR #30405 完整报告

- 仓库：`sgl-project/sglang`
- 标题：docs(nixl): document OBJ throughput target
- 合并时间：2026-08-14 04:04
- 原文链接：http://prhub.com.cn/sgl-project/sglang/pull/30405

---

## 执行摘要

本 PR 是纯文档变更，为 NIXL OBJ 存储后端补充了 S3 CRT 客户端的两个配置键（`crtMinLimit` 和 `throughput_target_gbps`）的说明、示例与使用建议。未改动任何代码、测试或运行时行为，影响范围仅限于文档阅读者。

## 功能与动机

PR body 明确说明这是纯文档更新（"Doc only. Describe recent changes in the NIXL OBJ store backend."），动机是让用户了解 NIXL OBJ 后端近期的行为变化，即如何通过 CRT 客户端提升大对象传输的吞吐。同时指出代码层面无需改动，因为 hicache 的 NIXL 后端已能直接将整个配置字典透传给 NIXL。

## 实现拆解

1. **更新 README.md**：
 - 在对象存储后端的描述段落中增加了指向 [NIXL OBJ 插件文档 ](https://github.com/ai-dynamo/nixl/blob/main/src/plugins/obj/README.md) 的链接。
 - 在配置键表格里新增 `crtMinLimit`（整数，默认禁用）和 `throughput_target_gbps`（整数，默认 10）两列。
 - 新增解释段落，说明这两个键的作用范围、5 MiB 的 AWS S3 最小分片限制，以及 `SGLANG_AUTO_NUMA_BIND=false` 对 CRT 线程池的影响。
 - 提供了一段内联配置示例，使用 `--hicache-storage-backend-extra-config` 启用 CRT 路径并设置 25 Gbps 吞吐目标。

2. **更新 nixl.config.toml.sample**：
 - 在示例 TOML 中添加了两个新键，各带注释说明默认值和生效条件，便于用户复制使用。

3. **无代码、测试或 CI 改动**：
 - 符合 PR 的文档定位，也无需配置迁移或部署配合。

### 本次变更不涉及任何源码逻辑修改，因此没有可展示的源码片段。所有变更均为 Markdown 文档和 TOML 示例配置。

## 评论区精华

该 PR 没有技术性 review 讨论。唯一一条评论来自 `gemini-code-assist[bot]`，内容为每日配额用尽的警告，与变更内容无关。

## 风险与影响

- **风险**：文档与示例配置可能让用户混淆示例值（25）与默认值（10），或误以为 `crtMinLimit` 默认即启用。另外，`SGLANG_AUTO_NUMA_BIND=false` 的建议未附带副作用说明，可能影响其他 NUMA 相关的行为。
- **影响**：仅影响使用 NIXL OBJ 后端的用户对配置的理解，对系统运行无任何影响。团队维护成本极低。

## 关联脉络

该 PR 与历史 PR 没有直接的代码关联。从功能演进角度看，它补全了 NIXL OBJ 后端的配置文档，是先前 NIXL 存储后端相关功能（如 hicache 集成、PD 使用 NIXL）的文档收尾工作，后续若有更多 CRT 参数变化，可能在此基础上继续补充。