安装 Node.js
安装当前受支持、并包含 npm 与 npx 的 Node.js 版本。
独立、基于官方源码核验的 DSH 指南
安装、排查并扩展 DeepSeek Harness
DeepSeek Harness（DSH）是开源的 Agent 运行工具：连接模型服务商，在本地工作区执行任务，并用插件和 MCP 扩展能力。新手从安装开始；遇到报错，直接查找解决方法。
Windows 与 macOS 的 DSH Desktop更想用桌面应用，不想先学终端？
使用社区维护的桌面封装管理本地 Harness 进程，并在独立窗口中工作。下载前先查看兼容性与安全说明。
查看 Desktop 兼容性与安装 →第三方桌面应用 · 由社区维护，并非 DeepSeek 官方产品。应用不包含 API 额度。
3 步安装 DeepSeek Harness
直接在本页执行官方 npm 快速启动命令；命令可以一键复制，任何一步失败再进入对应系统的完整教程。
启动本地 Web UI
执行官方 npm 快速启动命令，并保持终端窗口开启。
npx @deepseek-ai/dsh web连接模型并测试
打开“设置 → 模型”保存模型服务商凭据，选择一个临时测试文件夹，再运行一个简单任务。
DeepSeek Harness（DSH）到底是什么？
DSH 是位于模型外层的开源 Agent Harness：把模型选择、会话、工具、工作区权限、授权和插件组织成真正可执行的工作流。
DSH 真正增加了什么
模型本身负责生成输出；DSH 提供外层运行时，包括模型服务商与模型、工作区、会话记录、工具执行、授权边界，以及由插件组合出来的能力。
查看 DSH 概览 →DSH 和 Claude Code 有什么不同
Claude Code 是以 Claude 模型生态为中心的编码 Agent 产品；DSH 更强调可重组的插件式 Harness，可扩展模型服务商、工具、Web UI、MCP、Skills、Subagents 与 Workflows。
查看 Agent 对比 →你现在要完成什么？
只选下面与你当前情况相符的一项。
第一次安装 DSH
选择正在使用的系统，检查 Node.js，启动本地 Web UI，再运行一个简单测试任务。
打开小白安装路径 →
修复一个具体报错
输入终端里的完整报错，再按与你操作系统对应的命令处理。
搜索报错解决方案 →
添加插件、MCP 或模型服务商
先看扩展是官方还是第三方、安装后从哪里使用，以及安装时可能执行什么代码。
浏览扩展能力 →常见 DSH 报错
把终端里的完整报错粘贴到下面；匹配结果会直接展开最快处理方式，有命令时可以当场复制。
可以直接粘贴一整行终端报错。搜索在浏览器本地完成，不会上传你输入的错误文本。
先显示 7 个常见解决方案，共 11 个；输入报错查看对应答案
MISSING_CREDENTIAL凭据
MISSING_CREDENTIAL 错误
为当前会话使用的模型服务商保存凭据，再重新选择模型并重试。
UNKNOWN_MODEL模型
UNKNOWN_MODEL 错误
选择当前模型服务商中真实存在的 Model ID，或先添加该模型再重试。
401 authentication failed凭据
401 Authentication Failed
核对 Key、模型服务商 Base URL 和环境变量凭据，并把“获取模型”与聊天请求分开测试。
EADDRINUSE: address already in use 127.0.0.1:3080安装
EADDRINUSE: address already in use 127.0.0.1:3080
找出占用 3080 的进程，或确认 Windows 保留端口冲突；只结束已确认的旧进程，否则直接换端口。
127.0.0.1:3080 does not openWeb UI
127.0.0.1:3080 无法打开
先确认 DSH 在本机还是远程服务器运行，再打开终端打印的准确地址，或建立 SSH 端口转发。
'node' is not recognized安装
'node' Is Not Recognized
安装 DSH 支持的 Node.js，重新打开终端刷新 PATH，再确认 Node 可用。
npm / npx is not recognized安装
npm / npx Is Not Recognized
修复 Node.js 安装或 PATH，直到 node、npm 和 npx 能在同一终端正常运行。
按操作系统安装
选择你正在使用的系统，让命令、验证步骤和排错方式都与当前设备一致。
Windows
Windows 10/11：安装 Node.js，用 PowerShell 执行官方 npx 快速启动，并处理 npm.ps1、3080 端口占用等常见问题。
打开 Windows 安装教程 →
开始前先了解 Web UI 操作顺序
填写 API Key、选择测试文件夹、选择模型、查看授权提示，再到磁盘确认结果。
最新核验源码
官方 master 当前标识为 0.1.2-alpha.5，源码快照 49a606b。
打开版本来源 →Agent 对比
选择工作流前，对比 DSH 与 Hermes、Claude Code、Codex 和 OpenCode 的主要差异。
打开 Agent 对比 →插件检查
官方和第三方只说明来源；安装脚本、申请的权限和审查记录仍要分别查看。
查看插件策略 →