# PR #6420 完整报告

- 仓库：`verl-project/verl`
- 标题：Update installation instruction for TransferQueue
- 合并时间：2026-05-21 09:39
- 原文链接：http://prhub.com.cn/verl-project/verl/pull/6420

---

# 执行摘要

- 一句话：更新 TransferQueue 安装指令版本号
- 推荐动作：此 PR 变更简单直接，无需精读。但可作为提醒：依赖安装文档应与实际测试通过的依赖版本保持同步，避免误导用户。

# 功能与动机

Old versions of TransferQueue don't work with the current codebase, as reported in Issue #6407. The PR updates the installation instruction to recommend version 0.1.7, which has been verified to be compatible.

# 实现拆解

在文件 `verl/utils/transferqueue_utils.py` 中，将 `_MockTQ` 类的错误消息中的版本号从 `0.1.6` 改为 `0.1.7`。该错误消息在 `transfer_queue` 未安装时被触发，用于提示用户正确的安装命令。

关键文件：
- `verl/utils/transferqueue_utils.py`（模块 工具模块；类别 source；类型 configuration）: 唯一变更的文件，修改了 TransferQueue 推荐安装版本号。

关键符号：未识别

## 关键源码片段

### `verl/utils/transferqueue_utils.py`

唯一变更的文件，修改了 TransferQueue 推荐安装版本号。

```python
# verl/utils/transferqueue_utils.py 第 56 行
# 当 transfer_queue 未安装时，MockTQ 类返回此错误消息
# 版本号 0.1.7 是当前经过测试的兼容版本
raise RuntimeError(
    f"transfer_queue is not installed. Cannot use tq.{name}(). "
    "Please install it by calling `pip install TransferQueue==0.1.7`"
)

```

# 评论区精华

无显著的 review 讨论。gemini-code-assist[bot] 提交了自动化评论，确认 PR 内容无误；tardis-key 直接批准了 PR。

- 暂无高价值评论线程

# 风险与影响

- 风险：风险极低。仅修改一行错误消息中的版本号，不影响任何运行时逻辑。但需要注意，如果未来再次升级 TransferQueue，必须同步更新此处的版本推荐。
- 影响：影响范围极小，仅影响用户在未安装 TransferQueue 时看到的错误消息。用户将看到正确的安装命令，减少因版本不匹配导致的困惑。
- 风险标记：暂无

# 关联脉络

- PR #6407 关联 Issue 提及旧版本问题 : 该 PR 的动机来自 Issue #6407，报告旧版本 TransferQueue 不工作。
- PR #6354 [trainer,data] fix: Support merging `extra_info` for `main_ppo_sync` & update TQ dependency: PR #6354 引入了 TransferQueue 依赖并升级了版本，本 PR 是对其安装指令的修正。