# PR #25153 完整报告

- 仓库：`sgl-project/sglang`
- 标题：typo-fix: correct mooncake package name to "mooncake-transfer-engine"
- 合并时间：2026-07-01 02:54
- 原文链接：http://prhub.com.cn/sgl-project/sglang/pull/25153

---

# 执行摘要

- 一句话：修正 mooncake 包名从 mooncake 改为 mooncake-transfer-engine
- 推荐动作：值得合并。虽然是微小改动，但能避免用户因错误包名导致安装失败，提升开发者体验。

# 功能与动机

PR 正文指出：'pip install mooncake' 会安装错误的 Python 包，正确的包名应为 'mooncake-transfer-engine'。修正后用户能正确安装 mooncake 传输引擎。

# 实现拆解

1. **修改警告信息中的包名**：在 `python/sglang/srt/model_executor/model_runner.py` 的 `remote_instance_init_transfer_engine` 方法中，将 `logger.warning` 消息中的 `mooncake` 改为 `mooncake-transfer-engine`。
2. **修改错误提示中的包名**：在 `python/sglang/srt/mem_cache/storage/mooncake_store/mooncake_store.py` 的 `__init__` 方法中，将 `RuntimeError` 消息中的 `mooncake` 改为 `mooncake-transfer-engine`。
3. 两处修改均为单行文本替换，没有逻辑变更。

关键文件：
- `python/sglang/srt/model_executor/model_runner.py`（模块 运行器；类别 source；类型 data-contract）: 修改了 `remote_instance_init_transfer_engine` 方法中的警告信息包名，是用户首次接触 mooncake 安装提示的关键位置。
- `python/sglang/srt/mem_cache/storage/mooncake_store/mooncake_store.py`（模块 存储层；类别 source；类型 core-logic）: 修改了 `MooncakeStore.__init__` 中 RuntimeError 的升级命令包名，确保用户能通过正确的包名升级。

关键符号：remote_instance_init_transfer_engine, __init__

## 关键源码片段

### `python/sglang/srt/model_executor/model_runner.py`

修改了 `remote_instance_init_transfer_engine` 方法中的警告信息包名，是用户首次接触 mooncake 安装提示的关键位置。

```python
# python/sglang/srt/model_executor/model_runner.py
# 修正后的警告信息，指导用户安装正确的 mooncake 传输引擎包
    def remote_instance_init_transfer_engine(self):
        try:
            from mooncake.engine import TransferEngine
        except ImportError as e:
            logger.warning(
                "Please install mooncake for using remote instance transfer engine: "
                "pip install mooncake-transfer-engine"  # 包名修正为 mooncake-transfer-engine
            )
            return
        self.remote_instance_transfer_engine = TransferEngine()

```

### `python/sglang/srt/mem_cache/storage/mooncake_store/mooncake_store.py`

修改了 `MooncakeStore.__init__` 中 RuntimeError 的升级命令包名，确保用户能通过正确的包名升级。

```python
# python/sglang/srt/mem_cache/storage/mooncake_store/mooncake_store.py
# 修正后的错误提示，指导用户升级正确的 mooncake 包
            if self.config.standalone_storage:
                if not isinstance(mem_pool.allocator, MooncakeHostTensorAllocator):
                    raise RuntimeError(
                        "MooncakeStore with standalone_storage=True requires "
                        "MooncakeHostTensorAllocator. Please set standalone_storage=False "
                        "or upgrade Mooncake by 'pip install mooncake-transfer-engine --upgrade'."  # 包名修正
                    )

```

# 评论区精华

无实际 review 讨论，gemini-code-assist bot 给出了无意见的评论，stmatengss 和 xiezhq-hermann 直接批准。

- 暂无高价值评论线程

# 风险与影响

- 风险：无风险。该 PR 仅修改错误信息中的包名，不影响任何代码逻辑、运行时行为或接口。
- 影响：影响极小：仅修正了两处用户可见的错误提示信息，帮助用户正确安装依赖。对系统功能、性能、兼容性无任何影响。
- 风险标记：暂无

# 关联脉络

- 暂无明显关联 PR