From a5f9fb59604f3a84e8be1317e33b2d368c9fc6f9 Mon Sep 17 00:00:00 2001
From: "wang.yuqi" <yuqi.wang@daocloud.io>
Date: Thu, 11 Dec 2025 18:18:25 +0800
Subject: [PATCH] [Deprecation] Deprecation `--convert reward`, use `--convert
 embed` instead. (#30463)

Signed-off-by: wang.yuqi <yuqi.wang@daocloud.io>
---
 docs/models/pooling_models.md | 5 ++++-
 vllm/config/model.py          | 7 +++++++
 vllm/config/pooler.py         | 6 ++++--
 3 files changed, 15 insertions(+), 3 deletions(-)

diff --git a/docs/models/pooling_models.md b/docs/models/pooling_models.md
index 32ffcf96fabef..b4b0150faf841 100644
--- a/docs/models/pooling_models.md
+++ b/docs/models/pooling_models.md
@@ -316,10 +316,13 @@ We have split the `encode` task into two more specific token-wise tasks: `token_
 
 ### Remove softmax from PoolingParams
 
-We are going to remove `softmax` and `activation` from `PoolingParams`. Instead, use `use_activation`, since we allow `classify` and `token_classify` to use any activation function.
+We are going to remove `softmax` and `activation` from `PoolingParams` in v0.15. Instead, use `use_activation`, since we allow `classify` and `token_classify` to use any activation function.
 
 ### as_reward_model
 
+!!! warning
+    We are going to remove `--convert reward` in v0.15, use `--convert embed` instead.
+
 Pooling models now default support all pooling, you can use it without any settings.
 
 - Extracting hidden states prefers using `token_embed` task.
diff --git a/vllm/config/model.py b/vllm/config/model.py
index bd98111ffb5db..03140c17fb50e 100644
--- a/vllm/config/model.py
+++ b/vllm/config/model.py
@@ -788,6 +788,13 @@ class ModelConfig:
         runner_type: RunnerType,
         convert: ConvertOption,
     ) -> ConvertType:
+        if convert == "reward":
+            logger.warning(
+                "`--convert reward` is deprecated and will be removed in v0.15. "
+                "Please use `--convert embed` instead."
+            )
+            return "embed"
+
         if convert != "auto":
             return convert
 
diff --git a/vllm/config/pooler.py b/vllm/config/pooler.py
index aa4e7006d0247..976ae8c063eb7 100644
--- a/vllm/config/pooler.py
+++ b/vllm/config/pooler.py
@@ -111,13 +111,15 @@ class PoolerConfig:
 def get_use_activation(o: object):
     if softmax := getattr(o, "softmax", None) is not None:
         logger.warning_once(
-            "softmax will be deprecated, please use use_activation instead."
+            "softmax will be deprecated and will be removed in v0.15. "
+            "Please use use_activation instead."
         )
         return softmax
 
     if activation := getattr(o, "activation", None) is not None:
         logger.warning_once(
-            "activation will be deprecated, please use use_activation instead."
+            "activation will be deprecated and will be removed in v0.15. "
+            "Please use use_activation instead."
         )
         return activation