工程文章二次筛选报告 · Jay · 2026-07-16 上午场

主题: vLLM 生产部署命令·SGLang 对比·PrefixCache 调优·LLMOps 路线图·AI Agent Stack 六层 筛选标准: 真实环境、命令、错误、源码、性能数据、可复现步骤 覆盖范围: Jarvislabs · SitePoint · Spheron · llm-d.ai · MLMastery · The AI Engineer Substack


一、候选条目筛选结果


🔴 高价值保留条目


条目 1:Jarvislabs — vLLM 优化技术五法(实测数据 + 命令)

  • URLhttps://jarvislabs.ai/blog/vllm-optimization-techniques
  • 来源:Jarvislabs AI Blog
  • 发布时间:2026-07(近期待确认)
  • 可信度:高(自测 benchmark,数据完整,含图表)
  • 核心内容:Qwen3-32B + A100-80GB 实测对比,含三组实验命令和数值

保留理由(工程筛选标准 ✓): - ✅ 真实命令:含 vllm serve 完整参数,含 vllm bench serve benchmark 命令 - ✅ 性能数据:三组实验均含具体数值,非泛泛而谈 - ✅ 可复现步骤:数据集(HuggingFace 下载链接)、硬件配置(Qwen3-32B / A100-80GB)明确

实测数据摘要:

实验 A — FP8 KV-Cache:

vllm serve Qwen/Qwen3-32B \
    --max-model-len 32768 \
    --gpu-memory-utilization 0.9 \
    --kv-cache-dtype fp8   # vs fp16 default
指标 FP16 KV FP8 KV 变化
Output tok/s 785.61 955.22 +22%
Mean TPOT (ms) 155.50 225.07 +45%(更慢)
KV cache 大小 35,792 tokens 71,584 tokens +100%
最大并发 1.09x 2.18x +100%

注意:FP8 KV 带来 2x 缓存容量但 per-token 生成更慢(+45%),适合高并发长上下文场景而非低延迟场景。

实验 B — Prefix Caching:

vllm serve Qwen/Qwen3-32B \
    --enable-prefix-caching \
    --dtype bfloat16
指标 无 Prefix Cache 有 Prefix Cache 变化
Output tok/s 426.89 1,513.23 +254%
Mean TTFT (ms) 4,343.00 969.71 -78%
Mean TPOT (ms) 101.94 112.45 +10%

适合 RAG / agentic / 多轮对话等共享系统前缀的工作负载。

实验 C — CPU Offloading:

vllm serve Qwen/Qwen3-32B \
    --kv-offloading-backend native \
    --kv-offloading-size 8 \
    --disable-hybrid-kv-cache-manager
指标 无 Offloading 有 Offloading 变化
Output tok/s 783.09 825.77 +5.4%
Mean TTFT (ms) 78,994.18 66,508.99 -15.8%
GPU KV Cache 使用率 98.0% 99.65% 接近满载

实验环境: Qwen3-32B / A100-80GB / ShareGPT dataset / max concurrency 500

  • 建议分类LLM-Systems / Inference-Engine / vLLM / Performance
  • 后续行动:对比 SGLang RadixAttention 在相同硬件上的 prefix cache 表现

条目 2:SitePoint — vLLM 生产部署完整指南 2026

  • URLhttps://www.sitepoint.com/vllm-production-deployment-guide-2026
  • 来源:SitePoint(Web 开发技术媒体)
  • 发布时间:2026-06(中期)
  • 可信度:中高(技术媒体,有 Kubernetes/Docker 生产配置)
  • 核心内容:vLLM 生产级部署,含 Kubernetes Deployment YAML、Prometheus 监控配置、Docker Compose 生产栈

保留理由(工程筛选标准 ✓): - ✅ 生产级 Kubernetes YAML:含 topologySpreadConstraints(多 GPU 拓扑感知调度)、runtimeClassName: nvidia、健康检查 - ✅ Prometheus 监控配置:具体 scrape config,含 vLLM 关键指标(vllm:num_requests_runningvllm:num_requests_waitingvllm:gpu_cache_usage_perc) - ✅ Benchmark 命令benchmark_serving.py 完整调用,含示例输出解读

关键 Kubernetes Deployment 片段:

apiVersion: apps/v1
kind: Deployment
metadata:
  name: vllm-inference
  namespace: llm-serving
spec:
  replicas: 2
  topologySpreadConstraints:
  - maxSkew: 1
    topologyKey: kubernetes.io/hostname
    whenUnsatisfiable: DoNotSchedule
  containers:
  - name: vllm
    image: vllm/vllm-openai:<release-tag>
    args: ["--model", "...", "--gpu-memory-utilization", "0.90"]
    # 关键指标:num_requests_waiting 是容量耗尽主指标

vLLM 关键 Prometheus 指标(生产必监):

指标 含义 生产告警阈值建议
vllm:num_requests_waiting 队列深度 > 50 持续 5min
vllm:gpu_cache_usage_perc KV-cache 饱和度 > 95%
vllm:time_to_first_token_seconds TTFT 直方图 P99 > 2s
vllm:e2e_request_latency_seconds 端到端延迟 P99 > 10s

Benchmark 命令示例:

python benchmarks/benchmark_serving.py \
  --backend vllm \
  --endpoint /v1/completions \
  --model llama-3.1-8b \
  --dataset-name sharegpt \
  --num-prompts 500 \
  --request-rate 10 \
  --base-url http://localhost:8000
# 输出示例:
# Throughput: 842.3 tokens/s
# Mean TTFT: 48.2ms | P99 TTFT: 142.7ms
# Mean E2E latency: 1.24s | P99 E2E: 3.87s
  • 建议分类LLM-Systems / Inference-Engine / vLLM / Production
  • 后续行动:结合 Jarvislabs 数据做成本/性能权衡分析;补充 KEDA autoscaling 配置

条目 3:Spheron — vLLM vs SGLang 2026(H100 FP8 实测对比)

  • URLhttps://www.spheron.network/blog/vllm-vs-sglang-2026
  • 来源:Spheron Network Blog
  • 发布时间:2026-07
  • 可信度:中高(GPU 云平台,有明确硬件/软件/测试配置)
  • 核心内容:Llama 3.3 70B / H100 / FP8,vLLM 0.18 vs SGLang 0.5.9,并发 1/10/50/100 实测

保留理由(工程筛选标准 ✓): - ✅ 明确复现步骤:含 GPU 实例申请命令、Docker run 完整命令、benchmark client 说明 - ✅ 关键结论可操作:前缀共享率 > 60% 选 SGLang,否则两者差距 < 5% - ✅ 具体 Docker 命令含端口和参数

部署命令对照:

# vLLM on H100 FP8
docker run --gpus all --ipc=host -p 8000:8000 \
  -e HUGGING_FACE_HUB_TOKEN=your_token \
  vllm/vllm-openai:v0.18.0 \
  --model meta-llama/Llama-3.3-70B-Instruct \
  --quantization fp8 \
  --gpu-memory-utilization 0.92 \
  --max-model-len 8192 \
  --max-num-seqs 256 \
  --enable-prefix-caching  # prefix-heavy 工作负载加此参数

# SGLang on H100 FP8
docker run --gpus all --ipc=host -p 8000:8000 \
  -e HUGGING_FACE_HUB_TOKEN=your_token \
  lmsysorg/sglang:v0.5.9-cu130-runtime \
  python -m sglang.launch_server \
  --model-path meta-llama/Llama-3.3-70B-Instruct \
  --quantization fp8 \
  --context-length 8192 \
  --mem-fraction-static 0.92

判断规则(生产选型): - 前缀共享率 > 60%(RAG、agentic):SGLang,RadixAttention 带来 20-40% TTFT 降低 - 唯一 prompt 高吞吐:两者在 5% 以内,选型看运维熟悉度 - JSON 结构化输出:SGLang 略优(grammar-cache reuse) - RadixAttention cache 命中率:/metrics 端点可见

  • 建议分类LLM-Systems / Inference-Engine / Benchmark / vLLM / SGLang
  • 后续行动:对比 vLLM 0.25 + MRV2 的新数字

条目 4:llm-d.ai — KV-Cache 分布式调度(Precision Prefix-Cache Aware Scheduling)

  • URLhttps://llm-d.ai/blog/kvcache-wins-you-can-see
  • 来源:llm-d.ai Blog(vLLM 分布式调度方向)
  • 发布时间:2026(近期待确认)
  • 可信度:中高(有具体 benchmark 数字和方法论)
  • 核心内容:8 pod × 16 H100 集群,4 种调度策略对比,precise-scheduling 吊打盲调度

保留理由(工程筛选标准 ✓): - ✅ 具体性能数字:4 种调度策略,完整 TTFT/吞吐量/Wait Queue 表格 - ✅ 工程问题明确:标准负载均衡器将相关请求分散到不同 pod,破坏 cache locality - ✅ 量化收益:57x TTFT 改善,2x 吞吐量

Benchmark 结果(8 pod / 16 H100 / 150 租户 / 5 并发用户/租户):

策略 Output tok/s TTFT p90 (s) TTFT mean (s) vLLM Wait Queue mean
precise-scheduling 8,730.0 0.542 0.298 0.1
approximate-scheduling 6,944.4 31.083 13.316 8.1
load-scheduling 4,428.7 94.865 46.987 28.9
random-scheduling 4,428.7 92.551 45.281 27.3

核心洞察: - KV-cache demand = 73% 集群容量,单 pod 无法承载,强制分散 → 精确调度关键 - 盲调度(random/load)在高并发下 TTFT 轻易超过 90s - precise-scheduling 的 vLLM Wait Queue 仅 0.1s(接近零排队)

  • 建议分类LLM-Systems / Inference-Engine / KV-Cache / Distributed
  • 后续行动:了解 llm-d 项目本身是否开源,与 vLLM 官方分布式路线的差异

条目 5:The AI Engineer Substack — AI Agents Stack 2026(六层 + Evals 缺口数据)

  • URLhttps://theaiengineer.substack.com/p/the-ai-agents-stack-2026-edition
  • 来源:The AI Engineer(AI 工程垂直 Substack)
  • 发布时间:2026
  • 可信度:中高(行业工程媒体,有调查数据支撑)
  • 核心内容:AI Agent 六层架构 + 89% vs 52% eval 实施缺口 + 三个新 benchmark

保留理由(工程筛选标准 ✓): - ✅ 行业数据(可引用):LangChain State of Agent Engineering 调查,89% 有 observability,52% 有 evals - ✅ 六层架构分类:对理解 Agent 工程复杂度分层有参考价值 - ✅ 三个新 benchmark 线索:Context-Bench(memory)、Recovery-Bench(error recovery)、Terminal-Bench(coding agents)

关键数据: - Eval gap:89% observability vs 52% evals = 37 个百分点的"盲调"风险 - 三层 Eval 基础设施收敛:PR fast checks / nightly regression (LLM judge) / continuous production monitoring - Agent Stack 六层(2024 年原版为基础,新增三层): 1. Model 2. Routing / Multi-model 3. Tooling / Function Calling 4. Memory / Knowledge(新) 5. Agentic Patterns / Loop Engineering(新) 6. Evaluation(新,已独立成层)

  • 建议分类AI-Engineering / Agent / Evaluation / Stack
  • 后续行动:精读 Context-Bench / Recovery-Bench / Terminal-Bench 论文

条目 6:MLMastery — LLMOps 2026 学习路线图(含两段可运行代码)

  • URLhttps://machinelearningmastery.com/the-roadmap-for-mastering-llmops-in-2026
  • 来源:MachineLearningMastery
  • 发布时间:2026
  • 可信度:中(教育平台,有结构化路线图,含 Phase 1/2 具体步骤)
  • 核心内容:六步 LLMOps 路线图,含 Phase 1 + Phase 2 基础 LLMOps 代码示例

保留理由(工程筛选标准 ✓): - ✅ Phase 1 — Langfuse 接入代码:完整埋点 + 成本面板构建步骤 - ✅ Phase 2 — RAGAS 评估 pipeline:RAG 质量评估具体化 - ⚠️ 降级原因:属于路线图型内容,工程细节密度中等;对比同期 LLMOps 实践文章偏基础

降级保留说明(价值中等): - Phase 1/2 代码示例对 LLMOps 新人有用 - 但生产级 LLMOps(tracing / guardrails / cost control)深度不足 - 适合作为 LLMOps 入门的结构化索引,不适合作为工程实践核心参考

  • 建议分类AI-Engineering / LLMOps / Learning-Resource
  • 后续行动:对比 Puia 或 Arize Phoenix 的生产可观测性方案

🔶 中等价值降级条目(可参考,不归档)


条目 7:McKay Johns Substack — AI Engineering Skills 2026

  • URLhttps://mckayjohns.substack.com/p/top-ai-engineering-skills-for-2026
  • 可信度:中
  • 降级理由:技能清单型内容,核心 foundation 覆盖但缺乏工程深度数据;建议作为路线索引而非核心参考

条目 8:javarevisited Substack — Agentic AI Engineer Roadmap 2026

  • URLhttps://javarevisited.substack.com/p/the-2026-agentic-ai-engineer-roadmap
  • 可信度:中
  • 降级理由:课程推广为主,工程实践内容来自公开课;价值在于 Paul Iusztin 的 LLM Engineer Handbook 配套资源

二、本次新增主题词

  • vLLM-Production-Commands — 部署/监控/调优命令集
  • FP8-KV-Cache — 吞吐/并发换延迟的量化权衡
  • PrefixCache-Distributed — 分布式场景下的 cache locality 问题
  • AI-Agents-Stack-2026 — 六层架构 + eval gap
  • SGLang-vLLM-Production-Selection — 60% 前缀共享率判断规则

三、建议写入路径

条目 建议路径
条目 1(Jarvislabs vLLM 优化) llm-systems/inference-engine/vllm/2026-07-vllm-optimization-commands-benchmarks.md
条目 2(SitePoint vLLM K8s) llm-systems/inference-engine/vllm/2026-07-vllm-kubernetes-production-deploy.md
条目 3(Spheron vLLM vs SGLang) llm-systems/inference-engine/benchmark/2026-07-vllm-vs-sglang-h100-fp8.md
条目 4(llm-d 分布式调度) llm-systems/inference-engine/kv-cache/2026-07-prefix-cache-distributed-scheduling.md
条目 5(AI Agents Stack 2026) ai-engineering/agent/2026-07-ai-agents-stack-six-layers-eval-gap.md
条目 6(LLMOps Roadmap) ai-engineering/llmops/2026-07-llmops-roadmap-phase1-2.md

是否写入文件: 是,本轮写入 /shared/research-kb/inbox/jay/2026-07-16-1050-engineering-filter-vllm-sglang-production-commands-jul2026.md


四、后续精读/审稿建议

优先级 行动 对应条目
🔴 高 对比 Jarvislabs FP8 KV 数据与 vLLM 0.25 release notes 中的 KV 量化改进 条目 1
🔴 高 核实 SGLang 0.5.9 vs vLLM 0.18 benchmark 的官方对照 条目 3
🔴 高 追踪 Context-Bench / Recovery-Bench / Terminal-Bench 原始论文 条目 5
🔶 中 补充 vLLM KEDA autoscaling 配置(基于 num_requests_waiting 指标) 条目 2
🔶 中 llm-d precise-scheduling 开源情况和技术实现细节 条目 4