# PR #47212 完整报告

- 仓库：`vllm-project/vllm`
- 标题：[Misc][Docs] Fix broken protocol link in speech_to_text doc
- 合并时间：2026-07-21 09:05
- 原文链接：http://prhub.com.cn/vllm-project/vllm/pull/47212

---

# PR #47212 分析报告：修复 speech_to_text 文档中损坏的协议链接

## 执行摘要

本 PR 修复了语音转文本（speech-to-text）在线服务文档中一个损坏的外部链接，将协议定义指向已删除旧文件的链接更新为新的正确路径。变更仅涉及一行，零风险，属于常规文档维护。

## 功能与动机

原文档中“完整的参数列表”链接指向 `vllm/entrypoints/openai/protocol.py`，该文件已在代码库中移除。PR 作者发现此死链后，将其改为指向当前有效的 `vllm/entrypoints/speech_to_text/transcription/protocol.py`，确保用户能正常访问协议定义。

## 实现拆解

1. **确定目标文件**：`docs/serving/online_serving/speech_to_text.md`。
2. **替换链接 URL**：将第 70 行附近的链接从旧路径更换为新路径。
3. **提交与合并**：完成后通过 review 获得批准并合并。

### 变更内容体现在以下 Markdown 行中，仅修改了链接目标，其余内容不变。

```markdown
<!-- speech_to_text.md Line 70 -->
For the complete list of supported parameters including sampling parameters and vLLM extensions, 
see the [protocol definitions](https://github.com/vllm-project/vllm/blob/main/vllm/entrypoints/speech_to_text/transcription/protocol.py).

```

## 评论区精华

无实质讨论。仅包含机器人自动回复和 reviewer `noooop` 的批准意见，无争议或技术争论。

## 风险与影响

- **风险**：无。仅编辑文档链接，不影响任何代码或运行时行为。
- **影响**：正向提升文档可用性，修复了一个死链。影响范围极小，仅涉及查阅该文档的用户。

## 关联脉络

无关联的 PR 或 Issue。该 PR 是独立的文档修复，不涉及功能演进。