中文实用指南 · 独立指南
DeepSeek Harness 中文故障排查：从启动到模型请求
先确定失败发生在哪一层，再改配置：下载包失败、进程启动失败、浏览器打不开、工作区未选择、模型认证失败和工具连接失败需要不同检查。记录操作系统、启动命令、dsh 版本与第一条完整错误，在最小配置中一次只改一个条件。恢复后用同一检查重试，以可观察的成功结果确认原因。
资料状态: 依据下方固定版本官方资料整理；发布元数据和历史运行实测分别标注。 新版本发布后请重新核对官方资料。
分享仅包含公开链接，不携带本地进度或私人配置。
先记录环境与第一条错误
保存操作系统和架构、终端种类、准确启动命令、包版本、Profile 名与错误出现阶段。日志最后一行可能只是汇总，先寻找最早的失败。旧社区帖只代表对应版本与环境的报告，不应把其中的猜测写成当前版本结论。
- 命令下载超时：先核对 npm、网络与代理阶段。
- 启动退出：看 CLI 的插件和缺失服务诊断。
- 进程仍运行但浏览器未打开：手动打开终端打印的地址。
确认服务与工作区，再查模型
Web 服务默认打印本地 URL；仅有页面响应，还不足以发送任务。进入 Choose workspace 选择项目，再到 Settings → Models 保存提供商并选择模型。模型请求失败时保留 HTTP 状态或错误码，不把所有故障都归因于 Node。
用错误码缩小排查范围
缺凭据检查当前模型路由；模型未知检查 Provider ID、模型 ID 和 Profile；MCP 失败检查独立服务器启动、配置与连接阶段。不要同时升级启动器、替换端点、重装插件和重写配置，否则无法知道哪一步修复了问题。
- MISSING_CREDENTIAL：当前路由没有解析出要求的凭据。
- UNKNOWN_MODEL：当前适配器路由没有配置请求的模型。
- MCP 连接错误：先分开看服务器启动和连接，不直接判断是模型故障。
启动失败时看官方诊断记录
官方 CLI 参考说明必需插件激活失败会输出原始堆栈、待激活插件和缺失服务；成功写入时，Full diagnostics 指向 DSH_HOME/logs 下的独立日志。检查报告内容后再分享：原始插件错误没有保证对所有配置和凭据值脱敏。
用可重复的成功条件验收
安装阶段能显示版本，服务阶段能打开正确地址，工作区可选择，模型阶段最小任务有回复，工具阶段最小调用完成。记录修复前后唯一改变的条件；仍失败时向官方社区提供去除敏感信息后的环境、版本和最小复现。
不同失败阶段应该观察什么
| 失败阶段 | 先检查 | 成功条件 |
|---|---|---|
| 包下载或安装 | 包名、固定版本、网络与运行时环境 | 可执行程序能显示版本 |
| Web 启动 | 进程错误、监听地址和 Profile | 终端打印地址且页面可访问 |
| 任务发送 | 工作区、选中的提供商、模型和凭据 | 新会话最小任务正常返回 |
| 插件或 MCP | 依赖、配置层、服务器启动与工具启用 | 对应最小工具调用完成 |
官方资料
使用新版本前，打开以下固定版本或注明核验日期的资料。