从零安装 DeepSeek Harness

选择你的操作系统，完成安装、模型配置和一次只读检查。测试通过后，就可以让 DSH 在测试文件夹里执行第一个任务。

本页内容

安装前准备

准备可联网的电脑和模型服务商凭据，例如 DeepSeek API Key。官方桌面预览版安装包不附带模型调用额度。测试时使用空文件夹，避免误改重要项目。

选择你的系统

Windows x64 与 Apple 芯片 Mac 可使用官方桌面安装包。Intel Mac 和 Linux 使用命令行；Windows/macOS 教程也保留了命令行安装方式。

推荐桌面版

下载 EXE → 安装 → 打开 DSH Desktop

按芯片选择

Apple 芯片：官方 DMG；Intel：命令行安装

命令行

Node.js → npx 启动 → 打开 Web UI

安装 DSH 和连接模型是两个步骤。按 API Key 所属的服务商选择配置指南。

在设置 → 模型（Settings → Models）中保存所选服务商的 API 凭据，再选中模型。

新建空文件夹 dsh-test，点击选择工作区（Choose workspace）并选中它。

发送下面的只读任务，将工具返回的路径和文件列表与电脑上的文件夹对照。

只读测试提示词

请使用工具读取当前工作区的完整路径，并列出这个文件夹里的文件。不要创建、修改或删除任何文件。

将工具结果与电脑上的文件夹对照。空文件夹返回空列表也正常；仅有文字回复，还不能确认工作区读取成功。

DSH 能正常打开桌面主窗口或本机 Web UI 可用

模型能回复没有 MISSING_CREDENTIAL 或模型错误

文件读取正确工具返回的路径和文件列表与 dsh-test 一致

三项都符合，安装与基础配置就完成了。如果出现报错，先检查模型配置或查看排错指南。

安装信息来源与下载记录

DeepSeek Harness 官方仓库、官方 Desktop 说明、桌面下载页。

使用 DeepSeek Harness 官网当前提供的下载入口。链接核对日期：2026-11-06。桌面下载页单独列出历史安装包。