Prhub

#50131 [Bugfix] Add missing `vllm/models/kimi_k3/__init__.py`

原始 PR 作者 hmellor 合并时间 2026-07-28 21:47 文件变更 2 提交数 1 评论 0 代码增减 +4 / -0

执行摘要

修复 Kimi K3 子包缺失 __init__.py 导致的问题

PR #50090 新增了 vllm/models/kimi_k3/ 目录,但未添加 __init__.py,使其成为隐式命名空间包。这导致文档构建(mkdocstrings/Griffe)无法解析子模块,并且 setuptools 的 packages.find 无法识别该包,构建的 wheel 中缺少 vllm.models.kimi_k3 及其所有子模块。

可直接合并。建议日后在新增子包时使用 python -m build 验证 wheel 完整性。

讨论亮点

无 review 讨论。该 PR 由两名维护者审批通过,无未解决疑虑。

实现拆解

  1. vllm/models/kimi_k3/ 下新建 __init__.py,仅包含 Apache-2.0 许可的 SPDX 头信息,使该目录成为显式 Python 包。
  2. 修改 vllm/models/kimi_k3/amd/ops/__init__.py,为原本为空的文件添加相同的 SPDX 头。
  3. 该变更仅涉及打包基础设施,不影响运行时模型代码。
文件 模块 状态 重要度
vllm/models/kimi_k3/__init__.py 模型注册 added 6.15
vllm/models/kimi_k3/amd/ops/__init__.py 模型注册 modified 2.99

分析完成后,这里会展示 LLM 生成的相对完整源码片段和详细注释。

评论区精华

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

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

风险与影响

风险极低。仅添加了两行 SPDX 头注释,不改变任何运行时行为。但 PR 未包含测试验证(测试需要 GPU),依赖人工验证。

影响范围:仅影响 Kimi K3 模型的打包和文档生成。用户无感知,但修复了文档构建失败和 wheel 打包缺失的问题。
影响程度:低。

缺少测试覆盖

关联 Issue

未识别关联 Issue

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

完整报告

参与讨论