DeepSeek Harness UNKNOWN_MODEL 中文排查
遇到 UNKNOWN_MODEL 时，先检查当前提供商路由中是否配置了请求的精确模型 ID，而不是立即重装启动器。模型显示名称与端点 ID 不相同，另一个提供商目录中出现的模型也不能直接用于当前网关。自定义端点发现为空时，可以依据它正式公布的 ID 手动添加；保存后在新会话重新选择并验证。
分享仅包含公开链接，不携带本地进度或私人配置。
先检查 Provider ID 与精确模型 ID
核对会话选择的提供商、模型 ID 和实际加载的 Profile。ID 的大小写、前后缀和命名空间应与端点文档一致。显示名称可编辑，不是请求标识；不要因为别的平台使用同一品牌模型就复制那里的 ID。
确认模型写入了当前配置
Fetch available models 返回候选项后，还需要选中、添加并保存提供商。只在列表弹窗里看到模型，不代表已经持久保存。高级配置的整行替换也可能移除旧 models；检查合并后的当前路由，避免把其他提供商的列表误当当前模型目录。
发现失败时使用端点公开的 ID
自定义提供商可以查询网关，但列表格式不一定受支持。发现为空时先查提供商文档，手动添加一个明确支持的 ID，再测试推理。内置提供商的目录来自已安装包，不会因修改 Base URL 自动变成网关实时目录。
用新会话排除旧模型记录
修改默认模型或删除旧提供商后，旧会话仍可能保留历史模型。新建会话并检查选择器；不要只观察设置页。若模型已配置但服务器返回 not found，再核对该端点当前是否对你的账户开放，以及请求协议是否匹配。
常见问题
列表里看到了模型，为什么仍然 UNKNOWN_MODEL？
检查是否已 Add selected 并保存、是否请求了同一提供商，以及当前会话是否保留旧模型。候选发现列表不会自行写入当前路由。
能把 DeepSeek 或其他服务的模型名字直接填进自建网关吗？
需要使用该网关实际接受的模型 ID。品牌相同不保证别名一致，目录或显示名称也不能代替服务器的请求标识。
修改默认模型后，应该在哪个会话测试？
先在新会话验证。已经发过请求的会话可能沿用自身记录的模型，默认值的变化不是旧会话切换的证据。
手动添加模型会自动验证它可调用吗？
不会。保存配置与真实推理分开检查。添加端点正式公布的 ID 后，发送最小请求，确认访问权限、协议和模型均正确。
官方资料
使用新版本前，打开以下固定版本或注明核验日期的资料。