Skip to content

Commit 4e65a94

Browse files
chore: EN 번역 자동 업데이트 [skip-notion]
1 parent 1470005 commit 4e65a94

11 files changed

Lines changed: 1263 additions & 633 deletions

.notion-translate-hashes.json

Lines changed: 39 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -132,7 +132,7 @@
132132
"body_hash": "a376a0ff559597d76dbdc1e771fb5c0834fe2d42745c72a953997ea21ac9f035",
133133
"slug": "1",
134134
"sidebar_position": "1",
135-
"frontmatter_hash": "95beb651a61af6b790d11a702e74a15ca4587e8e19a3c628eac1c209893cca64"
135+
"frontmatter_hash": "7d15df42e55fd30e99c39ef9dbee05b3aa440400848c63ebd3c1a0442acc5e5b"
136136
},
137137
"docs/poc/audio-bench/poc-기획안-초고속초고품질-다국어-ai-자막-생성-시스템-구축.md": {
138138
"body_hash": "2f280704931a7250492869c09f1b53bdb73e26fb23c193558933098f4e40d7da",
@@ -153,10 +153,10 @@
153153
"frontmatter_hash": "007727c458d7f9d57b9c5314565fdd592a8e86a292ddaabd6f52b9ee1ec3b18f"
154154
},
155155
"docs/poc/vision-bench/2편-추론-파라미터-튜닝-qwen3-omni-6초-클립-분석-ofat-스윕.md": {
156-
"body_hash": "130babd1d227d3dd415989b016818f5ecb2a24bb89b384d7b73bdf3e799cf961",
156+
"body_hash": "de95fa85f7517cd86480b5279875065cf31291c30f135a1bc1ab62738169bb1a",
157157
"slug": "3",
158158
"sidebar_position": "3",
159-
"frontmatter_hash": "f57c584b76050d63f0fd73bef082bec5f1f13933b8607bf226812836416b827a"
159+
"frontmatter_hash": "bd91f34677ec986b1dbcf42afb33a3f0f38ba6cb21973e32edc51d31dcc06fa1"
160160
},
161161
"docs/guide/scenemakerai-문서.md": {
162162
"body_hash": "78fecbe8088c45ab98f1e36c1bb7bb6863019a7892a590101a1031398b55d0b0",
@@ -177,16 +177,16 @@
177177
"frontmatter_hash": "2901b66edcdaa817b613633ac6e2f5135b1bede77dc021295d65b46eb6ad7e9a"
178178
},
179179
"docs/install/qwen-3x-설치.md": {
180-
"body_hash": "25b9a227898cd3307898e444d568928dcaa3f887d76ce06bb2e1ba013fa206d8",
180+
"body_hash": "ae0f4ade3a7372c2eeeee5d86a94fb99c66986ec27e0ee8623e385c2de5bc592",
181181
"slug": "1",
182182
"sidebar_position": "1",
183-
"frontmatter_hash": "a4a3ace3819ae0f6cd04d8c8e81e790f410d5da23da7c88394840199ff5d40c9"
183+
"frontmatter_hash": "5595effad4c9df3ef2f6a34180399cf9a7bd5b260b16a86bfeb1eba53bf469e1"
184184
},
185185
"docs/install/ffmpeg-gpunvencnvdec-설치-절차서.md": {
186-
"body_hash": "92e979cf6f10dd8a4b5798f3675bda57fff7ac8bb5aa89f90d503af17e5dcac2",
186+
"body_hash": "fe34b62f51b5ab0a56c8883ecf5a41ba54e270584661eeddc0f97bd11b5e4567",
187187
"slug": "2",
188188
"sidebar_position": "2",
189-
"frontmatter_hash": "c07d044af0d99e4c656a4ab55afc5721f234aded452f1db505c3f0d54ca6daea"
189+
"frontmatter_hash": "134dffd9a7364434a0a299b2b30f4c3fc7132ed36bb84c65e4c02bbc2b1a5775"
190190
},
191191
"docs/install/제목없음.md": {
192192
"body_hash": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
@@ -219,9 +219,39 @@
219219
"frontmatter_hash": "e408bdeed7b790240044d4398030d8d1b7c88b0020bb2976c24e032f934685a2"
220220
},
221221
"docs/install/milvus-설치-aws-linux-docker-compose.md": {
222-
"body_hash": "4d6b14b5c292015bc99f3d6967a95603ea6a2d5069559f2952ea38cfc0e2d1f9",
222+
"body_hash": "efa98c1b3f692c063c0ff1af167d208219af19019b1a2d17bb183ab226ae546b",
223223
"slug": "3",
224224
"sidebar_position": "3",
225-
"frontmatter_hash": "e408bdeed7b790240044d4398030d8d1b7c88b0020bb2976c24e032f934685a2"
225+
"frontmatter_hash": "3e34968cc7f068e7db847f0982c942de73b1578136e1e0b1d8b6bb919fc45368"
226+
},
227+
"docs/contribute/ci빌드-test-cli-argspy에서-잘못된-cli-인자-유효성-검사-테스트를-수정.md": {
228+
"body_hash": "fe69133f1ae3a605070d2a13974d084e53fa9147e3a8effb301c666c91bee1c3",
229+
"slug": "3",
230+
"sidebar_position": "3",
231+
"frontmatter_hash": "2ca0bb80c002d6e4ef00902acfcc86195a03b81998616065061f777e1e878e4d"
232+
},
233+
"docs/contribute/ci빌드-v1completions-엔드포인트에서-bad-words를-지원.md": {
234+
"body_hash": "9ccd6e68baa3072671c27596d0667a7054d1b50958e7a2ba3a0cb41ed979f32a",
235+
"slug": "4",
236+
"sidebar_position": "4",
237+
"frontmatter_hash": "d8b03fb75d28a2e3b51b122ab7cb6cb6088a72d5ee1a36213ebc5e258a0857d1"
238+
},
239+
"docs/contribute/툴-파서-역슬래시-이스케이프-예외처리-수정.md": {
240+
"body_hash": "babdf303a40b178812c4dca33531f3ccba5817e6d057c70e1c76c18baa4a8eb6",
241+
"slug": "2",
242+
"sidebar_position": "2",
243+
"frontmatter_hash": "4adac2e2269ded5ff1f5a75d6f01708ce085925b5f08029b94d893a3baad6b36"
244+
},
245+
"docs/poc/vision-bench/1편-멀티모달-llm-한국-방송-6초-클립-영상-이해-벤치마크파이프라인-구축.md": {
246+
"body_hash": "6873f38cc9e3d56537b3fdb1b967f3476f4b972bef160bf3010b6266a5915971",
247+
"slug": "1",
248+
"sidebar_position": "1",
249+
"frontmatter_hash": "ccf784fa07f1d815f7f8fc1a5fab4273f342f828a0aa6d09a4ce0b0cacf190a6"
250+
},
251+
"docs/poc/vision-bench/3편-추론-파라미터-조합-qwen3-omni-6초-클립-분석-최적-구성-확정.md": {
252+
"body_hash": "1a6db84d0445191f35add470fdcd1e8eded88512642cf5c9ed325acb3410fa21",
253+
"slug": "4",
254+
"sidebar_position": "4",
255+
"frontmatter_hash": "b51d662bd6aaf51b52862020a4abc4ea5dd0eaad0199b254ccb275820b18eb6f"
226256
}
227257
}
Lines changed: 39 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,39 @@
1+
---
2+
title: "[CI/Build] Fixed a test for invalid CLI argument validation in test_cli_args.py"
3+
sidebar_position: 3
4+
slug: "3"
5+
tags: [PR]
6+
keywords: [PR]
7+
last_update:
8+
date: 2026-06-26
9+
---
10+
11+
[https://github.com/vllm-project/vllm/pull/46779](https://github.com/vllm-project/vllm/pull/46779)
12+
13+
### **Purpose**
14+
15+
In two tests, `tests/entrypoints/openai/test_cli_args.py` presented incorrect contract information, leading to a false sense of certainty.
16+
17+
It claimed that when combined1 with `test_enable_auto_choice_fails_with_enable_reasoning-enable-auto-tool-choice`, `-reasoning-parser` should fail. However, this combination is **documented as supported** (e.g., ) and **does not** fail correctly. The test passed because was omitted, which triggered the irrelevant check “Automatic tool selection requires a tool-call parser,” obscuring the fact that an inference conflict validation does not exist (and should not exist). I rewrote the code to ensure that documented combinations pass when the tool call parser is enabled.`docs/features/tool_calling.md-tool-call-parser hunyuan_a13b --reasoning-parser hunyuan_a13bvalidate_parsed_serve_args-tool-call-parser`
18+
2. `test_enable_auto_choice_passes_without_tool_call_parser` was misnamed. The function’s docstring and body explicitly state that the validation *fails*. `test_enable_auto_choice_fails_without_tool_call_parser` I renamed it to match the actual behavior.
19+
20+
This is a test-only change; runtime behavior remains unchanged.
21+
22+
**This is not a duplicate.** I searched for public PRs regarding `test_cli_args`, `validate_parsed_serve_args`, and `test_enable_auto_choice`, but none of them touched this test.
23+
24+
### **Test Plan**
25+
26+
```text
27+
python -m pytest tests/entrypoints/openai/test_cli_args.py -v
28+
# lint
29+
ruff check tests/entrypoints/openai/test_cli_args.py
30+
ruff format --check tests/entrypoints/openai/test_cli_args.py
31+
```
32+
33+
### **Test Results**
34+
35+
```text
36+
28 passed in 5.48s
37+
ruff: All checks passed! / 1 file already formatted
38+
```
39+
Lines changed: 52 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,52 @@
1+
---
2+
title: "[CI/Build] Support for `bad_words` at the `/v1/completions` endpoint"
3+
sidebar_position: 4
4+
slug: "4"
5+
tags: [PR]
6+
keywords: [PR]
7+
last_update:
8+
date: 2026-06-26
9+
---
10+
11+
12+
[https://github.com/vllm-project/vllm/pull/46793](https://github.com/vllm-project/vllm/pull/46793)
13+
14+
### **Purpose**
15+
16+
The chat autocomplete endpoint ( `/v1/chat/completions` ) exposes the `bad_words` field and passes it to `SamplingParams`, but the existing autocomplete endpoint ( ) does not do so. This is a functional disparity. Users of the autocomplete endpoint cannot hide specific words.`SamplingParamsbad_words`
17+
18+
This PR adds the `bad_words` field to reflect the existing chat implementation (the sampling parameter block and the field) and connects it via `CompletionRequest`.`to_sampling_params()chat_completion/protocol.pybad_words=self.bad_wordsto_sampling_params`
19+
20+
**This is not a duplicate.** `bad_words`  I searched for open PRs regarding (title/body), `bad_words CompletionRequest`, and `completion bad_words parity`, but the existing `bad_words` PRs concern tokenizer conversion/caching bugs, and there are no PRs that add the field to the autocomplete endpoint.
21+
22+
### **Test Plan**
23+
24+
```text
25+
python -m pytest tests/entrypoints/openai/completion/test_completion.py \
26+
-k "bad_words" -v
27+
# lint
28+
ruff check vllm/entrypoints/openai/completion/protocol.py \
29+
tests/entrypoints/openai/completion/test_completion.py
30+
ruff format --check vllm/entrypoints/openai/completion/protocol.py \
31+
tests/entrypoints/openai/completion/test_completion.py
32+
```
33+
34+
I added two CPU-specific unit tests.
35+
36+
- `test_completion_request_bad_words_to_sampling_paramsbad_wordsSamplingParams`
37+
38+
39+
is passed to
40+
41+
.
42+
43+
- `test_completion_request_bad_words_default_empty`
44+
— It is set to an empty list by default (same as in chat).
45+
46+
### **Test Results**
47+
48+
```
49+
2 passed
50+
ruff: All checks passed! / 2 files already formatted
51+
```
52+

i18n/en/docusaurus-plugin-content-docs/current/contribute/vllm.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ description: "vLLM Multimodal Processor Cache Bug — StopIteration (400) due to
66
tags: [ai]
77
keywords: [vllm, qwen3-omni, use_audio_in_video, mm_processor_cache, StopIteration]
88
last_update:
9-
date: 2026-06-04
9+
date: 2026-06-25
1010
---
1111

1212
Collection of vLLM (`vllm-project/vllm`) open-source contributions. Each issue/PR is organized on a subpage.
Lines changed: 57 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,57 @@
1+
---
2+
title: "[Tool Parser] Fixed exception handling for backslash escapes"
3+
sidebar_position: 2
4+
slug: "2"
5+
description: "Fixed exception handling for backslash escapes in `make_valid_python`"
6+
tags: [PR]
7+
keywords: [역슬래시 이스케이프 예외처리 수정]
8+
last_update:
9+
date: 2026-06-26
10+
---
11+
12+
[https://github.com/vllm-project/vllm/pull/46708](https://github.com/vllm-project/vllm/pull/46708)
13+
14+
### **Purpose**
15+
16+
`make_valid_python` (in `vllm/tool_parsers/utils.py`) is used to add a missing closing character to close an incomplete Python tool call expression during streaming. It checks only the single character immediately preceding it to determine whether a closing quote terminates a string.
17+
18+
```text
19+
if index > 0 and text[index - 1] == "\\":
20+
pass # treat quote as escaped
21+
else:
22+
bracket_stack.pop()
23+
```
24+
25+
**This is incorrect behavior** in the case of consecutive backslashes. For example, if a *real* closing quote follows an escaped backslash,  closing quote, the single-character check incorrectly treats the `\` quote as escaped, causing the string to remain open and producing an invalid or unparseable result.
26+
27+
This PR counts the number of consecutive backslashes preceding the quote and considers the quote to be escaped only when that number is **odd**.
28+
29+
### **This is not a duplicate**
30+
31+
I searched for open PRs and issues before submitting.
32+
33+
- `gh pr list --repo vllm-project/vllm --state open --search "make_valid_python"` [**Enable tool calls after text chunks #17311**](https://github.com/vllm-project/vllm/pull/17311)
34+
→ This applies only to an unrelated 2025 draft (
35+
36+
, “Enable tool calls after text chunks”) applies.
37+
38+
- `gh search issues --repo vllm-project/vllm 'make_valid_python backslash escape'`
39+
→ No search results found.
40+
41+
This backslash-escape counting bug has not been resolved in any currently open PRs or issues.
42+
43+
### **Tests**
44+
45+
Regression tests covering all input cases—normal, even number of backslashes, and odd number of backslashes—have been added inside `tests/tool_parsers/test_utils.py` ( ).`TestMakeValidPythonEscapes`
46+
47+
- The patched version passes all `make_valid_pythonNone`
48+
passes all four cases. The prefix function
49+
50+
returns the case with an even number of backslashes, so it catches the regression error in the new test.
51+
52+
- `python -m ruff check vllm/tool_parsers/utils.py tests/tool_parsers/test_utils.py`
53+
→ Passed all checks.
54+
55+
- `python -m ruff format --diff <same files>`
56+
→ Already formatted.
57+

i18n/en/docusaurus-plugin-content-docs/current/install/ffmpeg-gpunvencnvdec-설치-절차서.md

Lines changed: 58 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: "FFmpeg GPU (NVENC/NVDEC) Installation Guide"
33
sidebar_position: 2
44
slug: "2"
55
last_update:
6-
date: 2026-06-22
6+
date: 2026-06-24
77
---
88

99
## 1. Concepts
@@ -22,47 +22,83 @@ last_update:
2222
> ffmpeg -version | head -1
2323
```
2424

25-
## 3. **Obtaining a Build with nvenc Enabled (Easiest: BtbN)**
25+
## 3. **Obtaining a Build with nvenc Enabled**
26+
27+
- H.264 (the most common format)
28+
- **Standard (CPU-based):** `c:v libx264`
29+
30+
- **NVENC (GPU-accelerated):** `c:v h264_nvenc`
31+
32+
- H.265 / HEVC (High-quality, high-compression format)
33+
- **Standard (CPU-based):** `c:v libx265`
34+
35+
- **NVENC (GPU-accelerated):** `c:v hevc_nvenc`
2636

2737
```javascript
2838
# The linux64-gpl static build from BtbN/FFmpeg-Builds includes nvenc, cuvid, and scale_cuda.
2939

3040

31-
> mkdir -p ~/ffmpeg-gpu && cd ~/ffmpeg-gpu
32-
> curl -L -o ffmpeg.tar.xz \
33-
https://github.com/BtbN/FFmpeg-Builds/releases/download/latest/ffmpeg-master-latest-linux64-gpl.tar.xz
34-
tar xf ffmpeg.tar.xz --strip-components=1
41+
> mkdir -p /usr/local/ffmpeg-gpu && cd /usr/local/ffmpeg-gpu
42+
> curl -L -o ff.tar.xz \
43+
https://github.com/BtbN/FFmpeg-Builds/releases/download/autobuild-2026-01-31-12-57/ffmpeg-N-122607-g50bcc96a75-linux64-gpl.tar.xz
44+
tar xf ff.tar.xz --strip-components=1
3545

3646
# Create bin/ffmpeg and bin/ffprobe
3747
# Alternative: Compile manually (after installing nv-codec-headers, use --enable-nvenc --enable-cuda --enable-cuvid --enable-libnpp),
3848
# Or a package that includes nvenc, such as jellyfin-ffmpeg.
3949

50+
> ls -al bin/
51+
total 578564
52+
drwxr-xr-x. 2 1001 1001 49 Jan 31 21:55 .
53+
drwxr-xr-x. 6 root root 90 Jun 24 15:58 ..
54+
-rwxr-xr-x. 1 1001 1001 196915400 Jan 31 21:55 ffmpeg
55+
-rwxr-xr-x. 1 1001 1001 198827688 Jan 31 21:55 ffplay
56+
-rwxr-xr-x. 1 1001 1001 196698312 Jan 31 21:55 ffprobe
57+
>
4058

41-
```
4259

43-
## 4. Build + Driver Compatibility Check
60+
```
4461

45-
```javascript
46-
FF=~/ffmpeg-gpu/bin/ffmpeg
62+
## 4. Verify Build + Driver Compatibility
4763

64+
```bash
4865
# Verify Feature Inclusion
49-
> FF -hide_banner -hwaccels | grep cuda
50-
> FF -hide_banner -encoders | grep -i nvenc # h264_nvenc, hevc_nvenc, av1_nvenc
51-
> FF -hide_banner -decoders | grep -i cuvid # h264_cuvid, hevc_cuvid, vp9_cuvid ...
52-
> FF -hide_banner -filters | grep scale_cuda
66+
> bin/ffmpeg -hide_banner -hwaccels | grep cuda
67+
cuda
68+
> bin/ffmpeg -hide_banner -encoders | grep -i nvenc
69+
V....D av1_nvenc NVIDIA NVENC av1 encoder (codec av1)
70+
V....D h264_nvenc NVIDIA NVENC H.264 encoder (codec h264)
71+
V....D hevc_nvenc NVIDIA NVENC hevc encoder (codec hevc)
72+
> bin/ffmpeg -hide_banner -decoders | grep -i cuvid
73+
V..... av1_cuvid Nvidia CUVID AV1 decoder (codec av1)
74+
V..... h264_cuvid Nvidia CUVID H264 decoder (codec h264)
75+
V..... hevc_cuvid Nvidia CUVID HEVC decoder (codec hevc)
76+
V..... mjpeg_cuvid Nvidia CUVID MJPEG decoder (codec mjpeg)
77+
V..... mpeg1_cuvid Nvidia CUVID MPEG1VIDEO decoder (codec mpeg1video)
78+
V..... mpeg2_cuvid Nvidia CUVID MPEG2VIDEO decoder (codec mpeg2video)
79+
V..... mpeg4_cuvid Nvidia CUVID MPEG4 decoder (codec mpeg4)
80+
V..... vc1_cuvid Nvidia CUVID VC1 decoder (codec vc1)
81+
V..... vp8_cuvid Nvidia CUVID VP8 decoder (codec vp8)
82+
V..... vp9_cuvid Nvidia CUVID VP9 decoder (codec vp9)
83+
84+
> bin/ffmpeg -hide_banner -filters | grep scale_cuda
85+
.. scale_cuda V->V GPU accelerated video resizer
5386

5487

5588
# Does nvenc actually open in the driver? (Important)
56-
$FF -y -f lavfi -i testsrc=size=1280x720:rate=30:duration=3 -c:v h264_nvenc /tmp/t.mp4 \
89+
> bin/ffmpeg -y -f lavfi -i testsrc=size=1280x720:rate=30:duration=3 -c:v h264_nvenc /tmp/t.mp4 \
5790
&& echo "NVENC OK" || echo "NVENC failed"
58-
91+
...
92+
...
93+
NVENC OK
94+
>
5995
```
6096

6197
- Note — **Driver vs. NVENC SDK Version**: Builds that are too recent require the new NVENC SDK and will be rejected by older drivers.
62-
- If `Driver does not support the required nvenc API version. Required: X.Y` appears, update the driver or obtain an **older build** (BtbN’s date-specific `autobuild-YYYY-MM-DD` releases).
63-
- Make sure the test input is large enough, such as 1280x720(Very small resolutions may trigger false positives due to falling below the NVENC minimum resolution).
98+
- If `Driver does not support the required nvenc API version. Required: X.Y` appears, update your driver or use an **older build** (BtbN’s `autobuild-YYYY-MM-DD` releases sorted by date).
99+
- Make sure the test input is large enough, such as 1280x720 (very small sizes may trigger false positives due to falling below the NVENC minimum resolution).
64100

65-
## 5. Basic Usage Patterns
101+
## 5. Basic Usage Pattern
66102

67103
Perform decoding, scaling, and encoding entirely on the GPU:
68104

@@ -80,10 +116,10 @@ Perform decoding, scaling, and encoding entirely on the GPU:
80116
-vf scale_cuda=1280:720 -c:v h264_nvenc out.mp4
81117
```
82118

83-
Frequently used options
119+
Frequently Used Options
84120

85121
- `hwaccel cuda` : Use hardware decoding
86-
- `hwaccel_output_format cuda` : Keep decoded frames in GPU memory (required when combined with GPU filters such as scale_cuda)
122+
- `hwaccel_output_format cuda` : Keep decoded frames in GPU memory(required when chained with GPU filters such as `scale_cuda`)
87123
- `c:v h264_nvenc` / `hevc_nvenc` / `av1_nvenc` : Hardware encoder
88124
- `preset p1` (Fast) ~ `p7` (High Quality), `tune ll` / `ull`: nvenc quality/speed
89125
- `gpu 0` or `hwaccel_device 1`: Specify the ##GPU to use
@@ -101,5 +137,5 @@ The GPU-Util(%) value in nvidia-smi refers to compute cores (SMs), so it appears
101137
- The default ffmpeg included in most distributions often has nvenc disabled → Check step 4 first.
102138
- If the ffmpeg build is newer than the driver, nvenc will fail → Upgrade the driver or use an older ffmpeg build.
103139
- A cuvid decoder compatible with the input codec is required for GPU decoding (otherwise, it will fall back to CPU decoding or result in an error).
104-
- FFmpeg is an independent static binary, so it can be installed or replaced independently of the system or Python environment.
140+
- FFmpeg is a standalone static binary, so it can be installed or replaced independently of the system or Python environment.
105141

0 commit comments

Comments
 (0)