UNKNOWN_MODEL 错误
修复 UNKNOWN_MODEL：核对准确 Model ID、模型服务商 Base URL 和模型列表，再选择或添加真实存在的模型。
本页内容
先确认是不是 UNKNOWN_MODEL
这页只处理 UNKNOWN_MODEL 这一类报错。不同系统或 Node.js 版本可能多几个单词，但核心错误码或句式应该一致。
UNKNOWN_MODELunknown modelDSH UNKNOWN_MODEL搜索或求助时尽量复制完整报错，同时删除 API Key、私有仓库名、用户名和敏感路径。
打开“设置 → 模型”，核对服务商 Base URL 和当前模型列表，再选择真实存在的准确 Model ID。不要直接照搬营销名称或旧截图。
UNKNOWN_MODEL 是什么意思
当前会话引用的 Model ID 并不存在于正在使用的模型服务商配置中。
UNKNOWN_MODEL 的常见原因
- Model ID 已改名、下线或输入错误。
- 默认模型仍指向已删除或已替换的模型服务商。
- 模型发现失败，所以自定义模型没有被添加。
- 旧会话仍保存着与当前默认值不同的模型。
UNKNOWN_MODEL 的源码依据
下面链接固定到本页核验使用的 0.1.2-alpha.5 / 49a606b。先确认 UNKNOWN_MODEL 是 DSH 自身行为，还是 Node.js、PowerShell、操作系统网络或文件权限产生的错误。
修复 UNKNOWN_MODEL
- 01
逐字核对 Model ID
把当前 Model ID 与服务商实际模型列表对比。大小写、标点和服务商前缀都可能影响匹配。
- 02
确认模型属于正确的服务商
打开“设置 → 模型”，确认该模型属于你已经配置 Base URL 和凭据的服务商。
- 03
刷新或手动添加模型
服务商支持 GET /models 时使用模型发现；不支持时，手动添加已经确认无误的 Model ID。
- 04
用新会话测试
选择修正后的模型。如果旧会话仍引用旧模型，直接新建会话。
确认 UNKNOWN_MODEL 已经修好
- 所选模型显示在正确的模型服务商下。
- 新会话发送简单任务后不再出现 UNKNOWN_MODEL。
- 不要根据营销名称猜 Model ID。
- 不要认为修改全局默认模型会自动改写旧会话。
UNKNOWN_MODEL 常见问题
UNKNOWN_MODEL 怎么修？
打开“设置 → 模型”，核对服务商 Base URL 和当前模型列表，再选择真实存在的准确 Model ID。不要直接照搬营销名称或旧截图。
UNKNOWN_MODEL 是什么意思？
当前会话引用的 Model ID 并不存在于正在使用的模型服务商配置中。
怎么确认 UNKNOWN_MODEL 已经修好？
所选模型显示在正确的模型服务商下。 新会话发送简单任务后不再出现 UNKNOWN_MODEL。
本页于 2026-09-03 对照官方仓库核验。网站使用的已发布版本基线为 0.1.1-rc.2；源码核验快照为 0.1.2-alpha.5（49a606b）。