💄 style: use default deployment name when parseModelString doesn't contain deployment name (lobehub#7719)

* ♻️ refactor: use default deployment name when parseModelString doesn't contain deployment name

* ✅ test: add test case for parseModelString without deployment name

* 添加测试用例

* 📝 docs: clarify default deployment name behavior in model list documentation

* 📝 docs: update deployment name description for clarity in model list documentation

* 📝 docs: update deployment name description for clarity in model list documentation

Author: bbbugg

docs/self-hosting/advanced/model-list.mdx

@@ -19,6 +19,7 @@ You can use `+` to add a model, `-` to hide a model, and use `model name->deploy
 ```text
 id->deploymentName=displayName<maxToken:vision:reasoning:search:fc:file:imageOutput>,model2,model3
 ```
+The deploymentName `->deploymentName` can be omitted, and it defaults to the latest model version. Currently, the model service providers that support `->deploymentName` are: Azure and Volcengine.
 
 For example: `+qwen-7b-chat,+glm-6b,-gpt-3.5-turbo,gpt-4-0125-preview=gpt-4-turbo`
 

docs/self-hosting/advanced/model-list.zh-CN.mdx

@@ -18,6 +18,7 @@ LobeChat 支持在部署时自定义模型列表，详情请参考 [模型提供
 ```text
 id->deploymentName=displayName<maxToken:vision:reasoning:search:fc:file:imageOutput>,model2,model3
 ```
+部署名`->deploymentName`可以省略，默认为最新版本的模型。当前支持`->deploymentName`的模型服务商有：Azure和Volcengine。
 
 例如： `+qwen-7b-chat,+glm-6b,-gpt-3.5-turbo,gpt-4-0125-preview=gpt-4-turbo`
 

docs/self-hosting/environment-variables/model-provider.mdx

@@ -599,9 +599,9 @@ If you need to use Azure OpenAI to provide model services, you can refer to the
 ### `VOLCENGINE_MODEL_LIST`
 
 - Type: Optional
-- Description: Used to control the model list, use `+` to add a model, use `-` to hide a model, use `model_name->deploymentName=display_name` to customize the display name of a model, separated by commas. Definition syntax rules see [model-list][model-list]
+- Description: Used to control the model list, use `+` to add a model, use `-` to hide a model, use `model_name->deploymentName=display_name` to customize the display name of a model, separated by commas. The deploymentName `->deploymentName` can be omitted, and it defaults to the latest model version. Definition syntax rules see [model-list][model-list]
 - Default: `-`
-- Example: `-all,+deepseek-r1->deepseek-r1-250120,+deepseek-v3->deepseek-v3-250324,+doubao-1.5-pro-256k->doubao-1-5-pro-256k-250115,+doubao-1.5-pro-32k->doubao-1-5-pro-32k-250115,+doubao-1.5-lite-32k->doubao-1-5-lite-32k-250115`
+- Example: `-all,+deepseek-r1,+deepseek-v3->deepseek-v3-250324,+doubao-1.5-pro-256k,+doubao-1.5-pro-32k->doubao-1-5-pro-32k-250115,+doubao-1.5-lite-32k`
 
 ### `VOLCENGINE_PROXY_URL`
 
@@ -622,7 +622,7 @@ If you need to use Azure OpenAI to provide model services, you can refer to the
 ### `INFINIAI_MODEL_LIST`
 
 - Type: Optional
-- Description: Used to control the model list, use `+` to add a model, use `-` to hide a model, use `model_name->deploymentName=display_name` to customize the display name of a model, separated by commas. Definition syntax rules see [model-list][model-list]
+- Description: Used to control the model list, use `+` to add a model, use `-` to hide a model, use `model_name=display_name` to customize the display name of a model, separated by commas. Definition syntax rules see [model-list][model-list]
 - Default: `-`
 - Example: `-all,+qwq-32b,+deepseek-r1`
 

docs/self-hosting/environment-variables/model-provider.zh-CN.mdx

@@ -597,9 +597,9 @@ LobeChat 在部署时提供了丰富的模型服务商相关的环境变量，
 ### `VOLCENGINE_MODEL_LIST`
 
 - 类型：可选
-- 描述：用来控制模型列表，使用 `+` 增加一个模型，使用 `-` 来隐藏一个模型，使用 `模型名->部署名=展示名<扩展配置>` 来自定义模型的展示名，用英文逗号隔开。模型定义语法规则见 [模型列表][model-list]
+- 描述：用来控制模型列表，使用 `+` 增加一个模型，使用 `-` 来隐藏一个模型，使用 `模型名->部署名=展示名<扩展配置>` 来自定义模型的展示名，用英文逗号隔开。部署名`->部署名`可以省略，默认为最新版本的模型。模型定义语法规则见 [模型列表][model-list]
 - 默认值：`-`
-- 示例：`-all,+deepseek-r1->deepseek-r1-250120,+deepseek-v3->deepseek-v3-250324,+doubao-1.5-pro-256k->doubao-1-5-pro-256k-250115,+doubao-1.5-pro-32k->doubao-1-5-pro-32k-250115,+doubao-1.5-lite-32k->doubao-1-5-lite-32k-250115`
+- 示例：`-all,+deepseek-r1,+deepseek-v3->deepseek-v3-250324,+doubao-1.5-pro-256k,+doubao-1.5-pro-32k->doubao-1-5-pro-32k-250115,+doubao-1.5-lite-32k`
 
 ### `VOLCENGINE_PROXY_URL`
 
@@ -620,7 +620,7 @@ LobeChat 在部署时提供了丰富的模型服务商相关的环境变量，
 ### `INFINIAI_MODEL_LIST`
 
 - 类型：可选
-- 描述：用来控制模型列表，使用 `+` 增加一个模型，使用 `-` 来隐藏一个模型，使用 `模型名->部署名=展示名<扩展配置>` 来自定义模型的展示名，用英文逗号隔开。模型定义语法规则见 [模型列表][model-list]
+- 描述：用来控制模型列表，使用 `+` 增加一个模型，使用 `-` 来隐藏一个模型，使用 `模型名=展示名<扩展配置>` 来自定义模型的展示名，用英文逗号隔开。模型定义语法规则见 [模型列表][model-list]
 - 默认值：`-`
 - 示例：`-all,+qwq-32b,+deepseek-r1`
 

src/utils/parseModels.test.ts

@@ -306,16 +306,13 @@ describe('parseModelString', () => {
   });
 
   describe('deployment name', () => {
-    it('should have same deployment name as id', () => {
+    it('should have no deployment name', () => {
       const result = parseModelString('model1=Model 1', true);
       expect(result.add[0]).toEqual({
         id: 'model1',
         displayName: 'Model 1',
         abilities: {},
         type: 'chat',
-        config: {
-          deploymentName: 'model1',
-        },
       });
     });
 
@@ -455,6 +452,61 @@ describe('transformToChatModelCards', () => {
     expect(result).toMatchSnapshot();
   });
 
+  it('should use default deploymentName from known model when not specified in string (VolcEngine case)', () => {
+    const knownModel = LOBE_DEFAULT_MODEL_LIST.find(
+      (m) => m.id === 'deepseek-r1' && m.providerId === 'volcengine',
+    );
+    const defaultChatModels: AiFullModelCard[] = [];
+    const result = transformToAiChatModelList({
+      modelString: '+deepseek-r1',
+      defaultChatModels,
+      providerId: 'volcengine',
+      withDeploymentName: true,
+    });
+    expect(result).toContainEqual({
+      ...knownModel,
+      enabled: true,
+    });
+  });
+
+  it('should use deploymentName from modelString when specified (VolcEngine case)', () => {
+    const defaultChatModels: AiFullModelCard[] = [];
+    const knownModel = LOBE_DEFAULT_MODEL_LIST.find(
+      (m) => m.id === 'deepseek-r1' && m.providerId === 'volcengine',
+    );
+    const result = transformToAiChatModelList({
+      modelString: `+deepseek-r1->my-custom-deploy`,
+      defaultChatModels,
+      providerId: 'volcengine',
+      withDeploymentName: true,
+    });
+    expect(result).toContainEqual({
+      ...knownModel,
+      enabled: true,
+      config: { deploymentName: 'my-custom-deploy' },
+    });
+  });
+
+  it('should set both id and deploymentName to the full string when no -> is used and withDeploymentName is true', () => {
+    const defaultChatModels: AiFullModelCard[] = [];
+    const result = transformToAiChatModelList({
+      modelString: `+my_model`,
+      defaultChatModels,
+      providerId: 'volcengine',
+      withDeploymentName: true,
+    });
+    expect(result).toContainEqual({
+      id: `my_model`,
+      displayName: `my_model`,
+      type: 'chat',
+      abilities: {},
+      enabled: true,
+      config: {
+        deploymentName: `my_model`,
+      },
+    });
+  });
+
   it('should handle azure real case', () => {
     const defaultChatModels = [
       {

src/utils/parseModels.ts

@@ -23,7 +23,7 @@ export const parseModelString = (modelString: string = '', withDeploymentName =
 
     if (withDeploymentName) {
       [id, deploymentName] = id.split('->');
-      if (!deploymentName) deploymentName = id;
+      // if (!deploymentName) deploymentName = id;
     }
 
     if (disable) {
@@ -141,6 +141,12 @@ export const transformToAiChatModelList = ({
         knownModel = LOBE_DEFAULT_MODEL_LIST.find((model) => model.id === toAddModel.id);
         if (knownModel) knownModel.providerId = providerId;
       }
+      if (withDeploymentName) {
+        toAddModel.config = toAddModel.config || {};
+        if (!toAddModel.config.deploymentName) {
+          toAddModel.config.deploymentName = knownModel?.config?.deploymentName ?? toAddModel.id;
+        }
+      }
 
       // if the model is known, update it based on the known model
       if (knownModel) {