模型列表里看不到新上线的模型?分清内置目录、端点探测与能力声明

简介: 在 DSH 中配置模型提供商时,最容易混淆的是三类不同的「模型信息来源」:**已安装目录**、**端点实时探测**和**使用者自行声明的能力**。内置提供商的探测结果来自已安装目录,即使 API 地址指向网关,也不会变成网关的实时列表;列表中出现某个模型 ID,也不代表端点确实支持相应的上下文窗口或图片输入。本文依次梳理三个配置路径、列表看似过时的原因、探测与真实请求的区别、凭据和网络的排查方式,以及安全边界。

「我刚在网关后台看到的新模型,怎么没出现在 DSH 的模型列表里?是不是版本太旧了?」 这个疑问很合理,但它默认了「模型列表就是端点实时返回的清单」。在 DSH 中,这种理解只对了一半:要看你使用的是哪种提供商配置。

先厘清三种配置路径,后面的现象就容易对应起来:DeepSeek 卡片、内置第三方提供商,以及自定义模型 API。

排查时常见的六类误判:

  1. 把已安装目录当作端点实时探测;
  2. 把探测成功等同于模型可用;
  3. 把凭据检测提示当成认证已通过;
  4. 把本地声明的能力当成上游真实支持;
  5. 以为修改模型设置和修改代理环境变量是一回事;
  6. 把新会话的默认值当成旧会话也已切换模型。

先记住这句话:模型列表回答的是「有哪些」,不回答「能不能用」。 站内基础版可参考 配置模型提供商。

一、三个路径,三种信息来源

DeepSeek 卡片

模型配置指南说明,先在设置 → 模型中填写 DeepSeek 卡片。模型修改从下一次请求开始生效,无需重启服务器。这个「不重启」的特性值得记住,后面会和代理配置形成对照。

已保存的密钥在界面中是只写的:页面接收的是脱敏描述符,而不是明文。指南说明,凭据保存在 $DSH_HOME/.credentials.yaml,settings 中只保留凭据引用。因此,「浏览器里看不到密钥」是设计如此,并不表示密钥没有保存。

内置第三方提供商

选择添加模型提供商,再选一个提供商 ID(指南举例 anthropic、openai、moonshotai、zai),并按需保存凭据。端点、协议和模型列表都由已安装目录提供。

这里容易踩坑:凭据指示只表示检测到了凭据,不会验证密钥,也不会测试连接。留空时,在支持的情况下,可能会使用已保存的凭据或环境变量作为后备。

自定义模型 API

公司网关、中转服务、自建服务,或已安装目录中没有的提供商,都可以走这条路径。需要填写:小写 Provider ID、基础 URL、API 协议、凭据,以及至少一个模型。

协议必须与端点匹配。文档列出了 OpenAI Chat Completions、OpenAI Responses 和 Anthropic Messages 三种协议。一个提供商只能使用一种协议;如果网关同时提供两种协议,而你都要用,就需要创建两个提供商。

配置路径 模型信息来源 首先核对什么
DeepSeek 卡片 DeepSeek 适配器配置 密钥是否已保存、模型是否选对
内置第三方提供商 已安装目录 提供商 ID 与凭据来源
自定义模型 API 端点探测或手动模型 ID 基础 URL、协议和端点实际能力

还有一点容易忽略:自定义 Provider ID 是永久标识。请求、已保存的会话、默认值和凭据引用都会使用它。要更改名称,正确做法是新建提供商并删除旧的,而不是修改 ID。显示名称和 ID 不能互换。

二、为什么模型列表看起来过时

指南对此说得很直接:内置提供商的模型探测结果来自已安装目录,即使 API 地址指向网关也是如此。

也就是说,把内置提供商的地址改为自己的网关后,模型列表不会自动变成网关的实时清单;列表仍然来自随安装包提供的目录。

社区中确实有相关反馈:讨论 #6307 中有用户报告 OpenRouter 模型缺失;讨论 #7660 则提议更新目录依赖并调整发现逻辑。这两条属于社区反馈与提议,并非官方结论:它们不能证明每个构建的实际情况,也不能证明提议中的补丁已经发布。

因此,要查询网关实际提供的模型,正确做法是使用自定义提供商进行探测,而不是期待内置目录及时更新。

探测能做什么、不能做什么

自定义提供商的获取可用模型功能会使用表单当前填写的地址、协议和密钥请求端点;对于已保存的提供商,则可以使用已保存的密钥。

有两个限制:选中所需项目并添加后,只有保存或创建提供商,信息才会真正存储;探测支持常见响应格式,但并未覆盖所有端点。如果探测失败或列表为空,可根据服务提供方的文档手动填写一个有效的模型 ID。

三、探测成功不等于模型可用

这是本文最想强调的一点。

列表中出现某个模型,或手动输入一个 ID,都不保证端点支持相应的上下文窗口、图片输入或推理行为。指南明确指出,配置中的能力是使用者作出的声明。

换句话说,模型设置中的上下文窗口、最大输出 token、输入类型等字段,影响的是集成侧如何处理模型,而不是上游服务。填入一个数字或勾选图片输入,不会让网关开始接受图片。

因此,修改容量或输入类型前,应先查阅提供方文档;保存后,再用一个小型代表性请求测试实际需要的能力。

模型探测 vs 真实请求

把探测结果当作初步列表,而不是最终验证。使用自定义提供商时,可以按以下顺序操作:

  1. 先确认地址和协议指向同一个服务;
  2. 使用当前表单中的值获取模型列表;
  3. 成功 → 添加目标模型并保存;失败 → 对照端点文档手动填写一个有效 ID;
  4. 两种情况下,都要选择已保存的模型并发送最小请求。

还有一步很关键:记录错误发生在探测、保存、选择还是生成阶段。 这四个阶段的失败原因各不相同,混在一起排查就无法获得有效信息。

四、凭据和网络要分开查

检测提示不验证凭据

页面提示检测到凭据环境变量时,指南说明,这并不代表凭据已经验证。先确认选对了提供商,再在不公开密钥的前提下确认服务是否接受该密钥。对于自定义端点,还要核对 URL 和协议。

有句话容易踩坑:一家服务的有效凭据,不一定适用于另一家端点。

代理作用在启动环境上

网络代理指南说明,DSH 会在启动时读取标准代理环境变量,用于自身的出站请求;指南还列出了保持直连的例外,例如回环地址、部分模型编写代码的路径等。

这里必须区分两件事:修改启动环境变量需要重启,而保存模型设置会从下一次请求开始生效。 别把「设置已保存」当成「代理已经生效」。

此外,一次出站请求的代理测试成功,不能证明所有进程和目标都经过同一路由。 例外列表正是为此而列出的。

怎样确认测试用的就是目标模型

测试前,记下提供商 ID 和选择器中选定的模型,再确认观察到的结果属于目标会话。

指南说明,已经发送过请求的会话会保留日志中记录的模型。因此,新会话的默认值变了,不代表旧会话也切换到了新模型。用旧会话测试,测到的可能并不是你原本要测的模型。

五、限制与安全边界

代理 URL 中可能包含凭据,而代理指南提醒,DSH 运行的命令会继承这些环境变量。因此,不要把密码写进可能被工具读取或留在命令输出中的代理 URL。

不要通过关闭证书校验走捷径,应按指南配置组织的 CA。

模型设置无需重启即可生效,这在安全上也有影响:发送敏感内容前,先确认当前选中的提供商和模型。

最后还要记住:检测提示不测试凭据,模型列表探测成功也不能证明生成请求或图片输入成功。 排查时,应把凭据、网络、协议、模型 ID 和能力分别验证;分享日志前,先检查其中是否包含敏感信息。

六、术语速查

  • 提供商:访问模型服务时使用的路由和认证配置。
  • Provider ID:用于请求和保存配置的持久标识。
  • 基础 URL:提供商配置中的 API 地址。
  • 已安装目录:内置提供商集成随安装提供的模型和协议信息。
  • 模型探测:向自定义端点请求模型列表;端点支持情况和响应格式可能有所不同。

相关阅读

本文依据 DeepSeek Harness 模型配置与网络代理指南,以及社区讨论 #6307、#7660 整理,由 DSH Plugin 社区(dsh-plugin.com)维护者撰写,首发于阿里云开发者社区。
原文地址:https://dsh-plugin.com/zh/blog/configure-models-providers
插件与文档收录于:https://dsh-plugin.com/zh/blog

目录
相关文章
|
8天前
|
Linux Go 开发工具
手机上跑 DeepSeek 智能体:开源安卓客户端 DSH Go 安装与使用指南
DSH Go 是一款开源安卓客户端,将 DeepSeek Harness 智能体引擎装进手机:免 Root、免 Termux,一键安装即用;支持本机运行(内置 Ubuntu+Node.js)或远程接管电脑会话;具备插话打断、过程折叠、屏幕操控、端到端加密分享等特色功能,真正实现智能体“口袋化”。
9181 24
|
8天前
|
弹性计算 人工智能 API
Codex超详细入门指南(下载·安装·登录·上手,全版本覆盖,2026最新版)
建议收藏本教程,2026 全年各版本更新随时回来查阅。如果你在搭建过程中遇到任何问题,欢迎结合 阿里云工单系统 提交技术支持请求,或在 阿里云开发者社区 搜索 Codex 相关话题交流。 祝你编码愉快,效率翻倍!
2707 14
|
3天前
|
人工智能 安全 应用服务中间件
NGINX 爆出两处高危漏洞 可导致未经身份验证的远程代码执行
NGINX曝出两个高危漏洞(CVE-2026-123633和CVE-2026-123007),CVSS 9.2分,均属HTTP/2内存安全缺陷,无需认证即可远程执行代码。影响自2015年起的多个版本,静态站点亦受威胁。修复版本为开源版1.30.7/1.31.9。(239字)
1298 0
NGINX 爆出两处高危漏洞 可导致未经身份验证的远程代码执行
|
6天前
|
传感器 安全 区块链
Windows 电脑运行安卓应用教程:开源工具 ApkStart 双击 APK 即装、独立窗口运行
ApkStart 是一款开源Windows工具,让安卓APP像原生软件一样运行:双击APK即安装、生成真实图标、独立窗口启动、开始菜单可搜索。无需传统模拟器,内置QEMU运行时,支持数据互通、ARM兼容与命令行操作。(239字)
|
10天前
|
人工智能 前端开发 API
阿里云Qwen4-Max 大模型详解:定位、特征、能力、适用场景与相对Qwen3-Max差异解析
2026年11月11日,阿里发布第四代旗舰模型Qwen4-Max预览版,首发千问AI平台Token Plan并接入千问办公、Qoder等入口。该版本聚焦知识理解、世界感知、编程与Agentic四项升级,主打复杂编程、专业办公、前端设计与专业软件操作等真实任务。预览期为11月11日10:00至11月25日24:00,仅支持Token Plan调用,到期后模型标识下线;限时2折、新用户再享5折,最低1折可体验。
|
10天前
|
JSON 前端开发 API
阿里云最新Qwen4-Max大模型介绍:模型定位、特征、能力、适用场景解析
2026 年 11 月 11 日,阿里发布第四代旗舰模型Qwen4-Max预览版,首发千问 AI 平台 Token Plan,并同步接入千问办公、Qoder 等入口。该版本聚焦知识理解、世界感知、编程与 Agentic 四项升级,主打复杂编程、专业办公、前端设计与专业软件操作。预览期至 11 月 25 日 24:00,到期后模型标识下线;限时 2 折、新用户再享 5 折,最低 1 折可体验。
|
23天前
|
Linux 开发工具 iOS开发
Codex保姆级教程(下载+安装+登录+使用,含所有版本,2026最新)
Codex是OpenAI推出的开源AI编程智能体,本地运行,可理解整个代码库,支持自然语言指令改代码、执行命令、跑测试、修Bug,兼容Win/macOS/Linux。(239字)
11194 59
|
6天前
|
人工智能 弹性计算 开发工具
零成本玩各大模型!DeepSeek Harness dsh-our-free-model 插件,13 个厂商模型直接用
总结一下:装这个插件,你不用注册、不用绑卡、不用填一个 Key,就能在 DeepSeek Harness 里用上 DeepSeek V4.1 Flash、Kimi K3 这一批前沿模型,而且是白嫖的、还不限量。三步搞定:下载插件,复制包含 `package.json` 的插件目录路径,在「添加插件」里粘贴路径安装并重启。无论是在阿里云 ECS 上通过命令行部署的 Web 版,还是本地的 Electron 桌面端,都能顺利跑通,快速搭建一套零成本的免费模型使用环境。
1336 1
|
4天前
|
人工智能 弹性计算 IDE
Codex超详细入门指南(下载·安装·登录·上手,全版本覆盖,2026最新版)
适合团队落地代码规范,每次提交自动生成评审报告,降低人工CR工作量。同时支持自定义技能脚本,接入团队内部SDK说明文档,让Codex生成符合团队编码规范的代码。Codex三大客户端覆盖本地开发、服务器远程编码、自动化流水线场景,搭配阿里云百炼的Token Plan、Coding Plan,能够低成本搭建稳定可控的AI编码助手。新手建议先从IDE插件入手,熟悉交互逻辑,再尝试CLI版本部署在阿里云ECS,实现云上项目远程编码、批量脚本处理。只要按照步骤完成环境准备、版本选型、密钥对接、项目初始化,就可以把Codex融入日常开发流程,大幅提升代码编写、问题排查、项目重构的效率。
951 0
|
9天前
|
Linux API iOS开发
【DSH】DeepSeek Harness新手保姆教程(下载+安装+配置+使用,2026最新实测)
DeepSeek Harness(dsh)是DeepSeek AI开源的智能体框架,秉持“一切皆插件”理念,支持读文件、改代码、跑命令、处理表格、联网搜索等操作。免费开源,兼容Windows/macOS/Linux,提供桌面端与网页端,可灵活安装插件扩展能力。