执行摘要

• 一句话：为 Apple Silicon 添加 vLLM-Metal GPU 文档
• 推荐动作：此 PR 是用户体验文档改进，值得了解以在文档中推广新平台。对于关注非 NVIDIA 平台支持的读者可精读；否则只作参考。

功能与动机

PR body 指出 Mac 用户寻找 GPU 加速时只在 CPU 页面看到 vLLM-Metal，而在 GPU 页或快速入门页找不到，造成困惑。本次变更旨在填补这一空白。

实现拆解

1. 新建 docs/getting_started/installation/gpu.apple.inc.md，包含适用于 Apple Silicon 的安装、使用说明和注意事项，强调使用 mlx-community 模型。
2. 修改 docs/getting_started/installation/gpu.md，在 GPU 安装页面中为每一节（installation、requirements、setup 等）添加“Apple Silicon”选项卡，引用新建的文档片段。
3. 修改 docs/getting_started/quickstart.md，在平台选择中加入“Apple Silicon (Mac)”部分，提供链接和注意事项。
4. 修改 docs/getting_started/installation/README.md，在硬件平台列表中加入 Apple Silicon，并指向 GPU 页。

关键文件：

• docs/getting_started/installation/gpu.apple.inc.md（模块 文档；类别 docs；类型 documentation）: 新增文档片段，包含完整的 Apple Silicon 安装和使用说明，是本次变更的核心内容。
• docs/getting_started/installation/gpu.md（模块 文档；类别 docs；类型 documentation）: 在 GPU 安装页面各处插入 Apple Silicon 选项卡，引用新文档片段，是可见性提升的关键入口。
• docs/getting_started/quickstart.md（模块 文档；类别 docs；类型 documentation）: 在快速入门指南中增加 Apple Silicon 平台选项，让新用户首次使用即可看到 macOS 方案。
• docs/getting_started/installation/README.md（模块 文档；类别 docs；类型 documentation）: 在安装概览的硬件平台列表中加入 Apple Silicon，为从首页跳转的用户提供入口。

关键符号：未识别

评论区精华

• gemini-code-assist[bot] 提出三条建议：①强调 MLX 模型是必需的而不是仅兼容；②安装命令不要直接 pipe to bash；③Apple Silicon 选项卡标题应加上“(macOS)”以缓解与全局 Linux 要求的矛盾。三条建议均未被采纳或回复，PR 维持原状。

• aarnphm 评论“长期应让 pip install vllm 在 CPU 上可用，再 pip install vllm-metal”，ericcurtin 指出阻碍是缺少发布的 macOS wheel。这指向了未来的包装改进方向。

• MLX 模型措辞”works with” vs “requires” (documentation): 未采纳，文档保留原措辞。

• 安装命令安全风险 (security): 不适用；实际无安全风险。
• Apple Silicon 选项卡标题与全局 OS 要求矛盾 (documentation): 未采纳；全局 OS:Linux 是 NVIDIA/AMD/Intel 的先决条件，Apple Silicon 选项卡的出现间接说明 macOS，但未修改。
• 长期包装方向：pip 直接安装 vllm-metal (design): 方向性讨论，未纳入本次 PR。

风险与影响

• 风险：纯文档变更，无代码修改风险。可能存在文档与实际安装流程不一致的问题（如引用 vLLM-Metal 仓库的安装方式可能变化），但本质是外部链接，风险低。
• 影响：对 Mac 用户友好性提升，明确 GPU 加速安装路径。对现有系统无影响。团队需额外维护一份文档片段，但随主站更新即可。
• 风险标记：暂无

关联脉络

• 暂无明显关联 PR