DeepSeek Harness 模型列表什么时候刷新:保存即生效、十分钟后台刷新与内置兜底
DeepSeek Harness 的「保存即生效」说的是模型配置,不是模型列表。 保存密钥后,请求会立即使用这份配置;但模型清单要等到第一次需要模型时才加载,使用期间约每十分钟在后台刷新一次,加载失败还会退回内置模型(来源)。把「配置生效」和「列表刷新」分开,很多「新模型怎么没出现」的问题就解释得通了。
DeepSeek Harness 三个时间点:保存、首次需要、十分钟后
模型列表的生命周期有三个关键时间点,分别对应三种不同的现象。 先把时间线摆出来(来源):
| 时间点 | 发生了什么 | 你会看到什么 |
|---|---|---|
| 保存密钥时 | 模型配置写入,路由立即可用 | 卡片状态变化,但列表未必更新 |
| 第一次需要模型时 | 加载发布列表 | 选择器里出现可用模型 |
| 使用期间约每十分钟 | 后台刷新列表 | 新发布的模型逐渐出现在选择器 |
这三个时间点解释了三类常见疑问:为什么刚保存时选择器还是旧的、为什么过一会儿多了一个模型、为什么离线或加载失败时仍然能选到模型。
把它们分开的另一个好处,是你能判断「等待」是否有意义。等新模型出现,值得等;等一个已经存在的模型生效,不需要等,直接发请求即可;等一个加载失败的内置兜底变成完整列表,光等不会好,要修网络或端点。
需要注意的是,「约每十分钟」是后台刷新的节奏,不是一个精确的倒计时。你不会在整十分钟时看到一次明显变化,它更像周期性的后台同步。因此,判断列表是否更新,不要盯着秒表,要看选择器里有没有目标模型。
DeepSeek Harness 保存即生效,生效的是配置不是列表
保存密钥后立即生效的是「用哪个提供商、哪把凭据」,不是「有哪些模型可选」。 官方原文是:模型变更会在下一次请求时生效,不需要重启服务器(来源)。这里的「模型变更」包括你选择的模型和提供商配置,不等于发布列表已经重新拉取。
这带来一个实用结论:如果你只是换了一个已经存在的模型,保存后直接发请求即可,不需要等列表刷新;如果你在等一个刚发布的新模型,保存密钥并不会让它立刻出现,要等列表加载或后台刷新。
因此,「保存成功」和「新模型出现」是两条不同的链路。前者是配置写入,后者是目录同步。把这两件事混在一起,就会反复保存、反复重启,最后仍然看不到新模型。
如果你怀疑列表没有更新,先看模型选择器里有没有目标模型,而不是看设置页的卡片。卡片和选择器的显示口径不同,下面会单独讲。
DeepSeek Harness 列表加载失败为什么还能用
列表加载失败时仍然能选模型,是因为 DeepSeek Harness 有内置兜底。 官方说明:第一次需要模型时加载列表,使用期间约每十分钟在后台刷新一次,无法加载时退回内置模型(来源)。
内置兜底的作用是保证可用性,不是保证最新。它让你在网络不稳定、端点暂时不可达时仍然能发请求,但代价是你看不到发布列表里的新模型。此时选择器里的模型是可用的,只是可能不是最新的。
判断是否退回了内置模型,可以看两个信号:列表里是否缺少你预期的新模型;重新加载后是否出现更多模型。如果一直只有固定的几个内置模型,说明发布列表没有成功加载,应该检查网络、端点和密钥,而不是继续等十分钟。
也不要靠反复重启来「碰运气」。内置兜底是可用性设计,不是故障提示;重启只会重新走一遍加载,网络或端点没修好,结果仍然一样。先确认加载失败的原因,再谈刷新。
这和「模型列表拉不全」的故障不是同一件事。后者通常是加载成功但字段或过滤条件有问题,排查路径见《DeepSeek Harness 模型列表拉不全》。
DeepSeek Harness 卡片显示内置模型、新模型只进选择器
设置页卡片显示内置模型,不代表列表没刷新;这是发布列表模式下的显示口径。 官方明确说:使用发布的列表时,卡片上显示的是内置模型,因此新发布的模型只出现在模型选择器中(来源)。
这条口径很容易造成误判。用户在设置页看到卡片还是那几个熟悉的内置模型,就以为列表没更新;实际上新模型已经在选择器里,只是卡片不展示。判断列表是否更新,正确的观察点是模型选择器。
为什么卡片和选择器不一致?因为卡片承担的是「配置入口」的角色,显示的是稳定的内置集合;选择器承担的是「本次可选」的角色,会吸收发布列表。两者目标不同,显示自然不同。
一个实际判断例:你在发布列表里看到一个刚上线的新模型,设置页卡片仍然是那几个内置模型,这是正常的;打开模型选择器,如果新模型在列表里,就说明列表已经更新。此时不要点恢复默认,也不要去改模型目录,否则会把一个正常状态改回配置态。
所以,遇到「新模型没出现」,先打开选择器看一眼。如果选择器里有,问题只是你看错了位置;如果选择器里也没有,再按下一节的加载与兜底路径排查。
DeepSeek Harness 自定义目录与恢复默认
自定义模型目录和恢复默认模型是一对反向操作:一个停止跟随,一个重新跟随。 官方说明:在自定义设置里编辑模型目录,会改用你自己的列表,不再跟随发布的列表;点恢复默认模型,会重新跟随并重新加载(来源)。
两者的差别可以列成一张小表:
| 操作 | 对发布列表的影响 | 对现有覆盖的影响 | 适用场景 |
|---|---|---|---|
| 编辑模型目录 | 停止跟随 | 保留你写的目录 | 网关只提供固定模型、需要手工控制 |
| 恢复默认模型 | 重新跟随并重载 | 移除整个目录覆盖 | 想回到官方发布列表 |
这里有一个容易忽略的点:恢复默认模型会移除整个模型目录覆盖,包括你在目录里做过的其他模型编辑。官方特别提醒,只有需要恢复整个目录时才用它。如果你只想改一个模型,不要用恢复默认,直接编辑该模型即可。
两个常见误用也值得点出来:
- 只想修一个模型,却点了恢复默认 — 整个目录覆盖被清掉,其他手工改动一起丢失;
- 想跟随发布列表,却继续编辑目录 — 编辑动作本身就会停止跟随,越改越偏。
判断该用哪个,只看一个问题:你是想「回到官方列表」,还是想「维护自己的列表」。前者用恢复默认,后者才编辑目录。
自定义目录适合「端点不提供标准模型列表」或「只想暴露少量模型」的场景。它的代价是你要自己维护模型 ID、上下文窗口等字段;一旦端点升级,目录不会自动跟着变。
DeepSeek Harness 验证:三处看到的是否一致
验证模型列表是否正常,不要只看一处,要把发布列表、选择器、卡片三处对齐。 推荐三步(来源):
- 看选择器 — 目标模型是否出现在模型选择器里,能否被选中;
- 看卡片 — 卡片显示的是内置模型还是自定义目录,是否符合当前模式;
- 看请求 — 选目标模型发一条最短任务,确认能返回。
三处的预期关系是:选择器反映本次可选模型;卡片反映配置模式;请求结果反映模型是否真的可用。三者不一致时,优先相信请求结果,其次看选择器,最后看卡片。
如果选择器有、请求失败,问题在凭据或端点,不在列表;如果选择器没有、卡片也没有,问题在列表加载或自定义目录;如果选择器有、卡片没有,通常只是显示口径差异,不必处理。
最后提醒一句:列表刷新是后台行为,不需要你手动重启进程。你要做的是选对观察点,而不是反复触发保存。模型列表的正常生命周期讲完,换模型后旧会话为什么不变、密钥为什么保存后看不见,可以接着看同批的另外两篇。模型提供商的完整配置见《DeepSeek Harness 模型提供方怎么配》。
常见问题
DeepSeek Harness 不会这样。DeepSeek Harness 保存密钥后立即生效的是模型配置;列表在第一次需要模型时加载,使用期间约每十分钟在后台刷新一次,新发布的模型只出现在模型选择器里。
因为 DeepSeek Harness 有内置兜底:无法加载发布列表时会退回内置模型。你仍能发请求,但看到的可能不是最新列表,需要靠刷新或恢复默认来更新。
自定义模型目录会让 DeepSeek Harness 改用你自己的列表,不再跟随发布列表;恢复默认模型会重新跟随发布列表并重新加载,同时移除整个目录覆盖。
DeepSeek Harness 里不一定,具体取决于配置。使用发布列表时,DeepSeek Harness 的卡片显示的就是内置模型,新发布的模型只出现在模型选择器中。判断列表是否更新,要看选择器而不是只看卡片。
相关术语
- 模型目录
- 模型目录是 DeepSeek Harness 可用于模型选择器的模型清单,可以跟随 DeepSeek API 发布列表,也可以由用户自定义覆盖。— DeepSeek Harness 官方文档 - 配置模型
- 发布列表
- 发布列表是 DeepSeek API 对外发布的模型清单;使用默认端点并保存密钥时,DeepSeek Harness 会跟随这份列表加载模型。— DeepSeek Harness 官方文档 - 配置模型
- 内置兜底
- 内置兜底是 DeepSeek Harness 在无法加载发布列表时退回的一组内置模型,保证模型选择器和请求仍然可用。— DeepSeek Harness 官方文档 - 配置模型
- 恢复默认模型
- 恢复默认模型是 DeepSeek Harness 设置页里的动作,用于移除整个模型目录覆盖、重新跟随发布列表并重新加载。— DeepSeek Harness 官方文档 - 配置模型
来源
- DeepSeek Harness 官方文档 - 配置模型· deepseek-harness
- DeepSeek Harness 官方文档 - API key 提供方参考· deepseek-ai