DeepSeek Harness 自定义端点：协议、模型与排错
在本地 Settings → Models 的 Custom model API 中添加网关，选择网关实际支持的协议与根地址，添加准确的模型 ID 并保存，再用新会话验证。2026-10-04 复核的 dsh-v0.2.1-alpha.1 文档将模型发现、推理请求和原生 DeepSeek 适配器分开说明；这不代表新版 npm 已完成本站运行实测。
分享仅包含公开链接，不携带本地进度或私人配置。
核对端点协议与永久提供商 ID
自定义表单提供 OpenAI Chat Completions、OpenAI Responses、Anthropic Messages 三种协议。按网关文档选择；同一网关的两种协议需要两个提供商。小写 Provider ID 被请求、会话和凭据引用，创建后不能直接重命名。新版 GitHub 中原生 llm-deepseek 仅使用 Messages，不接受 protocol 字段。
发现模型后还要保存
自定义 Chat Completions 和 Responses 路由通过 GET {baseURL}/models 查询；Messages 使用 /v1/models?limit=1000 及原生认证头。选择所需模型并保存才会持久化。内置提供商返回安装包目录，即使更改根地址也不会变成实时网关目录。网关不提供支持的列表格式时，可以手动输入其文档给出的模型 ID。
用新会话验证实际请求
确认新会话选中的提供商和模型。已发送请求的旧会话保留其模型记录。MISSING_CREDENTIAL、UNKNOWN_MODEL、401 和请求格式拒绝应分别检查；不要一次同时改变协议、模型和凭据。只有端点实际支持图片时才声明图片输入。
按网关行为调整请求兼容项
有效密钥与可达地址仍可能遭到格式拒绝。官方指南为不接受 developer 角色或 max_completion_tokens 的网关提供 compat.supportsDeveloperRole: false 与 compat.maxTokensField: max_tokens 示例。只对实际存在的差异应用；协议不接受的开关或空值会被拒绝。
检查正在运行的配置层
标准 web profile 的文件为 $DSH_HOME/profiles/web/cordis.patch.yml。home patch 与命令行 --patch 可以覆盖整行 config，修改时需保留其他提供商。先用 dsh --profile web --dump-config 查看合成结果；启用 HMR 时有效常规修改可热重载，否则需要重启。旧 rc.7 配置生成器继续作为明确标注的历史工具。
官方资料
使用新版本前，打开以下固定版本或注明核验日期的资料。