实用指南 · 独立指南
DeepSeek Harness 模型发现：空列表与手动模型 ID
模型发现为空，并不能证明网关无法调用模型。列出模型与执行推理是两种不同请求。发现接口不可用时，可以依据提供商文档手动添加模型 ID，再单独验证推理。不要随意填写熟悉的模型名字，也不要把本地显示名称当成服务器实际接受的 ID。
资料状态: 官方文档复核于 dsh-v0.2.1-alpha.1（5badb15）。npm 与 PyPI 发布身份单独记录；未将新版文档复核视为本机运行实测。 新版本发布后请重新核对官方资料。
分享仅包含公开链接，不携带本地进度或私人配置。
区分内置目录与实时发现
内置提供商使用安装包中的目录；自定义提供商可以用表单里的地址、协议和密钥请求网关。只修改内置提供商的地址，不会把内置目录变成网关实时列表。
只保存当前需要的模型
自定义提供商中点击 Fetch available models，勾选后添加，最后保存提供商。端点不支持列出模型时，改用其官方文档给出的 ID。
- 列出模型返回 401 时先检查认证。
- 列表格式不受支持时可以手动添加。
- 先验证一个模型，再扩大模型目录。
用新会话验证
保存后选择模型，新建会话并执行简短的仓库概述任务。旧会话可能保留原先记录的模型，修改默认值不等于旧会话已经切换。
- 确认显示的提供商和模型。
- 记录错误类型而非公开完整请求。
- 模型存在但请求被拒绝时返回协议检查。
按协议检查发现接口
自定义 Chat Completions 和 Responses 路由通过 GET {baseURL}/models 查询并使用 bearer 认证；Messages 使用 /v1/models?limit=1000 及原生认证头。发现操作只读取候选元数据，提供商保存的配置决定模型目录。列表可用与推理成功是两项独立检查。
官方资料
使用新版本前，打开以下固定版本或注明核验日期的资料。