Prhub

#25153 typo-fix: correct mooncake package name to "mooncake-transfer-engine"

原始 PR 作者 TrafalgarZZZ 合并时间 2026-07-01 02:54 文件变更 2 提交数 1 评论 2 代码增减 +2 / -2

执行摘要

修正 mooncake 包名从 mooncake 改为 mooncake-transfer-engine

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

值得合并。虽然是微小改动,但能避免用户因错误包名导致安装失败,提升开发者体验。

讨论亮点

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

实现拆解

  1. 修改警告信息中的包名:在python/sglang/srt/model_executor/model_runner.pyremote_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 运行器 modified 4.08
python/sglang/srt/mem_cache/storage/mooncake_store/mooncake_store.py 存储层 modified 3.83

关键符号

remote_instance_init_transfer_engine __init__

关键源码片段

python/sglang/srt/model_executor/model_runner.py data-contract

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

# 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 core-logic

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

# 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'." # 包名修正
                    )

评论区精华

没有提炼出高价值讨论线程

当前评论区没有形成足够清晰的争议点或结论,后续有更多讨论时会体现在这里。

风险与影响

无风险。该PR仅修改错误信息中的包名,不影响任何代码逻辑、运行时行为或接口。

影响极小:仅修正了两处用户可见的错误提示信息,帮助用户正确安装依赖。对系统功能、性能、兼容性无任何影响。

关联 Issue

未识别关联 Issue

当前没有检测到明确关联的 Issue 链接,后续同步到相关引用后会出现在这里。

完整报告

参与讨论