模型名称必须与百炼控制台发布的模型ID完全一致、大小写敏感，且仅允许短横线、下划线和数字（不可开头或结尾），否则导致界面不显示、CLI解析失败或配置被覆盖。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
在Qoder中添加自定义模型时，模型名称是你后续在对话框或命令行中识别、切换和调用该模型的唯一标识符，必须满足唯一性、可读性和兼容性三重约束，否则会导致/model界面无法显示、CLI参数解析失败或配置被静默覆盖。
模型名称填写规范
模型名称不是随意起的昵称，而是Qoder内部用于路由和持久化的关键字段。它直接写入~/.qodercn.json的custom_models数组中，作为键值参与模型匹配逻辑。
第一步：进入/model界面 → Tab切换至Custom标签页 → 按Enter选择“Add custom model”
第二步：在Provider选择后，系统会弹出模型ID输入框——此处填入的字符串即为模型名称，【必须与百炼控制台实际发布的模型ID完全一致，大小写敏感】。例如百炼平台显示模型ID为deepseek-v4-pro，就不能填DeepSeek-V4-Pro或deepseekv4pro。
第三步：名称中禁止含空格、中文、斜杠（/）、点号（.）或控制字符；允许使用短横线（-）、下划线（_）和数字，但不可开头或结尾。
常见错误名称及后果
方法一：填我的DeepSeek Pro → 保存失败，界面提示“Invalid model identifier”，因为含空格与中文。
方法二：填deepseek/v4/pro → 配置虽能保存，但在CLI中执行qoderclicn --model deepseek/v4/pro会报错退出，因斜杠触发路径解析异常。
方法三：填deepseek-v4-pro-2026 → 合法，但若百炼侧该模型已下线，则验证连通性失败，且Qoder不会主动提醒名称有效但服务不可用。
命名建议与实操技巧
优先采用百炼控制台“模型服务”页签中“服务地址”末尾的路径片段。例如服务地址为https://dash.aliyuncs.com/v1/models/deepseek-v4-flash，则模型名称直接填deepseek-v4-flash。
若需区分同一模型的不同API Key来源（如测试环境与生产环境），可在末尾加短横线+小写字母标识，例如deepseek-v4-pro-test或deepseek-v4-pro-prod，但须确保该变体已在百炼侧完成独立部署并开通调用权限。
这一步操作起来很简单，直接复制粘贴百炼控制台模型卡片上的ID即可，无需额外加工。
