执行摘要
该 PR 修复了 Ascend 快速启动文档中一处错误指令:删除 export VLLM_ATTENTION_BACKEND=XFORMERS 环境变量设置。该变量仅适用于 NVIDIA 硬件,在 Ascend NPU 上会导致 vLLM 启动失败。这是一个非常轻量的文档修复,不涉及任何代码变更。
功能与动机
用户通过 Issue #6142 报告 Ascend 快速启动文档中存在两个问题:
1) 设置 VLLM_ATTENTION_BACKEND=XFORMERS 环境变量会导致 vLLM 启动失败(报错);
2) 容器默认在根目录执行时也会报错。本次 PR 修复了第一个问题,删除了不兼容的环境变量设置。
实现拆解
- 修改文件
docs/ascend_tutorial/quick_start/ascend_quick_start.rst 第 218-219 行
- 删除
export VLLM_ATTENTION_BACKEND=XFORMERS 以及紧邻的空行(实际删除两行)
- 无其他变更
无复杂源码变更,仅删除一行文档内容。
评论区精华
无有效讨论。审核机器人自动评论说明删除原因,合作者直接批准。
风险与影响
- 风险极低,仅影响文档正确性,不影响任何代码逻辑。
- 影响范围:阅读 Ascend 快速启动文档的用户,修复后用户不会再遇到因该环境变量导致的启动失败。
- 注意:Issue #6142 中提到的在容器根目录执行的问题尚未修复,建议后续跟进。
关联脉络
- 关联 Issue #6142:用户报告 Ascend 快速启动文档的兼容性问题。
- 无其他关联 PR。
参与讨论