从零安装 DeepSeek Harness：先下载 DSH Desktop
Windows/macOS 新手优先走桌面端：下载客户端、打开 DSH、配置模型，再运行第一个任务。Linux 或想使用命令行的用户，再进入对应 npm/npx 教程。
本页内容
如果你只是想尽快开始使用 DeepSeek Harness，不必先折腾 Node.js、pnpm 或终端。DSH Desktop 的正式安装包已经包含常规运行环境。它是独立社区维护的桌面客户端，并非 DeepSeek 官方产品；Linux 当前仍建议走下面的 npm/npx 路径。
第 1 步 — 先下载 DSH Desktop 客户端
Windows 和 macOS 新手优先从桌面端开始。安装包把固定版本的 DeepSeek Harness 与所需运行环境一起打包，省掉第一次安装 Node.js、pnpm 和手工启动本地 Host 的步骤。
桌面安装包已包含常规运行依赖，因此 Windows/macOS 普通用户不需要先安装 Node.js 或 pnpm。客户端属于社区项目；本站会继续保留官方 npm/npx 路径，方便 Linux、开发者和偏好命令行的用户。
Linux / 想用命令行？再选择系统教程
如果你使用 Linux、需要控制具体 Node 环境，或者就是想按官方 npm 快速启动方式运行 DSH，请选择对应系统教程。核心命令仍是 npx @deepseek-ai/dsh web，Web UI 默认在 127.0.0.1:3080 提供服务。
客户端或 CLI 打开 DSH 后，继续完成这 5 步
从这里开始，两条安装路径重新汇合。如果某一步失败，先修复它再继续下一步。
配置模型服务商
打开 Settings → Models，保存 DeepSeek API Key 或其他受支持服务商的凭证，再选择它提供的模型。
选择测试工作区
先选择可丢弃的测试文件夹，再让 DSH 访问重要项目。
先做只读仓库导览
让 DSH 总结文件结构或解释项目入口，并把回答与磁盘文件进行核对。
执行一个可控改动
发送一个小而可回退的任务，审查授权请求，并自行核验生成的文件。
选择下一次会话预设
根据已记录的预设能力，决定后续会话需要哪些工具。
Harness 提供什么
模型负责生成回答；Harness 把模型连接到工作区和完成任务所需的工具。在 DSH 中，Agent 预设就是一次会话的插件组合，包括工具、Prompt 和能力。
模型
选择已配置的服务商和模型来分析任务。
工作区与权限
所选工作区设置会话的工作目录。实际文件访问和哪些操作需要确认，由可用工具与当前权限策略决定。
预设与插件
官方项目将 DSH 描述为“Everything is a plugin”。预设组合一次会话可用的工具与能力。
因此首次任务应当小而且容易检查：你需要同时核验模型回答和它所处的执行环境。
开始前需要什么
使用 DeepSeek 时，先创建 DeepSeek API Key。也可以在 Settings → Models → Add provider 选择其他受支持服务商；企业网关或目录外的服务请参考自定义 Provider 指南。
DSH 成功打开之后
继续完成下面的学习路径：先配置模型，再读取仓库事实，做一次可控文件改动，最后了解后续会话可选择的能力。
配置其他模型服务商
每个服务商都有独立文章，包含官方 Key 页面、路由值、协议、模型选择路径和错误排查。
高级指南 — 真正需要时再打开
普通本地使用完成上面的入门路径就够了。下面四篇专门处理配置量更大、也更容易出现环境差异的场景。
DeepSeek Harness 官方仓库 · DSH Desktop 社区仓库。Desktop 是独立社区项目；DeepSeek Harness 当前也仍处于开发者预览阶段，版本更新可能改变界面标签和行为。